User Guide: Hotkeys

From UVLayout Docs

(Difference between revisions)
Jump to: navigation, search
Revision as of 05:25, 1 December 2006 (edit)
Headus (Talk | contribs)
m
← Previous diff
Current revision (02:17, 18 October 2024) (edit) (undo)
Headus (Talk | contribs)
(UV View)
 
(153 intermediate revisions not shown.)
Line 1: Line 1:
-{{:User Guide: Menu}} {{TOC}} This is the full list of hotkeys that can be used in UVLayout's graphics window.+{{:User Guide: Menu}} [[Image:UserGuide-Hotkeys.png|right|]] Open up the '''Hotkeys''' panel to access some button alternatives for the main keyboard hotkeys.
 +You can use these initially if you are unfamiliar with the keyboard hotkeys, or if you simply prefer to use the mouse for everything. Not every action is covered by these hotkey buttons though, so as you become more familiar with UVLayout, you will want to study the full list of keyboard hotkeys below.
-== Common Controls ==+The top row of buttons are simple clicks to set the view to UV, Ed or 3D space, adjust the brush size, or Undo (shown as Z, but is really Ctrl-Z).
 +The remaining buttons are toggled on and off. When enabled, you can then use the right mouse button to apply the selected key at the mouse pointer location. If an action calls for the double-tap of a hotkey (e.g. select edge loop with Double-C) then double-click the right mouse button to do the same thing.
-== UV View ==+Disable the button to turn off the mouse hotkey action, and then the right mouse button can again be used to zoom the view. To zoom the view while a hotkey button is enabled, use the mouse wheel, or click and drag the left and middle mouse buttons.
-<pre>+
-U/1 : toggle/set UV edit view+
-Pad5,Home : focus on shell+To manipulate shells or UV vertexes, you can either manually select the appropriate combination of '''Space''', '''Ctrl''' and '''Shift''' buttons, or use the buttons under the '''Hints''' section to set them up for you.
 +To temporarily disable the selected mouse hotkey actions, stow the '''Hotkeys''' panel. Open it back up and the previously selected mouse hotkey actions will be re-instated.
 +
 +----
 +
 +{{TOC}} Below is the full list of hotkeys that can be used in UVLayout's graphics window. Its split into four different sections, the first being hotkeys common to all viewing modes, followed by the hotkeys specific to each of the '''UV''', '''Ed''' and '''3D''' viewing modes.
 +
 +First off, here's some short-hands used in the lists below:
 +
 +<ul>
 +<table cellspacing=5">
 +<tr> <td> '''LMB''' <td> - Click the left mouse button. </tr>
 +<tr> <td> '''MMB''' <td> - Click the middle/wheel mouse button. </tr>
 +<tr> <td> '''RMB''' <td> - Click the right mouse button. </tr>
 +<tr> <td valign=top> '''Ctrl''' <td> - Hold down the '''Ctrl''' key while typing the listed key. The '''Command''' key can also be used under Mac OS X.</tr>
 +<tr> <td> '''Shift''' <td> - Hold down the '''Shift''' key while typing the listed key. </tr>
 +<tr> <td> '''Space''' <td> - Hold down the '''Space''' key while typing the listed key. </tr>
 +<tr> <td> '''Double''' <td> - Double tap the listed key. </tr>
 +<tr> <td valign=top> '''***''' <td> - Indicates a hotkey that will switch to rectangle selection, to apply the action to multiple shells, if the mouse pointer isn't currently over a shell.</tr>
 +</table>
 +</ul>
 +
 +'''Note:''' The hotkeys are case-sensitive. This means that if you accidentally turn Caps Lock on, then most functions will not work correctly. Because of this, a warning message will appear in the 3D window whenever you have Caps Lock on.
 +
 +== Common Keys ==
 +
 +<pre>
 +LMB : rotate view
 +Arrow Keys : rotate by 30 degrees
MMB : pan MMB : pan
RMB : zoom RMB : zoom
LMB+MMB : zoom LMB+MMB : zoom
 +Wheel Roll : zoom
-L : toggle shell lock+Ctrl-Z : undo
-F : flatten shell+C : tag cut edges
-Space-F : start continuous flatten+ : hold C and move mouse to extend selection
-Space : stop continuous flatten+Shift-C : tag an entire edge loop
-Shift-F : bloat then reflatten+Double-C : as above, but stop at branches
-B : flatten brush+W : tag weld edges
-R : relax brush+Shift-W : tag/untag an entire seam
-Shift-R : very relax brush+Double-W : same as Shift-W
-X : totally relax brush+
-O : old flatten brush+
-P : toggle pin+Backspace : untag cut/weld edges
-Double-P : pin between+
-Shift-P : pin box menu+
-Shift-D : move shell back to 3D space+
-C/W : cut/weld seam+O : toggle ortho/perspective projection
-Shift-W : toggle weld edges+ 
-Backspace : unselect weld edges+Pad5/Home/. : mouse pointer over geometry - focus view onto polys under pointer
-M/Shift-M : magnet snap weld edges+ : pointer over empty space - focus view onto picked shells
-Enter : attach/detach shells+ : no picked shells - focus view onto all visible geometry
 +Double-Home : reset view
 + 
 +End/, : mouse pointer over geometry - focus view onto UV shell under pointer
 + : pointer over empty space - focus view onto UV tile under pointer
G : mark paint polys G : mark paint polys
-Double-G : mark fill polys+Double-G : mark fill polys (Ctrl-G also)
Shift-G : unmark paint Shift-G : unmark paint
-Double-Shift-G : unmark fill+Double-Shift-G : unmark fill (Ctrl-Shift-G also)
 + 
 +H : hide polys menu
 + 
 +> : auto save to UVL file
 + 
 +/ : Maximize/minimize pane
 +</pre>
 + 
 +=== G Menu ===
 + 
 +Whenever you type the G key, a menu of extra options appears towards the bottom of the graphics window.
 + 
 +<pre>
 +LMB : Click'n'drag the LMB to stretch a box over polys you want to mark.
 +RMB : Click'n'drag the RMB to stretch a box over polys you want to unmark.
 +F : Mark polys facing the camera within a 100 degree arc
 +Shift-F : Mark polys facing the camera within a 180 degree arc
 +H : Hide all marked polys.
 +P : Pin the vertexes of all marked polys.
 +Shift-P : Unpin the vertexes of all marked polys.
 +S : Unmark marked polys, and visa versa.
 +U : Unmark all marked polys.
 +-/= : Shrink and grow marked region.
 +Home : Focus view on marked polys.
 +Enter : Make the G menu go away.
 +</pre>
 + 
 +=== H Menu ===
 + 
 +Whenever you type the H key, a menu of extra options appears towards the bottom of the graphics window.
 + 
 +<pre>
 +LMB : Click'n'drag the LMB to stretch a box over polys you want to hide.
 +RMB : Click'n'drag the RMB to stretch a box; all polys outside are hidden.
 +1 : Hide all flattened polys.
 +G : Hide all marked polys.
 +H : Hide other shells.
 +P : Hide all unpicked shells.
 +S : Hide all visible polys, and unhide all hidden polys.
 +U : Make all polys visible.
 +Enter : Make the H menu go away.
 +</pre>
 + 
 +== UV View ==
 +<pre>
 + 
 +U/1 : toggle/set UV edit view
 + 
 +Enter : attach/detach/split shells
 +Shift-D : undrop shell back to Ed space ***
 +D : then use LMB to set the drop location, use RMB to unset
 + 
 +F : hold down to flatten/optimize shell ***
 +Space-F : start continuous optimize
 +Space : stop continuous optimize
 +Shift-F : bloat then optimize ***
 +Shift-B : scale up then optimize
 + 
 +B : hold down for optimize brush
 +-/= : change brush size
 + 
 +M : if weld edges tagged, magnet snaps a shell to its adjacent shell
 + : if no edges tagged, will snap based on the edge under the pointer
 +Shift-M : same as M, but moves the adjacent shell instead
 + : You can swap the action of M and Shift-M in the Edit tool
 +Shift-M : if no shell under pointer, moves all picked shells to the pointer location
 +
 +L : toggle shell lock ***
T : tag webbing edges T : tag webbing edges
Shift-T : toggle webbing edges Shift-T : toggle webbing edges
 +Double-T : same as Shift-T
Backspace : unselect webbing edges Backspace : unselect webbing edges
-S : toggle stack marker/anchor+P : toggle pin
-Double-S : straighten between stack markers+Double-P : pin between two already pinned boundary points
-Shift-S : as above+Shift-P : as above if pointer over a boundary point,
 + : pins all boundary points if pointer over shell,
 + : otherwise shows pin box menu
 +Ctrl-P : unpin all points in shell
-L/R Arrow : flip shell in U+L/R Arrow : flip shell in U. Flipped shells are drawn with red wires.
U/D Arrow : flip shell in V U/D Arrow : flip shell in V
 +Shift-Arrow : flip all shells with same flip state as shell under pointer
 +Ctrl-Shift-Arr : select all shells with same flip state as shell under pointer
 +
 +LMB : click to pick/unpick single shell
 + : click'n'drag to pick multiple shells
 + : click in empty space to unpick all shells
 + : see About UVLayout -> Preferences -> Edit Settings -> LMB Pick for more info
 +
 +Backquote : (above Tab) Toggles tile selection mode
 +
 +Space-LMB : rotate picked shells or marked polys
 +Space-MMB : move picked shells or marked polys
 +Space-RMB : scale picked shells or marked polys
 +Space-LMB+MMB : as above
 +Tab : hold down for finer control
 +Alt : hold down to xform a single shell when multiple shells picked
Ctrl-MMB : move single point Ctrl-MMB : move single point
Ctrl-Shift-MMB : move connected points Ctrl-Shift-MMB : move connected points
Shift-MMB : move points in circle Shift-MMB : move points in circle
--/= : change circle size 
-_/+ : change UV box size 
-Space-LMB : rotate shell+_/+ : change UV box size (i.e. Shift -/=)
-Space-MMB : move shell+ : if a single point is pinned, the resize is centered about that point
-Space-RMB : scale shell+L/R Arrow : aim pointer at empty space to move UV box in U direction
-Space-LMB+MMB : scale shell+U/D Arrow : aim pointer at empty space to move UV box in V direction
Tab : hold down for finer control Tab : hold down for finer control
 +
 +A : toggle horizontal/vertical snap anchor
 +Shift-A : turn off all anchors in shell
 +
 +Ctrl-L/R Arrow : aim pointer at edge to rotate shell so edge is horizontal
 +Ctrl-U/D Arrow : aim pointer at edge to rotate shell so edge is vertical
 +
 +I : tag straight edge - axis aligned
 +Shift-I : tag an entire edge loop
 +Backspace : untag edge
 +Ctrl-I : on tagged edge - remove all 'I' tagged edges from shell
 + on untagged edge - 'I' tag all similarly oriented edges
 +
 +K : tag straight edge - unaligned
 +K : toggle kink point
 +Shift-K : tag an entire edge loop
 +Backspace : untag edge
 +Ctrl-K : on tagged edge - remove all 'K' tagged edges and points from shell
 + on untagged edge - 'K' tag all similarly oriented edges
 +
 +R : if topology allows, snap quads to an axis aligned grid.
 + otherwise, snaps boundary to an axis aligned rectangle ***
 +Shift-R : as above, but the internal UVs are also aligned ***
 +
 +J : move shell to the "Junk" tile ***
 +Shift-J : randomize shell's UVs
 +
 +When mouse pointer is aimed at shell boundary points:
 +
 + S : toggle stack marker
 + Double-S : straighten between two stack markers
 + Shift-S : as above
 +
 +When mouse pointer is aimed at shell interior polys:
 +
 + S : copy UVs from light to dark mirror polys ***
 + Shift-S : swap light and dark mirror polys
 +
 +When Brush Local Scale selected:
 +
 + 4 : scale polys up
 + 5 : scale polys down
 + 4+5 : reset local scaling
 +
 +When Brush Pin selected:
 +
 + 4 : push UVs out and pin
 + 5 : pull UVs in and pin
 + 6 : smooth UVs and pin
 + 4+5 : unpin
 +
 +Pack tool hotkeys:
 +
 + [ or ] : pack shells in box, or if no box is picked, packs all shells
 + * Note: No Rotation testing done. Use the "Pack All" button for that.
 + { or } : toggle box fixed/free status
 + \ : rotate box, shell or tile 90 degrees
 + Ctrl-\ : rotate shell inside a box
 + Del : delete box
 + | : toggle orientation lock for shell, selected shells or box
 + Pad 1/3/7/9 : toggle corner preference for shell, selected shells or box
 + # : toggle tile lock for shell, selected shells or box
 +
 +Keys below are no longer supported:
 +
 + R : relax brush
 + Shift-R : very relax brush
 + X : totally relax brush
 +
</pre> </pre>
Line 73: Line 256:
E/2 : toggle/set 3D edit view E/2 : toggle/set 3D edit view
-O : toggle ortho projection+Enter : detach or split shell
-H : hide faces menu+D : drop shell into UV space ***
-Pad5,Home : focus on faces+Shift-D : reattach shell ***
-LMB : rotate+Shift-S : split shell, or tag symmetry plane
-Arrow_Keys : rotate by 30 degrees+
-MMB : pan+
-RMB : zoom+
-LMB+MMB : zoom+
-C/W : cut/weld seam+R : mark revolved polys suited to rectangular flattening
-Shift-C/W : cut/weld extended+Shift-R : mark adjoined quads suited to grid flattening
-Backspace : unselect cut edges+
-Enter : detach shell+
-D : drop shell into UV space+
-Shift-D : reattach shell+
-Shift-S : split seams+
- +
-G : mark paint polys+
-Double-G : mark fill polys+
</pre> </pre>
Line 100: Line 271:
3 : toggle/set 3D texture view 3 : toggle/set 3D texture view
-O : toggle ortho projection+Enter : detach shells
-H : hide faces menu+
-Pad5,Home : focus on faces+
-C/W : cut/weld seam+T : cycle through textures. Use Display Trace to load a custom map.
-Shift-W : toggle weld edges+-/= : rescale checkers when visible
-Backspace : unselect weld edges+
-T : cycle through textures+Shift-LMB : click to pick/unpick single shell
--/= : scale texture+ : click'n'drag to pick multiple shells
 + : click in empty space to unpick all shells
-G : mark paint polys+Shift-MMB : move Trace texture over surface. Must have both
-Double-G : mark fill polys+ a 3D view and a UV view open using split panes.
-LMB : rotate+S : toggle smooth shading for SUBD surfaces
-Arrow_Keys : rotate by 30 degrees+
-MMB : pan+
-RMB : zoom+
-LMB+MMB : zoom+
</pre> </pre>

Current revision

Cover Page
About UVLayout
Load/Save
Display
Hotkeys
Edit
Optimize
Pack
Snap/Stack/Sort
Move/Scale/Rotate
Render
Pattern
Groups
Layers
Reshape
Segment
Quick Start
Interface Plugins
Download PDF
Open up the Hotkeys panel to access some button alternatives for the main keyboard hotkeys.

You can use these initially if you are unfamiliar with the keyboard hotkeys, or if you simply prefer to use the mouse for everything. Not every action is covered by these hotkey buttons though, so as you become more familiar with UVLayout, you will want to study the full list of keyboard hotkeys below.

The top row of buttons are simple clicks to set the view to UV, Ed or 3D space, adjust the brush size, or Undo (shown as Z, but is really Ctrl-Z).

The remaining buttons are toggled on and off. When enabled, you can then use the right mouse button to apply the selected key at the mouse pointer location. If an action calls for the double-tap of a hotkey (e.g. select edge loop with Double-C) then double-click the right mouse button to do the same thing.

Disable the button to turn off the mouse hotkey action, and then the right mouse button can again be used to zoom the view. To zoom the view while a hotkey button is enabled, use the mouse wheel, or click and drag the left and middle mouse buttons.

To manipulate shells or UV vertexes, you can either manually select the appropriate combination of Space, Ctrl and Shift buttons, or use the buttons under the Hints section to set them up for you.

To temporarily disable the selected mouse hotkey actions, stow the Hotkeys panel. Open it back up and the previously selected mouse hotkey actions will be re-instated.


Contents

Below is the full list of hotkeys that can be used in UVLayout's graphics window. Its split into four different sections, the first being hotkeys common to all viewing modes, followed by the hotkeys specific to each of the UV, Ed and 3D viewing modes.

First off, here's some short-hands used in the lists below:

    LMB - Click the left mouse button.
    MMB - Click the middle/wheel mouse button.
    RMB - Click the right mouse button.
    Ctrl - Hold down the Ctrl key while typing the listed key. The Command key can also be used under Mac OS X.
    Shift - Hold down the Shift key while typing the listed key.
    Space - Hold down the Space key while typing the listed key.
    Double - Double tap the listed key.
    *** - Indicates a hotkey that will switch to rectangle selection, to apply the action to multiple shells, if the mouse pointer isn't currently over a shell.

Note: The hotkeys are case-sensitive. This means that if you accidentally turn Caps Lock on, then most functions will not work correctly. Because of this, a warning message will appear in the 3D window whenever you have Caps Lock on.

Common Keys

LMB            : rotate view
Arrow Keys     : rotate by 30 degrees
MMB            : pan
RMB            : zoom
LMB+MMB        : zoom
Wheel Roll     : zoom

Ctrl-Z         : undo

C              : tag cut edges
               : hold C and move mouse to extend selection
Shift-C        : tag an entire edge loop
Double-C       : as above, but stop at branches

W              : tag weld edges
Shift-W        : tag/untag an entire seam
Double-W       : same as Shift-W

Backspace      : untag cut/weld edges

O              : toggle ortho/perspective projection

Pad5/Home/.    : mouse pointer over geometry - focus view onto polys under pointer
               :    pointer over empty space - focus view onto picked shells
               :            no picked shells - focus view onto all visible geometry
Double-Home    : reset view

End/,          : mouse pointer over geometry - focus view onto UV shell under pointer
               :    pointer over empty space - focus view onto UV tile under pointer

G              : mark paint polys
Double-G       : mark fill polys  (Ctrl-G also)
Shift-G        : unmark paint
Double-Shift-G : unmark fill      (Ctrl-Shift-G also)

H              : hide polys menu

>              : auto save to UVL file

/              : Maximize/minimize pane

G Menu

Whenever you type the G key, a menu of extra options appears towards the bottom of the graphics window.

LMB       : Click'n'drag the LMB to stretch a box over polys you want to mark.
RMB       : Click'n'drag the RMB to stretch a box over polys you want to unmark.
F         : Mark polys facing the camera within a 100 degree arc
Shift-F   : Mark polys facing the camera within a 180 degree arc
H         : Hide all marked polys.
P         : Pin the vertexes of all marked polys.
Shift-P   : Unpin the vertexes of all marked polys.
S         : Unmark marked polys, and visa versa.
U         : Unmark all marked polys.
-/=       : Shrink and grow marked region.
Home      : Focus view on marked polys.
Enter     : Make the G menu go away.

H Menu

Whenever you type the H key, a menu of extra options appears towards the bottom of the graphics window.

LMB       : Click'n'drag the LMB to stretch a box over polys you want to hide.
RMB       : Click'n'drag the RMB to stretch a box; all polys outside are hidden.
1         : Hide all flattened polys.
G         : Hide all marked polys.
H         : Hide other shells.
P         : Hide all unpicked shells.
S         : Hide all visible polys, and unhide all hidden polys.
U         : Make all polys visible.
Enter     : Make the H menu go away.

UV View


U/1            : toggle/set UV edit view

Enter          : attach/detach/split shells
Shift-D        : undrop shell back to Ed space ***
D              : then use LMB to set the drop location, use RMB to unset

F              : hold down to flatten/optimize shell ***
Space-F        : start continuous optimize
Space          : stop continuous optimize
Shift-F        : bloat then optimize ***
Shift-B        : scale up then optimize

B              : hold down for optimize brush
-/=            : change brush size

M              : if weld edges tagged, magnet snaps a shell to its adjacent shell
               : if no edges tagged, will snap based on the edge under the pointer
Shift-M        : same as M, but moves the adjacent shell instead
               : You can swap the action of M and Shift-M in the Edit tool
Shift-M        : if no shell under pointer, moves all picked shells to the pointer location
               
L              : toggle shell lock ***

T              : tag webbing edges
Shift-T        : toggle webbing edges
Double-T       : same as Shift-T
Backspace      : unselect webbing edges

P              : toggle pin
Double-P       : pin between two already pinned boundary points
Shift-P        : as above if pointer over a boundary point, 
               : pins all boundary points if pointer over shell,
               : otherwise shows pin box menu
Ctrl-P         : unpin all points in shell

L/R Arrow      : flip shell in U. Flipped shells are drawn with red wires.
U/D Arrow      : flip shell in V
Shift-Arrow    : flip all shells with same flip state as shell under pointer
Ctrl-Shift-Arr : select all shells with same flip state as shell under pointer

LMB            : click to pick/unpick single shell
               : click'n'drag to pick multiple shells
               : click in empty space to unpick all shells
               : see About UVLayout -> Preferences -> Edit Settings -> LMB Pick for more info

Backquote      : (above Tab) Toggles tile selection mode

Space-LMB      : rotate picked shells or marked polys
Space-MMB      : move picked shells or marked polys
Space-RMB      : scale picked shells or marked polys
Space-LMB+MMB  : as above
Tab            : hold down for finer control
Alt            : hold down to xform a single shell when multiple shells picked

Ctrl-MMB       : move single point
Ctrl-Shift-MMB : move connected points
Shift-MMB      : move points in circle

_/+            : change UV box size (i.e. Shift -/=)
               : if a single point is pinned, the resize is centered about that point
L/R Arrow      : aim pointer at empty space to move UV box in U direction
U/D Arrow      : aim pointer at empty space to move UV box in V direction
Tab            : hold down for finer control

A              : toggle horizontal/vertical snap anchor
Shift-A        : turn off all anchors in shell 

Ctrl-L/R Arrow : aim pointer at edge to rotate shell so edge is horizontal
Ctrl-U/D Arrow : aim pointer at edge to rotate shell so edge is vertical

I              : tag straight edge - axis aligned 
Shift-I        : tag an entire edge loop
Backspace      : untag edge
Ctrl-I         : on tagged edge - remove all 'I' tagged edges from shell
                 on untagged edge - 'I' tag all similarly oriented edges
 
K              : tag straight edge - unaligned 
K              : toggle kink point
Shift-K        : tag an entire edge loop
Backspace      : untag edge
Ctrl-K         : on tagged edge - remove all 'K' tagged edges and points from shell
                 on untagged edge - 'K' tag all similarly oriented edges

R              : if topology allows, snap quads to an axis aligned grid. 
                 otherwise, snaps boundary to an axis aligned rectangle ***
Shift-R        : as above, but the internal UVs are also aligned ***

J              : move shell to the "Junk" tile ***
Shift-J        : randomize shell's UVs

When mouse pointer is aimed at shell boundary points:
 
  S            : toggle stack marker
  Double-S     : straighten between two stack markers
  Shift-S      : as above
 
When mouse pointer is aimed at shell interior polys:
 
  S            : copy UVs from light to dark mirror polys ***
  Shift-S      : swap light and dark mirror polys

When Brush Local Scale selected:
 
  4            : scale polys up
  5            : scale polys down
  4+5          : reset local scaling
 
When Brush Pin selected:
 
  4            : push UVs out and pin
  5            : pull UVs in and pin
  6            : smooth UVs and pin
  4+5          : unpin

Pack tool hotkeys:

  [ or ]       : pack shells in box, or if no box is picked, packs all shells
               * Note: No Rotation testing done. Use the "Pack All" button for that.
  { or }       : toggle box fixed/free status
  \            : rotate box, shell or tile 90 degrees
  Ctrl-\       : rotate shell inside a box
  Del          : delete box
  |            : toggle orientation lock for shell, selected shells or box
  Pad 1/3/7/9  : toggle corner preference for shell, selected shells or box
  #            : toggle tile lock for shell, selected shells or box

Keys below are no longer supported:
 
  R            : relax brush
  Shift-R      : very relax brush
  X            : totally relax brush

Ed View

E/2            : toggle/set 3D edit view

Enter          : detach or split shell
D              : drop shell into UV space ***
Shift-D        : reattach shell ***

Shift-S        : split shell, or tag symmetry plane

R              : mark revolved polys suited to rectangular flattening
Shift-R        : mark adjoined quads suited to grid flattening

3D View

3              : toggle/set 3D texture view

Enter          : detach shells

T              : cycle through textures. Use Display Trace to load a custom map.
-/=            : rescale checkers when visible

Shift-LMB      : click to pick/unpick single shell
               : click'n'drag to pick multiple shells
               : click in empty space to unpick all shells

Shift-MMB      : move Trace texture over surface. Must have both
                 a 3D view and a UV view open using split panes.

S              : toggle smooth shading for SUBD surfaces