xref: /utopia/UTPA2-700.0.x/modules/xc/api/ace/ACE_private.h (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)
1 //<MStar Software>
2 //******************************************************************************
3 // MStar Software
4 // Copyright (c) 2010 - 2012 MStar Semiconductor, Inc. All rights reserved.
5 // All software, firmware and related documentation herein ("MStar Software") are
6 // intellectual property of MStar Semiconductor, Inc. ("MStar") and protected by
7 // law, including, but not limited to, copyright law and international treaties.
8 // Any use, modification, reproduction, retransmission, or republication of all
9 // or part of MStar Software is expressly prohibited, unless prior written
10 // permission has been granted by MStar.
11 //
12 // By accessing, browsing and/or using MStar Software, you acknowledge that you
13 // have read, understood, and agree, to be bound by below terms ("Terms") and to
14 // comply with all applicable laws and regulations
15 //
16 // 1. MStar shall retain any and all right, ownership and interest to MStar
17 //    Software and any modification/derivatives thereof.
18 //    No right, ownership, or interest to MStar Software and any
19 //    modification/derivatives thereof is transferred to you under Terms.
20 //
21 // 2. You understand that MStar Software might include, incorporate or be
22 //    supplied together with third party`s software and the use of MStar
23 //    Software may require additional licenses from third parties.
24 //    Therefore, you hereby agree it is your sole responsibility to separately
25 //    obtain any and all third party right and license necessary for your use of
26 //    such third party`s software.
27 //
28 // 3. MStar Software and any modification/derivatives thereof shall be deemed as
29 //    MStar`s confidential information and you agree to keep MStar`s
30 //    confidential information in strictest confidence and not disclose to any
31 //    third party.
32 //
33 // 4. MStar Software is provided on an "AS IS" basis without warranties of any
34 //    kind. Any warranties are hereby expressly disclaimed by MStar, including
35 //    without limitation, any warranties of merchantability, non-infringement of
36 //    intellectual property rights, fitness for a particular purpose, error free
37 //    and in conformity with any international standard.  You agree to waive any
38 //    claim against MStar for any loss, damage, cost or expense that you may
39 //    incur related to your use of MStar Software.
40 //    In no event shall MStar be liable for any direct, indirect, incidental or
41 //    consequential damages, including without limitation, lost of profit or
42 //    revenues, lost or damage of data, and unauthorized system use.
43 //    You agree that this Section 4 shall still apply without being affected
44 //    even if MStar Software has been modified by MStar in accordance with your
45 //    request or instruction for your use, except otherwise agreed by both
46 //    parties in writing.
47 //
48 // 5. If requested, MStar may from time to time provide technical supports or
49 //    services in relation with MStar Software to you for your use of
50 //    MStar Software in conjunction with your or your customer`s product
51 //    ("Services").
52 //    You understand and agree that, except otherwise agreed by both parties in
53 //    writing, Services are provided on an "AS IS" basis and the warranty
54 //    disclaimer set forth in Section 4 above shall apply.
55 //
56 // 6. Nothing contained herein shall be construed as by implication, estoppels
57 //    or otherwise
58 //    (a) conferring any license or right to use MStar name, trademark, service
59 //        mark, symbol or any other identification;
60 //    (b) obligating MStar or any of its affiliates to furnish any person,
61 //        including without limitation, you and your customers, any assistance
62 //        of any kind whatsoever, or any information; or
63 //    (c) conferring any license or right under any intellectual property right.
64 //
65 // 7. These terms shall be governed by and construed in accordance with the laws
66 //    of Taiwan, R.O.C., excluding its conflict of law rules.
67 //    Any and all dispute arising out hereof or related hereto shall be finally
68 //    settled by arbitration referred to the Chinese Arbitration Association,
69 //    Taipei in accordance with the ROC Arbitration Law and the Arbitration
70 //    Rules of the Association by three (3) arbitrators appointed in accordance
71 //    with the said Rules.
72 //    The place of arbitration shall be in Taipei, Taiwan and the language shall
73 //    be English.
74 //    The arbitration award shall be final and binding to both parties.
75 //
76 //******************************************************************************
77 
78 #ifndef _API_ACE_PRIV_H_
79 #define _API_ACE_PRIV_H_
80 
81 
82 ////////////////////////////////////////////////////////////////////////////////
83 // Header Files
84 ////////////////////////////////////////////////////////////////////////////////
85 #ifdef __cplusplus
86 extern "C"
87 {
88 #endif
89 
90 typedef struct __attribute__((packed))
91 {
92     E_XC_ACE_MWE_FUNC  _MWEFunc;
93     MS_U32       _MWETimer;
94     MS_U32       _MWEFlag;
95     MWE_RECT gMWERect;
96 
97     XC_ACE_InitData g_XC_ACE_InitData;
98     MS_BOOL _bMWESkipDriverSetting;
99     E_XC_ACE_MWE_MIRROR_TYPE _enMirrorMode;
100 
101     MS_U8  g_u8MotionStableCnt;
102     MS_U8  g_u8LumaStableCnt;
103     MS_U8  g_u8FlickStableCnt;
104     MS_BOOL  g_bACEModuleInited[2];
105 } ST_APIACE;
106 
107 typedef struct __attribute__((packed))
108 {
109     MS_U16 u16RedGain;
110     MS_U16 u16GreenGain;
111     MS_U16 u16BlueGain;
112 } ACE_PostRGBGainSetting;
113 
114 typedef struct __attribute__((packed))
115 {
116     MS_U16 wContrast;
117     MS_U16 wRCon;
118     MS_U16 wGCon;
119     MS_U16 wBCon;
120     MS_U8 ucSaturation;
121     MS_U8 ucHue;
122     short sContrastRGBMatrix[3][3];
123     short sVideoSatHueMatrix[3][3];
124     short psColorCorrectionMatrix[32]; // this variable must pointer to a array[3][3]
125 #if !defined (__aarch64__)
126    // MS_U32 u32AlignmentDummy0;
127 #endif
128     short* psPCsRGBMatrix; // sRGB matrix for PC, this variable must pointer to a array[3][3]
129 #if !defined (__aarch64__)
130     MS_U32 u32AlignmentDummy1;
131 #endif
132     short psYVUtoRGBMatrix[9]; // this variable must pointer to a array[3][3]
133 #if !defined (__aarch64__)
134     //MS_U32 u32AlignmentDummy2;
135 #endif
136     MS_U8 bForceYUVtoRGB : 1;
137     MS_U8 ucYUVtoRGBMatrixSel : 2;
138 }StruAceInfo;
139 
140 typedef struct __attribute__((packed))
141 {
142     ACE_PostRGBGainSetting stACEPostGainSetting[2];
143     StruAceInfo s_AceInfo[2];
144     PanelSizeType MWEPanel;
145     MS_BOOL bBypassColorMatrix;
146 } ST_DRVACE;
147 
148 typedef struct __attribute__((packed))
149 {
150     MS_BOOL  bMainWinSkipWaitVsyn;
151     MS_BOOL  bSubWinSkipWaitVsyn;
152 } ST_HALACE;
153 
154 typedef struct __attribute__((packed))
155 {
156     MS_BOOL bResourceRegistered;
157     ST_APIACE stapiACE;
158     ST_DRVACE stdrvACE;
159     ST_HALACE sthalACE;
160 }ACE_RESOURCE_PRIVATE;
161 
162 typedef struct
163 {
164     MS_U32      ACE_Reg[2];
165     MS_BOOL     bSetPCYUV2RGB_Enable;
166     XC_ACE_color_temp_ex2 stColorTemp;
167 
168     MS_BOOL     bUseYUVSpace;
169     MS_U8       u8Contrast;
170 
171     MS_U8       u8Brightness_R;
172     MS_U8       u8Brightness_G;
173     MS_U8       u8Brightness_B;
174 
175     MS_U8       u8Hue;
176     MS_U8       u8Saturation;
177     MS_U8       u8Sharpness;
178 }ACE_REGS_SAVE_AREA;
179 #define _ACE_SEMAPHORE_ENTRY(pInst)                                                              \
180         if(MDrv_ACE_Get_Semaphore(pInst) != UTOPIA_STATUS_SUCCESS)                               \
181         {      }
182 
183 #define _ACE_GET_INST_PRIVATE()  \
184     ACE_INSTANCE_PRIVATE *psACEInstPri = NULL; \
185     UtopiaInstanceGetPrivate(pInstance, (void**)&psACEInstPri);
186 
187 
188 #define _ACE_GET_VARIABLE()  \
189     ACE_INSTANCE_PRIVATE *psACEInstPri = NULL; \
190     UtopiaInstanceGetPrivate(pInstance, (void**)&psACEInstPri);    \
191     ACE_RESOURCE_PRIVATE *psACEResPri = NULL; \
192     UtopiaResourceGetPrivate(pu32ACERes[psACEInstPri->u32DeviceID],(void**)(&psACEResPri));
193 
194 #define _ACE_SEMAPHORE_RETURN(pInst)                                                             \
195             MDrv_ACE_Release_Semaphore(pInst);
196 
197 
198 typedef MS_BOOL                             (*IOCTL_ACE_INIT)                                   (void *pInstance, XC_ACE_InitData *pstXC_ACE_InitData, MS_U32 u32InitDataLen);
199 typedef MS_BOOL                             (*IOCTL_ACE_EXIT)                                   (void *pInstance );
200 typedef void                                (*IOCTL_ACE_DMS)                                    (void *pInstance, MS_BOOL eWindow, MS_BOOL bisATV);
201 typedef void                                (*IOCTL_ACE_SETPCYUV2RGB)                           (void *pInstance, MS_BOOL eWindow, MS_BOOL bEnable);
202 typedef void                                (*IOCTL_ACE_SELECTYUVTORGBMATRIX)                   (void *pInstance, MS_BOOL eWindow, MS_U8 ucMatrix, MS_S16* psUserYUVtoRGBMatrix);
203 typedef void                                (*IOCTL_ACE_SETCOLORCORRECTIONTABLE)                (void *pInstance, MS_BOOL bScalerWin);
204 typedef void                                (*IOCTL_ACE_SETPCSRGBTABLE)                         (void *pInstance, MS_BOOL bScalerWin);
205 typedef void                                (*IOCTL_ACE_GETCOLORMATRIX)                         (void *pInstance, MS_BOOL eWindow, MS_U16* pu16Matrix);
206 typedef void                                (*IOCTL_ACE_SETCOLORMATRIX)                         (void *pInstance, MS_BOOL eWindow, MS_U16* pu16Matrix);
207 typedef E_XC_ACE_RESULT                     (*IOCTL_ACE_SETBYPASSCOLORMATRIX)                   (void *pInstance, MS_BOOL bEnable );
208 typedef MS_BOOL                             (*IOCTL_ACE_SETIHC)                                 (void *pInstance, MS_BOOL bScalerWin, XC_ACE_IHC_COLOR_TYPE eIHC, MS_U8 u8Val);
209 typedef MS_BOOL                             (*IOCTL_ACE_SETICC)                                 (void *pInstance, MS_BOOL bScalerWin, XC_ACE_ICC_COLOR_TYPE eICC, MS_U8 u8Val);
210 typedef MS_BOOL                             (*IOCTL_ACE_SETIBC)                                 (void *pInstance, MS_BOOL bScalerWin, XC_ACE_IBC_COLOR_TYPE eIBC, MS_U8 u8Val);
211 typedef void                                (*IOCTL_ACE_PATCHDTGCOLORCHECKER)                   (void *pInstance, MS_U8 u8Mode);
212 typedef MS_U16                              (*IOCTL_ACE_GETACEINFO)                             (void *pInstance, MS_BOOL bWindow, E_XC_ACE_INFOTYPE eXCACEInfoType );
213 typedef void                                (*IOCTL_ACE_GETACEINFOEX)                           (void *pInstance, MS_BOOL bWindow, XC_ACE_InfoEx *pInfoEx);
214 typedef void                                (*IOCTL_ACE_PICSETCONTRAST)                         (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, MS_U8 u8Contrast);
215 typedef void                                (*IOCTL_ACE_PICSETBRIGHTNESS)                       (void *pInstance, MS_BOOL eWindow, MS_U8 u8Brightness_R, MS_U8 u8Brightness_G, MS_U8 u8Brightness_B);
216 typedef void                                (*IOCTL_ACE_PICSETBRIGHTNESSPRECISE)                (void *pInstance, MS_BOOL eWindow, MS_U16 u16Brightness_R, MS_U16 u16Brightness_G, MS_U16 u16Brightness_B);
217 typedef MS_BOOL                             (*IOCTL_ACE_PICSET_PRE_Y_OFFSET)                    (void *pInstance, MS_BOOL eWindow, MS_U8 u8PreYOffset);
218 typedef MS_U8                               (*IOCTL_ACE_PICGET_PRE_Y_OFFSET)                    (void *pInstance, MS_BOOL eWindow);
219 typedef void                                (*IOCTL_ACE_PICSETHUE)                              (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, MS_U8 u8Hue );
220 typedef E_XC_ACE_RESULT                     (*IOCTL_ACE_SKIPWAITVSYNC)                          (void *pInstance, MS_BOOL eWindow,MS_BOOL bIsSkipWaitVsyn);
221 typedef void                                (*IOCTL_ACE_PICSETSATURATION)                       (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, MS_U8 u8Saturation );
222 typedef void                                (*IOCTL_ACE_PICSETSHARPNESS)                        (void *pInstance, MS_BOOL eWindow, MS_U8 u8Sharpness );
223 typedef void                                (*IOCTL_ACE_PICSETCOLORTEMP)                        (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp* pstColorTemp);
224 typedef void                                (*IOCTL_ACE_PICSETCOLORTEMPEX)                      (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp_ex* pstColorTemp);
225 typedef void                                (*IOCTL_ACE_PICSETCOLORTEMP_10BITS)                      (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp_ex* pstColorTemp);
226 typedef void                                (*IOCTL_ACE_PICSETPOSTCOLORTEMP_V02)                (void *pInstance, MS_BOOL eWindow, XC_ACE_color_temp_ex2* pstColorTemp);
227 typedef void                                (*IOCTL_ACE_SETFLESHTONE)                           (void *pInstance, MS_BOOL eWindow, MS_BOOL bEn, MS_U8 u8FleshTone);
228 typedef void                                (*IOCTL_ACE_SETBLACKADJUST)                         (void *pInstance, MS_BOOL eWindow, MS_U8 u8BlackAdjust);
229 typedef MS_BOOL                             (*IOCTL_ACE_SET_IHC_SRAM)                           (void *pInstance, MS_U16 *pBuf, MS_U16 u16ByteSize);
230 typedef MS_BOOL                             (*IOCTL_ACE_SET_ICC_SRAM)                           (void *pInstance, MS_U16 *pBuf, MS_U16 u16ByteSize);
231 typedef void                                (*IOCTL_ACE_ENABLEMWE)                              (void *pInstance, MS_BOOL bEnable);
232 typedef void                                (*IOCTL_ACE_MWECLONEVISUALEFFECT)                   (void *pInstance);
233 typedef MS_BOOL                             (*IOCTL_ACE_MWESETREGTABLE)                         (void *pInstance, XC_ACE_TAB_Info *pMWETable);
234 typedef MS_BOOL                             (*IOCTL_ACE_SETMWELOADFROMPQ)                       (void *pInstance, MS_BOOL bEnable);
235 typedef MS_BOOL                             (*IOCTL_ACE_MWESTATUS)                              (void *pInstance);
236 typedef void                                (*IOCTL_ACE_MWEHANDLE)                              (void *pInstance);
237 typedef void                                (*IOCTL_ACE_MWEFUNCSEL)                             (void *pInstance, MS_BOOL eWindow, E_XC_ACE_MWE_FUNC mwe_func);
238 typedef void                                (*IOCTL_ACE_MWESETDISPWIN)                          (void *pInstance, MS_U16 u16MWE_Disp_Hstart, MS_U16 u16MWE_Disp_Vstart, MS_U16 u16MWE_Disp_Width, MS_U16 u16MWE_Disp_Height);
239 typedef void                                (*IOCTL_ACE_3DCLONEPQMAP)                           (void *pInstance, XC_ACE_WEAVETYPE enWeaveType);
240 typedef void                                (*IOCTL_ACE_DNR_BLENDING_NRTBL)                     (void *pInstance, MS_U8 *pu8NewNR, MS_U8 u8Weight, MS_U8 u8Step, MS_U16 *pu16PreY0, MS_U16 *pu16PreY1, MS_U8 *pu8NRTBL);
241 typedef MS_U16                              (*IOCTL_ACE_DNR_BLENDING_MISC)                      (void *pInstance, MS_U8 u8NewItem, MS_U16 u16PreItem, MS_U8 u8Weight, MS_U8 u8Step);
242 typedef MS_U8                               (*IOCTL_ACE_DNR_BLENDING)                           (void *pInstance, MS_U8 u8NewItem, MS_U16 u16PreItem, MS_U8 u8Weight);
243 typedef MS_U16                              (*IOCTL_ACE_DNR_GET_PRECISIONSHIFT)                 (void *pInstance);
244 typedef MS_U8                               (*IOCTL_ACE_DNR_GETMOTION_WEIGHT)                   (void *pInstance, MS_U8 u8CurMotion, MS_U8 u8PreMotion, MS_U8 u8CurMotionLvl, MS_U8 u8PreMotionLvl, MS_U8 u8DeFlick_Thre, MS_U8 u8DeFilick_Step);
245 typedef MS_U8                               (*IOCTL_ACE_DNR_GETLUMA_WEIGHT)                     (void *pInstance, MS_U8 u8CurAvgLuma, MS_U8 u8PreAvgLuam, MS_U8 u8CurLumaLvl, MS_U8 u8PreLumaLvl, MS_U8 u8DeFlick_Th, MS_U8 u8DeFlick_Step);
246 typedef MS_U8                               (*IOCTL_ACE_DNR_GETNOISE_WEIGHT)                    (void *pInstance, MS_U8 u8CurNoise, MS_U8 u8PreNoise, MS_U8 u8Range, MS_U8 u8DeFlick_Th, MS_U8 u8DeFlick_Step);
247 typedef MS_U8                               (*IOCTL_ACE_DNR_GETMOTION)                          (void *pInstance);
248 typedef void                                (*IOCTL_ACE_DNR_INIT_MOTION)                        (void *pInstance);
249 typedef void                                (*IOCTL_ACE_DNR_INIT_LUMA)                          (void *pInstance);
250 typedef void                                (*IOCTL_ACE_DNR_INIT_NOISE)                         (void *pInstance);
251 typedef void                                (*IOCTL_ACE_DNR_SETPARAM)                           (void *pInstance, MS_BOOL eWindow, XC_ACE_DNR_Param eParam, MS_U16 u16val);
252 typedef MS_U8                               (*IOCTL_ACE_DNR_GETPARAM)                           (void *pInstance, MS_BOOL eWindow, XC_ACE_DNR_Param eParam);
253 typedef void                                (*IOCTL_ACE_DNR_SETNRTBL)                           (void *pInstance, MS_U8 *pu8Tbl);
254 typedef E_XC_ACE_RESULT                     (*IOCTL_ACE_GETLIBVER)                              (void *pInstance, const MSIF_Version **ppVersion);
255 typedef const XC_ACE_ApiInfo *              (*IOCTL_ACE_GETINFO)                                (void *pInstance);
256 typedef MS_BOOL                             (*IOCTL_ACE_GETSTATUS)                              (void *pInstance, XC_ACE_ApiStatus *pDrvStatus, MS_BOOL bWindow);
257 typedef MS_BOOL                             (*IOCTL_ACE_SETDBGLEVEL)                            (void *pInstance, MS_U16 u16DbgSwitch);
258 typedef void                                (*IOCTL_ACE_COLORCORRECTIONTABLE)                   (void *pInstance, MS_BOOL bScalerWin, MS_S16 *psColorCorrectionTable );
259 typedef void                                (*IOCTL_ACE_SETCOLORMATRIXCONTROL)                  (void *pInstance, MS_BOOL bScalerWin, MS_BOOL bEnable );
260 typedef void                                (*IOCTL_ACE_SETRBCHANNELRANGE)                      (void *pInstance, MS_BOOL bScalerWin, MS_BOOL bRange );
261 typedef void                                (*IOCTL_ACE_PICSETPOSTCOLORTEMP)                    (void *pInstance, MS_BOOL eWindow, XC_ACE_color_temp* pstColorTemp);
262 typedef void                                (*IOCTL_ACE_PICSETPOSTCOLORTEMPEX)                  (void *pInstance, MS_BOOL eWindow, XC_ACE_color_temp_ex* pstColorTemp);
263 typedef void                                (*IOCTL_ACE_PICSETPOSTCOLORTEMP2)                   (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp* pstColorTemp);
264 typedef void                                (*IOCTL_ACE_PICSETPOSTCOLORTEMP2EX)                 (void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp_ex* pstColorTemp);
265 typedef MS_U32                              (*IOCTL_ACE_SET_POWERSTATE)                         (void*, EN_POWER_MODE);
266 typedef MS_BOOL                             (*IOCTL_ACE_SETHDRINIT)                             (void*, XC_ACE_HDRinit *pstACE_HDRInitData);
267 
268 // OBSOLETE FUNCTION POINTER END
269 
270 typedef struct __attribute__((packed))
271 {
272     MS_U32 u32DeviceID;
273     IOCTL_ACE_INIT                                  fpACE_Init;
274     IOCTL_ACE_EXIT                                  fpACE_Exit;
275     IOCTL_ACE_DMS                                   fpACE_DMS;
276     IOCTL_ACE_SETPCYUV2RGB                          fpACE_SetPCYUV2RGB;
277     IOCTL_ACE_SELECTYUVTORGBMATRIX                  fpACE_SelectYUVtoRGBMatrix;
278     IOCTL_ACE_SETCOLORCORRECTIONTABLE               fpACE_SetColorCorrectionTable;
279     IOCTL_ACE_SETPCSRGBTABLE                        fpACE_SetPCsRGBTable;
280     IOCTL_ACE_GETCOLORMATRIX                        fpACE_GetColorMatrix;
281     IOCTL_ACE_SETCOLORMATRIX                        fpACE_SetColorMatrix;
282     IOCTL_ACE_SETBYPASSCOLORMATRIX                  fpACE_SetBypassColorMatrix;
283     IOCTL_ACE_SETIHC                                fpACE_SetIHC;
284     IOCTL_ACE_SETICC                                fpACE_SetICC;
285     IOCTL_ACE_SETIBC                                fpACE_SetIBC;
286     IOCTL_ACE_PATCHDTGCOLORCHECKER                  fpACE_PatchDTGColorChecker;
287     IOCTL_ACE_GETACEINFO                            fpACE_GetACEInfo;
288     IOCTL_ACE_GETACEINFOEX                          fpACE_GetACEInfoEx;
289     IOCTL_ACE_PICSETCONTRAST                        fpACE_PicSetContrast;
290     IOCTL_ACE_PICSETBRIGHTNESS                      fpACE_PicSetBrightness;
291     IOCTL_ACE_PICSETBRIGHTNESSPRECISE               fpACE_PicSetBrightnessPrecise;
292     IOCTL_ACE_PICSET_PRE_Y_OFFSET                   fpACE_PicSetPreYOffset;
293     IOCTL_ACE_PICGET_PRE_Y_OFFSET                   fpACE_PicGetPreYOffset;
294     IOCTL_ACE_PICSETHUE                             fpACE_PicSetHue;
295     IOCTL_ACE_SKIPWAITVSYNC                         fpACE_SkipWaitVsync;
296     IOCTL_ACE_PICSETSATURATION                      fpACE_PicSetSaturation;
297     IOCTL_ACE_PICSETSHARPNESS                       fpACE_PicSetSharpness;
298     IOCTL_ACE_PICSETCOLORTEMP                       fpACE_PicSetColorTemp;
299     IOCTL_ACE_PICSETCOLORTEMPEX                     fpACE_PicSetColorTempEx;
300     IOCTL_ACE_PICSETCOLORTEMP_10BITS                     fpACE_PicSetColorTemp_10Bits;
301     IOCTL_ACE_PICSETPOSTCOLORTEMP_V02               fpACE_PicSetPostColorTemp_V02;
302     IOCTL_ACE_SETFLESHTONE                          fpACE_SetFleshTone;
303     IOCTL_ACE_SETBLACKADJUST                        fpACE_SetBlackAdjust;
304     IOCTL_ACE_SET_IHC_SRAM                          fpACE_Set_IHC_SRAM;
305     IOCTL_ACE_SET_ICC_SRAM                          fpACE_Set_ICC_SRAM;
306     IOCTL_ACE_ENABLEMWE                             fpACE_EnableMWE;
307     IOCTL_ACE_MWECLONEVISUALEFFECT                  fpACE_MWECloneVisualEffect;
308     IOCTL_ACE_MWESETREGTABLE                        fpACE_MWESetRegTable;
309     IOCTL_ACE_SETMWELOADFROMPQ                      fpACE_SetMWELoadFromPQ;
310     IOCTL_ACE_MWESTATUS                             fpACE_MWEStatus;
311     IOCTL_ACE_MWEHANDLE                             fpACE_MWEHandle;
312     IOCTL_ACE_MWEFUNCSEL                            fpACE_MWEFuncSel;
313     IOCTL_ACE_MWESETDISPWIN                         fpACE_MWESetDispWin;
314     IOCTL_ACE_3DCLONEPQMAP                          fpACE_3DClonePQMap;
315     IOCTL_ACE_DNR_BLENDING_NRTBL                    fpACE_DNR_Blending_NRTbl;
316     IOCTL_ACE_DNR_BLENDING_MISC                     fpACE_DNR_Blending_MISC;
317     IOCTL_ACE_DNR_BLENDING                          fpACE_DNR_Blending;
318     IOCTL_ACE_DNR_GET_PRECISIONSHIFT                fpACE_DNR_Get_PrecisionShift;
319     IOCTL_ACE_DNR_GETMOTION_WEIGHT                  fpACE_DNR_GetMotion_Weight;
320     IOCTL_ACE_DNR_GETLUMA_WEIGHT                    fpACE_DNR_GetLuma_Weight;
321     IOCTL_ACE_DNR_GETNOISE_WEIGHT                   fpACE_DNR_GetNoise_Weight;
322     IOCTL_ACE_DNR_GETMOTION                         fpACE_DNR_GetMotion;
323     IOCTL_ACE_DNR_INIT_MOTION                       fpACE_DNR_Init_Motion;
324     IOCTL_ACE_DNR_INIT_LUMA                         fpACE_DNR_Init_Luma;
325     IOCTL_ACE_DNR_INIT_NOISE                        fpACE_DNR_Init_Noise;
326     IOCTL_ACE_DNR_SETPARAM                          fpACE_DNR_SetParam;
327     IOCTL_ACE_DNR_GETPARAM                          fpACE_DNR_GetParam;
328     IOCTL_ACE_DNR_SETNRTBL                          fpACE_DNR_SetNRTbl;
329     IOCTL_ACE_GETLIBVER                             fpACE_GetLibVer;
330     IOCTL_ACE_GETINFO                               fpACE_GetInfo;
331     IOCTL_ACE_GETSTATUS                             fpACE_GetStatus;
332     IOCTL_ACE_SETDBGLEVEL                           fpACE_SetDbgLevel;
333     IOCTL_ACE_COLORCORRECTIONTABLE                  fpACE_ColorCorrectionTable;
334     IOCTL_ACE_SETCOLORMATRIXCONTROL                 fpACE_SetColorMatrixControl;
335     IOCTL_ACE_SETRBCHANNELRANGE                     fpACE_SetRBChannelRange;
336     IOCTL_ACE_PICSETPOSTCOLORTEMP                   fpACE_PicSetPostColorTemp;
337     IOCTL_ACE_PICSETPOSTCOLORTEMPEX                 fpACE_PicSetPostColorTempEx;
338     IOCTL_ACE_PICSETPOSTCOLORTEMP2                  fpACE_PicSetPostColorTemp2;
339     IOCTL_ACE_PICSETPOSTCOLORTEMP2EX                fpACE_PicSetPostColorTemp2Ex;
340     IOCTL_ACE_SET_POWERSTATE                        fpACE_SetPowerState;
341     IOCTL_ACE_SETHDRINIT                            fpACE_SetHDRInit;
342 
343     // OBSOLETE FUNCTION POINTER START
344     // avoid using these functions pointers!!!!
345     //
346     // OBSOLETE FUNCTION POINTER END
347     // avoid using these functions pointers!!!!
348 }ACE_INSTANCE_PRIVATE;
349 
350 MS_BOOL MApi_XC_ACE_Init_U2(void *pInstance, XC_ACE_InitData *pstXC_ACE_InitData, MS_U32 u32InitDataLen);
351 MS_BOOL MApi_XC_ACE_Exit_U2(void *pInstance);
352 void MApi_XC_ACE_DMS_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bisATV);
353 void MApi_XC_ACE_SetPCYUV2RGB_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bEnable);
354 void MApi_XC_ACE_SelectYUVtoRGBMatrix_U2(void *pInstance, MS_BOOL eWindow, MS_U8 ucMatrix, MS_S16* psUserYUVtoRGBMatrix);
355 void MApi_XC_ACE_SetColorCorrectionTable_U2(void *pInstance, MS_BOOL bScalerWin);
356 void MApi_XC_ACE_SetPCsRGBTable_U2(void *pInstance, MS_BOOL bScalerWin);
357 void MApi_XC_ACE_GetColorMatrix_U2(void *pInstance, MS_BOOL eWindow, MS_U16* pu16Matrix);
358 void MApi_XC_ACE_SetColorMatrix_U2(void *pInstance, MS_BOOL eWindow, MS_U16* pu16Matrix);
359 E_XC_ACE_RESULT MApi_XC_ACE_SetBypassColorMatrix_U2(void *pInstance, MS_BOOL bEnable);
360 MS_BOOL MApi_XC_ACE_SetIHC_U2(void *pInstance, MS_BOOL bScalerWin, XC_ACE_IHC_COLOR_TYPE eIHC, MS_U8 u8Val);
361 MS_BOOL MApi_XC_ACE_SetICC_U2(void *pInstance, MS_BOOL bScalerWin, XC_ACE_ICC_COLOR_TYPE eICC, MS_U8 u8Val);
362 MS_BOOL MApi_XC_ACE_SetIBC_U2(void *pInstance, MS_BOOL bScalerWin, XC_ACE_IBC_COLOR_TYPE eIBC, MS_U8 u8Val);
363 void MApi_XC_ACE_PatchDTGColorChecker_U2(void *pInstance, MS_U8 u8Mode);
364 MS_U16 MApi_XC_ACE_GetACEInfo_U2(void *pInstance, MS_BOOL bWindow, E_XC_ACE_INFOTYPE eXCACEInfoType);
365 void MApi_XC_ACE_GetACEInfoEx_U2(void *pInstance, MS_BOOL bWindow, XC_ACE_InfoEx *pInfoEx);
366 void MApi_XC_ACE_PicSetBrightness_U2(void *pInstance, MS_BOOL eWindow, MS_U8 u8Brightness_R, MS_U8 u8Brightness_G, MS_U8 u8Brightness_B);
367 void MApi_XC_ACE_PicSetBrightnessPrecise_U2(void *pInstance, MS_BOOL eWindow, MS_U16 u16Brightness_R, MS_U16 u16Brightness_G, MS_U16 u16Brightness_B);
368 MS_BOOL MApi_XC_ACE_PicSetPreYOffset_U2(void *pInstance, MS_BOOL eWindow, MS_U8 u8PreYOffset);
369 MS_U8 MApi_XC_ACE_PicGetPreYOffset_U2(void *pInstance, MS_BOOL eWindow);
370 void MApi_XC_ACE_PicSetSharpness_U2(void *pInstance, MS_BOOL eWindow, MS_U8 u8Sharpness );
371 void MApi_XC_ACE_PicSetContrast_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, MS_U8 u8Contrast);
372 void MApi_XC_ACE_PicSetHue_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, MS_U8 u8Hue );
373 E_XC_ACE_RESULT MApi_XC_ACE_SkipWaitVsync_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bIsSkipWaitVsyn);
374 void MApi_XC_ACE_PicSetSaturation_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, MS_U8 u8Saturation);
375 void MApi_XC_ACE_SetFleshTone_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bEn, MS_U8 u8FleshTone);
376 void MApi_XC_ACE_SetBlackAdjust_U2(void *pInstance, MS_BOOL eWindow, MS_U8 u8BlackAdjust);
377 void MApi_XC_ACE_PicSetColorTemp_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp* pstColorTemp);
378 void MApi_XC_ACE_PicSetColorTempEx_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp_ex* pstColorTemp);
379 void MApi_XC_ACE_PicSetColorTemp_10Bits_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp_ex* pstColorTemp);
380 void MApi_XC_ACE_PicSetPostColorTemp_V02_U2(void *pInstance, MS_BOOL eWindow, XC_ACE_color_temp_ex2* pstColorTemp);
381 void MApi_XC_ACE_PicSetPostColorTemp_U2(void *pInstance, MS_BOOL eWindow, XC_ACE_color_temp* pstColorTemp);
382 void MApi_XC_ACE_PicSetPostColorTempEx_U2(void *pInstance, MS_BOOL eWindow, XC_ACE_color_temp_ex* pstColorTemp);
383 void MApi_XC_ACE_PicSetPostColorTemp2_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp* pstColorTemp);
384 void MApi_XC_ACE_PicSetPostColorTemp2Ex_U2(void *pInstance, MS_BOOL eWindow, MS_BOOL bUseYUVSpace, XC_ACE_color_temp_ex* pstColorTemp);
385 E_XC_ACE_RESULT MApi_XC_ACE_GetLibVer_U2(void *pInstance, const MSIF_Version **ppVersion);              // Get version
386 const XC_ACE_ApiInfo * MApi_XC_ACE_GetInfo_U2(void *pInstance);          // Get info from driver
387 MS_BOOL MApi_XC_ACE_GetStatus_U2(void *pInstance, XC_ACE_ApiStatus *pDrvStatus, MS_BOOL bWindow);    // Get DLC current status
388 MS_BOOL MApi_XC_ACE_SetDbgLevel_U2(void *pInstance, MS_U16 u16DbgSwitch);
389 void MApi_XC_ACE_EnableMWE_U2(void *pInstance, MS_BOOL bEnable);
390 void MApi_XC_ACE_MWESetMirrorMode_U2(void *pInstance, E_XC_ACE_MWE_MIRROR_TYPE eMirrorMode);
391 void MApi_XC_ACE_MWECloneVisualEffect_U2(void *pInstance);
392 void MApi_XC_ACE_3DClonePQMap_U2(void *pInstance, XC_ACE_WEAVETYPE enWeaveType);
393 MS_BOOL MApi_XC_ACE_MWESetRegTable_U2(void *pInstance, XC_ACE_TAB_Info *pMWETable);
394 MS_BOOL MApi_XC_ACE_SetMWELoadFromPQ_U2(void *pInstance, MS_BOOL bEnable);
395 void MApi_XC_ACE_MWESetDispWin_U2(void *pInstance, MS_U16 u16MWE_Disp_Hstart, MS_U16 u16MWE_Disp_Vstart, MS_U16 u16MWE_Disp_Width, MS_U16 u16MWE_Disp_Height);
396 MS_BOOL MApi_XC_ACE_MWEStatus_U2(void *pInstance);
397 void MApi_XC_ACE_MWEFuncSel_U2(void *pInstance, MS_BOOL eWindow, E_XC_ACE_MWE_FUNC  mwe_func);
398 void MApi_XC_ACE_MWEHandle_U2(void *pInstance);
399 MS_BOOL MApi_XC_ACE_Set_IHC_SRAM_U2(void *pInstance, MS_U16 *pBuf, MS_U16 u16ByteSize);
400 MS_BOOL MApi_XC_ACE_Set_ICC_SRAM_U2(void *pInstance, MS_U16 *pBuf, MS_U16 u16ByteSize);
401 MS_U16 MApi_XC_ACE_DNR_Get_PrecisionShift_U2(void *pInstance);
402 void MApi_XC_ACE_DNR_Blending_NRTbl_U2(
403     void *pInstance,
404     MS_U8 *pu8NewNR,
405     MS_U8 u8Weight,
406     MS_U8 u8Step,
407     MS_U16 *pu16PreY0,
408     MS_U16 *pu16PreY1,
409     MS_U8 *pu8NRTBL);
410 MS_U8 MApi_XC_ACE_DNR_Blending_U2(void *pInstance, MS_U8 u8NewItem, MS_U16 u16PreItem, MS_U8 u8Weight);
411 MS_U16 MApi_XC_ACE_DNR_Blending_MISC_U2(
412     void *pInstance,
413     MS_U8 u8NewItem,
414     MS_U16 u16PreItem,
415     MS_U8 u8Weight,
416     MS_U8 u8Step);
417 MS_U8 MApi_XC_ACE_DNR_GetMotion_U2(void *pInstance);
418 MS_U8 MApi_XC_ACE_DNR_GetMotion_Weight_U2(
419     void *pInstance,
420     MS_U8 u8CurMotion,
421     MS_U8 u8PreMotion,
422     MS_U8 u8CurMotionLvl,
423     MS_U8 u8PreMotionLvl,
424     MS_U8 u8DeFlick_Thre,
425     MS_U8 u8DeFilick_Step);
426 MS_U8  MApi_XC_ACE_DNR_GetLuma_Weight_U2(
427     void *pInstance,
428     MS_U8 u8CurAvgLuma,
429     MS_U8 u8PreAvgLuam,
430     MS_U8 u8CurLumaLvl,
431     MS_U8 u8PreLumaLvl,
432     MS_U8 u8DeFlick_Th,
433     MS_U8 u8DeFlick_Step);
434 MS_U8 MApi_XC_ACE_DNR_GetNoise_Weight_U2(
435     void *pInstance,
436     MS_U8 u8CurNoise,
437     MS_U8 u8PreNoise,
438     MS_U8 u8Range,
439     MS_U8 u8DeFlick_Th,
440     MS_U8 u8DeFlick_Step);
441 void MApi_XC_ACE_DNR_Init_Motion_U2(void *pInstance);
442 void MApi_XC_ACE_DNR_Init_Luma_U2(void *pInstance);
443 void MApi_XC_ACE_DNR_Init_Noise_U2(void *pInstance);
444 MS_U8 MApi_XC_ACE_DNR_GetParam_U2(void *pInstance, MS_BOOL eWindow, XC_ACE_DNR_Param eParam);
445 void MApi_XC_ACE_DNR_SetParam_U2(void *pInstance, MS_BOOL eWindow, XC_ACE_DNR_Param eParam, MS_U16 u16val);
446 void MApi_XC_ACE_DNR_SetNRTbl_U2(void *pInstance, MS_U8 *pu8Tbl);
447 void MApi_XC_ACE_ColorCorrectionTable_U2(void *pInstance, MS_BOOL bScalerWin, MS_S16 *psColorCorrectionTable);
448 void MApi_XC_ACE_SetColorMatrixControl_U2(void *pInstance, MS_BOOL bScalerWin, MS_BOOL bEnable);
449 void MApi_XC_ACE_SetRBChannelRange_U2(void *pInstance, MS_BOOL bScalerWin, MS_BOOL bRange);
450 MS_U32 MApi_XC_ACE_SetPowerState_U2(void* pInstance, EN_POWER_MODE enPowerState);
451 MS_BOOL MApi_XC_ACE_SetHDRInit_U2(void * pInstance ,XC_ACE_HDRinit * pstACE_HDRInitData);
452 
453 //internal use only
454 MS_U32 _XC_ACE_GET_DEVICE_NUM(void);
455 
456 void ACERegisterToUtopia(FUtopiaOpen ModuleType);
457 MS_U32 ACEOpen(void** ppInstance, const void* const pAttribute);
458 MS_U32 ACEClose(void* pInstance);
459 MS_U32 ACEIoctl(void* pInstance, MS_U32 u32Cmd, void* pArgs);
460 
461 #ifdef __cplusplus
462 }
463 #endif
464 
465 #undef _API_ACE_PRIV_H_
466 #endif // _API_ACE_PRIV_H_
467