BundleContents

class omni.graph.core.BundleContents(context: ~omni.graph.core._omni_graph_core.GraphContext, node: ~omni.graph.core._omni_graph_core.Node, attribute_name: str, read_only: bool, gpu_by_default: bool, gpu_ptr_kind: ~omni.graph.core._omni_graph_core.PtrToPtrKind = <PtrToPtrKind.NA: 0>)

Bases: object

—– FOR USE BY GENERATED CODE ONLY —–

Manage the allowed types of attributes, providing a static set of convenience values

context

Evaluation context from which this bundle was extracted

Type

GraphContext

read_only

Is the bundle data read-only?

Type

bool

Methods

__init__(context, node, attribute_name, ...)

Initialize the access points for the bundle attribute

add_attributes(types, names)

Add attributes to the bundle

attribute_by_name(attribute_name)

Returns the named attribute within the bundle, or None if no such attribute exists in the bundle

changes([clear_at_exit])

clear()

Empties out the bundle contents

insert(to_insert)

Insert new content in the existing bundle

remove(attribute_name)

Removes the attribute with the given name from the bundle, silently succeeding if it is not in the bundle

remove_attributes(names)

Remove attributes from the bundle

Attributes

attributes

interface objects corresponding to the attributes contained within the bundle

bundle

Underlying bundle of this object

path

the path where this bundle's data is stored

size

the number of attributes within this bundle, 0 if the bundle is not valid

valid

Validity of the underlying bundle

__init__(context: ~omni.graph.core._omni_graph_core.GraphContext, node: ~omni.graph.core._omni_graph_core.Node, attribute_name: str, read_only: bool, gpu_by_default: bool, gpu_ptr_kind: ~omni.graph.core._omni_graph_core.PtrToPtrKind = <PtrToPtrKind.NA: 0>)

Initialize the access points for the bundle attribute

Parameters
  • context – Evaluation context from which this bundle was extracted

  • node – Node owning the bundle

  • attribute_name – Name of the bundle attribute

  • read_only – Is the bundle data read-only?

  • gpu_by_default – Are the bundle members on the GPU by default?

  • gpu_ptr_kind – On which device to pointers to GPU bundles live?

add_attributes(types: List[Type], names: List[str])

Add attributes to the bundle

Parameters
  • types – Vector of types

  • names – The names of each attribute

Note it is required that size(types) == size(names)

attribute_by_name(attribute_name: str) Optional[RuntimeAttribute]

Returns the named attribute within the bundle, or None if no such attribute exists in the bundle

Parameters

attribute_name – Name of the attribute to retrieve

Returns

Bundle member with the given name, None if it was not found

Return type

RuntimeAttribute

clear()

Empties out the bundle contents

Raises

og.OmniGraphError – if the bundle is not writable

insert(to_insert: Union[BundleContents, RuntimeAttribute, Tuple[RuntimeAttribute, str], Tuple[Type, str]]) RuntimeAttribute

Insert new content in the existing bundle

Parameters

to_insert

Object to insert. It can be one of three different types of object:

Bundle: Another bundle, whose contents are entirely copied into this one

RuntimeAttribute: A single attribute from another bundle to be copied with the same name

(RuntimeAttribute, str): A single attribute from another bundle and the name to use for the copy

AttributeDescription: Information required to create a brand new typed attribute

Returns

wrapper to the new attribute if inserting an attribute, else None

Return type

RuntimeAttribute

remove(attribute_name: str)

Removes the attribute with the given name from the bundle, silently succeeding if it is not in the bundle

Parameters

attribute_name – Name of the attribute to remove

remove_attributes(names: List[str])

Remove attributes from the bundle

Parameters

names – The names of each attribute to be removed

Note it is required that size(types) == size(names)

property attributes: List[RuntimeAttribute]

interface objects corresponding to the attributes contained within the bundle

Type

list[RuntimeAttribute]

property bundle: Bundle

Underlying bundle of this object

Type

Bundle

property path: str

the path where this bundle’s data is stored

Type

str

property size: int

the number of attributes within this bundle, 0 if the bundle is not valid

Type

int

property valid: bool

Validity of the underlying bundle

Type

bool