@DATABASE NEWGUIDE

@REMARK Edited with Guided by Linus McCabe


@NODE "Main" "Main"

@{JCENTER}- WELCOME TO V.2.4 of PLAYGUI -

programmiert von Richard KAPP in GUI4CLI

February 2000

@{JLEFT}                                            
@{JCENTER}THE LINKS



@{"Was ist das?/Features" LINK "1"}

@{"Was brauche ich?" LINK "2"}

@{"Benutzung/Installation" LINK "3"}

@{"Ich möchte etwas für PlayGUI raufladen!" LINK "Upload"}



@{"Copyright/Kontakt" LINK "4"}

@{"Was ist GUI4CLI?" LINK "5"}
@{JLEFT}


@{JCENTER} NEUE VERSION VON HIPPOPLAYER IM AMINET. V.2.45!
@ENDNODE
@NODE "1" "What is it? Features!"

Was ist das? Und welche Features hat es?
----------------------------------------

Es gibt viele tolle Player im Aminet mit wunderschönen Skins aber das sind alles
MP2/3 Player. Ich wollte immer einen Module und Sample Player in dieser Art. 
Daher hatte ich beschlossen, mit Hilfe von GUI4CLI so einen Player zu machen. 
PlayGUI ist eine Art GUI(Oberflächen)-Ersatz für Play16 and HIPPO-Player
- hat aber ganz besondere Features, wie....

THE FEATURES:

+ Man kann coole Skins verwenden (wie AmigaAMP) oder eigene zeichnen.

+ 4 Skins sind schon dabei 

+ Man kann Skins übers Menü wechseln

+ PlayGUI spielt Mods (DBPro, Med, Mod, XM, S3M, Mpg, etc)

+ PlayGUI spielt Samples (Wave, AIFF, 8SVX etc.)

+ PlayGUI hat eine Kommentar Funktion 
   (Damit man Kommentare zu einem Module als Text speichern kann)

+ PlayGUI hat eine Launch-Option, mit der man andere Programme starten kann

+ PlayGUI unterstützt Drag and Drop 
(Man braucht ein Modul nur auf den Amp ziehen)

+ PlayGUI zeigt Lautstärke, Module-Art, Sound-Qualität etc im Display an

+ Man kann die Sound-Qualität übers Menü wechseln 
(8bit, 14bit, 16bit oder eine user config)

+ Shortcuts für alle Funktionen

+ 'Mute' option

+ Öffnet system-freundlich auf der WB



NEU seit V.2.3
---------------
+ 3D Box um das Skin

+ Neues Display (schwarz&weiß)

+ Iconify-Option

+ Graphische Änderungen (Lautstärkeregler)

+ Bug fixes 

+ Kommentar-Fenster hat nun Menüs

+ Centered Text

+ PlugIn Menü für PlayGUI PlugIns

+ Bessere 'Mute' Funktion (aus/an)

 
@ENDNODE
@NODE "2" "Requirements"
----------------
Was brauche ich?
----------------

Man braucht:

- Einen AGA or CGX Amiga mit modernem OS & HD

- Neueste Version von GUI4CLI (und GUI) (ist dabei!)

- ASL.library (für die File-requester)

- XHelvetica.font und Topaz_thin.font im Fonts: directory 
  (Zu finden im'fonts' dir von PlayGUI)

- AREXX gestartet (Einfach Arexx in die WB-StartUp ziehen) 

- Copy, delete, run im C: Verzeichnis.

- Richtig konfigurierten Hippoplayer

- Play16

Empfohlen:

- Eine 800x600 Auflösung oder höher

- Graphikkarte für eine bessere Farbanpassung der Skins


Das sollte alles sein...
 
@ENDNODE
@NODE "3" "Usage"
@{JCENTER}BITTE ALLES LESEN!!!
@{JLEFT}
 

@{JCENTER}BENUTZUNG/INSTALLATION



@{JLEFT}
@{JCENTER}
@{"INSTALLATION" LINK "Install"}

@{"TOOLTYPES" LINK "ToolTypes"} 

@{"ABSPIEL OPTIONEN" LINK "Play"}

