Alembic

From the Alembic home page:

Alembic is an open computer graphics interchange framework. Alembic distills complex, animated scenes into a non-procedural, application-independent set of baked geometric results. This ‘distillation’ of scenes into baked geometry is exactly analogous to the distillation of lighting and rendering scenes into rendered image data.

Alembic is focused on efficiently storing the computed results of complex procedural geometric constructions. It is very specifically not concerned with storing the complex dependency graph of procedural tools used to create the computed results. For example, Alembic will efficiently store the animated vertex positions and animated transforms that result from an arbitrarily complex animation and simulation process which could involve enveloping, corrective shapes, volume-preserving simulations, cloth and flesh simulations, and so on. Alembic will not attempt to store a representation of the network of computations (rigs, basically) which are required to produce the final, animated vertex positions and animated transforms.

In brief, Alembic can be used to write an animated mesh to a drive, and read it back quickly and efficiently. This means that a mesh can be animated with a very CPU-intensive rig and then ‘baked’ to an Alembic file. Finally it can be load into the shot file for shading and lighting with only moderate CPU usage.

Due to the Open Source nature of the Alembic standard as well as the C++ library implementing that standard, Blender can be used in a hybrid pipeline. For example, other software, such as Houdini or Maya, can export files to Alembic, which can then be loaded, shaded, and rendered in Blender. It is also possible to animate characters (or other models) in Blender, export to Alembic, and load those files into other software for further processing.

Exporting to Alembic Files

This section describes the effect of the different export options.

Manual Transform

../../_images/files_import-export_alembic_export-panel-scene-options.png

Generic and Scene Alembic Export options.

축척(Scale)

This sets the global scale of the Alembic file. Keep it at the default value of 1.0 to use Blender’s units.

Scene Options

Frame Start, End

Sets the frame range to export to Alembic. This defaults to the current scene frame range.

Sub-frame Sampling

These options control the sub-frame sampling of animations.

Samples Transform

Transform Samples sets the number of times per frame at which animated transformations are sampled and written to Alembic.

Geometry

Geometry Samples sets the same, but then for animated geometry.

Shutter Open, Close

Shutter Open/Close define the interval [open, close] over which those samples are taken. The valid range is -1 to 1, where -1 indicates the previous frame, 0 indicates the current frame, and 1 indicates the next frame.

For example, if information for detailed mesh motion blur is desired, some subframes around the current frame can be written to Alembic by using a sample count of 5, Shutter Open at -0.25 and Shutter Close at 0.25. This mimics a “180 degree” shutter, opening 90 degrees before the frame and closing 90 degrees after the frame.

Flatten Hierarchy

When disabled, parent/child relations between objects are exported too. Any parent object that is not exported itself, but with children that are exported, is replaced by an empty. When enabled, parent/child relations are not exported, and transformations are all written in world coordinates.

Use Instancing

Exports data of duplicated or instanced objects as Alembic instances; speeds up the export and can be disabled for compatibility with other software.

Custom Properties

When enabled (which it is by default), custom properties are exported to Alembic as well. The following custom property types are supported:

  • Numbers (int, float) and strings. These are exported as arrays of a single element, so 47 will be exported as [47] to Alembic, and "Agent" to ["Agent"]. This matches the behavior of many other DCCs.

  • Lists of numbers and strings. These are exported as-is, so [327, 47] is exported as [327, 47].

  • Matrices and nested arrays of numbers. These are flattened into one long list, so a 3×2 matrix of numbers will become a list of 6 numbers. Similarly, nested lists [[1, 2, 3], [4, 5], [6]] will be exported as [1, 2, 3, 4, 5, 6].

  • Numbers can be animated as well.

Only
Selected Objects

When enabled, exports only the selected objects. When disabled, all objects are exported.

Visible Objects

Limits the export to scene collections that are currently visible.

Use Settings For

Determines visibility of objects, modifier settings, and other areas where there are different settings for viewport and rendering.

Render

Use Render settings for object visibility, modifier settings, etc.

Viewport

Use Viewport settings for object visibility, modifier settings, etc.

Object Options

../../_images/files_import-export_alembic_export-panel-object-options.png

Object options.

UVs

When enabled, UV maps are exported. Although the Alembic standard only supports a single UV map, Blender exports all UV maps in a way that should be readable by other software.

Pack UV Islands

Generates an optimized UV layout with non-overlapping islands that tries to efficiently fill the Texture Space. See the Pack Islands operator that works with the same principle for more information.

Normals

When enabled, an object’s Normals are exported. See Custom Split Normals of Meshes below for more information.

Color Attributes

When enabled, exports Color Attributes.

Face Sets

Exports the material names per face. The material data is not exported but only material names.

Subdivisions
Apply

Applies any Subdivision Surface modifiers before writing to Alembic.

Use Schema

Writes polygonal meshes using the “SubD” Alembic schema, rather than the “PolyMesh” schema. This sets an import option for the program, with which the file is opened, to apply its form of a non-destructive subdivision.

Triangulate

Triangulates the mesh before writing to Alembic. For more detail on the specific option see the Triangulate modifier.

Particle Systems

../../_images/files_import-export_alembic_export-panel-particle-systems.png

Particle Systems options.

Alembic has no support for Particle Systems, in the same way that it does not support armatures. Hair is exported as animated zero-width curves. Particles are exported as animated points.

Importing Alembic Files

When importing an Alembic file, Mesh Sequence Cache modifiers are automatically added to time-varying meshes. For time-varying object transforms (so animation of rotation, location, or scale) the Transform Cache Constraint is used.

Custom Split Normals of Meshes

Blender supports the import and export of custom normals to Alembic files. As a basic rule of thumb, a completely smooth mesh will be exported without normals and thus produce the smallest Alembic file. This is reflected in the importer; an Alembic mesh without normals is loaded as a smooth mesh.

On export, for every mesh:

  • If it has Custom Loop Normals then the loop normals are exported.

  • If one or more polygons are marked flat then loop normals are also exported.

  • Otherwise, no normals are exported.

On import, when the Alembic mesh contains:

  • Loop normals (kFacevaryingScope) are used as custom loop normals, and enable Auto Smooth to have Blender actually use them.

  • Vertex normals (kVertexScope or kVaryingScope) are convert to loop normals, and handle as above.

  • If there are no normals then the mesh is marked as smooth.

  • Unsupported normal types (kConstantScope, kUniformScope, kUnknownScope) are handled as no normals.

When an imported mesh does not contain normals, the final look can be controlled by enabling the Auto Smooth checkbox and altering the threshold angle.

Handling Time

Unlike Blender and many other applications and file formats, Alembic files don’t have any concept of frames. Alembic works purely with time, and values that are sampled over time. For example, there is no way to distinguish 30 FPS with 2 samples per frame, and 60 FPS with 1 sample per frame. This has caused many developers to just hard-coded 24 FPS when reading Alembic files.

Blender uses the current scene frame rate to convert a frame number (in Blender) to a time in seconds (in Alembic). As a result, you can import an Alembic file that was produced at 120 FPS into a Blender scene that is 30 FPS and still not see any time stretching.