                             Anleitung zu

                               FontSel

                             Version 1.09
                          11. September 1995

                                 von

                 Holger Weets und Christoph Zwerschke


Inhaltsverzeichnis
==================

 1 Sinn und Zweck von FontSel
 2 Installation fr Eilige
 3 Genaueres zur Installation
 4 Bedienung
 5 Bedienung mit der Maus
 6 Drag & Drop
 7 Bedienung mit der Tastatur
 8 Probleme und Einschrnkungen
 9 Alternative Font-Selektoren
10 Aufruf von FontSel (fr Programmierer)
11 Copyright
12 Adressen der Autoren



1 Sinn und Zweck von FontSel
============================

FontSel ist ein Font-Selektor-Programm, mit dem Fonts (Zeichenstze)
in Anwendungsprogrammen eingestellt werden knnen. FontSel unter-
sttzt dabei sowohl die UFSL- und xFSL-Cookie-Schnittstellen nach
Michael Thnitz, Stefan Rogel und Dirk Haun als auch das Font-Proto-
koll ber GEM-Nachrichten nach Christian Grunenberg.



2 Installation fr Eilige
=========================

Unter einem Singletasking-Betriebssystem (wie dem gewhnlichen TOS)
startet man FontSel als AUTO-Ordner-Programm (FontSel untersttzt
dann die Cookie-Schnittstellen) oder als Accessory (FONTSEL.PRG mu
dazu in FONTSEL.ACC umbenannt und in das Wurzelverzeichnis des Boot-
Laufwerks kopiert werden, FontSel untersttzt dann GEM-Nachrichten).
Unter einem Multitasking-Betriebssystem (wie Multi-TOS oder MagiC)
startet man FontSel am besten als Autostart-Applikation vor dem Desk-
top (unter Multi-TOS, indem man in GEM.CNF eine entsprechende run-An-
weisung eintrgt, unter MagiC, indem man FontSel in den Ordner ko-
piert, der in MAGX.INF unter #_APP eingetragen ist).

Diese Anleitung existiert sowohl als gewhnlicher ASCII-Text namens
FONTSEL.TXT als auch als Hypertext fr ST-Guide. Falls Sie dieses Hy-
pertext-System von Holger Weets benutzen, sollten Sie FONTSEL.HYP und
FONTSEL.REF in Ihren Hypertext-Ordner kopieren.



3 Genaueres zur Installation
============================

FontSel kann auf verschiedene Weise gestartet werden, nmlich als
AUTO-Ordner-Programm, als Accessory (es mu dazu in FONTSEL.ACC umbe-
nannt werden), als Autostart-Applikation oder als gewhnliche Applika-
tion. Je nachdem, wie FontSel gestartet wurde, untersttzt das Pro-
gramm dann die Cookie-Schnittstelle oder GEM-Nachrichten oder beides.
Die Art der Installation kann ber Kommandozeilen-Parameter gegebenen-
falls genauer spezifiziert werden:

 Option -c
    Cookies UFSL und xFSL installieren und nach dem Beenden des Pro-
    gramms resident bleiben

 Option -d
    Font-Selektor sofort ffnen und nach dem Schlieen Programm wie-
    der beenden

 Option -e
    Font-Selektor erst auf Anforderung ffnen und nach dem Schlieen
    nicht beenden

Wenn keine Optionen angegeben werden knnen oder angegeben wurden,
dann werden automatisch folgende Optionen verwendet:

    Start aus dem AUTO-Ordner: -c
    Start als Accessory: -e
    Start als Applikation unter einem Singletasking-TOS: -c
    Start als Applikation unter einem Multitasking-TOS: -d
    Start als Applikation unter Multitasking vor dem Desktop: -ce

Man kann die Optionen auch kombinieren; nicht alle Optionen und Kombi-
nationen sind jedoch sinnvoll. Die Optionen -d und -e sind beim Start
aus dem AUTO-Ordner nicht mglich, weil zu der Zeit das GEM noch
nicht initialisiert ist. Die Option -c ist beim Start als Accessory
nicht mglich, weil ein Accessory nicht resident installiert werden
kann (es wird z.B. bei einem Auflsungswechsel aus dem Speicher ent-
fernt) und daher keine Cookies anlegen darf.

Fr Programme, die kein XACC2-Protokoll verwenden, aber trotzdem
FontSel mittels der GEM-Nachricht FONT_SELECT aufrufen wollen, sollte
man die Environment-Variable FONTSELECT setzen.

Es gibt verschiedene Mglichkeiten, wie man dies bewerkstelligen
kann. In einem Batchfile mte man dazu etwa so etwas eintragen:

setenv FONTSELECT "C:\UTILITY\FONTSEL.PRG"

In GEM.CNF mu man das gleiche etwas anders schreiben:

setenv FONTSELECT=C:\UTILITY\FONTSEL.PRG

In MAGX.INF gibt es noch eine andere Schreibweise dafr:

#_ENV FONTSELECT=C:\UTILITY\FONTSEL.PRG

Es gibt auch spezielle Programme zum Setzen des Environments, wie
etwa "Senf" von Thomas Binder. In SENF.INF schreibt man:

FONTSELECT=C:\UTILITY\FONTSEL.PRG



4 Bedienung
===========

Wenn FontSel von einem Programm aufgerufen wird, erscheint auf dem
Bildschirm eine Dialogbox mit einer Liste der whlbaren Fonts, einer
Liste der zugehrigen Fontgren und einer Anzeige des Fonts anhand
eines Beispiels. Es handelt sich dabei entweder um einen "Fenster-
dialog" oder um eine "gewhnliche" Dialogbox (dies entscheidet das
aufrufende Programm). Die Dialogbox kann komplett ber die Tastatur
bedient werden. Durch Anklicken des Hintergrundes oder irgendeines un-
benutzten Objekts kann sie auch verschoben werden ("Let 'em fly"
braucht dazu nicht installiert zu sein).



