Philips DirectX Visualizer User manual

DirectX Visualizer
User Manual
Philips 3D Solutions

Document Information
Info
InfoInfo
Info Content
ContentContent
Content
Title DirectX Visualizer, User Manual
Date 01 April 2009
Security
The attache material an the information containe herein are
proprietary to Philips 3D Solutions. Copying, repro uction,
a aptation, mo ification or issemination in whole or part is not
permitte without written permission from Philips 3D
Solutions.
Contact http://www.philips.com/3 solutions

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 3 of 26
Table of Contents
1 Intro uction .............................................................................................................................................................................4
2 Compatibility............................................................................................................................................................................6
3 Overview of configuration process ....................................................................................................................................7
4 Installation.................................................................................................................................................................................8
5 Configuration file.....................................................................................................................................................................9
6 Configuration options..........................................................................................................................................................10
6.1 Logging...........................................................................................................................................................................10
6.2 Display resolution.......................................................................................................................................................10
6.3 Har ware gamma........................................................................................................................................................11
6.4 Application resolution................................................................................................................................................11
6.5 Image input resolution...............................................................................................................................................11
6.6 Depth input resolution..............................................................................................................................................12
6.7 Output resolution an position...............................................................................................................................12
6.8 Depth map selection ..................................................................................................................................................12
6.9 Discar able epth stencils ........................................................................................................................................15
6.10 Depth tuning help .......................................................................................................................................................15
6.11 Range of interest.........................................................................................................................................................16
6.12 Inverse projection calculation..................................................................................................................................17
6.13 Switching between 2D, 3D an epth-only mo e..............................................................................................18
6.14 Ren ering parameters in hea er.............................................................................................................................18
6.15 Improving HUD rea ability ......................................................................................................................................20
6.16 Mouse cursor rawing...............................................................................................................................................21
Appen ix A: Configuring the Visualizer for a new application ............................................................................................22

DirectX Visualizer
3D Solutions
01 April 2009
4 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
1
11
1 Introduction
The DirectX Visualizer enables one to view the output of 3D applications or games on Philips 3D
isplays even though the applications have not been esigne to support them. It oes this by
intercepting the interaction between the 3D application an DirectX.
Direct3D application
d3d9.dll
WOWvx DirectX
Visualizer DLL
Direct3D application
d3d9.dll
Direct3D
function calls
Direct3D
function calls
forwarded Direct3D
function calls
Direct3D application The same Direct3D application
running with the WOWvx
DirectX Visualizer DLL
Figure 1: A Direct3D application running with and without the Visualizer
Because the application is unaware of the Visualizer oing its work, all configuration an tweaking has
to be one through the Visualizer’s configuration file. An overview of how to get a new application to
work with the Visualizer is given in section 3, while the configuration file format an an explanation of
all possible settings are given in sections 5 an 6 respectively.
This ocument assumes basic knowle ge of the Direct3D API in its explanation of the Visualizer
configuration process. For example it expects the rea er to un erstan what ren er targets an epth
stencils are, what the IDirect3DDevice9::Clear() function can o an what a projection matrix is.
As an alternative to the rather complicate process of creating a Visualizer configuration for a new
application or game, we provi e configuration files an installation instructions for several games on
our website.
Note that as the Visualizer works without the application being aware of it, there will always be
applications or parts of applications that will not generate proper output with the Visualizer, regar less

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 5 of 26
of the settings in the configuration file. In some cases it is possible to buil support for this application
into a later version of the Visualizer, but this will have to be etermine on a case by case basis.

