@database MagicExpansion/ME_deutsch.guide

@Width 72

@Node Main "MagicExpansion/ME_deutsch.guide"

________________________________________________________________________

                             MagicExpansion

 Praktische Erweiterungen für das MagicUserInterface von Stefan Stuntz
                   und MagicWB von Martin Huttenloher

                         Version 1.1 (Mai 1994)

               Copyright © 1994 by Johannes (Jojo) Beigel

                             - Giftware -

¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

    @{" Einleitung        " Link "EINLEITUNG" }

    @{" Inhalt des Pakets " Link "INHALT" }

    @{" Installation      " Link "INSTALLATION" }

    @{" Rechtliches       " Link "RECHTLICHES" }

    @{" Danksagungen      " Link "DANKSAGUNGEN" }

@EndNode

@Node "EINLEITUNG" "ME_deutsch.guide/EINLEITUNG"
@Next "INHALT"
@Toc "Main"

Einleitung
~~~~~~~~~~
    ,MagicExpansion'  soll eine  Erweiterung für das  MagicUserInterface
(MUI)  von Stefan Stuntz und MagicWB von Martin Huttenloher sein.  Falls
Sie es noch nicht getan haben,  sollten Sie sich schnellstens bei beiden
Produkten registrieren.
    Dies ist die erste Version von  ,MagicExpansion'.   ,MagicExpansion'
ist Giftware,  daß heißt,  wenn Ihnen das Paket gefällt, sollten Sie mir
Geld [ :-) ] oder ein kleines Geschenk an folgende Adresse zuschicken:

    Johannes Beigel
    Fliederstr. 43a
    65396 Walluf
    GERMANY

    Wenn sich genügend  Leute für das Paket interessieren,   werden auch
noch weitere Versionen folgen.

@EndNode

@Node "INHALT" "ME_deutsch.guide/INHALT"
@Next "INSTALLATION"
@Prev "EINLEITUNG"
@Toc "Main"

