pattern:undo-move-element
List of: Scheme Extensions
Subjects: Patterns
Contents: Kernel

Action: Undoes a move applied to a single element of an existing pattern.

Filename: kern/kern_scm/pattern_scm.cxx

Syntax: (pattern:undo-move-element pat coords)

Arg Types: pat pattern

coords pair

Returns: pattern

Description: Undoes all moves applied to the pattern element specified by coords, restoring it to its original position within the pattern.


pat specifies a pattern.


coords identifies the element in the pattern.

Example: ; pattern:undo-move-element

; make a prism

(define height 1)

;; height

(define maj_rad 1)

;; maj_rad

(define min_rad 0.5)

;; min_rad

(define num_sides 3)

;; num_sides

(define prism (solid:prism height


maj_rad min_rad num_sides))

;; prism

; position the prism

(define origin (position 1 2 3))

;; origin

(define transform (entity:transform prism


(transform:axes


origin (gvector 1 0 0) (gvector 0 1 0))))

;; transform

; make a pattern

(define x-vec (gvector 2 0 0))

;; x-vec

(define num_x 8)

;; num_x

(define y-vec (gvector 0 3 0))

;; y-vec

(define num_y 8)

;; num_y

(define pat (pattern:linear x-vec num_x y-vec num_y))

;; pat

; move one of the pattern elements

(define disp (gvector 0.4 1.2 0.5))

;; disp

(define move (transform:translation disp))

;; move

(set! pat (pattern:move-element pat (list 3 2) move))

;; #[pattern

;; trans-vec: "DOMAIN(X*VEC(2,0,0)+X2*VEC

;; (0,3,0),0,7,0,7)"

;; x-vec:
"null_law"

;; y-vec:
"null_law"

;; z-vec:
"null_law"

;; scale:
"null_law"

;; keep:
"null_law"

;; [list]]

; undo the move

(set! pat (pattern:undo-move-element pat (list 3 2)))

;; #[pattern

;; trans-vec: "DOMAIN(X*VEC(2,0,0)+X2*VEC

;; (0,3,0),0,7,0,7)"

;; x-vec:
"null_law"

;; y-vec:
"null_law"

;; z-vec:
"null_law"

;; scale:
"null_law"

;; keep:
"null_law"

;; [list]]

; apply the pattern to the prism

(define body (entity:pattern prism pat))

;; body
PDF/KERN/14SCI.PDF
HTM/DATA/KERN/KERN/14SCI/0097.HTM