This is a crash course in the basics of what all the hotkeys for the
This is a crash course in the basics of what all the hotkeys for the
the Toolbar tools do. It also describes basics of what the Tool Options
parameters control.

Version 1.0 Fri Nov  7 1997 Adrian Likins <adrian@gimp.org>

==========================================================================
=key
=
=mb1 mouse button 1
=mb2 mouse button2 (middle button)
=mb3 mouse button3 (right button)
=
=Ctrl   Control Key
=       Shift  Shift key
=       Alt    Alt or Meta or whatever
=
==========================================================================


All selections (rectangular, ellipse, fuzzy, magic wand)

mb1draw selection

mb1+mb3 (release mb1)cancel selection

  At inital click

shift+mb1       Add selection to existing selection

ctrl+mb1        subtract selection from existing selection

shift+ctrl+mb1keep part of selection in both 
selections (union)

  on active selections

alt+mb1move selection


ellipse and rectangular selection

  while making selection

shift+mb1        constrain selection to regular shape 
(square/circle)

ctrl+mb1        draw selection centered from click

ctrl+shift+mb1          draw (square/circle) selection centered 
on click


  Tool Options

Antialiasing     ???

FeatherTurns on feathering (similar to blurring a
 selection mask)
Used to make a "smoother" selection
  
Feather Radius   Determines the blur radius of the selection mask.
  How smooth the selection needs to be.
  
  
Magic Wand selection

  (all the general selection addition rules apply)

  Tool Options

Sample Merged   If off, just use the contents of the 
current drawable
if on, use whats visible.
 
Antialiasing????

FeatherTurns on feathering (similar to blurring
 a selection mask)
 Used to make a "smoother" selection
  
Feather Radius   Determines the blur radius of the selection mask.
 How smooth the selection needs to be.
  
Bezier Select

  While making selection

mb1sets the control points

  To make bezier into a selection

close the selection (beziers have to be closed), then click
inside the selection. Zooming in sometimes helps.

  After closing bezier (but before making a selection)

mb1 on control point adjust handles
shift+mb1adjust one handle
ctrl+mb1move the point


  Tool Options

Antialiasing????

FeatherTurns on feathering (similar to
 blurring a selection mask)
Used to make a "smoother" selection
  
Feather Radius   Determines the blur radius of the selection mask.
 How smooth the selection needs to be.
  
  
Intelligent scissors

Nothing yet

Move Tool

mb1move current layer

shift+cursor keysmove current layer by 25 pixels
ctrl+cursor keysmove current layer by 1 pixel
alt+cursor keys move selection by 1 pixel
alt+shift+cursor keys moce selection by 25 pixels


Magnify (Zoom)

mb1zoom in 
shift+mb1zoom out

Tool Options

Allow window resizing  if on, window will resize when
        zooming in and out
       if off, window will retain its current size
  

Crop

  Before  making crop bounds

mb1      select bounds of crop
mb1+mb3(release mb1)  cancel crop

  After making crop bounds

mb1(inside bounds)crop to are selected (same as 
pressing crop button)


  Crop tool dialog options

cropcrop to area selected
selectionuse the bounds of the 
current selection to 
set bounds of crop
closecancel the crop



Transform

  note: transform type is selected via the tool options dialog

  Rotation

mb1free rotation
ctrl+mb1rotate in 15 degree increments

  Scaling

mb1 free scaling
ctrl+mb1   scale in Y direction only
shift+mb1  scale in X direction only
shift+ctrl+mb1 scale with constrained ratio

  Shearing

mb1free shearing

  Perspective

mb1move the control points

  Tool Options

Smoothingdetermines if sub-pixel sampling is done


Flip

mb1Flip in indicated direction

  Tool options

HorizontalFlip horizontally
VerticalFlip vertically


Text Tool

mb1set top left bounds of text



Color Picker

mb1set active color to color under cursor


Bucket Fill

  (with no selection)

mb1do a seeded fill from the pixel where the cursor is
filling with the foreground color

shift+mb1do a seeded fill from the pixel where the cursor is
filling with the background color

  (with a selection active)

