User Guide: Edit

Symmetry Find Off/On: If parts of your mesh have mirrored topology, you can use the Symmetry tool to speed up cut'n'weld operations. Click on the Find button, then LMB click on any edge that sits on the mirror line (i.e. the line that divides the two symmetrical halves), then tap the space bar to continue; if all goes well, the left half of the mesh will be shaded darker than the right, indicating that symmetry editing is now active; the slider that appears can be used to adjust the level of darkening. Yellow shading is applied to non-symmetrical polys.

Cut, weld, detach, attach, drop and undrop actions from then on will be mirrored across to the other half. When packing, symmetrical shells will be arranged to the left and right sides of tiles and boxes. Click on the Off button if you want to turn the mirroring off for all of the mesh. If you want to remove the symmetry tagging from just some of the mesh, use the H key menu to hide the polys you don't want to change, then click the x button next to the slider; this will delete the symmetry tagging from all visible polys.

If parts of your mesh are symmetrical but detached (e.g. a pair of shoes), first LMB click on any edge in one shell, then MMB click on the mirrored edge in the other shell, then tap the space bar to continue.

[Professional Version Only]

Copy UVs Stack/U/V: To copy UVs between parts of your mesh, first click the Copy UVs button, then LMB select an edge in the source shell (i.e. the shell you want to copy UVs from); you can select this edge in either the UV or 3D views. This "source" edge will be highlighted in red.

Next LMB select edges, in the same relative position, for the target shells; by selecting multiple edges, you can copy to more than one shell at a time. If you accidentally select the wrong edge, LMB click on it again to unselect it. All "target" edges are highlighted in blue.

To quickly select edges on all matching shells, tap the = hotkey. Use the - hotkey to select edges on similar shells, that is, those with the same topology but not exactly the same size or shape, or use the + hotkey to select edges on all matching topology objects, regardless of size. When using the quick select mode, unaffected shells are temporarily hidden so you can easily see those that have been matched. At this point you can change the selected edges if you like, or use the H hotkey menu to hide matched shells that you don't want to copy to. Note: The quick select mode only works when in the 3D view, and on separated objects.

Tap the space bar when you have selected all the edges, and the UVs will be copied across if the selected shells match. To match, shells must have the same topology (i.e. the same number and arrangement of polygons).

Before copying, select Stack if the you want the target shells stacked on top of the source shell, or U or V if you want them arranged alongside. Stacked shells are locked and boxed, but they can be unlocked with the L hotkey menu after copying.

Get Picked / Offset: For U or V arranged copies, you have the option here to set a fixed offset value. For example, if you make this 1, then copied shells will be placed in the same location in adjacent tiles. You can also select one or more shells in the UV view, then click the Get Picked button, and the size of the bounding box of those shells will be copied into the offset field. Leave the offset on 0.0 and UVLayout will calculate the offset automatically so shells are arranged with a small gap between them.

Prioritize Mirror: Toggle this on if you want to check for mirroring first when copying UVs. See the example mesh to the right; the two selected blobs are stretched spheres, so if copying the UVs from the left to the right, by default the UVs will end up exactly the same on the right blob. In this case though its more appropriate that the UVs are mirrored, and turning on this option will do that.

Untag Edges 0/1/10/D: Select the look-ahead range for cut'n'weld tagging of edge loops. Click on the Untag Edges button to untag all red or yellow highlighted edges.

The D option turns on cutting drag mode, where you tag the first edge, then keep the C hotkey held down while you use the mouse pointer to draw out the edge loop selection. Whenever the selection reaches a fork, that edge turns blue, and the current position of the mouse pointer will determine in which direction the edge loop selection continues. Release the C hotkey when you are happy with the edge loop selection.

Auto Fit/Off: When Auto Fit is on, all current UVs are re-normalized (scaled to fit in the 0 to 1 range) every time a UV shell is moved or modified. When Off, they aren't, so you can move shells beyond this range and out onto other tiles. Use the + and _ keys to scale the UV unit box up and down.

