目录

camera_device.h

概述

定义相机的基本接口和功能。

引用文件: <ohcamera/camera_device.h>

库: libohcamera.so

系统能力: SystemCapability.Multimedia.Camera.Core

起始版本: 12

相关模块: OH_Camera

汇总

[h2]函数

名称 描述
Camera_ErrorCode OH_CameraDevice_GetCameraOrientation(Camera_Device* camera, uint32_t* orientation) 获取相机设备的传感器方向属性。
Camera_ErrorCode OH_CameraDevice_GetHostDeviceName(Camera_Device* camera, char** hostDeviceName) 获取远程设备名称。
Camera_ErrorCode OH_CameraDevice_GetHostDeviceType(Camera_Device* camera, Camera_HostDeviceType* hostDeviceType) 获取远程设备类型。
Camera_ErrorCode OH_CameraDevice_GetLensEquivalentFocalLengths(const Camera_Device* camera, uint32_t** equivalentFocalLengths, uint32_t* size) 获取相机设备的等效焦距。
Camera_ErrorCode OH_CameraDevice_IsLogicalCamera(const Camera_Device* camera, bool* isLogicalCamera) 检查相机设备是否为逻辑摄像头(由一个或多个物理摄像头组成)。
Camera_ErrorCode OH_CameraDevice_GetLogicalCameraConstituentCameraDevices(const Camera_Device* logicalCamera, Camera_Device** constituentCameras, uint32_t* size) 获取组成逻辑摄像头的所有物理摄像头。调用OH_CameraDevice_DeleteConstituentCameraDevices释放组成逻辑摄像头的所有物理摄像头。
Camera_ErrorCode OH_CameraDevice_DeleteConstituentCameraDevices(const Camera_Device* logicalCamera, Camera_Device* constituentCameras, uint32_t size) 删除组成逻辑摄像头的所有物理摄像头。
Camera_ErrorCode OH_CameraDevice_GetLensFocalLength(const Camera_Device* camera, float* lensFocalLength) 获取相机镜头的焦距。
Camera_ErrorCode OH_CameraDevice_GetMinimumFocusDistance(const Camera_Device* camera, float* minimumFocusDistance) 获取相机设备的最小对焦距离。
Camera_ErrorCode OH_CameraDevice_GetLensDistortion(const Camera_Device* camera, float** lens, uint32_t* size) 获取相机设备的镜头畸变参数。
Camera_ErrorCode OH_CameraDevice_GetIntrinsicCalibration(const Camera_Device* camera, float** intrinsicCalibration, uint32_t* size) 获取相机设备的内参标定参数。
Camera_ErrorCode OH_CameraDevice_GetSensorPhysicalSize(const Camera_Device* camera, float* width, float* height) 获取相机传感器的物理尺寸。
Camera_ErrorCode OH_CameraDevice_GetSensorPixelArraySize(const Camera_Device* camera, uint32_t* width, uint32_t* height) 获取相机传感器的像素阵列大小。
Camera_ErrorCode OH_CameraDevice_GetSensorColorFilterArrangement(const Camera_Device* camera, OH_Camera_SensorColorFilterArrangement* sensorCFA) 获取相机传感器的滤色阵列排列方式。
Camera_ErrorCode OH_CameraDevice_GetAutomotiveCameraPosition(const Camera_Device* camera, OH_Camera_AutomotiveCameraPosition* automotiveCameraPosition) 获取Car设备相机摄像头的位置。

函数说明

[h2]OH_CameraDevice_GetCameraOrientation()

Camera_ErrorCode OH_CameraDevice_GetCameraOrientation(Camera_Device* camera, uint32_t* orientation)

描述

获取相机设备的传感器方向属性。

起始版本: 12

参数:

参数项 描述
Camera_Device* camera 用于获取属性的Camera_Device。
uint32_t* orientation 返回相机sensor角度属性。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功,返回传感器方向属性。

CAMERA_CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetHostDeviceName()

Camera_ErrorCode OH_CameraDevice_GetHostDeviceName(Camera_Device* camera, char** hostDeviceName)

描述

获取远程设备名称。

起始版本: 15

参数:

参数项 描述
Camera_Device* camera 用于获取属性的Camera_Device。
char** hostDeviceName 返回远程设备名称属性。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功,将返回远程设备名称属性。

CAMERA_CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetHostDeviceType()

Camera_ErrorCode OH_CameraDevice_GetHostDeviceType(Camera_Device* camera, Camera_HostDeviceType* hostDeviceType)

描述

获取远程设备类型。

起始版本: 15

参数:

参数项 描述
Camera_Device* camera 用于获取属性的Camera_Device。
Camera_HostDeviceType* hostDeviceType 远程设备类型属性。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功,将返回远程设备名称属性。

CAMERA_CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetLensEquivalentFocalLengths()

Camera_ErrorCode OH_CameraDevice_GetLensEquivalentFocalLengths(const Camera_Device* camera, uint32_t** equivalentFocalLengths, uint32_t* size)

描述

获取相机设备的等效焦距。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
uint32_t** equivalentFocalLengths 输出参数,返回等效焦距数组。
uint32_t* size 输出参数,返回数组大小。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_IsLogicalCamera()

