gimp/docs/cheat_sheet.txt

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)

	mb1			draw 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+mb1		keep part of selection in both 
				selections (union)
		
  on active selections
	
	alt+mb1			move 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     ???
		
	Feather		Turns 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	????
		
	Feather		Turns 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
	
	mb1		sets 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+mb1		adjust one handle
	ctrl+mb1		move the point
		

  Tool Options
	
	Antialiasing	????
		
	Feather		Turns 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

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

Magnify (Zoom)

	mb1			zoom in 
	shift+mb1		zoom 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
	
	crop				crop to area selected
	selection			use the bounds of the 
					current selection to 
					set bounds of crop
	close				cancel the crop
		


Transform

  note: transform type is selected via the tool options dialog
	
  Rotation
	
	mb1			free rotation
	ctrl+mb1		rotate 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
	
	mb1			free shearing
		
  Perspective
	
	mb1			move the control points
		
  Tool Options
	
	Smoothing		determines if sub-pixel sampling is done
		

Flip

	mb1				Flip in indicated direction
	
  Tool options
	
	Horizontal		Flip horizontally
	Vertical		Flip vertically
		

Text Tool

	mb1		set top left bounds of text
	
	

Color Picker

	mb1		set active color to color under cursor
	
	
Bucket Fill

  (with no selection)
	
	mb1		do a seeded fill from the pixel where the cursor is
			filling with the foreground color
						
	shift+mb1	do 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 Fill	use foreground or background color to fill
		Pattern Fill	use 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

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

	Mode		What 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
		
		Linear			from point a to point b

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

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

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

		conical			????
		conical  
			(asymeteric)	????
		Shapeburst		Fills selections based on 
					the shape of the selections
						
		Repeat
			None		just make one blend
			Sawtooth	repeat the blend
			triangle	another 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+mb1		draw 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+mb1		draw a straigtline from the last place 
				the cursor was
		 
	Tool Options
	
	   Fade Out		distance 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+mb1		erase 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+mb1		draw a straigtline from the last place
				 the cursor was
		 
	Tool Options
	
		Rate		Controls how quickly the "paint flows".
				 Higher values reach full value quicker
						
		Pressure	the higher the value, the quicker the 
				airbrush fills the brush
		

Clone Tool


	mb1(hold)		draw with the clone tool	
	ctrl+mb1		set 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+mb1		draw 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
	
		Pressure		used to control intensity of tool
		
		Blur			blurs the are under the cursor
		Sharpen			tries to sharpen the are 
					under the cursor