DirectX Visualizer
3D Solutions
01 April 2009
6 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
2
22
2 Compatibility
This ocument escribes the configuration file format for DirectX Visualizer version 1.0.
At this time the Visualizer can only support games an applications that use Direct3D 9.
The Visualizer is expecte to work on any mo ern 3D graphics car , but we recommen an NVIDIA
GeForce 6800 XT or better.
At this time the DirectX Visualizer has only been teste on Microsoft Win ows XP Professional SP2.

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 7 of 26
3
33
3 Overview of configuration process
The process of getting an application to work with the Visualizer basically consists of these six steps.
1. Getting the application to run in fullscreen at the native resolution of the 3D isplay with 32-
bit color.
1
2. Fin ing out where to install the Visualizer so it will be use by the application. This step is
iscusse in section 4.
3. Determining when an where to extract epth information. See the escription of the
DepthTriggerCon ition setting in 6.8 for more information on this step.
4. Tuning the epth settings to get a proper epth effect as explaine in sections 6.10 through
6.12.
5. Depen ing on the application it may be useful to configure several extra features of the
Visualizer, such as improving HUD rea ability (see 6.15) or turning mouse cursor rawing on
or off (see 6.16).
6. Cleaning up the configuration file by removing any unnee e settings
An example of this process is inclu e in appen ix A an inclu es more etails on steps 3 an 4 in
particular.
1
The native resolution for a 20” 3D isplay is 1600x1200, for the 42” it is 1920x1080.

DirectX Visualizer
3D Solutions
01 April 2009
8 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
4
44
4 Installation
The Visualizer is a DLL that looks to the application like the DirectX DLL for rawing in 3D, therefore
it has the same name: 3 9. ll . The first thing to o is to etermine where to put this DLL. In most
cases the irectory containing the executable of the application is the right location. Copy over the
Visualizer DLL from where it was installe (usually C:\Program Files\Philips\DirectX Visualizer) to the
irectory with the application’s executable.
To check if the application is using our DLL, put a file name visualizer.ini in the same irectory
containing:
Starting the application shoul result in creation of a file name visualizer_log.txt . If this file is not
create , then the Visualizer is not being loa e . Try putting 3 9. ll an visualizer.ini in a ifferent
irectory.
Note: Do not put these files in the Win ows system irectory. The copy of 3 9. ll in the system
irectory is the original DirectX DLL an should not be overwritten!
[Config]
EnableLogging=1

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 9 of 26
5
55
5 Configuration file
Once the application loa s the Visualizer when it starts up it is time to configure the Visualizer. The
Visualizer nee s to be tune specifically for each application that it is use with.
The Visualizer rea s settings from a file calle visualizer.ini if it is present. This file nee s to be place
in the same irectory as the Visualizer DLL. As mentione before, this is usually the irectory where
the application executable is locate . If no configuration file is foun , efault settings will be use .
The configuration file complies with the format of a stan ar Microsoft Win ows .ini file. It shoul
start with the eclaration of a section (always [Config] for this Visualizer), followe by a list of options
an their values. Any lines that start with a semi-colon are ignore an can be use to a comments.
Figure 2 shows an example of such a configuration file.
Figure 2: visualizer.ini example
[Config]
; Enable logging
EnableLogging=1
; Use the ‘3’ key to toggle between 2D, 3D an epth only mo e
3DToggleKey = 3

