|
Action:
|
Creates a conical face relative to the active WCS.
|
|
|
Filename:
|
cstr/cstr_scm/face_scm.cxx
|
|
|
APIs:
|
api_face_cylinder_cone
|
|
|
Syntax:
|
(face:cone position1 position2 radius1 radius2
|
|
|
[start-angle=0 end-angle=360 ratio position3])
|
|
|
Arg Types:
|
position1
|
position
|
|
position2
|
position
|
|
radius1
|
real
|
|
radius2
|
real
|
|
start-angle
|
real
|
|
end-angle
|
real
|
|
ratio
|
real
|
|
position3
|
position
|
|
|
Returns:
|
face
|
|
|
Description:
|
This extension creates a conical face relative to the active WCS.
|
|
|
position1 and
position2 are opposite ends of the cone axis and define the cone height.
|
|
|
radius1 is the cone radius at the base
|
|
|
radius2 is the cone radius at the top. If
radius2 is greater than 0, the object created is a frustum.
|
|
|
start-angle and
end-angle angles default to 0 and 360 degrees, creating a completed conical face. A face of a quarter cone 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 degrees.
|
|
|
ratio allows the creation of an elliptical conical face.
radius1 becomes the major axis and a minor axis is determined by the
ratio (major/minor).
|
|
|
The cone axis defines an alternate
z-axis (as described in
face:plane). This
z-axis defines the top and bottom planes that become the top and bottom elliptical faces of the cone. 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 cone axis defines the top and bottom planes; therefore, the
x-axis simply rotates about the
z-axis until it aligns with
position3.
|
|
|
Example:
|
; face:cone
|
|
; Create conical face 1.
|
|
(define face1
|
|
|
(face:cone (position 0 0 0)
|
|
|
(position 0 50 0) 30 10))
|
|
;; face1
|
|
; Create conical face 2.
|
|
(define face2
|
|
|
(face:cone (position 0 0 0)
|
|
|
(position 0 40 0) 40 20 0 135))
|
|
;; face2
|
|
; OUTPUT Example
|
|
|
|
|
Figure 2-28. face:cone
|