Package Documentation

Object: lofted-surface (The :surf Package)
Mixins: surface

Description

Loft of a surface through a list of curves with various controls.


Input Slots (required)

curves list of gdl curve objects

The curves through which the surface will be lofted.



Input Slots (optional)

brep-tolerance [from surface] number

Overall tolerance for the internal brep representation of this surface. Defaults to nil. Note that a value of nil indicates for SMLib a value of 1.0e-05 of the longest diagonal length of the brep.


built-from [from surface] gdl surface

Specify this if you want this surface to be a clone of an existing surface (note - this uses a shared underlying surface object, it does not make a copy)


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.


end-caps-on-brep? [from surface] boolean

Indicates whether to attempt automatic endcaps on conversion of this surface to a brep. Note that this might change in future to a keyword value for :min, :max, or :both to provide more control.


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).


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).


rail-1 gdl curve object

Guide rail corresponding to minimum U parameter of resulting surface. Defaults to nil.


rail-1-is-spine? boolean

If specified as non-nil, then the rail-1 will be used as a spine curve similar to what is described on page 462 of the NURBS book. Default is nil.


rail-1-params list of curve parameters

The parameter value on the rail-1 which should correspond to each respective profile curve. Defaults to the evenly spaced parameters between the u-min and u-max of the rail-1, one for each profile curve.


rail-2 gdl curve object

Guide rail corresponding to maximum U parameter of resulting surface. Defaults to nil. If both rail-1 and rail2 are given, then they must be synchronized.


rational? [from surface] boolean

Returns non-nil iff this surface is rational, i.e. all weights are not 1.


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


sew-and-orient-brep? [from surface] boolean

Indicates whether brep representation should undergo a sew-and-orient operation. Defaults to nil.


spine gdl curve object

Curve to use as spine for calling ascssk.


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.


synchronized? boolean

Set this to t if the curves already have synchronized control points. It makes the lofted-surface much lighter-weight in terms of its control mesh. Default is NIL (which means the lofted-surface does not assume synchronized control points on the profile curves).


tessellation-parameters [from surface] plist of keyword symbols and numbers

This controls tessellation for the brep of this surface. The keys are as follows:

  • :min-number-of-segments
  • :max-3d-edge-factor
  • :min-parametric-ratio
  • :max-chord-height
  • :max-angle-degrees
  • :min-3d-edge
  • :min-edge-ratio-uv
  • :max-aspect-ratio
and the defaults come from the following parameters:
   (list 
       :min-number-of-segments *tess-min-number-of-segments*
       :max-3d-edge-factor *tess-max-3d-edge-factor*
       :min-parametric-ratio *tess-min-parametric-ratio*
       :max-chord-height *tess-max-chord-height*
       :max-angle-degrees *tess-max-angle-degrees*
       :min-3d-edge *tess-min-3d-edge*
       :min-edge-ratio-uv *tess-min-edge-ratio-uv*
       :max-aspect-ratio *tess-max-aspect-ratio*)


tolerance number

The fitting tolerance to fit to the loft curves. 0 means to interpolate exactly. Default is 0


use-ascssk? boolean

If non-nil, we use the low-level nlib ascssk directly. If nil, we use the SMLib make-skinned-surface routine. Default is nil


v-degree integer

The degree of the surface in the lofting direction. Defaults to 3.


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, defaulting)

center [from base-object] 3d point

Indicates in global coordinates where the center of the reference box of this object should be located.


display-controls [from base-object] plist

May contain keywords and values indicating display characteristics for this object. The following keywords are recognized currently:

:color
color keyword from the *color-table* parameter, or an HTML-style hexidecimal RGB string value, e.g. "#FFFFFF" for pure white. Defaults to :black.
:line-thickness
an integer, defaulting to 1, indicating relative line thickness for wireframe representations of this object.
:dash-pattern
(currently PDF/PNG/JPEG only). This is a list of two or three numbers which indicate the length, in pixels, of the dashes and blank spaces in a dashed line. The optional third number indicates how far into the line or curve to start the dash pattern.


isos [from surface] plist with keys :n-u and :n-v

The number of isoparametric curves to be displayed in each direction. This value comes from the value of :isos on the display-controls if that exists, and defaults to *isos-default* otherwise.


orientation [from base-object] 3x3 matrix of double-float numbers

Indicates the absolute Rotation Matrix used to create the coordinate system of this object. This matrix is given in absolute terms (i.e. with respect to the root's orientation), and is generally created with the alignment function. It should be an orthonormal matrix, meaning each row is a vector with a magnitude of one (1.0).


Examples

                  
 (in-package :surf)

  (define-object test-lofted-surface (base-object)
  
  :input-slots
  ((curves (list (the curve-1) (the curve-2) (the curve-3) (the curve-4)  )))
  
  :objects
  ((lofted-surface :type 'lofted-surface
                   :curves (the curves))
   
   (curve-1 :type 'b-spline-curve
            :display-controls (list :color :red :line-thickness 3)
            :control-points (list (make-point 0 0 0)
                                  (make-point 1 1 0)
                                  (make-point 0 1 0)
                                  (make-point 0 0 0) ))
   
   (curve-2 :type 'b-spline-curve
            :display-controls (list :color :red :line-thickness 3)
            :control-points (list (make-point 0 0 1)
                                  (make-point -1 1 1)
                                  (make-point 0 1 1)
                                  (make-point 0 0 1) ))
           
   (curve-3 :type 'b-spline-curve
            :display-controls (list :color :red :line-thickness 3)
            :control-points (list (make-point 0 0 2)
                                  (make-point -1 -1 2)
                                  (make-point 0 -1 2)
                                  (make-point 0 0 2) ))
   
   (curve-4 :type 'b-spline-curve
            :display-controls (list :color :red :line-thickness 3)
            :control-points (list (make-point 0 0 3)
                                  (make-point 1 -1 3)
                                  (make-point 0 -1 3)
                                  (make-point 0 0 3) ))))

 (generate-sample-drawing :object-roots (make-object 'test-lofted-surface)
                          :projection-direction :trimetric)

 

Package Documentation