Inhalt des Paketes
~~~~~~~~~~~~~~~~~~

 @{" Include-File         " Link "INCLUDEFILE" }
 
 @{" MUI-Image-Sets       " Link "IMAGESETS" }
 
 @{" Icons                " Link "ICONS" }
 
 @{" Farb-Paletten        " Link "FARBPALETTEN }
 
 @{" Hintergrund-Patterns " Link "PATTERNS" }
 
@EndNode

@Node "INCLUDEFILE" "ME_deutsch.guide/INHALT/INCLUDEFILE"
@Next "IMAGESETS"
@Toc "INHALT"

Das Include-File
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Das Include-File definiert ein paar brauchbare,  neue MUI-Makros für
kürzeren und schöneren Source-Code.

  - Neue Gadget-Typen: ...UInteger(), ...SInteger(), ...Note(),
      KeyPopupButton(), ...ToggleButton()
  
  - Neuer Label-Typ ...CLabel...() für zentrierte Labels
  
  - Neue Spacing-Makros: HBar, VBar, HBarFixed(), VBarFixed()
  
  - "Wt"-Version für manche Gadget-Makros (zusätzlicher Weight-
      Parameter)

    Wenn Sie die Integer-  oder Note-Gadget-Makros  aus dem Include-File
benutzen,  müssen folgende Zeilen  vor dem ersten Makro-Aufruf eingefügt
werden:

    TEXT acceptSNumbers[] = ACCEPTSNUMBERS; /* Für ...SInteger() */
    TEXT acceptUNumbers[] = ACCEPTUNUMBERS; /* Für ...UInteger() */
    TEXT acceptNotes[] = ACCEPTNOTES;       /* Für     ...Note() */

    Die  Zeilen  habe  ich  absichtlich  nicht ins  Include-File  selbst
eingefügt,   damit  man  es  z.B.  in  GST-Files   (beim SAS/C-Compiler)
aufnehmen kann.

@EndNode

@Node "IMAGESETS" "ME_deutsch.guide/INHALT/IMAGESETS"
@Next "ICONS"
@Prev "INCLUDEFILE"
@Toc "INHALT"

Die MUI-Image-Sets
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Das Paket beinhaltet 6 MUI-Image-Sets:
  
  - Jojo_Black_11pt

  - Jojo_Black_13pt

  - Jojo_3D_11pt

  - Jojo_3D_13pt

  - Jojo_Outline_11pt

  - Jojo_Outline_13pt
  
    Die Image-Sets  sollten mit einem  11-  oder  13-Pixel-Font  benutzt
werden.
    Das Image-Set  ,Jojo_Black_11pt'  beinhaltet Images für Pfeile, alle
Arten  von  Popup-Objects,   Checkmarks,   RadioButtons,  Cycle-Gadgets,
das Assign-Symbol,  das Network-Symbol  und das  TapePause-Symbol.   Die
anderen  Images wurden von den XEN-Sets  übernommen.   So können Sie die
XEN-Sets   komplett von der Festplatte  löschen,  falls Sie Platz sparen
wollen.
    Die anderen  Sets  beeinhalten  nur  die  Images,  die von  denen in
,Jojo_Black_11pt' abweichen.
    Außer den TapePause-,  Assign- und Network-Images, sehen alle Images
wie die  XEN-Buttons aus.   Das TapePause-Image besteht einfach aus zwei
vertikalen Strichen anstatt aus einem  (Ich habe mir jeden CD-Player und
Kassetten-Recorder im Haus angeschaut und überall ist ein  ,||' und kein
,|' auf den Pause-Schaltern).
    Damit die Image-Sets am besten aussehen, tun Sie folgendes (Wenn Sie
MagicWB benutzen müßten die ersten 3 Punkte schon eingestellt sein.):

  - Benutzen Sie einen Screen mit mindestens  8 Farben und einer Screen-
    Breite ähnlich der -Höhe (z.B. 640 x 512).

  - Benutzen Sie die  MagicWB-Palette   (oder eine ähnliche,  z.B.  eine
    Palette aus diesem Paket).

  - Benutzen Sie einen 11- oder 13-Pixel-Font für Screen-Text.

  - Starten Sie das MUI-Prefs-Programm.

  - Wählen Sie ,XEN Lo' oder ,XEN Hi' aus dem ,Edit/Presets'-Menü.

  - Ändern Sie die Images auf die Images in Jojo_Black.. bzw.  Jojo_3D..
    oder Jojo_Outline.. ab (Images-Seite).
  - Wenn  Sie MagicWB  nicht haben,    ändern Sie  die   Font-Namen  von
    ,XHelvetica' auf ,helvetica' (Fonts-Seite).

    Zusätzlich zu den Sets  existiert in  dem Paket  auch noch ein  sog.
MUI-Image-Construction-Kit: ein ILBM-Bild mit den MUI-Images aller Sets.
Diese Bild-Datei  können Sie als  Vorbild für  Ihre  eigenen  neuen MUI-
Images benutzen.

@EndNode

@Node "ICONS" "ME_deutsch.guide/INHALT/ICONS"
@Next "FARBPALETTEN"
@Prev "IMAGESETS"
@Toc "INHALT"

Die Icons
¯¯¯¯¯¯¯¯¯
    Ich habe versucht, die Icons so aussehen zu lassen, wie die Icons im
MagicWB-Paket.   Ich gebe zu,  daß meine Icons nicht so gut Aussehen wie
,richtige' MagicWB-Icons, aber vielleicht nimmt Martin Huttenloher meine
Icons zum Anlaß, entsprechende bessere Icons zu malen.
    Die meisten Icons habe ich gemalt,   weil ich den SAS/C(++)-Compiler
benutze,  und die Icons von SAS im normalen langweiligen  Commodore-Stil
gezeichnet sind.

    Im Paket enthalten ist ein ILBM-File mit verschieden neuen und alten
Icon-Templates (Wenn Sie nicht wissen was ein Icon-Template ist, schauen
Sie sich das Bild doch mal an :-) ).

@EndNode

@Node "FARBPALETTEN" "ME_deutsch.guide/INHALT/FARBPALETTEN"
@Next "PATTERNS"
@Prev "ICONS"
@Toc "INHALT"

Farb-Paletten
¯¯¯¯¯¯¯¯¯¯¯¯¯
    Die Farb-Paletten sollen Alternativen zur originalen MagicWB-Palette
sein.   Jede Palette liegt als ILBM-Datei  (OS 3.0 oder besser)  und als
,pre'-Datei  (OS 2.x)  vor.   Darum müssen  Sie sich  aber nicht  weiter
kümmern,   denn das Installations-Skript installiert schon die richtigen
Paletten.
    Die Paletten  ,OriginalPalette.ilbm' und  ,OriginalPalette.pre' sind
die originale MagicWB-Palette (Wer hätte das gedacht?).

@EndNode

@Node "PATTERNS" "ME_deutsch.guide/INHALT/PATTERNS"
@Prev "FARBPALETTEN"
@Toc "INHALT"

Hintergrund-Patterns
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Im Paket  befinden sich  ein paar neue  Hintergrund-Muster im  ILBM-
Format.   Die Muster benutzen die  originale  MagicWB-Palette und können
deshalb sofort von OS 2.0-Usern mit NickPrefs benutzt werden.

    Außerdem gibt es noch zwei   Hintergrund-Muster  für die  Workbench-
Windows  unter  OS 2.x.   Sie liegen  im  Format für  den   Prefs-Editor
,WBPattern' vor.

@EndNode

@Node "INSTALLATION" "ME_deutsch/INSTALLATION"
@Next "RECHTLICHES"
@Prev "INHALT"
@Toc "Main"

Installation
~~~~~~~~~~~~
    Doppelklicken   Sie  einfach  das  InstallMagicExpansion-Icon.   Zur
Installation wird der Commo-Installer benötigt, doch wenn Sie MUI haben,
haben Sie auch den Installer.
    Nun könne Sie auswählen,  was Sie installieren wollen und was nicht.
Wenn  Sie einmal  nicht weiterwissen,   schauen Sie  sich doch  mal  den
Hilfstext an.

    Die Icons werden  vom Script  nicht installiert,  denn ich  wußte ja
nicht, welche Icons Sie benutzen wollen und welche nicht.
    Sie müssen die Icons also ,von Hand' mit IconUpdate update-n. Bsp.:
    
    IconUpdate TCSWD MagicExpansion/Icons/Editor2 SC:c/se
    
    Diese Zeile würde das Icon für den SAS/C++-Editor ,se' update-n.

@EndNode

@Node "RECHTLICHES" "ME_deutsch.guide/RECHTLICHES"
@Next "DANKSAGUNGEN"
@Prev "INSTALLATION"
@Toc "Main"

Rechtliches
~~~~~~~~~~~
    Diese Paket ist  Giftware,   aber es ist auch  Copyright  ©  1994 by
Johannes Beigel.   Das heißt,  Sie können (und sollen) es über die ganze
Welt verteilen,  ohne mich zu fragen, solange Sie nicht mehr als DM 5,--
oder  $US 5,--  dafür  nehmen   (im Preis sind Disk-  und  Kopier-Kosten
enthalten aber nicht das Porto).
    Das Paket darf nur vollständig weiterkopiert werden.
    Wenn   Sie  Dateien   aus  diesem   Paket  mit   nicht-kommerzieller
(Shareware,  Freeware,  Giftware...)  Software vertreiben wollen, müssen
Sie mir das Produkt zuschicken (bei Shareware: Vollversion).
    Wenn Sie   das Paket   (oder Teile davon)   mit einem  kommerziellen
Produkt vertreiben wollen,   *müssen*  Sie mich schriftlich um Erlaubnis
bitten (Adresse s. @{"Einleitung" Link "EINLEITUNG"}.).

@EndNode

@Node "DANKSAGUNGEN" "ME_deutsch.guide/DANKSAGUNGEN"
@Prev "RECHTLICHES"
@Toc "Main"

Danksagungen
~~~~~~~~~~~~
    Ich möchte  Martin Huttenloher und  Stefan Stuntz  ganz herzlich für
ihre tollen Produkte MUI und MagicWB danken.
    Außerdem  danke ich dem   ICP-Verlag  (AmigaPlus)  und  Cloanto  für
PersonalPaint 2.1,   mit dem alle Icons,   Images, Paletten und Patterns
entstanden sind.

@EndNode
