Provided by: mjpegtools_2.1.0+debian-4_amd64 bug

NAME

       lavplay - Playback and edit MJPEG video

SYNOPSIS

       lavplay [options] lavfile1 [lavfile2 ... lavfileN]

DESCRIPTION

       lavplay can be used to playback video in MJPEG format (either quicktime or AVI) on a zoran
       video-capture device, such as the Miro/Pinnacle DC10(+), the Iomega  Buz  or  Linux  Media
       Labs' LML33, or in software mode (using SDL).

       It also provides mechanisms for non-destructive editting video using an interactive front-
       end such as glav(1).  See SEARCHING AND EDITING below for details.

OPTIONS

       lavplay accepts the following options:

       -p/--playback [S|C|H]
               The playback mode to be used. 'S' means software-playback using SDL.
                'H'   means   hardware-playback   on   the   monitor   (on-screen).   'C'   means
               hardware-playback  to the video-out of the zoran video-capture device.  Obviously,
               'C' and 'H' only work on computers with zoran video-capture devices.

       -Z/--full-screen
               Full-screen playback. This works if SDL- or onscreen-playback is chosen.

       --size NxN
               Size of the video window (default: size of the input video)  when  using  software
               (SDL) or hardware onscreen playback

       -a/--audio num
               When play audio, 0 means never, or sum of
                 1: while playing forward,
                 2: while playing reverse,
                 4: even fast playing,
                 8: while pausing
               (default:  7: forward/reverse/fast).  If 8(pausing) was contained, lavplay will be
               very noisy, but useful when you want to edit by sound.

       -z/--zoom
               Zooms the video to fit the screen as good as possible.

       -x      Exchange fields of an interlaced video. Try this if the  video  looks  weird.   It
               shouldn't be necessary with stuff captured using lavrec(1) but could be needed for
               other sources.

       -s/--skip num
               Skip <num> seconds of video at the beginning.

       -x/--exchange-fields
               Invert field  order  (for  videos  which  are  recorded  with  wrong  field  order
               interlacing settings)

       -F/--flicker
               Disable  stills  flicker  reduction.   This  is  useful  if you want to see stills
               exactly as they were recorded rather than flicker-free!

       -c/--synchronization [0|1]
               Enables (1) or disables (0) the use of sync  corrections.  Basically,  you  almost
               certainly  want  this.   Disabling is really there for diagnostic purposes and not
               much else.

       -H/--H-offset num, -V/--V-offset num
               Horizontal (-H) and vertical (-V) offset  when  using  hardware-playback.   Offset
               plus  width  or  height  should  be smaller than or equal to the playback device's
               maximum allowed size (DC10+: 640x480 or 768x576, LML33/Marvel/Buz: 720x480/576).

       --s-x-offset num, --s-y-offset num
               Offset for the video window (from top left  screen  corner)  when  using  hardware
               onscreen playback in non-fullscreen mode.

       --display :x.x
               When  using  hardware  fullsreen video playback (-pH), this setting can be used to
               specify the video display (default: :0.0) to use for video display.

       -q/--no-quit
               Makes lavplay stay alive at the end  of  the  video  (lavplay  won't  quit).   Use
               'q<enter>' on the command line to quit (see below, SEARCHING AND EDITING).

       -g/--gui-mode
               Enables  GUI-mode. This is used by glav and Linux Video Studio. It will output the
               current position in the video each frame, so that the glav or LVS can  keep  track
               of where we are in the video which is being played back.

       -P/--preserve-pathnames
               This  is  used  by  glav  and  Linux Video Studio.  When editlists are created the
               original pathnames for files are used and not the canonicalised pathnames from the
               root  directory.   Useful  if you've got things like automounters active that make
               directories with the same non-canonical name have  different  canonical  names  on
               different machines.

       -U/--use-write
               Use  the  write() system call rather than the mmap() system call for audio writing
               to the sound device.   This may fix some audio playback problems.

       -n/--mjpeg-buffers num
               Number of MJPEG-buffers. Default is 32. Try changing this number if you have  many
               lost frames.

       -v/--verbose num
               Verbosity level (0, 1 or 2)

ENVIRONMENT VARIABLES

       The following environment variables can be recognized by lavrec:

       LAV_VIDEO_DEV
               The video device. Default is /dev/video

       LAV_AUDIO_DEV
               The audio device. Default is /dev/dsp

SEARCHING AND EDITING

       lavplay can do more than simple plain playback. It is also intended to be controlled using
       commands sent via stdin from a front-end  like  glav(1)  or  similar,  more  sophisticated
       tools.   The  most  significant aspect of this functionality is the ability to create edit
       list files giving the playback sequence of an editted version of  the  input  video.   The
       edit  list  file  can be read by any of the mjpegtools(1) (including lavplay!) wherever an
       actual video file would be acceptable.  Such edit lists record only  the  original  source
       file and start and stop frames of the components of the editted video editting rather than
       the video itself.  As such editting leaves the original files unchanged and requires  only
       tiny  amounts  of  data-movement.   The  drawback  is  that  for the edit list to work the
       original files must remain unchanged, and that interactive play may be jumpy  due  to  the
       playback sequence "skipping about" between different parts of the original video sequence.

       If  a stand-alone consolidated versions of editted video is required it can be produced by
       running the lavtrans(1) utility on the edit list.

       Edit list files are plain text with a very simple syntax to  allow  easy  manual  editting
       using a text-editor or writing of scripted editting tools.

STDIN COMMANDS

       The  commands  accepted  on  standard  input  sre as follows (and can of course be entered
       directly by command-line junkies):

       +, -    Goes to next/previous frame. Only makes sense when the video is paused.

       pN      Sets playback speed to N (N=..., -1, 0, 1, ...)

       a[01]   Enables/disables audio playback

       sN      if N is a number, this means to go to frame N. if N is prefixed by a + or -,  this
               means to go N frames back- or forward.

       om editlist [N1 N2 [N3 N4]]
               Opens  a movie or editlist. A second and third argument can specify to only open a
               specific range of frames from this video (N1=-1 means whole video). N3 and N4  can
               specify  to  show  only a specific range of frames from the frames which were just
               opened (useful for trimming).

       w[as] file
               Save the current editlist (a) or the current selection (s) to a file.

       q       Quit lavplay.

       e[ou] N1 N2
               Cuts (u) or copies (o) frames N1-N2 from the current  editlist  into  an  internal
               selection.

       ep      Pastes the contents of the selection into the current position in the editlist.

       em N1 N2 N3
               Moves frames N1-N2 to position N3 in the video.

       ed N1 N2
               Deletes frames N1-N2 from the editlist.

       ea video N1 N2 N3
               Adds  frames N1-N2 of the video into position N3 within the editlist.  N1=-1 means
               to add the whole video.

       es N1 N2
               Sets the current viewable frames within the whole video to N1-N2. This  is  useful
               for trimming.

BUGS

       Editlists  record  absolute  pathnames.   This  more or less forces manual editting of the
       pathnames in them if it is desired to move editlists and source video files.

       lavplay really ought to make a decent job of detecting what playback options are  feasible
       (on-screen  hardware, video-out port hardware, software) and set the default playback mode
       appropriately.  Alas, it does not.

AUTHOR

       This man page was written by Ronald Bultje.
       If you have questions, remarks, problems or you just want to contact the  developers,  the
       main mailing list for the MJPEG-tools is:
           mjpeg-users@lists.sourceforge.net
       For more info, see our website at
           http://mjpeg.sourceforge.net/

SEE ALSO

       mjpegtools(1), lavrec(1), glav(1)