DirectX Visualizer
3D Solutions
01 April 2009
10 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
6
66
6 Configuration options
Whenever a key nee s to be efine in the configuration file, the names from the following table can
be use . Where necessary the “Remarks” column specifies some things to note. All key names are
case insensitive, so “A” enotes the same key as “a”.
Keys
KeysKeys
Keys Remarks
RemarksRemarks
Remarks
“f1” upto “f12”, “a” upto “z”, “0” upto “9”,
“esc”, "minus", "plus", "backspace", "tab",
"capslock", "enter", "shift", "comma", "perio ",
"ctrl", "space", "menu"
main part of the keyboar
"insert", " elete", "home", "en ", "pageup",
"page own", "leftarrow", "rightarrow",
"uparrow", " ownarrow"
between main part of keyboar an the
numpa
"numlock", "numpa ivi e",
"numpa multiply", "numpa subtract",
"numpa a ", "numpa ecimal",
“numpa 0” upto “numpa 9”
on the numpa
“ isable ” can be use to specify that a function will
not be available un er a key
6.1
6.16.1
6.1 Logging
The Visualizer can write information about what is going on to a file. This can help in choosing the
right values for options in the configuration file. The name of the file is visualizer_log.txt an it will be
put in the same irectory as the Visualizer DLL. Logging incurs a performance penalty, so it shoul be
isable once the settings in visualizer.ini have been finalize .
Option name
Option nameOption name
Option name Possible
Possible Possible
Possible
values
valuesvalues
values
Default
Default Default
Default
value
valuevalue
value
Description
DescriptionDescription
Description
EnableLogging 0 or 1 0 Whether to log information to a file (1) or not (0).
6.2
6.26.2
6.2 Display resolution
For 3D output it is require that the screen resolution is set to the native resolution of the isplay. If
the application oes not support the native screen resolution an switches to a ifferent one on
startup, the Visualizer can change the resolution back. This metho is not preferre an shoul only be
use as a last resort. Set the settings below to 0 to isable resolution switching.

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 11 of 26
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
ChangeDisplayResW positive integer 0 Wi th of native isplay resolution
ChangeDisplayResH positive integer 0 Height of native isplay resolution
ChangeDisplayRefreshRate positive integer 0 Refresh rate to use at native isplay
resolution
6.3
6.36.3
6.3 Hardware gamma
Har ware gamma control will mo ify the colors of the output before sen ing it to the isplay. This will
also affect the epth information that the Visualizer sen s to the isplay, possibly having a negative
impact on the epth effect. A clue that the application is using har ware gamma control is if changing a
brightness or gamma setting from the application’s menu also changes the brightness of the epth map
(see 6.13 on how to isplay only the epth map).
2
Option name
Option nameOption name
Option name Possible
Possible Possible
Possible
values
valuesvalues
values
Default
Default Default
Default
value
valuevalue
value
Description
DescriptionDescription
Description
DisableHar wareGamma 0, 1 0 Whether to isable har ware gamma (1) or not (0)
6.4
6.46.4
6.4 Application resolution
The resolution at which the application ren ers is etecte by the Visualizer automatically if these
options are set to 0. If auto- etection fails, use this option to overri e it.
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values
Defau
DefauDefau
Default value
lt valuelt value
lt value Description
DescriptionDescription
Description
ResAppW positive integer 0 Wi th of application resolution
ResAppH positive integer 0 Height of application resolution
6.5
6.56.5
6.5 Image input resolution
The application can be force to ren er at a ifferent resolution by changing the viewport. This results
in a lower resolution 2D input to the Visualizer. Quality in 2D mo e is optimal if the input resolution
is equal to the application resolution. Optimal quality in 3D mo e as well as highest performance is
achieve when the input resolution is set to a quarter of the application resolution (both wi th an
2
If the application has no brightness/gamma setting it is ifficult, but still possible to see the effect of it on the
epth. Follow the instructions in section 6.9 to get a correct perspective. If straight lines towar the horizon still
appear bent when looking at the 3D isplay from a ifferent angle, then this coul very well be cause by
har ware gamma.

DirectX Visualizer
3D Solutions
01 April 2009
12 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
height ivi e by 2), but this may interfere with the ren ering of the application. If these options are
set to 0, the size of the efault ren er target at the time the 3D evice is create or reset will be use .
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
ResInputRgbW positive integer 0 Wi th of Visualizer input resolution
ResInputRgbH positive integer 0 Height of Visualizer input resolution
6.6
6.66.6
6.6 Depth input resolution
This setting oes for epth what the image input resolution oes for the image. If these options are set
to 0, the image input resolution will be use .
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
ResInputDW positive integer 0 Wi th of Visualizer input resolution
ResInputDH positive integer 0 Height of Visualizer input resolution
6.7
6.76.7
6.7 Output resolution and position
These options tell the Visualizer to only use a part of the screen for its output. In general the
Visualizer output shoul cover the entire screen. In that case these options can be set to 0, causing the
application resolution to be use . Note that the coor inate system use with these options has its
origin at the bottom-left corner of the screen.
Option name
Option nameOption name
Option name Possible
Possible Possible
Possible
values
valuesvalues
values
Default
Default Default
Default
value
valuevalue
value
Description
DescriptionDescription
Description
ResOutputW positive integer 0 Wi th of Visualizer output resolution
ResOutputH positive integer 0 Height of Visualizer output resolution
ResOutputPosX positive integer 0 x-coor inate of bottom-left corner of Visualizer output
ResOutputPosY positive integer 0 y-coor inate of bottom-left corner of Visualizer output
6.8
6.86.8
6.8 Depth map selection
Many applications use multiple ren er passes per frame to construct complex scenes. Imagine a game
where a certain room is full of security monitors. The image that is presente on these monitors may
well have been create by a separate ren er pass. If the game also isplays statistics such as health an
the current score on the screen, that is probably a separate ren er pass as well. The Z-buffer will
often be cleare between ren er passes like this, meaning the epth that correspon s to the larger
scene (your view of the room) may not be available by the time the frame is rea y to be presente .

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 13 of 26
The epth trigger con ition can be use to tell the Visualizer at what point in the ren ering process
the Z-buffer contains the epth of the 3D scene that shoul be shown to the user. It selects one call
to IDirect3DDevice9::Clear base on its parameters, the number of times clear was calle before for
this frame an properties of the active ren er target (color buffer) an epth stencil ( epth buffer).
Currently the epth trigger con ition can only be base on calls to IDirect3DDevice9::Clear, as
in icate by the “cl:” prefix, but this may be exten e in the future.
To simplify etermining the number of times Clear shoul be calle before extracting the epth
information, the DepthBufferPass relate options were create . It allows you to use a key to
temporarily mo ify the count part of the epth trigger con ition. Once the right epth information has
been extracte while running the application, the log file can be use to etermine the most suitable
epth trigger con ition. Appen ix A shows how to etermine a proper value for
DepthTriggerCon ition.
Option name
Option nameOption name
Option name Possible
Possible Possible
Possible
values
valuesvalues
values
Default
Default Default
Default
value
valuevalue
value
Description
DescriptionDescription
Description
DepthTriggerCon ition string un efine A string specifying the con ition un er which to
grab epth information from the Z-buffer. The
efault is to grab the epth information at the en
of a frame when SwapBuffers is calle .
DepthBufferPassDownKey
key un efine Key to select an earlier call to Clear to trigger on
DepthBufferPassUpKey key un efine Key to select a later call to Clear to trigger on
This string must be the string “cl:” followe by a comma-separate list of con itions in the or er they
appear in the table below, for example:
DepthTriggerCon ition=cl:n=2,c=0x0000FF00,z=1.0,rtw=1600,rth=1200
Figure 3: example showing format of depth trigger condition string
The following table explains the possible con itions an their values. The ‘n’ use in the escription of
several con itions refers to the value fille in for <positive integer>.

