home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 24 / CDACTUAL24.iso / SHARE / os2 / mp123 / manual / pm123.doc < prev    next >
Encoding:
Text File  |  1998-04-11  |  9.1 KB  |  274 lines
  1.  
  2.  
  3.                                     PM123
  4.  
  5.                                  USER'S GUIDE
  6.                                        
  7.    
  8.      _________________________________________________________________
  9.    
  10.      PM123 is a Graphical User Interface to the MP123 MPEG-audio player.
  11.      This software allows you to play and control MPEG-audio Layer 1, 2
  12.      and 3 streams. It also offers extensive playlist, drag'n'drop, ID3
  13.      tag and HTTP support all wrapped nicely into a cool looking
  14.      interface.
  15.      
  16.    
  17.      _________________________________________________________________
  18.    
  19.    
  20.    
  21.    Installation
  22.      _________________________________________________________________
  23.    
  24.      Installation procedure is very simple, all you need to do is create
  25.      a directory for PM123 and unpack it there (it's recommended to use a
  26.      HPFS partition, but PM123 will work just fine from a FAT partition
  27.      too).
  28.  
  29.      [c:\os2apps] md pm123
  30.      [c:\os2apps] cd pm123
  31.      [c:\os2apps\pm123] unzip c:\pm123_b1.zip
  32.  
  33.      If you want a PM123 icon on your desktop, run INSTALL.CMD.
  34.  
  35.      [c:\os2apps\pm123] install
  36.  
  37.    
  38.    Starting the player
  39.      _________________________________________________________________
  40.    
  41.      
  42.      There are a few different ways to start PM123. You can start it
  43.      simply by entering PM123 on command line or starting it from the
  44.      desktop icon.
  45.      
  46.      You can also start PM123 with a file (or wildcards) or a playlist as
  47.      a parameter. Like this:
  48.  
  49.      [c:\os2apps\pm123] pm123 c:\audio\mpeg\test.mp3
  50.      [c:\os2apps\pm123] pm123 c:\audio\mpeg\test.lst
  51.      [c:\os2apps\pm123] pm123 c:\audio\mpeg\*.mp3
  52.  
  53.      Note: If PM123 isn't always started from its directory, you should
  54.      copy MP123.DLL to a directory in your LIBPATH (or add PM123's
  55.      directory to your LIBPATH).
  56.      
  57.    
  58.    Playing your first file
  59.      _________________________________________________________________
  60.      
  61.      When you have started the player, you'll get the player window on
  62.      your desktop.
  63.      
  64.      Main window
  65.      
  66.      Next click on the player window with right mouse button (RMB from
  67.      here on). You should get a menu like this:
  68.      
  69.      Main popup menu
  70.      
  71.      Click on Properties.
  72.      
  73.      Properties notebook
  74.      
  75.      You can now configure the player. For information about configuring,
  76.      look at Configuring PM123.
  77.      
  78.      Pop up the menu with RMB again, and click on Load file. Then select
  79.      a file to load and click Ok.
  80.      
  81.      Now you have loaded a file.
  82.      
  83.      Main window
  84.      
  85.      Click on play and enjoy the music!
  86.      
  87.      Play button
  88.      
  89.    
  90.    Controlling your player
  91.      _________________________________________________________________
  92.      
  93.      
  94.      PM123 can be controlled with the buttons in the main window.
  95.      
  96.      Button bar
  97.      
  98.      
  99.         >                       Play and stop
  100.         ||                      Pause
  101.         << and >>               Rewind and fast forward
  102.         A note                  Opens and closes the playlist window
  103.         Repeat symbol           Toggles the repeat of playlist
  104.         Question mark symbol    Toggles the shuffle (random play) of
  105.                                 playlist
  106.         <| and |>               Skips to previous or next song in playlist
  107.         Power symbol            Quits PM123
  108.      
  109.      Additional options can be access by click right mouse button on the
  110.      main window. It pop ups this menu:
  111.      
  112.      Main popup menu
  113.      
  114.      Open playlist: Opens the playlist window.
  115.      
  116.      Load file: Loads a single file to the player.
  117.      
  118.      Open URL: Opens a file directly from the Internet (or Intranet)
  119.      using the HTTP protocol. It only accepts URLs prefixed with http://.
  120.      
  121.      
  122.      Properties: Brings up a notebook for PM123 settings.
  123.      
  124.      Font: PM123 has two different fonts for the main screen. You can
  125.      select between them.
  126.      
  127.      Size: You can choose between different play window looks. Small and
  128.      tiny are for people who don't want PM123 to take any extra desktop
  129.      space.
  130.      
  131.      Hide window: Hides PM123 window. You can restore PM123 window from
  132.      the Window list.
  133.    
  134.    
  135.    Playlist window controls
  136.    
  137.      Playlist window
  138.      
  139.      You can manage the playlist by clicking to it with right mouse
  140.      button on a empty space (space where there are no filenames). It
  141.      should bring up this menu:
  142.      
  143.      Playlist menu
  144.      
  145.      Use this playlist: By default PM123 is in a "single file play" mode.
  146.      You must first select Use this playlist to activate the playlist.
  147.      
  148.      Add to list: Prompts you for files to add in the playlist. NOTE! You
  149.      can also add playlists.
  150.      
  151.      Clear list: Clears the whole list.
  152.      
  153.      Save list: Saves the list into a .LST-file.
  154.      
  155.      Load list: Loads a list into the playlist (replacing your current
  156.      list).
  157.      
  158.      Sort: You can sort the playlist by file size, playing time, filename
  159.      and song name.
  160.      
  161.      If you click on a filename on the playlist, you'll get this menu:
  162.      
  163.      Playlist file menu
  164.      
  165.      Play: Plays this file.
  166.      
  167.      Remove from list: Removes this file from the playlist.
  168.      
  169.      Edit tag: Edits this files ID3 tag information. For more
  170.      information, see ID3 tags.
  171.      
  172.      You can organize the files in playlist by grabbing a file with right
  173.      mouse button and dragging it to a new location in the playlist.
  174.      
  175.    Configuring PM123
  176.      _________________________________________________________________
  177.    
  178.      
  179.      
  180.      Properties notebook
  181.      
  182.      This is the Properties notebook. It can be accessed by RMB'ing the
  183.      main window and selecting Properties. It has two pages,
  184.      Configuration and About.
  185.      
  186.      Sound system
  187.      
  188.      DART: Uses the DART sound system in OS/2. It should work with an
  189.      out-of-the-box Warp 4 or Warp 3 with the DART DLLs (available from
  190.      hobbes.nmsu.edu).
  191.      
  192.      MMOS/2: Uses the basic MMOS/2 for sound. Sometimes works more
  193.      reliably than DART. Might be even faster on some systems. Select the
  194.      sound system which suits best for you.
  195.      
  196.      8-bit audio: Plays the music with 8 bits instead of 16 bits. Use
  197.      this if you have an old 8-bit sound card.
  198.      
  199.      Behaviour
  200.      
  201.      Start playing on file load: Starts playing automatically when you
  202.      drop a file or load a file from PM123.
  203.      
  204.      Auto 'use playlist' on add: Automatically uses the playlist when you
  205.      add files to it.
  206.      
  207.      Sound quality
  208.      
  209.      Mix both channels (mono): Mixes the left and right channel into one
  210.      channel and uses mono playback. Drops the CPU usage dramatically.
  211.      Good for 486DX100 or Pentium-75 owners.
  212.      
  213.      Downmix 44kHz to 22kHz: Decodes only every second sample and plays
  214.      the song at 22kHz. Combined with mono mode you can play Layer 3
  215.      streams on a 486DX2!
  216.      
  217.      Sound device
  218.      
  219.      Select the sound device to use for playback from the drop down list.
  220.      
  221.      Sound device is shared: Opens the sound device in shared mode. It
  222.      means that if your driver supports it, you can, for example, listen
  223.      to a MPEG-audio stream and hear system sounds at the same time! Not
  224.      many drivers support this (at least Gravis Ultrasound "Next
  225.      Generation" drivers support this).
  226.      
  227.    
  228.    ID3 tags
  229.      _________________________________________________________________
  230.    
  231.      ID3 tags is a method of storing song information inside a MPEG-audio
  232.      stream. The information resides at the end of the song. You can
  233.      browse thru a files information by clicking on the file name in the
  234.      main window.
  235.      
  236.      PM123 comes with a built-in ID3 tag editor (accessed from the
  237.      playlist window).
  238.      
  239.    
  240.    Non obvious features
  241.      _________________________________________________________________
  242.    
  243.      * Drag'n'drop: You can practically drop anything over the main
  244.        window and playlist. Try dropping MPEG-audio files or playlists on
  245.        the main window or the playlist (or a color from the System
  246.        Palette).
  247.      * Main window filename: Click on it to browse ID3 tag entries.
  248.        
  249.    
  250.    Authors, reporting bugs, obtaining latest version, etc.
  251.      _________________________________________________________________
  252.    
  253.      Authors
  254.      
  255.      Original MPEG-audio decoder was done by Michael Hipp, the OS/2 port
  256.      of the decoder (mpg123 and mpg123.dll) was done by Samuel Audet
  257.      and the GUI (Graphical User Interface) for OS/2 PM was done
  258.      by Taneli Leppä.
  259.      
  260.      Bug reporting
  261.      
  262.      If you think you've found a bug or a problem inside the program,
  263.      please FIRST check the list of known bugs. If your bug isn't
  264.      mentioned there, then you can use this bug report form.
  265.      
  266.      Obtaining the latest version
  267.      
  268.      Latest version can be found from the PM123 home page (mirror). New
  269.      betas are also uploaded to hobbes.nmsu.edu and ftp.leo.org.
  270.      
  271.    
  272.      _________________________________________________________________
  273.    
  274.