Package Documentation

Object: RENDERER-MIXIN (The :GEOM-BASE Package)
Mixins: VANILLA-MIXIN

Description

Object mixed into the base-view to compute required values to provide a rendered perspective view, as in VRML.


Input Slots (required)

OBJECT-ROOTS list of gdl objects

Roots of the leaf objects to be displayed in this renderer view.


OBJECTS list of gdl objects

Leaves of the objects to be displayed in this renderer view.



Input Slots (optional)

3D-BOX list of two 3d points

The left-front-lower and right-rear-upper corners of the axis-aligned bounding box of the object-roots and objects.


3D-BOX-CENTER 3d point

The effective view center for the scene contained in this view object. Defaults to the center of the bounding sphere of all the objects in the scene, consisting of the object-roots and the objects.


BOUNDING-SPHERE plist containing keys: :center and :radius

This plist represents the tightest-fitting sphere around all the objects listed in the object-roots and the objects


FIELD-OF-VIEW-DEFAULT number in angular degrees

The maximum angle of the view frustrum for perspective views. Defaults to 0.1 (which results in a near parallel projection with virtually no perspective effect).


HIDDEN? [from VANILLA-MIXIN*] boolean

Indicates whether the object should effectively be a hidden-object even if specified in :objects. Default is nil.


ROOT [from VANILLA-MIXIN*] gdl instance

The root-level node in this object's ``tree'' (instance hierarchy).


SAFE-CHILDREN [from VANILLA-MIXIN*] list of gdl instances

All objects from the :objects specification, including elements of sequences as flat lists. Any children which throw errors come back as a plist with error information


STRINGS-FOR-DISPLAY [from VANILLA-MIXIN*] string or list of strings

Determines how the name of objects of this type will be printed in most places. This defaults to the name-for-display (generally the part's name as specified in its parent), followed by an index number if the part is an element of a sequence.


VIEW-VECTORS plist

Keys indicate view vector names (e.g. :trimetric), and values contain the 3D vectors. Defaults to the parameter *standard-views*, but with the key corresponding to current (the view) ordered first in the plist. This list of view-vectors is used to construct the default viewpoints.


VIEWPOINTS list of plists

Each plist contains, based on each entry in the view-vectors, keys:

  • :point (camera location, defaults to the 3d-box-center translated along the corresponding element of view-vectors) by the local camera distance. The camera distance is computed based on the field-of-view angle and the bounding-sphere
  • :orientation (3d matrix indicating camera orientation)
  • field-of-view Angle in degrees of the view frustrum (i.e. lens angle of the virtual camera).


VISIBLE-CHILDREN [from VANILLA-MIXIN*] list of gdl instances

Additional objects to display in Tatu tree. Typically this would be a subset of hidden-children. Defaults to NIL.


Package Documentation