DirectX Visualizer
3D Solutions
01 April 2009
14 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
Condition
ConditionCondition
Condition Possible values
Possible valuesPossible values
Possible values Description
DescriptionDescription
Description
count n=<positive integer> the n-th Clear operation that matches the other con itions will be
use to grab the epth information
c=<32-bit hex value> match only Clear operations that clear the color buffer to this value
c match only Clear operations that clear the color buffer
color
!c match only Clear operations that o not clear the color buffer
z=<float value> match only Clear operations that clear the Z-buffer to this value
z match only Clear operations that clear the Z-buffer
epth
!z match only Clear operations that o not clear the Z-buffer
s=<32-bit hex value> match only Clear operations that clear the stencil buffer to this value
s match only Clear operations that clear the stencil buffer
stencil
!s match only Clear operations that o not clear the stencil buffer
ren ertargetor inal
rto=<positive integer> match only Clear operations that are one while the last call to
SetRen erTarget selecte the n-th unique ren er target set in the
first frame that use n or more unique ren er targets.
3
ren ertargetin ex rti=<positive integer> match only Clear operations that are one while the last call to
SetRen erTarget selecte a ren er target for in ex n.
ren ertargetwi th rtw=<positive integer> match only Clear operations that are one while the last call to
SetRen erTarget selecte a ren er target with the specifie wi th.
ren ertargetheight rth=<positive integer> match only Clear operations that are one while the last call to
SetRen erTarget selecte a ren er target with the specifie height.
epthstencilor inal so=<positive integer> match only Clear operations that are one while the last call to
SetDepthStencilSurface selecte the n-th unique epth stencil surface
set in the first frame that use n or more unique epth stencil
surfaces.
3
epthstencilwi th sw=<positive integer> match only Clear operations that are one while the last call to
SetDepthStencilSurface selecte a epth stencil surface with the
specifie wi th.
epthstencilheight sh=<positive integer> match only Clear operations that are one while the last call to
SetDepthStencilSurface selecte a epth stencil surface with the
specifie height.
3
If the epth trigger con ition contains a ren ertargetor inal con ition, the visualizer will start counting unique
ren er targets set with SetRen erTarget. If the number of unique ren er targets at the en of a frame is less
than the specifie number, the count will restart in the next frame. Once enough unique ren er targets are use
within one frame, the ren er target that correspon s to the specifie number will be store an use in the
evaluation of the epth trigger con ition in all later frames. The epthstencilor inal con ition is han le in a
similar way.

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 15 of 26
6.9
6.96.9
6.9 Discardable depth stencils
Discar able epth stencils are epth stencils that lose their ata as soon as they are no longer the
active epth stencil. These epth stencils are not compatible with the Visualizer an a warning will be
written to the log if the application is using them.
RetrieveDfromZbufferBinary getting epth from epth stencil 0x001E9E40
Detecte multisample type 1 for epth buffer; using interme iate epth stencil for
epth extraction
WARNING: StretchRect faile with error 'INVALIDCALL' when trying to ownsample the
multisample epth stencil.
The application probably create the epth stencil as iscar able.
Either turn off multisampling or set RefuseDiscar ableDepthStencils=1 in the
configuration file.
Con ition 0x0161AC00: reset, restarting with con ition 1
Figure : log file fragment including warning
It is usually a better option to turn off multisampling than it is to use RefuseDiscar ableDepthStencils
in the configuration file. The latter can have a very large an non-constant negative effect on
performance.
6.10
6.106.10
6.10 Depth tuning help
When the EnableDepthTuningHelp option is set to 1 the Visualizer will give certain epth values in the
epth map a ifferent color to help you tune both the range of interest (6.11) as well as the
FarNearRatio value (6.12). To see the epth map, either switch to the epth-only mo e using the 3D
toggle key (6.13) or run the application on a regular 2D isplay.
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
EnableDepthTuningHelp
0 or 1 0 Whether to use the special colors in the epth
map for certain isparity values (1) or not (0).
Colors are assigne to four epth values. Enabling these colors oes not affect the epth values use
by the isplay.
Disparity
DisparityDisparity
Disparity Color
ColorColor
Color Description
DescriptionDescription
Description
255 re Disparity value for objects that are furthest in front of the isplay (ZNearInterest)
191 purple
Disparity value half-way between closest objects an the isplay plane
128 green Disparity value for objects on the isplay plane (just like everything on a 2D isplay)
64 cyan Disparity value half-way between furthest objects an the isplay plane

