XangleCs documentation

These instructions are especially useful when working with 3d body photogrammetry scans captured using our 200-camera rig at Xangle Studio. The files we provide are delivered in RAW format, ensuring maximum image quality and flexibility for post-processing. Before using them in RealityCapture, you'll need to convert the RAW files to high-quality JPGs using Lightroom, Capture One, or a similar editing software. Once converted, you can follow the steps below to generate clean, scaled OBJ files ready for use in CLO3D or Marvelous Designer.

1. Import Your Photos into RealityCapture

• Open RealityCapture.
• Click “Add Images” or drag your photo set into the window.
• Wait for the images to load into the project.

2. Align the Images

• Click “Align Images” from the Workflow tab.
• RealityCapture will generate a sparse point cloud and estimate camera positions.

✅ Make sure all or most of your images align. Good photo overlap and lighting consistency help.

3. Build the 3D Model (Mesh Reconstruction)

• Go to the Reconstruction section and choose “Normal Detail” or “High Detail”.
• RealityCapture will generate a dense mesh from your image data.

4. Clean the Mesh (Remove Unwanted Geometry)

• Use the Selection Tool (lasso, box, or paint selection) in the 3D view.
• Delete any geometry you don’t need, such as the floor, background, or noise artifacts.
• Keep only the relevant scanned subject (e.g., human body, mannequin, torso).

5. Simplify the Mesh

• Go to Mesh > Simplify Tool.
• Set a target polygon count, such as 50,000 to 150,000 triangles.
• This ensures your mesh is manageable inside CLO3D/Marvelous without slowing things down.

6. Optional: Texture the Model

• If you want your mesh to have a texture (useful as a visual reference), go to:
  • Texture > Texture, set your desired resolution (e.g., 4096x4096), and click Texture.
• Skip this step if you're only using the model as a base avatar or reference and don’t need surface color.

7. Define Real-World Scale

• CLO3D uses centimeters as its base unit, so your scan needs to be correctly scaled.
• Go to Workflow > Define Ground Plane and Scale:
  • Set known distances (e.g., shoulder width = 40 cm).
  • Click “Set Scale and Transformation” to apply.

⚠️ If you skip this, the model will appear incorrectly scaled in CLO3D (e.g., 5 meters tall).

8. Export as OBJ

• Go to File > Export > Mesh.
• Choose .OBJ as the format.
• In the export settings:
  • Use Z-up (RealityCapture default is usually fine for CLO3D).
  • Confirm your mesh is scaled in centimeters.
  • Export texture and material files if you generated them.

✨ (Optional) Cleanup in Blender (Recommended Before Importing into CLO3D)

If you want to further refine or clean up the OBJ mesh, here’s how to do it in Blender:

✅ A. Import the OBJ

• Open Blender.
• Go to File > Import > Wavefront (.obj) and select your exported file from RealityCapture.

✅ B. Basic Cleanup

• Go into Edit Mode (Tab key).
• Use tools like:
  • “Select > Select All by Trait > Loose Geometry” → Delete.
  • Mesh > Clean Up > Decimate Geometry → For reducing unnecessary vertices.
  • Knife, smooth, or sculpt tools if refining surface topology or silhouette.

You can also:

• Fix surface intersections or holes using the Sculpt Tool with the Smooth Brush.
• Use Modifiers > Decimate for controlled mesh reduction.

✅ C. Set Scale & Orientation

• Make sure your object is realistically sized:
  • Use the Scale tool or Measure Tool in the right-hand toolbar (Shortcut: N) to ensure the model aligns with CLO3D proportions (e.g., ~170cm for a full-body human).
• Set origin: Object > Set Origin > Origin to Geometry.
• When ready, export as .OBJ:
  • Go to File > Export > Wavefront (.obj).
  • In export options:
    • Apply Scale: 100.00 if you're working in meters to cm.
    • Axis: Forward: -Z Forward, Up: Y Up (CLO3D default).

✅ 9. Import the OBJ into CLO3D or Marvelous

• Open CLO3D or Marvelous Designer.
• Go to File > Add > Avatar (OBJ) or Background OBJ, depending on how you want to use it.
• Use the imported mesh as a base for:
  • Accurate draping
  • Pattern fitting
  • Pose reference
  • Custom avatars or mannequins

📏 Scaling 3D Scans for CLO3D & Marvelous Designer

(Using RealityCapture and/or Blender)

When working with photogrammetry models - especially full-body scans from the Xangle Studio’s 200-camera rig - proper real-world scale is essential for accurate garment simulation in CLO3D and Marvelous Designer. Here's how to correctly scale your mesh during or after RealityCapture processing.

✅ Option A: Set Real-World Scale in RealityCapture

1. Complete your model reconstruction in RealityCapture.
2. Go to:

   Workflow > Define Ground Plane and Scale

3. In the 3D view:
   • Use the Control Points Tool to place two markers on your mesh.
   • Ideal reference distances:
     • Top of head to bottom of feet (for full height)
     • Shoulder to shoulder (for width)
4. Enter the known distance between those two points (e.g., 170 cm for height).
5. Click “Set Scale and Transformation”.

Your mesh is now correctly scaled in centimeters, ready for export to CLO3D or Marvelous.

✅ Option B: Set Scale in Blender

If you skipped scaling in RealityCapture, you can do it afterward in Blender:

1. Import the OBJ

• File > Import > Wavefront (.obj)

2. Measure and Scale

• In Object Mode, press N to open the Sidebar.
• Use the Measure Tool or eyeball approximate height using the Z-axis.
• Use the Scale Tool (S key) to resize the model until the vertical dimension matches your desired real-world height (e.g., 170 cm for an average human figure).

3. Apply Scale

• Press Ctrl+A → Select Apply Scale

4. Export

• File > Export > Wavefront (.obj)
• In export settings:
  • Set Forward: -Z Forward
  • Up: Y Up
  • Ensure units match centimeters
  • Apply scale factor if needed (e.g., 100.00 if working from meters)

✅ Importing Into CLO3D or Marvelous Designer

Once your OBJ file is scaled correctly:

• In CLO3D or Marvelous Designer, go to:

  File > Add > Avatar (OBJ)

  or

  File > Add > Background OBJ

• The mesh should appear at the correct human scale (roughly 160–190 cm tall, depending on your scan).
• You can now use it to:
  • Design clothing around real measurements
  • Simulate fit and drape accurately
  • Align pattern pieces on a realistic reference

🧵 Final Tips

• Use simple poses with arms slightly away from the body to improve garment simulation accuracy.
• If needed, measure shoulder width and chest circumference in Blender and compare with avatar presets in CLO3D.