diff options
Diffstat (limited to 'src')
| -rw-r--r-- | src/cameras/simple.h | 4 | ||||
| -rw-r--r-- | src/uca.c | 1 | ||||
| -rw-r--r-- | src/uca.h | 14 |
3 files changed, 14 insertions, 5 deletions
diff --git a/src/cameras/simple.h b/src/cameras/simple.h index 0c8e9a7..6d8e45e 100644 --- a/src/cameras/simple.h +++ b/src/cameras/simple.h @@ -15,8 +15,8 @@ with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA */ -#ifndef __UNIFIED_CAMERA_ACCESS_PHOTON_H -#define __UNIFIED_CAMERA_ACCESS_PHOTON_H +#ifndef __UNIFIED_CAMERA_ACCESS_SIMPLE_H +#define __UNIFIED_CAMERA_ACCESS_SIMPLE_H uint32_t uca_simple_init(struct uca_camera_priv **uca, struct uca_grabber_priv *grabber); @@ -346,6 +346,7 @@ uint32_t uca_cam_release_buffer(struct uca_camera *cam, void *buffer) struct uca_camera_priv *priv = cam->priv; if (priv->release_buffer != NULL) return priv->release_buffer(priv, buffer); + return UCA_ERR_NOT_IMPLEMENTED; } uint32_t uca_cam_grab(struct uca_camera *cam, char *buffer, void *meta_data) @@ -208,6 +208,8 @@ enum uca_access_rights { /** * Describes the current state of the camera. + * + * \see uca_cam_get_state() */ enum uca_cam_state { UCA_CAM_CONFIGURABLE, /**< Camera can be configured and is not recording */ @@ -220,16 +222,19 @@ enum uca_cam_state { * Specify if the callback function keeps the buffer and will call * ufo_cam_release_buffer() at later time or if after returning the buffer can * be released automatically. + * + * \since 0.5 */ enum uca_buffer_status { - UCA_BUFFER_KEEP, - UCA_BUFFER_RELEASE + UCA_BUFFER_KEEP, /**< Keep the buffer and call ufo_cam_release_buffer() manually */ + UCA_BUFFER_RELEASE /**< Buffer is released upon return */ }; /** * A uca_property_t describes a vendor-independent property used by cameras and * frame grabbers. It basically consists of a human-readable name, a physical * unit, a type and some access rights. + * \see uca_get_full_property() */ typedef struct uca_property { /** @@ -266,6 +271,9 @@ union uca_value { * \param[in] meta_data Meta data provided by the camera specifying per-frame * data. * \param[in] user User data registered in uca_cam_register_callback() + * \return Value from uca_buffer_status. If #UCA_BUFFER_KEEP is returned, the + * callee must make sure to call uca_cam_release_buffer(). On the other hand, if + * #UCA_BUFFER_RELEASE is returned this is done by the caller. * * \note The meta data parameter is not yet specified but just a place holder. */ @@ -357,7 +365,7 @@ typedef struct uca { * relying on external calibration data. It is ignored when no JSON parser can * be found at compile time or config_filename is NULL. * - * \return Pointer to a uca structure + * \return Pointer to a #uca structure * * \note uca_init() is thread-safe if a Pthread-implementation is available. */ |