@{"SOUND OPTIONEN" LINK "Sound"}

@{"KOMMENTAR" LINK "Comment"}

@{"SKINS" LINK "Skins"}

@{"LAUNCHING" LINK "Launch"}

@{"PLUGINS" LINK "PlugIn"}

Ein neues Feature von PlayGUI

@{"TIPS & TRICKS" LINK "Tips"}







@{JLEFT}



@ENDNODE
@NODE "Install" "Install"

INSTALLATION
-------------

- Das alte Verzeichnis von PlayGUI löschen

- Das ganze Verzeichnis 'PlayGUI' irgendwo hinkopieren , aber NICHT 
die NAMEN umbennen! (Weder von PlayGUI-Ordner noch von den Files)

- Die Fonts vom PlayGUI:fonts Verzeichnis in das SYS:fonts Verzeichnis
  kopieren. 

- AREXX muß aktiv sein! (Kopiere SYS:System/RexxMast in WBStartup)

Danach einfach PlayGUI starten! 

Aber ich schlage vor, sich zuerst die @{"tooltypes" LINK "Tooltypes"} anzusehen.

@ENDNODE
@NODE "ToolTypes" "ToolTypes"

---------------
TOOLTYPES/PREFS
---------------
Es gibt 6 Tooltypes Optionen um den Pfad von Hippo, Play16, skins, modules, samples und
das Verzeichnis, um Programme zu starten (Launch), festzulegen.

Das ist die richtige Reihenfolge:

MODPATH=Hier das Verzeichnis, wo sich deine mods befinden, eintragen. 
(z.B. MODPATH=DH1:music/mods/ )

SAMPLEPATH= Dasselbe wie bei den mods, aber diesmal für deine Samples.

HIPPOPATH=Der Pfad, wo du Hippoplayer hast (z.B. HIPPOPATH=DH0:Music/Player/Hip)

PLAY16PATH=Der Pfad für Play16

SKINSELECT=Einfach den Namen des Skins eintragen (i.e.SKINSELECT=BlueAMP)

LAUNCHPATH=Pfad für deine Lieblingsprogramme eintragen

Siehe auch:
@{"Skins" LINK "Skins"}


Bitte beachten, daß die Namen der Tooltypes nicht geändert werden dürfen!
MODPATH muß MODPATH heißen etc. 

Nicht z.B. MODPATH auf MPATH umbennen.

NUR DIE PFADE dürfen geändert werden! 

In Zukunft könnte es jederzeit neue Tooltypes für @{"PlugIns" LINK "PlugIn"}.
geben. Diesmal gibt's ein PlugIn für 'Plone. Plone ist ein Playlist-Addon für
PlayGUI und ist von Rolf Roth programmiert worden.

Einfach den Pfad eintragen, wo du 'Plone' installiert hast.

Beispiel:PLONEPATH=DH0:Music/Plone/

In Zukunft (wenn es andere PlugIns geben sollte), wird es vielleicht
dafür neue tooltypes geben....

Also: Immer Ausschau halten!
@ENDNODE
@NODE "Play" "Playing Options"
-----------------
PLAYING - OPTIONS
-----------------

Wenn du PlayGUI gestartet hast, präsentiert sich dir ein nettes Skin (vor allem
dann, wenn du viele Farben auf deiner WB hast) und auf dem Skin befinden sich 
einige Knöpfe.

PlayGUI ist in zwei Sektionen unterteilt. Die erste ist um Module abzuspielen,
die zweite, um Samples zu spielen.  Wenn du die Maus über einen Knopf hast,
erscheint ein kleiner Hinweis auf der WB-Menü Leiste. Es sollte also einfach
sein, herauszufinden, welcher Knopf für was gut ist. 

-------------
DRAG and DROP
-------------

Seit V.1.6, kann man ganz einfach Module auf den Amp ziehen und sie werden sofort
abgespielt.

-------------------
SHORTCUTS and MENUS
-------------------

Jede Funktion von PlayGUI ist auch im Menü vertreten und kann auch
über Shortcuts (Tastenkombination) aktiviert werden. 

----
MUTE
----

