OOF2: The Manual

OOF.ElementGroup.Assign_Material
	6.2.7. OOF.ElementGroup Commands

Name

OOF.ElementGroup.Assign_Material — Assign a bulk material to an element group.

OOF.ElementGroup.Assign_Material(skeleton,group,material)

Parent Menu: OOF.ElementGroup
Callback: function _assign_matl in module ooflib.engine.IO.skeletongroupmenu
Options: cli_only=1
Parameters:

skeleton

Type: The path to an existing Skeleton object.

group

Name of the group. Type: The name of a group of Skeleton elements.

material

Name of the material. Type: A character string.

Assigning a Material to a Skeleton Element is a way of overriding the Material assigned to pixels by OOF.Material.Assign. Normally an Element's Material is implicitly inherited from the Element's dominant pixel. If a Material has been explicitly assigned to an ElementGroup with OOF.ElementGroup.Assign_Material, the explicitly assigned Material will be used instead of the implicitly inherited Material for all Elements in the group.

If an Element is in more than one ElementGroup, the Element's Material is the last one assigned to any of the groups to which the Element belongs. If a Material is assigned to a group that already has an explicitly assigned Material, the new Material replaces the old one.

If an explicitly assigned Material is removed with OOF.ElementGroup.Remove_Material, the implicitly inherited Material will be used.

In the GUI, OOF.ElementGroup.Remove_Material is invoked by the Remove button in the Material subpane of the Element group operations pane in the Skeleton Selection Page when the page is in Elements mode.


OOF.ElementGroup.Add_to_Group		OOF.ElementGroup.Auto_Group