mb1  fill the seelction with foreground color
shift+mb2  fill the selection with the background color


  Tool Options

Fill Opacity        opacity of the fill?

Fill Threshold    If the surroundings pixels are within this value
     of the inital pixel, they are filled

Mode    What paint mode to use

Fill Type
Color Filluse foreground or background color to fill
Pattern Filluse current active pattern to fill

Sample merged     if on, use the visible compontents to determine
    where to fill
  if off, use the active drawable to determine
   where to fill


Blend Tool

mb1     set start and endpoints of gradient
mb1+mb2(release mb1) cancel blend

  Tool Options

Opacity How transparent the gradient should be

Offsetat what percentage fo the gradient to 
start from (ie, 50 to start the blend at
 halfway through the gradient)

ModeWhat paint mode to apply the blend with
Blend
FG to BG (rgb)      Blend from the foreground color to 
    background color  in rgb space 
FG to BG (hsv)      Blend from the foreground color 
    to the background color in hsv space

FG to Transparent   Blends the foreground color from 100% 
    opacity to 0% opacity
  
Gradient

Linearfrom point a to point b

bi-linearlike linear but "mirrored"
 across the inital point

Radialblends radial form point A 
being the center to point B 
being a point on the circumference.

Squaremakes a sqaured shaped blend
 from a center at Point A
to point B on the perimeter

conical????
conical  
(asymeteric)????
ShapeburstFills selections based on 
the shape of the selections

Repeat
Nonejust make one blend
Sawtoothrepeat the blend
triangleanother way to repeat... ??

adaptive supersampling
if on, blend does supersampling
resulting in a much smoother
blend if off, blend does no
supersampling resulting in a 
much faster blend

Max Depth.???
Threshold???


Pencil

mb1(hold)draw with pencil tool
alt+mb1(hold)draw with pencil tool, but store all
 of the cursor history events (so you
 can draw fast and let it catch up
 with you without losing info)

shift+mb1draw a straigtline from the last place
 the cursor was


Paintbrush

mb1(hold)draw with paintbrush tool
alt+mb1(hold)draw with paintbrush tool, but store
all of the cursor history events (so you
can draw fast and let it catch up
 with you without losing info)

shift+mb1draw a straigtline from the last place 
the cursor was
 
Tool Options

   Fade Outdistance you can paint before 
the paint "runs out"
set to 0 for unlimited "paint"

Eraser

mb1(hold)erase (set to transparent or background
 color)
alt+mb1(hold)erase but store all of the cursor history
events (so you can erase fast and let
 it catch up with you without losing info)
shift+mb1erase a straightline from the 
last place the cursor was


Airbrush


mb1(hold)draw with airbrush tool
alt+mb1(hold)draw with airbrush tool, but store all
of the cursor history events (so you
can draw fast and let it catch up with
 you without losing info)

shift+mb1draw a straigtline from the last place
 the cursor was
 
Tool Options

RateControls how quickly the "paint flows".
 Higher values reach full value quicker

Pressurethe higher the value, the quicker the 
airbrush fills the brush


Clone Tool


mb1(hold)draw with the clone tool
ctrl+mb1set the point from which the brush clones
  
alt+mb1(hold)draw with clone tool, but store all of
the cursor history events (so you can 
draw fast and let it catch up with you
 without losing info)

shift+mb1draw a straigtline from the last place
 the cursor was
 

 Tool Options

Source
Image source     clone from somewhere within the
 image (set with ctrl+mb1)
Pattern source   clone from the current active pattern

Aligned

tries to keep the source point and the cloned
 point "in sync" YMMV if for pattern source, 
having alligned on means the clone tool reveals
 a consistent pattern. If off, the clone tool 
can start the cloning from a new pointin the pattern
 each time.

Convolver

note: convolve type is set in the Tool options dialog

mb1(hold)blur or sharpen under cursor
 
Tool Options

Pressureused to control intensity of tool

Blurblurs the are under the cursor
Sharpentries to sharpen the are 
under the cursor