Es gibt auch eine 'mute' Funktion, die man ein oder aus
schalten kann, indem man AMIGA+M drückt.(Oder über das Menü
auswählt) Im Display wird angezeigt, ob Mute an ist oder aus.

-----------
THE DISPLAY
-----------

Im Display wird alles mögliche angezeigt. Der Name des mods,
die Art des Mods (XM, MMD, DBM, S3M etc), die Lautstärke,
die Sound Qualität, das gewählte Skin etc...




@{"Zurück zu BENUTZUNG/INSTALLATION" LINK "3"}
@ENDNODE
@NODE "Sound" "Sound Quality"
-------------
SOUND QUALITY
-------------
Wenn du die rechte Maustaste drückst, wrist du ein Menü finden,
namens 'SOUND'.
Hier kann man auswählen, welche Sound Qualität man möchte:

8bit, 14bit, AHI oder eine USER Definition

SEI GEWARNT! Wenn man eine von diesen auswählt, werden die HippoPlayer.prefs in 
deinem S: Verzeichnis gelöscht. Statt dieser Configuration, kopiert PlayGUI die
ausgewählten Prefs an dessen Stelle. (ins S: Verzeichnis)

Zum Beispiel: Wenn du 8bit auswählst, werden die Hippoplayer.prefs vom 
Verzeichnis 

PlayGUI:SoundPrefs/8bit/HippoPlayer.prefs

in das S: Verzeichnis kopiert. Dadurch werden deine alten Einstellungen
von HippoPlayer ersetzt.

Daher ist es ratsam, sich eine Kopie der HippoPlayer.prefs zu machen und sie
dann in das Verzeichnis

PlayGUI:SoundPrefs/User/ 

zu kopieren.

Immer, wenn du dann USER vom Soundquality-Menü auswählst, werden deine
alten HippoPlayer-Einstellungen benutzt.

Damit die Sound Qualität auch aktiviert wird, muß man zuerst den
STOP Knopf und dann PLAY drücken.

Zum Beispiel: Du hast ein Module, das in 14bit Qualität gemacht wurde.

Was du dann tun mußt, um es auch in 14Bit zu hören:

- 14bit vom SOUND-Menü auswählen
- Stopp drücken 
- Modul aussuchen und auf Play drücken 
  (Wenn du schon ein Modul geladen hast, brauchst du natürlich kein
   neues auswählen sondern nur (nachdem du zuerst auf Stop gedrückt 
   hast) auf Play drücken!)

NEU!!

Es gibt jetzt neue und alte Einstellungen im SoundQuality-Verzeichnis.
Die neuen sind für die neue Version von hippoplayer v.2.45 (10.1.2000). 
Hol sie dir vom Aminet!! 
@ENDNODE
@NODE "Comment" "Commentary"
---------
KOMMENTAR
---------

Es gibt einen Button ganz rechts oben, namens Commentary. Meine Idee war, daß
es nett wäre, ein Kommentar über ein Modul zu schreiben. (Länge, Zeit, Autor
etc, vielleicht sogar ein Gedicht, das gut zu dem Modul paßt....)
Nun, kein Problem. Einfach auf den button Commentary klicken und es öffnet sich
ein Fenster, das aussieht, wie eine Ringmappe, indem du deine Kommentare zu dem
aktuellen Modul eintragen kannst.

Load - Kommentar über ein Mod laden

Save - Den aktuellen Text woanders hinspeichern.

Clear - Text löschen

Edit - Hier ruft PlayGUI einen Editor auf (z.B ed oder Golded), welcher sich im
       C:Verzeichnis mit dem Namen ed befinden muß). Außerdem wird eine Vorlage
       geladen, die sich im SYS-Ordner von PlayGUI befindet und jederzeit ver-
       ändert werden kann. Dann einfach die Infos über das mod ausfüllen und es
       (am besten unter den selben Namen, wie das Mod mit der Endung .txt
       o.ä. in irgendein Verzeichnis speichern)

Help - Kleiner Hilfe-Requester

