Home | History | Annotate | Download | only in libqdutils 
      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 S3DGpuComp_t {
     61     int32_t displayId; /* on which display S3D is composed by client */
     62     uint32_t s3dMode; /* the S3D format of this layer to be accessed by client */
     63 };
     64 
     65 struct MetaData_t {
     66     int32_t operation;
     67     int32_t interlaced;
     68     struct BufferDim_t bufferDim;
     69     float refreshrate;
     70     enum ColorSpace_t colorSpace;
     71     enum IGC_t igc;
     72      /* Gralloc sets PRIV_SECURE_BUFFER flag to inform that the buffers are from
     73       * ION_SECURE. which should not be mapped. However, for GPU post proc
     74       * feature, GFX needs to map this buffer, in the client context and in SF
     75       * context, it should not. Hence to differentiate, add this metadata field
     76       * for clients to set, and GPU will to read and know when to map the
     77       * SECURE_BUFFER(ION) */
     78     int32_t mapSecureBuffer;
     79     /* The supported formats are defined in gralloc_priv.h to
     80      * support legacy code*/
     81     uint32_t s3dFormat;
     82     /* VENUS output buffer is linear for UBWC Interlaced video */
     83     uint32_t linearFormat;
     84     /* Set by graphics to indicate that this buffer will be written to but not
     85      * swapped out */
     86     uint32_t isSingleBufferMode;
     87     /* Indicate GPU to draw S3D layer on dedicate display device */
     88     struct S3DGpuComp_t s3dComp;
     89 
     90     /* Set by camera to program the VT Timestamp */
     91     uint64_t vtTimeStamp;
     92 };
     93 
     94 enum DispParamType {
     95     SET_VT_TIMESTAMP         = 0x0001,
     96     UNUSED1                  = 0x0002,
     97     PP_PARAM_INTERLACED      = 0x0004,
     98     UNUSED2                  = 0x0008,
     99     UNUSED3                  = 0x0010,
    100     UNUSED4                  = 0x0020,
    101     UNUSED5                  = 0x0040,
    102     UPDATE_BUFFER_GEOMETRY   = 0x0080,
    103     UPDATE_REFRESH_RATE      = 0x0100,
    104     UPDATE_COLOR_SPACE       = 0x0200,
    105     MAP_SECURE_BUFFER        = 0x0400,
    106     S3D_FORMAT               = 0x0800,
    107     LINEAR_FORMAT            = 0x1000,
    108     SET_IGC                  = 0x2000,
    109     SET_SINGLE_BUFFER_MODE   = 0x4000,
    110     SET_S3D_COMP             = 0x8000,
    111 };
    112 
    113 enum DispFetchParamType {
    114     GET_VT_TIMESTAMP         = 0x0001,
    115     GET_PP_PARAM_INTERLACED  = 0x0004,
    116     GET_BUFFER_GEOMETRY      = 0x0080,
    117     GET_REFRESH_RATE         = 0x0100,
    118     GET_COLOR_SPACE          = 0x0200,
    119     GET_MAP_SECURE_BUFFER    = 0x0400,
    120     GET_S3D_FORMAT           = 0x0800,
    121     GET_LINEAR_FORMAT        = 0x1000,
    122     GET_IGC                  = 0x2000,
    123     GET_SINGLE_BUFFER_MODE   = 0x4000,
    124     GET_S3D_COMP             = 0x8000,
    125 };
    126 
    127 struct private_handle_t;
    128 int setMetaData(struct private_handle_t *handle, enum DispParamType paramType,
    129         void *param);
    130 
    131 int getMetaData(struct private_handle_t *handle, enum DispFetchParamType paramType,
    132         void *param);
    133 
    134 int copyMetaData(struct private_handle_t *src, struct private_handle_t *dst);
    135 
    136 int clearMetaData(struct private_handle_t *handle, enum DispParamType paramType);
    137 
    138 #ifdef __cplusplus
    139 }
    140 #endif
    141 
    142 #endif /* _QDMETADATA_H */
    143 
    144