Ministry OF Flat UnWrapConsole3.exe Documentation for version 3.7.2

It only takes .obj files, but most tools can import and export obj-files, so it should work for most usages.

UI Version

To change the camera, press the right mouse button. Right + Left dollys, and Right + Middle pans. Multi-touch camera controls also work (two fingers to tumble/zoom and three to pan), as well as standard Maya camera controls by pressing Alt + mouse buttons.

Click in empty space to switch between 3D and UV view.

Contact and Feedback

If you encounter any issues, please mail me, and if possible, send me the mesh you have problems with. If you can’t send the mesh, a screenshot will also do. If you are having problems, you can turn on the “validate” option in the settings. This will run a bunch of validation steps and output any errors it finds in the betray_stdout.txt file. It only gets better if I know what’s wrong with it!

UV mapping is subjective, so if you have opinions, please let me know. If you think it sucks, LET ME KNOW and tell me why.

Note: I am more focused on hand-made meshes with good topology than on scanned meshes, so that will remain my focus for now.

Follow me on Twitter at @quelsolaar. I will post when I release new versions and when issues are fixed.

If you are interested in Licensing the full version, contact license@ministryofflat.com.


Settings

Texture Resolution

  • Description: Resolution of texture, to give the right amount of island gaps to prevent bleeds.
  • Command-line usage: -RESOLUTION <VALUE>
  • Default value: 1024

Separate Hard Edges

  • Description: Guarantees that all hard edges are separated. Useful for lightmapping and normal mapping.
  • Command-line usage: -SEPARATE <TRUE/FALSE>
  • Default value: FALSE

Aspect

  • Description: Aspect ratio of pixels. For non-square textures.
  • Command-line usage: -ASPECT <VALUE>
  • Default value: 1.000000

Use Normal

  • Description: Use the model’s normals to help classify polygons.
  • Command-line usage: -NORMALS <TRUE/FALSE>
  • Default value: FALSE

UDIMs

  • Description: Split the model into multiple UDIMs.
  • Command-line usage: -UDIMS <VALUE>
  • Default value: 1

Overlap Identical Parts

  • Description: Overlap identical parts to take up the same texture space.
  • Command-line usage: -OVERLAP <TRUE/FALSE>
  • Default value: FALSE

Overlap Mirrored Parts

  • Description: Overlap mirrored parts to take up the same texture space.
  • Command-line usage: -MIRROR <TRUE/FALSE>
  • Default value: FALSE

Scale UV Space to Worldspace

  • Description: Scales the UVs to match their real-world scale, going beyond the zero-to-one range.
  • Command-line usage: -WORLDSCALE <TRUE/FALSE>
  • Default value: FALSE

Texture Density

  • Description: If worldspace is enabled, this value sets the number of pixels per unit.
  • Command-line usage: -DENSITY <VALUE>
  • Default value: 1024

Seam Direction

  • Description: Sets a point in space that seams are directed toward. By default, it’s the center of the model.
  • Command-line usage: -CENTER <X VALUE> <Y VALUE> <Z VALUE>
  • Default value: 0.000000 0.000000 0.000000

Debugging Settings

Warning:
All following settings are for debugging purposes only.
Making any change to these settings is likely to result in worse UV mapping and/or longer processing time.

Suppress Validation Errors

  • Description: Faulty geometry errors will not be printed to standard output.
  • Command-line usage: -SUPRESS <TRUE/FALSE>
  • Default value: FALSE

Quads

  • Description: Searches the model for triangle pairs that make good quads. Improves the use of patches.
  • Command-line usage: -QUAD <TRUE/FALSE>
  • Default value: TRUE

Vertex Weld

  • Description: Merges duplicate vertices. Does not affect the output polygon or vertex data.
  • Command-line usage: -WELD <TRUE/FALSE>
  • Default value: TRUE

Flat Soft Surface

  • Description: Detects flat areas of soft surfaces in order to minimize distortion.
  • Command-line usage: -FLAT <TRUE/FALSE>
  • Default value: TRUE

Cones

  • Description: Searches the model for sharp cones.
  • Command-line usage: -CONE <TRUE/FALSE>
  • Default value: TRUE

Cone Ratio

  • Description: The minimum ratio of a triangle used in a cone.
  • Command-line usage: -CONERATIO <VALUE>
  • Default value: 0.500000

Grids

  • Description: Searches the model for grids of quads.
  • Command-line usage: -GRIDS <TRUE/FALSE>
  • Default value: TRUE

Strips

  • Description: Searches the model for strips of quads.
  • Command-line usage: -STRIP <TRUE/FALSE>
  • Default value: TRUE

Tubes

  • Description: Finds tube-shaped geometry and unwraps it using cylindrical projection.
  • Command-line usage: -TUBES <TRUE/FALSE>
  • Default value: TRUE

Packing

  • Description: Packs islands into a rectangle.
  • Command-line usage: -PACKING <TRUE/FALSE>
  • Default value: TRUE

Packing Iterations

  • Description: How many times the packer will pack the islands to find the optimal spacing.
  • Command-line usage: -PACKING_ITERATIONS <VALUE>
  • Default value: 4

Validate

  • Description: Validates geometry after each stage and prints out any issues found (for debugging only).
  • Command-line usage: -VALIDATE <TRUE/FALSE>
  • Default value: FALSE