Live: When Live editing is turned on, each shell's flattening is automatically optimized as cuts and welds are made. With a slow system or particularly complex shell, this may slow down your editing workflow, but you can abort the flattening calculation by aiming the mouse pointer at empty space and then tap either the C or W hotkeys.

Saw Pole: Used to create saw-tooth style UVs at the poles (end caps) of spheres and similar topology objects. The main body of the object must already have UVs, so you could use the R hotkey to create them if they don't exist already. Select the end-caps you want new UVs for, next use the W hotkey to tag all the edges where you want to create the "teeth", then finally click the Saw Pole button. The uv value can be set to a specific offset, or leave it at the default of 0.0 if you want the offset to equal the depth of the first row of adjacent polys on the main body.

4/5/6 Local Scale / Pin: When Local Scale is selected, the 4/5 hotkeys paint a local scaling into the polys under the brush; this has the effect of moving the UVs in that area in or out during any further flattening, while preserving the shape of the polys as much as possible.

When Pin is selected, the 4/5 hotkeys simply move the UVs in or out directly, disregarding any shape constraints and most likely reducing the quality of the UVs in that area. The UVs are pinned so that any subsequent flattening of that shell doesn't affect the new UV positions. Also when in this Pin mode, the 6 hotkey can be used to smooth UVs.

Smooth Boundary: When smoothing with the 6 hotkey, this option selects whether shell boundaries are modified.

No MMB: Normally to move UV points around, you hold down Ctrl or Shift and click'n'drag the MMB. If you are doing lots of manual tweaking of UVs, the MMB click'n'drag can be a strain on your mouse hand, so you have the option in that situation to go into No MMB mode; tick this option, and you can move UVs simply with the Ctrl or Shift keys. If you have Hold selected, you have to hold down the Ctrl or Shift keys while moving the UVs. Select Tap, and you tap the keys to start moving the UV points, and tap again to release the points.

Shift-B: This sets how much a shell is scaled up by when using the Shift-B hotkey.

Strength: Sets the strength of the flattening optimization. Normally this would be at 1 for maximum speed. If the strength is reduced, then the flattening optimization is more delicate, which may be desired in certain situations. Also when the strength is reduced, the F hotkey optimization stops after one step so the results can be assessed before proceeding.

R Key: This sets what action the R hotkey performs; Rect for the newer "Rectangles and Pipes" tool, or Relax for the old UV relaxing tool, which was long ago replaced with the 4/5 hotkeys.

Ctrl I/K: Sets the angle threshold for the tagging of similarly oriented edges. Reduce this angle to select fewer edges.

G Key: When using the G hotkey to paint select polys, this option determines whether only polys Facing the camera are selected, or if the selection goes all the way Thru the mesh (i.e. also selecting polys on the other side, facing away from the camera). Select Old for the older style painting method (i.e. only a single poly under the pointer is selected).

S Key: When Symmetry Editing is turned on, the S hotkey is used to copy UVs from one shell to its mirrored half. This option sets where the mirrored shell is placed:

Slf : for "self", the mirrored shell is flipped over and place right underneath the first shell. If Box and Lock is ticked, then both shells with be boxed and locked, keeping them together if shells are later packed. This option is only available in the Professional version of UVLayout.

Adj : for "adjacent", the mirrored shell is placed next to the first shell.

Opp : for "opposite", the mirrored shell is placed on the opposite side of the current tile.

Nxt : for "next", the mirrored shell is placed on the opposite side of the next tile.

M / Shift-M: Normally the M hotkey is used to magnetically snap shells together before they are welded. Originally M was used to snap the shell under the cursor away to the location of the adjacent shell, where Shift-M would move the adjacent shells so they fall alongside the shell under the cursor. This option swaps the action of the M and Shift-M hotkeys.

If no edges are tagged for welding, the M hotkey will also snap shells together if the mouse pointer is placed over a boundary edge. In this mode, if the Pack tool bleed is turn on, then a gap of that size is left between the shells.

