Changeset 17 for branches/v2.9/mediafolder

Timestamp:

Jul 19, 2020, 10:11:27 PM (5 years ago)

Author:

Lewis Rosenthal

Message:

Update main help (formatting).
Refactor Media folder help.

File:

• branches/v2.9/mediafolder/Help/mediafldr.ipf (modified) (1 diff)

branches/v2.9/mediafolder/Help/mediafldr.ipf

@@ -5 +5 @@
 :title.Help for Media Folder distribution 
 
-:h1 res=100.Help for Media Player
-:p.
-This object is a Media-Folder. Put any audio file into it
-for playing. Specify the order of the tracks using drag and drop.
-The usual play controls are available like play, stop or volume.
-:p.
-More information and updates:
-:p.
-:link reftype=launch
-object='netscape.exe'
-data='http://www.os2world.com/cdwriting'.
-http&colon.//www.os2world.com/cdwriting:elink.
-.br
-:link reftype=launch
-object='netscape.exe'
-data='http://www.geocities.com/SiliconValley/Sector/5785/'.
-http&colon.//www.geocities.com/SiliconValley/Sector/5785/:elink.
-:p.
+.* ----------------------------------------------------------------------------
+:h1 res=100.Media player
+:p.This object is a Media folder. Drag one or more audio files into it for
+playing. To reorder, ensure that :hp1.Always maintain sort order:ehp1. option on
+the :hp2.Sort:ehp2. submenu is deselected, as well as any other sort options
+which might affect manual ordering, and drag and drop the tracks as desired.
+
+:p.Use the buttons to control playback. The Repeat checkbox will cause the
+currently selected track to continuously replay. The Random checkbox will select
+tracks arbitrarily, unless the Repeat checkbox has been set.
+
+:p.More information and updates&colon.
+
+:p.https&colon.//trac.netlabs.org/cwmmclasses/wiki
+
 :nt.
-:p.
-For playing of MP3 files you need the MMIOMP3 procedure written
-by Russell O'Connor.
-:p.
-Get it from
-:p.
-:link reftype=launch
-object='netscape.exe'
-data='http://www.math.berkeley.edu/~roconnor/'.
-http&colon.//www.math.berkeley.edu/~roconnor/:elink.
+A suitable MP3 MMIOProc is required in order to play MP3 files, as is a suitable
+MMIOProc for Ogg (Vorbis and FLAC) files. These are included in the MMAudio Pak
+2, available from&colon.
+
+:p.http&colon.//r6.ca/MMAudioPak/
+
+:p.(Ogg formats are supported by default in ArcaOS 5.x and above.)
 :ent.
-:p.
-:hp2.Keyboard control:ehp2.
-:p.
-Use the following keys to control the media folder. The buttons in the upper part
-of the folder must have the focus when using the keys. Use :hp2.TAB:ehp2. to switch
-the focus from the container to the buttons.
-:p.
-:ul.
-:li.:hp8.B:ehp8.ack
-:li.:hp8.S:ehp8.top
-:li.:hp8.P:ehp8.ause
-:li.P:hp8.l:ehp8.ay
-:li.:hp8.N:ehp8.ext
-:li.:hp8.R:ehp8.epeat
+
+:p.:hp2.Keyboard control:ehp2.
+
+:p.Use the following keys to control the Media folder. The buttons in the upper
+part of the folder must have focus when using these keys. Use
+:hp2.&lt.Tab&gt.:ehp2. to switch the focus from the container to the buttons.
+
+:ul compact.
+:li.:hp2.B:ehp2.ack
+:li.:hp2.S:ehp2.top
+:li.:hp2.P:ehp2.ause
+:li.P:hp2.l:ehp2.ay
+:li.:hp2.N:ehp2.ext
+:li.:hp2.R:ehp2.epeat
+:li.R:hp2.a:ehp2.ndom
 :eul.
 
