|
Action:
|
Creates a toroidal face.
|
|
|
Filename:
|
cstr/cstr_scm/face_scm.cxx
|
|
|
APIs:
|
api_face_torus
|
|
|
Syntax:
|
(face:torus position spine-radius tube-radius
|
|
|
[tube-start=0 tube-end=360 spine-start=0
|
|
|
spine-end=360 vector])
|
|
|
Arg Types:
|
position
|
position
|
|
spine-radius
|
real
|
|
tube-radius
|
real
|
|
tube-start
|
real
|
|
tube-end
|
real
|
|
spine-start
|
real
|
|
spine-end
|
real
|
|
vector
|
vector
|
|
|
Returns:
|
face
|
|
|
Description:
|
Creates a toroidal face relative to the active WCS.
The torus axis is in the direction of the active
y-axis.
|
|
|
position is the center of the torus.
|
|
|
spine-radius or major radius is the radius of the spine.
|
|
|
tube-radius or minor radius is the radius of the tube, defined by the positive
x-axis with the spine in the
xz plane
|
|
|
tube-start is the starting angle of the tube, defined by the positive
x-axis with the spine in the
xy plane. All angles are measured counter-clockwise and respect the right-hand rule.
|
|
|
spine-end. is the end angle for the spine.
|
|
|
tube-end is the end angle for the tube.
|
|
|
vector creates an alternate
z-axis as described in
face:plane.
|
|
|
Example:
|
; face:torus
|
|
; Create toroidal face 1.
|
|
(define face1 (face:torus (position 0 0 0) 30 10))
|
|
;; face1
|
|
; Create toroidal face 2.
|
|
(define face2
|
|
|
(face:torus
|
|
|
(position -10 -10 -10)
|
|
|
10 20 -90 90 0 180))
|
|
;; face2
|
|
; OUTPUT Example
|
|
|
|
|
Figure 2-34. face:torus
|