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 //<MStar Software> 78 #ifndef __MSDLC_H 79 #define __MSDLC_H 80 81 #ifdef _MSDLC_C_ 82 #define _MSDLCDEC_ 83 #else 84 #define _MSDLCDEC_ extern 85 #endif 86 #include "UFO.h" 87 #if ENABLE_DLC 88 //------------------------------------------------------------------------ 89 // Input: 90 // wWidth: Output image Width 91 // wHeight: Output iamge Height 92 //------------------------------------------------------------------------ 93 void msDlcInit(WORD wWidth, WORD wHeight); 94 void msDlcInitWithCurve( WORD wHStart, WORD wHEnd, WORD wVStart, WORD wVEnd ); 95 96 97 //------------------------------------------------------------------------ 98 // Put this function at main loop 99 // This function will use 33ms for 5xxx/6xxx version chip 100 // This function will use 22ms for 5xxxA/6xxxA version chip 101 //------------------------------------------------------------------------ 102 void msDlcHandler(BOOL bWindow); 103 BOOL msGetHistogramHandler(BOOL bWindow); 104 //void msDlcStaticCurveOnOff(BOOL bEnable); 105 106 void msDlcEnableSetDLCCurveBoth(BOOL bEnable); 107 108 //------------------------------------------------------------------------ 109 // Input: 110 // bWindow: 0 main window, 1 sub window 111 // bSwitch: 0 is OFF, 1 is ON 112 //------------------------------------------------------------------------ 113 void msDlcOnOff(BOOL bSwitch, BOOL bWindow); 114 void msDlcSpeedupTrigger(BYTE ucLoop); 115 void msDlcSetBleOnOff(BOOL bSwitch); 116 117 //------------------------------------------------------------------------ 118 // CGC 119 //------------------------------------------------------------------------ 120 void msDlc_CGC_Init(void); 121 void msDlc_CGC_ReInit(void); 122 #if defined(UFO_PUBLIC_HEADER_500) 123 #define MDrv_msDlc_CGC_SetGain msDlc_CGC_SetGain 124 #endif 125 void msDlc_CGC_SetGain(BYTE u8CGain); 126 void msDlc_CGC_Handler(void); 127 128 //------------------------------------------------------------------------ 129 // For Debug Command 130 //------------------------------------------------------------------------ 131 #if defined(UFO_PUBLIC_HEADER_500) 132 #define MDrv_msDLC_ParametersTool msDLC_ParametersTool 133 #endif 134 void msDLC_ParametersTool(BYTE *pCmdBuff); 135 //------------------------------------------------------------------------ 136 // LIB version check 137 //------------------------------------------------------------------------ 138 WORD msDlcLibVersionCheck(void); 139 WORD msDlcCGCLibVersionCheck(void); 140 //------------------------------------------------------------------------ 141 //------------------------------------------------------------------------ 142 143 typedef struct 144 { 145 // Default luma curve 146 BYTE ucLumaCurve[16]; 147 BYTE ucLumaCurve2_a[16]; 148 BYTE ucLumaCurve2_b[16]; 149 BYTE ucLumaCurve2[16]; 150 151 BYTE u8_L_L_U; // default value: 10 152 BYTE u8_L_L_D; // default value: 10 153 BYTE u8_L_H_U; // default value: 10 154 BYTE u8_L_H_D; // default value: 10 155 BYTE u8_S_L_U; // default value: 128 (0x80) 156 BYTE u8_S_L_D; // default value: 128 (0x80) 157 BYTE u8_S_H_U; // default value: 128 (0x80) 158 BYTE u8_S_H_D; // default value: 128 (0x80) 159 BYTE ucCGCCGain_offset; // -31 ~ 31 (bit7 = minus, ex. 0x88 => -8) 160 BYTE ucCGCChroma_GainLimitH; // 0x00~0x6F 161 BYTE ucCGCChroma_GainLimitL; // 0x00~0x10 162 BYTE ucCGCYCslope; // 0x01~0x20 163 BYTE ucCGCYth; // 0x01 164 BYTE ucDlcPureImageMode; // Compare difference of max and min bright 165 BYTE ucDlcLevelLimit; // n = 0 ~ 4 => Limit n levels => ex. n=2, limit 2 level 0xF7, 0xE7 166 BYTE ucDlcAvgDelta; // n = 0 ~ 50, default value: 12 167 BYTE ucDlcAvgDeltaStill; // n = 0 ~ 15 => 0: disable still curve, 1 ~ 15 => 0.1 ~ 1.5 enable still curve 168 BYTE ucDlcFastAlphaBlending; // min 17 ~ max 32 169 BYTE ucDlcSlowEvent; // some event is triggered, DLC must do slowly // for PIP On/Off, msMultiPic.c 170 BYTE ucDlcTimeOut; // for IsrApp.c 171 BYTE ucDlcFlickAlphaStart; // for force to do fast DLC in a while 172 BYTE ucDlcYAvgThresholdH; // default value: 128 173 BYTE ucDlcYAvgThresholdL; // default value: 0 174 BYTE ucDlcBLEPoint; // n = 24 ~ 64, default value: 48 175 BYTE ucDlcWLEPoint; // n = 24 ~ 64, default value: 48 176 BYTE bCGCCGainCtrl : 1; // 1: enable; 0: disable 177 BYTE bEnableBLE : 1; // 1: enable; 0: disable 178 BYTE bEnableWLE : 1; // 1: enable; 0: disable 179 BYTE ucDlcYAvgThresholdM; 180 BYTE ucDlcCurveMode; 181 BYTE ucDlcCurveModeMixAlpha; 182 BYTE ucDlcAlgorithmMode; 183 BYTE ucDlcHistogramLimitCurve[17]; 184 BYTE ucDlcSepPointH; 185 BYTE ucDlcSepPointL; 186 WORD uwDlcBleStartPointTH; 187 WORD uwDlcBleEndPointTH; 188 BYTE ucDlcCurveDiff_L_TH; 189 BYTE ucDlcCurveDiff_H_TH; 190 WORD uwDlcBLESlopPoint_1; 191 WORD uwDlcBLESlopPoint_2; 192 WORD uwDlcBLESlopPoint_3; 193 WORD uwDlcBLESlopPoint_4; 194 WORD uwDlcBLESlopPoint_5; 195 WORD uwDlcDark_BLE_Slop_Min; 196 BYTE ucDlcCurveDiffCoringTH; 197 BYTE ucDlcAlphaBlendingMin; 198 BYTE ucDlcAlphaBlendingMax; 199 BYTE ucDlcFlicker_alpha; 200 BYTE ucDlcYAVG_L_TH; 201 BYTE ucDlcYAVG_H_TH; 202 BYTE ucDlcDiffBase_L; 203 BYTE ucDlcDiffBase_M; 204 BYTE ucDlcDiffBase_H; 205 BYTE ucLMaxThreshold; 206 BYTE ucLMinThreshold; 207 BYTE ucLMaxCorrection; 208 BYTE ucLMinCorrection; 209 BYTE ucRMaxThreshold; 210 BYTE ucRMinThreshold; 211 BYTE ucRMaxCorrection; 212 BYTE ucRMinCorrection; 213 BYTE ucAllowLoseContrast; 214 MS_U8 u8Dlc_Mode; 215 MS_U8 u8Tmo_Mode; 216 }StuDlc_FinetuneParamaters; 217 218 219 extern XDATA StuDlc_FinetuneParamaters g_DlcParameters; 220 221 #define DLC_PURE_IMAGE_DLC_CURVE 0L 222 #define DLC_PURE_IMAGE_LINEAR_CURVE 1L 223 #define DLC_PURE_IMAGE_DO_NOTHING 2L 224 225 extern XDATA WORD g_wLumaHistogram32H[32]; 226 227 extern XDATA BYTE g_ucHistogramMax, g_ucHistogramMin; 228 extern XDATA WORD g_wLumiAverageTemp; 229 extern XDATA BYTE g_ucTable[16]; 230 extern XDATA char* g_pInitLumaCurve; 231 extern XDATA WORD g_wLumiTotalCount; 232 233 #define DLC_EVENT_SLOW_ENABLE 40 234 235 #if (ENABLE_DLC == DLC_8SEG_HIS_MODE) 236 extern XDATA WORD g_wLumaHistogram8H[8]; 237 #endif 238 239 void msDlc_SetCaptureRange(MS_U16 wHStart,MS_U16 wHEnd, MS_U16 wVStart, MS_U16 wVEnd); 240 241 242 243 #endif 244 #endif 245