@database cybergraphics.guide

@Width 72


   Dokumentation zum CyBERgraphics WB Emulation Standard
         für Domino, PicassoII, Spectrum & Piccolo


@Node Main "cybergraphics.guide"
@Next "M1_INTRD"

                        CyBERgraphics WB Emulation

           Der Versuch, das WB Emulationschaos auf dem AMIGA
                          zu vereinheitlichen

                            Version 40.41

        (C) Copyright 1994-1995 by Thomas Sontowski & Frank Mariak

                               SHAREWARE


 @{" Vorstellung         " Link "M1_INTRD"}          Was ist CyBERgraphics ?

 @{" Systemanforderungen " Link "M1_REQUI"}          Systemvoraussetzungen

 @{" Installation        " Link "M1_INSTL"}          Installation

 @{" Registrierung       " Link "M1_REGIS"}          Wie werde ich registrierter User

 @{" Updates             " Link "M1_UPDAT"}          Wo gibt es die neueste Version

 @{" Rechtliches         " Link "M1_RIGHT"}          Copyright, Haftung, Warenzeichen

 @{" Einschränkungen     " Link "M1_LIMIT"}          Einschränkungen der Shareware Version

 @{" Programmfehler      " Link "M1_BUGRP"}          Bekannte Fehler

 @{" Zukunftsaussichten  " Link "M1_FUTUR"}          Was werden zukünftige Versionen bringen

 @{" Versionen           " Link "M1_HISTO"}          Was hat sich bisher getan

 @{" Zusatztreiber       " Link "M1_MODUL"}          Zusatztreiber für diverse Programme

 @{" Danksagung          " Link "M1_THANX"}          Dank an ..

 @{" Autoren             " Link "M1_AUTOR"}          So kann man uns erreichen


@EndNode

@Node Main2 "cybergraphics.guide"
@Next "M1_INTRD"

                        CyBERgraphics WB Emulation

           Der Versuch, das WB Emulationschaos auf dem AMIGA
                          zu vereinheitlichen

                            Version 40.41

        (C) Copyright 1994-1995 by Thomas Sontowski & Frank Mariak

                           registrierte Version


 @{" Vorstellung           " Link "M1_INTRD"}          Was ist CyBERgraphics ?

 @{" Systemanforderungen   " Link "M1_REQUI"}          Systemvoraussetzungen

 @{" Installation          " Link "M1_INSTL"}          Installation

 @{" Updates               " Link "M1_UPDAT"}          Wo gibt es die neueste Version

 @{" Rechtliches           " Link "M1_RIGHT"}          Copyright, Haftung, Warenzeichen

 @{" Environment-Variablen " Link "M1_ENVIR"}          veränderbare Environment-Variablen

 @{" Monitordefinitionen   " Link "M1_MONIT"}          über Monitordefinitionen

 @{" Programmfehler        " Link "M1_BUGRP"}          Bekannte Fehler

 @{" Zukunftsaussichten    " Link "M1_FUTUR"}          Was werden zukünftige Versionen bringen

 @{" Versionen             " Link "M1_HISTO"}          Was hat sich bisher getan

 @{" Zusatztreiber         " Link "M1_MODUL"}          Zusatztreiber für diverse Programme

 @{" Danksagung            " Link "M1_THANX"}          Dank an ..

 @{" Autoren               " Link "M1_AUTOR"}          So kann man uns erreichen

@endnode

@Node "M1_INTRD" "cybergraphics.guide/M1_INTRD"
@Next "M1_REQUI"
@Prev "Main"
@Toc "Main"

Vorstellung
-----------

Das Cybergraphics-System wurde sowohl entwickelt, um einen unabhängigen
Grafikstandard für Grafikkarten zu definieren, als auch um das
mittlerweile dreijährige Know-how im Programmieren von Grafikkarten
und Workbench-Treibern fortzusetzen (WB-Emulation der Visiona, Domino, Picasso
und der Cybervision64).
Das System gliedert sich in hardwareabhängige Monitorfiles und in hardware-
unabhängige Libraries auf. Dies hat z.B. den Vorteil, dass das Beheben von
Fehlern in der WB-Emulation oder das Optimieren gleich allen Grafikkarten
zugute kommt, die von cybergraphics unterstützt werden. Dies garantiert
für die Zukunft bug-fixes (denn zwischen Programmierern und Anwendern steht
kein Dritter wie XpERT zu Domino-Zeiten oder Village-Tronic) und die stetige
Weiterentwicklung der Software.
Momentan erlaubt das cybergraphics-System für Programmierer ein Bearbeiten
von 15/16/24-Bit Screens unabhängig von der zugrunde liegenden Speicher-
organisation, jedoch kann man noch nicht mit "normalen" graphics-library-
Aufrufen Ausgaben auf dem Screen machen (es wird einfach nichts gezeichnet).
Zukünftig wird die graphics.library jedoch derart erweitert, daß diese Screens
normal in das Amiga-System eingebettet sind, d.h. man wird mit der
graphics-library darauf z.B. Texte ausgeben können, Fenster öffnen und
verschieben und vieles mehr.

