pymel.core.system.iterReferences¶
- iterReferences(parentReference=None, recursive=False, namespaces=False, refNodes=False, references=True, recurseType='depth', loaded=None, unloaded=None)¶
returns references in the scene as a list of value tuples.
The values in the tuples can be namespaces, refNodes (as PyNodes), and/or references (as FileReferences), and are controlled by their respective keywords (and are returned in that order). If only one of the three options is True, the result will not be a list of value tuples, but will simply be a list of values.
Parameters: - parentReference (string, Path, or FileReference) – a reference to get sub-references from. If None (default), the current scene is used.
- recursive (bool) – recursively determine all references and sub-references
- namespaces (bool) – controls whether namespaces are returned
- refNodes (bool) – controls whether reference PyNodes are returned
- refNodes (bool) – controls whether FileReferences returned
- recurseType (string) – if recursing, whether to do a ‘breadth’ or ‘depth’ first search; defaults to a ‘depth’ first
- loaded (bool or None) – whether to return loaded references in the return result; if both of loaded/unloaded are not given (or None), then both are assumed True; if only one is given, the other is assumed to have the opposite boolean value
- unloaded (bool or None) – whether to return unloaded references in the return result; if both of loaded/unloaded are not given (or None), then both are assumed True; if only one is given, the other is assumed to have the opposite boolean value