background image

 

Intel® Digital Set Top Box Display Driver 

35 

 

User’s Guide for Microsoft* Windows* CE 5.0 

7.1.1.6 ICEGD_ESCAPE_SET_FB_GAMMA_RAMP 

Input Data Structure 

Output Data Structure 

Notes 

esc_color_params_t N/A 

esc_color_params flag options: 

Mandatory: 

GAMMA_FLAG (0x1) 

Not Applicable: 

BRIGHTNESS_FLAG (0x2) 

CONTRAST_FLAG (0x4) 

SATURATION_FLAG (0x8) 

OVL_COLOR_FLAG (0x10) 

 

Description 

This escape code is used to set frame buffer gamma correction ramp. Legal values are from 1-500, 1 - default, 500 – 
brightest. 

Input Data Structure Definition 

Same data structure as ICEGD_ESCAPE_SET_OVL_COLOR_PARAMS, but for this escape code, you need only 
set the GAMMA_FLAG. 

Example 

esc_color_params_t color; 
memset(&color, 0, sizeof(esc_color_params_t)); 
 
//set flag to gamma 
color.flag = GAMMA_FLAG; 
color.gamma = 0; 
 
for(int i=1;i<10;i++){ 
    //change gamma value gradually, and the legal value is between 1 and 500 
    color.gamma=i*50; 
    ExtEscape( 
  Hdc, 
  ICEGD_ESCAPE_SET_FB_GAMMA_RAMP, 
  sizeof(esc_color_params_t), 
  (LPCSTR)&color, 
  0, 
 NULL); 
//Check error status returned by ExtEscape 
// … 
// Wait a while for HW to complete the operation of changing the gamma value 
    Sleep(500); 

Summary of Contents for 82830M GMCH

Page 1: ...Intel Digital Set Top Box Display Driver User s Guide for Microsoft Windows CE 5 0 January 2006 Driver 1 0 0 0094...

Page 2: ...only is subject to change without notice and should not be construed as a commitment by Intel Corporation Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that m...

Page 3: ...1 3 Installing the MSI 12 3 2 Driver Files 13 3 3 Registry Options 13 4 Configuration Information 14 4 1 Display Driver Options 14 4 1 1 Display Options 14 4 1 2 Port Driver TV Encoder DLL Options 16...

Page 4: ...Changing the TV Format to PAL B 24 5 2 2 Changing the TV Output Type to Component 24 5 2 3 Enabling 3D Support 24 5 2 4 HDMI Support Single Shadow DVO Modes 25 6 Hardware Limitations 26 6 1 830 Chipse...

Page 5: ...for overlay surfaces with interleaved data using DirectDraw Added new samples BobTest CapsTest PerPixelAlphaBltTest VBITest December 2005 1 0 0 0092 Updated escape interface for HDMI Hotplug and HDMI...

Page 6: ...6 Intel Digital Set Top Box Display Driver User s Guide for Microsoft Windows CE 5 0 This page intentionally left blank...

Page 7: ...manufacturers and system control application developers 1 1 Definitions Table 1 Definitions Term Definition API Application Programming Interface BLT Bit block transfer BPP Bits per pixel DDGPE Direct...

Page 8: ...ctDraw Video APIs including DdCreateSurface DdDestroySurface DdSetColorKey DdLock DdUpdateOverlay DdSetOverlayPosition DdFlip and DdUnlock DDGPE APIs which extend GPE classes to support DirectDraw GDI...

Page 9: ...rlay surfaces with interleaved data using DirectDraw DDCAPS2_CANBOBINTERLEAVED and DDCAPS2_CANFLIPODDEVEN caps are set Example usage is provided in the BobTest sample Note IDirectDrawSurface5 UpdateOv...

Page 10: ...Extended Definition 480p 720x480 60Hz For use with Extended Definition 576p 720x576 50Hz For use with High Definition 720p 1280x720 60Hz For use with High Definition 1080i 1920x1080 60Hz The display d...

Page 11: ...4 VBI Support The display driver includes support for the following VBI features Closed Captioning with NTSC Line 21 field 1 2 Copy Generation Management System on NTSC Line 20 field 1 Line 21 field...

Page 12: ...5873 CX25892 and CX25899 TV encoders 3 1 2 854 MSI The 854 MSI installs the display driver DLL the display driver D3D Mobile DLL video reg the Conexant cx873 DLL the Focus fs454 DLL and the Silicon Im...

Page 13: ...i854 ddi_iceg dll NK SH fs454 dll INTELCEG_DRIVERS_DIR display i854 fs454 dll NK SH To configure the Direct 3D module add gdld3dm dll INTELCEG_DRIVERS_DIR display i854 gdld3dm dll NK SH 3 3 Registry O...

Page 14: ...Requested rate at which the frame buffer is sent out from the GMCH to the output port DVOScanMode DWORD Bit Field that specifies which timing table flags to preset when matching compatible timing set...

Page 15: ...ion color keying and by configuring the framebuffer to use ARGB32 pixel format The one side effect this configuration is that any pixel that has an alpha value of 0xFF that also matches the color key...

Page 16: ...on do not refer to multiple DVO ports The following setting on the 854 specifies to enumerate the DVO B port 2 and then the analog VGA port 5 PortOrder 2500 The following settings is required for Shad...

Page 17: ...ey sets a minimum size in pixels for a video surface in the horizontal direction The default minimum width is 16 Note Do not set this lower than 16 MinVidSurfY DWORD This key sets a minimum size in li...

Page 18: ...ich updates the frame buffer when active data is not being displayed This can be used to prevent tearing if BLT operations are being requested directly on to the primary frame buffer Note This key ena...

Page 19: ...icrosoft DirectX DirectShow Video Renderer The following settings affect the direct show video renderer MaxBackBuffers DWORD This setting determines if single double or triple buffering is used This i...

Page 20: ...bled a valid Direct3D Mobile needs to be loaded See 3DModule below SharedMemHeapSize DWORD This key is used to set the size in bytes of the shared system memory heap to be allocated at driver startup...

Page 21: ...one of the list entries If an attribute name does not match a supported attribute or if an out of range value is used the display driver will fail to load and this will result in a GWES exception Port...

Page 22: ...3 DACB dword 1 DACC dword 2 DACD dword 4 Option 6 of TV Output is for a special TV connector named SCART I which is very popular in European This option is only available for the Hominy Hill2 now sinc...

Page 23: ...Platform Intel 830M4 Development Platform TV Encoder Spartan B ADD card with the Focus FS454 Frame Buffer 720x480 60Hz and 32 bits per pixel TV Format NTSC TV Output Type Composite and S Video Enable...

Page 24: ...nge the height setting to 576 o Height dword 240 Change the refresh setting to 50 o Refresh dword 32 2 Next change the TV format to PAL B which is dependent on the TV Encoder On the Focus FS454 use o...

Page 25: ...Image port driver o Single DVO PortDrivers sii9030 o Shadow DVO PortDrivers cx873 sii9030 Set Port Order o Single DVO PortOrder 5300 VGA generates clocks o Shadow DVO PortOrder 2350 Conexant CX23899 g...

Page 26: ...chroma artifact which is commonly referred to as the Chroma Upsampling Error CUE Both interleaved and progressive data are supported by the YUV 4 2 2 packed and xRGB formats 6 2 854 Chipset Limitatio...

Page 27: ...tructure by number of bytes LPCSTR pointer of input data buffer of BYTE Note Please note that LPCSTR does not imply the input data buffer is anything related to string which means a long constant poin...

Page 28: ...GD_ESCAPE_GET_MONITOR_DESC ICEGD_ESCAPE_VBI_ENABLE ICEGD_ESCAPE_VBI_DISABLE ICEGD_ESCAPE_VBI_UPDATE ICEGD_ESCAPE_INTERRUPT_INSTALL ICEGD_ESCAPE_INTERRUPT_UNINSTALL ICEGD_ESCAPE_SET_VIDEO_PLANE_ZORDER...

Page 29: ...ndary display port Input Data Structure Definition The data structure esc_port_ctrl_t should be filled in with port number 0 or 1 and enable 1 disable 0 value to configure which port 0 or 1 to be enab...

Page 30: ...before a call to ICEGD_ESCAPE_GET_AVAIL_PD_ATTRIBUTES to size the required igd_attr_t data structure array Description This escape code is used to request the total number of attributes supported by t...

Page 31: ...RIBUTES must be called before it can get the number of attributes The output is a pointer to a list that can hold all the attributes supported by the Port Driver It is always called to get the attribu...

Page 32: ...er the attribute could be supported by the card you can use ICEGD_ESCAPE_GET_AVAIL_PD_ATTRIBUTES to get the supported attribute list and check with it String attributes are read only Example Please re...

Page 33: ...TTRIBUTES 0 NULL number sizeof igd_attr_t LPSTR attr_list current attr_list for int i 0 i number i current choose attribute DACA and the type of it must be range if current id 26 current type PD_ATTR_...

Page 34: ...ta Structure Definition The data structure esc_color_params_t should be filled in with parameters of gamma brightness contrast saturation and so on Please refer to icegd_public_escape h for details Ex...

Page 35: ...are from 1 500 1 default 500 brightest Input Data Structure Definition Same data structure as ICEGD_ESCAPE_SET_OVL_COLOR_PARAMS but for this escape code you need only set the GAMMA_FLAG Example esc_c...

Page 36: ...ucture Notes N A esc_mem_stats_t Description This escape code is used to get memory statistics Output Data Structure Definition Please refer to igd_public h for details about data structure esc_mem_st...

Page 37: ...only 0 or 1 Description This escape code is used to get the monitor description EDID Output Data Structure Definition Please refer to icegd_public_escape h for details about data structure esc_monito...

Page 38: ...E Input Data Structure Output Data Structure Notes N A N A Description This escape code is used to call port driver to enable Line 21 VBI Vertical Blank Interrupt data It is always used before ICEGD_E...

Page 39: ...SCAPE_VBI_DISABLE Input Data Structure Output Data Structure Notes N A N A Description This escape code is used to call port driver to disable Line 21 VBI Vertical Blank Interrupt data It is always us...

Page 40: ...r to igd_public h for vbi data structure details Example vbi_data pvbi 0 pvbi vbi_data malloc sizeof vbi_data 2 pvbi unFlags VERSION_1 pvbi unDataLength 2 CC CGMS line 21 pvbi unDataType LINE_21_FIELD...

Page 41: ...SCAPE_VBI_UPDATE sizeof vbi_data 2 const char pvbi 0 NULL Sleep 33 Sleep 1000 erase cc displayed memory pvbi pucData 0 0x14 pvbi pucData 1 0x2c ExtEscape Hdc ICEGD_ESCAPE_VBI_UPDATE sizeof vbi_data 2...

Page 42: ...ape code is used to install an interrupt It is always followed by ICEGD_ESCAPE_INTERRUPT_UNINSTALL unInterrupt of the input structure could only be ESCAPE_INTERRUPT_VBLANK After the operation finishes...

Page 43: ...pt_data interrupt memset interrupt 0 sizeof escape_interrupt_data interrupt unInterrupt ESCAPE_INTERRUPT_VBLANK install an interrupt ExtEscape Hdc ICEGD_ESCAPE_INTERRUPT_INSTALL sizeof escape_interrup...

Page 44: ...ane based alpha support Input Data Structure Definition Please refer to icegd_public_escape h for details about esc_vid_plane_zorder_t Example static unsigned long lcolorkey 0x090900 static unsigned l...

Page 45: ...Input Data Structure Output Data Structure Notes Int N A Input can be only HW_ALPHA_COMPAT_VIDEO_RENDERER_MODE 0x00000001 Description This escape code is used to enable the HW plane alpha mode Example...

Page 46: ...river_version_t Description This escape code is used to get the driver version Input Data Structure Definition Please refer to icegd_public_escape h for details about esc_driver_version_t Example esc_...

Page 47: ...E 5 0 7 1 1 17 ICEGD_ESCAPE_I2C_CONFIG Input Data Structure Output Data Structure Notes esc_i2c_config_t N A Description This escape code is used before ICEGD_ESCAPE_I2C_ACCESS to configure Pin Pair D...

Page 48: ...t i2c_access unsigned char data unsigned char data2 memset i2c_config 0 sizeof esc_i2c_config_t memset i2c_access 0 sizeof esc_i2c_access_t the data is only for cx892 please refer to special documents...

Page 49: ...Guide for Microsoft Windows CE 5 0 Read the data to make sure the last step works ok i2c_access mode INTEL_I2C_MODE_READ ExtEscape Hdc ICEGD_ESCAPE_I2C_ACCESS sizeof esc_i2c_access_t LPCSTR i2c_access...

Page 50: ...ut on SD ESC_DISPLAY_PIXEL_DOUBLE ESC_DISPLAY_INTERLACED Description This escape code is used to select a DVO port master slave Input Data Structure Definition Set select to select a DVO port Set flag...

Page 51: ...s escape code is used to query the HDMI hotplug status Output Data Structure Definition If the HDMI is plugged in return ESC_HDMI_PLUG_IN else return ESC_HDMI_PLUG_OUT Example esc_enum_hotplug_status...

Page 52: ...tEscape hDC ICEGD_ESCAPE_WAIT_HDMI_HOTPLUG 0 NULL sizeof esc_enum_hotplug_status LPSTR status if status ESC_HDMI_PLUG_IN dvoSelect select ESC_MULT_DVO_SLAVE Double pixel and interlaced flag only be ne...

Page 53: ...tput Data Structure Notes Int N A N A Description This escape code is used to set the HDMI scan info Input Data Structure Definition The input data can be set between 0 3 But only 1 and 2 make sense n...

Reviews: