home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 491.lha / PictureEditor_v1.12 / BildEditor.dok < prev    next >
Text File  |  1991-04-05  |  16KB  |  446 lines
  1. #####################################################################
  2. #                                                                   #
  3. #     B I L D E D I T O R       Dokumentation für Version 1.12      #
  4. #                                                                   #
  5. #     © Hans-Werner Stremlau         9. Februar 1991     Glinde     #
  6. #                                                                   #
  7. #####################################################################
  8.  
  9. Inhalt:
  10.  
  11.      1. Übersicht
  12.      2. Programmpaket
  13.      3. Starten
  14.      4. Titelzeile
  15.      5. Betriebsarten
  16.      6. Funktionstasten
  17.      7. Menü-Funktionen
  18.      8. Tips und Hinweise
  19.      9. Bekannte Fehler
  20.  
  21.  
  22. 1. Übersicht:
  23.  
  24.  
  25.  Das Prinzip dieses Modula2 Programms besteht darin Bildobjekte aus
  26.  einfachen geometrischen Figuren (Kreis,Dreieck,Linie,..Fonts)
  27.  zusammenzusetzen.
  28.  
  29.  So erzeugte Bildobjekte können wiederum zu noch komplexeren
  30.  Bildobjekten zusammengesetzt werden.
  31.  
  32.  Jedes Bildobjekt stellt also die Spitze einer hierarchisch
  33.  strukturierten "Objekt-Pyramide" dar. Die Basis dieser Pyramide
  34.  setzt sich aus "atomaren-Bildobjekten", d.h. aus geometrischen
  35.  Grundfiguren, zusammen.
  36.  
  37.  Beispiel einer einfachen Bildobjekt-Hirarchie:
  38.  
  39.                         Haus
  40.                         /  \
  41.                     Dach   Rechteck(Erdgeschoss)
  42.                     /  \
  43.              Dreieck1 Dreieck2
  44.  
  45.  
  46.  
  47.  Man kann Bild-Objekte:
  48.  
  49.     - erzeugen(größer,kleiner,drehen)
  50.     - duplizieren
  51.     - löschen
  52.     - verschieben
  53.     - drehen (90 Grad Schritte)
  54.     - verfärben
  55.     - über oder unter andere Objekte schieben (Vorder/Hintergrund)
  56.     - mit anderen Objekten verbinden (merge)
  57.     - zusammengesetzte Objekte wieder aufspalten (split)
  58.     - speichern
  59.     - laden
  60.     - als IFF(ILBM) Bild speichern
  61.  
  62.  
  63.  Intern werden drei Bildobjekt-Klassen unterschieden:
  64.  
  65.  - atomar:    Geometrische GrundObjekte(Kreis,Dreieck..)
  66.               Ihre Farbe kann frei gewählt werden.
  67.  
  68.  - molekular: Zusammengesetzte Objekte gleicher Farbe.
  69.               Ihre Farbe kann ebenfalls frei gewählt werden.
  70.  
  71.  - bunt:      Zusammengesetzte Objekte unterschiedlicher Farbe.
  72.               Ihre Farbe kann nicht verändert werden.
  73.  
  74.  
  75. =====================================================================
  76.  
  77. 2. Programmpaket:
  78.  
  79.  Zu diesem Programmpaket gehören folgende Dateien:
  80.  
  81.  - Bildeditor.dok .. ....... diese Datei
  82.  - PictureEditor.doc ....... Dokumentation in Englisch
  83.  - ReadMe .................. Shareware-Hinweis
  84.  - PED ..................... Das Programm (PED=PictureEDitor)
  85.  - Pictures (dir)
  86.    - PED-Startup ........... scriptFile (assign PED: ...)
  87.    - House&Trees.info ...... icon zum Starten von PED mit diesem Bild
  88.    - House&Trees.typ ....... Beispiel-Bilddatei
  89.    - HOUSE.typ ............. Beispiel-Bilddatei
  90.    - ROOF.typ  ............. Beispiel-Bilddatei
  91.    - TREE.typ  ............. Beispiel-Bilddatei
  92.    - MOON.typ  ............. Beispiel-Bilddatei
  93.    - PIPELINE.info ......... icon zum Starten von PED mit diesem Bild
  94.    - PIPELINE.typ .......... Beispiel-Bilddatei
  95.    - valve.typ ............. Beispiel-Bilddatei
  96.    - FULLCONTAINER.typ ..... Beispiel-Bilddatei
  97.    - CONTAINER.typ ......... Beispiel-Bilddatei
  98.    - line.typ .............. Beispiel-Bilddatei
  99.    - LINE2.typ ............. Beispiel-Bilddatei
  100.    - S.typ ................. Beispiel-Bilddatei
  101.    - S1.typ ................ Beispiel-Bilddatei
  102.    - l1.typ ................ Beispiel-Bilddatei
  103.    - l2.typ ................ Beispiel-Bilddatei
  104.    - l3.typ ................ Beispiel-Bilddatei
  105.    - Text (dir)
  106.      - HELLO_WORLD.typ ..... Beispiel-Bilddatei
  107.      - HW_TXT.typ .......... Beispiel-Bilddatei
  108.  
  109.    Anmerkung: Wenn z.B. HOUSE.typ oder TREE.typ gelöscht wird, dann
  110.               ist auch HOUSE&TREES.typ unbrauchbar.
  111.  
  112.  
  113. =====================================================================
  114.  
  115. 3. Starten:
  116.  
  117.  Der Bildeditor benötigt die "arp.library" im Verzeichnis Libs:
  118.  Diese Library muss ggf. aus dem Verzeichnis PictureEditor/libs
  119.  nach Libs: kopiert werden.
  120.  
  121.  
  122.  Der Bildeditor sucht alle Dateien im PED: Verzeichnis.
  123.  Wenn diese Zuweisung nicht vor dem Programmstart durchgeführt wurde,
  124.  z.B. "assign PED: df0:pictureED/Bilder", dann ist RAM: das benutzte
  125.  Verzeichnis.
  126.  
  127.  
  128.  CLI Betrieb:
  129.  ============
  130.  Beim Starten des Editors aus dem CLI kann als Argument der Name eines
  131.  Bildobjektes (max. 16 Zeichen ohne extension ".typ") angegeben werden.
  132.  (z.B.   "PED Bild1" )
  133.  
  134.  
  135.  Workbench Betrieb:
  136.  ==================
  137.  Wenn man ein "Bild" von der Workbench aus bearbeiten will (wie im
  138.  Beispiel HAUS&BäUME), dann muss man ein passendes Projekt-Icon
  139.  nehmen und als default Tool den Bildeditor eintragen.
  140.  
  141.  
  142.  Betrieb mit 512 KB und einem Diskettenlaufwerk:
  143.  ===============================================
  144.  Das Prgramm funktioniert auch mit nur einem Diskettenlaufwerk und
  145.  512 KByte Speicher. Mit dieser Konfiguration und der WB 1.3 sowie
  146.  der ARP.library konnte ich das Beispielbild "House&Trees" laden,
  147.  mußte dabei aber "Diskjockey" spielen.
  148.  
  149.    Wenn man das Icon "Click Me first" anklickt, dann sollten die
  150.    Befehle assign und echo resident sein.(Diskwechsel)
  151.  
  152.    Wenn man zum Einlesen der Fonts die WB-Diskette eingelegt hatte,
  153.    dann muß man die WB wieder in den "Hintergrund" klicken.
  154.  
  155.  
  156.  
  157. ====================================================================
  158.  
  159. 4. Titelzeile:
  160.  
  161.  Wenn der Bildeditor mit einem Bildobjekt als Argument gestartet
  162.  wurde, dann steht auf der linken Seite der Name des Bildobjektes.
  163.  Durch "Save" Funktionen wird der gesamte Bildinhalt in das
  164.  bezeichnete Bildobjekt übernommen.
  165.  
  166.  Auf der rechten Seite der Titelzeile steht der Name des selektierten
  167.  Objektes.
  168.  
  169.  Wenn man ein atomares Objekt erzeugt, dann werden auf der rechten
  170.  Seite der Titelzeile die Atomparameter:
  171.  ( Atomtyp(@ ), Breite, Höhe, und der Verdrehwinkel in Grad )
  172.  angezeigt.
  173.  
  174.  Wenn man einen Font wählt, dann steht stattdessen  der Name des
  175.  angewählten Fonts auf der rechten Seite.
  176.  
  177.  
  178. ====================================================================
  179.  
  180. 5. Betriebsarten:
  181.  
  182.  Bei der Bedienung des Programms werden folgende
  183.  Betriebsarten unterschieden:
  184.  
  185.  
  186.    Basis-Betriebsart:  Laden, bearbeiten und speichern.
  187.  
  188.    Create-Betriebsart: Erzeugen von atomaren Objekten
  189.                        (Punkt,Linie,Kreis,Dreieck,Quadrat,Rechteck)
  190.  
  191.    Text-Betriebsart:   Schreiben von einzeiligem Text in der
  192.                        eingestellten Schriftart (Font)
  193.  
  194.    Schriftart-Auswahl: In dieser Betriebsart kann eine Schriftart
  195.                        gewählt werden.
  196.  
  197.  
  198.  
  199.  
  200. ====================================================================
  201.  
  202. 6. Funktionstasten:
  203.  
  204.  Alle Funktionen beziehen sich normalerweise auf das angewählte Bild-
  205.  Objekt. "sh" steht für Shift(nur die linke Shift Taste ist wirksam)
  206.  
  207.  
  208.   Tastenbelegung im der "Basis" Betriebsart:
  209.  
  210.       F1 = Vertausche Oben mit Unten
  211.    sh F1 = Vertausche Links mit Rechts
  212.  
  213.       F2 = 90 Grad rechts drehen
  214.    sh F2 = 90 Grad links drehen
  215.  
  216.       F8 = Objekt nach vorne ziehen (verdeckt andere Objekte)
  217.    sh F8 = Objekt nach hinten ziehen (wird von anderen verdeckt)
  218.  
  219.       F9 = nächstes Bildbjekt anwählen (in Richtung Vordergrund)
  220.    sh F9 = vorheriges Bildobjekt anwählen (in Richtung Hintergrund)
  221.  
  222.      F10 = nächste Farbe  (geht nur bei einfarbigen Objekten)
  223.   sh F10 = vorherige Farbe (...)
  224.  
  225.      Del = selektiertes Bildobjekt löschen
  226.  
  227.   Cursortasten und Pfeiltasten des Zehnerblocks
  228.          = Bewegen Objekte jeweils um ein Pixel in die
  229.            jeweilige Richtung(auch diagonal).
  230.  
  231.   sh Cursortasten und sh Pfeiltasten des Zehnerblocks
  232.          = bewegen Objekt jeweils um die Objektabmessung in die
  233.            jeweilige Richtung(auch diagonal).
  234.  
  235.        D = Dupliziert Objekt über dem Original.
  236.  
  237.        M = Merge ==> vereinigt alle selektierten (angeklickten)
  238.            Objekte zu EINEM Bildobjekt.
  239.  
  240.        S = Splittet Objekt in seine Bestandteile auf.
  241.  
  242.        P = "Punch" Verwandelt das selektierte Objekt in eine
  243.            "Stanze" d.h. wenn andere Objekte mit dieser Stanze
  244.            "gemergt" werden, dann  enthält das gemergte
  245.            Objekt an der Stelle der "Stanze" ein Loch von der
  246.            Form des Stanz-Objektes.
  247.            (man kann damit z.B. Ringe erzeugen).
  248.            (siehe "MOND" im Beispiel-File, benutze split !)
  249.            Diese Funktion toggelt, d.h. nach erneutem Aufruf von P
  250.            ist das Objekt wieder "normal".
  251.            Objekte im "Punch"Zustand werden grau dargestellt.
  252.  
  253.        B = Blitz Objekt. (das selektierte Objekt blitzt auf)
  254.            (geht auch mit der '5' des Zehnerblocks)
  255.  
  256.        F = First (das oberste Objekt ist das angewählte )
  257.        L = Last  (das unterste Objekt ist das angewählte)
  258.  
  259.  
  260. ---------------------------------------------------------------------
  261.  
  262.   Tastenbelegung in der "Create" Betriebsart:
  263.  
  264.         RETURN = das erzeugte Objekt wird übernommen
  265.     ESC oder Q = das Objekt wird nicht übernommen
  266.  
  267.    Cursor Left = das Objekt wird schmaler
  268.    Cursor Right= das Objekt wird breiter
  269.  
  270.    Cursor Up   = das Objekt wird niedriger (nur für Rechtecke )
  271.    Cursor Down = das Objekt wird höher     (und Dreiecke      )
  272.  
  273.            F10 = das Objekt dreht rechts (1 Grad ) (nicht für Kreise)
  274.         sh F10 = das Objekt dreht links  (1 Grad ) (...             )
  275.  
  276.    Zehnerblock = bewegt Objekt in entsprechende Richtung.
  277.  
  278.    Durch drücken der linken Maustaste kann das Objekt mit der Maus
  279.    verschoben werden.
  280.  
  281. ---------------------------------------------------------------------
  282.  
  283.   In der "Text" Betriebsart ist nur eine Menü-Steuerung möglich. Nach
  284.   Betätigung einer Taste wird das entsprechende Zeichen in der
  285.   eingestellten Schriftart auf dem Bildschirm ausgegeben.
  286.  
  287. ---------------------------------------------------------------------
  288.  
  289.   Tastenbelegung in der "SetFont" Betriebsart:
  290.  
  291.  
  292.    Cursor Up   = der vorherige Font wird geladen
  293.    Cursor Down = der nächste Font wird geladen
  294.              F = der erste (first) Font wird geladen
  295.              L = der letzte (last) Font wird geladen
  296.         RETURN = Font "übernehmen" und zurück zur "Text" Betriebsart
  297.     ESC oder Q = Font "ignorieren" und zurück zur "Text" Betriebsart
  298.  
  299.  
  300. =====================================================================
  301.  
  302. 7. Menü-Funktionen:
  303.  
  304.  PROJECT:
  305.  
  306.  - Load Type: Aus dem Verzeichnis PED: und ggf. aus Unterverzeichnissen
  307.               kann ein Bildobjekt-Typ (name.typ) ausgewählt und
  308.               geladen werden.
  309.  
  310.  - Clear All: Alle Objekte auf dem Bildschirm löschen.
  311.  
  312.  - Make ILBM: Das selektierte Objekt wird als iff(ILBM) File unter
  313.               dem Namen "<name>.iff" im PED: Verzeichnis gespeichert,
  314.               und kann anschließend mit Malprogrammen oder z.B. auch
  315.               mit dem PD-Programm "IconLab" bearbeitet werden.
  316.  
  317.  - Save:      Falls der Bildeditor mit einem ObjektNamen als Argument
  318.               gestartet wurde, dann wird der gesamte Bildschirminhalt
  319.               als Objekt unter diesem Namen abgespeichert.
  320.  
  321.  - Save As:   Der gesamte Bildschirminhalt wird unter dem angegebenen
  322.               Namen als Bildobjekt im Verzeichnis PED: abgespeichert.
  323.               Es muss ein Name sein, der noch nicht existiert.
  324.  
  325.  - Save Exit: Wie "Save". Zusätzlich wird das Programm nach dem
  326.               Abspeichern beendet.
  327.  
  328.  - Quit:      Das Programm wird beendet, ohne den Bildschirminhalt
  329.               abzuspeichern.
  330.  
  331.  
  332.  EDIT:
  333.  
  334.  - Text:      Man gelangt in eine Betriebsart, in der ein einzeiliger
  335.               Text in der aktiven Schriftart eingetippt werden kann.
  336.  
  337.    - Return:    Über dieses Menü gelangt man wieder in die "Basis"-
  338.                 Betriebsart.
  339.  
  340.    - SetFont:   Über dieses Menü gelangt man in eine Betriebsart, in
  341.                 der die aktive Schriftart (Font) gewählt werden kann.
  342.  
  343.      - FirstFont: Es wird der erste Font der Fontliste angewählt.
  344.      - LastFont:  Es wird der letzte Font der Fontliste angewählt.
  345.      - NextFont:  Es wird der nächste Font der Fontliste angewählt.
  346.      - PrevFont:  Es wird der vorherige Font der Fontliste angewählt.
  347.      - Use Font:  Der gewählte Font wird zum aktiven Font bestimmt.
  348.                   Zurück zur Text-Betriebsart.
  349.      - Cancel  :  Zurück zur Text-Betriebsart ohne den angewählten
  350.                   Font zu übernehmen.
  351.  
  352.  
  353.  - Create:
  354.  
  355.    - Point:    Es wird ein Punkt erzeugt.
  356.    - Circle:   Es wird ein Kreis erzeugt.
  357.    - Line:     Es wird eine Linie erzeugt.
  358.    - Triangle: Es wird ein (rechtwinkliges) Dreieck erzeugt.
  359.    - Square:   Es wird ein Quadrat erzeugt.
  360.    - Rectangle:Es wird ein Rechteck erzeugt.
  361.  
  362.      Mit den Cursortasten kann die Größe der Objekte verändert werden
  363.      Mit F10/shift-F10 kann das Objekt gedreht werden.
  364.      Mit der Maus und den Zehnerblock-Tasten wird das Objekt bewegt.
  365.      Mit "RETURN" wird das Objekt übernommen.
  366.      Mit "Q" oder "ESC" wird diese Funktion abgebrochen.
  367.  
  368.  
  369.  - Punch: (engl.: Stanze). Verwandelt das selektierte Objekt in eine
  370.            "Stanze" d.h. nach dem mergen enthält das "gemergte"
  371.            Objekt ein Loch. (z.B. zum erzeugen von Ringen).
  372.            Diese Funktion toggelt, d.h. nach erneutem Aufruf
  373.            ist das Objekt wieder "normal".
  374.  
  375.  - SelectAll:Alle Objekte auf dem Bildschirm werden selektiert.
  376.              Beim "mergen" werden dann alle Bildobjekte zu
  377.              einem Objekt "zusammen-gemergt".
  378.  
  379.  - De-select:Alle Objekte auf dem Bildschirm werden De-selektiert.
  380.              Man kann danach einzelne Objekte durch "anklicken"
  381.              selektieren, um eine Auswahl für das "mergen" zu
  382.              treffen.
  383.  
  384.  - Merge:    Alle selektierten Objekte (siehe oben) werden zu
  385.              einem Objekt zusammengefügt.
  386.  
  387.  - Split:    Ein zusammengesetztes Objekt wird wieder in seine
  388.              Bestandteile zerlegt.
  389.  
  390.  
  391.  WINDOW:
  392.  
  393.  - CYCLING:
  394.  
  395.    - CycleOn:  Das "ColorCycling" wird eingeschaltet.
  396.    - CycleOff: Das "ColorCycling" wird ausgeschaltet.
  397.  
  398.  - RESOLUTION:
  399.  
  400.    - LO-Res    Niedrige Auföesung (320 x 256)
  401.    - HI-Res    Mittlere Auföesung (640 x 256)
  402.    - Interlace Höchste  Auflösung (640 x 512)
  403.  
  404. =====================================================================
  405.  
  406. 8. Tips und Hinweise:
  407.  
  408.  - Die Hi-Resolution Bildschirmauflösung hat ein Seitenverhältnis
  409.    von 640:256 also etwa 2:1. Aus diesen Grund werden Kreise als Elipse
  410.    und Quadrate als Rechteck dargestellt. Dieser Effekt fällt besonders
  411.    beim drehen von Objekten auf.
  412.      Bei der interlace-Auflösung tritt dieser Effekt nicht auf.
  413.    Hier sollte man aber über mindestens 1MB Chip-Ram verfügen, um
  414.    sinnvoll arbeiten zu können.
  415.  
  416.  - Wenn man auf eine schnellere Bildberechnung wert legt, dann sollte
  417.    man darauf achten, daß Bildobjekete aus möglichst wenigen komplexen
  418.    Objekten aufgebaut sind, statt aus vielen kleinen Objekten.
  419.  
  420.  - Um eine Objektgruppe zu einem Objekt zu vereinigen geht man
  421.    folgendermaßen vor:
  422.    1. De-Select aus dem EditMenü aufrufen(kein Objekt mehr selektiert)
  423.    2. Alle zu vereinigenden Objekte mit der Maus anklicken(selektieren)
  424.    3. Merge aus Edit-Menü oder über Funktionstaste "M" aufrufen.
  425.       Einen sinnvollen Namen für das Objekt eingeben.
  426.  
  427.  - Wenn man eine größere Objekt-Bibliothek aufbauen will, dann ist es
  428.    sinnvoll sich im PED: Verzeichnis Unterverzeichnisse einzurichten
  429.    (das erhöht die Übersicht).
  430.  
  431.  
  432. =====================================================================
  433.  
  434. 9. Bekannte (aber leider noch nicht behobene) Fehler:
  435.  
  436.  - Wenn man nach Anwahl des ARP-Filerequesters schnell die rechte
  437.    Maustaste drückt, dann "verklemmt" das Programm.
  438.  
  439.  
  440.  
  441.  
  442.                    Hans-Werner Stremlau
  443.                    Stormarnring 20
  444.                    D-2056 Glinde 
  445.  
  446.