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

:userdoc.

: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.
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.

.* ----------------------------------------------------------------------------
: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.

.* ----------------------------------------------------------------------------
: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.
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.

.* ----------------------------------------------------------------------------
: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.

.* ----------------------------------------------------------------------------
: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.