DS7Control ARexx Dokumentation ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ Version 1.0 (12.04.97) Einführung ¯¯¯¯¯¯¯¯¯¯ Das Programm "DS7Control" (ohne Piktogramm) ist ein ARexx-Host, der eine Anzahl von Funktionen zur Steuerung der Kamera, zur Bildübertragung und für die Benutzerschnittstelle zur Verfügung stellt. Die globalen Einstellungen werden in "DS7Prefs" vorgenommen und als Umgebungs- variablen gespeichert, so daß sie leicht aus ARexx Skripten heraus gelesen werden können. Umgebungsvariablen ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ Diese befinden sich in "ENV:DS7Control". DEVICE Serielles Device UNIT Einheit für Device BAUD Geschwindigkeit in Baud PATHARCHIVE Die Pfade, welche in DS7Prefs eingestellt werden PATHPHOTOS PATHMAIN <- wichtig, um ggf. DS7Control zu finden und zu starten TEMPDIR SAVETIME 1: Datum und Uhrzeit als Dateikommentar speichern 0: Kein Dateikommentar speichern VIEWER Anzeigeprogramm Benutzung ¯¯¯¯¯¯¯¯¯ Kamera: Zunächst muß die Kamera mit OPENCAMERA geöffnet werden. Erst danach können weitere Kommandos ausgeführt werden, welche auf die Kamera zugreifen. Anschließend muß die Kamera mit CLOSECAMERA wieder freigegeben werden. Bildbearbeitung: Um Fotos bearbeiten zu können, gibt es eine Anzahl von Befehlen, die das Wort "IMAGE" im Namen haben. Eine Datei kann mit LOADIMAGE geladen, mit SCALEIMAGE oder ROTATEIMAGE bearbeitet und mit SAVEIMAGE wieder gespeichert werden. Benutzerführung: Neben den üblichen Datei- und Verzeichnisauswahlfenstern gibt es ein Fotoauswahlfenster und eine Fortschrittsanzeige. ARexx-Kommandos ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ Name des ARexx Ports: "DS7Control" in alphabetischer Reihenfolge: ---------------------------------------- NAME ADDNAMETOPATH Verbindet einen Verzeichnisnamen und einen Dateinamen zu einem Dateinamen mit voller Pfadangabe. SYNOPSIS ADDNAMETOPATH PATH,FILENAME PATH : Verzeichnis FILENAME: Dateiname RESULTS FULLNAME Name mit kompletter Pfadangabe. ---------------------------------------- NAME CLOSECAMERA Gibt mit "OPENCAMERA" geöffnete Kamera wieder frei. Vorher kann die Kamera nicht wieder geöffnet werden. Die Kamera wird auch beim Beenden des Steuerprogramms freigegeben. SYNOPSIS CLOSECAMERA RESULTS ---------------------------------------- NAME CLOSEPROGREQ Das Fenster mit der Fortschrittsanzeige wird geschlossen. SYNOPSIS CLOSEPROGREQ RESULTS ---------------------------------------- NAME DISPOSEIMAGE Der Bildpuffer wird entfernt und der dafür belegte Speicher freigegeben. SYNOPSIS DISPOSEIMAGE RESULTS ---------------------------------------- NAME GETABORT Testet, ob Benutzer bei der Fortschrittsanzeige auf "Abbrechen" geklickt hat. Das Fenster wird nicht geschlossen, wenn der Benutzer "Abbrechen" angeklickt hat. SYNOPSIS GETABORT RESULTS ABORT/N ABORT=1, wenn Abbruch gewünscht; sonst 0 ---------------------------------------- NAME GETNUMPICS Liest die Anzahl der in der Kamera vorhandenen Fotos. SYNOPSIS GETNUMPICS RESULTS NUM/N Anzahl der Fotos. ---------------------------------------- NAME GETPHOTO Liest das Foto aus der Kamera und speichert es in einer Datei im JPEG-Format. SYNOPSIS GETPHOTO NUM/N/A,FILE/A,PROGFROM/N,PROGTO/N NUM : Nummer des Fotos FILE : Dateiname PROGFROM: Wert für die Fortschrittsanzeige vor Aufruf dieser Funktion PROGTO : Wert für die Fortschrittsanzeige nach dieser Funktion Die Fortschrittsanzeige wird zwischen diesen Werten aktualisiert, während diese Funktion läuft. RESULTS ---------------------------------------- NAME GETPHOTOINFO Liest Infos über ein Foto SYNOPSIS GETPHOTOINFO NUM/N/A NUM : Nummer des zu untersuchenden Fotos RESULTS ORIENTATION/N,DATE,TIME ORIENTATION : Bildlage 0: normal, -90: 90° links, 90: 90° rechts, 180: auf dem Kopf DATE : Datum der Aufnahme (Form: "TT.MM.JJJJ") TIME : Aufnahmezeit (Form: "HH:MM:SS") ---------------------------------------- NAME GETPHOTONAME Liest Dateinamen des Fotos aus der Kamera SYNOPSIS GETPHOTONAME NUM/N/A NUM : Nummer des Fotos RESULTS NAME NAME : Name des Fotos in der Kamera (in der Form "DSC00007.JPG") ---------------------------------------- NAME IMAGEINFO Größe des Bildes im Bildpuffer auslesen. SYNOPSIS IMAGEINFO RESULTS WIDTH/N,HEIGHT/N WIDTH : Breite in Pixeln HEIGHT : Höhe in Pixeln ---------------------------------------- NAME LOADIMAGE Laden eines JPEG-Bildes aus einer Datei in einen Bildpuffer. SYNOPSIS LOADIMAGE FILE/A FILE : Dateiname RESULTS ---------------------------------------- NAME OPENCAMERA Öffnet die Schnittstelle und initialisiert die Kamera für die Datenübertragung. Bis das Kommando "CLOSECAMERA" aufgerufen wird oder das Programm "DS7Control" beendet wird, kann die Kamera von keinem anderen Programm benutzt werden. SYNOPSIS OPENCAMERA DEVICE/A,UNIT/N/A,BAUD/N/A DEVICE : serielles Device UNIT : zu benutzende Einheit des Device BAUD : zu benutzende Geschwindigkeit. Mögliche Werte sind: 9600, 12000, 14400, 16800, 19200, 28800, 38400, 57600 (es wird jeweils der nächstkleinere benutzt) RESULTS ---------------------------------------- NAME OPENPROGREQ Öffnet ein Fenster mit einer Fortschrittsanzeige (Balken) und optional einem zusätzlichen einzeiligen Text. SYNOPSIS OPENPROGREQ TITLE/K,TEXT/K,FROM/N,TO/N,SCREEN/K TITLE : Fenstertitel TEXT : Zusätzlicher Text (einzeilig) im Fenster. Ein solcher Text wird nur im Fenster angezeigt, wenn bei diesem Befehl ein Text angegeben ist ! FROM,TO : Zahlenbereich des Fortschrittsbalkens (z.B. 0-100 oder 14 bis 27) Voreinstellung: 0 und 100 SCREEN : Name des Bildschirms, auf dem der Requester geöffnet werden soll. (Workbench, wenn nicht vorhanden) RESULTS ---------------------------------------- NAME QUIT Das Programm "DS7Control" wird beendet. SYNOPSIS QUIT RESULTS ---------------------------------------- NAME REQUESTDIR Ein Verzeichnisauswahlfenster wird geöffnet. SYNOPSIS REQUESTDIR PATH/K,TITLE/K,SCREEN/K,SAVE/S PATH : Voreinstellung für den Pfad TITLE : Fenstertitel SCREEN : Name des Bildschirms, auf dem der Requester geöffnet werden soll. (Workbench, wenn nicht vorhanden) SAVE : In das ausgewählte Verzeichnis soll gespeichert werden. RESULTS PATH ausgewählter Pfad (RC=5, wenn abgebrochen; RC=10, wenn Fenster nicht geöffnet werden konnte, in beiden Fällen wird das PATH-Argument zurückgegeben) ---------------------------------------- NAME REQUESTFILE Ein Dateiauswahlfenster wird geöffnet. SYNOPSIS REQUESTFILE PATH/K,FILE/K,TITLE/K,PATTERN/K,SCREEN/K,SAVE/S PATH : Voreinstellung für den Pfad FILE : Voreinstellung für den Dateinamen TITLE : Fenstertitel PATTERN : Muster für den Dateinamen SCREEN : Name des Bildschirms, auf dem der Requester geöffnet werden soll. (Workbench, wenn nicht vorhanden) SAVE : Dateiname zum Speichern auswählen RESULTS PATH,FILE Pfad und Dateiname ---------------------------------------- NAME REQUESTOPTION Der Benutzer kann zwischen mehreren Optionen auswählen. SYNOPSIS REQUESTOPTION TITLE/K,TEXT/K/A,OPTIONS/K/M/A,SCREEN/K TITLE : Fenstertitel TEXT : Text, der im Fenster angezeigt wird. Bei mehrzeiligem Text werden die Zeilen mit '\' getrennt. OPTIONS : Liste von Optionen, die vom Benutzer gewählt werden können SCREEN : Name des Bildschirms, auf dem der Requester geöffnet werden soll. (momentan nicht unterstützt) RESULTS SELECTION/N Auswahl des Benutzers (erste,linke Option:0, dann 1, usw.) Fehlercodes: RC=0 ok RC=7 Fenster konnte nicht geöffnet werden (SELECTION=rechte Option) ---------------------------------------- NAME REQUESTPHOTO Ein Fenster wird angezeigt, in dem ein oder mehrere Fotos ausgewählt werden können. SYNOPSIS REQUESTPHOTO TITLE/K,TEXT/K,SCREEN/K,MULTI/S,ALL/S,CURRENT/S TITLE : Fenstertitel TEXT : Text, der zusätzlich im Fenster angezeigt wird (z. B. Erklärung). Bei mehrzeiligem Text werden die Zeilen mit '\' getrennt. SCREEN : Name des Bildschirms, auf dem der Requester geöffnet werden soll. (Workbench, wenn nicht vorhanden) MULTI : Es können mehrere Fotos ausgewählt werden. ALL : (nur zusammen mit MULTI) Es sind initial alle Fotos ausgewählt. CURRENT : (nur zusammen mit MULTI) Es ist nur das aktuelle Foto ausgewählt. RESULTS NUM/N/M Die Nummer(n) des/der ausgewählten Fotos. Fehlercodes: RC=0 ok RC=5 Benutzer hat abgebrochen RC=6 Keine Fotos in der Kamera RC=7 Fenster konnte nicht geöffnet werden. RC=10 Kamera ist nicht geöffnet ---------------------------------------- NAME ROTATEIMAGE Dreht das Bild im Bildpuffer um den angegebenen Winkel. SYNOPSIS ROTATEIMAGE ANGLE/N/A ANGLE : Drehwinkel in Grad (muß Vielfaches von 90 sein) RESULTS ---------------------------------------- NAME SAVEIMAGE Speichert den Bildpuffer als JPEG oder IFF Datei. SYNOPSIS SAVEIMAGE FILE/A,QUALITY/N,IFF24/S FILE : Dateiname QUALITY : JPEG-Qualitätseinstellung (1..100) IFF24 : Das Bild im IFF-ILBM Format speichern (24 Bit Farbtiefe). RESULTS ---------------------------------------- NAME SETPROGRESS Die Fortschrittsanzeige aktualisieren. SYNOPSIS SETPROGRESS TEXT/K,VALUE/N/K TEXT : neuer Text, der angezeigt werden soll VALUE : neuer Wert des Balkens RESULTS