Das cybergraphics-System wird ebenfalls die mitgelieferte Software zur im
Ende Februar 1995 erscheinenden Cybervision64 von Advanced Systems & Sofware
sein (natürlich mit Treibern für diverse Programme,Screenmode-Promoter
u.v.m.).
Zum momentanen Zeitpunkt (22.2.95) existieren bereits Treiber für Maxon Cinema,
Real3D, ADpro, Amax IV, Emplant, ImageFX, PhotoWorx und Photogenics.
Desweiteren ist das Programm Cyberview zum Betrachten von Bildern in 15/16/24
Bit auf Aminet o.ä. erhältlich.

FEATURES
  o stabile WB-Emulation ;
  o screen-dragging
  o benötigt kein chip-mem für die Screens
  o modulares Konzept
  o hardwareunabhängige Programmierung der 15/16/24Bit - Modi
    d.h diegleichen Treiber laufen auf jeder Karte
  o mehr-Karten-support (momentan nur mit verschiedenen Karten)
  o vilintuisup.library auf Cybergraphics aufgesetzt, damit für
    eine Übergangszeit (ohne Cybergraphics-Treiber) noch die alten
    Picasso-Treiber benutzt werden können.
    (jedoch benutzen auf eigene Gefahr !)
  o benutzt Blitter zur planar2chunky-Konvertierung (optional)



@EndNode

@Node "M1_REQUI" "cybergraphics.guide/M1_REQUI"
@Next "M1_INSTL"
@Prev "M1_INTRD"
@Toc "Main"

Systemanforderungen
-------------------

  o eine der folgenden Grafikkarten:
      - Domino
      - Picasso II im linear mode (! nicht segmentiert !) 
      - Piccolo Z2/Z3 (keine SD64!!)
      - GVP Spectrum
      - CyberVision64
  o Kickstart 3.0 oder höher
  o mindestens 68020 CPU
  o 2 MB Fast-ram (mehr schadet nicht)

Bitte vermeiden Sie es, uns wegen weiterer Treiber zu kontaktieren (z.B.
Retina Z2/Z3, Piccolo SD64, Merlin etc.) Wir wissen, dass diese Karten
existieren. Da wir Softwareentwicklung aber nicht als Hauptberuf ausüben,
können wir nicht für jede x-beliebige Karte einen Treiber bieten im Moment.
Sobald neue Treiber verfügbar sind, wird dies bekanntgegeben.

Das bestimmte Treiber jetzt noch nicht existieren, liegt entweder daran,
das uns entsprechende Hardwareunterlagen fehlen, das uns einfach die
Zeit mangelt eine Anpassung für die Karte zu entwickeln oder das wir
einfach keine entsprechende Karte haben, um einen Treiber zu entwickeln.
Das hat nichts mit Konkurrenz oder sonstigem zu tun, wie es leider in den
gängingen Netzen zu lesen ist. Eine Stellungnahme zu diesem Thema haben wir
uns aus verständlichen Gründen bisher erspart.

Wir sind vor allem an einer zeitweiligen Zurverfügungstellung einer
Merlin-Grafikkarte interessiert, da wir es nicht mehr mit ansehen können,
wie Merlin-Besitzer für Updates kräftig zur Kasse gebeten werden.


Um einen problemlosen Betrieb der neuen Emulation zu gewährleisten, müssen
die VillageTronic bzw. EGS Emulationen entfernt werden. Dies wird zum Teil
von den Installationsskript übernommen, in Einzelfällen muß dies aber vom
User selbst erledigt werden. Es sollten auch Tools wie z.B. PatchDT
entfernt werden, da diese zu einer Verlangsamung der Emulation führen
können.

Bitte entfernen Sie auch Tools wie PatchDT, da diese Tools im Zusammenhang
mit cybergraphics einen eher bremsenden Effekt haben.

Viele PicassoII Besitzer haben den relativ hohen Speicherverbrauch von
cybergraphics im Vergleich zu den alten Treibern unter weniger als 256
Farben beklagt. Das ist in der Tat ein Kritikpunkt. An diesem Zustand wird
sich allerdings auch in Zukunft nichts ändern. Man kann es leider nicht
jedem Recht machen. PicassoII Besitzer haben optional ja immer noch die
Möglichkeit, auf ein Software update zu warten. Niemand wird zur Benutzung
von cybergraphics gezwungen.

@EndNode

@Node "M1_INSTL" "cybergraphics.guide/M1_INSTL"
@Next "M1_FASTE"
@Prev "M1_REQUI"
@Toc "Main"

Installation
------------

Die Installation geschieht mit dem Commodore Installer. Dazu genügt es,
das Icon mit dem Namen @{b}CyberGfx_Install@{ub} im Verzeichnis @{b}cybershare@{ub}
mit der Maus anzuklicken.

@EndNode



@Node "M1_LIMIT" "cybergraphics.guide/M1_LIMIT"

Einschraenkungen
----------------