Camera_ErrorCode OH_CameraDevice_IsLogicalCamera(const Camera_Device* camera, bool* isLogicalCamera)

描述

检查相机设备是否为逻辑摄像头(由一个或多个物理摄像头组成)。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
bool* isLogicalCamera 输出参数,返回表示是否为逻辑摄像头的布尔值。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetLogicalCameraConstituentCameraDevices()

Camera_ErrorCode OH_CameraDevice_GetLogicalCameraConstituentCameraDevices(const Camera_Device* logicalCamera, Camera_Device** constituentCameras, uint32_t* size)

描述

获取组成逻辑摄像头的所有物理摄像头。调用OH_CameraDevice_DeleteConstituentCameraDevices释放组成逻辑摄像头的所有物理摄像头。

起始版本: 24

参数:

参数项 描述
const Camera_Device* logicalCamera 逻辑摄像头的Camera_Device指针。
Camera_Device** constituentCameras 输出参数,返回组成逻辑摄像头的物理摄像头集合指针数组。
uint32_t* size 输出物理摄像头数量数组的大小。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_DeleteConstituentCameraDevices()

Camera_ErrorCode OH_CameraDevice_DeleteConstituentCameraDevices(const Camera_Device* logicalCamera, Camera_Device* constituentCameras, uint32_t size)

描述

删除组成逻辑摄像头的所有物理摄像头。

起始版本: 24

参数:

参数项 描述
const Camera_Device* logicalCamera 逻辑摄像头的Camera_Device指针。
Camera_Device* constituentCameras 期望被释放的组成逻辑摄像头的物理摄像头集合。
uint32_t size 物理摄像头数量数组的大小。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

[h2]OH_CameraDevice_GetLensFocalLength()

Camera_ErrorCode OH_CameraDevice_GetLensFocalLength(const Camera_Device* camera, float* lensFocalLength)

描述

获取相机镜头的焦距。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
float* lensFocalLength 输出参数,返回镜头焦距值。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetMinimumFocusDistance()

Camera_ErrorCode OH_CameraDevice_GetMinimumFocusDistance(const Camera_Device* camera, float* minimumFocusDistance)

描述

获取相机设备的最小对焦距离。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
float* minimumFocusDistance 输出参数,返回最小对焦距离。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetLensDistortion()

Camera_ErrorCode OH_CameraDevice_GetLensDistortion(const Camera_Device* camera, float** lens, uint32_t* size)

描述

获取相机设备的镜头畸变参数。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
float** lens 输出参数,返回镜头畸变参数数组。
uint32_t* size 输出参数,返回数组大小。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetIntrinsicCalibration()

Camera_ErrorCode OH_CameraDevice_GetIntrinsicCalibration(const Camera_Device* camera, float** intrinsicCalibration, uint32_t* size)

描述

获取相机设备的内参标定参数。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
float** intrinsicCalibration 输出参数,返回内参标定参数数组。
uint32_t* size 输出参数,返回数组大小。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetSensorPhysicalSize()

Camera_ErrorCode OH_CameraDevice_GetSensorPhysicalSize(const Camera_Device* camera, float* width, float* height)

描述

获取相机传感器的物理尺寸。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
float* width 输出参数,返回传感器宽度(单位:毫米)。
float* height 输出参数,返回传感器高度(单位:毫米)。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetSensorPixelArraySize()

Camera_ErrorCode OH_CameraDevice_GetSensorPixelArraySize(const Camera_Device* camera, uint32_t* width, uint32_t* height)

描述

获取相机传感器的像素阵列大小。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
uint32_t* width 输出参数,返回像素阵列宽度(单位:像素)。
uint32_t* height 输出参数,返回像素阵列高度(单位:像素)。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetSensorColorFilterArrangement()

Camera_ErrorCode OH_CameraDevice_GetSensorColorFilterArrangement(const Camera_Device* camera, OH_Camera_SensorColorFilterArrangement* sensorCFA)

描述

获取相机传感器的滤色阵列排列方式。

起始版本: 24

参数:

参数项 描述
const Camera_Device* camera 用于获取属性的Camera_Device指针。
OH_Camera_SensorColorFilterArrangement* sensorCFA 输出参数,返回传感器滤色阵列排列枚举值。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。

[h2]OH_CameraDevice_GetAutomotiveCameraPosition()

Camera_ErrorCode OH_CameraDevice_GetAutomotiveCameraPosition(const Camera_Device* camera, OH_Camera_AutomotiveCameraPosition* automotiveCameraPosition)

描述

获取Car设备相机摄像头的位置。

起始版本: 26.0.0

参数:

参数项 描述
const Camera_Device* camera 指向用于检索属性的Camera_Device的指针。
OH_Camera_AutomotiveCameraPosition* automotiveCameraPosition 输出参数,返回Car设备摄像头位置枚举值。

返回:

类型 说明
Camera_ErrorCode

CAMERA_OK:方法调用成功。

CAMERA_INVALID_ARGUMENT:参数丢失或者参数不正确。

CAMERA_SERVICE_FATAL_ERROR:相机服务异常。