
           AV viewer
	   
	   (C) Vladimir Dergachev 2001-2004
	   
	  
   A viewer for TV capable cards.
   
          * Xv support
	  
   Requirements: TV input capable card with Xv support
		 Tcl/Tk 8.4.x or later
		 libzvbi from http://zapping.sf.net/
		 ffmpeg-0.4.6 from http://ffmpeg.sf.net/
		 LIRC (optional) from http://www.lirc.org/
		  
	
*** NOTES ***

       * right-clicking in the video window will bring up a menu
       
       * People with newer cards with SPDIF - if your sound is distorted
         try muting/unmuting various channels (like CD).
	 LET ME KNOW (volodya@mindspring.com) if this helps.       

       * If you are working off ffmpeg CVS it is a good idea to run
         
	 make clean; cvs update -d; make 

	 in ffmpeg directory before installing newer version of avview. 
	 Since CVS might turn out to be screwed up I recommend making a 
	 tarball of ffmpeg tree right after make clean - it is not that 
	 big and you would be able to untar it and continue as before if 
	 anything breaks.
	 
       * Do you want to use AVview remote bindings before AVview is launched ?
         put the following line in your .xinitrc or .xsession file:

	 xmodmap /usr/local/share/AVview/avview.modmap

         You might need to replace /usr/local/ with whatever location 
	 you installed AVview in.       	 


       * at the moment closed captioning will only work with km from CVS
         and only with Radeon cards.

*** KEYBOARD BINDINGS ***

	*** Pressed anywhere in AVview ***
	
	Control-F                toggle fullscreen
	Keypad + or -  	         switch favorite channels
	Control-Keypad + or -	 increas/decreases channel number
	Control-i                switch between tuner/composite/svideo
	Keypad *                 toggle mute
	Arrow Up/Down            switch on-screen controls
	Arrow Left/Right         adjust on-screen control
	Control-q or Escape      exit AVview

	*** Pressed in main window (with TV display) ***
	
	1-9,0			 input channel number
	1-9,0, single letters	 input channel name
	' (apostrophe)		 begin entering channel name (required
				 for all-digit channel names)
	Enter, Return		 switch to keyed in channel
	Delete			 erase keyed in channel name and show 
				 current channel
	BackSpace		 erase last entered letter
	
	Left-click		 rotate among on-screen controls
	Right-click		 bring up popup menu
	MouseWheel		 adjust on-screen control
	
*** LIRC CONFIGURATION ***

       * LIRC (Linux Infrared Remote Control) commands are defined in
	 file ~/.lircrc, see
	 <http://www.lirc.org/html/configure.html#lircrc_format> for
	 description of the file format. Each entry in the file has
	 prog field telling which application should handle the button
	 press. For AVview this field is 'avview' (without the
	 apostrophes). The following commands are recogniced as config
	 field values:

	 fullscreen		 toggle fullscreen mode
	 next_channel val     	 switch between favourite channels.
				 val is the number of channels to 
				 skip, can be negative
	 mute			 toggle mute
	 exit			 exit AVview
	 volume val		 change volume by amount val
	 next_control val	 switch on-screen control. val is the
				 number of controls to skip, can be
				 negative
	 change_control val	 change the value of on-screen control
				 by amount val
	 next_encoding		 change xv port encoding (PAL, NTSC, ...)
	 remote_power_off	 exit or toggle screensaver
	 channel val		 select channel val. val is channel
				 name (e.g. E5)
	 channel_number val	 select channel number val
