1# drawing_record_cmd.h
2
3
4## Overview
5
6The **drawing_record_cmd.h** file declares the functions related to a recording command object.
7
8**File to include**: <native_drawing/drawing_record_cmd.h>
9
10**Library**: libnative_drawing.so
11
12**Since**: 13
13
14**Related module**: [Drawing](_drawing.md)
15
16
17## Summary
18
19
20### Functions
21
22| Name| Description|
23| -------- | -------- |
24| [OH_Drawing_RecordCmdUtils](_drawing.md#oh_drawing_recordcmdutils) \* [OH_Drawing_RecordCmdUtilsCreate](_drawing.md#oh_drawing_recordcmdutilscreate) (void) | Creates an **OH_Drawing_RecordCmdUtils** object.|
25| [OH_Drawing_ErrorCode](_drawing.md#oh_drawing_errorcode) [OH_Drawing_RecordCmdUtilsDestroy](_drawing.md#oh_drawing_recordcmdutilsdestroy) ([OH_Drawing_RecordCmdUtils](_drawing.md#oh_drawing_recordcmdutils) \*recordCmdUtils) | Destroys an **OH_Drawing_RecordCmdUtils** object and reclaims the memory occupied by the object.|
26| [OH_Drawing_ErrorCode](_drawing.md#oh_drawing_errorcode) [OH_Drawing_RecordCmdUtilsBeginRecording](_drawing.md#oh_drawing_recordcmdutilsbeginrecording) ([OH_Drawing_RecordCmdUtils](_drawing.md#oh_drawing_recordcmdutils) \*recordCmdUtils, int32_t width, int32_t height, [OH_Drawing_Canvas](_drawing.md#oh_drawing_canvas) \*\*canvas) | Starts recording. This function must be used in pair with [OH_Drawing_RecordCmdUtilsFinishRecording](_drawing.md#oh_drawing_recordcmdutilsfinishrecording).<br>The **OH_Drawing_RecordCmdUtils** object generates a canvas object of the recording type and calls the interface of the drawing object to record all drawing commands.|
27| [OH_Drawing_ErrorCode](_drawing.md#oh_drawing_errorcode) [OH_Drawing_RecordCmdUtilsFinishRecording](_drawing.md#oh_drawing_recordcmdutilsfinishrecording) ([OH_Drawing_RecordCmdUtils](_drawing.md#oh_drawing_recordcmdutils) \*recordCmdUtils, [OH_Drawing_RecordCmd](_drawing.md#oh_drawing_recordcmd) \*\*recordCmd) | Ends recording. This function must be called after [OH_Drawing_RecordCmdUtilsBeginRecording](_drawing.md#oh_drawing_recordcmdutilsbeginrecording).<br>The **OH_Drawing_RecordCmdUtils** object ends recording and stores the drawing commands recorded by the canvas object of the recording type into the generated [OH_Drawing_RecordCmdUtilsBeginRecording](_drawing.md#oh_drawing_recordcmdutilsbeginrecording) object.|
28| [OH_Drawing_ErrorCode](_drawing.md#oh_drawing_errorcode) [OH_Drawing_RecordCmdDestroy](_drawing.md#oh_drawing_recordcmddestroy) ([OH_Drawing_RecordCmd](_drawing.md#oh_drawing_recordcmd) \*recordCmd) | Destroys an **OH_Drawing_RecordCmd** object and reclaims the memory occupied by the object.|
29