comp function

Synopsis

  • float[] comp(compSelector) { selector operator expression | ... }
  • string[] comp(compSelector) { selector operator expression | ... }
  • bool[] comp(compSelector) { selector operator expression | ... }

Parameters

  1. compSelector, selector, operator
    These parameters are the same as for the comp operation.
  2. expressionfloat, string, bool
    An expression evaluated per component. All expressions must be of the same type.

Returns

An array that contains the returned values of expression for each component.

Note:

Arrays can not be declared as attr or const.

◾Its size is equal to the number of faces, edges, etc. for a compSelector set to f, e, etc. respectively.

◾For example, for compSelector set to f, the array contains the returned value of expression for each face: the value for face index 0 at position 0, for face index 1 at position 1, and so on.

◾Evaluated expressionss of combined component shapes (operator =) are copied and inserted for each respective topological entity at the relevant index positions.

◾Topological entities which are not selected by a selector are inserted with a default value (0, "", false respectively) at the relevant index positions.

Description

The comp function, very much like the comp operation, divides a shape into topological components (wrt. compSelector, selector, operator) which result in new component shapes. But in contrast to the operation the function does not process the selected components by a sequence of shape operations. Instead a functional expression is evaluated on each selected component shape. The respective return values are organized in an ordered array which is returned as the result of the comp function. Refer to the documentation of the comp operation for details on available compSelectors, selectors and operators.

The returned array has a number of properties:

  • Its size is equal to the number of faces, edges, etc. for a compSelector set to f, e, etc. respectively.
  • For example, for compSelector set to f, the array contains the returned value of expression for each face: the value for face index 0 at position 0, for face index 1 at position 1, and so on.
  • Evaluated expressions of combined component shapes (operator =) are copied and inserted for each respective topological entity at the relevant index positions.
  • Topological entities which are not selected by a selector are inserted with a default value (0, "", false respectively) at the relevant index positions.
Note:

The comp function allows you to gather information about the current shape and its components without changing the current shape or adding successor shapes to the shape tree.

Related

Explanatory examples

Vertices | Comp shape attributes

A shape is split into all of its 6 vertices. Each vertex component is asked for its component index. These values are then organized in an array in edge index order.

array = comp(v) { all : comp.index }

Lot --> print(array)

(6)[0, 1, 2, 3, 4, 5]

Edges | Scope shape attributes

In this example the shape with 7 edges is split into its 6 border edges. Each edge component is asked for its length via its scope attribute. Edge 2 is not selected but inserted in the array with a default value 0.

edgeLength = scope.sx
	
array = comp(e) { border : edgeLength }

(7)[7,15,0,17,15,10,16]

Face edges | Combine shape operator

The shape with 8 face edges is split into its 2 front face edges and into a combined shape consisting of 2 back face edges (operator =). For each front edge a string is constituted using comp shape attributes. The second string expression is evaluated only once but the return value is inserted at all respective back edge indices. The remaining edges are not selected but inserted with a default value (empty string "").

array = comp(fe) { front : comp.sel + comp.index |
                   back  = str(comp.index)       }
		   
(8)[front0,,0,,,0,,front1]

Faces | Occlusion query

The shape with 6 faces is split into one shape consisting of 4 side faces. An occlusion query is evaluated once and the result is inserted into the array for all side faces. The remaining faces are not selected but inserted with a default value (false).

array = comp(f) { side = touches }
		   
(6)[false,true,true,true,true,false]

See for example the setback operation for applications.


In this topic