Ohne persönliche Registrierung kann die cybergraphics emulation nicht in
vollem Umfang genutzt werden. Die Einschränkungen sind im einzelnen:

   @{b}*@{ub} In der ShareWare Version sind die Monitor ModeDefinitionen stark
   eingeschränkt. Es sind nur 9 festeinprogrammierte Auflösungen vorhanden,
   wobei 8 Auflösungen für die Workbench geeignet sind (256 Farben) und ein
   Modus für diverse Treiber verwendet werden kann (32768 Farben). Die
   registrierte Version hat natürlich keinerlei Einschränkungen dieser Art
   und es können ohne weiteres mehr Modes und höhere Farbtiefen/Bildwiederhol-
   frequenzen verwendet werden (24Bit).
   Die Auflösungen sind wie folgt definiert:

    -  320x240 Bildpunkte in 58Hz, 37,35kHz
    -  640x480 Bildpunkte in 70Hz, 37,03kHz
    -  800x600 Bildpunkte in 58Hz, 36,42kHz
    -  1024x768 Bildpunkte in 74Hz/Interlace, 30,26kHz
    -  1120x832 Bildpunkte in 62Hz/Interlace, 27,46kHz
    -  1152x900 Bildpunkte in 51Hz/Interlace, 26,57kHz
    -  1280x1024 Bildpunkte in 43Hz/Interlace, 24.16kHz
    -  1600x1200 Bildpunkte in 29Hz/Interlace, 18.32kHz

    sowie ein Modus in 32768 Farben:

    -  320x240 Bildpunkte in 58Hz, 37,35kHz

   UM ES NOCH EINMAL ZU BETONEN: ES SIND WESENTLICH HÖHERE FREQUENZEN MIT DEN
   CYBERGRAPHICS TREIBERN MÖGLICH, DIE LIMITIERUNG IST NUR DAZU GEDACHT, IHRE
   ZAHLUNGSMORAL ETWAS ZU BESTÄRKEN, DAMIT WIR WEITER AN CYBERGRAPHICS
   ARBEITEN KÖNNEN!!!

   @{b}*@{ub} Es wird nur der AdPro Treiber in der Shareware Distribution
   mitgeliefert. Es existieren noch weitere Treiber für Maxon Cinema 4D,
   Real3D, Photogenics, PhotoWorx, AmaxIV ... Weitere werden wahrscheinlich
   in Kürze folgen.

   @{b}*@{ub} Falls Sie registriert sind, gewährleisten wir Support bei
   Problemen und Fragen über email & smail. Wir sind gerne bereit, Anregungen
   von nicht registrierten Usern entgegenzunehmen, sehen es aber nicht ein,
   auf jede EMail/Mail bzgl. Problemen/Bugs mit cybergraphics von nicht
   registrierten Usern einzugehen.


Wir bitten um Verständnis für die Einschränkungen in der Shareware Version.
Wie Sie an eine persönlich registrierte cybergraphics Version kommen,
lesen Sie im Abschnitt @{i}Registrierung@{ui}.


@EndNode

@Node "M1_REGIS" "cybergraphics.guide/M1_REGIS"

Registrierung
-------------

Sie können shareware cybergraphics absolut kostenlos testen, wenn
Sie mit den Einschränkungen der unregistrierten Version leben können.
Falls Sie der Meinung sind, dieses Programmpaket ist den Betrag von
50,-DM bzw. $30,- wert, dann sollten Sie Ihre persönliche cybergraphics
Version bei einem von uns anfordern.

Sie erhalten dann die jeweils aktuellste auf Sie registrierte
Programmversion

Um sich nun für cybergraphics registrieren zu lassen, drucken Sie bitte
die Datei @{b}Bestellformular@{ub} auf Ihrem Drucker aus (falls kein Drucker
vorhanden können Sie den Text auch abschreiben), füllen es
anschließend aus und schicken es an eine der angegebenen Adressen.
Wir garantieren die Bearbeitung der Registrierung innerhalb von zwei
Wochen nach Erhalt des Formulars und der Gebühr durchzuführen.
Im Normalfall sollte es jedoch schneller gehen. Die Versendung des
Programmpakets kann wahlweise auch per email vonstatten gehen (anstelle
von Briefpost).

Die Autoren behält sich das Recht vor, Registrierwünsche nicht
anzunehmen.

@EndNode

@Node "M1_UPDAT" "cybergraphics.guide/M1_UPDAT"

Updates
-------

Als registrierter Anwender erhalten Sie die neueste Version von
cybergraphics mit einem auf sie persönlich registrierten Grafikkarten
Treiber. Neu erscheinende Versionen der cybergraphics libraries
und tools werden weiterhin über elektronische Netze veröffentlicht
und können dann auch direkt von Ihnen ohne Einschränkungen genutzt
werden. Neue Versionen des Grafikkarten Treibers werden Ihnen
persönlich zugestellt (per smail bzw. email)