5 Bedienung mit der Maus
========================

Klick auf Font oder Gre: Font oder Fontgre auswhlen

auf "Slider": Slider beliebig bewegen

auf Slider-Hintergrund: Slider um eine Seite bewegen

auf Pfeile: um eine Zeile bewegen

auf +/-: Zwischengren einstellen (bei Vektorfonts)

auf Knopf ? neben dem Beispieltext: Beispieltext umschalten,
es kann zwischen folgenden Anzeigen umgeschaltet werden:
- Beispieltext in der gewhlten Schrift
- Fontname in der gewhlten Schrift
- Fontname im Systemzeichensatz
- Kompletter Zeichensatz in der gewhlten Schrift

auf Pfeile neben dem Beispieltext: Textanzeige verschieben

auf Knpfe F,H,K,U,O,S: Effekte whlen

    Anmerkungen dazu:

        Die Abkrzungen bedeuten:
         fett, hell, kursiv, unterstrichen, hohl, schattiert

        Schattierte Schrift ist bei den meisten Bildschirmtreibern
         nicht implementiert und bewirkt deshalb nichts.

        Die Effekte knnen vom Font-Selektor nur ber die neueren
         Protokolle (nicht ber die UFSL-Schnittstelle) bergeben
         werden und werden von den meisten Programmen nicht ausgewer-
         tet. Man kann sie im Font-Selektor vor allem deshalb einstel-
         len, damit man vorher schon sehen kann, ob der gewhlte Font
         auch mit gesetzten Effekten ansprechend aussieht.

auf "Info": Information ber Version und Datum des Font-Selektors

auf "Abbruch": Selektor verlassen, Font nicht bernehmen

auf "OK": Selektor verlassen, Font bernehmen

Doppelklick auf Font oder Gre: Font oder Fontgre whlen und OK

Doppelklick auf Beispieltext: Aktuellen Font whlen und OK



6 Drag & Drop
=============

