Skip to main content

RealityCapture

How to export your data from RealityCapture

Updated this week

Preparation: Add a custom camera position exporter to RealityCapture. Open the following file with a text editor, such as Notepad:

C:\Program Files\Capturing Reality\RealityCapture\calibration.xml

We recommend making a backup of the file before changing it. Scroll down to the end of the file, and insert

<format id="{D33CD455-3AE5-420E-B67D-B76A8B323290}" mask="*.csv" descID="9001"

desc="AIM CSV" writer="cvs" requires="component">

<body EulerFormat="zyx">cameraIndex,index,width,height,scale,imagePath,imageName,imageE xt,originalFile,x,y,z,xInpCS,yInpCS,zInpCS,tx,ty,tz,lat,lon,alt,yaw,pitch,roll,invYaw,invPitch,i nvRoll,omega,phi,kappa,f,px,py,k1,k2,k3,k4,t1,t2,aspect,R00,R01,R02,R10,R11,R12,R20, R21,R22,euclidx,euclidy,euclidz

$ExportCameras($(cameraIndex),$(index),$(width),$(height),

$(scale),"$(imagePath)","$(imageName)","$(imageExt)","$(originalFile)",$(x),$(y),$(z),

$(xInpCS),$(yInpCS),$(zInpCS),$(tx),$(ty),$(tz),$(lat),$(lon),$(alt),$(yaw),$(pitch),$(roll),

$(invYaw),$(invPitch),$(invRoll),$(omega),$(phi),$(kappa),$(f),$(px),$(py),$(k1),$(k2),

$(k3),$(k4),$(t1),$(t2),$(aspect),$(R00),$(R01),$(R02),$(R10),$(R11),$(R12),$(R20),

$(R21),$(R22),$(euclidx),$(euclidy),$(euclidz)

)</body>

</format>

just before </Calibration>.

(Note that writer="cvs" in the snippet is not a typo for "csv", see RealityCapture documentation.

The syntax of RealityCapture's calibration.xml files is unfortunately not documented, and it does not seem to contain a proper CSV exporter. Thus your image file names must not contain double-quotes, as they will not be properly CSV-escaped.)

The result should look similar to this


(but use the link provided above for the text, do not type down the contents of the screenshot):

Provide AIM with an export folder containing the following:

  1. A textured OBJ

    1. Ensure your mesh has approximately 1M triangles. More can be too much for smartphone browsers.

    2. Ensure you have created textures using the correct settings:

In the Mesh Model tab, in section Mesh Color & Texture, choose Settings

and set:

  • Maximal texture resolution: 4096 x 4096

  • Maximal texture count: 10

(higher counts are acceptable but will result in longer loading times)

  1. In the Mesh Model tab, in section Export, choose Dense Mesh Model

Export the file as "model.obj" into a folder "mesh".

  1. The camera positions and

In the Alignment tab, in section Export, choose Registration.

Save the file as "realitycapture-cameras.csv" with AIM CSV format (this format is only present afteryou followed the "Preparation" step above and restarted RealityCapture).

  1. The image

    1. Save them into an "images" folder (flat, no subfolders).


​Step 1a: Creating a textured mesh


​Step 1b: Exporting the mesh


​Step 1b: Exporting the camera positions

When you are done, the export folder should look as follows:

name-of-your-export-folder realitycapture-cameras.csv mesh

model.obj model.mtl

model_u1_v1_diffuse.jpeg β¬… the texture files

model_u1_v2_diffuse.jpeg

...

model_u3_v3_diffuse.jpeg images

photo1.jpg photo2.jpg

...

Did this answer your question?