mirror of
https://github.com/QB64Official/qb64.git
synced 2024-09-28 11:17:47 +00:00
82 lines
3.3 KiB
Markdown
82 lines
3.3 KiB
Markdown
The [_DISPLAY](_DISPLAY) statement turns off the automatic display while only displaying the screen changes when called.
|
|
|
|
## Syntax
|
|
|
|
> [_DISPLAY](_DISPLAY)
|
|
|
|
## Description
|
|
|
|
* **_DISPLAY** turns off the auto refresh screen default [_AUTODISPLAY](_AUTODISPLAY) behavior. Prevents screen flickering.
|
|
* Call _DISPLAY each time the screen graphics are to be displayed. Place call after the image has been changed.
|
|
* Re-enable automatic display refreshing by calling [_AUTODISPLAY](_AUTODISPLAY). If it isn't re-enabled, things may not be displayed later.
|
|
* _DISPLAY tells **QB64** to render all of the hardware [_PUTIMAGE](_PUTIMAGE) commands loaded into the buffer previously.
|
|
* The [_AUTODISPLAY (function)](_AUTODISPLAY-(function)) can be used to detect the current display behavior.
|
|
* **QB64** can set the graphic rendering order of _SOFTWARE, _HARDWARE, and _GLRENDER with [_DISPLAYORDER](_DISPLAYORDER).
|
|
|
|
## Example(s)
|
|
|
|
Displaying a circle bouncing around the screen.
|
|
|
|
```vb
|
|
|
|
SCREEN 12
|
|
x = 21: y =31 'start position
|
|
dx = 3: dy = 3 'number of pixel moves per loop
|
|
DO
|
|
_LIMIT 100 ' set to 100 frames per second
|
|
x = x + dx: y = y + dy
|
|
IF x < 0 OR x > 640 THEN dx = -dx 'limit columns and reverse column direction each side
|
|
IF y < 0 OR y > 480 THEN dy = -dy 'limit rows and reverse row direction top or bottom
|
|
IF px <> x OR py <> y THEN FOR d = 1 to 20: CIRCLE (px, py), d, 0: NEXT 'erase
|
|
FOR c = 1 TO 20: CIRCLE (x, y), c, 6: NEXT 'draw new circle at new position
|
|
px = x: py = y 'save older coordinates to erase older circle next loop
|
|
_DISPLAY 'after new circle is set, show it
|
|
LOOP UNTIL INKEY$ = CHR$(27)
|
|
|
|
```
|
|
|
|
> *Explanation:* The loop is set with [_LIMIT](_LIMIT) to 100 frames per second to limit CPU usage and the speed of the ball. Each loop a circle is drawn while the previous one is erased when the coordinates change. _DISPLAY only shows the new circle position once each loop. The **_DISPLAY** routine eliminates the need for setting [SCREEN (statement)](SCREEN-(statement)) swap pages, [CLS](CLS) and [PCOPY](PCOPY). _DISPLAY keeps the image off of the screen until the changes have all completed. Drawing 40 circles every loop helps slow down the ball.
|
|
|
|
[_DISPLAY](_DISPLAY) must be used to render hardware images placed with [_PUTIMAGE](_PUTIMAGE) (**version 1.000 and up**).
|
|
|
|
```vb
|
|
|
|
CONST MenuHeight = 200
|
|
|
|
SCREEN _NEWIMAGE(640, 480, 32)
|
|
'SLEEP 1
|
|
LOCATE 20
|
|
DO
|
|
_LIMIT 30
|
|
DisplayMenu
|
|
k = _KEYHIT
|
|
IF k <> 0 THEN PRINT k,
|
|
LOOP UNTIL k = 32 OR k = 27
|
|
|
|
SUB DisplayMenu
|
|
STATIC init, MS_HW AS LONG
|
|
IF NOT init THEN
|
|
init = -1
|
|
MS = _NEWIMAGE(640, MenuHeight, 32) 'MenuScreen image
|
|
D = _DEST: _DEST MS
|
|
CLS , &HFFAAAAAA 'background color gray
|
|
_PRINTSTRING (20, 2), "Menu Test" 'image text
|
|
MS_HW = _COPYIMAGE(MS, 33) 'create the MenuScreen_HardWare image
|
|
_FREEIMAGE MS
|
|
_DEST D
|
|
END IF
|
|
_PUTIMAGE (0, 0)-(640, MenuHeight), MS_HW
|
|
_DISPLAY
|
|
END SUB
|
|
|
|
```
|
|
|
|
> *Notes:* When _DISPLAY is commented out, the hardware Menu Test screen portion will blink and key codes may be seen underneath.
|
|
|
|
## See Also
|
|
|
|
* [_DISPLAY (function)](_DISPLAY-(function))
|
|
* [_DISPLAYORDER](_DISPLAYORDER)
|
|
* [_AUTODISPLAY](_AUTODISPLAY), [_AUTODISPLAY (function)](_AUTODISPLAY-(function))
|
|
* [_PUTIMAGE](_PUTIMAGE)
|
|
* [PCOPY](PCOPY)
|