C3DScreen::CreateFullScreen

Syntax:

CreateFullScreen(int  width, int  height, int  bPP, int  vSync, opt handler=0 as UINT), int

Purpose:
Creates a full screen exclusive Direct3D screen.

Parameters:

width - width of the screen

height - height of the screen

bpp - Bits per pixel.  Valid values are 8, 16, and 32.

vsync - Vertical sync flag.

handler - Optional message handler.

Returned value(s):

0 if screen was successfully created. <> 0 on failure.

Application:

C3DScreen s
s.CreateFullScreen(screen_width,screen_height,32,true)

Class Hierarchy

C3DScreen

Additional Info:

The vsync flag indicates whether Direct3D should synchronize presenting of the rendered surface with the vertical refresh of the monitor. Set to TRUE to wait for vsync or FALSE to immediately show changes.  Waiting for vsync will throttle your maximum FPS to the refresh rate of the monitor.

The optional handler allows using a standard windows handler with your full screen program to process messages sent to the internal window. This allows seamless integration standard event driven code with linear 3D code.

If screen creation fails you can determine the reason for the failure by building a debug executable and running your program under a debug session.  The reason for failure will be printed in the Debug View of the IDE.

A windowed or full screen Direct3D screen must be created before any objects, cameras or meshes.

See Also:

CreateWindowed