NAME
    MPlayer.pm - An OO interface to MPlayer for Perl

SYNOPSIS
      use MPlayer
  
      my $mp = new MPlayer("./opensource.ogg", -1, "-ao" => "oss");

      sleep 10;

      $mp->mute();

      $mp->quit();

      $mp = new MPlayer("some_movie.avi", -1, "-cache" => 1024);

      $mp->vo_fullscreen();

      $mp->pause();

      my @error = $mp->error;
      print join "\n", @error;

      #Show last error:
      my $error = $mp->error
      print $error;

      $mp->tv_step_channel(1);
      $mp->tv_set_channel(2);

DESCRIPTION
    MPlayer.pm is a simple interface to MPlayers slave mode command and can
    be used inside a perlscript.

NOTE
    MPlayer.pm does not keep block, i.e. if your script exits before the
    sound file is finished, it will just kill MPlayer. This module might be
    used to write interfaces in Perl::Tk or Curses::UI which have a Mainloop
    for flowcontrol.

GENERAL
    MPlayer implements all calls documented in DOCS/tech/slave.txt. Calls
    will return a true value on success and 'undef' otherwise. Some calls
    are not documented at all, they return 'undef' defaultly. If an error
    occurs you can access those errors through a call to $mp->error() which
    will give you a string error description.

    See DOCS/tech/slave.txt in the mplayer source tree for all calls and
    their options.

    The tv_ calls can be called thourgh $mp->tv_...

USAGE
    new( filename, mplayer_opts.... )
        Filename is mandatory, MPlayer needs a given filename to start up.
        Mplayer_opts can be any of MPlayers command line options as an
        anonymous hash (e.g. "-cache" => 1024 ).

    error()
        Returns descriptions of errors that have occured in MPlayer.pm. In
        array context it returns all errors, in scalar context the last
        error that occured.

INSTALL
    At the very least you should be able to use this set of instructions to
    install the module...

        perl Makefile.PL
        make
        make test
        make install

    If you are on a windows box you should use 'nmake' rather than 'make'.

BUGS
    This is the first version, mostly untested when it comes to TV stuff. If
    you find a bug please report it to the author.

AUTHORS
            Marcus Thiesen
            marcus@cpan.org
            http://www.thiesenweb.de
	    
	    Modified by
	    Peter Ivanov
	    ivanovp@freemail.hu

COPYRIGHT
    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

    The full text of the license can be found in the LICENSE file included
    with this module.

SEE ALSO
    perl(1). mplayer