Das erste Update des Grafikkarten Treibers bekommen Sie kostenlos
zugestellt, alle weiteren werden Ihnen gegen einen Unkostenbeitrag von
DM 5 (US$ 5 außerhalb der EU) umgehend zugestellt, falls sie den Postweg
wünschen (email-Zusendung bleibt kostenfrei)
Dieses Angebot gilt selbstverständlich nur für registrierte Benutzer.


@EndNode

@Node "M1_RIGHT" "cybergraphics.guide/M1_RIGHT"
@Toc "Main"

Rechtliches
-----------

 @{" Haftung " Link "Haftung"}
 @{" Verbreitung " Link "Verbreitung"}
 @{" Warenzeichen " Link "Warenzeichen"}
 @{" Copyright " Link "Copyright"}        (C) 1994-1995 T.Sontowski & F.Mariak


@EndNode

@Node "Haftung" "cybergraphics.guide/Haftung"
@Next "Verbreitung"
@Toc "M1_RIGHT"

Haftung
-------

Mit dem Betrieb von cybergraphics stimmen Sie folgender Verzichtserklärung
zu:

ES GIBT KEINERLEI GARANTIE FÜR DIESES PROGRAMMPAKET, IN BEZUG AUF DIE
GELTENDE GESETZGEBUNG. AUSSER ES IST ANDERWEITIG SCHRIFTLICH BESTÄTIGT,
SO STELLEN DIE COPYRIGHT-INHABER UND/ODER EINE DRITTE PARTEI DIESES PROGRAMM
"SO WIE ES IST", OHNE GARANTIE IRGENDWELCHER ART, INDIREKTER ODER
AUSDRÜCKLICHER ART, EINGESCHLOSSEN, ABER NICHT DARAUF BESCHRÄNKT, DIE
EINGESCHLOSSENEN MARKTÜBLICHEN GARANTIEN UND TAUGLICHKEIT FÜR EINEN
BESTIMMTEN ZWECK, ZUR VERFÜGUNG. DAS VOLLE RISIKO DER QUALITÄT UND
FUNKTIONALITÄT DIESES PROGRAMMS LIEGT BEI IHNEN. SOLLTE SICH DAS
PROGRAMMPAKETS ALS FEHLERHAFT ERWEISEN, SO TRAGEN SIE ALLE KOSTEN ALLER
NÖTIGEN SERVICEARBEITEN, DER REPARATUR ODER KORREKTUR.

UNTER KEINEN UMSTÄNDEN, SOWEIT NICHT AUSDRÜCKLICH DURCH DIE GELTENDE
GESETZGEBUNG BESTIMMT ODER DURCH EIN SCHRIFTLICHE GENEHMIGUNG, KÖNNEN
DIE COPYRIGHT-INHABER ODER IRGENDEINE ANDERE PARTEI, DIE DIESES
PROGRAMMPAKET WEITERVERTREIBEN, SO WIE ES OBEN ERLAUBT WURDE, FÜR SCHÄDEN
GEWÖHNLICHER, BESONDERER, ZUFÄLLIGER ODER DURCH DAS PROGRAMMPAKET
ENTSTANDENER ART, WELCHE DURCH DIE NUTZUNG ODER FEHLERHAFTE BEDIENUNG
DES PROGRAMMPAKETS (EINGESCHLOSSEN, ABER NICHT DARAUF BESCHRÄNKT, DER
VERLUST VON DATEN, ODER FEHLERHAFTER DARGESTELLTER DATEN, ODER
VERLUSTE, DIE DURCH SIE ODER EINE DRITTE PARTEI HERBEIGEFÜHRT WURDEN,
ODER DURCH EIN FEHLERHAFTES ARBEITEN DIESES PROGRAMMPAKETS MIT ANDERERN
PROGRAMMEN), SELBST WENN DER INHABER ODER EINE DRITTE PARTEI AUF SOLCHE
MÖGLICHKEITEN DER SCHÄDEN HINGEWIESEN WURDEN, VERANTWORTLICH GEMACHT
WERDEN.


@EndNode

@Node "Verbreitung" "cybergraphics.guide/Verbreitung"

Verbreitung
-----------

