SCREENCONTROL

• Source: https://www.freebasic.net/wiki/wikka.php?wakka=KeyPgScreencontrol
• Last revised: 2024-04-05

---

Sets or gets internal graphics library settings

Syntax

declare sub ScreenControl ( byval what as const long, byref param1 as long = &h80000000, byref param2 as long = &h80000000, byref param3 as long = &h80000000, byref param4 as long = &h80000000 )
declare sub ScreenControl ( byval what as const long, byref param1 as longint, byref param2 as longint = &h80000000, byref param3 as longint = &h80000000, byref param4 as longint = &h80000000 )
declare sub ScreenControl ( byval what as const long, byref param as string)

Usage

in the LONG (or INTEGER`<32>`) version of the sub:

ScreenControl( what [, [ param1 ] [, [ param2 ] [, [ param3 ] [, param4 ]]]] )

or,

ScreenControl( what , param )

in the LONGINT (or INTEGER`<64>`) version of the sub:

ScreenControl( what , param1 [, [ param2 ] [, [ param3 ] [, param4 ]]] )

or,

ScreenControl( what , param )

Parameters

what

specifies the function to perform

param1

first integer parameter, contains value to be set on entry or value got on exit

param2

second integer parameter, contains value to be set on entry or value got on exit

param3

third integer parameter, contains value to be set on entry or value got on exit

param4

fourth integer parameter, contains value to be set on entry or value got on exit

param

string parameter, contains text to be set on entry or text got on exit

Description

This function can be used to set or get internal GfxLib states. The what parameter specifies which operation to perform. On operations that set states, the param* parameters must contain the values to be set. On operations that get states, param* will hold the values returned by GfxLib when the function returns.

The meaning of the param* parameters depend on the what parameter, whose possible values are defined as constants in fbgfx.bi. In lang fb, they are set to be stored in the FB Namespace.

Below is a list of the supported what constants - and their values as defined at time of writing - along with the parameters associated with them.

Supported operations

Note:

(*) denotes operations that are allowed while a graphics mode has not yet been set via Screen (Graphics) or ScreenRes,

(**) denotes the operations that must be performed before the graphics mode is set via Screen (Graphics) or ScreenRes,

for all other operations, return values are zero (0) or the empty string ("``") and the operation has no effect if a graphics mode is not available at call time.

Get operations

• GET_WINDOW_POS Returns the current window position, in desktop coordinates.
• (*) GET_WINDOW_TITLE Returns the title of the program window.
• GET_WINDOW_HANDLE Returns a handle to the program window.
• (*) GET_DESKTOP_SIZE Returns the desktop size, in pixels.
• GET_SCREEN_SIZE Returns the current screen size in pixels.
• GET_SCREEN_DEPTH Returns current graphics mode screen depth.
• GET_SCREEN_BPP Returns current graphics mode BPP.
• GET_SCREEN_PITCH Returns the current graphics mode framebuffer pitch, in bytes.
• GET_SCREEN_REFRESH Returns the current graphics mode refresh rate, in hertz.
• GET_DRIVER_NAME Returns the current graphics mode driver name.
• GET_TRANSPARENT_COLOR Returns the transparent color value for the current graphics mode depth.
• GET_VIEWPORT Returns the current viewport as set by the View (Graphics) statement, in screen coordinates.
• GET_PEN_POS Returns the last graphical pen position, in screen coordinates. This position is used in graphics functions supporting relative coordinates using the Step keyword.
• GET_COLOR Returns the current graphics mode color.
• GET_ALPHA_PRIMITIVES Returns if primitives drawing support for alpha channel is enabled.
• GET_GL_EXTENSIONS Returns a string holding all supported GL extensions, or the empty string if not in OpenGL mode.
• GET_HIGH_PRIORITY Returns if GFX_HIGH_PRIORITY was specified in the flags passed to Screen (Graphics) or Screenres.
• GET_SCANLINE_SIZE Returns how currently many scan lines each row of fbgfx video memory should occupy on the screen
• (*) GET_X86_MMX_ENABLED Returns if MMX specific blitters are enabled on X86. fbgfx will select MMX blitters if MMX is enabled and available.
• GET_GL_COLOR_BITS Returns the current number of bits dedicated to the OpenGL color buffer
• GET_GL_COLOR_RED_BITS Returns the current number of bits dedicated to the red component of the OpenGL color buffer
• GET_GL_COLOR_GREEN_BITS Returns the current number of bits dedicated to the green component of the OpenGL color buffer
• GET_GL_COLOR_BLUE_BITS Returns the current number of bits dedicated to the blue component of the OpenGL color buffer
• GET_GL_COLOR_ALPHA_BITS Returns the current number of bits dedicated to the alpha component of the OpenGL color buffer
• GET_GL_DEPTH_BITS Returns the current number of bits dedicated to the OpenGL depth buffer
• GET_GL_STENCIL_BITS Returns the current number of bits dedicated to the OpenGL stencil buffer
• GET_GL_ACCUM_BITS Returns the current number of bits dedicated to the OpenGL accumulation buffer
• GET_GL_ACCUM_RED_BITS Returns the current number of bits dedicated to the red component of the OpenGL accumulation buffer
• GET_GL_ACCUM_GREEN_BITS Returns the current number of bits dedicated to the green component of the OpenGL accumulation buffer
• GET_GL_ACCUM_BLUE_BITS Returns the current number of bits dedicated to the blue component of the OpenGL accumulation buffer
• GET_GL_ACCUM_ALPHA_BITS Returns the current number of bits dedicated to the alpha component of the OpenGL accumulation buffer
• GET_GL_NUM_SAMPLES Returns the current number of samples to be used for OpenGL multisampling
• GET_GL_2D_MODE Returns the current OpenGL 2D render
• GET_GL_SCALE Returns the current zoom factor on OpenGL 2D render (only allowed if OpenGL 2D render mode has yet been activated via SET_GL_2D_MODE)
• SET_WINDOW_POS Sets the current program window position, in desktop coordinates.
• (*) SET_WINDOW_TITLE Sets the current program window title. This is equivalent to calling WindowTitle( param ).
• SET_PEN_POS Sets the current graphical pen position, in screen coordinates. This position is used in graphics functions supporting relative coordinates using the Step keyword.
• (*) SET_DRIVER_NAME Sets the name of the internal graphics driver to be used in subsequent calls to Screen (Graphics) or ScreenRes.
• SET_ALPHA_PRIMITIVES Sets if primitives drawing should honor alpha channel.
• (*) SET_GL_COLOR_BITS Sets the number of bits dedicated to the OpenGL color buffer
• (*) SET_GL_COLOR_RED_BITS Sets the number of bits dedicated to the red component of the OpenGL color buffer
• (*) SET_GL_COLOR_GREEN_BITS Sets the number of bits dedicated to the green component of the OpenGL color buffer
• (*) SET_GL_COLOR_BLUE_BITS Sets the number of bits dedicated to the blue component of the OpenGL color buffer
• (*) SET_GL_COLOR_ALPHA_BITS Sets the number of bits dedicated to the alpha component of the OpenGL color buffer
• (*) SET_GL_DEPTH_BITS Sets the number of bits dedicated to the OpenGL depth buffer
• (*) SET_GL_STENCIL_BITS Sets the number of bits dedicated to the OpenGL stencil buffer
• (*) SET_GL_ACCUM_BITS Sets the number of bits dedicated to the OpenGL accumulation buffer
• (*) SET_GL_ACCUM_RED_BITS Sets the number of bits dedicated to the red component of the OpenGL accumulation buffer
• (*) SET_GL_ACCUM_GREEN_BITS Sets the number of bits dedicated to the green component of the OpenGL accumulation buffer
• (*) SET_GL_ACCUM_BLUE_BITS Sets the number of bits dedicated to the blue component of the OpenGL accumulation buffer
• (*) SET_GL_ACCUM_ALPHA_BITS Sets the number of bits dedicated to the alpha component of the OpenGL accumulation buffer
• (*) SET_GL_NUM_SAMPLES Sets the number of samples to be used for OpenGL multisampling
• (*) SET_X86_MMX_ENABLED Sets if MMX blitters should be used on X86
• (**) SET_GL_2D_MODE Sets OpenGL 2D render
• (**) SET_GL_SCALE Apply a zoom factor on OpenGL 2D render (only allowed if OpenGL 2D render mode has yet been activated via SET_GL_2D_MODE)
• POLL_EVENTS Cause the library to poll all events, ie to check the system event queue, specifically used for retrieving keyboard and mouse events. This is most useful for OpenGL code where Flip is not used, as normally Flip will cause these events to be polled.

