Alternatives Messages

• ALTERNATIVE_ADD_ITEMS - Adds geometry nodes to an existing alternative geometry group.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the existing alternative to add geometry nodes to.

  • geometry_list - The list of geometry nodes to be added to the alternative. If the list is empty the currently selected geometry is added.

• ALTERNATIVE_ADD_ITEMS_BYLABEL - Adds geometry nodes to an existing alternative geometry group.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the existing alternative to add geometry nodes to.

  • geometry_list - The list of geometry nodes to be added to the alternative. If the list is empty the currently selected geometry is added.

• ALTERNATIVE_CHANGED - Indicates that the contents of an existing alternative were modified.

  Parameters:

  • lineupType - The type of lineup that the modified alternative belonged to.

  • lineupName - The name of the lineup that the modified alternative belonged to.

  • alternativeName - The name of the alternative that was modified.

• ALTERNATIVE_CHOICE - Selects an alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative to select belongs to.

  • alternativeName - The name of the alternative to select.

  • dataList - List of data to set the state to after switching to a given alternative.

• ALTERNATIVE_CHOICE_BYLABEL - Allows an ALTERNATIVE_CHOICE message to be issued by specifying labels instead of names. Since labels need not be unique, and since wildcards are allowed, more than one alternative may match; in that case, only one ALTERNATIVE_CHOICE message will be issued per lineup.

  Parameters:

  • altLineupLabel - Alternative lineup label.

  • altLabel - Alternative label.

• ALTERNATIVE_CREATE - Creates a new alternative geometry group in the given alternative lineup.

  Parameters:

  • lineupName - The name of the existing alternative lineup.

  • alternativeName - The name of the new alternative to be added to the lineup.

  • imageName - The name of the image to be applied to the alternative.

  • item_list - The tuple of object IDs to be added to the alternative.

  • setCurrent - True to make the created set current.

• ALTERNATIVE_CREATE_BYLABEL - Creates a new alternative geometry group in the given alternative lineup.

  Parameters:

  • lineupName - The name of the existing alternative lineup.

  • alternativeName - The name of the new alternative to be added to the lineup.

  • imageName - The name of the image to be applied to the alternative.

  • item_list - The tuple of object IDs to be added to the alternative.

  • setCurrent - True to make the created set current.

• ALTERNATIVE_CREATE_DATA - Creates a new alternative geometry group in the given alternative lineup.

  Parameters:

  • lineupName - The name of the existing alternative lineup.

  • alternativeName - The name of the new alternative to be added to the lineup.

  • imageName - The name of the image to be applied to the alternative.

  • item_list - The tuple of items to be added to the alternative, where each tuple is in the form (objectId, objectData). For a positional alternative, the objectData represents the object's world space inclusive transform matrix. For a material alternative, the objectData is the material's name. For a model alternative, the objectData is simply the object's ID. If the list is empty the currently selected geometry is added.

  • setCurrent - True to make the created set current.

• ALTERNATIVE_CREATE_DATA_BYLABEL - Creates a new alternative geometry group in the given alternative lineup.

  Parameters:

  • lineupName - The name of the existing alternative lineup.

  • alternativeName - The name of the new alternative to be added to the lineup.

  • imageName - The name of the image to be applied to the alternative.

  • item_list - The tuple of items to be added to the alternative, where each tuple is in the form (objectId, objectData). For a positional alternative, the objectData represents the object's world space inclusive transform matrix. For a material alternative, the objectData is the material's name. For a model alternative, the objectData is simply the object's ID. If the list is empty the currently selected geometry is added.

  • setCurrent - True to make the created set current.

• ALTERNATIVE_CREATE_SET - Creates a new alternative lineup.

  Parameters:

  • lineupName - The name of the new alternative lineup.

  • setType - The type of alternative, specified by AlternativeSet.AlternativeType: 'model', 'positional', 'material'.

• ALTERNATIVE_DELETE - Deletes an existing alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative to be deleted from the lineup.