Erscheint FontSel als Fensterdialog, so kann der Beispieltext mit der
Maus auf ein beliebiges Fenster verschoben werden. FontSel sendet
dann an die betreffende Applikation eine sogenannte FONT_CHANGED-Nach-
richt, was die Applikation dazu veranlassen sollte, den Font in dem
betreffenden Fenster entsprechend einzustellen. Dies funktioniert
selbstverstndlich nur, wenn die Applikation auch die FONT_CHANGED-
Nachricht versteht und auswertet.



7 Bedienung mit der Tastatur
============================

Ctrl-(Alt)-Q oder Ctrl-(Alt)-U: Fenster schlieen

Ctrl-(Alt)-Leertaste: Fenster (ent)ikonifizieren

Cursor hoch/runter: Auswahl des Font

Cursor links/rechts: Auswahl der Fontgre

mit Shift: eine Seite hoch/runter

mit Control: zum Anfang/Ende

Clr/Home: zum letzten/ersten Font

Ctrl-Clr/Home: zur letzten/ersten Fontgre

1,2,3,...: direkte Auswahl des Fonts

F1,F2,F3,...: direkte Auswahl der Fontgre

+/-: Zwischengren einstellen (bei Vektorfonts)

?,<,>: nderung des Beispieltextes

F,H,K,U,O,S: Effekte whlen

Help = "Info"

Undo = "Abbruch"

Return = "OK"



8 Probleme und Einschrnkungen
==============================

FontSel untersttzt bisher lediglich die Auswahl des Zeichensatzes,
der Gre in Punkt und der Effekte. ber die xFSL-Schnittstelle und
ber die GEM-Nachricht XFONT_CHANGED aus dem Font-Protokoll knnen
auch noch weitere Attribute angegeben werden, diese Attribute werden
von FontSel jedoch nicht untersttzt.

ltere FontSel-Versionen richten sich noch nach der zum jetzigen
Standard inkompatibelen xFSL-Revision 3 und sollten daher schnellst-
mglich durch die aktuelle FontSel-Version ersetzt werden.

Falls der Aufrufer Ansprche an die Vollstndigkeit der Zeichenstze
stellt, berprft FontSel das Vorhandensein und die Breite aller
gewnschten Zeichen selber, was (je nach GDOS) einige Zeit in An-
spruch nehmen kann. Der Font-Selektor erscheint dann etwas verzgert
auf dem Bildschirm. Andernfalls verlt sich FontSel bei der Frage,
ob ein Zeichensatz proportional ist, auf die Angaben, die das einge-
setzte GDOS macht. Diese Angaben sind leider auch bei den aktuellen
Versionen von Speedo-GDOS und NVDI fehlerhaft oder unzuverlssig (bei
Speedo mehr, bei NVDI weniger). FontSel verzichtet hier auf "Work-
arounds", in der Hoffnung, da diese Probleme doch noch ausgerumt
werden. Macht das eingesetzte GDOS keine Angaben dazu, ob ein Font
proportional ist, dann testet FontSel dies natrlich selber.

Ein Hinweis fr Besitzer der Nova-Grafikkarte: Neuere Versionen des
Nova-VDI setzen anscheinend den "EdDI-Cookie", der die Untersttzung
von Bitmap-Funktionen signalisiert. Bei der Ausgabe in eine Bitmap
liefern einige dieser Versionen allerdings dann ein falsches Ergebnis
oder strzen sogar ab (insbesondere im Zusammenspiel mit Speedo oder
NVDI). In diesem Fall kann man mit einem Disk-Monitor-Programm im
FontSel-Programm nach der Zeichenkette "EdDI" suchen und sie etwa
durch "eddi" ersetzen. Dann werden die Bitmap-Funktionen nicht mehr
benutzt. Noch besser ist es, diese Zeichenkette im Nova-VDI zu erset-
zen, dann knnen auch andere Programme, die Bitmaps benutzen, keine
Probleme mehr bekommen. Solcherart modifizierte Programmversionen
aber bitte niemals an andere weitergeben!