(Falls du komische Textzeichen im Info-Fenster sehen solltest, keine Panik! Wenn
das passiert, war noch irgendetwas im Clipboard, vielleicht durch etwas, was
zuvor markiert wurde und ins Clipboard abgelegt. In so einen Fall einfach auf
Clear klicken!)
@ENDNODE
@NODE "Skins" "Skins"
----------
THE SKINS
----------
Beim Programmstart sucht PlayGUI im Skin-Verzeichnis die Files:
main.iff, option_bar, mod_bar, sample_bar and volume_bar..
Das bedeutet, daß PlayGUI 5 Skin Elemente benötigt.

Diese Daten MÜSSEN sich im selben Ordner befinden, wie das Skin, das du
in den TOOLTYPES eingetragen hast. Siehe @{"ToolTypes" LINK "Tooltypes"}!

Schau einfach mal in den Ordner PlayGUI:Skins/ rein. Dort findest du all diese
Skin Elemente (brushes). Zum Beispiel, BlueAMP.
Wenn du bei der WB auf 'Alle anzeigen' gehst,  wirst du alle benötigten Files
sehen, wie main.iff, option_bar, etc.

4 Skins sind schon bei PlayGUI dabei. Einfach ausprobieren!

Wenn du ein Skin wechseln möchtest, drücke den rechten Mausknopf. Im Menü 'OPTIONS' 
findest du den Eintrag 'Select new skin'. Ein Filerequester erscheint, indem man
einfach das Verzeichnis des Skins, indem sich die Skin Elemente befinden, auswählt.

Zum Beispiel, wenn du das Skin 'BlueAMP' möchtest, brauchst du nur in den ordner 
'BlueAMP' hineinzuklicken und auf ok klicken. 

NEU:Wenn PlayGUI ein Skin nicht findet, weil es in den Tooltypes falsch eingetragen 
ist, wird PlayGUI ein Default-Skin laden.(Danke hier an Rolf Roth für diese Feature)

Wenn du deine eigenen Skins zeichnen möchtest, schau einfach mal ins Verzeichnis
'SkinTemplate'. Hier findest du alle möglichen Vorlagen um selbst ein Skin zu
gestalten. Einfach die Templates in Lieblings-Malprogramm einladen und loszeichnen.:)
Aber nicht vergessen, deine Meisterwerke ins Aminet raufzuladen! (mus/play) :)

PS: Es gibt schon recht viele Skins für PlayGUI im Aminet. Dank den Leuten, die sie
gemacht haben, wie Rolf Roth oder Krister S. Skrtic.. ;)

AUSSERDEM IST EIN BESUCH DER OFFICIAL PLAYGUI WEBSITE SEHR EMPFEHLENSWERT

http://playgui.cxa.de

gemacht von Rolf Roth! (Danke, Rolf!;)

Dort gibt's auch die neuesten Versionen von
PlayGUI und Plone und natürlich auch viele
Skins! Also: Mal vorbeischauen!!
 
@ENDNODE
@NODE "Launch" "Launch"
-----------------
THE LAUNCH BUTTON
-----------------

Mit dieser Funktion kann man schnell irgendein Programm starten.
Z.B.:Irgendein Samplebearbeitungsprogramm, oder was anderes....
@ENDNODE
@NODE "PlugIn" "PlugIns"
-------
PlugIns
-------

Im Menü findest du einen Eintrag, namens 'PlugIn'.
Hier stehen alle PlugIns drinnen, die man von PlayGUI
aus aufrufen kann. 

---------
BENUTZUNG
---------

Um ein PlugIn für PlayGUI zu starten, einfach den rechten
Mausknopf drücken und vom Menü 'PlugIn' das PlugIn, das man
starten möchte aufrufen.
PlayGUI wird das PlugIn starten, wenn der richtige
Pfad dafür in den Tooltypes angegeben wurde.
 
Siehe auch: @{"tooltypes" LINK "ToolTypes"}...

-----
PLONE
-----

Dank Rolf Roth, gibt es schon ein PlugIn im Aminet. 
Es heißt 'Plone' und ist eine PlayList mit der man 
alle heigeliebten mods editieren kann, indem man dem 
Namen des Autor oder Kommentare, wie z.B. die Länge 
des Liedes oder irgendetwas anderes, einträgt.. Man 
kann auch die PlayList nach verschiedenen Kategorien 
sortieren lassen.