Junk: Sets the UV tile location for shells thrown into the 'Recycle Bin' with the J hotkey.

Function Keys: The F1 to F6 function keys can be mapped to buttons in the GUI. Click on one of the Fn buttons in the GUI, then click on the button in the GUI you want it mapped to. You can then use that function key on the keyboard to perform the mapped action. Buttons that have been previously mapped are colored blue; unmapped buttons are grey. To remove a mapping, double click that Fn button. To show a reminder of what a mapped button does, hover the mouse pointer over it.

Retrieved from "http://doc.uvlayout.com/User_Guide:_Edit"

 ; Symmetry Find Off/On  : If parts of your mesh have mirrored topology, you can use the Symmetry tool to speed up cut'n'weld operations. Click on the '''Find''' button, then LMB click on any edge that sits on the mirror line (i.e. the line that divides the two symmetrical halves), then tap the space bar to continue; if all goes well, the left half of the mesh will be shaded darker than the right, indicating that symmetry editing is now active; the slider that appears can be used to adjust the level of darkening. Yellow shading is applied to non-symmetrical polys.
-: Cut, weld, detach, attached, drop and undrop actions from then on will be mirrored across to the other half. When packing, symmetrical shells will be arranged to the left and right sides of tiles and boxes. Click on the '''Off''' button if you want to turn the mirroring off.
+: Cut, weld, detach, attach, drop and undrop actions from then on will be mirrored across to the other half. When packing, symmetrical shells will be arranged to the left and right sides of tiles and boxes. Click on the '''Off''' button if you want to turn the mirroring off for all of the mesh. If you want to remove the symmetry tagging from just ''some'' of the mesh, use the '''H''' key menu to hide the polys you don't want to change, then click the '''x''' button next to the slider; this will delete the symmetry tagging from all visible polys.
 : If parts of your mesh are symmetrical but detached (e.g. a pair of shoes), first LMB click on any edge in one shell, then MMB click on the mirrored edge in the other shell, then tap the space bar to continue.
 : To quickly select edges on all matching shells, tap the '''=''' hotkey. Use the '''-''' hotkey to select edges on ''similar'' shells, that is, those with the same topology but not exactly the same size or shape, or use the '''+''' hotkey to select edges on ''all'' matching topology objects, regardless of size. When using the quick select mode, unaffected shells are temporarily hidden so you can easily see those that have been matched. At this point you can change the selected edges if you like, or use the '''H''' hotkey menu to hide matched shells that you don't want to copy to. '''Note:''' ''The quick select mode only works when in the 3D view, and on separated objects.''
+[[Image:UserGuide-Copy-Mirror.png|right|]]
 : Tap the space bar when you have selected all the edges, and the UVs will be copied across if the selected shells match. To match, shells must have the same topology (i.e. the same number and arrangement of polygons).
 ; Get Picked / Offset : For U or V arranged copies, you have the option here to set a fixed offset value. For example, if you make this '''1''', then copied shells will be placed in the same location in adjacent tiles. You can also select one or more shells in the UV view, then click the '''Get Picked''' button, and the size of the bounding box of those shells will be copied into the offset field. Leave the offset on '''0.0''' and UVLayout will calculate the offset automatically so shells are arranged with a small gap between them.
+; Prioritize Mirror : Toggle this on if you want to check for mirroring first when copying UVs. See the example mesh to the right; the two selected blobs are stretched spheres, so if copying the UVs from the left to the right, by default the UVs will end up exactly the same on the right blob. In this case though its more appropriate that the UVs are mirrored, and turning on this option will do that.
 </div>
 ; Live : When '''Live''' editing is turned on, each shell's flattening is automatically optimized as cuts and welds are made. With a slow system or particularly complex shell, this may slow down your editing workflow, but you can abort the flattening calculation by aiming the mouse pointer at empty space and then tap either the '''C''' or '''W''' hotkeys.
+----
+; Saw Pole : [[Image:UserGuide-Saw-Pole.png|right|]] Used to create saw-tooth style UVs at the poles (end caps) of spheres and similar topology objects. The main body of the object must already have UVs, so you could use the '''R''' hotkey to create them if they don't exist already. Select the end-caps you want new UVs for, next use the '''W''' hotkey to tag all the edges where you want to create the "teeth", then finally click the '''Saw Pole''' button. The '''uv''' value can be set to a specific offset, or leave it at the default of '''0.0''' if you want the offset to equal the depth of the first row of adjacent polys on the main body.
 ----
 ; 4/5/6 Local Scale / Pin : When '''Local Scale''' is selected, the 4/5 hotkeys paint a local scaling into the polys under the brush; this has the effect of moving the UVs in that area in or out during any further flattening, while preserving the shape of the polys as much as possible.
-: When '''Pin''' is selected, the 4/5 hotkeys simply move the UVs in or out directly, disregarding any shape constraints and most likely reducing the quality of the UVs in that area. The UVs are pinned so that any subsequent flattening of that shell doesn't affect the new UV positions. Also when in this '''Pin''' mode, the 6 hotkey can be used to smooth UVs.
+: When '''Pin''' is selected, the '''4/5''' hotkeys simply move the UVs in or out directly, disregarding any shape constraints and most likely reducing the quality of the UVs in that area. The UVs are pinned so that any subsequent flattening of that shell doesn't affect the new UV positions. Also when in this '''Pin''' mode, the '''6''' hotkey can be used to smooth UVs.
 ; Smooth Boundary : When smoothing with the 6 hotkey, this option selects whether shell boundaries are modified.
 ; Shift-B : This sets how much a shell is scaled up by when using the '''Shift-B''' hotkey.
-; Strength : Sets the strength of the flattening optimization. Normally you want to leave this at '''1''' for maximum strength/speed, but some people like to slow things down by reducing the strength, and then they can see whats happening and have the opportunity to abort the optimization before it goes too far.
+; Strength : Sets the strength of the flattening optimization. Normally this would be at '''1''' for maximum speed. If the strength is reduced, then the flattening optimization is more delicate, which may be desired in certain situations. Also when the strength is reduced, the '''F''' hotkey optimization stops after one step so the results can be assessed before proceeding.
 ; R Key : This sets what action the '''R''' hotkey performs; '''Rect''' for the newer "Rectangles and Pipes" tool, or '''Relax''' for the old UV relaxing tool, which was long ago replaced with the '''4/5''' hotkeys.
 :: '''Nxt''' : for "next", the mirrored shell is placed on the opposite side of the next tile.
-; M / Shift-M : Choose between original, or swap the action of the '''M''' and '''Shift-M''' hotkeys.
+; M / Shift-M : Normally the '''M''' hotkey is used to ''magnetically'' snap shells together before they are welded. Originally '''M''' was used to snap the shell under the cursor away to the location of the adjacent shell, where '''Shift-M''' would move the adjacent shells so they fall alongside the shell under the cursor. This option swaps the action of the '''M''' and '''Shift-M''' hotkeys.
+: If no edges are tagged for welding, the '''M''' hotkey will also snap shells together if the mouse pointer is placed over a boundary edge. In this mode, if the '''Pack''' tool bleed is turn on, then a gap of that size is left between the shells.
+; Junk : Sets the UV tile location for shells thrown into the 'Recycle Bin' with the '''J''' hotkey.
 ----
 ; Function Keys : The '''F1''' to '''F6''' function keys can be mapped to buttons in the GUI. Click on one of the '''Fn''' buttons in the GUI, then click on the button in the GUI you want it mapped to. You can then use that function key on the keyboard to perform the mapped action. Buttons that have been previously mapped are colored blue; unmapped buttons are grey. To remove a mapping, double click that '''Fn''' button. To show a reminder of what a mapped button does, hover the mouse pointer over it.