OOF2: The Manual

OOF.ElementGroup.Assign_Material
Prev  6.2. Menus  Next

Name

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

Synopsis

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

Details

  • Parent Menu: OOF.ElementGroup
  • Callback: function _assign_matl in module ooflib.engine.IO.skeletongroupmenu

  • 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.

Description

Assigning a Material to a Skeleton ElementGroup 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 chronologically last one assigned to any of the groups to which the Element belongs. If a Material is assigned to a group that already had an explicitly assigned Material, the new Material replaces the old one for all Elements in the group.

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

See Also

Prev  Up  Next
OOF.ElementGroup.Add_to_Group  Home  OOF.ElementGroup.Auto_Group