|
|
|
|
Framework.Initialize Method |
Language: |
Initializes the sample framework.
Visual Basic Public Sub Initialize( _
ByVal isParsingCommandLine As Boolean, _
ByVal handleDefaultKeys As Boolean, _
ByVal showMessageBoxOnError As Boolean _
)C# public void Initialize(
bool isParsingCommandLine,
bool handleDefaultKeys,
bool showMessageBoxOnError
);C++ public:
void Initialize(
bool isParsingCommandLine,
bool handleDefaultKeys,
bool showMessageBoxOnError
);JScript public function Initialize(
isParsingCommandLine : boolean,
handleDefaultKeys : boolean,
showMessageBoxOnError : boolean
);
isParsingCommandLine System.Boolean
Set to true if the sample framework checks for command-line arguments; otherwise, false.handleDefaultKeys System.Boolean
Set to true if the sample framework automatically responds to certain keyboard input; otherwise, false.showMessageBoxOnError System.Boolean
Set to true if the sample framework displays a message box if there is an error condition; otherwise, false.
Command-line arguments take precedence over options set by the application when a Microsoft Direct3D device is first created, but they are ignored afterward to allow the user to interactively change the settings.
The following table contains descriptions of possible command-line arguments when executing a sample framework application.
Command-line Argument Description -adapter:# Forces the application to use this adapter ordinal. Fails if the adapter ordinal does not exist. -fullscreen Starts in full-screen mode. -windowed Starts in windowed mode. -startx:# For windowed mode, sets the x-coordinate of the window position to the value of #. -starty:# For windowed mode, sets the y-coordinate of the window position to the value of #. -height:# Sets the window height to the value of #. For full-screen mode, the sample framework picks the closest possible supported mode. -width:# Sets the window width to the value of #. For full-screen mode, the sample framework picks the closest possible supported mode. -forcehal Forces the application to use a hardware abstraction layer (HAL) device type. Fails if a HAL device does not exist. -forcehwvp Forces the application to use hardware vertex processing. Fails if the device does not support this mode. -forcepurehwvp Forces the application to use pure hardware vertex processing. Fails if the device does not support this mode. -forceref Forces the application to use a reference device type. Fails if a reference device does not exist. -forceswvp Forces the application to use software vertex processing. -constantframetime Uses a constant frame time. -noerrormsgboxes Prevents the display of message boxes generated by the framework, allowing the application to be run without user interaction. -quitafterframe:# Forces the application to quit after frame #.
The following table lists the keyboard input that is handled by default when the handleDefaultKeys property is set to true.
Keyboard Input Description ALT+ENTER Toggles between full-screen and windowed modes. ESC Exits the application. F2 Prompts the user to select a new rendering device or display mode. F3 Toggles between HAL and reference devices. F8 Toggles between wireframe and rendered views. PAUSE Pauses the application.
Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center