Definition at line 636 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.


Public Member Functions | |
| video_frame (const frame &f) | |
| Extends the frame class with additional video related attributes and functions. More... | |
| int | get_width () const |
| returns image width in pixels More... | |
| int | get_height () const |
| returns image height in pixels More... | |
| int | get_stride_in_bytes () const |
| retrieve frame stride, meaning the actual line width in memory in bytes (not the logical image width) More... | |
| int | get_bits_per_pixel () const |
| retrieve bits per pixel More... | |
| int | get_bytes_per_pixel () const |
| retrieve bytes per pixel More... | |
| bool | extract_target_dimensions (rs2_calib_target_type calib_type, float *target_dims, unsigned int target_dims_size) const |
| Extract the target dimensions on the specific target. More... | |
| video_frame (const frame &f) | |
| Extends the frame class with additional video related attributes and functions. More... | |
| int | get_width () const |
| returns image width in pixels More... | |
| int | get_height () const |
| returns image height in pixels More... | |
| int | get_stride_in_bytes () const |
| retrieve frame stride, meaning the actual line width in memory in bytes (not the logical image width) More... | |
| int | get_bits_per_pixel () const |
| retrieve bits per pixel More... | |
| int | get_bytes_per_pixel () const |
| retrieve bytes per pixel More... | |
| bool | extract_target_dimensions (rs2_calib_target_type calib_type, float *target_dims, unsigned int target_dims_size) const |
| Extract the target dimensions on the specific target. More... | |
| void | swap (frame &other) |
| Swap the internal frame handle with the one in parameter. More... | |
| void | swap (frame &other) |
| Swap the internal frame handle with the one in parameter. More... | |
| void | keep () |
| keep the frame, otherwise if no refernce to the frame, the frame will be released. More... | |
| void | keep () |
| keep the frame, otherwise if no refernce to the frame, the frame will be released. More... | |
| operator bool () const | |
| Parenthesis operator check if internal frame handle is valid. More... | |
| operator bool () const | |
| Parenthesis operator check if internal frame handle is valid. More... | |
| rs2_sensor * | get_sensor () |
| rs2_sensor * | get_sensor () |
| double | get_timestamp () const |
| retrieve the time at which the frame was captured During the frame's lifetime it receives timestamps both at the device and host levels. More... | |
| double | get_timestamp () const |
| retrieve the time at which the frame was captured During the frame's lifetime it receives timestamps both at the device and host levels. More... | |
| rs2_timestamp_domain | get_frame_timestamp_domain () const |
| retrieve the timestamp domain More... | |
| rs2_timestamp_domain | get_frame_timestamp_domain () const |
| retrieve the timestamp domain More... | |
| rs2_metadata_type | get_frame_metadata (rs2_frame_metadata_value frame_metadata) const |
| retrieve the current value of a single frame_metadata More... | |
| rs2_metadata_type | get_frame_metadata (rs2_frame_metadata_value frame_metadata) const |
| retrieve the current value of a single frame_metadata More... | |
| bool | supports_frame_metadata (rs2_frame_metadata_value frame_metadata) const |
| determine if the device allows a specific metadata to be queried More... | |
| bool | supports_frame_metadata (rs2_frame_metadata_value frame_metadata) const |
| determine if the device allows a specific metadata to be queried More... | |
| unsigned long long | get_frame_number () const |
| retrieve frame number (from frame handle) More... | |
| unsigned long long | get_frame_number () const |
| retrieve frame number (from frame handle) More... | |
| const int | get_data_size () const |
| retrieve data size from frame handle More... | |
| const int | get_data_size () const |
| retrieve data size from frame handle More... | |
| const void * | get_data () const |
| retrieve data from frame handle More... | |
| const void * | get_data () const |
| retrieve data from frame handle More... | |
| stream_profile | get_profile () const |
| retrieve stream profile from frame handle More... | |
| stream_profile | get_profile () const |
| retrieve stream profile from frame handle More... | |
| template<class T > | |
| bool | is () const |
| Template function, checking if current instance is the type of another class. More... | |
| template<class T > | |
| bool | is () const |
| Template function, checking if current instance is the type of another class. More... | |
| template<class T > | |
| T | as () const |
| Template function, cast current instance as the type of another class. More... | |
| template<class T > | |
| T | as () const |
| Template function, cast current instance as the type of another class. More... | |
| rs2_frame * | get () const |
| Retrieve back the internal frame handle. More... | |
| rs2_frame * | get () const |
| Retrieve back the internal frame handle. More... | |
| operator rs2_frame * () | |
| operator rs2_frame * () | |
| frame | apply_filter (filter_interface &filter) |
| frame | apply_filter (filter_interface &filter) |
Protected Member Functions | |
| void | add_ref () const |
| add additional reference to a frame without duplicating frame data More... | |
| void | add_ref () const |
| add additional reference to a frame without duplicating frame data More... | |
| void | reset () |
| void | reset () |
|
inline |
Extends the frame class with additional video related attributes and functions.
| [in] | frame | - existing frame instance |
Definition at line 643 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), rs2::frame::reset(), RS2_EXTENSION_VIDEO_FRAME, and rs2_is_frame_extendable_to().
|
inline |
Extends the frame class with additional video related attributes and functions.
| [in] | frame | - existing frame instance |
Definition at line 643 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), rs2::frame::reset(), RS2_EXTENSION_VIDEO_FRAME, and rs2_is_frame_extendable_to().
|
inlineprotectedinherited |
add additional reference to a frame without duplicating frame data
| [out] | result | new frame reference, release by destructor |
Definition at line 604 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_frame_add_ref().
Referenced by rs2::frame::frame().
|
inlineprotectedinherited |
add additional reference to a frame without duplicating frame data
| [out] | result | new frame reference, release by destructor |
Definition at line 604 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_frame_add_ref().
|
inlineinherited |
Definition at line 593 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::filter::process().
|
inlineinherited |
Definition at line 593 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::filter::process().
|
inlineinherited |
Template function, cast current instance as the type of another class.
Definition at line 580 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
Referenced by rs2::frameset::get_pose_frame().
|
inlineinherited |
Template function, cast current instance as the type of another class.
Definition at line 580 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inline |
Extract the target dimensions on the specific target.
| [in] | frame | Left or right camera frame of specified size based on the target type |
| [in] | calib_type | Calibration target type |
| [in] | target_dims_size | Target dimension array size |
| [out] | target_dims | The array to hold the result target dimensions calculated. For type RS2_CALIB_TARGET_RECT_GAUSSIAN_DOT_VERTICES, the four rectangle side sizes in pixels with the order of top, bottom, left, and right |
| [out] | error | If non-null, receives any error that occurs during this call, otherwise, errors are ignored |
Definition at line 717 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_extract_target_dimensions().
|
inline |
Extract the target dimensions on the specific target.
| [in] | frame | Left or right camera frame of specified size based on the target type |
| [in] | calib_type | Calibration target type |
| [in] | target_dims_size | Target dimension array size |
| [out] | target_dims | The array to hold the result target dimensions calculated. For type RS2_CALIB_TARGET_RECT_GAUSSIAN_DOT_VERTICES, the four rectangle side sizes in pixels with the order of top, bottom, left, and right |
| [out] | error | If non-null, receives any error that occurs during this call, otherwise, errors are ignored |
Definition at line 717 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_extract_target_dimensions().
|
inlineinherited |
Retrieve back the internal frame handle.
Definition at line 590 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
Referenced by rs2::frame_source::allocate_motion_frame(), rs2::frame_source::allocate_points(), rs2::frame_source::allocate_video_frame(), rs2::depth_frame::depth_frame(), rs2::disparity_frame::disparity_frame(), rs2::points::export_to_ply(), extract_target_dimensions(), rs2::frameset::foreach_rs(), rs2::frame_source::frame_ready(), rs2::frameset::frameset(), rs2::disparity_frame::get_baseline(), get_bits_per_pixel(), rs2::depth_frame::get_distance(), get_height(), rs2::pose_frame::get_pose_data(), get_stride_in_bytes(), rs2::points::get_texture_coordinates(), rs2::depth_frame::get_units(), rs2::points::get_vertices(), get_width(), rs2::motion_frame::motion_frame(), rs2::frameset::operator[](), rs2::points::points(), rs2::pose_frame::pose_frame(), and video_frame().
|
inlineinherited |
Retrieve back the internal frame handle.
Definition at line 590 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inline |
retrieve bits per pixel
Definition at line 695 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_bits_per_pixel().
|
inline |
retrieve bits per pixel
Definition at line 695 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_bits_per_pixel().
Referenced by get_bytes_per_pixel().
|
inline |
retrieve bytes per pixel
Definition at line 707 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References get_bits_per_pixel().
Referenced by ds3d::impl::realsense::rsFrame2Plane().
|
inline |
retrieve bytes per pixel
Definition at line 707 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References get_bits_per_pixel().
|
inlineinherited |
retrieve data from frame handle
Definition at line 545 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_data().
|
inlineinherited |
retrieve data from frame handle
Definition at line 545 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_data().
Referenced by rs2::motion_frame::get_motion_data().
|
inlineinherited |
retrieve data size from frame handle
Definition at line 533 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_data_size().
|
inlineinherited |
retrieve data size from frame handle
Definition at line 533 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_data_size().
|
inlineinherited |
retrieve the current value of a single frame_metadata
| [in] | frame_metadata | the frame_metadata whose value should be retrieved |
Definition at line 497 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_metadata().
|
inlineinherited |
retrieve the current value of a single frame_metadata
| [in] | frame_metadata | the frame_metadata whose value should be retrieved |
Definition at line 497 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_metadata().
|
inlineinherited |
retrieve frame number (from frame handle)
Definition at line 521 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_number().
|
inlineinherited |
retrieve frame number (from frame handle)
Definition at line 521 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_number().
|
inlineinherited |
retrieve the timestamp domain
Definition at line 485 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_timestamp_domain().
|
inlineinherited |
retrieve the timestamp domain
Definition at line 485 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_timestamp_domain().
|
inline |
returns image height in pixels
Definition at line 671 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_height().
|
inline |
returns image height in pixels
Definition at line 671 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_height().
Referenced by ds3d::impl::realsense::rsFrame2Plane().
|
inlineinherited |
retrieve stream profile from frame handle
Definition at line 557 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_stream_profile().
Referenced by rs2::frameset::first_or_default(), rs2::frameset::get_fisheye_frame(), rs2::frameset::get_infrared_frame(), rs2::frameset::get_pose_frame(), and rs2::pointcloud::map_to().
|
inlineinherited |
retrieve stream profile from frame handle
Definition at line 557 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_stream_profile().
|
inlineinherited |
Definition at line 445 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_sensor().
Referenced by rs2::sensor_from_frame().
|
inlineinherited |
Definition at line 445 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_sensor().
|
inline |
retrieve frame stride, meaning the actual line width in memory in bytes (not the logical image width)
Definition at line 683 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_stride_in_bytes().
|
inline |
retrieve frame stride, meaning the actual line width in memory in bytes (not the logical image width)
Definition at line 683 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_stride_in_bytes().
Referenced by ds3d::impl::realsense::rsFrame2Plane().
|
inlineinherited |
retrieve the time at which the frame was captured During the frame's lifetime it receives timestamps both at the device and host levels.
The different timestamps are gathered and managed under the frame's Metadata attributes. Chronologically the list of timestamps comprises of: SENSOR_TIMESTAMP - Device clock. For video sensors designates the middle of exposure. Requires metadata support. FRAME_TIMESTAMP - Device clock. Stamped at the beginning of frame readout and transfer. Requires metadata support. BACKEND_TIMESTAMP - Host (EPOCH) clock in Kernel space. Frame transfer from USB Controller to the USB Driver. TIME_OF_ARRIVAL - Host (EPOCH) clock in User space. Frame transfer from the USB Driver to Librealsense.
During runtime the SDK dynamically selects the most correct representaion, based on both device and host capabilities: In case the frame metadata is not configured:
HW Timestamp (FRAME_TIMESTAMP), orGlobal Timestamp Host-corrected derivative of HW Timestamp required for multi-sensor/device synchronizationRS2_OPTION_GLOBAL_TIME_ENABLED option. To query which of the three alternatives is active use get_frame_timestamp_domain() function call Definition at line 474 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_timestamp().
|
inlineinherited |
retrieve the time at which the frame was captured During the frame's lifetime it receives timestamps both at the device and host levels.
The different timestamps are gathered and managed under the frame's Metadata attributes. Chronologically the list of timestamps comprises of: SENSOR_TIMESTAMP - Device clock. For video sensors designates the middle of exposure. Requires metadata support. FRAME_TIMESTAMP - Device clock. Stamped at the beginning of frame readout and transfer. Requires metadata support. BACKEND_TIMESTAMP - Host (EPOCH) clock in Kernel space. Frame transfer from USB Controller to the USB Driver. TIME_OF_ARRIVAL - Host (EPOCH) clock in User space. Frame transfer from the USB Driver to Librealsense.
During runtime the SDK dynamically selects the most correct representaion, based on both device and host capabilities: In case the frame metadata is not configured:
HW Timestamp (FRAME_TIMESTAMP), orGlobal Timestamp Host-corrected derivative of HW Timestamp required for multi-sensor/device synchronizationRS2_OPTION_GLOBAL_TIME_ENABLED option. To query which of the three alternatives is active use get_frame_timestamp_domain() function call Definition at line 474 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_get_frame_timestamp().
|
inline |
returns image width in pixels
Definition at line 659 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_width().
Referenced by ds3d::impl::realsense::rsFrame2Plane().
|
inline |
returns image width in pixels
Definition at line 659 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::frame::get(), rs2::error::handle(), and rs2_get_frame_width().
|
inlineinherited |
Template function, checking if current instance is the type of another class.
Definition at line 570 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inlineinherited |
Template function, checking if current instance is the type of another class.
Definition at line 570 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inlineinherited |
keep the frame, otherwise if no refernce to the frame, the frame will be released.
Definition at line 437 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2_keep_frame().
Referenced by rs2::frame_queue::enqueue().
|
inlineinherited |
keep the frame, otherwise if no refernce to the frame, the frame will be released.
Definition at line 437 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2_keep_frame().
|
inlineinherited |
Parenthesis operator check if internal frame handle is valid.
Definition at line 443 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inlineinherited |
Parenthesis operator check if internal frame handle is valid.
Definition at line 443 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inlineexplicitinherited |
Definition at line 591 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inlineexplicitinherited |
Definition at line 591 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
|
inlineprotectedinherited |
Definition at line 611 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2_release_frame().
|
inlineprotectedinherited |
Definition at line 611 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2_release_frame().
Referenced by rs2::depth_frame::depth_frame(), rs2::disparity_frame::disparity_frame(), rs2::frameset::frameset(), rs2::motion_frame::motion_frame(), rs2::points::points(), rs2::pose_frame::pose_frame(), and video_frame().
|
inlineinherited |
determine if the device allows a specific metadata to be queried
| [in] | frame_metadata | the frame_metadata to check for support |
Definition at line 509 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_supports_frame_metadata().
|
inlineinherited |
determine if the device allows a specific metadata to be queried
| [in] | frame_metadata | the frame_metadata to check for support |
Definition at line 509 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References rs2::error::handle(), and rs2_supports_frame_metadata().
|
inlineinherited |
Swap the internal frame handle with the one in parameter.
| [in] | frame | other - another frame instance to be swaped |
Definition at line 413 of file 9.2/sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References absl::swap_internal::swap().
|
inlineinherited |
Swap the internal frame handle with the one in parameter.
| [in] | frame | other - another frame instance to be swaped |
Definition at line 413 of file sources/libs/ds3d/3rdparty/realsense2/include/librealsense2/hpp/rs_frame.hpp.
References absl::swap_internal::swap().
Referenced by rs2::frame::operator=().