9 Alternative Font-Selektoren
=============================

FontSel war zunchst nur als kompakte Alternative zum ersten Font-Se-
lektor UFSL gedacht, der leider nicht mehr weiter entwickelt wird.
Inzwischen ist FontSel allerdings um einiges flexibler als UFSL und
beherrscht auch weitere Font-Selektor-Standards. Der UFSL-Standard
wird von FontSel aber immer noch voll untersttzt.

Hier eine bersicht ber einige weitere Font-Selektoren:

 UFSL von Michael Thnitz:
    der Prototyp, UFSL-Schnittstelle

 xUFSL von Stefan Rogel:
    erster Nachfolger von UFSL mit erweiterter Schnittstelle

 FontSel von Holger Weets:
    kompakter Nachfolger von UFSL, Updates von Ch. Zwerschke

 Calvino von Dirk Haun:
    moderner Nachfolger von UFSL, neue xFSL-Schnittstelle

 HuGo! von Stefan Rogel:
    Nachfolger von xUFSL mit xFSL-Schnittstelle

 Font-Selektor aus "Magic" von Peter Hellinger:
    Bestandteil von Magic (nicht von MagiC!)

 Font-Selektor aus "ACSpro" von Stefan Bachert und Oliver Michalak
    Bestandteil (Objekt) von ACSpro

 FontSelector aus "EnhancedGEM" von Christian Grunenberg:
    neues Konzept, Font-Protokoll mit GEM-Nachrichten

 FONTselector von Hayo Schmidt:
    aus dem AES-Font-Loader-Paket, FOse-Schnittstelle



10 Aufruf von FontSel (fr Programmierer)
=========================================

Die xFSL-Schnittstelle ist inzwischen in einem Hypertext von Dirk
Haun umfassend dokumentiert worden, auf den hier verwiesen sei. Die-
ser Hypertext sollte zumindest in den MausNet-Mailboxen WI2 und LU zu
finden sein. Er enthlt im Anhang zustzlich die Dokumentation fr
das Font-Protokoll und die UFSL-Schnittstelle.

Bei Fragen und/oder Anmerkungen zur xFSL-Schnittstelle wendet man
sich am besten an Dirk Haun oder an Stefan Rogel, bei Fragen zum Font-
Protokoll an Christian Grunenberg.



11 Copyright
============

Copyright (c) 1994-95 by Holger Weets & Christoph Zwerschke.
All rights reserved.

FontSel darf im nicht-kommerziellen Rahmen nach Belieben kopiert und
weitergegeben oder der eigenen Software beigelegt werden.



12 Adressen der Autoren
=======================

Hier die Adressen der Autoren der genannten Font-Selektoren. Herzli-
chen Dank an dieser Stelle besonders an Holger Weets fr den Original-
FontSel und an Dirk Haun fr seine Mhe bei der Entwicklung der xFSL-
Schnittstelle und seine Tests und Hinweise zu den FontSel-Updates.

Die Programmierer vom Dienst:


12.1 Calvino
------------

Dirk Haun
Europastrae 8
D-64569 Nauheim
dirk_haun@wi2.maus.de


12.2 HuGo!
----------

Stefan Rogel
Khlerweg 1
D-67661 Kaiserslautern
stefan_rogel@lu.maus.de


12.3 FontSelector
-----------------

Christian Grunenberg
Traminerweg 5
D-71717 Beilstein
christian_grunenberg@lb.maus.de


12.4 FONTselector
-----------------

Hayo Schmidt
Grotiusweg 1
D-22587 Hamburg
hayo_schmidt@hh.maus.de


12.5 FontSel (Original)
-----------------------

Holger Weets
Tangastrae 45
D-26121 Oldenburg
holger_weets@ol.maus.de 


12.6 FontSel (Updates)
----------------------

Christoph Zwerschke
Am Steinfeld 4
D-59379 Selm-Cappenberg
christoph_zwerschke@ka.maus.de



