libdc1394  2.1.4
Functions
dc1394/utils.h File Reference

Utility functions. More...

Functions

dc1394error_t dc1394_get_image_size_from_video_mode (dc1394camera_t *camera, uint32_t video_mode, uint32_t *width, uint32_t *height)
dc1394error_t dc1394_framerate_as_float (dc1394framerate_t framerate_enum, float *framerate)
dc1394error_t dc1394_get_color_coding_data_depth (dc1394color_coding_t color_coding, uint32_t *bits)
dc1394error_t dc1394_get_color_coding_bit_size (dc1394color_coding_t color_coding, uint32_t *bits)
dc1394error_t dc1394_get_color_coding_from_video_mode (dc1394camera_t *camera, dc1394video_mode_t video_mode, dc1394color_coding_t *color_coding)
dc1394error_t dc1394_is_color (dc1394color_coding_t color_mode, dc1394bool_t *is_color)
dc1394bool_t dc1394_is_video_mode_scalable (dc1394video_mode_t video_mode)
dc1394bool_t dc1394_is_video_mode_still_image (dc1394video_mode_t video_mode)
dc1394bool_t dc1394_is_same_camera (dc1394camera_id_t id1, dc1394camera_id_t id2)
const char * dc1394_feature_get_string (dc1394feature_t feature)
const char * dc1394_error_get_string (dc1394error_t error)
uint16_t dc1394_checksum_crc16 (const uint8_t *buffer, uint32_t buffer_size)

Detailed Description

Utility functions.

Author:
Damien Douxchamps: coding
Peter Antoniac: documentation maintainer

More details soon


Function Documentation

uint16_t dc1394_checksum_crc16 ( const uint8_t *  buffer,
uint32_t  buffer_size 
)

Calculates the CRC16 checksum of a memory region. Useful to verify the CRC of an image buffer, for instance.

const char* dc1394_error_get_string ( dc1394error_t  error)

Returns a descriptive string for an error code

const char* dc1394_feature_get_string ( dc1394feature_t  feature)

Returns a descriptive name for a feature

dc1394error_t dc1394_framerate_as_float ( dc1394framerate_t  framerate_enum,
float *  framerate 
)

Returns the given framerate as a float.

dc1394error_t dc1394_get_color_coding_bit_size ( dc1394color_coding_t  color_coding,
uint32_t *  bits 
)

Returns the bit-space used by a pixel. This is different from the data depth! For instance, RGB16 has a bit space of 48 bits, YUV422 is 16bits and YU411 is 12bits.

Returns the number of bits per pixel for a certain color coding. This is the size of the data sent on the bus, the effective data depth may vary. Example: RGB16 is 16, YUV411 is 8, YUV422 is 8.

Returns the color coding from the video mode. Works with scalable image formats too.

dc1394error_t dc1394_get_image_size_from_video_mode ( dc1394camera_t camera,
uint32_t  video_mode,
uint32_t *  width,
uint32_t *  height 
)

Returns the image width and height (in pixels) corresponding to a video mode. Works for scalable and non-scalable video modes.

Tells whether the color mode is color or monochrome

Tells whether two IDs refer to the same physical camera unit.

Tells whether the video mode is scalable or not.

Tells whether the video mode is "still image" or not ("still image" is currently not supported by any cameras on the market)