view:set-bg-color
List of: Scheme Extensions
Subjects: Backgrounds and Foregrounds, Colors, Viewing
Contents: Scheme Support

Action: Sets a view's background color.

Filename: scm/scmext/view_scm.cxx

Syntax: (view:set-bg-color color [view=active])

Arg Types: color integer | color

view view

Returns: view

Description: The argument color specifies the color to set the background, can be as an integer in the range 0-7, or as an rgb color object formed using the color:rgb extension. color integer values are:


0 = Black

1 = Red

2 = Green

3 = Blue

4 = Cyan

5 = Yellow

6 = Magenta

7 = White


The optional argument view specifies which view to get a background color. If view is not specified, the active view is used. The specified background color is displayed after calling view:refresh.

Limitations: This extension is available on all platforms, but produces results only on NT using OpenGL.

Example: ; view:set-bg-color

; Define a new view.

(define view1 (view:dl))

;; view1

; Set the background color to magenta for the

; view using a color integer.

(view:set-bg-color 6 view1)

;; #[view 1075519376]

; Set the background color to light pink for the

; current view using an rgb value.

(view:set-bg-color (color:rgb 0.9 0.45 0.7))

;; #[view 41943045]
PDF/SCM/04SC.PDF
HTM/DATA/SCM/SCM/04SC/0164.HTM