相机管理
相机管理相关功能的头文件为 uav_camera_manager.h
,本文档描述了 uav_camera_manager.h
文件中函数原型的关键信息和使用方法。
函数原型
UAV_CameraManager_Init
- 功能: 初始化摄像头管理模块。用户应调用此函数。
注意:
- 请在
UAV_Core_Init()
之后初始化此接口。
T_UAVReturnCode UAV_CameraManager_Init(void)
UAV_CameraManager_DeInit
- 功能: 反初始化摄像头管理模块。
T_UAVReturnCode UAV_CameraManager_DeInit(void)
UAV_CameraManager_GetCameraType
- 功能: 获取相机类型。
T_UAVReturnCode UAV_CameraManager_GetCameraType(E_UAVCameraType &cameraType)
- 参数
cameraType
: E_UAVCameraType。
UAV_CameraManager_GetCameraTypeIndex
- 功能: 获取选定挂载位置的相机固件版本。
T_UAVReturnCode UAV_CameraManager_GetCameraTypeIndex(T_UAVCameraManagerFirmwareVersion *firmwareVersion)
- 参数
firmwareVersion
:固件版本,参见T_UAVCameraManagerFirmwareVersion
。
UAV_CameraManager_GetCameraConnectStatus
- 功能: 获取选定挂载位置的相机连接状态。
T_UAVReturnCode UAV_CameraManager_GetCameraConnectStatus(bool *connectStatus)
- 参数
connectStatus
:连接状态的返回值。
UAV_CameraManager_SetMode
- 功能: 设置选定挂载位置相机的工作模式。
T_UAVReturnCode UAV_CameraManager_SetMode(E_UAVCameraManagerWorkMode workMode)
- 参数
workMode
: 工作模式,请参见E_UAVCameraManagerWorkMode
。
UAV_CameraManager_GetMode
- 功能: 获取选定安装位置摄像头的工作模式。
T_UAVReturnCode UAV_CameraManager_GetMode(E_UAVCameraManagerWorkMode &workMode)
- 参数
workMode
: 工作模式,请参见E_UAVCameraManagerWorkMode
。
UAV_CameraManager_SetShootPhotoMode
- 功能: 设置选定挂载位置相机的拍照模式。
T_UAVReturnCode UAV_CameraManager_SetShootPhotoMode(E_UAVCameraManagerShootPhotoMode mode)
- 参数
mode
:拍照模式,请参见E_UAVCameraManagerShootPhotoMode
。
UAV_CameraManager_GetShootPhotoMode
- 功能: 获取选定挂载位置相机的拍照模式。
T_UAVReturnCode UAV_CameraManager_GetShootPhotoMode(E_UAVCameraManagerShootPhotoMode &takePhotoMode)
- 参数
`mode`:拍照模式,请参见 `E_UAVCameraManagerShootPhotoMode`。
UAV_CameraManager_StartShootPhoto
- 功能: 开始拍照。
T_UAVReturnCode UAV_CameraManager_StartShootPhoto(E_UAVMountPosition position)
UAV_CameraManager_StopShootPhoto
- 功能: 拍照过程中停止拍照。
T_UAVReturnCode UAV_CameraManager_StopShootPhoto(E_UAVMountPosition mountPosition)
UAV_CameraManager_GetCapturingState
- 功能: 获取相机拍摄状态。
T_UAVReturnCode UAV_CameraManager_GetCapturingState(E_UAVCameraManagerCapturingState &capturingState)
- 参数
capturingState
:获取拍照状态,详见E_UAVCameraManagerCapturingState
。
UAV_CameraManager_SetPhotoBurstCount
- 功能: 在连拍模式下设置连拍张数。
T_UAVReturnCode UAV_CameraManager_SetPhotoBurstCount(E_UAVCameraBurstCount count)
- 参数
count
:连拍张数,请参见E_UAVCameraBurstCount
。
UAV_CameraManager_GetPhotoBurstCount
- 功能: 在连拍模式下获取连拍张数。
T_UAVReturnCode UAV_CameraManager_GetPhotoBurstCount(E_UAVCameraBurstCount &count)
- 参数
count
:连拍张数,请参见E_UAVCameraBurstCount
。
UAV_CameraManager_SetPhotoAEBCount
- 功能: 设置 AEB(自动曝光拍摄)模式下的连拍数量。
T_UAVReturnCode UAV_CameraManager_SetPhotoAEBCount(E_UAVCameraManagerPhotoAEBCount count)
- 参数
count
:AEB 拍照张数,请参见E_UAVCameraManagerPhotoAEBCount
。
UAV_CameraManager_GetPhotoAEBCount
- 功能: 获取 AEB 模式下的连拍数量。
T_UAVReturnCode UAV_CameraManager_GetPhotoAEBCount(E_UAVCameraManagerPhotoAEBCount &count)
- 参数
count
:AEB 拍照张数,请参见E_UAVCameraManagerPhotoAEBCount
。
UAV_CameraManager_SetPhotoTimeIntervalSettings
- 功能: 设置间隔拍摄模式的参数。
T_UAVReturnCode UAV_CameraManager_SetPhotoTimeIntervalSettings(uint32_t interval)
- 参数
interval
:拍照间隔时间。
UAV_CameraManager_GetPhotoTimeIntervalSettings
- 功能: 获取间隔拍摄模式的参数。
T_UAVReturnCode UAV_CameraManager_GetPhotoTimeIntervalSettings(uint32_t &interval)
- 参数
interval
:拍照间隔时间。
UAV_CameraManager_SetFocusMode
- 功能: 设置选定相机挂载位置的相机对焦模式。
T_UAVReturnCode UAV_CameraManager_SetFocusMode(E_UAVCameraManagerFocusMode focusMode)
- 参数
focusMode
:对焦模式,请参见E_UAVCameraManagerFocusMode
。
UAV_CameraManager_GetFocusMode
- 功能: 获取选定相机挂载位置的对焦模式
T_UAVReturnCode UAV_CameraManager_GetFocusMode(E_UAVCameraManagerFocusMode &focusMode)
- 参数
focusMode
:对焦模式,请参见E_UAVCameraManagerFocusMode
。
UAV_CameraManager_SetFocusTarget
- 功能: 设置选定相机挂载位置的对焦点。
T_UAVReturnCode UAV_CameraManager_SetFocusTarget(T_UAVCameraManagerFocusPosData focusPosData)
- 参数
focusPosData
:对焦点位置,请参见T_UAVCameraManagerFocusPosData
。
UAV_CameraManager_GetFocusTarget
- 功能: 获取选定相机挂载位置的对焦点。
T_UAVReturnCode UAV_CameraManager_GetFocusTarget(T_UAVCameraManagerFocusPosData &tapFocusPos)
- 参数
focusPosData
:对焦点位置,请参见T_UAVCameraManagerFocusPosData
。
UAV_CameraManager_StartContinuousOpticalZoom
- 功能: 开启选定挂载位置相机的持续光学变焦。
T_UAVReturnCode UAV_CameraManager_StartContinuousOpticalZoom(E_UAVCameraZoomDirection zoomDirection, E_UAVCameraZoomSpeed zoomSpeed)
- 参数
zoomSpeed
:相机变焦速度,请参见E_UAVCameraZoomSpeed
。zoomDirection
:相机变焦方向,请参见E_UAVCameraZoomDirection
。
UAV_CameraManager_StopContinuousOpticalZoom
- 功能: 停止选定挂载位置相机的持续光学变焦。
T_UAVReturnCode UAV_CameraManager_StopContinuousOpticalZoom(E_UAVMountPosition position)
UAV_CameraManager_SetOpticalZoomParam
- 功能: 设置选定挂载位置相机的光学变焦参数。
T_UAVReturnCode UAV_CameraManager_SetOpticalZoomParam(autel_f32_t factor)
- 参数
factor
:变焦参数。
UAV_CameraManager_GetOpticalZoomParam
- 功能: 获取选定挂载位置相机的光学变焦参数。
T_UAVReturnCode UAV_CameraManager_GetOpticalZoomParam(autel_f32_t &factor)
- 参数
factor
:变焦参数。
UAV_CameraManager_SetInfraredZoomParam
- 功能: 设置指定挂载位置相机的红外变焦参数。
T_UAVReturnCode UAV_CameraManager_SetInfraredZoomParam(autel_f32_t factor)
- 参数
factor
:变焦参数。
UAV_CameraManager_SetFocusRingValue
- 功能: 设置相机焦距环的值。
T_UAVReturnCode UAV_CameraManager_SetFocusRingValue(uint32_t value)
- 参数
value
:焦距环的值。
UAV_CameraManager_GetFocusRingValue
- 功能: 获取相机焦距环的值。
T_UAVReturnCode UAV_CameraManager_GetFocusRingValue(uint32_t &value)
- 参数
value
:焦距环的值。
UAV_CameraManager_SetExposureMode
- 功能: 设置选定的挂载位置相机的曝光模式。
T_UAVReturnCode UAV_CameraManager_SetExposureMode(E_UAVCameraManagerExposureMode mode)
- 参数
mode
:曝光模式,请参见E_UAVCameraManagerExposureMode
。
UAV_CameraManager_GetExposureMode
- 功能: 获取选定的挂载位置相机的曝光模式。
T_UAVReturnCode UAV_CameraManager_GetExposureMode(E_UAVCameraManagerExposureMode &mode)
- 参数
mode
:曝光模式,请参见E_UAVCameraManagerExposureMode
。
UAV_CameraManager_SetISO
- 功能: 设置选定的挂载位置相机的 ISO 值。
T_UAVReturnCode UAV_CameraManager_SetISO(E_UAVCameraManagerISO iso)
- 参数
iso
:增益值,请参见E_UAVCameraManagerISO
。
UAV_CameraManager_GetISO
- 功能: 获取选定的挂载位置相机的 ISO 值。
T_UAVReturnCode UAV_CameraManager_GetISO(E_UAVCameraManagerISO &iso)
- 参数
iso
:增益值,请参见E_UAVCameraManagerISO
。
UAV_CameraManager_SetAperture
- 功能: 设置选定的挂载位置相机的光圈值。
T_UAVReturnCode UAV_CameraManager_SetAperture(E_UAVCameraManagerAperture aperture)
- 参数
aperture
:光圈值,请参见E_UAVCameraManagerAperture
。
UAV_CameraManager_GetAperture
- 功能: 获取选定的挂载位置相机的光圈值。
T_UAVReturnCode UAV_CameraManager_GetAperture(E_UAVCameraManagerAperture &aperture)
- 参数
aperture
:光圈值,请参见E_UAVCameraManagerAperture
。
UAV_CameraManager_SetShutterSpeed
- 功能: 设置指定挂载位置相机的快门速度。
T_UAVReturnCode UAV_CameraManager_SetShutterSpeed(E_UAVCameraManagerShutterSpeed shutterSpeed)
- 参数
shutterSpeed
:快门速度,请参见E_UAVCameraManagerShutterSpeed
。
UAV_CameraManager_GetShutterSpeed
- 功能: 获取指定挂载位置相机的快门速度。
T_UAVReturnCode UAV_CameraManager_GetShutterSpeed(E_UAVCameraManagerShutterSpeed &shutterSpeed)
- 参数
shutterSpeed
:快门速度,请参见E_UAVCameraManagerShutterSpeed
。
UAV_CameraManager_SetExposureCompensation
- 功能: 设置指定挂载位置相机的曝光补偿
T_UAVReturnCode UAV_CameraManager_SetExposureCompensation(E_UAVCameraManagerExposureCompensation ev)
- 参数
ev
:曝光补偿值,请参见E_UAVCameraManagerExposureCompensation
。
UAV_CameraManager_GetExposureCompensation
- 功能: 获取指定挂载位置相机的曝光补偿。
T_UAVReturnCode UAV_CameraManager_GetExposureCompensation(E_UAVCameraManagerExposureCompensation &ev)
- 参数
ev
:曝光补偿值,请参见E_UAVCameraManagerExposureCompensation
。
UAV_CameraManager_SetAELockEnabled
- 功能: 设置自动曝光锁定。
T_UAVReturnCode UAV_CameraManager_SetAELockEnabled(bool enable)
- 参数
enable
:启用为true
,禁用为false
。
UAV_CameraManager_GetAELockEnabled
- 功能: 获取自动曝光锁定状态。
T_UAVReturnCode UAV_CameraManager_GetAELockEnabled(bool &enable)
- 参数
enable
:启用为true
,禁用为false
。
UAV_CameraManager_ResetCameraSettings
- 功能: 重置相机设置。
T_UAVReturnCode UAV_CameraManager_ResetCameraSettings(E_UAVMountPosition position)
UAV_CameraManager_StartRecordVideo
- 功能: 选定挂载位置相机开始录像。
T_UAVReturnCode UAV_CameraManager_StartRecordVideo(E_UAVMountPosition position)
UAV_CameraManager_StopRecordVideo
- 功能: 选定挂载位置相机停止录像。
T_UAVReturnCode UAV_CameraManager_StopRecordVideo(E_UAVMountPosition position)
UAV_CameraManager_GetRecordingState
- 功能: 获取相机录像状态。
T_UAVReturnCode UAV_CameraManager_GetRecordingState(E_UAVMountPosition position,E_UAVCameraManagerRecordingState *recordingState)
- 参数
recordingState
:录像状态,请参见E_UAVCameraManagerRecordingState
。
UAV_CameraManager_GetStreamSource
- 功能: 选择摄像机流源。
T_UAVReturnCode UAV_CameraManager_GetStreamSource(E_UAVCameraManagerStreamSource &streamSource)
- 参数
rangeList
:返回的范围结果。
UAV_CameraManager_GetStreamSourceRange
- 功能: 获取相机流媒体数据源范围。
T_UAVReturnCode UAV_CameraManager_GetStreamSourceRange(T_UAVCameraManagerRangeList &rangeList)
- 参数
rangeList
:返回的范围结果。
UAV_CameraManager_GetPhotoFormatStorageRange
- 功能: 获取照片存储格式范围。
T_UAVReturnCode UAV_CameraManager_GetPhotoFormatStorageRange(T_UAVCameraManagerRangeList &rangeList)
- 参数
rangeList
:返回的范围结果。
UAV_CameraManager_SetPhotoFormat
- 功能: 设置照片存储格式。
T_UAVReturnCode UAV_CameraManager_SetPhotoFormat(E_UAVCameraManagerPhotoStorageFormat format)
- 参数
format
:存储格式。
UAV_CameraManager_GetPhotoFormat
- 功能: 获取照片存储格式。
T_UAVReturnCode UAV_CameraManager_GetPhotoFormat(E_UAVCameraManagerPhotoStorageFormat &format)
- 参数
format
:存储格式。
UAV_CameraManager_GetVideoFormatRange
- 功能: 获取视频存储格式范围。
T_UAVReturnCode UAV_CameraManager_GetVideoFormatRange(T_UAVCameraManagerRangeList &rangeList)
- 参数
rangeList
:返回的范围结果。
UAV_CameraManager_SetVideoStorageFormat
- 功能: 设置视频存储格式。
T_UAVReturnCode UAV_CameraManager_SetVideoStorageFormat(E_UAVCameraManagerVideoStorageFormat format)
- 参数
format
:存储格式。
UAV_CameraManager_GetVideoFormat
- 功能: 获取视频存储格式。
T_UAVReturnCode UAV_CameraManager_GetVideoFormat(E_UAVCameraManagerVideoStorageFormat &format)
- 参数
format
:存储格式。
UAV_CameraManager_GetVideoResolutionFrameRate
- 功能: 获取视频分辨率和帧率。
T_UAVReturnCode UAV_CameraManager_GetVideoResolutionFrameRate(T_UAVCameraManagerVideoFormat &videoParam)
- 参数
videoParam
:返回的视频分辨率和帧率。
UAV_CameraManager_SetSynchronizedSplitScreenZoomEnabled
- 功能: 启用 / 禁用同步分屏缩放功能。
T_UAVReturnCode UAV_CameraManager_SetSynchronizedSplitScreenZoomEnabled(bool enable)
- 参数
enable
:设置为true
以启用,false
以禁用。
UAV_CameraManager_FormatStorage
- 功能: 格式化 SD 卡。
T_UAVReturnCode UAV_CameraManager_FormatStorage(E_UAVMountPosition position)
UAV_CameraManager_GetStorageInfo
- 功能: Get 获取 SD 卡的存储信息。
T_UAVReturnCode UAV_CameraManager_GetStorageInfo(T_UAVCameraManagerStorageInfo *storageInfo)
- 参数
storageInfo
:SD 卡存储信息的获取结果。
UAV_CameraManager_SetPointThermometryCoordinate
- 功能: 设置选定挂载位置的相机点温度坐标。
T_UAVReturnCode UAV_CameraManager_SetPointThermometryCoordinate(T_UAVCameraManagerPointThermometryCoordinate pointCoordinate)
- 参数
pointCoordinate
:点温度坐标。
UAV_CameraManager_GetPointThermometryData
- 功能: 设置选定挂载位置相机的工作模式。
T_UAVReturnCode UAV_CameraManager_GetPointThermometryData(T_UAVCameraManagerPointThermometryData &pointThermometryData)
- 参数
pointCoordinate
:点温度结果。
UAV_CameraManager_SetAreaThermometryCoordinate
- 功能: 设置选定挂载位置的相机区域温度坐标。
T_UAVReturnCode UAV_CameraManager_SetAreaThermometryCoordinate(T_UAVCameraManagerAreaThermometryCoordinate areaCoordinate)
- 参数
areaCoordinate
:区域温度坐标。
UAV_CameraManager_GetAreaThermometryData
- 功能: 获取区域温度结果。
T_UAVReturnCode UAV_CameraManager_GetAreaThermometryData(T_UAVCameraManagerAreaThermometryData &areaThermometryData)
- 参数
areaCoordinate
:区域温度结果。
UAV_CameraManager_SetFfcMode
- 功能: 设置 FFC 模式。
T_UAVReturnCode UAV_CameraManager_SetFfcMode(E_UAVCameraManagerFfcMode ffcMode)
- 参数
ffcMode
:待设置的模式。
UAV_CameraManager_TriggerFfc
- 功能: 触发一次 FFC。
T_UAVReturnCode UAV_CameraManager_TriggerFfc(E_UAVMountPosition position)
UAV_CameraManager_SetInfraredCameraGainMode
- 功能: 设置红外相机增益模式。
T_UAVReturnCode UAV_CameraManager_SetInfraredCameraGainMode(E_UAVCameraManagerIrGainMode gainMode)
- 参数
gainMode
:待设置的增益模式。
UAV_CameraManager_SetMeteringMode
- 功能: 设置相机测光模式。
T_UAVReturnCode UAV_CameraManager_SetMeteringMode(E_UAVCameraManagerMeteringMode meteringMode)
UAV_CameraManager_GetMeteringMode
- 功能: 获取相机测光模式。
T_UAVReturnCode UAV_CameraManager_GetMeteringMode(E_UAVCameraManagerMeteringMode &meteringMode)
- 参数
meteringMode
:返回的测光模式值。
UAV_CameraManager_SetMeteringPoint
- 功能: 设置测光点。
T_UAVReturnCode UAV_CameraManager_SetMeteringPoint(T_UAVCameraManagerMeteringPosData meteringPosData)
- 参数
meteringPosData
:测光点坐标。
UAV_CameraManager_GetMeteringPoint
- 功能: 获取当前测光点。
T_UAVReturnCode UAV_CameraManager_GetMeteringPoint(T_UAVCameraManagerMeteringPosData &meteringPosData)
- 参数
meteringPosData
:测光点坐标。