render:set-environment-map
List of: Scheme Extensions
Subjects: Environment Maps, Rendering Control
Contents: Rendering Base

Action: Sets the currently active environment map.

Filename: rbase/rnd_scm/emap_scm.cxx

APIs: api_rh_set_environment_map

Syntax: (render:set-environment-map environment-map)

Arg Types: environment-map environment-map | boolean

Returns: environment-map

Description: This extension sets the environment-map to be used for rendering. An environment map is used for special rendering features, such as reflections.


An environment map is not supported in Basic Rendering Component. In Advanced Rendering Component, the render mode should be "full" or better.


environment-map specifies the environment map to set. Specifying #f deactivates the environment map and returns renderer to the default state.

Example: ; render:set-environment-map

; Set the environment map to be used in

; rendering objects with materials with

; environment mapped reflections.

(define emap1 (environment-map:render


(part:entities) 256 (position 0 0 0)))

;; emap1

(render:set-environment-map emap1)

;; ()
PDF/RBASE/03SCM.PDF
HTM/DATA/RBASE/RBASE/03SCM/0050.HTM