export_nodes

export_nodes(filename, nodes=[], first_frame=0, frame_count=0, samples=[], cyclic=True, progress=<function _progress>, get_name=<function _get_name>, export_parents=True)

“Export the deformed geometries to an Alembic file.

This file can be used to import the deformed geometry back in any Alembic compatible software.

Parameters:
  • filename (unicode) – the alembic file path
  • nodes (list rumba.Node) – the nodes to export or an empty list to export everything.
  • first_frame (int) – the first frame to export. Ignored if frame_count is 0.
  • frame_count (int) – the number of frame to export. If 0, export the current animation range.
  • samples (a list of floats) – If empty, export a single sample per frame. See the details below.
  • cyclic (bool) – If True, the samples are samples relative to each frame, else they are absolute frame samples.
  • export_parents (bool) – If True, exports also the parent nodes of the selected nodes.
  • progress (function progress(float ratio, str msg) -> bool) – an optional progression function. Same prototype than the rumbapy.Progress.update method.
  • get_name – an optional callback to override the nodes name in the alembic archive.

The default implementation returns the node’s name. One can use this callback to add a prefix. The callback receives the node object and must return a name for this node. :type get_name: function get_name(Node node) -> str

If samples is not empty and cyclic is True, the samples are the sub-sample to export, relative to each frame. Those values should be between [-1.0, 1.0]. In that case, frame_count*len(samples) samples will be exported. For example, with first_frame=1, frame_count=3 and samples=[0.0, 0.4], this will export those samples : [1.0, 1.4, 2.0, 2.4, 3.0, 3.4].

If cyclic is False, the samples values are the absolute frame samples to export. This last mode can be used to export non-uniform sub-frame sampling. In that case, first_frame and frame_count are ignored.