C3DScreen::CreateWindowed

Top  Previous  Next

Syntax:

 

CreateWindowed(int  l, int  t, int  width, int  height, int  style, string  title, pointer parent, int  vSync, opt handler=0 as UINT), int

 

Purpose:
Creates a windowed Direct3D screen.

 

Parameters:

l, t, width, height - Position and dimensions of new window.

style - Style flags of the window.

title - Caption text for window.

parent - Windows parent or NULL.

vsync - Vertical sync flag.

handler - Optional message handler.

 

Returned value(s):

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

 

Application:

C3DScreen s
s.CreateWindowed(0,0,640,480,@CAPTION|@SIZE,"3D Test - ESC exits",NULL,false)

 

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 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:

CreateFullScreen