• ALTERNATIVE_DELETED - Indicates that an alternative was deleted.

  Parameters:

  • lineupType - The type of lineup that the deleted alternative belonged to.

  • lineupName - The name of the lineup that the deleted alternative belonged to.

  • alternativeName - The name of the alternative that was deleted.

• ALTERNATIVE_DELETE_BYLABEL - Deletes an existing alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative to be deleted from the lineup.

• ALTERNATIVE_DELETE_SET - Deletes an existing alternative lineup.

  Parameters:

  • lineupName - The name of the alternative lineup to be deleted.

• ALTERNATIVE_DELETE_SET_BYLABEL - Deletes an existing alternative lineup.

  Parameters:

  • lineupName - The name of the alternative lineup to be deleted.

• ALTERNATIVE_DUPLICATE - Duplicates the geometry content of an existing alternative and creates a new alternative containing the duplicated geometry.

  Parameters:

  • lineupName - The name of the lineup that the existing alternative belongs to.

  • alternativeName - The name of the alternative to be duplicated.

  • newName - The name of the newly created alternative.

• ALTERNATIVE_DUPLICATE_BYLABEL - Duplicates the geometry content of an existing alternative and creates a new alternative containing the duplicated geometry.

  Parameters:

  • lineupName - The name of the lineup that the existing alternative belongs to.

  • alternativeName - The name of the alternative to be duplicated.

  • newName - The name of the newly created alternative.

• ALTERNATIVE_IMAGE_SET - Indicates that an image has been set for an alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative that the image was applied to.

  • image - The name of the image that was applied.

• ALTERNATIVE_REMOVE_ITEMS - Removes geometry nodes from an existing alternative geometry group.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the existing alternative to remove the geometry from.

  • geometry_list - The list of geometry nodes to be removed from the alternative. If empty the currently selected geometry is removed.

• ALTERNATIVE_REMOVE_ITEMS_BYLABEL - Removes geometry nodes from an existing alternative geometry group.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the existing alternative to remove the geometry from.

  • geometry_list - The list of geometry nodes to be removed from the alternative. If empty the currently selected geometry is removed.

• ALTERNATIVE_RENAME - Changes the label of an existing alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative.

  • newLabel - The new label for the alternative.

• ALTERNATIVE_RENAMED - Indicates that the label of an alternative changed.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative.

  • newLabel - The new label for the alternative.

• ALTERNATIVE_RENAME_BYLABEL - Changes the label of an existing alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative.

  • newLabel - The new label for the alternative.

• ALTERNATIVE_RENAME_SET - Changes the label of an existing alternative lineup.

  Parameters:

  • lineupName - The name of the alternative lineup.

  • newLabel - The new label for the lineup.

• ALTERNATIVE_RENAME_SET_BYLABEL - Changes the label of an existing alternative lineup.

  Parameters:

  • lineupName - The name of the alternative lineup.

  • newLabel - The new label for the lineup.

• ALTERNATIVE_REQUEST_SET_CREATION - Requests the creation of a new alternative lineup. This message displays a popup menu listing the types of alternative lineups to create and then creates the lineup when the user selects the type from the list.

• ALTERNATIVE_SET_CHANGED - Indicates that the contents of an existing alternative lineup were modified.

  Parameters:

  • lineupType - The type of alternative lineup that was modified.

  • lineupName - The name of the alternative lineup that was modified. An empty string indicates that the alternative lineup was deleted.

• ALTERNATIVE_SET_CREATED - Indicates that an alternative lineup was created.

  Parameters:

  • lineupName - The name of the new alternative lineup.

• ALTERNATIVE_SET_DELETED - Notification that an alternative lineup has been deleted.

  Parameters:

  • lineupName - The name of the alternative lineup that was deleted.

• ALTERNATIVE_SET_IMAGE - Sets an image for an existing alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative to apply the image to.

  • image - The name of the image.

• ALTERNATIVE_SET_IMAGE_BYLABEL - Sets an image for an existing alternative.

  Parameters:

  • lineupName - The name of the lineup that the alternative belongs to.

  • alternativeName - The name of the alternative to apply the image to.

  • image - The name of the image.