building_blocks.face.group

Syntax

s := building_blocks.face.group(fp<,slot>)

building_blocks.face.group(fp<,slot>) := s

Get/set the group name assigned to face fp in slot slot, if provided. The slot named 'Default' is used by default if slot is not provided.

On set, a group index may be used instead of a string for s. On get or set, a slot index may be used instead of a string for slot. Indices operate more efficiently than strings.*

Returns:

s - the group name; None is returned if no group has been assigned in the given slot

Accepts:

s - the group name or index*; if not present, the group is created in the given slot

Arguments:

fp - face pointer

slot - the slot name or index*; if not given, the slot name 'Default' is used

Note

*Use the group.find and group.find.slot intrinsics to obtain group and slot indices, respectively, and for further information.

Use of the group logic is described in Groups.