OOF2: The Manual

placeholder
	6.6. Other Objects

Name

placeholder — Placeholder arguments for groups

Description

OOF2 often gives the user a choice between operating upon objects stored in a named group (e.g, pixel groups or Node group) or upon the current selection (e.g, the pixel selection), or upon all of the existing objects (e.g, all of the pixels in a Microstructure or all the Nodes in a Skeleton). In such situations, the GUI presents a pull down menu containing the names of the relevant groups and two additional placeholder entries, <selection> and <all>, as shown in Figure 6.122. Choosing <selection> applies the operation to the current selection. Choosing <all> applies the operation to all objects.

Figure 6.122. The selection placeholder

A menu listing a bunch of groups, plus the placeholders <selection> and <all>.

The placeholders are shown with angle brackets (< and >) in the GUI to distinguish them from groups that a perverse user might have named “selection” or “all”. In scripts, group names always appear in quotation marks, and the placeholders are simply predefined Python variables, selection and all. They should be entered without quotation marks, such as in this command to assign a Material to the currently selected pixels:

          OOF.Material.Assign(material='material',
	                      microstructure='microstructure',
                              pixels=selection)

The following command, on the other hand, assigns a Material to all pixels in the group (perversely) named “selection”:

          OOF.Material.Assign(material='material',
	                      microstructure='microstructure',
                              pixels='selection')


Point		automatic

/* OOF home */ /* OOF2 home */ /* Send mail to the OOF Team */