Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

XG.3D-INSERT-BOX

source files: [xc]shp.[ch]

SYNTAX

(XG.3D-INSERT-BOX
  :THING <thing>
[ :TRANSFORM <xtfm> ]
[ :X <num> ] [ :Y <num> ] [ :Z <num> ]
[ :SCALE <num> ]
[ :SCALE-X <num> ] [ :SCALE-Y <num> ] [ :SCALE-Z <num> ]
)

DESCRIPTION

The <thing> must be a 'thing' in the :DRAW <camera> sense, a disembodied propertylist containing a :POINT-RELATION, and also a :FACET-RELATION. Both must be rank-1.

This call inserts eight X-Y-Z points in :POINT-RELATION, defining the corners of a box, and also six four-sided facets in :FACET-RELATION.

The resulting box has is 1.0 x 1.0 x 1.0 before SCALEing is applied, centered on :X :Y :Z.

If :TRANSFORM is supplied, it must be an instance of CLASS-MATRIX44, and will be used to transform the box exactly as if by XG.3D-TRANSFORM-THING.


Go to the first, previous, next, last section, table of contents.