• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# photo_native.h
2<!--Kit: Camera Kit-->
3<!--Subsystem: Multimedia-->
4<!--Owner: @qano-->
5<!--SE: @leo_ysl-->
6<!--TSE: @xchaosioda-->
7
8## Overview
9
10The file declares the camera photo concepts.
11
12**File to include**: <ohcamera/photo_native.h>
13
14**Library**: libohcamera.so
15
16**System capability**: SystemCapability.Multimedia.Camera.Core
17
18**Since**: 12
19
20**Related module**: [OH_Camera](capi-oh-camera.md)
21
22## Summary
23
24### Structs
25
26| Name| typedef Keyword| Description|
27| -- | -- | -- |
28| [OH_PhotoNative](capi-oh-camera-oh-photonative.md) | OH_PhotoNative | Describes the photo object, which is a full-quality image object.|
29
30### Functions
31
32| Name| Description|
33| -- | -- |
34| [Camera_ErrorCode OH_PhotoNative_GetMainImage(OH_PhotoNative* photo, OH_ImageNative** mainImage)](#oh_photonative_getmainimage) | Obtains a full-quality image.|
35| [Camera_ErrorCode OH_PhotoNative_Release(OH_PhotoNative* photo)](#oh_photonative_release) | Releases a full-quality image.|
36
37## Function Description
38
39### OH_PhotoNative_GetMainImage()
40
41```
42Camera_ErrorCode OH_PhotoNative_GetMainImage(OH_PhotoNative* photo, OH_ImageNative** mainImage)
43```
44
45**Description**
46
47Obtains a full-quality image.
48
49**Since**: 12
50
51
52**Parameters**
53
54| Name| Description|
55| -- | -- |
56| [OH_PhotoNative](capi-oh-camera-oh-photonative.md)* photo | Pointer to an OH_PhotoNative instance.|
57| [OH_ImageNative](../apis-image-kit/capi-image-imagenative-.md)** mainImage | Double pointer to the full-quality image, which is an OH_ImageNative instance.|
58
59**Returns**
60
61| Type| Description|
62| -- | -- |
63| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | **CAMERA_OK**: The operation is successful.<br>**CAMERA_INVALID_ARGUMENT**: A parameter is missing or the parameter type is incorrect.|
64
65### OH_PhotoNative_Release()
66
67```
68Camera_ErrorCode OH_PhotoNative_Release(OH_PhotoNative* photo)
69```
70
71**Description**
72
73Releases a full-quality image.
74
75**Since**: 12
76
77
78**Parameters**
79
80| Name| Description|
81| -- | -- |
82| [OH_PhotoNative](capi-oh-camera-oh-photonative.md)* photo | Pointer to the OH_PhotoNative instance to release.|
83
84**Returns**
85
86| Type| Description|
87| -- | -- |
88| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | **CAMERA_OK**: The operation is successful.<br>**CAMERA_INVALID_ARGUMENT**: A parameter is missing or the parameter type is incorrect.|
89