1 /*
2  * Copyright (c) 2012-2016, The Linux Foundation. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *     * Redistributions of source code must retain the above copyright
8  *       notice, this list of conditions and the following disclaimer.
9  *     * Redistributions in binary form must reproduce the above
10  *       copyright notice, this list of conditions and the following
11  *       disclaimer in the documentation and/or other materials provided
12  *       with the distribution.
13  *     * Neither the name of The Linux Foundation nor the names of its
14  *       contributors may be used to endorse or promote products derived
15  *       from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
18  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
21  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
24  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
25  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
26  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
27  * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29 
30 #ifndef _QDMETADATA_H
31 #define _QDMETADATA_H
32 
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36 
37 enum ColorSpace_t{
38     ITU_R_601,
39     ITU_R_601_FR,
40     ITU_R_709,
41 };
42 
43 enum IGC_t {
44     IGC_NotSpecified,
45     IGC_sRGB,
46 };
47 
48 struct HSICData_t {
49     int32_t hue;
50     float   saturation;
51     int32_t intensity;
52     float   contrast;
53 };
54 
55 struct BufferDim_t {
56     int32_t sliceWidth;
57     int32_t sliceHeight;
58 };
59 
60 struct MetaData_t {
61     int32_t operation;
62     int32_t interlaced;
63     struct BufferDim_t bufferDim;
64     float refreshrate;
65     enum ColorSpace_t colorSpace;
66     enum IGC_t igc;
67      /* Gralloc sets PRIV_SECURE_BUFFER flag to inform that the buffers are from
68       * ION_SECURE. which should not be mapped. However, for GPU post proc
69       * feature, GFX needs to map this buffer, in the client context and in SF
70       * context, it should not. Hence to differentiate, add this metadata field
71       * for clients to set, and GPU will to read and know when to map the
72       * SECURE_BUFFER(ION) */
73     int32_t mapSecureBuffer;
74     /* The supported formats are defined in gralloc_priv.h to
75      * support legacy code*/
76     uint32_t s3dFormat;
77     /* VENUS output buffer is linear for UBWC Interlaced video */
78     uint32_t linearFormat;
79     /* Set by graphics to indicate that this buffer will be written to but not
80      * swapped out */
81     uint32_t isSingleBufferMode;
82     /* Set by camera to program the VT Timestamp */
83     uint64_t vtTimeStamp;
84 };
85 
86 enum DispParamType {
87     UNUSED0                = 0x0001,
88     UNUSED1                = 0x0002,
89     PP_PARAM_INTERLACED    = 0x0004,
90     UNUSED2                = 0x0008,
91     UNUSED3                = 0x0010,
92     UNUSED4                = 0x0020,
93     UNUSED5                = 0x0040,
94     UPDATE_BUFFER_GEOMETRY = 0x0080,
95     UPDATE_REFRESH_RATE    = 0x0100,
96     UPDATE_COLOR_SPACE     = 0x0200,
97     MAP_SECURE_BUFFER      = 0x0400,
98     S3D_FORMAT             = 0x0800,
99     LINEAR_FORMAT          = 0x1000,
100     SET_IGC                = 0x2000,
101     SET_SINGLE_BUFFER_MODE = 0x4000,
102     SET_VT_TIMESTAMP       = 0x8000,
103 };
104 
105 enum DispFetchParamType {
106     GET_PP_PARAM_INTERLACED  = 0x0004,
107     GET_BUFFER_GEOMETRY      = 0x0080,
108     GET_REFRESH_RATE         = 0x0100,
109     GET_COLOR_SPACE          = 0x0200,
110     GET_MAP_SECURE_BUFFER    = 0x0400,
111     GET_S3D_FORMAT           = 0x0800,
112     GET_LINEAR_FORMAT        = 0x1000,
113     GET_IGC                  = 0x2000,
114     GET_SINGLE_BUFFER_MODE   = 0x4000,
115     GET_VT_TIMESTAMP         = 0x8000,
116 };
117 
118 struct private_handle_t;
119 int setMetaData(struct private_handle_t *handle, enum DispParamType paramType,
120         void *param);
121 
122 int getMetaData(struct private_handle_t *handle, enum DispFetchParamType paramType,
123         void *param);
124 
125 int copyMetaData(struct private_handle_t *src, struct private_handle_t *dst);
126 #ifdef __cplusplus
127 }
128 #endif
129 
130 #endif /* _QDMETADATA_H */
131 
132