monado/src/xrt/drivers/wmr/wmr_camera.h
2021-12-13 10:41:55 +00:00

69 lines
1.7 KiB
C

// Copyright 2021 Jan Schmidt <jan@centricular.com>
// SPDX-License-Identifier: BSL-1.0
/*!
* @file
* @brief Interface to read WMR cameras
* @author Jan Schmidt <jan@centricular.com>
* @ingroup drv_wmr
*/
#pragma once
#include "xrt/xrt_config_have.h"
#include "util/u_logging.h"
#include "xrt/xrt_prober.h"
#include "xrt/xrt_frame.h"
#include "wmr_config.h"
#ifdef __cplusplus
extern "C" {
#endif
struct wmr_camera;
#ifdef XRT_HAVE_LIBUSB
struct wmr_camera *
wmr_camera_open(struct xrt_prober_device *dev_holo,
struct xrt_frame_sink *left_sink,
struct xrt_frame_sink *right_sink,
enum u_logging_level log_level);
void
wmr_camera_free(struct wmr_camera *cam);
/*!
* Starts the cameras.
*
* The data pointed to by @p configs must be kept alive for as long as the camera is kept alive.
*/
bool
wmr_camera_start(struct wmr_camera *cam, const struct wmr_camera_config *configs, int config_count);
bool
wmr_camera_stop(struct wmr_camera *cam);
/*!
* Set manual exposure and gain values
*
* @param cam Camera container
* @param camera_id Which camera to affect
* @param exposure Time the shutter is open, observed values 60-6000.
* @param gain Amplification of the analog signal, observed values: 16-255.
*/
int
wmr_camera_set_exposure_gain(struct wmr_camera *cam, uint8_t camera_id, uint16_t exposure, uint8_t gain);
#else
/* Stubs to disable camera functions without libusb */
#define wmr_camera_open(dev_holo, left_sink, right_sink, log_level) NULL
#define wmr_camera_free(cam)
#define wmr_camera_start(cam, cam_configs, n_configs) false
#define wmr_camera_stop(cam) false
#define wmr_camera_set_exposure_gain(cam, camera_id, exposure, gain) -1
#endif
#ifdef __cplusplus
}
#endif