Scene :: createOccurrenceFromSelection

Synopsis

Create a new occurrence and add the given occurrences as children

GUI Dialog

Script function

scene.createOccurrenceFromSelection([name[, children[, parent]]]) -> occurrence

Parameters

   name (String) [optional] : Name of the new occurrence
   children (OccurrenceList) [optional] : Add given occurrence as children (if any)
   parent (Occurrence

) [optional] : If defined, the new occurrence will be created as a child of this parent. Else if children are defined, the first common parent of children will be used as a parent for this new occurrence. Last resort will be to use the root as parent

Return value

occurrence (Occurrence

) : Created occurrence