DirectX Visualizer
3D Solutions
01 April 2009
16 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
0 black Disparity value for objects that are furthest behin the isplay (ZFarInterest)
These colors can be use to easily etermine a value of FarNearRatio for an approximately correct
perspective representation. To o this first get the application to isplay a flat surface that exten s
away from the viewer towar s the horizon (such as the floor or a wall in a long hallway). The correct
perspective is achieve if the colore lines on such a surface in the epth map are equi istant on the
screen (see Figure 5). If the physical istance on the screen between lines that represent closer
istances (for instance re an purple) is larger than the istance between lines that represent further
istances (for instance green an cyan), then the FarNearRatio nee s to be ecrease to come closer
to the correct perspective.
Figure 5: Depth map with FarNearRatio tuned for a correct perspective
6.11
6.116.11
6.11 Range of interest
Usually objects rawn by an application are sprea out between the Direct3D near an far plane.
However, some applications use only a small range of Z-buffer values for the majority of objects. This
may result in a epth map with only a few ifferent epth values if the Visualizer uses the efault
translation from Z-buffer values to epth information. The following settings can prevent this problem
by efining a range of interest for Z-buffer values. The Visualizer uses its entire epth range for just the

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 17 of 26
Z-buffer values within the range of interest. Any values outsi e the range of interest are clippe to the
closest extreme of the range of interest.
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
ZNearInterest floating point value
between 0.0 an
1.0
0.0 Smallest Z-buffer value of interest
ZNearInterestDownKey key isable Key that ecreases ZNearInterest
ZNearInterestUpKey key isable Key that increases ZNearInterest
ZFarInterest floating point value
between 0.0 an
1.0
1.0 Largest Z-buffer value of interest
ZFarInterestDownKey key isable Key that ecreases ZFarInterest
ZFarInterestUpKey key isable Key that increases ZFarInterest
6.12
6.126.12
6.12 Inverse pro ection calculation
By efault the Visualizer will use the inverse of the Direct3D projection matrix to calculate the Z
coor inates from the value in the Z-buffer. If the projection matrix cannot be inverte , an
approximation will be use instea . The Visualizer will write a warning message about this to the log if
logging is enable (see Figure 6). It is recommen e to test the application at least once with logging
enable to see if this warning is given.
En of InitSha ers
Warning: inverse projection matrix not valid; using approximation.
DllMain DLL_THREAD_ATTACH
Warning: Switched back to using inverse projection matrix.
DllMain DLL_THREAD_DETACH
Figure 6: log file fragment including warning
If this warning is generate while the application is showing a 3D scene, then the approximation nee s
to be tune to still result in an acceptable 3D effect. For this purpose DynamicZtoD can be set to 0,
which will force the Visualizer to always use the approximation an allow you to etermine an
acceptable FarNearRatio. The value of FarNearRatio only influences the approximation an has no
effect if the inverse projection matrix is use .
To etermine the appropriate value for FarNearRatio it is recommen e to:
1. run the application with EnableLogging=1, DynamicZtoD=0, EnableDepthTuningHelp=1 an
ZRange keys efine to usable values
2. change the FarNearRatio using the ZRangeUpKey an ZRangeDownKey to fin a satisfactory
value
3. rea the last use FarNearRatio value from the log file
4. set the chosen FarNearRatio value in the configuration file

