1# oh_display_info.h
2
3
4## Overview
5
6The **oh_display_info.h** file declares the common enums and definitions of the display.
7
8**File to include**: <window_manager/oh_display_info.h>
9
10**Library**: libnative_display_manager.so
11
12**System capability**: SystemCapability.WindowManager.WindowManager.Core
13
14**Since**: 12
15
16**Related module**: [OH_DisplayManager](_o_h___display_manager.md)
17
18
19## Summary
20
21
22### Structs
23
24| Name| Description|
25| -------- | -------- |
26| struct  [NativeDisplayManager_Rect](_native_display_manager___rect.md) | Describes a rectangle.|
27| struct  [NativeDisplayManager_WaterfallDisplayAreaRects](ive_display_manager___waterfall_display_area_rects.md) | Describes the curved area on a waterfall display.|
28| struct  [NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md) | Describes the unusable area of a display, including punch hole, notch, and curved area of a waterfall display.|
29| struct  [NativeDisplayManager_DisplayHdrFormat](_native_display_manager___display_hdr_format.md) | Encapsulates all the HDR formats supported by a display.|
30| struct  [NativeDisplayManager_DisplayColorSpace](_native_display_manager___display_color_space.md) | Encapsulates all the color spaces supported by a display.|
31| struct  [NativeDisplayManager_DisplayInfo](_native_display_manager___display_info.md) | Encapsulates the information about a display.|
32| struct  [NativeDisplayManager_DisplaysInfo](_native_display_manager___displays_info.md) | Encapsulates the information about displays of a device with multiple screens.|
33
34
35### Types
36
37| Name| Description|
38| -------- | -------- |
39| typedef enum [NativeDisplayManager_Rotation](_o_h___display_manager.md#nativedisplaymanager_rotation) [NativeDisplayManager_Rotation](_o_h___display_manager.md#nativedisplaymanager_rotation) | Defines an enum for the clockwise rotation angles of a display.|
40| typedef enum [NativeDisplayManager_Orientation](_o_h___display_manager.md#nativedisplaymanager_orientation) [NativeDisplayManager_Orientation](_o_h___display_manager.md#nativedisplaymanager_orientation) | Defines an enum for the orientations of a display.|
41| typedef enum [NativeDisplayManager_ErrorCode](_o_h___display_manager.md#nativedisplaymanager_errorcode) [NativeDisplayManager_ErrorCode](_o_h___display_manager.md#nativedisplaymanager_errorcode) | Defines an enum for the status codes returned by the display manager interface.|
42| typedef enum [NativeDisplayManager_FoldDisplayMode](_o_h___display_manager.md#nativedisplaymanager_folddisplaymode) [NativeDisplayManager_FoldDisplayMode](_o_h___display_manager.md#nativedisplaymanager_folddisplaymode) | Defines an enum for the display modes of a foldable device.|
43| typedef struct [NativeDisplayManager_Rect](_native_display_manager___rect.md) [NativeDisplayManager_Rect](_o_h___display_manager.md#nativedisplaymanager_rect) | Defines a struct for a rectangle.|
44| typedef struct [NativeDisplayManager_WaterfallDisplayAreaRects](ive_display_manager___waterfall_display_area_rects.md) [NativeDisplayManager_WaterfallDisplayAreaRects](_o_h___display_manager.md#nativedisplaymanager_waterfalldisplayarearects) | Defines a struct for the curved area on a waterfall display.|
45| typedef struct [NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md) [NativeDisplayManager_CutoutInfo](_o_h___display_manager.md#nativedisplaymanager_cutoutinfo) | Defines a struct for the unusable area of a display, including punch hole, notch, and curved area of a waterfall display.|
46| typedef enum [NativeDisplayManager_DisplayState](_o_h___display_manager.md#nativedisplaymanager_displaystate) [NativeDisplayManager_DisplayState](_o_h___display_manager.md#nativedisplaymanager_displaystate) | Defines an enum for the states of a display.|
47| typedef struct [NativeDisplayManager_DisplayHdrFormat](_native_display_manager___display_hdr_format.md) [NativeDisplayManager_DisplayHdrFormat](_o_h___display_manager.md#nativedisplaymanager_displayhdrformat) | Defines a struct that encapsulates all the HDR formats supported by a display.|
48| typedef struct [NativeDisplayManager_DisplayColorSpace](_native_display_manager___display_color_space.md) [NativeDisplayManager_DisplayColorSpace](_o_h___display_manager.md#nativedisplaymanager_displaycolorspace) | Defines a struct that encapsulates all the color spaces supported by a display.|
49| typedef struct [NativeDisplayManager_DisplayInfo](_native_display_manager___display_info.md) [NativeDisplayManager_DisplayInfo](_o_h___display_manager.md#nativedisplaymanager_displayinfo) | Defines a struct that encapsulates the information about a display.|
50| typedef struct [NativeDisplayManager_DisplaysInfo](_native_display_manager___displays_info.md) [NativeDisplayManager_DisplaysInfo](_o_h___display_manager.md#nativedisplaymanager_displaysinfo) | Defines a struct that encapsulates the information about displays of a device with multiple screens.|
51
52
53### Enums
54
55| Name| Description|
56| -------- | -------- |
57| [NativeDisplayManager_Rotation](_o_h___display_manager.md#nativedisplaymanager_rotation-1) { DISPLAY_MANAGER_ROTATION_0 = 0, DISPLAY_MANAGER_ROTATION_90 = 1, DISPLAY_MANAGER_ROTATION_180 = 2, DISPLAY_MANAGER_ROTATION_270 = 3 } | Enumerates the clockwise rotation angles of a display.|
58| [NativeDisplayManager_Orientation](_o_h___display_manager.md#nativedisplaymanager_orientation-1) {<br>DISPLAY_MANAGER_PORTRAIT = 0, DISPLAY_MANAGER_LANDSCAPE = 1, DISPLAY_MANAGER_PORTRAIT_INVERTED = 2, DISPLAY_MANAGER_LANDSCAPE_INVERTED = 3,<br>DISPLAY_MANAGER_UNKNOWN<br>} | Enumerates the orientations of a display.|
59| [NativeDisplayManager_ErrorCode](_o_h___display_manager.md#nativedisplaymanager_errorcode-1) {<br>DISPLAY_MANAGER_OK = 0, DISPLAY_MANAGER_ERROR_NO_PERMISSION = 201, DISPLAY_MANAGER_ERROR_NOT_SYSTEM_APP = 202, DISPLAY_MANAGER_ERROR_INVALID_PARAM = 401,<br>DISPLAY_MANAGER_ERROR_DEVICE_NOT_SUPPORTED = 801, DISPLAY_MANAGER_ERROR_INVALID_SCREEN = 1400001, DISPLAY_MANAGER_ERROR_INVALID_CALL = 1400002, DISPLAY_MANAGER_ERROR_SYSTEM_ABNORMAL = 1400003<br>} | Enumerates the status codes returned by the display manager interface.|
60| [NativeDisplayManager_FoldDisplayMode](_o_h___display_manager.md#nativedisplaymanager_folddisplaymode-1) {<br>DISPLAY_MANAGER_FOLD_DISPLAY_MODE_UNKNOWN = 0, DISPLAY_MANAGER_FOLD_DISPLAY_MODE_FULL = 1, DISPLAY_MANAGER_FOLD_DISPLAY_MODE_MAIN = 2, DISPLAY_MANAGER_FOLD_DISPLAY_MODE_SUB = 3,<br>DISPLAY_MANAGER_FOLD_DISPLAY_MODE_COORDINATION = 4<br>} | Enumerates the display modes of a foldable device.|
61| [NativeDisplayManager_DisplayState](_o_h___display_manager.md#nativedisplaymanager_displaystate-1) {<br>DISPLAY_MANAGER_DISPLAY_STATE_UNKNOWN = 0, DISPLAY_MANAGER_DISPLAY_STATE_OFF = 1, DISPLAY_MANAGER_DISPLAY_STATE_ON = 2, DISPLAY_MANAGER_DISPLAY_STATE_DOZE = 3,<br>DISPLAY_MANAGER_DISPLAY_STATE_DOZE_SUSPEND = 4, DISPLAY_MANAGER_DISPLAY_STATE_VR = 5, DISPLAY_MANAGER_DISPLAY_STATE_ON_SUSPEND = 6<br>} | Enumerates the states of a display.|
62