ATTACHSCREEN

Syntax

INT = ATTACHSCREEN(win as WINDOW,width as int,height as int,OPT bStretch=0 as INT)

Description

Attaches a DirectX screen to a window to create a non exclusive windowed mode DirectX program.

Parameters

win - Window to attach screen to

width - Width of DirectX screen

height - Height of DirectX screen

bStretch - Optional. 1 to scale screen to window, 0 to use the sizes provided.

Return value

0 if DirectX screen was created successfully and attached to the window. < 0  if creation fails.

Remarks

Only one windowed mode DirectX screen is allowed at a time in your program. If a screen already exists then this function will fail. You must use the  CLOSESCREEN command to remove the DirectX screen before closing the window.

See Also: CLOSESCREEN, CREATESCREEN

Example usage

OPENWINDOW win,0,0,width,height,@NOAUTODRAW|@SIZE,0,"Caption",&handler
IF(ATTACHSCREEN(win,width,height,TRUE) < 0)
    MESSAGEBOX win,"Couldn't create DirectX window","Error"
    CLOSEWINDOW win
    END
ENDIF