Changeset 91 for branches/v2.9_Lars/mediafolder/Help/mediafldr.ipf

Timestamp:

Oct 1, 2023, 4:30:02 PM (23 months ago)

Author:

erdmann

Message:

merging v2.9 into v2.9_Lars branch, in particular, this means adding french,spanish,russian translations

Location:

branches/v2.9_Lars

Files:

• . (modified) (1 prop)
• mediafolder/Help/mediafldr.ipf (modified) (1 diff)

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

@@ -1 +1 @@
 :userdoc.
 
-:docprof.
-
-: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.
+:docprof toc=123456.
+
+:title.Help for Media Folder distribution
+
+.* ----------------------------------------------------------------------------
+:h1 res=100 name=mplayer
+    x=left y=bottom width=100% height=100%.Media player
+
+This object is a Media folder. Drag one or more audio files into it for
+playing. To reorder, ensure that View | Sort > Always maintain sort order option
+is deselected, as well as any other sort options which might affect manual
+ordering, and drag and drop tracks into the folder as desired.
+
+:p.Use the buttons or :link reftype=hd refid=mkeyboard.Keyboard:elink. 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
+
+.* ----------------------------------------------------------------------------
+:h2 res=110 name=mview
+    x=left y=bottom width=100% height=100%.View options
+
+By default, Media folders are displayed in Details view, listing track-
+specific details for each file or object which has been added to the main
+folder.
+
+:p.To switch to Compact view, select View | Compact from the main menu. In this
+mode, the folder content is hidden, however,
+:link reftype=hd refid=mlaunchpad.Launchpad:elink. buttons will be visible.
+
+:note text='Tip:'.Select files to play contiguously, reordering folder content
+if necessary, click :hp2.Play:ehp2., and then change the view to Compact.
+
+.* ----------------------------------------------------------------------------
+:h2 res=120 name=mkeyboard
+    x=left y=bottom width=100% height=100%.Keyboard control
+
+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.
+.* ----------------------------------------------------------------------------
+:h2 res=130 name=mvolume
+    x=left y=bottom width=100% height=100%.Volume slider
+
+Below the player buttons is the Volume slider. This controls the volume level
+for playback, within the limits set by the Master volume control for the system.
+
+.* ----------------------------------------------------------------------------
+:h2 res=140 name=mtrackpos
+    x=left y=bottom width=100% height=100%.Track position slider
+
+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.
+
+.* ----------------------------------------------------------------------------
+:h2 res=150 name=mlaunchpad
+    x=left y=bottom width=100% height=100%.Launchpad
+
+Toward the lower left of the player folder is a square box. Drag and drop a
+media file on the Launchpad to add it to the palette. The filename is displayed
+in the button's tooltip. Drag and drop additional files in between existing
+items in the Launchpad or to the right of the last item. Click any one of these
+to begin playing it.
+
+:p.The Launchpad is common across all Media, CD player, and M3U playlist
+folders.
+
+:note.When play is started in this manner, the
+:link reftype=hd refid=mtrackpos.Track position slider:elink. does not reflect
+the current playback state, and the player buttons do not control playback. Use
+the button's context menu to control playback, instead.
+
+:warning.While it is possible to add MP3, Ogg, and other digital media files to
+the Launchpad, do not add CD tracks here. CD tracks will not be playable from
+the Launchpad.
+
+.* ----------------------------------------------------------------------------
+:h1 res=200 name=cplayer
+    x=left y=bottom width=100% height=100%.CD player
+
+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
+
+.* ----------------------------------------------------------------------------
+:h2 res=210 name=cview
+    x=left y=bottom width=100% height=100%.View options
+
+By default, the CD player is displayed in Details view, listing details for each
+track on the mounted disc.
+
+:p.To switch to Compact view, select View | Compact from the main menu. In this
+mode, the folder content is hidden, however,
+:link reftype=hd refid=claunchpad.Launchpad:elink. buttons will be visible.
+
+:note text='Tip:'.Select the first track to be played, click :hp2.Play:ehp2., and
+then change the view to Compact.
+
+.* ----------------------------------------------------------------------------
+:h2 res=220 name=ckeyboard
+    x=left y=bottom width=100% height=100%.Keyboard control
+
+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.
-
+.* ----------------------------------------------------------------------------
+:h2 res=230 name=cvolume
+    x=left y=bottom width=100% height=100%.Volume slider
+
+Below the player buttons is the Volume slider. This controls the volume level
+for playback, within the limits set by the Master volume control for the system.
+
+.* ----------------------------------------------------------------------------
+:h2 res=240 name=ctrackpos
+    x=left y=bottom width=100% height=100%.Track position slider
+
+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.
+
+.* ----------------------------------------------------------------------------
+:h2 res=250 name=claunchpad
+    x=left y=bottom width=100% height=100%.Launchpad
+
+Toward the lower left of the player folder is a square box. Drag and drop a
+media file on the Launchpad to add it to the palette. The filename is displayed
+in the button's tooltip. Drag and drop additional files in between existing
+items in the Launchpad or to the right of the last item. Click any one of these
+to begin playing it.
+
+:p.The Launchpad is common across all Media, CD player, and M3U playlist
+folders.
+
+:note.When play is started in this manner, the
+:link reftype=hd refid=mtrackpos.Track position slider:elink. does not reflect
+the current playback state, and the player buttons do not control playback. Use
+the button's context menu to control playback, instead.
+
+:warning.While it is possible to add MP3, Ogg, and other digital media files to
+the Launchpad, do not add CD tracks here. CD tracks will not be playable from
+the Launchpad.
+
+.* ----------------------------------------------------------------------------
+:h1 res=300 name=peditor
+    x=left y=bottom width=100% height=100%.Playlist editor
+
+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
+
+.* ----------------------------------------------------------------------------
+:h2 res=350 name=plaunchpad
+    x=left y=bottom width=100% height=100%.Launchpad
+
+Toward the lower left of the M3U playlist editor is a square box. Drag and drop
+a media file on the Launchpad to add it to the palette. The filename is
+displayed in the button's tooltip. Drag and drop additional files in between
+existing items in the Launchpad or to the right of the last item. Click any one
+of these to begin playing it.
+
+:p.The Launchpad is common across all Media, CD player, and M3U playlist
+folders.
+
+:note.Use the button's context menu to control playback.
+
+:warning.While it is possible to add MP3, Ogg, and other digital media files to
+the Launchpad, do not add CD tracks here. CD tracks will not be playable from
+the Launchpad.
 
 :euserdoc.
-