Die Shareware Version von cybergraphics  darf auf beliebigen Datenträgern
weitergegeben, in Mailboxen oder anderen elektronischen Netzverbunden zur
Verfügung gestellt werden, allerdings nur unter Einhaltung folgender
Verzeichnisstruktur:

     devs (dir)
          monitors (dir)
            Domino                           Domino.info
            Picasso                          Picasso.info
            Piccolo                          Piccolo.info
            Spectrum                         Spectrum.info
       monitors.info                    
     libs (dir)
       cybergraphics.library            cyberintuition.library
       cyberlayers.library              vilintuisup.library
     devdocs (dir)
          autodoc (dir)
            colormodels.doc                  colormodels.doc.info
            cybergraphics                    cybergraphics.doc
            cybergraphics.doc.info           cybergraphics.info
          examples (dir)
            cybersavegio.c                   cybersavegio.c.info
          fd (dir)
            cybergraphics_lib.fd             
          include (dir)
               inline (dir)
               clib (dir)
                 cybergraphics_protos.h           
               cybergraphics (dir)
                 cybergraphics.h                  cybergraphics.h.info
                 cybergraphics.i                  cybergraphics.i.info
                 cyberinline.h                    
               pragmas (dir)
                 cybergraphics_pragmas.h          
       autodoc.info                     examples.info
       fd.info                          include.info
     drivers (dir)
          adpro (dir)
            CyBERgraphics                    
          cinema4d (dir)
            cinemaausgabe.library            
          photogenics (dir)
            CyBERgraphics.gio                
          photoworx (dir)
            cyber.viewer                     
          real3d (dir)
            cybergfx_r3d.library             
          imagefx (dir)
            CyberGraphics.000                CyberGraphics.000.info
            CyberGraphics.030                CyberGraphics.030.info
     modes (dir)
       Monitor-15khz                    Monitor-31khz
       Monitor-35khz                    Monitor-38khz
       Monitor-48khz                    Monitor-57khz
       Monitor-64khz                    
  Bestellformular                  Bestellformular.info
  CyBERgfx_D.guide                 CyBERgfx_D.guide.info
  CyBERgfx_E.guide                 CyBERgfx_E.guide.info
  CyberGfx_Install                 CyberGfx_Install.info
  devdocs.info                     devs.info
  drivers.info                     libs.info
  Orderform                        Orderform.info
  Versions                         Versions.info

Die gepackte Verbreitung dieser Dateien mittels LHA oder ähnlichen
Programmen ist erlaubt.  Für die Verbreitung darf eine Kopiergebühr
erhoben werden, solange ausdrücklich klargestellt ist, daß der Käufer
damit nicht für die Shareware Gebühren bezahlt hat.

Registrierte cybergraphics Versionen dürfen nur von den Autoren verteilt
und nicht ohne Genehmigung derselben weitergegeben werden.


@EndNode