-:h1 res=200.Help for CD-Player
-:p.
-This object is a CD player with FreeDB support. Tracktitles and other information
-are queried from a FreeDB server if an internet connection is available. 
-:p.
-More information and updates:
-:p.
-:link reftype=launch
-object='netscape.exe'
-data='http://www.os2world.com/cdwriting'.
-http&colon.//www.os2world.com/cdwriting:elink.
-.br
-:link reftype=launch
-object='netscape.exe'
-data='http://www.geocities.com/SiliconValley/Sector/5785/'.
-http&colon.//www.geocities.com/SiliconValley/Sector/5785/:elink.
-:p.
+:p.:hp2.Track position slider:ehp2.
+
+:p.To the right of the player buttons is the Track position slider. Drag the
+slider forward or back to reposition the playback point of the current file.
+
+.* ----------------------------------------------------------------------------
+:h1 res=200.CD player
+:p.This object is a CD player with CDDB support. Track titles and other metadata
+are queried from a configured FreeDB-compatible server if an internet connection
+is available.
+
+:p.More information and updates&colon.
+
+:p.https&colon.//trac.netlabs.org/cwmmclasses/wiki
+
 :nt.
-To use FreeDB servers you have to install the appropriate package and you must
-specify an email address. Use the configuration object to do so.
+Most CDDB servers follow the FreeDB practice of requiring a valid email address
+for access. Use the FreeDB Client configuration object in the Multimedia folder
+to set this.
 :ent.
-:p.
-:hp2.Keyboard control:ehp2.
-:p.
-Use the following keys to control the player. The buttons in the upper part
-of the window must have the focus when using the keys. Use :hp2.TAB:ehp2. to switch
-the focus from the container to the buttons.
-:p.
-:ul.
-:li.:hp8.B:ehp8.ack
-:li.:hp8.S:ehp8.top
-:li.:hp8.P:ehp8.ause
-:li.P:hp8.l:ehp8.ay
-:li.:hp8.N:ehp8.ext
-:li.:hp8.R:ehp8.epeat
+
+:p.:hp2.Keyboard control:ehp2.
+
+:p.Use the following keys to control the CD Player. The buttons in the upper
+part of the player must have focus when using these keys. Use
+:hp2.&lt.Tab&gt.:ehp2. to switch the focus from the container to the buttons.
+
+:ul compact.
+:li.:hp2.B:ehp2.ack
+:li.:hp2.S:ehp2.top
+:li.:hp2.P:ehp2.ause
+:li.P:hp2.l:ehp2.ay
+:li.:hp2.N:ehp2.ext
+:li.:hp2.R:ehp2.epeat
 :eul.
 
-:h1 res=300.Help for playlist editor
-:p.
-Use the playlist editor to create or modify M3U playlists. These playlists
-are for example used by portable MP3 players. Such a playlist file is a text file
-containing the filenames of every track to be played.
-:p.
-Weitere Informationen und Updates:
-:p.
-:link reftype=launch
-object='netscape.exe'
-data='http://www.os2world.com/cdwriting'.
-http&colon.//www.os2world.com/cdwriting:elink.
-.br
-:link reftype=launch
-object='netscape.exe'
-data='http://www.geocities.com/SiliconValley/Sector/5785/'.
-http&colon.//www.geocities.com/SiliconValley/Sector/5785/:elink.
+:p.:hp2.Track position slider:ehp2.
 
+:p.To the right of the player buttons is the Track position slider. Drag the
+slider forward or back to reposition the playback point of the current track.
+
+.* ----------------------------------------------------------------------------
+:h1 res=300.Playlist editor
+:p.Use the Playlist editor to modify M3U playlists. An M3U playlist is a text
+file which contains paths (URLs) to the tracks it references.
+
+:p.M3U (Moving Picture Experts Group Audio Layer 3 Uniform Resource Locator) is
+a :hp1.de facto:ehp1. standard, generally recognized by most MP3 players.
+
+:p.To add tracks, simply drag and drop them into the editor. To reorder, ensure
+that :hp1.Always maintain sort order:ehp1. option on the :hp2.Sort:ehp2. submenu
+is deselected, as well as any other sort options which might affect manual
+ordering, and drag and drop the tracks as desired. Save the playlist by
+selecting :hp2.File | Save:ehp2. from the menu.
+
+:p.To create a new playlist, drag the M3U playlist template from the Multimedia
+Templates folder to a suitable location on the desktop.
+
+:p.More information and updates&colon.
+
+:p.https&colon.//trac.netlabs.org/cwmmclasses/wiki
 
 :euserdoc.
-