Examples

start GeSHi

'' include fbgfx.bi for some useful definitions
#include "fbgfx.bi"

'' use FB namespace for easy access to types/constants
Using FB

Dim e As EVENT
Dim As Long x0, y0, x, y
Dim As Integer shakes = 0
Dim As Any Ptr img

ScreenRes 320, 200, 32
Print "Click to shake window"

'' find window coordinates
ScreenControl GET_WINDOW_POS, x0, y0

Do

    If (shakes > 0) Then
       
        '' do a shake of the window

        If (shakes > 1) Then

            '' move window to a random position near its original coordinates
            x = x0 + Int(32 * (Rnd() - 0.5))
            y = y0 + Int(32 * (Rnd() - 0.5))
            ScreenControl SET_WINDOW_POS, x, y

        Else

            '' move window back to its original coordinates
            ScreenControl SET_WINDOW_POS, x0, y0

        End If

        shakes -= 1

    End If

    If (ScreenEvent(@e)) Then
        Select Case e.Type
       
        '' user pressed the mouse button
        Case EVENT_MOUSE_BUTTON_PRESS

            If (shakes = 0) Then
                '' set to do 20 shakes
                shakes = 20

                '' find current window coordinates to shake around
                ScreenControl GET_WINDOW_POS, x0, y0
            End If

        '' user closed the window or pressed a key
        Case EVENT_WINDOW_CLOSE, EVENT_KEY_PRESS
            '' exit to end of program
            Exit Do

        End Select
    End If

    '' free up CPU for other programs
    Sleep 5

Loop

end GeSHi

start GeSHi

'' include fbgfx.bi for some useful definitions
#include "fbgfx.bi"

Dim As String driver

#ifdef __FB_WIN32__
'' set graphics driver to GDI (Windows only), before calling ScreenRes
ScreenControl FB.SET_DRIVER_NAME, "GDI"
#endif

ScreenRes 640, 480

'' fetch graphics driver name and display it to user
ScreenControl FB.GET_DRIVER_NAME, driver
Print "Graphics driver name: " & driver

'' wait for a keypress before closing the window
Sleep

end GeSHi

Version

• Since fbc 1.20.0: GET_X86_MMX_ENABLED, SET_X86_MMX_ENABLED
• Since fbc 1.10.0: 16 getters from GET_SCANLINE_SIZE to GET_GL_SCALE added.
• Before fbc 1.08.0:

Dialect Differences

• Not available in the -lang qb dialect unless referenced with the alias __Screencontrol.

Differences from QB

• New to FreeBASIC

See also

• Screen (Graphics)
• ScreenEvent
• ScreenInfo
• WindowTitle
• View (Graphics)

Back to DocToc