|
|
QSDK 1.1 Documentation |
|
|
#include <Q/q.h>
Inheritance diagram for Q::Screen:
The screen represents a physical output device. The screen contains a stack of two dimensional layers. The layers can range from simple colored or textured rectangles to full three-dimensional scenes. Typically, the user interface of an application is made up from a number of textured layers and one or more three-dimensional camera layers.
|
|
Define how keyboard focus is transitioned between layers. |
|
|
Define how mouse focus is transitioned between layers.
The mode |
|
|
|
Create a null Screen handle. |
|
|
Destroy the screen. |
|
|
Return the current 'alwaysTop' layer, if any. This is the last layer having the 'alwaysTop' property which was added to the screen. This layer will always be rendered on top of any other layer. |
|
|
If the object referenced by |
|
|
Return the type of this class. |
|
||||||||||||||||||||||||||||
|
Create a screen for the Q::Application. The underlying QDraw parameters for selecting input driver, display driver and window info are given by
physicalExtent and supports rendering to the entire screen area. The second, 'windowed mode' creates a window with dimension physicalExtent and supports rendering into the client area of that window.
The parameters Only one screen can be created at a time. Any attempt to create another screen will return an invalid handle. The current screen can be accessed by Application::app().screen(). |
|
||||||||||||||||||||||||||||||||
|
Create a screen for the Q::Application. The underlying QDraw parameters for selecting input driver and display driver are given by
Two types of screen are supported - the first called 'fullscreen mode', changes mode to the closest supported screen mode to
The parameters Only one screen can be created at a time. Any attempt to create another screen will return an invalid handle. The current screen can be accessed by Q::Application::app().screen(). |
|
||||||||||||
|
Block or allow the transmission of MouseMove and MousePosition events to the layer listeners. |
|
||||||||||||||||
|
Allow the Screen to manage mouse positions. This allows registered layers to receive both position events and relative mouse move events. Calling initMouse enables various "managed mouse" features in Screen and is designed for apps that wish to use a mouse cursor consistently in both windowed and fullscreen mode. It switches the input driver over into a mode which sends mouse delta information. If you configure Screen to use the DX7 input driver, this works well as mouse delta information is sent direct from the device. If however you use the win32 driver, mouse delta information is derived from the raw win32 mouse position information, so you may see bad clipping behaviour if the win32 mouse reaches the edges of the screen (as mouse deltas are derived from the position of the win32 cursor rather than direct from the mouse movement). After a call to initMouse, the following features become valid: filterMouseEvents, mousePos, setMousePos, mouseSensitivity, setMouseSensitivity
|
|
||||||||||||
|
Return |
|
|
Return the layer which currently holds the keyboard focus. |
|
|
Return the current policy for arbitrating keyboard focus between layers. |
|
|
Return the layer directly above the given layer. Return a null layer if the layer is at the top of the stack. |
|
|
Return the layer directly below the given layer. Return a null layer if the layer is at the bottom of the stack. |
|
|
Return the layer which currently holds the mouse focus. |
|
|
Return the current policy for arbitrating mouse focus between layers. |
|
|
Valid only after a call to initMouse. Return the current mouse position in the screen's virtual coordinate system. |
|
|
Valid only after a call to initMouse. Return the mouse sensitivity parameters. The mousemove delta values read from the input device are scaled by this factor before calculating the mouse screen position. |
|
||||||||||||
|
Move |
|
||||||||||||
|
Move |
|
|
Move a layer to the bottom of the stack of layers. |
|
|
Move a layer to the top of the stack of layers. |
|
|
Return the physical aspect ratio of the screen. |
|
|
Return the physical extent of the screen. |
|
|
Read the value of a performance counter. |
|
|
Return the size of the memory cache used to store optimised renderer data structures for visible objects.
|
|
|
Reset the value of a performance counter. |
|
|
Set the keyboard focus to the given layer. |
|
|
Set the policy used for managing the keyboard focus. |
|
|
Set the mouse focus to the given layer. |
|
|
Set the policy used for managing the mouse focus. |
|
|
For use only after a call to initMouse. Set the position of the mouse in the screen's virtual coordinate system. Sends a MousePosition event to layer listeners if allowPositionEvents is set true. |
|
|
Valid only after a call to . Set the mouse sensitivity. The mousemove delta values read from the input device are scaled by this factor before calculating the mouse screen position. |
|
|
Set the extent of the screen's physical coordinate system. |
|
|
Set the size in bytes of the memory cache used to store optimised renderer data structures for visible objects. The default size is 8MB. |
|
|
Set the speaker set associated with the screen. The speaker set is initialised at that point. |
|
|
Enable the clamping of textures to 16 bit pixel formats. |
|
|
Set the size in bytes of the system memory cache used for textures. The texture cache is irrelevant on PC. The default value on Xbox and PS2 is 2MB.
|
|
|
Return the speaker set associated with the screen |
|
|
Return |
|
|
Return the size of the memory cache used for textures.
|
|
|
Return the virtual extent of the screen. |
|
|||
|
|
Qube Software Limited © 2000-2004
|
|