FreeJ version 0.6 USAGE NOTES
===============================

The interface consists in a on screen display (OSD) reporting
informations like FPS, the filters that are created in the order they
are applied to the layer and some status messages.

LIST OF COMMANDS:
^ means CTRL key pressed
% means SHIFT key pressed

 GENERIC COMMANDS:
 ^SPACE   = switch fullscreen mode
 SPACE    = freeze the whole engine
 ESC      = quits (without confirm)
 TAB      = on/off OSD
 ^TAB     = on/off calibration guidelines
 PRINTSCR = display nice and lovely credits


 LAYER COMMANDS:

 PGUP/PGDOWN   = select layers up and down thru the chain
 ^PGUP/^PGDOWN  = move layers up and down thru the chain

 HOME     = hide/show layer         BACKSP   = turn matte off
 %BACKSP  = white matte             ^BACKSP  = black matte

 1 = select NORMAL BLIT             2 = select BLU BLIT
 3 = select GREEN BLIT              4 = select RED BLIT
 5 = select ADD BLIT                6 = select SUB BLIT
 7 = select AND BLIT                8 = select OR BLIT
 9 = SWITCH ALPHA blend on/off      0 = SWITCH BLANK screen on/off
 with ALPHA blend on, you can fade thru values using 1-9 keys

 %ARROWS  = move layers around thru the screen
 mouse-l  = drag layers around, slowly and smoothly
 
 

 FILTER COMMANDS:

 F1 - F12 = select an available filter (enter to create it)
            you can browse thru loaded plugins with this

 ^F1-^F12 = select the filter bank from which browse filters
            filters are stored in 12 banks, containing 12 filters each

 UP/DOWN  = select created filters up and down thru the chain
 ^UP/DOWN = move created filters up and down thru the chain

 DELETE   = remove selected filter
 ^DELETE  = remove ALL filters

 INSERT   = activate/deactivate filter
 (filters may have their own keys to change specific parameters)
 
 VIDEO 4 LINUX LAYER COMMANDS:
 k/m      = switch up/down input channel
 j/n      = (if TV tuner is present) switch up/down frequency tables
 h/b      = (if TV tuner is present) cycle up/down frequencies

 AVI LAYER COMMANDS:
 l/r
 arrows   = move one keyframe back and forward on the avi
 ^l/r
 arrows   = move many keyframes back and forward on the avi:
            left ctrl = 50000 ; right ctrl = 10000 ;
	    left shift = 5000 ; right shift = 1000 ;
 Key_Pad_0  PAUSE (still can seek !)
 %I       = set/clear mark_in
 %O       = set/clear mark_out
 k,l      = -/+ double frame / slow motion
 n,m      = -/+ play speed
 if k,l,n,m are not working as you expect, you have two 
 possibilities: recode the movie with full frames 
 or regard the artifacts as art 8=)

 TXT LAYER COMMANDS:
 l/r
 arrows   = go to previous/next word in text
 o,p      = -/+ font size, hold ctrl for bigger increase
 u,i      = cycle thru available fonts
 b        = blink cycling thru words in file, loop at end
 m,k      = -/+ time on screen while blinking
 n,j      = -/+ time off screen while blinking


SOME FILTER COMMANDS:
(see the filter's sourcecode for details)

 DelayGrab filter
 q/w      = browse the 4 delay maps
 a/s      = -/+ blocksize

 Vertigo filter
 q/w      = -/+ phase
 a/s      = -/+ zoom speed
 z/x      = -/+ weirdness

 Simura filter
 caps-lock + all letters = change color filters
 keypad numbers = change mirror mode

 QuadTrans filter
 q/w      = -/+ frames of the screen

 SquareTrans filter
 q/w      = -/+ blocksize

 Water filter
 q/w      = -/+ water density
 e        = big splash in the center
 r        = randomly placed splash
 t        = rain
 y        = whirpool in the center
 u        = surfer
 d        = distort surface (USE WITH CAUTION)
 f        = calm water

 Cartoon filter
 q/w      = -/+ blending
 a/s      = -/+ border outline

 Nervous filter
 q        = switch between the 2 modes

SDL TIP:

 if you set the environmental variable SDL_VIDEODRIVER to something like
 "aalib" then you can render freej screen in ascii art, and you can use
 other drivers as well, see the SDL documentation for details.


 for more information ask the mailinglist <freej@dyne.org>
 subscribe with a mail to <freej-subscribe@dyne.org>