@Node "M1_MODUL" "cybergraphics module"

 @{i}Adpro Saver@{ui}

   Hierbei handelt es sich um einen Saver für Art Department Pro von Elastic
   Reality. Dieser wurde bislang allerdings nur mit der Version 2.5 von
   AdPro getestet, und koennte unter anderen Versionen zu Problemen führen.


 @{i}Maxon Cinema4D Ausgabemodul@{ui}

   Dazu ist eigentlich nicht viel zu sagen. Dieses Modul wird vom Installer-
   skript in den libs: Ordner kopiert und ist dort unter
   cinemaausgabe.library zu finden. Wie das Modul bedient wird, ist dem
   Maxon Cinema Handbuch zu entnehmen. Dieses Modul wurde erfolgreich mit der
   Version 2.0 von Cinema4D getestet.


 @{i}ImageFX Render Modul@{ui}

   Dieses Modul wurde von Uwe Roehm erstellt. An dieser Stelle noch einmal
   Danke für das Modul und die nun folgende Beschreibung:

   Dies ist ein Rendermodul für ImageFX und das CyberGraphics RTG-System.
   Es ermöglicht, den Mainbuffer von ImageFX auf einem Hi- oder TrueColor
   CyberGraphics-Screen auszugeben. In einem größeren Bild kann man mit den
   Cursortasten scrollen, bzw. bei ausreichendem Speicherplatz wird ein
   autoscrollender Screen geöffnet. Falls Sie ImageFX selbst auf einem
   Hi- oder TrueColor Screen betreiben, können Sie den Mainbuffer auch in 
   einem Fenster ausgeben (näheres unter Installation).

   Es gibt zwei Versionen des Rendermoduls, die für den MC68000, bzw. den 
   MC68030 kompiliert sind. Sie können anhand der Endung .000, bzw. .030 
   unterschieden werden. 

   Danach können Sie wie gewohnt über den "Render..."-Button im Konfigurations-
   fenster von ImageFX das CyberGraphics-Rendermodul einstellen.
   
   Um auch in einem Fenster auf dem ImageFX-Panel-Screen rendern zu können,
   müssen Sie ImageFX im Workbench-Modus auf einem Hi- oder TrueColor-Screen
   starten. Ein "normaler" 256 Farbenscreen reicht nicht aus. Wegen den 
   derzeitigen Limitationen des Workbench-Screenmodes und der Konfiguration 
   von ImageFX müssen sie wir folgt vorgehen:
    1. Öffnen Sie einen PublicScreen in einem 15, 16 oder 24Bit CyberGraphics-
       Mode. Es gibt diverse PublicScreen-Manager, die dabei hilfreich sind.
    2. Setzen Sie im Icon von ImageFX die ToolTypes WORKBENCH und PUBSCREEN,
       wobei sie bei PUBSCREEN den Namen des eben geöffneten Screens angeben.
    3. Starten Sie ImageFX und wechseln Sie auf den PublicScreen 
       (er wird nicht automatisch nach vorne geholt)
    4. Im Panel des CyberGraphics-Rendermoduls sollte nun der Knopf für das
       Rendern in einem Fenster anwählbar sein. Die Lage und Größe des Fensters
       können Sie ändern und in den ImageFX-Preferences speichern.

   Bedienoberfläche

   Die Bedienoberfläche des CyberGraphics-Rendermoduls enthält die folgenden
   fünf Elemente:

   Module        : Zum Wählen eines anderen Rendermoduls

   Output Format : Sie können in einem eigenen CyberGraphics-Screen
                   ("Render in new CyberGraphics screen") oder einem
                   Fenster auf dem ImageFX-Panelscreen ("Render in
                   window on panel screen") den Buffer ausgeben.
                   Die Ausgabe in einem Fenster ist nur möglich und
                   anwählbar, wenn ImageFX auf einem HiColor-Screen
                   läuft (näheres unter Installation).

   Display Mode  : Falls sie die Ausgabe in einem CyberGraphics-Screen
                   sehen wollen, können Sie mit diesem Cycle-Gadget
                   den Screenmode wählen. Es stehen alle Hi- und TrueColor
                   Auflösungen zur Auswahl. Das Rendermodul wird
                   automatisch die geeignetste Auflösung voreinstellen.

   Render        :  Zeigt das Bild im Mainbuffer auf einem eigenen Screen oder
                    Fenster, abhängig von den Einstellungen des Display-Modes
                    und des Ausgabeformats.
                    (Shortcut: r)

   Close         :  Schließt das Fenster/den Screen wieder
                    (Shortcut: c)

   Scrolling

   In Bildern, die größer als der verwendete Ausgabescreen oder -fenster sind,
   kann man mit den Cursortasten scrollen. Einfache Cursortasten scrollen
   pixelweise, mit SHIFT zusammen jeweils 10 Pixel und mit CTRL zusammen 
   bildschirm-/fensterweise. Ein Ausgabescreen ist zudem autoscrollend, falls
   genügend Speicherplatz verfügbar ist, so daß sie ihn auch mit der Maus
   scrollen können.

   Preferences

   Das Rendermodul speichert in den ImageFX Preferences die Lage und Größe des
   Renderfensters, sowie das Ausgabeformat (Fenster oder Screen).


 @{i}Photogenics Saver@{ui}

   Dieser Saver ermöglicht das Anschauen von Photogenics Projekten auf einem
   15/16/24 bit Screen.


 @{i}PhotoWorx Display Treiber@{ui}

   Dieser Treiber wurde vom PhotoWorx Autor selbst erstellt und sollte deswegen
   keine Probleme bereiten.


 @{i}Real3D external screen module@{ui}

   Dieser Treiber ist als externes Ausgabemodul für Real3D gedacht. Wählen Sie in
   external screen/Settings die cybergfx_r3d.library als Ausgabe Library an.
   Wenn Sie nun external screen/Open anwählen, muesste sich ein cybergraphics
   Schirm öffnen. Mit Set modes können Sie nun dessen Auflösung wählen.


@endnode

@Node "Warenzeichen" "cybergraphics.guide/Warenzeichen"

Warenzeichen
------------

Workbench (TM), Intutition(TM) und Amiga (TM) sind eingetragene
Warenzeichen der Commodore Amiga Inc.,West Chester, USA.

@EndNode

@Node "Copyright" "cybergraphics.guide/Copyright"

Copyright
---------

Für das Programmpaket @{i}Cybergraphics@{ui} und das zugehörige Manual gilt:

Copyright (C) 1994-1995, Thomas Sontowski & Frank Mariak. All Rights reserved.

@EndNode

@Node "M1_BUGRP" "cybergraphics.guide/M1_BUGRP"

Bekannte Fehler:

  o einige Picasso II Karten produzieren Lesefehler bzw. Blitterfehler
    bei hohen Auflösungen und Bildwiederholraten. Evtl. muss man dann
    mit PicassoMode eine kleinere Bildfrequenz wählen

@EndNode


@Node "M1_MONIT" "cybergraphics.guide/M1_MONIT"

Zum momentanen Zeitpunkt existiert noch kein Programm zum Verändern
der Monitordefinitionen. Bis zum Release des endgültigen Monitorprogrammes
für cybergraphics muss man noch mit den mitgelieferten Monitordefinitionen
leben. Alle von cybergraphics unterstützten Grafikkarten haben dasgleiche
Dateiformat für die Monitordefinitionen, man kann also die Files zwischen
verschiedenen Karten austauschen !

  o Domino :	    Es gibt keine Definitionsfile bei der Domino Grafik-
                    Karte. Mittels setenv cybergraphics/dominomonitor kann
                    die maximale Horizontalfrequenz gewählt werden. Man
                    kann wahlweise 31,50 oder 57 angeben.

  o Picasso II :    das Monitorfile lädt das Definitionsfile, daß mit der
                    Environmentvariable PICASSOMONITOR spezifiziert wurde
                    aus ENV:cybergraphics/Picasso/
                    (wird normalerweise bei der Installation bereits
                     gesetzt)
                    Sollte kein Definitionsfile gefunden werden, so wird
                    ein Requester einige Standardmodi zur Wahl stellen.
                    Mit dem Programm ConvPicassoMode kann man die alten, von
                    PicassoMode generierten Modi in das cybergraphics-Format
                    umrechnen (die Dateien in devs:village/#? werden
                    konvertiert und nach envarc:cybergraphics/Picasso/
                    gesichert)
  
  o Piccolo Z3 :    das Monitorfile lädt das Definitionsfile, daß mit der
                    Environmentvariable PICCOLOMONITOR spezifiziert wurde
                    aus ENV:cybergraphics/Piccolo/
                    (wird normalerweise bei der Installation bereits
                     gesetzt)
                    Sollte kein Definitionsfile gefunden werden, so wird
                    ein Requester einige Standardmodi zur Wahl stellen.

  o GVP Spectrum:   das Monitorfile lädt das Definitionsfile, daß mit der
                    Environmentvariable SPECTRUMMONITOR spezifiziert wurde
                    aus ENV:cybergraphics/spectrum/
                    (wird normalerweise bei der Installation bereits
                     gesetzt)
                    Sollte kein Definitionsfile gefunden werden, so wird
                    ein Requester einige Standardmodi zur Wahl stellen.

  o CyberVision64 : das Monitorfile lädt das Definitionsfile, daß mit der
                    Environmentvariable CYBERVISION spezifiziert wurde
                    aus ENV:cybergraphics/Cybervision/
                    (wird normalerweise bei der Installation bereits
                     gesetzt)
                    Sollte kein Definitionsfile gefunden werden, so wird
                    ein Requester einige Standardmodi zur Wahl stellen.


@EndNode


@Node "M1_FUTUR" "cybergraphics.guide/M1_FUTUR"
@Next "M1_HISTO"
@Prev "M1_BUGRP"
@Toc "Main"

Zukunftsaussichten
------------------

Geplante Features für kommende Versionen von cybergraphics, wobei die
Reihenfolge keine Priorität bedeutet:



   @{b}*@{ub} 15/16/24bit Erweiterung der "normalen" graphics.library,
     d.h. man wird in absehbarer Zukunft 24bit-Screens öffnen
     können und mit den bisherigen graphics.lib-Aufrufen darauf
     zeichnen können (mit einigen Einschränkungen wegen der fehlenden
     CLUT)

   @{b}*@{ub} eigenes Programm zum Einstellen der Bildparameter

   @{b}*@{ub} Unterstützung weiterer Grafikkarten

   @{b}*@{ub} Bildschirmanzeigeprogramme, die cybergraphics unterstützen
     Dies wollen wir weitgehend Programmierern überlassen, die bereits Viewer
     für diverse Grafikkarten programmiert haben.


@EndNode

@Node "M1_HISTO" "cybergraphics.guide/M1_HISTO"
@Next "M1_THANX"
@Prev "M1_FUTUR"
@Toc "Main"

Versionen
---------

cybergraphics Revision 40.41

   - displaying alerts now works again. The monitor switch was not
     toggled in V40.40
   - IconMasks now work perfectly on extended bitmaps too
   - changed the allocbitmap stuff a bit. Now picture datatypes
     should work on extended displays too.
   - all extended bitmaps are now correctly aligned
   - some changes in the sprite stuff
   - added blitter support for extended display BltTemplate
     (currently only cvision is supported)
   - GREY8 & CLUT8 RECTFMTs did only sizex-1 rectangle
     writes. now fixed
   - tried to optimize some code in Write/Fill/ScalePixelArray
   - TDNestCnt state was not restored correctly when no memory
     could be allocated for screen conversion.
   - fixed bug in conjunction with interleaved bitmaps
   - fixed a bug in ScalePixelArray
   - added a missing mem alloc failed check in 15 bit bitmap
     allocation routines
   - very bad system crashes when being low on memory and opening
     screens then should be a thing of the past now.
   - Blitting should be more low memory tolerant now (Chunky2Planar
	blits failed in previous versions if not enough chip memory could
	be allocated)
   - fixed a rounding problem in the rgb15 color models

cybergraphics Revision V40.40

   - mouse colors should be set correctly now, even on less than
     32 colour screens
   - added ScalePixelArray function
   - fixed a bug in GetCyberIDAttr & GetCyberMapAttr
   - added clipping for InvertPixelArray
     fixed layer offset bugs in WritePixelArray
   - added ReadPixel for extended screens (via FindColor)
   - diverse changes in the extended screen support stuff
   - CYBRMREQ_MaxDepth is now set to 32 by default
   - fixed a bug in GetCyberMapAttr when a amiga bitmap was
     supplied
   - added CopyCyberMap function to allow faster image transfers
   - did some optimizations in the chunky to rgb code parts
   - dim_MaxRasterHeight was set to dim_MaxRasterWidth. This
     is fixed now.
   - fixed a bug in the Draw 15/16 bit function. FgPen & BgPen 
     was not set correctly
   - fixed diverse bugs in MovePixeArray and added minimal
     clipping support

cybergraphics Revision V40.36

   - graphics' WritePixelArray8 also works on extended bitmaps
     now
   - cybergraphics' WritePixelArray works in a layered 
     environment now too
   - fixed some problems with normal chunky bitmaps in 
     GetCyberMapAttr
   - complement text mode works now correctly
   - cybergraphics library can not be opened without a driver
     installed anymore
   - fixed memory loss problems in FreeModeList & FreeBitmap
   - fixed memory loss problem with extended (15/16/24) bitmaps
   - added WriteChunkyPixels patch
   - fixed a clipping bug in the drawing routine
   - fixed further bugs in ReadPixelArray
   - added PIXFMT_RGBA32
   - added minimal clipping support for Read & WritePixelArray
   - fixed a cycle eating bug in the sub task. Signaling was not
     handled correctly

cybergraphics Revision V40.29
   - added CPUP2C environment variable
   - HIRESCRSR environment variable is supported now
   - internal speedups
   - fixed titlebar problem in 15/16/24 bit
   - fixed another small masking bug with cirrus-boards
   - added blitter support for (Move & InvertPixelArray).
   - fixed a minor bug in ReadRGBPixel & ReadPixelArray
   - fixed bugs in extended bitmap support routines
   - Fixed bugs in Fill & InvertPixelArray
   - fixed bugs in MovePixelArray

cybergraphics Revision V40.23
   - first official release

@EndNode

@Node "M1_THANX" "cybergraphics.guide/M1_THANX"
@Next "M1_AUTOR"
@Prev "M1_HISTO"
@Toc "Main"

Danksagung
----------

Folgenden Leuten/Firmen möchten wir danken. Ohne einige von ihnen wäre das
cybergraphics Projekt in dieser Form wahrscheinlich nicht existent:



   -     @{i}Advanced Systems&Software@{ui} für die Entwicklung einer "State of
         the Art" Grafikkarte, die ausschlaggebend für die Entwicklung von
         CyBERgraphics war.

   -     @{i}Ralf Schmidt@{ui} für Tips und Anregungen in Sachen intuition und
         graphics

   -     @{i}Olaf Barthel@{ui} für Anregungen und Testen der ersten Versionen
         sowie Entwicklung eines Treibers für die PhotoCD Anwendung PhotoWorx
         als auch die vilintuisup.library.

   -     @{i}Matthias Scheler@{ui} für Anregungen und Testen der ersten Versionen
	 sowie für die Entwicklung der Programme CyberView und CyberWindow

   -     @{i}Andreas Goiczyk@{ui} für Anregungen und intensives Testen von
         cybergraphics auf der Piccolo Z3 Grafikkarte

   -     @{i}Bernd Münchgesang@{ui} für Hardwareunterstützung

   -     @{i}Kenneth Dyke@{ui} für interessante Talks auf IRC

   -     @{i}Robert Reiswig@{ui} für das Erstellen der Installer-Skripts

   -     @{i}Uwe Roehm@{ui} für das Erstellen des ImageFX Rendermoduls

@EndNode


@Node "M1_ENVIR" "cybergraphics.guide/M1_ENVIR"

folgende Environmantvariablen kennt die cybergraphics-library:


  o cybergraphics/CPUP2C

    Mit dieser Variable kann man die planar nach chunky-Konvertierung
    von der CPU übernehmen lassen (anstatt der Blitterkonvertierung).
    Dadurch entfallen die "planaren" Effekte beim Aufbau (bei der
    Blitterkonvertierung werden nacheinander die planes in die Karte
    kopiert, was man bei großen Blits sehen kann).
    Aktiviert wird die CPU-Variante mit
    
           setenv cybergraphics/CPUP2C="1"
    
    (wobei man, will man die Einstellung permanent haben, noch das
     dadurch entstehende File nach envarc: kopieren muss)
    CPU-Konvertierung ist jedoch langsamer als die Blitter-unterstützte
    Routine.



  o cybergraphics/HIRESCRSR

    Mit dieser Variable kann man auf nicht-AA-Maschinen die Lores-Sprites-
    Verdopplung der cybergraphics-library abschalten. Dadurch erhält
    man einen kleinen "Hires"-Mauszeiger. Diese Environment-Variable
    entspricht dem Tooltype HIRESSPRITE alter Picasso-Monitorfiles.
    Aktiviert werden die kleinen Sprites mit:
    
           setenv cybergraphics/HIRESCRSR="1"
    
    (wobei man, will man die Einstellung permanent haben, noch das
     dadurch entstehende File nach envarc: kopieren muss)


@EndNode


@Node "M1_AUTOR" "cybergraphics.guide/M1_AUTOR"
@Prev "M1_THANKS"
@Toc "Main"

Autoren
-------


        Thomas Sontowski                und   Frank Mariak                 
        Bensberger Marktweg 15                Klosterstr. 7                
        51069 Köln                            44135 Dortmund               
        GERMANY                               GERMANY                      
email:  marvin@sun.ph-cip.uni-koeln.de        fmariak@chaosengine.ping.de  

@EndNode

