luchianmihai/walnux
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
walnux/include/nuttx/video/imgsensor.h
SPRESENSE 9c57850466 drivers/video: Support clip 
Support clip by ioctl(VIDIOC_S_SELECTION) and ioctl(VIDIOC_G_SELECTION).
2022-05-30 20:38:47 +03:00

368 lines
12 KiB
C
Raw Blame History

/****************************************************************************
* include/nuttx/video/imgsensor.h
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
#ifndef __INCLUDE_NUTTX_VIDEO_IMGSENSOR_H
#define __INCLUDE_NUTTX_VIDEO_IMGSENSOR_H
/****************************************************************************
* Included Files
****************************************************************************/
#include <sys/types.h>
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
/* Camera parameter IDs */
#define IMGSENSOR_ID_BRIGHTNESS (0x00000000)
#define IMGSENSOR_ID_CONTRAST (0x00000001)
#define IMGSENSOR_ID_SATURATION (0x00000002)
#define IMGSENSOR_ID_HUE (0x00000003)
#define IMGSENSOR_ID_AUTO_WHITE_BALANCE (0x00000004)
#define IMGSENSOR_ID_RED_BALANCE (0x00000005)
#define IMGSENSOR_ID_BLUE_BALANCE (0x00000006)
#define IMGSENSOR_ID_GAMMA (0x00000007)
#define IMGSENSOR_ID_GAMMA_CURVE (0x00000008)
#define IMGSENSOR_ID_EXPOSURE (0x00000009)
#define IMGSENSOR_ID_HFLIP_VIDEO (0x0000000a)
#define IMGSENSOR_ID_VFLIP_VIDEO (0x0000000b)
#define IMGSENSOR_ID_HFLIP_STILL (0x0000000c)
#define IMGSENSOR_ID_VFLIP_STILL (0x0000000d)
#define IMGSENSOR_ID_SHARPNESS (0x0000000e)
#define IMGSENSOR_ID_COLOR_KILLER (0x0000000f)
#define IMGSENSOR_ID_COLORFX (0x00000010)
#define IMGSENSOR_ID_AUTOBRIGHTNESS (0x00000011)
#define IMGSENSOR_ID_ROTATE (0x00000012)
#define IMGSENSOR_ID_EXPOSURE_AUTO (0x00010000)
#define IMGSENSOR_ID_EXPOSURE_ABSOLUTE (0x00010001)
#define IMGSENSOR_ID_FOCUS_ABSOLUTE (0x00010002)
#define IMGSENSOR_ID_FOCUS_RELATIVE (0x00010003)
#define IMGSENSOR_ID_FOCUS_AUTO (0x00010004)
#define IMGSENSOR_ID_ZOOM_ABSOLUTE (0x00010005)
#define IMGSENSOR_ID_ZOOM_RELATIVE (0x00010006)
#define IMGSENSOR_ID_ZOOM_CONTINUOUS (0x00010007)
#define IMGSENSOR_ID_IRIS_ABSOLUTE (0x00010008)
#define IMGSENSOR_ID_IRIS_RELATIVE (0x00010009)
#define IMGSENSOR_ID_AUTO_N_PRESET_WB (0x0001000a)
#define IMGSENSOR_ID_WIDE_DYNAMIC_RANGE (0x0001000b)
#define IMGSENSOR_ID_IMG_STABILIZATION (0x0001000c)
#define IMGSENSOR_ID_ISO_SENSITIVITY (0x0001000d)
#define IMGSENSOR_ID_ISO_SENSITIVITY_AUTO (0x0001000e)
#define IMGSENSOR_ID_EXPOSURE_METERING (0x0001000f)
#define IMGSENSOR_ID_3A_LOCK (0x00010011)
#define IMGSENSOR_ID_AUTO_FOCUS_START (0x00010012)
#define IMGSENSOR_ID_AUTO_FOCUS_STOP (0x00010013)
#define IMGSENSOR_ID_3A_PARAMETER (0x00010014)
#define IMGSENSOR_ID_3A_STATUS (0x00010015)
#define IMGSENSOR_ID_FLASH_LED_MODE (0x00020000)
#define IMGSENSOR_ID_JPEG_QUALITY (0x00030000)
#define IMGSENSOR_ID_CLIP_VIDEO (0xFFFF0000)
#define IMGSENSOR_ID_CLIP_STILL (0xFFFF0001)
/* Number of elements in clip data array
* in IMGSENSOR_ID_CLIP_VIDEO and IMGSENSOR_ID_CLIP_STILL case
*/
#define IMGSENSOR_CLIP_NELEM (4)
/* Index of clip information
* in IMGSENSOR_ID_CLIP_VIDEO and IMGSENSOR_ID_CLIP_STILL case
*/
#define IMGSENSOR_CLIP_INDEX_LEFT (0)
#define IMGSENSOR_CLIP_INDEX_TOP (1)
#define IMGSENSOR_CLIP_INDEX_WIDTH (2)
#define IMGSENSOR_CLIP_INDEX_HEIGHT (3)
/* bit definition for IMGSENSOR_ID_3A_LOCK */
#define IMGSENSOR_LOCK_EXPOSURE (1 << 0)
#define IMGSENSOR_LOCK_WHITE_BALANCE (1 << 1)
#define IMGSENSOR_LOCK_FOCUS (1 << 2)
/* Status bit definition for IMGSENSOR_ID_3A_STATUS */
#define IMGSENSOR_3A_STATUS_STABLE (0)
#define IMGSENSOR_3A_STATUS_AE_OPERATING (1 << 0)
#define IMGSENSOR_3A_STATUS_AWB_OPERATING (1 << 1)
#define IMGSENSOR_3A_STATUS_AF_OPERATING (1 << 2)
/* Format definition for start_capture() and validate_frame_setting */
#define IMGSENSOR_FMT_MAX (2)
#define IMGSENSOR_FMT_MAIN (0)
#define IMGSENSOR_FMT_SUB (1)
#define IMGSENSOR_PIX_FMT_UYVY (0)
#define IMGSENSOR_PIX_FMT_RGB565 (1)
#define IMGSENSOR_PIX_FMT_JPEG (2)
#define IMGSENSOR_PIX_FMT_JPEG_WITH_SUBIMG (3)
#define IMGSENSOR_PIX_FMT_SUBIMG_UYVY (4)
#define IMGSENSOR_PIX_FMT_SUBIMG_RGB565 (5)
/****************************************************************************
* Public Types
****************************************************************************/
/* enumeration for VIDEO_ID_COLORFX */
typedef enum imgsensor_colorfx_e
{
IMGSENSOR_COLORFX_NONE = 0,
IMGSENSOR_COLORFX_BW = 1,
IMGSENSOR_COLORFX_SEPIA = 2,
IMGSENSOR_COLORFX_NEGATIVE = 3,
IMGSENSOR_COLORFX_EMBOSS = 4,
IMGSENSOR_COLORFX_SKETCH = 5,
IMGSENSOR_COLORFX_SKY_BLUE = 6,
IMGSENSOR_COLORFX_GRASS_GREEN = 7,
IMGSENSOR_COLORFX_SKIN_WHITEN = 8,
IMGSENSOR_COLORFX_VIVID = 9,
IMGSENSOR_COLORFX_AQUA = 10,
IMGSENSOR_COLORFX_ART_FREEZE = 11,
IMGSENSOR_COLORFX_SILHOUETTE = 12,
IMGSENSOR_COLORFX_SOLARIZATION = 13,
IMGSENSOR_COLORFX_ANTIQUE = 14,
IMGSENSOR_COLORFX_SET_CBCR = 15,
IMGSENSOR_COLORFX_PASTEL = 16,
} imgsensor_colorfx_t;
/* enumeration for IMGSENSOR_ID_EXPOSURE_AUTO */
typedef enum imgsensor_exposure_auto_type_e
{
/* exposure time:auto, iris aperture:auto */
IMGSENSOR_EXPOSURE_AUTO = 0,
/* exposure time:manual, iris aperture:manual */
IMGSENSOR_EXPOSURE_MANUAL = 1,
/* exposure time:manual, iris aperture:auto */
IMGSENSOR_EXPOSURE_SHUTTER_PRIORITY = 2,
/* exposure time:auto, iris aperture:manual */
IMGSENSOR_EXPOSURE_APERTURE_PRIORITY = 3
} imgsensor_exposure_auto_type_t;
/* enumeration for IMGSENSOR_ID_AUTO_N_PRESET_WHITE_BALANCE */
typedef enum imgsensor_white_balance_e
{
IMGSENSOR_WHITE_BALANCE_MANUAL = 0,
IMGSENSOR_WHITE_BALANCE_AUTO = 1,
IMGSENSOR_WHITE_BALANCE_INCANDESCENT = 2,
IMGSENSOR_WHITE_BALANCE_FLUORESCENT = 3,
IMGSENSOR_WHITE_BALANCE_FLUORESCENT_H = 4,
IMGSENSOR_WHITE_BALANCE_HORIZON = 5,
IMGSENSOR_WHITE_BALANCE_DAYLIGHT = 6,
IMGSENSOR_WHITE_BALANCE_FLASH = 7,
IMGSENSOR_WHITE_BALANCE_CLOUDY = 8,
IMGSENSOR_WHITE_BALANCE_SHADE = 9,
} imgsensor_white_balance_t;
/* enumeration for IMGSENSOR_ID_ISO_SENSITIVITY_AUTO */
typedef enum imgsensor_iso_sensitivity_auto_type_e
{
IMGSENSOR_ISO_SENSITIVITY_MANUAL = 0,
IMGSENSOR_ISO_SENSITIVITY_AUTO = 1,
} imgsensor_iso_sensitivity_auto_type_t;
/* enumeration for IMGSENSOR_ID_EXPOSURE_METERING */
typedef enum imgsensor_exposure_metering_e
{
IMGSENSOR_EXPOSURE_METERING_AVERAGE = 0,
IMGSENSOR_EXPOSURE_METERING_CENTER_WEIGHTED = 1,
IMGSENSOR_EXPOSURE_METERING_SPOT = 2,
IMGSENSOR_EXPOSURE_METERING_MATRIX = 3,
} imgsensor_exposure_metering_t;
/* enumeration for IMGSENSOR_ID_FLASH_LED_MODE */
typedef enum imgsensor_flash_led_mode_e
{
IMGSENSOR_FLASH_LED_MODE_NONE = 0,
IMGSENSOR_FLASH_LED_MODE_FLASH = 1,
IMGSENSOR_FLASH_LED_MODE_TORCH = 2,
} imgsensor_flash_led_mode_t;
/* enumeration for get_supported_value() */
typedef enum imgsensor_ctrl_type_e
{
IMGSENSOR_CTRL_TYPE_INTEGER = 1,
IMGSENSOR_CTRL_TYPE_BOOLEAN = 2,
IMGSENSOR_CTRL_TYPE_INTEGER64 = 5,
IMGSENSOR_CTRL_TYPE_BITMASK = 8,
IMGSENSOR_CTRL_TYPE_INTEGER_MENU = 9,
IMGSENSOR_CTRL_TYPE_U8FIXEDPOINT_Q7 = 10,
IMGSENSOR_CTRL_TYPE_U16FIXEDPOINT_Q8 = 11,
IMGSENSOR_CTRL_TYPE_INTEGER_TIMES_3 = 12,
IMGSENSOR_CTRL_TYPE_U8 = 0x0100,
IMGSENSOR_CTRL_TYPE_U16 = 0x0101,
IMGSENSOR_CTRL_TYPE_U32 = 0x0102,
} imgsensor_ctrl_type_t;
/* enumeration for stream */
typedef enum imgsensor_stream_type_e
{
IMGSENSOR_STREAM_TYPE_VIDEO = 0,
IMGSENSOR_STREAM_TYPE_STILL = 1,
} imgsensor_stream_type_t;
/* structure for validate_frame_setting() and start_capture() */
typedef struct imgsensor_format_s
{
uint16_t width;
uint16_t height;
uint32_t pixelformat;
} imgsensor_format_t;
typedef struct imgsensor_interval_s
{
uint32_t numerator;
uint32_t denominator;
} imgsensor_interval_t;
/* structure for get_supported_value() */
typedef struct imgsensor_capability_range_s
{
int64_t minimum;
int64_t maximum;
uint64_t step;
int64_t default_value;
} imgsensor_capability_range_t;
typedef struct imgsensor_capability_discrete_s
{
int8_t nr_values;
int32_t *values;
int32_t default_value;
} imgsensor_capability_discrete_t;
typedef struct imgsensor_capability_elems_s
{
uint32_t nr_elems;
int64_t minimum;
int64_t maximum;
uint64_t step;
} imgsensor_capability_elems_t;
typedef struct imgsensor_supported_value_s
{
imgsensor_ctrl_type_t type; /* control type */
union
{
/* Use 'range' member in the following types cases.
* IMGSENSOR_CTRL_TYPE_INTEGER
* IMGSENSOR_CTRL_TYPE_BOOLEAN
* IMGSENSOR_CTRL_TYPE_INTEGER64
* IMGSENSOR_CTRL_TYPE_BITMASK
* IMGSENSOR_CTRL_TYPE_U8FIXEDPOINT_Q7
* IMGSENSOR_CTRL_TYPE_U16FIXEDPOINT_Q8
* IMGSENSOR_CTRL_TYPE_INTEGER_TIMES_3
*/
imgsensor_capability_range_t range;
/* Use 'discrete' member in the following type case.
* IMGSENSOR_CTRL_TYPE_INTEGER_MENU
*/
imgsensor_capability_discrete_t discrete;
/* Use 'elems' member in the following types cases.
* IMGSENSOR_CTRL_TYPE_U8
* IMGSENSOR_CTRL_TYPE_U16
* IMGSENSOR_CTRL_TYPE_U32
*/
imgsensor_capability_elems_t elems;
} u;
} imgsensor_supported_value_t;
typedef union imgsensor_value_u
{
int32_t value32;
int64_t value64;
uint8_t *p_u8;
uint16_t *p_u16;
uint32_t *p_u32;
} imgsensor_value_t;
/* Structure for Image Sensor I/F */
struct imgsensor_ops_s
{
CODE bool (*is_available)(void);
CODE int (*init)(void);
CODE int (*uninit)(void);
CODE const char * (*get_driver_name)(void);
CODE int (*validate_frame_setting)(imgsensor_stream_type_t type,
uint8_t nr_datafmts,
FAR imgsensor_format_t *datafmts,
FAR imgsensor_interval_t *interval);
CODE int (*start_capture)(imgsensor_stream_type_t type,
uint8_t nr_datafmts,
FAR imgsensor_format_t *datafmts,
FAR imgsensor_interval_t *interval);
CODE int (*stop_capture)(imgsensor_stream_type_t type);
CODE int (*get_supported_value)(uint32_t id,
FAR imgsensor_supported_value_t *value);
CODE int (*get_value)(uint32_t id,
uint32_t size,
FAR imgsensor_value_t *value);
CODE int (*set_value)(uint32_t id,
uint32_t size,
imgsensor_value_t value);
};
#ifdef __cplusplus
#define EXTERN extern "C"
extern "C"
{
#else
#define EXTERN extern
#endif
/****************************************************************************
* Public Function Prototypes
****************************************************************************/
/* Register image sensor operations. */
int imgsensor_register(FAR const struct imgsensor_ops_s *ops);
#undef EXTERN
#ifdef __cplusplus
}
#endif
#endif /* __INCLUDE_NUTTX_VIDEO_HALIF_H */
Reference in a new issue View git blame Copy permalink