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 unlimeted "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 eith 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