ds:get-comb-graphics
List of: Scheme Extensions
Subjects: Deformable Surfaces
Contents: ACIS Deformable Modeling

Action: Gets the number of points and the gain used in the rendering of a curvature comb graphical report for a deformable model.

Filename: adm/ds_scm/dsscm.cxx

APIs: api_dm_get_attrib_dm2acis

Syntax: (ds:get-comb-graphics owner [target=1])

Arg Types: owner entity

target integer

Returns: ((integer . real) ...)

Description: Gets the number of points and scaling gain used in the graphical parameter space curvature comb report for a target deformable model.


The target argument specifies which deformable model to use in a patch hierarchy. Valid values for target are:


1 = active deformable model

2 = root deformable model

-1 = active deformable model and offspring

-2 = root deformable model and offspring


Otherwise, the target is the deformable model whose tag identifier equals target.


Curvature combs are a graphical representation of the parameter space curvature properties of the curve constraints. A curvature comb is made up of a set of vectors drawn from the curve in the direction of principle curvature. The magnitude of the vector is the curvature. These combs are then projected through the deformable surface shape into three dimensional space for rendering which tends to distort them as the surface is manipulated.


The number of vectors drawn per element is specified by elem_pt_count. gain is an additional gain factor used to scale the curvature comb for viewing convenience.


owner ACIS face or edge on which the deformable model lives.


target specifies which deformable model to use in a patch hierarchy.

Example: ; ds:get-comb-graphics

; Build a test square face with some tag objects

; (6x6 control points, x and y side length = 36)

(define dsmodel1 (ds:test-face 6 6 36 36 0))

;; dsmodel1

; Don't display entity / ds test face exists.

(define erase (entity:erase dsmodel1))

;; erase

; Render the loads and constraints.

(ds:set-draw-state dsmodel1 1


(+ ds-draw-cstrns ds-draw-loads))

;; ()

; Replace the default edge constraints with a circle

; constraint.

(ds:toggle-cstrn dsmodel1 1)

;; 0

(ds:toggle-cstrn dsmodel1 2)

;; 0

(ds:toggle-cstrn dsmodel1 3)

;; 6

(ds:toggle-cstrn dsmodel1 4)

;; 6

(ds:add-circ-cstrn dsmodel1 1 "position"


(par-pos 0.5 0.5) (par-pos 0 0.3)


(par-pos 0.3 0))

;; 7

; Render the loads, constraints, and the

; curvature reports.

(ds:get-draw-state dsmodel1 1)

;; 12

; Adjust the curvature plot graphics

; to draw the comb pointing to the convex side.

(ds:set-comb-graphics dsmodel1 1 20 -1.0)

;; ()

; Retrieve the curvature plot graphical parameters.

(ds:get-comb-graphics dsmodel1 1)

;; (20 -1)
PDF/ADM/05SCD.PDF
HTM/DATA/ADM/ADM/05SCD/0010.HTM