| Object: boxed-curve (The :surf Package) |
| Mixins: outline-specialization-mixin, b-spline-curve |
| Input Slots (required) | |
| curve-in gdl curve object | |
This can be any type of curve, e.g. b-spline-curve, fitted-curve, or an edge from a solid brep. Note that the reference-box of this curve (i.e. its center and orientation) will have an effect on the resulting boxed-curve. If you want to consider the incoming curve-in as being in global space, then make sure its center is (0 0 0) and its orientation is nil or equivalent to geom-base::+identity-3x3+ | |
| Input Slots (optional) | |
| built-from [from curve] gdl curve | |
Specify this if you want this curve to be a clone of an existing curve. (note - this uses a shared underlying curve object, it does not make a copy) | |
| center 3d point in global space | |
You can pass in a new center for the curve's reference box, which will move the whole box including the curve. This defaults to the orientation-center (if given), otherwise to the (the curve-in center). | |
| color-decimal [from geometry-kernel-object-mixin] vector of three real numbers | |
The RGB color of this object as imported from an external format (e.g. IGES) or as specified in :display-controls. Defaults to the foreground color specified in *colors-default*. This message should not normally be overridden in user application code. | |
| from-center 3d point in global space | |
The center with respect to which this object should be positioned. Normally this should not be specified by user code, unless you know what you are doing [e.g. to override the center of a curve-in which is meaningless and force it to be interpreted as a curve in global space, you could specify this as (the center) when passing it in from the parent]. Default is (the curve-in center). | |
| from-object gdl object which mixes in base-object | |
The current boxed-curve will be positioned and oriented with respect to the center and orientation of this object. The default is (the curve-in). | |
| from-orientation 3x3 transformation matrix | |
The orientation with respect to which this object should be oriented. Normally this should not be specified by user code, unless you know what you are doing [e.g. to override the orientation of a curve-in which is meaningless and force it to be interpreted as a curve in the parent's coordinate system, you could specify this as (the orientation) when passing it in from the parent]. Default is (the curve-in orientation). | |
| hidden? [from vanilla-mixin*] boolean | |
Indicates whether the object should effectively be a hidden-object even if specified in :objects. Default is nil. | |
| iges-level [from geometry-kernel-object-mixin] integer | |
Synonym for the layer. | |
| image-file [from base-object] pathname or string | |
Points to a pre-existing image file to be displayed instead of actual geometry for this object. Defaults to nil | |
| layer [from geometry-kernel-object-mixin] integer | |
The primary IGES-compatible level (layer) on which this object resides. Defaults to the first of the levels. This slot can be overridden in user code to specify a new layer which will be written out when this object is exported with the IGES output-format. | |
| levels [from geometry-kernel-object-mixin] list of integers | |
The IGES-compatible levels (layers) on which this object resides. GDL does not currently support writing out multiple levels (layers) through the IGES writer ; only the first of these will be output if the object is exported with the IGES output-format (please contact Genworks if you need all levels (layers) to be written out). | |
| local? [from b-spline-curve] boolean | |
Indicates whether the inputted control-points should be considered in local coordinate system of this object. Default is nil. | |
| obliqueness [from base-object] 3x3 orthonormal matrix of double-float numbers | |
This is synonymous with the orientation. | |
| onclick-function [from base-object] lambda function of zero arguments, or nil | |
If non-nil, this function gets invoked when the user clicks the object in graphics front-ends which may or may not support this functionality (see viewport-html-div). | |
| orientation 3x3 transformation matrix | |
This will be the new orientation for the box and the contained curve. Default is (the curve-in orientation) -- i.e. identical orientation with the provided curve-in. | |
| orientation-center 3d point in global space | |
If you provide this, the curve's reference box will be moved to have its center at this point, before any orientation is applied. This will become the new center of the resulting boxed-curve, unless you explicitly pass in a different center. 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 | |
| scale number | |
The overall scale factor for X, Y, and Z, if no individual scales are specified. Defaults to 1. | |
| scale-x number | |
The scale factor for X. Defaults to 1. | |
| scale-y number | |
The scale factor for Y. Defaults to 1. | |
| scale-z number | |
The scale factor for Z. Defaults to 1. | |
| show-box? boolean | |
This determines whether the reference box is displayed along with the curve. Default is t (will be changed to nil). | |
| show-control-polygon? boolean | |
This determines whether the control polygon is displayed along with the curve. Default is nil. | |
| show-tight-box? boolean | |
This determines whether the tight box is displayed along with the curve. Default is nil. | |
| 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. | |
| translation-threshold number | |
Tolerance to determine whether the boxed-curve has moved with respect to the original. Default is *zero-epsilon* | |
| uv-curve [from curve] gdl curve object | |
The corresponding UV curve for the primary surface on which this curve lies, if any. If this is not a surface-curve, this will return an error. | |
| 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. | |
| Input Slots (optional, settable) | |
| tolerance [from curve] number | |
Approximation tolerance for display purposes. Defaults to the tolerance of the built-from curve, if one exists, otherwise defaults to the *display-tolerance*. | |
| Input Slots (optional, defaulting) | |
| display-controls [from base-object] plist | |
May contain keywords and values indicating display characteristics for this object. The following keywords are recognized currently:
| |
| Computed Slots | |
| control-points [from b-spline-curve] list of 3d points | |
The control points. | |
| degree [from b-spline-curve] integer | |
Degree of the curve. Defaults to 3 (cubic). | |
| height [from base-object] number | |
Z-axis dimension of the reference box. Defaults to zero. | |
| knot-vector [from b-spline-curve] list of numbers | |
Knots of the curve. Default is NIL, which indicates a uniform knot vector. | |
| length [from base-object] number | |
Y-axis dimension of the reference box. Defaults to zero. | |
| weights [from b-spline-curve] list of numbers | |
A weight to match each control point. Should be same length as control-points. Default is a value of 1.0 for each weight, resulting in a nonrational curve. | |
| width [from base-object] number | |
X-axis dimension of the reference box. Defaults to zero. | |
(define-object boxed-curves-test (base-object)
:computed-slots ((b-spline (the b-splines (curves 2))))
:objects
((b-splines :type 'test-b-spline-curves)
(boxed :type 'boxed-curve
:curve-in (the b-splines (curves 2)))
(translated :type 'boxed-curve
:curve-in (the b-spline)
:center (translate (the center) :left 15))
(twisted :type 'boxed-curve
:curve-in (the boxed)
:orientation
(alignment :left (the (face-normal-vector :top))
:rear (rotate-vector-d (the (face-normal-vector :rear))
30
(the (face-normal-vector :top)))))
(rotated :type 'boxed-curve
:curve-in (the b-spline)
:display-controls (list :color :purple)
:orientation
(alignment :left
(rotate-vector-d (the (face-normal-vector :left))
50
(the (face-normal-vector :rear)))))
(rotated-about :type 'boxed-curve
:curve-in (the b-spline)
:display-controls (list :color :purple)
:orientation-center (translate (the center) :right 2.5)
;;:center (translate (the center) :up 5)
:orientation
(alignment :left
(rotate-vector-d (the (face-normal-vector :left))
45
(the (face-normal-vector :rear)))))
(moved-up :type 'boxed-curve
:curve-in (the rotated-about)
:center (translate (the rotated-about center)
:up 7
:left 5))
(straightened :type 'boxed-curve
:curve-in (the moved-up)
:orientation
(alignment
:left
(rotate-vector-d
(the-child curve-in (face-normal-vector :left))
45
(the-child curve-in (face-normal-vector :rear)))
:rear (the-child curve-in (face-normal-vector :rear))))
(rotated-straightened :type 'boxed-curve
:curve-in (the straightened)
:orientation (the moved-up orientation)
:orientation-center
(translate (the-child curve-in center) :up 2.5))
(rotated-straightened-moved :type 'boxed-curve
:curve-in (the rotated-straightened)
:center (translate (the-child curve-in center)
:right 5))
(center-sphere :type 'sphere
:radius 0.3
:center (the moved-up-and-straightened orientation-center))
(moved-up-and-straightened
:type 'boxed-curve
:curve-in (the straightened)
:center (translate (the-child orientation-center) :right 7)
:orientation
(alignment :left
(the-child curve-in (face-normal-vector :rear))
:front
(rotate-vector-d (the-child curve-in (face-normal-vector :left))
45
(the-child curve-in (face-normal-vector :rear))))
:orientation-center (translate (the straightened center) :up 2.5))
(moved-up-and-straightened-1
:type 'boxed-curve
:curve-in (the straightened)
:center (translate (the-child curve-in center) :right 14)
:orientation (the rotated-straightened orientation)
:orientation-center (translate (the straightened center) :up 2.5))
(moved-up-and-straightened-2
:type 'boxed-curve
:curve-in (the straightened)
:center (translate (the-child curve-in center) :right 21)
:orientation (the rotated-straightened orientation)
:orientation-center (translate (the straightened center) :up 2.5))
(transformed
:type 'boxed-curve
:curve-in (the b-spline)
:center (translate (the center) :left 50)
:orientation
(alignment :rear
(rotate-vector-d (the (face-normal-vector :rear))
30
(the (face-normal-vector :right)))))))