OOF2: The Manual

OOF.Material.Assign
Prev  6.2. Menus  Next

Name

OOF.Material.Assign — Assign a Material to pixels in a Microstructure.

Synopsis

OOF.Material.Assign(material, microstructure, pixels)

Details

  • Parent Menu: OOF.Material
  • Callback: function _wrapped_assignmat in module ooflib.engine.IO.materialmenu

  • Parameters:

    material
    Material to be assigned. Type: A character string.
    microstructure
    Type: The path to an existing Microstructure object.
    pixels
    Target pixels. Type: The name of a PixelGroup, or every or selection.

Description

Assigning Materials to pixels is the climactic step in building a Microstructure. The pixels argument is either the name of a pixel group in the Microstructure, or one of the special placeholder objects all or selected. Choosing selected assigns the Material to the pixels currently selected in the Microstructure.

Assigning a Material to a pixel that already has a Material simply overwrites the previous assignment. There is no need to remove the old Material first.

Assigning a Material to a pixel does not store a copy of the information in the Material. The pixel always refers to the Material object for the information it requires. If the Material is edited and its Properties change, then the pixel's properties change.

See Also

Prev  Up  Next
OOF.Material.Add_Property  Home  OOF.Material.Copy