|
Action:
|
Gets the current background.
|
|
|
Filename:
|
rbase/rnd_scm/bkgd_scm.cxx
|
|
|
APIs:
|
api_rh_get_background
|
|
|
Syntax:
|
(render:background)
|
|
|
Arg Types:
|
None
|
|
|
Returns:
|
background | boolean
|
|
|
Description:
|
This extension returns the current background. If there is no current background active, it returns
boolean#f.
|
|
|
Example:
|
; render:background
|
|
; Create a solid block.
|
|
(define block1
|
|
|
(solid:block (position -30 -30 -30)
|
|
|
(position 0 0 0)))
|
|
;; block1
|
|
; Create a "clouds" background.
|
|
(define back1 (background "clouds"))
|
|
;; back1
|
|
; Set the background.
|
|
(render:set-background back1)
|
|
;; ()
|
|
; Get the current background.
|
|
(render:background)
|
|
;; #[entity 3 1]
|
|
(render)
|
|
;; ()
|
|
; OUTPUT Example
|
|
|
|
|
Figure 3-11. render:background
|