Import Formats

../_images/ImportTable.png

Supported Data Streams by Format

HoloEdit supports several file types for import in the clip creation. The following sections contains details on each output format.

MVE

MVE, or Multi View Environment, is a format for raw image data used for geometry reconstruction and texturing. MVE frame sequences can be used in HoloEdit for the Texture Reconstruction Stage. MVE data is imported as a special Texture Stream during Make Clip if each frame is formatted according to the MVE specification:

  • One Asset Directory per frame, each containing a subfolder called “views”. Each “views” folder contains one or more “view_[number].mve” directories, each representing capture from a single camera (real or virtual). Each .mve directory contains one image plus a meta.ini file containing necessary camera metadata.

PNG

PNG image files can be imported as Texture Streams during Make Clip

JPG

JPG image files can be imported as Texture Streams during Make Clip

OMS

OMS files can be imported as Mesh Streams during Make Clip.

Note

As of HoloEdit 2021.1, OMS files must be placed alone in a folder in order to be added to a clip.

Mp4

MP4 files can be imported as Texture Streams during Make Clip. Note: As of HoloEdit 2021.1, MP4 files must be contained in a folder with no other files adjacent

Note

As of HoloEdit 2021.1, mp4 files must be placed alone in a folder in order to be added to a clip.

OBJ

Obj mesh files can be imported as Mesh Streams during Make Clip

PLY

The Polygon File Format, or “PLY format” is a versatile binary mesh format popular in research applications. PLY files contain arbitrary attributes, called properties, for data such as position, color, texture coordinates, and any additional data specified by the software that produced the .ply file.

Because of the versatility of the PLY format, it’s not possible to guarantee every individual of .ply file will be imported correctly. HoloEdit supports a common format for most mesh data, and three common formats for texture coordinates. This covers .ply files exported from most standard DCC software and several common capture stages.

HoloEdit supports ascii and binary PLY files that are formatted as follows:

Data Type

Supported Vertex Property

Supported Face Property

Vertex Position

float x, y, and z

N/A

Vertex Normals

float nx, ny, and nz

N/A

Texture Coordinates

float u,v or float s,t

list uint8 float texcoord

Vertex Colors

uchar red, green, and blue

N/A

Vertex Indices

N/A

list uchar int vertex_indices

PLY mesh files can be imported as Mesh Streams during Make Clip. Vertex Color data present in PLY files will be included in the Mesh Stream

FBX (Mesh)

FBX mesh files can be imported as Mesh Streams during Make Clip

FBX (Skeleton)

FBX files containing skeletons can be imported as Animation Streams during Make Clip. To import an fbx skeleton, take care to ensure that the skeleton matches the hierarchy and names provided in the Animation and Workflow HoloEdit exports.

FBX files for skeleton import must follow the Sequence naming scheme to import animations: filename-\[startframe\]-\[endframe\].fbx. For example, “myfbx-0000-0009.fbx” will import the first ten frames of an FBX, and create a clip from frames 0-9. Each number must be four digits long, ie 0009, 0020, 0999, etc. Files without this exact naming scheme may not import correctly.

Important

Adjusting the frame numbers in the .fbx filename will change the number of frames imported and the start frame of the clip in HoloEdit, but not which frames are sampled from the .fbx. The .fbx will always be sampled starting from frame 0, and going until the length of your frame range.

Warning

FBX animation files are imported by HoloEdit at 30fps, so take care that your animation is exported at that framerate. Otherwise, you may see animation issues or desync.

ABC

Alembic mesh sequences can be imported as Mesh Streams during Make Clip. To properly import an Alembic sequence, it should be the only mesh data in a folder. When an Alembic file is imported, HoloEdit samples its frames at 30fps to produce the clip.