DirectX Visualizer
3D Solutions
01 April 2009
18 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
5. remove ZRange key efinitions from the configuration file to have them fall back to their
efault “ isable ”
6. remove EnableLogging=1, EnableDepthTuningHelp=1 (an optionally DynamicZtoD=0) from
the configuration file
Note: Although the inverse projection matrix gives a 100% perspectively correct representation, it
may not give the best possible epth effect for certain applications. For example a lot of racing
simulators put the player’s view close to the surface of the roa . In these games the player can see
nearby objects of less than a centimeter in size as well as faraway objects tens or hun re s of meters
long. Evenly istributing the epth that the isplay can show over the ren ere scene woul cause the
nearby part of the roa , which covers a large part of the screen, to have no noticeable variation in
epth. In this case it is often better to set DynamicZtoD to 0 an tune FarNearRatio to sacrifice some
of the perspective correctness in exchange for a noticeable epth gra ient in all parts of the scene.
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
DynamicZtoD 0 or 1 1 Whether to use the inverse projection matrix
(1) or not (0)
FarNearRatio floating point value
between 2.0 an
32768.0
512.0 A value influencing the approximate function
for Z coor inate calculation
ZRangeResetKey key isable Key that resets FarNearRatio to the value it is
set to in the configuration file
ZRangeDownKey key isable Key that ecreases FarNearRatio
ZRangeUpKey key isable Key that increases FarNearRatio
6.13
6.136.13
6.13 Switching between 2D, 3D and depth-only mode
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
3DToggleKey key isable Key that toggles between the ifferent mo es.
6.14
6.146.14
6.14 Rendering parameters in header
The hea er contains several parameters that influence the 3D ren ering process in the isplay. These
parameters can also be set from the configuration file.

