|
Action:
|
Creates a cylindrical face relative to the active WCS.
|
|
|
Filename:
|
cstr/cstr_scm/face_scm.cxx
|
|
|
APIs:
|
api_face_cylinder_cone
|
|
|
Syntax:
|
(face:cylinder position1 position2 radius
|
|
|
[start-angle=0 end-angle=360 ratio position3])
|
|
|
Arg Types:
|
position1
|
position
|
|
position2
|
position
|
|
radius
|
real
|
|
start-angle
|
real
|
|
end-angle
|
real
|
|
ratio
|
real
|
|
position3
|
position
|
|
|
Returns:
|
face
|
|
|
Description:
|
This extension creates a cylindrical face relative to the active WCS.
|
|
|
position1 and
position2 are opposite ends of the cylinder axis and define the cylinder height. The cylinder
radius is self-explanatory.
|
|
|
start-angle and
end-angle angles default to 0 and 360 degrees creating a completed cylindrical face. A face of a quarter cylinder may be defined, for example, by specifying 0 for
start-angle and 90 for
end-angle. The angles must lie in the range of -360 to 360.
|
|
|
ratio allows the creation of an elliptical cylindrical face. The
radius becomes the major axis and a minor axis is determined by the
ratio (major/minor).
|
|
|
The cylinder axis defines an alternate
z-axis as previously described in
face:plane. This
z-axis defines the top and bottom planes that become the top and bottom elliptical faces of the cylinder. The start (start-angle) and end (end-angle) angles and the elliptical major axis are based from the alternate
x-axis.
|
|
|
position3 if specified, the
x-axis becomes the line drawn to the projection of this point on the top and bottom planes. The cylinder axis defines the top and bottom planes; therefore,
x-axis simply rotates about the
z-axis until it aligns with
position3.
|
|
|
Example:
|
; face:cylinder
|
|
; Create cylindrical face 1.
|
|
(define face1
|
|
|
(face:cylinder (position 0 0 0)
|
|
|
(position 0 50 0) 10))
|
|
;; face1
|
|
; Create cylindrical face 2.
|
|
(define face2
|
|
|
(face:cylinder (position 0 0 0)
|
|
|
(position 0 40 0) 15 45 135))
|
|
;; face2
|
|
; OUTPUT Example
|
|
|
|
|
Figure 2-29. face:cylinder
|