User Guide: Load/Save

The main way to load files into UVLayout is to drag'n'drop them onto the headus UVLayout desktop icon. Files in UVLayout's own UVL format can also be double clicked to open them up. And finally, if UVLayout is already running, you can use the Load button to load a new file.

When loading OBJ or PLY files, there's a few options to choose between:

SUBD / Poly: If the mesh being loaded is the control cage for a subdivision surface, then make sure that SUBD is selected. The subdivided surface will then be used in the flattening calculations, rather than the control cage itself, producing more accurate results. If the mesh isn't a subdivision surface, then select Poly.

Edit / New: If your mesh already has UVs and you want to reflatten them to reduce distortion, select Edit. Otherwise, select New to delete any existing UVs and start with a clean slate.

Weld UVs: If the loaded mesh has seams (green edges) between adjacent polys, reload with this option ticked. It'll weld all co-incident UVs together, but could break the OBJ Update tool and point correspondences between morph targets.

Clean: If the loaded mesh has non-manifold edges (i.e. an edge is shared by more than two faces) then ticking this option will fix the problem geometry as its loaded. The clean will also remove duplicate faces. A summary of the changes made will be displayed once the file has been loaded.

Detach Flipped UVs: Tick this option if you want flipped polys in UV space to be detached into separate shells.

Weld Geom Vertexes: If there are geometry seams (blue edges) between seemingly continuous surfaces, then reload with this ticked to weld those up. Currently this triangulates the mesh also, so its recommended you only do this if you really have to.

Save

When saving your work, you have a choice between three file formats; UVL, PLY or OBJ:

UVL: UVLayout's own format that saves the current edit state, including which faces have been detached, dropped or flattened, and which edges have been 'C' tagged. You should use the UVL format if you're part way through flattening a mesh, and want to restart at a latter time.

UVL is the default format, so for example, if you type "fish" into the Path field, the ".uvl" extension gets added automatically and the scene is saved into "fish.uvl".

OBJ: Use the OBJ format to export or import UVs to and from other applications.

To save out an OBJ file, add ".obj" to the typed in filename.

PLY: PLY format files are more compact than OBJ files, but few applications know about them. They're included here mainly as a link between UVLayout and CySlice.

To save out a PLY file, add ".ply" to the typed in filename.

Update

The Update button pops up a file selection window where you can select a previously loaded OBJ file that you want to update with the current UVs. The original file isn't overwritten though; a new file called whatever-uvlayout.obj is created, which is a copy of the original file with all the material/grouping information preserved and only the UVs changed.

Note: In the current release of UVLayout, this blending of the new UVs with the loaded OBJ file is automatic, so you only ever need to use the Save button. The Update button will be hidden away, and only appears when it might be needed, such as when you've loaded a UVL file that was saved out from an earlier version of UVLayout.

File Selection GUI

UVLayout's File Selection window is divided into four main areas; the directories list, the files list, the full path, and the action buttons (see diagram to the right). In the directories area, the sub-directories in the current directory are listed, along with "..", the current directory's parent. In the files area, the files in the current directory that match the filter are listed. In the path area the full path of the current directory, and selected file, is displayed. And finally, in the buttons area are the buttons you use to preview the selected file, to load/save the selected file, or abort from the load/save operation.

To change directory:

Type the name in the File input field and hit <Enter>.
Or double click on directory name to go down one level.
Or double click on '..' (first entry in list) to go up one level.
Or click on 'Dir:' option button to go up multiple levels.
Or click the 'Dir:' button for standard directory selection (Windows only).
Or click the history arrow for previously accessed directories.
You can use '~' (tilde) for your home directory.
You can use '.' by itself to go back to the original directory.

To access the Desktop (Windows Only) and other filesystems:

Use the 'Dir:' option button to select '/'.
Or type '/' in the File input field and hit <Enter>..

To change the files listed:

Change the Filter input field and hit <Enter>. You can use '*', '?' and '[a-z]' wildcards.
Or pick one of the listed file types from the 'Type:' option list.

To select a file:

Type the name in the File input field, and hit <Enter>.
Or single click on file name in the files list, then hit the green button.
Or double click on file name in the files list.

The other buttons:

Hit Show to preview the selected file (not always available).
Or hit Dismiss to stop selecting files.

To get more information about the listed files, click on the black right arrow after the Filter input field. Click on the 'Filename', 'Size' or 'Modified' labels to sort the list by that value.

Tmp/E Buttons

The Tmp 1 to 5 buttons can be used to quickly save the current scene into temporary files, named tmp1.uvl to tmp5.uvl, that can be loaded later on if something goes wrong.

The buttons are color coded:

Red	- most recent save, can't be overwritten
Orange	- other saves
Greeny Orange	- oldest save
Green	- not yet used

The E button also saves the current scene, but into files named edit01.uvl, edit02.uvl etc, always creating the next unused filename in the sequence.

You can also enable a regular auto save using the Auto Save setting under the Preferences panel.

To include the name of the original mesh into the quick save files, tick the Full Name Quick Saves preference.

Retrieved from "http://doc.uvlayout.com/User_Guide:_Load/Save"

 ; '''Weld UVs''' : If the loaded mesh has seams (green edges) between adjacent polys, reload with this option ticked. It'll weld all co-incident UVs together, but could break the OBJ Update tool and point correspondences between morph targets.
-; '''Clean''' : If the loaded mesh has non-manifold edges (i.e. an edge is shared by more than two faces) then ticking this option will fix the problem geometry as its loaded, but may break the OBJ Update tool and point correspondences between morph targets.
+; '''Clean''' : If the loaded mesh has non-manifold edges (i.e. an edge is shared by more than two faces) then ticking this option will fix the problem geometry as its loaded. The clean will also remove duplicate faces. A summary of the changes made will be displayed once the file has been loaded.
 ; '''Detach Flipped UVs''' : Tick this option if you want flipped polys in UV space to be detached into separate shells.