DirectX Visualizer
3D Solutions
01 April 2009
©2005-2009 Philips Electronics Ne erlan B.V. 19 of 26
6.14.1
6.14.16.14.1
6.14.1 Header Factor
Option
Option Option
Option name
namename
name Possible values
Possible valuesPossible values
Possible values Default
Default Default
Default
value
valuevalue
value
Description
DescriptionDescription
Description
Hea erFactor positive integer
between 0 an 255
64 Hea er factor that sets the quantity of epth to
(hea erFactor / 64 * 100)% of the
recommen e epth for the isplay.
Hea erFactorResetKey key isable Key that resets Hea erFactor to the value it is
set to in the configuration file
Hea erFactorDownKey key isable Key that ecreases Hea erFactor
Hea erFactorUpKey key isable Key that increases Hea erFactor
6.14.2
6.14.26.14.2
6.14.2 Header Offset
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Defaul
DefaulDefaul
Default
t t
t
value
valuevalue
value
Description
DescriptionDescription
Description
Hea erOffset positive integer
between 0 an 255
128 Hea er offset that etermines how much of
the epth effect is behin the screen
(0 = everything is in front of the screen, 255
= everything is behin the screen).
Hea erOffsetResetKey key isable Key that resets Hea erOffset to the value it
is set to in the configuration file
Hea erOffsetDownKey key isable Key that ecreases Hea erOffset
Hea erOffsetUpKey key isable Key that increases Hea erFactor
6.14.3
6.14.36.14.3
6.14.3 Clear Edge feature
The Clear E ge feature will take for each pixel in the epth map the maximal epth value of all pixels
in the surroun ing area efine by the HorizontalClearE ge an VerticalClearE ge settings. This will
help hi e artefacts in scenes where backgroun pixels still have a bit of foregroun color in them,
which coul happen with antialiasing for instance.
Option name
Option nameOption name
Option name Possible
Possible Possible
Possible
values
valuesvalues
values
Default
Default Default
Default
value
valuevalue
value
Description
DescriptionDescription
Description
HorizontalClearE ge 0, 1, 2 or 3 0 The horizontal ra ius of the area aroun a pixel use for
Clear E ge. Setting this to n will result in an area of (2n
+ 1) pixels wi e to be taken into account.
VerticalClearE ge 0, 1 or 2 0 The vertical ra ius of the area aroun a pixel use for
Clear E ge. Setting this to n will result in an area of (2n

DirectX Visualizer
3D Solutions
01 April 2009
20 of 26 ©2005-2009 Philips Electronics Ne erlan B.V.
+ 1) pixels high to be taken into account.
6.14.4
6.14.46.14.4
6.14.4 Visualization
Smooth visualization is a mo e in which the transition between viewing cones is more gra ual at the
expense of the epth range.
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
Visualization 0 or 1 0 Sets visualization to smooth (1) or raw (0).
6.15
6.156.15
6.15 Improving HUD readability
Many games isplay statistics on the screen such as the player’s health, ammunition, score, etc. These
items are often referre to as a Hea -up Display (HUD). A HUD usually oes not have a
correspon ing profile in the epth map an will therefore be isplaye at the epth of the part of the
scene that it is rawn on. This may have an a verse effect on the rea ability of the HUD epen ing on
the epth in the scene. To keep the HUD rea able it is possible to efine areas of the image that
shoul always be on the isplay plane. The following settings provi e an easy way to efine such areas.
Option name
Option nameOption name
Option name Possible values
Possible valuesPossible values
Possible values Default value
Default valueDefault value
Default value Description
DescriptionDescription
Description
HUDScreenShotKey key isable Key that writes a screenshot to a file
name hu screenshot.bmp
HUDMaskImage the name of a bitmap file isable Specifies the name of the file that efines
the HUD mask
HUDMaskToggleKey key isable Key that toggles the HUD mask on an off
To efine a HUD mask, follow these steps:
1. Define HUDScreenShotKey, run the application, an take a screenshot of a scene containing
the HUD. The screenshot will be save to a file calle hu screenshot.bmp in the same
irectory as the Visualizer.
2. Open the screenshot in an image e iting application (e.g. Paint or Photoshop) an mark the
area containing the HUD by coloring that area white.
4
4
Screenshots taken by the visualizer are arkene slightly when compare to the application’s output. This is to
make sure that there are no white areas an it can be easily use to create a HUD mask.