Natürlich kann man auch mods von der PlayList aus
starten oder an PlayGUI schicken, um sie abzuspielen. 
Aber Plone bietet noch viel mehr - also runterladen!

Wenn auch du ein PlugIn für PlayGUI geschrieben hast,
setze dich mit zuerst mit @{"mir" LINK "4"} in Verbindung, 
damit ich das neue PlugIn in PlayGUIs Menü einbinden kann.
@ENDNODE
@NODE "Tips" "Tips & Tricks"
-------------
TIPS & TRICKS
-------------

Wenn PlayGUI gestartet wird, öffnet es sich immer unter der Mausezeiger Position. 
Um genauer zu sein, dein Mauszeiger wird exakt unter dem Knopf befinden, von dem
man ein neues mod auswählen kann. Ein nettes Feature für faule Leute, wie für
mich:)




@ENDNODE
@NODE "Upload" "Upload"
---------
UPLOADING
---------

Wenn du etwas für PlayGUI ins Aminet/Internet raufladen möchtest, ist es
gestattet, alles im Ordner 'SYS' mit der Ausnahme des Files 'start.iff' zu 
ändern. Dort befinden sich der Start-und der Quitsound, das Template und 
das skin für das 'Commentary'-window.

Wenn du ein cooles Skin für das commentary/ coole Sounds hast und
den SYS-Ordner dementsprechend verändert hast, kannst du es gerne
ins Aminet (mus/play) raufladen und das Archive 'PGSYSAddOn' oder 
so ähnlich nennen. Aber bitte dabei zu beachten, das Haupt-Archiv
von 'PlayGUI' und die Installation und Anwendung deines AddOns
asuführlich zu erklären.

Falls du eine neue Version von PlayGUI, ein neues Script, das
PlayGUI ersetzt, geschrieben haben solltest, es ist nicht erlaubt,
es ohne mein Wissen raufzuladen! Da ich der Schöpfer von PlayGUI 
bin und daher auch das Copyright habe, wünsche ich der Haupt-Entwickler
von PlayGUI zu bleiben. PlayGUI ist NICHT Open Source! 

Wenn du neue Features möchtest oder eine deutsche Übersetzung von PlayGUI 
etc, brauchst du mich nur zu e-mailen:

narr.cybersdorf@gmx.net

Richard  
@ENDNODE
@NODE "4" "Copyright etc..."
-----------------
COPYRIGHTS, ETC.
-----------------

Dieses Programm unterliegt dem Copyright von Richard KAPP 
Nov 1999 -February 2000 und ist SKINWARE!

Ich übernehme keine Garantie für PlayGUI! Ihr benützt es auf
eigenes Risiko. 

Was ist SKINWARE? Nun, Ich hätte gerne, daß ihr ein cooles Skin für 
PlayGUI zeichnet (muß jetzt nicht übertrieben toll sein! So gut ihr 
es halt könnt;) und es ins Aminet raufzuladen!!! Bei der Beschreibung
(ReadME) sollte PlayGUI erwähnt werden. 

Wenn du Vorschläge hast oder Fehler findest....

Einfach eine mail schicken: 

narr.cybersdorf@gmx.net

Außerdem gibt es die 

OFFICIAL PLAYGUI WEBSITE

http://playgui.cxa.de

welche von Rolf Roth geführt wird.

Einfach mal vorbeischauen!

Wenn du jazz, funk, groove, experimental, rock mods,
magst, kannst du auch gerne mal mit PlayGUI eines
meiner Mods abspielen:

Such im Aminet unter R.Kapp.

--------------------
Want Music - GO KAPP
--------------------
@ENDNODE
@NODE "5" "GUI FOR CLI ?"
--------------------
WHAT IS GUI FOR CLI?
--------------------

This is one of the best FREEWARE-script-languages, I have seen! 
You can get from Aminet! Get it and do something! USE IT!

Thanx to D. Keletsekis for his huge effort!!
@ENDNODE
