EAGLE Help Version 8.2.2

Index

Erklärung der Hilfe-Funktion
EAGLE konfigurieren
Kommandozeilen-Optionen
Schnelle Einführung
Control Panel
Tastatur und Maus
- Benachbarte Objekte selektieren
Editor-Fenster
Editor-Befehle
- Befehlseingabe
- ADD
- ALIGN
- ARC
- ASSIGN
- ATTRIBUTE
- AUTO
- BOARD
- BUS
- CHANGE
- CIRCLE
- CLASS
- CLOSE
- CONNECT
- COPY
- CUT
- DELETE
- DESCRIPTION
- DIMENSION
- DISPLAY
- DRC
- EDIT
- ERC
- ERRORS
- EXPORT
- FRAME
- GATESWAP
- GRID
- GROUP
- HELP
- HOLE
- INFO
- INVOKE
- JUNCTION
- LABEL
- LAYER
- LINE
- LOCK
- MARK
- MEANDER
- MENU
- MIRROR
- MITER
- MODULE
- MOVE
- NAME
- NET
- OPEN
- OPTIMIZE
- PACKAGE
- PAD
- PASTE
- PIN
- PINSWAP
- POLYGON
- PORT
- PREFIX
- PRINT
- QUIT
- RATSNEST
- RECT
- REDO
- REMOVE
- RENAME
- REPLACE
- RIPUP
- ROTATE
- ROUTE
- RUN
- SCRIPT
- SET
- SHOW
- SIGNAL
- SLICE
- SMASH
- SMD
- SPLIT
- TECHNOLOGY
- TEXT
- UNDO
- UPDATE
- USE
- VALUE
- VARIANT
- VIA
- WINDOW
- WIRE
- WRITE
Ausgabedaten erzeugen
Standard-Befehl GROUP
Autorouter
Überprüfen des Designs
- Design Rules
Querverweise
User Language
Automatischer Backup
Datei-Locking
Forward&Back-Annotation
- Konsistenzprüfung
- Einschränkungen
Lizenz
- EAGLE-Editionen

Erklärung der Hilfe-Funktion

Ist in einem Layout-Editor-, Schaltplan-Editor-, oder Bibliotheks-Editor-Fenster ein Befehl aktiviert, dann wird nach Drücken der F1-Taste oder Eintippen von HELP die Hilfe-Seite für diesen Befehl aufgerufen.

Die Erklärung eines Befehls kann auch durch die Eingabe von

HELP befehl

aufgerufen werden.

Ersetzen Sie "befehl" beispielsweise durch MOVE, dann rufen Sie die Hilfe-Seite für den MOVE-Befehl auf.

Von jeder anderen Stelle aus öffnet F1 eine "kontextsensitive" Hilfe-Seite.

Folgende Hilfe-Seiten geben Auskunft für den Einstieg in das Programm.

Schnelle Einführung
EAGLE konfigurieren
Kommandozeilen-Optionen
Control Panel

EAGLE konfigurieren

Die folgenden Editor-Befehle können dazu verwendet werden, EAGLE individuell anzupassen. Sie können entweder direkt von der Kommandozeile eines Editor-Fensters eingegeben werden oder man kann Sie in die Datei eagle.scr eintragen.

Für die Befehle ASSIGN und SET existieren auch Dialoge, die über das Options-Menü der Editor-Fenster aufgerufen werden.

Benutzer-Interface

Befehlsmenü		MENU-Befehl..;
Tastenbelegung		ASSIGN function_key-Befehl..;
Snap-Funktion		SET SNAP_LENGTH number;
		SET CATCH_FACTOR value;
		SET SELECT_FACTOR value;
Inhalt von Menüs		SET USED_LAYERS name \| number;
		SET WIDTH_MENU value..;
		SET DIAMETER_MENU value..;
		SET DRILL_MENU value..;
		SET SMD_MENU value..;
		SET SIZE_MENU value..;
		SET ISOLATE_MENU value..;
		SET SPACING_MENU value..;
		SET MITER_MENU value..;
		SET DLINE_WIDTH_MENU value..;
		SET DLINE_EXT_WIDTH_MENU value..;
		SET DLINE_EXT_LENGTH_MENU value..;
		SET DLINE_EXT_OFFSET_MENU value..;
Kontextmenüs		SET CONTEXT type text commands;
Line/Wire Bend		SET WIRE_BEND bend_nr;
Beep ein/aus		SET BEEP OFF \| ON;

Bildschirmdarstellung

Farbe für Grid-Linien		SET COLOR_GRID color;
Farbe für Layer		SET COLOR_LAYER layer color;
Fill Style für Layer		SET FILL_LAYER layer fill;
Grid-Parameter		SET MIN_GRID_SIZE pixels;
min. dargest. Textgröße		SET MIN_TEXT_SIZE size;
Darst. der Netzlinien		SET NET_WIRE_WIDTH width;
Darst. der Pads		SET DISPLAY_MODE REAL \| NODRILL;
		SET PAD_NAMES OFF \| ON;
Darst. der Buslinien		SET BUS_WIRE_WIDTH width;
DRC-Füllmuster		SET DRC_FILL fill_name;
Polygon-Berechnung		SET POLYGON_RATSNEST OFF \| ON;
Vector Font		SET VECTOR_FONT OFF \| ON;

Mode-Parameter

Package-Check		SET CHECK_CONNECTS OFF \| ON;
Grid-Parameter		GRID options;
Replace-Modus		SET REPLACE_SAME NAMES \| COORDS;
UNDO-Buffer		SET UNDO_LOG OFF \| ON;
Line/Wire-Optimierung		SET OPTIMIZING OFF \| ON;
Netz-Linien beenden		SET AUTO_END_NET OFF \| ON;
Automatische Junctions		SET AUTO_JUNCTION OFF \| ON;

Voreinstellungen

Pad-Form		CHANGE SHAPE shape;
Linienbreite		CHANGE WIDTH value;
Pad/Via-Durchmesser		CHANGE DIAMETER diameter;
Pad/Via/Hole-Bohrd.		CHANGE DRILL value;
Smd-Größe		CHANGE SMD width height;
Text-Höhe		CHANGE SIZE value;
Text-Linienbreite		CHANGE RATIO ratio;
Text-Font		CHANGE FONT font;
Text-Ausrichtung		CHANGE ALIGN align;
Polygon-Parameter		CHANGE THERMALS OFF \| ON;
Polygon-Parameter		CHANGE ORPHANS OFF \| ON;
Polygon-Parameter		CHANGE ISOLATE distance;
Polygon-Parameter		CHANGE POUR SOLID \| HATCH \| CUTOUT;
Polygon-Parameter		CHANGE RANK value;
Polygon-Parameter		CHANGE SPACING distance;
Bemaßungsart		CHANGE DTYPE value;

Kommandozeilen-Optionen

EAGLE kann mit Kommandozeilen-Optionen aufgerufen werden. Dazu ist folgendes Format erforderlich:

eagle [ Optionen [ Dateiname [ Layer ] ] ]

Unter Windows steht EAGLE auch als Konsolenapplikation 'eaglecon.exe' zur Verfügung (s.u.).

Optionen

`-Axxx`		Bestückungsvariante
`-Cxxx`		den angegebenen Befehl ausführen
`-Dxxx`		Draw-Toleranz (0.1 = 10%)
`-Exxx`		Drill-Toleranz (0.1 = 10%)
`-Fxxx`		Flash-Toleranz (0.1 = 10%)
`-N-`		keine Rückfragen in der Kommandozeile
`-O+`		Stift-Bewegungen optimieren
`-Pxxx`		Plotter-Stift (Layer=Stift)
`-Rxxx`		Bohrer-Datei
`-Sxxx`		Script-Datei
`-Uxxx`		Datei für Benutzereinstellungen
`-Wxxx`		Blenden-Datei
`-X-`		CAM-Prozessor ausführen
`-c+`		positive Koordinaten
`-dxxx`		Ausgabegerät (-d? für Liste)
`-e-`		Blenden emulieren
`-f+`		Pads ausfüllen
`-hxxx`		Seitenhöhe (inch)
`-m-`		Ausgabe spiegeln
`-oxxx`		Ausgabedateiname
`-pxxx`		Stiftdurchmesser (mm)
`-q-`		Quick-Plot
`-r-`		Ausgabe um 90 Grad drehen
`-sxxx`		Skalierungsfaktor
`-u-`		Ausgabe auf dem Kopf stehend
`-vxxx`		Stiftgeschwindigkeit
`-wxxx`		Seitenbreite (inch)
`-xxxx`		X-Versatz (inch)
`-yxxx`		Y-Versatz (inch)

Hierbei bedeutet xxx, dass weitere Daten, z. B. ein Dateiname oder eine Dezimalzahl an den Optionsbuchstaben angehängt werden müssen (ohne oder mit Leerzeichen), wie zum Beispiel bei

-Wmywheel.whl
-W mywheel.whl
-e      Blenden-Emulation ein
-e+     dto.
-e-     Blenden-Emulation aus

Bei Schalter-Optionen bedeutet ein '-', dass der Schalter standardmäßig ausgeschaltet ist, während er bei '+' standardmäßig eingeschaltet ist.

Schalter-Optionen (z.B. -e) können ohne Wiederholung des '-'-Zeichens verwendet werden:

-ecfm Blenden-Emulation ein, positive Koordinaten ein, Pads ausfüllen ein, Ausgabe spiegeln

-ec-f+ Blenden-Emulation ein, positive Koordinaten aus, Pads ausfüllen ein

Benutzereinstellungen

Benutzereinstellungen werden in der eaglerc-Datei gespeichert, die normalerweise unter $HOME/.eaglerc abgelegt wird.

Unter Windows wird die Datei als eaglerc.usr in dem Verzeichnis abgelegt, welches durch den Registry-Eintrag "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\AppData" definiert ist, sofern keine Umgebungsvariable namens HOME definiert ist.

Mit der Kommandozeilen-Option -U kann dafür eine andere Datei angegeben werden. Dies ist insbesondere sinnvoll, wenn Sie mehrere EAGLE-Versionen mit verschiedenen Einstellungen verwenden wollen.
Beispiel: C:/Progamme/MyEAGLE5/bin/eagle.exe -UC:/Settings/eaglerc5.usr könnte eine Startzeile für Version 5 mit einer V5-spezifischen, C:/Progamme/MyEAGLE6/bin/eagle.exe -UC:/Settings/eaglerc6.usr für Version 6 mit einer V6-spezifischen eaglerc-Datei aufrufen, welche sich von eaglerc5.usr z.B. in den Projekt-Verzeichnissen unterscheidet.

Wird als Dateiname das Zeichen '-' angegeben, wie in -U-, so wird keine eaglerc-Datei gelesen bzw. geschrieben.

Toleranzen definieren

Ohne '+'- oder '-'-Zeichen gilt eine Toleranzangabe für beide Richtungen:

`-D0.10`		stellt Draw-Toleranz auf ±10% ein
`-D+0.1 -D-0.05`		stellt Draw-Toleranz auf +10% und -5% ein

Befehle ausführen

Wird ein Befehl über die Option '-C' angegeben, wie etwa

eagle -C "window (1 1) (2 2);" myboard.brd

so lädt EAGLE die angegebene Datei und führt den Befehl so aus, als wäre er in der Kommandozeile des Editor-Fensters eingegeben worden.

Folgende Bedingungen gelten für die Option '-C':

Es muss ein Dateiname (Board, Schaltplan oder Library) angegeben werden, so dass ein Editor-Fenster geöffnet wird, in dem der Befehl ausgeführt werden kann. Diese Datei muss nicht notwendigerweise existieren. Der Befehl wird nach dem Ladevorgang und Bestätigung evtl. damit verbundener Meldungen ausgeführt.
Die Datei eagle.scr wird nicht automatisch ausgeführt.
Die Option '-s' wird ignoriert.
Die Benutzer-Einstellungen werden nicht in die eaglerc-Datei zurückgeschrieben.
Falls beim letzten Verlassen von EAGLE ein Projekt geöffnet war, so wird dieses nicht geöffnet.
Der Befehl kann ein einzelner Befehl sein oder eine Sequenz von durch Semikolons getrennten Befehlen.

Um EAGLE zu starten ohne automatisch die Datei eagle.scr auszuführen oder ein Projekt zu laden, kann der Befehl auch leer sein:

eagle -C ""

Beachten Sie bitte, dass in diesem speziellen Fall ein Leerzeichen zwischen dem Options-Buchstaben und den Anführungszeichen sein muss, damit das Programm den explizit leeren String sieht. Es muss dann auch kein Dateiname angegeben werden, da ja kein Befehl ausgeführt werden soll.

Dateiname

Falls der angegebene Dateiname eagle.epf ist (evtl. mit vorangestelltem Verzeichnisnamen), so lädt EAGLE diese Projekt-Datei. Ansonsten wird, falls keine Dateinamenserweiterung angegeben ist, .brd als Default verwendet.

Konsolen-Applikation (eaglecon.exe)

Um EAGLE unter Windows von einer Konsole aus betreiben zu können (z.B. um einen Batch-Job für die CAM-Ausgabe zu erstellen), können Sie die 'eaglecon.exe' verwenden. eaglecon.exe befindet sich ebenfalls im Ordner 'bin', ist identisch mit eagle.exe, hält aber die Verbindung zur Konsole aufrecht.

Wichtiger Hinweis zum Schließen:
Bitte beenden Sie immer zuerst EAGLE, bevor Sie die Konsole schliessen! Das vorherige Schliessen der Konsole bewirkt sonst ein unkontrolliertes "Abschiessen" von EAGLE, so daß ungespeicherte Änderungen verloren gehen können usw. Das gleiche Problem tritt auf wenn Sie über die Taskleiste die EAGLE-Fenster als als Gruppe schliessen oder nur gezielt das Konsolen-Fenster.

Schnelle Einführung

Um schnell mit EAGLE zurechtzukommen, sollten Sie mehr über folgende Themen wissen:

Control Panel und Editor-Fenster
Befehlseingabe
Eingabe von Parametern und Werten
Schaltplan entwerfen
Hierarchischen Schaltplan entwerfen
Schaltplan überprüfen
Platine aus Schaltplan erzeugen
Layout überprüfen
Bauelement in Bibliothek definieren
Autorouter benutzen
Ausdrucken auf den System-Drucker
Daten ausgeben mit dem CAM-Prozessor

Control Panel und Editor-Fenster

Vom Control Panel aus können Sie über das Datei-Menü oder durch Anklicken eines Icons die Fenster des Schaltplan-, Layout- und Bibliotheks-Editors öffnen.

Eingabe von Parametern und Werten

Parameter und Werte können über die EAGLE-Kommandozeile oder, wesentlich bequemer, über die Parameter-Toolbar eingegeben werden, die erscheint, wenn ein Befehl aktiviert ist. Da dies keiner großen Erklärung bedarf, wird an anderen Stellen im Hilfe-Text nicht explizit darauf hingewiesen.

Wann immer Koordinaten oder Abmessungen (z.B. Leiterbahnbreiten oder Pad-Durchmesser) angegeben werden können, können diese mit Einheiten versehen werden, wie etwa 50mil oder 0.8mm. Wird keine Einheit angegeben, so wird die aktuelle Grid-Einheit verwendet.

Schaltplan entwerfen

Schaltplan anlegen

Neuen Schaltplan mit "Datei/Neu" anlegen und mit "Datei/Speichern unter..." unter neuem Namen abspeichern.

Zeichnungsrahmen laden

Bibliothek FRAMES mit USE laden und Rahmen mit ADD plazieren.

Symbole plazieren

Bibliotheken mit USE laden und Symbole plazieren (siehe ADD, MOVE, DELETE, ROTATE, NAME, VALUE). Fehlt ein bestimmtes Bauelement, dann mit Bibliotheks-Editor definieren.

Busse einzeichnen

Busse mit BUS einzeichnen. Geben Sie den Bussen Namen (NAME), aus denen hervorgeht, welche Signale sich herausführen lassen.

Netze einzeichnen

Die Verbindungen zwischen den Pins der Elemente definiert man mit NET. Dargestellt werden Netze im Net-Layer. Mit dem Befehl JUNCTION kennzeichnet man Verbindungen sich kreuzender Netze.

Hierarchischen Schaltplan entwerfen

Ein hierarchischer Schaltplan wird durch Module gebildet. Ein Modul wird durch den MODULE-Befehl erzeugt. Module können auch über mehrere Schaltplanseiten gehen.

Module verwenden

Im Schaltplan wird ein Modul durch eine Modul-Instanz referenziert. Es kann mehrere Modul-Instanzen desselben Moduls geben.

Modul-Instanzen anschließen

Anschlusspunkte für Modul-Instanzen werden durch PORTs definiert.

Schaltplan überprüfen

Electrical Rule Check (ERC) durchführen und anhand der Meldungen Fehler korrigieren. Eventuell Netz- und Pin-Liste ausgeben (EXPORT). Mit dem SHOW-Befehl Netze am Bildschirm verfolgen.

Platine aus Schaltplan erzeugen

Mit dem BOARD-Befehl bzw. durch Anklicken des Board-Icons erzeugen Sie eine Platine aus dem geladenen Schaltplan (falls noch keine Platine mit demselben Namen existiert).

Es entsteht eine Leerplatine, neben der die mit Luftlinien verbundenen Bauelemente plaziert sind. Versorgungs-Pins werden mit den Signalen verbunden, die ihrem Namen entsprechen, falls nicht explizit ein anderes Netz mit ihnen verbunden wurde.

Die Platine ist über die Forward&Back-Annotation mit dem Schaltplan verbunden. Damit ist gewährleistet, dass beide übereinstimmen. Um die Forward&Back-Annotation aufrechtzuerhalten, sollten Sie immer beide Dateien geladen haben, wenn Sie Änderungen am Schaltplan oder an der Platine durchführen.

Platinenumrisse und Plazierung festlegen

Gegebenenfalls die Leerplatine in Größe und Form verändern (MOVE, SPLIT). Elemente an gewünschte Position verschieben (MOVE) und überprüfen, ob die Plazierung günstig oder ungünstig ist (RATSNEST).

Sperrflächen definieren

Falls gewünscht, zeichnet man Sperrflächen für den Autorouter als Rechtecke, Polygone oder Kreise in die Layer tRestrict, bRestrict und vRestrict (siehe RECT, POLYGON, CIRCLE). Für den Autorouter begrenzen auch geschlossene Linienzüge im Dimension-Layer die Route-Fläche.

Routen

Mit dem ROUTE-Befehl lassen sich jetzt die Luftlinien in Leitungen umwandeln. Diese Aufgabe kann man auch dem Autorouter (siehe Befehl AUTO) zuweisen.

Layout überprüfen

Design Rule Check (DRC) durchführen und Fehler korrigieren (ERRORS). Eventuell Netz-, Bauteile- und Pin-Liste ausgeben (EXPORT).

Bauelement in Bibliothek definieren

Die Definition eines Bauelements erfordert drei Schritte, die aufeinander aufbauen.

Öffnen Sie eine Bibliothek mit Öffnen oder Neu im Datei-Menü.

Package definieren

Packages sind die Gehäuse der Bauelemente, die im Board dargestellt werden.

Klicken Sie das Edit-Package-Icon an, und tragen Sie den gewünschten Namen in das New-Feld ein.

Legen Sie das Raster fest (GRID).

Plazieren Sie die Pads (PAD) und legen Sie deren Namen (NAME) und Parameter fest (CHANGE).

Plazieren Sie mit dem TEXT-Befehl die Strings >NAME und >VALUE (repräsentieren den aktuellen Namen und Wert in der Platine), und zeichnen Sie das Gehäuse (LINE-Befehl) in die entsprechenden Layer.

Symbol definieren

Symbole sind der Teil eines Devices, das im Schaltplan dargestellt wird.

Klicken Sie das Edit-Symbol-Icon an, und tragen Sie den gewünschten Namen in das New-Feld ein.

Plazieren Sie die Pins (PIN) und legen Sie deren Namen (NAME) und Parameter fest (CHANGE).

Plazieren Sie mit dem TEXT-Befehl die Strings >NAME und >VALUE (repräsentieren den aktuellen Namen und Wert im Schaltplan), und zeichnen Sie das Symbol (LINE-Befehl) in die entsprechenden Layer.

Device definieren

Ein Device enthält die Definition eines gesamten Bauelements einschließlich Gehäuse und Schaltplan-Symbol(e).

Klicken Sie das Edit-Device-Icon an, und tragen Sie den gewünschten Namen in das New-Feld ein.

Weisen Sie dem Device ein Gehäuse zu (PACKAGE-Befehl).

Verwenden Sie den ADD-Befehl, um das Symbol oder die Symbole in das Device zu holen.

Klicken Sie auf das CONNECT-Icon, um festzulegen, welche Pins mit welchen Gehäuse-Pads verbunden sind.

Speichern Sie die Bibliothek, und sie kann anschließend vom Schaltplan- oder vom Board-Editor aus mit USE geladen werden.

Control Panel

Das Control Panel ist EAGLEs Steuerzentrale. Es enthält in der linken Fensterhälfte eine Baumstruktur und ein Informationsfenster in der rechten Hälfte.

Verzeichnisse einstellen

Die Haupteinträge in der Baumansicht repräsentieren die verschiedenen EAGLE-Dateitypen. Jeder der Einträge kann auf ein oder mehrere Verzeichnisse zeigen, die Dateien dieses Typs enthalten. Die Verzeichnisse werden im Directories-Dialog definiert. Wenn einer der Haupteinträge auf ein Verzeichnis zeigt, sehen Sie nach dem Aufklappen des Eintrags (entweder durch einen Klick auf das kleine Symbol links oder durch einen Doppelklick auf den Eintrag selbst) direkt den Inhalt des Verzeichnisses. Wenn ein Haupteintrag auf mehrere Verzeichnisse zeigt, werden nach dem Aufklappen alle Verzeichniseinträge aufgelistet.

Kontext-Menü

Das Kontext-Menü eines Eintrags in der Baumstruktur erreichen Sie mit einem rechten Mausklick auf den entsprechenden Eintrag. Es enthält dann spezielle Punkte zu diesem Eintrag.

Beschreibungen

Die Beschreibung-Spalte der Baumansicht enthält eine Kurzbeschreibung des Eintrags (wenn vorhanden). Diese Beschreibungen werden aus der ersten nicht leeren Textzeile der folgenden Quellen erzeugt:

Verzeichnisse Die Datei mit dem Namen DESCRIPTION darin

Bibliotheken DESCRIPTION-Befehl in der Bibliothek

Devices DESCRIPTION-Befehl im Device-Editor

Packages DESCRIPTION-Befehl im Package-Editor

Design-Regeln Die Beschreibung der Design-Regel-Datei im DRC-Dialog

User-Language-Programme Text, durch die #usage-Anweisung gekennzeichnet

Script-Dateien Der Kommentar am Anfang der Script-Datei

CAM-Jobs DESCRIPTION-Befehl im CAM-Prozessor-Job

Drag&Drop

Sie können mit Hilfe von Drag&Drop Dateien und Verzeichnisse innerhalb der Baumstruktur kopieren oder bewegen. Es ist auch möglich, ein Device oder ein Package in das Schaltplan-, Layout- bzw. Library-Fenster zu ziehen und dort zu plazieren. Zieht man User-Language-Programme und Script-Dateien auf ein Editor-Fenster, werden sie darin ausgeführt. Design Rules werden einem Layout zugeordnet, wenn Sie einen entsprechenden Eintrag in das Layout-Editor-Fenster ziehen. Ziehen Sie eine Board-, Schaltplan- oder Library-Datei auf das jeweilige Editor-Fenster, so wird die Datei in den Editor geladen. All diese Funktionen erreichen Sie auch über das Kontext-Menü des entsprechenden Eintrags in der Baumstruktur.

Informations-Fenster

In der rechten Hälfte des Control Panels werden Informationen zum selektierten Punkt in der Baumstruktur angezeigt. Diese Informationen werden aus den Quellen erzeugt, die unter Beschreibungen angegeben sind. Bei Device und Package erhält man eine Voransicht des Elements.

Menü-Leiste

Die Menü-Leiste des Control Panels enthält folgende Punkte:

Datei

Neu		Erzeugt eine neue Datei
Öffnen		Öffnet eine existierende Datei
Zuletzt geöffnete Projekte		Öffnet eines der zuletzt bearbeiteten Projekte
Alles speichern		Speichert alle modifizierten Editor-Dateien
Projekt schließen		Schließt das aktuelle Projekt
Beenden		Beendet das Programm

Ansicht

Aktualisieren		Aktualisiert den Inhalt der Baumansicht
Suche		Sucht im Inhalt der Baumansicht (siehe unten)
Sortieren		Ändert die Sortierung der Baumansicht

Optionen

Verzeichnisse...		Öffnet den Verzeichnis-Dialog
Sicherung...		Öffnet den Sicherungs-Dialog
Benutzeroberfläche...		Öffnet den Benutzeroberfläche-Dialog
Fensterpositionen...		Öffnet den Fensterpositionen-Dialog

Fenster

Control Panel		Zum Control Panel wechseln
1 Schaltplan - ...		Zu Fenster 1 wechseln
2 Board - ...		Zu Fenster 2 wechseln

Hilfe

Allgemein		Öffnet eine allgemeine Hilfe-Seite
Kontext		Öffnet die Hilfe-Seite für den momentanen Kontext
Control Panel		Öffnet diese Hilfe-Seite
Auf Update prüfen		Prüft ob eine neue Version von EAGLE verfügbar ist
Über EAGLE		Zeigt Details zu Ihrer EAGLE Version und Lizenz an

Suchleiste

Das Suchmuster kann aus einem oder mehreren Wörtern, getrennt durch Leerzeichen, bestehen. Nach diesen Begriffen wird in den Namen und Beschreibungen der Baumansicht unabhängig von Groß- und Kleinschreibung gesucht. Es müssen alle Begriffe gefunden werden. Der Platzhalter '*' steht für eine beliebige Anzahl von sichtbaren Zeichen, während '?' für exakt ein sichtbares Zeichen steht. Um einen Platzhalter selbst zu suchen, muss diesem ein Backslash vorangestellt werden, wie in '\*'. Um die Suche auf einen bestimmten Zweig der Baumansicht zu beschränken, muss die Suche in dessen Kontextmenü gestartet werden. Um z.B. ein NAND-Bauteil der 74xx-Serie zu finden, geben Sie ein: 74* nand

Statuszeile

Die Statuszeile unten im Control Panel enthält den vollständigen Namen des gegenwärtig selektierten Objektes.

Kontext-Menüs

Ein Klick mit der rechten Maustaste auf ein Objekt des Control Panels öffnet ein Kontext-Menü das folgende Aktionen ermöglicht (nicht alle davon sind für alle Objekte zutreffend):

Neuer Ordner

Erzeugt ein neues Verzeichnis unterhalb des selektierten Ordners und schaltet den neu erzeugten Zweig der Baumansicht in den Umbenennen-Modus, so dass der gewünschte Name vergeben werden kann.

Beschreibung editieren

Lädt die DESCRIPTION-Datei in den HTML-Editor.

Umbenennen

Schaltet den Eintrag der Baumansicht in den Editier-Modus, so dass er umbenannt werden kann.

Kopieren

Öffnet einen Datei-Dialog in dem Sie den neuen Namen der zu kopierenden Datei bzw. des Verzeichnisses angeben. Dateien oder Verzeichnisse kann man auch mit Hilfe von Drag&Drop kopieren.

Löschen

Löscht die Datei oder das Verzeichnis. Sie werden vor dem Löschen gefragt, ob wirklich gelöscht werden soll.

Use

Ist eine Bibliothek als in use markiert, werden die Devices und Packages darin von der Suchfunktion berücksichtigt. Sie können auch durch einen Mausklick auf den Marker in der zweiten Spalte der Baumansicht die Bibliothek freigeben oder nicht.

Alle Bibliotheken laden

Alle Bibliotheken im Bibliothekspfad werden bei der Suche nach Devices und Packages berücksichtigt, d. h. alle Bibliotheken sind in use.

Keine Bibliothek laden

Keine der Bibliotheken ist in use (einschließlich der Bibliotheken, die nicht im Bibliothekspfad stehen).

Update

Tauscht alle Bauteile des geladenen Schaltplans oder Layouts, die aus dieser Bibliothek genommen wurden gegen die aktuelle Bauteile-Definition aus.

Update in Bibliothek

Tauscht alle in der geladenen Bibliothek verwendeten Gehäusedefinitionen gegen den aktuellen Stand aus dieser Bibliothek aus.

In Schaltplan einfügen

Startet den ADD-Befehl im Schaltplan-Editor für dieses Device. Das ist auch über Drag&Drop möglich.

In Platine einfügen

Startet den ADD-Befehl im Layout-Editor für dieses Package. Das ist auch über Drag&Drop möglich.

In Bibliothek kopieren

Kopiert das selektierte Device-Set oder Package in die geladene Bibliothek. Das ist auch über Drag&Drop möglich.

Neue Package-Variante in der Bibliothek

Erzeugt eine neue Package-Variante mit dem selektierten Package im aktuellen Device-Set der geladenen Bibliothek. Das ist auch über Drag&Drop möglich.

Projekt öffnen/schließen

Öffnet oder schließt ein Projekt. Dazu können Sie auch auf den Marker rechts vom Projekt-Eintrag in der Baumansicht klicken.

Neu

Öffnet ein Fenster mit der neuen Datei des entsprechenden Typs.

Öffnen

Öffnet ein Editor-Fenster mit dieser Datei. Das ist auch mit über Drag&Drop möglich.

Drucken...

Druckt die Datei auf dem System-Drucker aus. Weitere Informationen zur Benutzung der Druck-Dialoge entnehmen Sie bitte dem Kapitel Drucken auf dem System-Drucker.

Wird eine Datei über dies Kontext-Menü Option ausgedruckt, so wird immer die Datei von der Platte gelesen, auch wenn Sie ein offenes Editor Fenster haben in dem Sie die Datei editieren! Benutzen Sie den PRINT-Befehl um eine Zeichnung aus einem offenen Editor Fenster heraus zu drucken.
Bitte beachten Sie, dass Polygone in Platinen beim Ausdrucken über das Kontext-Menü nicht automatisch freigerechnet werden! Es werden lediglich die Umrisse dargestellt. Um die Polygone freigerechnet auszudrucken, laden Sie die Zeichnung in ein Editor-Fenster, geben Sie RATSNEST ein und dann PRINT.

Im ... ausführen

Startet das gewählte User-Language-Programm bzw. Script im aktuellen Schaltplan, Board oder in der Bibliothek. Das ist auch über Drag&Drop möglich.

Im Board laden

Lädt diesen Satz von Design Rules für das aktuelle Board. Das ist auch überDrag&Drop möglich.

Verzeichnisse

Mit dem Verzeichnisse-Dialog definiert man die Pfade, in denen nach Dateien gesucht werden soll.

Alle Felder können ein oder mehrere, durch Doppelpunkt (':') getrennte Verzeichnisse enthalten, in denen nach den verschiedenen Dateitypen gesucht wird.
Unter Windows werden die einzelnen Verzeichnisnamen durch Strichpunkte (';') getrennt.
Wird einer der Befehle OPEN, USE, SCRIPT oder RUN eingegeben, dann werden diese Pfade durchsucht, mit Priorität von links nach rechts. Wird der Datei-Dialog benutzt um eine Datei eines dieser Typen anzusprechen, so wird das Verzeichnis, in das der Anwender mittels des Datei-Dialogs navigiert hat, implizit an das Ende des jeweiligen Pfades angehängt.

Die Variablen $HOME und $EAGLEDIR werden verwendet, um das Home-Verzeichnis des Benutzers bzw. das EAGLE-Programm-Verzeichnis anzugeben.
Unter Windows gilt für $HOME entweder die Umgebungsvariable HOME (falls gesetzt), oder der Wert des Schlüssels "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\Personal" in der Windows-Registry, der den gültigen Pfad des Verzeichnisses "Eigene Dateien" enthält.

Datensicherung

Der Datensicherung-Dialog ermöglicht es Ihnen, den automatischen Backup individuell einzustellen.

Max. Anzahl der Sicherungskopien

Definiert wie viele Backup-Kopien Ihrer EAGLE-Dateien "aufgehoben" werden wenn eine Datei normal mit dem WRITE-Befehl abgespeichert wird (Default: 9).

Intervall f. automat. Sicherung (Minuten)

Bestimmt das Zeitintervall nachdem EAGLE automatisch eine Sicherungskopie aller modifizierten Zeichnungsdateien erzeugt (default ist 5 min.).

Projektdatei automatisch sichern

Ist diese Option gewählt, werden Ihre Projekteinstellungen automatisch gesichert, wenn Sie das Programm verlassen. Bitte beachten Sie, dass das momentan geöffnete Projekt nicht abgespeichert wird, wenn Sie diese Option ausschalten, was zur Folge hat, dass die Einstellung nicht nicht in der eagle.epf-Datei des Projekts gespeichert wird. Daher ist diese Option wieder eingeschaltet, wenn Sie das Projekt das nächste Mal öffnen. Wenn Sie wollen, dass diese Option für das aktuelle Projekt ausgeschaltet bleibt, müssen Sie manuell "Datei/Alles speichern" aus dem Pulldown-Menü wählen, nachdem Sie die Option ausgeschaltet haben.

Benutzeroberfläche

Der Benutzeroberfläche-Dialog ermöglicht es, das Erscheinungsbild der Editor-Fenster für Layout, Schaltplan und Bibliothek den eigenen Vorstellungen anzupassen.

Symbolleisten und Menüs

Menüleiste		aktiviert das Pulldown-Menü am oberen Rand des Editor-Fensters
Aktionsleiste		aktiviert die Toolbar mit Buttons für "Datei", "Drucken" etc.
Parameterleiste		aktiviert die dynamische Parameter-Toolbar, die alle Parameter des gerade aktiven Befehls enthält
Befehlsmenü		aktiviert die Kommando-Toolbar
Textmenü		aktiviert das Text-Menü
Seitenvorschau		aktiviert die Vorschau für Schaltplanseiten

Layout

Hintergrund		wählt die Hintergrundfarbe schwarz, weiß oder farbig im Layout-Editor
Mauszeiger		wählt einen kleines Kreuz oder ein großes Fadenkreuz als Mauszeiger im Layout-Editor

Schaltplan

Hintergrund		wählt die Hintergrundfarbe schwarz, weiß oder farbig im Schaltplan-Editor
Mauszeiger		wählt ein kleines Kreuz oder ein großes Fadenkreuz als Mauszeiger im Schaltplan-Editor

Hilfe

Direkthilfe		aktiviert die "Direkthilfe" Funktion, die einen kurzen Hinweis über die Bedeutung der Buttons gibt, wenn man den Mauszeiger über einen solchen bewegt
Benutzerführung		aktiviert die "Benutzerführung", die einen Hilfetext anzeigt, der dem Benutzer bei aktivem Befehl jederzeit den nächsten sinnvollen Schritt angibt

Misc

Immer Vektor-Schrift		Texte in Zeichnungen werden immer im EAGLE-eigenen Vektor-Font dargestellt, unabhängig welche Schriftart für einen Text ursprünglich gewählt wurde.
Mausrad-Zoomfaktor		definiert den Zoom-Faktor für das Hinein- bzw. Herauszoomen mit einer Rädchenmaus in einem Editor-Fenster ('0' schaltet diese Funktion aus, das Vorzeichen bestimmt die Drehrichtung des Rädchens)

Fensterpositionen

Der Fensterpositionen-Dialog ermöglicht es, die Positionen aller momentan geöffneten Fenster abzuspeichern, so dass später, wenn ein Fenster des gleichen Typs erneut geöffnet wird, dieses an der gleichen Stelle wie zuvor erscheint.

Sie können auch alle gespeicherten Fensterpositionen löschen, so dass es wieder dem Window-Manager überlassen ist, wo neu geöffnete Fenster platziert werden.

Auf Update prüfen

Die Option "Hilfe/Auf Update prüfen" im Pulldown-Menü des Control-Panels öffnet einen Dialog, der anzeigt, ob auf dem CadSoft-Server eine neue Version von EAGLE zur Verfügung steht.

Der Konfigurieren-Button öffnet einen Dialog, in dem Sie angeben können ob und wie häufig eine automatische Überprüfung auf eine neue Version beim Programmstart stattfinden soll (standardmäßig geschieht dies einmal am Tag). Falls Sie einen Proxy benutzen müssen, um das Internet anzusprechen, so können Sie diesen auch im Konfigurationsdialog angeben. Geben Sie dazu im Feld "Host" den vollen Namen des Proxy-Rechners ein, ohne etwaigen http://-Präfix, und im Feld "Port" eine optionale Port-Nummer.

Falls Sie auch über Betaversionen von EAGLE informiert werden möchten, so können sie die Option "Auch auf Betaversionen prüfen" einschalten.

Tastatur und Maus

Die Steuertasten (Alt, Ctrl und Shift) werden benutzt um das Verhalten bestimmter Maus-Aktionen zu verändern. Beachten Sie bitte, dass abhänging vom verwendeten Betriebssystem bzw. Window-Manager manche dieser Tasten (in Kombination mit Maus-Aktionen) möglicherweise nicht an Applikationen weitergeleitet werden, was zur Folge hat, dass einige der hier beschriebenen Funktionen dann nicht verfügbar sind.

Auf deutschen Tastaturen wird die Ctrl-Taste meist als Strg bezeichnet und die Shift-Taste als "Umschalt-Taste". Da EAGLE an einigen Stellen Code-Buchstaben für die Bezeichnung dieser Tasten verwendet (siehe ASSIGN und Befehlseingabe) verwenden wir durchgehend die Bezeichnungen Ctrl und Shift.

Alt

Ein Druck auf die Alt-Taste schaltet auf ein alternatives GRID um. Dies kann typischerweise ein feineres Raster als das normale sein, wodurch es zum Beispiel schnell und einfach möglich ist etwas in einem dicht belegten Gebiet fein zu positionieren, wofür das normal Raster zu grob wäre. Das alternative Grid bleibt so lange aktiv, wie die Alt-Taste gedrückt gehalten wird.

Ctrl

Wird die Ctrl-Taste zusammen mit der rechten Maustaste gedrückt so wird zwischen korrespondierenden Knickwinkeln hin und her geschaltet (dies betrifft nur Befehle die Knickwinkel unterstützen, wie etwa LINE).

Die Ctrl-Taste zusammen mit der linken Maustaste steuert spezielle Funktionen der einzelnen Befehle, wie zum Beispiel das Aufnehmen eines Objektes an seinem Aufhängepunkt beim MOVE-Befehl.

Falls ein Befehl eine Gruppe selektieren kann, so muss die Ctrl-Taste zusammen mit der rechten Maustaste gedrückt werden, um die Gruppe zu selektieren (ansonsten würde ein Kontext-Menü für das ausgewählte Objekt geöffnet).

Unter Mac OS X ist anstatt der Ctrl-Taste die Cmd-Taste zu verwenden.

Shift

Wird die Shift-Taste zusammen mit der rechten Maustaste gedrückt so wird die Richtung des Weiterschaltens des Knickwinkels umgekehrt (dies betrifft nur Befehle die Knickwinkel unterstützen, wie etwa LINE).

Die Shift-Taste zusammen mit der linken Maustaste steuert spezielle Funktionen der einzelnen Befehle, wie zum Beispiel das Löschen eines übergeordneten Objektes beim DELETE-Befehl.

Esc

Wird bei einem aktiven Befehl die Esc-Taste gedrückt, so wird die aktuelle Aktion dieses Befehls beendet, ohne dass der gesamte Befehl abgebrochen wird (falls die Kommandozeile Text enthält so wird dieser zuerst gelöscht und der nächste Druck auf die Esc-Taste wirkt auf den Befehl). Für den MOVE-Befehl zum Beispiel bedeutet dies, dass ein am Mauszeiger befindliches Objekt "fallengelassen" wird und ein anderes Objekt selektiert werden kann.

Crsr-Up/Down

Die Tasten Crsr-Up (Pfeil nach oben) bzw. Crsr-Down (Pfeil nach unten) erlauben es in der Kommandozeile des Editor-Fensters früher eingegeben Befehlszeilen wieder herzuholen ("History-Funktion").

Funktionstasten

Beliebige Kommandos können mit dem ASSIGN-Befehl auf Funktionstasten gelegt werden.

Linke Maustaste

Die linke Maustaste dient generell zum Selektieren, Zeichnen und Plazieren von Objekten.

Mittlere Maustaste

Die mittlere Maustaste wechselt den aktuellen Layer oder spiegelt das am Mauszeiger hängende Objekt.

Folgende Befehle unterstützen die mittlere Maustaste:

ADD Bauteil spiegeln

ARC aktiven Layer wechseln

CIRCLE aktiven Layer wechseln

COPY Objekt spiegeln

INVOKE Gatter spiegeln

LABEL aktiven Layer wechseln

LINE aktiven Layer wechseln

MOVE Objekt oder Gruppe spiegeln

PASTE Gruppe spiegeln

POLYGON aktiven Layer wechseln

RECT aktiven Layer wechseln

ROUTE aktiven Layer wechseln

SMD aktiven Layer wechseln

TEXT aktiven Layer wechseln

Click&Drag mit der mittleren Maustaste verschiebt die Zeichnung innerhalb des Editor-Fensters.

Rechte Maustaste

Die rechte Maustaste wird im Wesentlichen dazu verwendet, eine Gruppe zu selektieren, am Mauszeiger hängende Objekte zu rotieren, den Knickwinkel zu ändern sowie für einige andere, befehlsspezifische Funktionen.

Wird ein Objekt mit der rechten Maustaste angeklickt, so wird ein kontextspezifisches Popup-Menü angezeigt, aus dem Befehle, die für dieses Objekt anwendbar sind, ausgewählt werden können. Falls gerade ein Befehl aktiv ist, der auf eine Gruppe angewendet werden kann, enthält das Popup-Menü einen entsprechenden Eintrag.

Folgende Befehle unterstützen die rechte Maustaste:

ADD Bauteil drehen

ARC Drehsinn des Kreisbogens ändern

BUS Knickwinkel ändern

CHANGE Change auf Gruppe anwenden

DELETE Gruppe löschen

GROUP Polygon schließen

INVOKE Gatter drehen

LABEL Label drehen

LINE Knickwinkel ändern

MIRROR Gruppe spiegeln

MOVE Objekt drehen bzw. Gruppe selektieren

NET Knickwinkel ändern

PAD Pad drehen

PASTE Gruppe drehen

PIN Pin drehen

POLYGON Knickwinkel ändern

RIPUP Ripup auf Gruppe anwenden

ROTATE Gruppe drehen

ROUTE Knickwinkel ändern

SMD Smd drehen

SPLIT Knickwinkel ändern

TEXT Text drehen

Maus-Rädchen

Innerhalb eines Editor-Fensters kann mit dem Maus-Rädchen die Zoomstufe verändert werden.

Benachbarte Objekte selektieren

Wenn Sie an einer Stelle ein Objekt selektieren wollen, an der mehrere Objekte eng beieinander liegen, nimmt der Mauszeiger die Form eines Vierfach-Pfeils an, und es erscheint die Frage

Hervorgehobenes Objekt auswählen? (links=ja, rechts=weiter, ESC=abbrechen)

Drücken Sie die rechte Maustaste, um zyklisch durch alle in Frage kommenden Objekte "durchzutasten".

Mit der linken Maustaste wählen Sie das gewünschte Objekt aus.

Um die Auswahl ganz abzubrechen, drücken Sie die Esc-Taste.

Mit dem Befehl

SET Select_Factor select_radius;

können Sie beeinflussen, wie groß der "Selektionsradius" sein soll.

Wurde die ursprüngliche Selektion mit der rechten Maustaste gemacht, so erscheint ein kontextspezifisches Popup-Menü für das erste ausgewählte Objekt, welches als ersten Eintrag "Weiterschalten" enthält. Durch Klicken auf diesen Eintrag wird zyklisch durch die Objekte im Selektionsradius geschaltet.

Editor-Fenster

EAGLE kennt unterschiedliche Typen von Daten-Dateien. Jeder davon wird in einem eigenen Editor-Fenster-Typ bearbeitet. Wenn Sie eines der Objekte durch Doppelklick selektieren oder vom Control Panel aus eine Datei mit Datei/Öffnen laden, dann öffnet sich ein Editor-Fenster für diesen Dateityp.

Bibliotheks-Editor
Schaltplan-Editor
Layout-Editor
Text-Editor

Bibliotheks-Editor

Der Bibliotheks-Editor dient dazu, Bauelemente-Bibliotheken (*.lbr) zu editieren.

Nach dem Öffnen des Bibliotheks-Editor-Fensters zeigt die Arbeitsfläche das Inhaltsverzeichnis der Bibliothek; je eine Liste der Devices, Packages und Symbole in dieser Bibliothek. Von hier aus kann man die Devices, Packages und Symbole verwalten: Zum Editieren öffnen, Umbenennen, Löschen, Duplizieren usw. Mit einem Klick auf eine der Schaltflächen Add unter der jeweiligen Liste kann man neue Devices, Packages und Symbole anlegen oder von einer anderen Bibliothek importieren.

Bibliotheks-Objekt editieren

Im Bibliothekseditier-Modus kann man Devices, Packages und Symbole editieren

Package: Die Gehäuse-Bauform.

Symbol: Das Schaltplan-Symbol.

Device: Definition des vollständigen Bauteils. Besteht aus ein oder mehreren Packages und ein oder mehreren Symbolen. Die Symbole können unterschiedlich sein (z.B. verschiedene Gatter).

Mit einem Klick auf eines der Devices-, Packages- oder Symbols-Tabs werden die entsprechenden Objekte gezeigt.

Wenn Sie ein neues Objekt anlegen möchten, schreiben Sie den Namen des neuen Objekts in die Zeile Neu. Sie können auch den Namen eines bereits existierenden Objekts angeben und dieses editieren.

Um ein bestehendes Objekt aus einer anderen Bibliothek zu importieren, wählen Sie das entsprechende Tab im Dialog und klicken Sie unten auf die Schaltfläche Import.... Es öffnet sich ein neues Fenster, das alle Devices, Packages und Symbole der Bibliotheken, die zur Zeit benutzt werden (also "in use" sind) zeigt. Wählen Sie das Objekt, das Sie importieren wollen und klicken Sie OK. Das Objekt wird in die geöffnete Bibliothek kopiert und zum Editieren geöffnet. Beachten Sie, dass beim Importieren eines Devices auch alle zugehörigen Packages und Symbole importiert werden.

Layout-Editor

Der Layout-Editor dient dazu, Layouts (*.brd) zu editieren.

Wenn im selben Verzeichnis eine Schaltplan-Datei (*.sch) mit demselben Namen existiert, wird beim Öffnen eines Layouts automatisch auch ein Schaltplan-Editor-Fenster mit dieser Datei als Icon auf den Desktop gelegt. Das ist notwendig, damit die Schaltplan-Datei geladen ist, wenn Änderungen an der Platine die Back-Annotation zum Schaltplan erforderlich machen.

Schaltplan-Editor

Der Schaltplan-Editor dient dazu, Schaltpläne (*.sch) zu editieren.

Wenn im selben Verzeichnis eine Layout-Datei (*.brd) mit demselben Namen existiert, wird beim Öffnen eines Layouts automatisch auch ein Layout-Editor-Fenster mit dieser Datei als Icon auf den Desktop gelegt. Das ist notwendig, damit die Layout-Datei geladen ist, wenn Änderungen an der Platine die Forward-Annotation zum Layout erforderlich machen.

Mit Hilfe der Combo-Box in der Action-Toolbar des Schaltplan-Editor-Fensters können Sie zwischen den einzelnen Schaltplan-Seiten wechseln oder neue Seiten anlegen. Sie können dazu auch den EDIT-Befehl verwenden.

Text-Editor

Der Text-Editor dient dazu, Textdateien zu editieren.

Die Textdatei muss eine reine ASCII-Datei sein und darf keine Steuerzeichen enthalten. Als Anwendungen sind in erster Linie vorgesehen: das Schreiben von User-Language-Programmen und Script-Dateien.

Verwenden eines externen Text-Editors

Falls Sie anstatt des in EAGLE eingebauten lieber einen externen Text-Editor verwenden wollen, so können Sie den zum Starten dieses Editors nötigen Befehl im Dialog "Optionen/Benutzeroberfläche" eintragen.

In diesem Befehl werden die folgenden Platzhalter durch aktuelle Werte ersetzt:

%C die Spalte, in die der Cursor positioniert werden soll (zur Zeit immer 1)

%F der Name der zu ladenden Datei

%L die Zeile, in die der Cursor positioniert werden soll

Ist als Befehl lediglich ein Minuszeichen ('-') eingetragen, so wird EAGLE niemals ein Text-Editor-Fenster öffnen. Dies ist hilfreich für Benutzer, die ihren Text-Editor immer selbst starten wollen.

Folgende Einschränkungen gelten bei der Verwendung eines externen Text-Editors:

Der externe Text-Editor läuft in einem separaten Prozess, und EAGLE hat keine Möglichkeit zu wissen ob die geladene Datei verändert worden ist oder nicht. Sie sind selber dafür verantwortlich, die Datei nach eventuellen Änderungen abzuspeichern.
Wird die selbe Datei mehrfach in den Text-Editor geladen, so hängt es von der Konfiguration des verwendeten Text-Editors ab, ob dieser jedesmal ein neues Fenster öffnet, oder die Datei immer in das selbe Fenster lädt.
Die Fenster des externen Text-Editors erscheinen nicht in der Liste der EAGLE-Fenster, und werden daher auch nicht im Projekt mit abgespeichert und somit auch bei einem späteren Neu-Laden des Projekts nicht wieder geöffnet.
Beim Verlassen von EAGLE werden die externen Text-Editor-Prozesse beendet. Es hängt vom verwendeten Betriebssystem und dem konkreten Text-Editor ab, ob Sie im Falle einer veränderten Datei gefragt werden, ob diese abgespeichert werden soll.
Die Funktion "Datei/Alles speichern" speichert nicht die im externen Text-Editor geänderten Dateien.
Der unter Umständen beim Laden einer Datei aus einer älteren EAGLE-Version erzeugte Update-Bericht wird immer mit dem eingebauten Text-Editor angezeigt.

Editor-Befehle

Wechsel der Betriebsart/Dateibefehle

CLOSE		Bibliothek nach Editieren schließen
EDIT		Zeichnung laden/anlegen
EXPORT		ASCII-Liste erzeugen (z.B. Netzliste)
OPEN		Bibliothek zum Editieren laden
QUIT		EAGLE verlassen
REMOVE		Dateien/Bibliotheks-Elemente löschen
SCRIPT		Befehlsdatei ausführen
USE		Bibliothek zum Plazieren von Elementen laden
WRITE		Zeichnung/Bibliothek speichern

Zeichnungen/Bibliotheken editieren

ADD		Element in Zeichnung / Symbol in Device einfügen
ALIGN		Ordnet ausgewählte Objekte im Layout-Editor an
ARC		Kreisbogen zeichnen
ATTRIBUTE		Attribute definieren
CIRCLE		Kreis zeichnen
CLASS		Netzklassen definieren
COPY		Objekte/Elemente kopieren
CUT		Vorher definierte Gruppe in die Zwischenablage kopieren
DELETE		Objekt löschen
DESCRIPTION		Beschreibung eines Objektes ändern
GROUP		Gruppe für spätere Operation definieren
HOLE		Nichtleitende Bohrung definieren
LAYER		Layer definieren/wechseln
LINE		Linie oder geroutete Verbindung zeichnen
MIRROR		Objekt spiegeln
MITER		Linien-Verbindungsstellen abschrägen
MODULE		Modul und Modul-Instanz erzeugen
MOVE		Objekt bewegen oder rotieren
NAME		Objekt mit Namen versehen
PASTE		Inhalt der Zwischenablage in die Zeichnung einfügen
PORT		Port zu einem Modul hinzufügen
POLYGON		Polygon zeichnen
RECT		Rechteck zeichnen
ROTATE		Objekt rotieren
SLICE		Linien auftrennen
SMASH		NAME/VALUE zum Bewegen vorbereiten
SPLIT		Linien knicken
TEXT		Text zu einer Zeichnung hinzufügen
VALUE		Wert für Element definieren/ändern

Spezielle Befehle für Platinen

DRC		Design Rule Check durchführen
ERRORS		DRC-Fehler anzeigen
LOCK		Bauteilposition verriegeln
RATSNEST		Kürzeste Luftlinien anzeigen
REPLACE		Bauteil ersetzen
RIPUP		Signal auflösen
ROUTE		Signal routen
SIGNAL		Signal (Luftlinie) definieren
VIA		Durchkontaktierung (Via) plazieren

Spezielle Befehle für Schaltpläne

BOARD		Platine aus einem Schaltplan erzeugen
BUS		Buslinie zeichnen
ERC		Electrical Rule Check ausführen
GATESWAP		Äquivalente 'Gates' tauschen
INVOKE		'Gate' aus Device plazieren
JUNCTION		Verbindungspunkt plazieren
LABEL		Label für Bus oder Netz plazieren
NET		Netz definieren
PINSWAP		Äquivalente Pins tauschen

Spezielle Befehle für Bibliotheken

CONNECT		Pin/Pad-Zuordnung festlegen
PACKAGE		Package für Device definieren
PAD		Pad in Package einfügen
PIN		Pin in Symbol einfügen
PREFIX		Default-Präfix für Device festlegen
REMOVE		Elemente aus Bibliothek löschen
RENAME		Symbol/Package/Device neu benennen
SMD		Smd-Pad in Package einfügen
TECHNOLOGY		Technologien für ein Device definieren
VALUE		Definieren, ob Value-Text änderbar

Befehle für Bildschirmdarstellung und Benutzer-Interface

ASSIGN		Tasten belegen
CHANGE		EAGLE-Parameter ändern
DISPLAY		Layer anzeigen/ausblenden
GRID		Raster/Einheit definieren
MENU		Befehls-Menü konfigurieren
SET		Programm-Parameter einstellen
WINDOW		Bildausschnitt verändern

Weitere Befehle

AUTO		Autorouter starten
HELP		Hilfe-Seite anzeigen
INFO		Information über Objekt zeigen
MARK		Messmarke setzen/entfernen
OPTIMIZE		Linien-Segmente zusammenfassen
PRINT		Ausdrucken auf dem System-Drucker
REDO		Zurückgenommene Befehle ausführen
RUN		User-Language-Programm ausführen
SHOW		Objekt hell darstellen
UNDO		Befehle zurücknehmen
UPDATE		Bibliotheks-Objekte aktualisieren

Befehlseingabe

EAGLE-Befehle können auf vier verschiedene Arten eingegeben werden:

mit der Tastatur als Text

mit der Maus, durch Anklicken von Menüpunkten oder Icons

mit belegten Tasten (siehe ASSIGN-Befehl)
mit einer Script-Datei (siehe SCRIPT-Befehl)

Diese Eingabearten können auch gemischt verwendet werden.

Für die Befehlsbeschreibungen gelten folgende Regeln:

Befehle und Parameter in GROSSBUCHSTABEN werden direkt eingegeben (bzw. aus dem Befehlsmenü mit der Maus selektiert). Bei der Eingabe werden Groß- und Kleinbuchstaben nicht unterschieden.

Parameter in Kleinbuchstaben werden durch Namen, Zahlenwerte oder Schlüsselwörter ersetzt. Beispiel:

Syntax: GRID grid_size grid_multiple;

Input: GRID 1 10;

Verkürzte Eingabe

Befehle und andere Schlüsselwörter können beliebig abgekürzt werden, solange sie nicht mit anderen Schlüsselwörtern verwechselt werden können.

Alternative Parameter

Das Zeichen | bedeutet, dass Parameter alternativ angegeben werden können. Beispiel:

Syntax: SET BEEP OFF | ON;

Input: SET BEEP OFF;

oder

SET BEEP ON;

Wiederholungspunkte

Die Zeichen .. bedeuten, dass die Funktion mehrfach ausgeführt werden kann bzw. dass mehrere Parameter vom gleichen Typ erlaubt sind. Beispiel:

Syntax: DISPLAY option layer_name..

Input: DISPLAY TOP PINS VIAS

Koordinatenangaben

Das Zeichen • bedeutet normalerweise, dass an dieser Stelle im Befehl mit der linken Maustaste ein Objekt anzuklicken ist. Beispiel:

Syntax: MOVE • •..

Input: MOVE

Mausklick auf erstes zu bewegendes Element

Mausklick auf das Ziel

Mausklick auf zweites zu bewegendes Element

etc.

An diesem Beispiel sehen Sie auch, wie die Wiederholungspunkte bei Befehlen mit Mausklicks zu verstehen sind.

Jeder Mausklick stellt eine Koordinatenangabe dar. Will man den Befehl textuell eingeben, dann kann man anstelle des Mausklicks die Koordinaten über die Tastatur in folgender Form eingeben:

(x y)

Dabei sind x und y Zahlen in der mit dem GRID-Befehl gewählten Einheit. Die textuelle Eingabemöglichkeit ist insbesondere für Script-Dateien erforderlich.
Soll eine andere als die im GRID-Befehl gewählte Einheit verwendet werden, so kann diese an die angegebenen Koordinaten angefügt werden, wie in

(100mil 200mil)

Erlaubte Einheiten sind mm, mic, mil und in. Es können auch unterschiedliche Einheiten für x und y verwendet werden.
Die spezielle Koordinate

(@)

kann dazu benutzt werden, die aktuelle Position des Mauszeigers im Zeichenfenster zu referenzieren. So würde zum Beispiel die Eingabe

MOVE R1 (@)

das Bauteil mit dem Namen R1 an die Position verschieben, auf der der Mauszeiger im Moment steht.

Nach der öffnenden Klammer darf eine beliebige Kombination der folgenden Steuerzeichen folgen um einen bestimmten Tastendruck zusammen mit dem "Mausklick" zu simulieren oder die Art der Koordinaten zu modifizieren:

> rechte Maustaste

A Alt-Taste

C Ctrl-Taste

P Polar-Koordinaten (relativ zur Marke, x = Radius, y = Winkel in Grad, gegen den Uhrzeigersinn)

R Relative Koordinaten (relativ zur Marke)

S Shift-Taste

Die Eingabe

(CR> 1 2)

würde zum Beispiel einem "Mausklick" mit der rechten Maustaste an den Koordinaten (1 2) relativ zur Marke, mit gedrückter Ctrl-Taste entsprechen (natürlich würde es vom konkreten Befehl abhängen was genau mit dieser Art von Eingabe geschehen würde). Falls momentan keine Marke gesetzt ist, beziehen sich Koordinaten mit R oder P auf den Ursprung der Zeichnung. Die Steuerzeichen sind unabhängig von Groß-/Kleinschreibung, ihre Reihenfolge spielt keine Rolle und es muss auch kein Leerzeichen zwischen ihnen und der ersten Ziffer der Koordinaten stehen. Das obige Beispiel könnte also ebenso als (r>c1 2) geschrieben werden. Als "Polar-Koordinaten" eingegebene Werte werden intern als die entsprechenden (x y) Koordinaten abgespeichert.

Als Beispiel für die Koordinateneingabe in Textform soll die Eingabe der Platinenumrisse mit exakten Maßen dienen:

GRID 1 MM;
CHANGE LAYER DIMENSION;
LINE 0 (0 0) (160 0) (160 100) (0 100) (0 0);
GRID LAST;

Dezimalzahlen

Bei der Eingabe von Dezimalzahlen in der Kommandozeile des Editor-Fensters oder in Dialog-Eingabefeldern können Sie das Komma als Dezimal-Trennzeichen verwenden (also zum Beispiel 12,34), falls Ihre landesspezifischen Einstellungen dies zulassen. Allerdings sollten Sie beim Schreiben eines Scripts oder eines ULPs, welches EAGLE-Befehle über die exit()-Funktion zurückgibt, immer den Punkt als Dezimal-Trennzeichen verwenden (also 12.34). Ansonsten kann es sein, dass Ihr Script bzw. ULP nicht auf anderen Systemen lauffähig ist. Generell ist es empfehlenswert, immer den Punkt als Dezimal-Trennzeichen zu verwenden.

Strichpunkt

Der Strichpunkt (';') schließt einen Befehl ab. Ein Befehl muss dann mit einem Strichpunkt abgeschlossen werden, wenn er weniger als die maximal mögliche Zahl von Parametern enthält. Der Befehl

WINDOW;

frischt beispielsweise das Zeichenfenster auf, während

WINDOW FIT

das Zeichenfenster so skaliert, dass die gesamte Zeichnung sichtbar ist. Im zweiten Fall ist kein Strichpunkt erforderlich, weil bereits klar ist, dass kein weiterer Parameter folgen kann.

ADD

Funktion: Elemente in eine Zeichnung einfügen.
Symbole in ein Device einfügen.
Syntax: ADD package_name[@library_name] [name] [orientation] •..
ADD device_name[@library_name] [name [gate]] [orientation] •..
ADD symbol_name [name] [options] •..
Maustasten: Mittlere spiegelt das Bauteil.
Rechte dreht das Bauteil.
Shift+Rechte kehrt die Richtung der Drehung um.

Siehe auch UPDATE, USE, INVOKE

Der ADD-Befehl holt ein Schaltplan-Symbol (Gate) oder ein Package aus der aktiven Bibliothek und plaziert es in der Zeichnung.

Bei der Device-Definition holt der ADD-Befehl ein Symbol in das Device.

Üblicherweise klickt man den ADD-Befehl an und selektiert das Package/Symbol aus dem sich öffnenden Menü. Nun können die Parameter (falls erforderlich) per Tastatur eingegeben werden.

Wenn device_name Platzhalter enthält ('*' oder '?') und mehr als ein Device gefunden wird, öffnet sich der ADD-Dialog. Daraus kann dann das gewünschte Device gewählt werden. Beachten Sie, dass die Beschreibung Checkbox im ADD-Dialog ausgeschaltet wird, sobald ein ADD-Befehl mit einem Device-Namen in der Kommandozeile angegeben wird, egal ob der Name Platzhalter enthält oder nicht. Der Grund hierfür ist, dass ein in der Kommandozeile angegebener Device-Name nur in den Namen der Devices gesucht wird und nicht in deren Beschreibungen.

Plaziert wird das Package/Symbol mit der linken Maustaste, rotiert wird es mit der rechten. Nachdem es plaziert wurde, hängt sofort eine weitere Kopie am Mauszeiger.

Wenn bereits ein Device oder Package mit gleichem Namen (aus derselben Bibliothek) in der Zeichnung existiert und die Bibliothek seit dem Plazieren des ursprünglichen Elements modifiziert wurde, startet EAGLE automatisch einen Library-Update bei dem Sie gefragt werden, ob die Bauteile durch die neuere Bibliotheksdefinition ersetzt werden sollen. Achtung: Nach einem Library-Update sollten Sie immer den Design Rule Check (DRC) und den Electrical Rule Check (ERC) laufen lassen!

Package oder Symbol in Zeichnung holen

Platzhalter

Der ADD-Befehl kann mit Platzhaltern ('*' oder '?') arbeiten, um ein bestimmtes Element zu finden. Der ADD-Dialog zeigt alle gefundenen Elemente in einer Baumansicht und dazu auch eine Voransicht des Devices und der Package-Variante.

Um ein Element direkt zu plazieren, verwenden Sie die Syntax:

ADD devicename@libraryname

devicename darf Platzhalter enthalten und libraryname darf entweder direkt der Bibliotheksname (wie "ttl" oder "ttl.lbr"), der volle Name mit Pfadangabe (wie "/home/mydir/myproject/ttl.lbr" oder "../lbr/ttl"), oder die URN einer heruntergeladenen Verwaltete Bibliothek (zum Beispiel "urn:adsk.eagle:library:462") sein. Im Falle von Leerzeichen im Pfad ist der Gesamtausdruck von Hochkommas einzuschließen (z.B. ADD 'DEV1A@/home/my dir/ttl.lbr').

Namen

Der Parameter package_name, device_name bzw. symbol_name ist der Name, unter dem das Package/Device/Symbol in der Bibliothek abgelegt ist. Er wird üblicherweise aus einem Menü selektiert. Der Parameter name ist der Name, den das Element in der Zeichnung erhalten soll. Falls der Name als eine Orientierung oder Option interpretiert werden könnte, muss er in Hochkommas eingeschlossen werden. Wird er nicht explizit angegeben, erhält das Element einen generierten Namen.

Beispiel:

ADD DIL14 IC1 •

holt das Package DIL14 in die Platine und gibt ihm den Namen IC1.

Wird im Schaltplan kein Name angegeben, erhält das Gate als Namen den bei der Device-Definition mit PREFIX festgelegten Präfix, ergänzt um eine fortlaufende Zahl (z.B. IC1).

Beispiel:

ADD 7400 • • • • •

Hier werden der Reihe nach fünf Gatter aus Bausteinen des Typs 7400 plaziert. Sofern als Präfix "IC" definiert wurde und die Einzelgatter innerhalb eines 7400 die Namen A...D haben, erhalten die Gatter im Schaltplan die Namen IC1A, IC1B, IC1C, IC1D, IC2A (falls schon Elemente mit demselben Präfix plaziert wurden, wird die Zählung mit der nächsten laufenden Nummer fortgesetzt. Siehe auch INVOKE.

Während ein Objekt am Cursor hängt, können Sie den Namen, unter dem es in die Zeichnung eingefügt wird, ändern. Damit können Sie mehrere Bauteile gleichen Typs unter verschiedenen, explizit vergebenen Namen einfügen:

Beispiel:

ADD CAP C1 • C5 • C7 •

Bestimmte Gatter

Um ein bestimmtes Gatter eines neu hinzugefügten Bausteins zu holen kann nach dem Bauteilnamen der Name des Gatters angegeben werden:

Beispiel:

ADD 7400 IC1 A •

Dies ist vor allem dafür gedacht, wenn ein Schaltplan über ein Script generiert werden soll. Beachten Sie bitte, dass wenn ein bestimmtes Gatter geholt wird keine anderen Gatter mit Add-Level MUST oder ALWAYS automatisch mit geholt werden, und Sie müssen zumindest die MUST-Gatter mit dem INVOKE-Befehl aktivieren (ansonsten wird sie der Electrical Rule Check als fehlend melden).

Orientation

Dieser Parameter gibt die Ausrichtung des Objektes in der Zeichnung an. Normalerweise rotiert man Objekte mit der rechten Maustaste. In Script-Dateien verwendet man die textuellen Angaben für diesen Parameter:

[S][M]Rnnn

S setzt das Spin-Flag, welches die Funktion abschaltet, die Texte von unten oder rechts lesbar hält (nur im Board-Kontext verfügbar)

M setzt das Mirror-Flag, welches das Objekt an der Y-Achse spiegelt

Rnnn setzt die Rotation auf den angegebenen Wert, der im Board-Kontext im Bereich 0.0...359.9 (mit einer Auflösung von 0.1 Grad) und im Schaltplan-Kontext einer der Werte 0, 90, 180 oder 270 sein darf (Winkel dürfen auch negativ angegeben werden, sie werden dann in den entsprechenden positiven Wert umgewandelt)

Die Schlüsselbuchstaben S, M und R können als Groß- oder Kleinbuchstaben angegeben werden und es muss mindestens R gefolgt von einer Zahl vorhanden sein.

Ist das Mirror-Flag sowohl in einem Bauteil als auch in einem in dessen Package befindlichen Text gesetzt, so heben sich diese in ihrer Wirkung auf. Das gleiche gilt für das Spin-Flag.

Beispiele:

R0 keine Rotation

R90 um 90° gegen den Uhrzeigersinn gedreht

R-90 um 90° im Uhrzeigersinn gedreht (wird in 270° umgerechnet)

MR0 an der Y-Achse gespiegelt

SR0 Texte werden mit "Spin" dargestellt

SMR33.3 um 33.3° gegen den Uhrzeigersinn gedreht, gespiegelt und mit "Spin"

Default: R0

ADD DIL16 R90 (0 0);

plaziert ein 16poliges DIL-Gehäuse, das um 90 Grad gegen den Uhrzeigersinn gedreht ist, an den Koordinaten (0 0).

Fehlermeldungen

Soll ein Gate aus einem unvollständig definierten Device geholt werden, erscheint eine Fehlermeldung (siehe BOARD-Befehl). Dies lässt sich mit dem Befehl "SET CHECK_CONNECTS OFF;" verhindern. Vorsicht: Der BOARD-Befehl führt diese Prüfung auf alle Fälle durch. Sie abzuschalten ist also nur sinnvoll, wenn man keine Platine erzeugen will.

Symbol in Device holen

Bei der Device-Definition holt der ADD-Befehl ein vorher definiertes Symbol in das Device. Als Optionen sind zwei Parameter (Swaplevel und Addlevel) möglich, die in beliebiger Reihenfolge eingegeben werden können. Beide lassen sich mit dem CHANGE-Befehl voreinstellen und ändern. Auch der im ADD-Befehl angegebene Wert bleibt als Voreinstellung erhalten.

Swaplevel

Der Swaplevel ist eine ganze Zahl, wobei gilt:

0: Das Symbol (Gate) kann im Schaltplan nicht mit einem anderen vertauscht werden.

>0 Das Symbol (Gate) kann im Schaltplan mit jedem anderen Symbol dieses Typs vertauscht werden, das denselben Swaplevel hat (auch zwischen verschiedenen Devices).

Default: 0

Addlevel

Für diesen Parameter gibt es folgende Möglichkeiten:

`Next`		Wenn ein Device mehr als ein Gate aufweist, werden in den Schaltplan der Reihe nach die Symbole mit Addlevel Next geholt.
`Must`		Wird ein beliebiges Symbol eines Device in den Schaltplan geholt, dann muss auch ein mit dem Addlevel Must definiertes Symbol im Schaltplan erscheinen. Dies geschieht automatisch. Es kann nicht gelöscht werden, bevor nicht alle anderen Symbole aus diesem Device gelöscht sind. Falls nur noch Must-Symbole aus einem Device vorhanden sind, löscht der DELETE-Befehl das ganze Device.
`Always`		Wie Must, allerdings kann ein Symbol mit Addlevel Always gelöscht und mit INVOKE wieder in den Schaltplan geholt werden.
`Can`		Gibt es in einem Device Next-Gates, dann werden Can-Gates nur geholt, wenn sie explizit mit INVOKE angefordert werden. Ein Symbol mit Addlevel Can wird mit ADD nur dann in den Schaltplan geholt, wenn das Device nur Can- und Request-Gates enthält.
`Request`		Diese Eigenschaft wird sinnvollerweise für Versorgungs-Symbole von Bausteinen verwendet. Request-Gates können nur explizit in den Schaltplan geholt werden (INVOKE) und werden intern nicht mitgezählt. Das hat zur Folge, dass in Bausteinen mit nur einem Gatter und einem Versorgungsspannungs-Symbol der Gatter-Name nicht zum Bauteil-Namen hinzugefügt wird. Im Falle eines 7400 mit vier Gattern (plus Versorgungsspannung) heißen die einzelnen Gatter im Schaltplan beispielsweise IC1A, IC1B, IC1C und IC1D. Ein 68000 mit nur einem Gate, dem Prozessor-Symbol, heisst dagegen im Schaltplan z. B. IC1, da sein separates Spannungsversorgungs-Symbol als Gate nicht mitzählt.

Beispiel:

ADD PWR 0 REQUEST •

holt das Symbol PWR (z. B. ein Versorgungssymbol) und definiert dafür den Swaplevel 0 (nicht tauschbar) und den Addlevel Request.

ALIGN

Funktion: Ordnet ausgewählte Objekte im Layout-Editor an.
Syntax: ALIGN • ..

Zur Zeit unterstützt der ALIGN-Befehl keine Kommandozeilen-Parameter.

sort()

Funktion: Sortiert ein Array oder einen Satz von Arrays.
Syntax: void sort(int number, array1[, array2,...]);

Die sort-Funktion sortiert entweder direkt ein array1, oder sie sortiert einen Satz von Arrays (beginnend mit array2), wobei array1 ein int-Array ist, das als Pointer-Array verwendet wird.

In jedem Fall definiert das Argument number die Zahl der Einträge im Array oder in den Arrays.

Einzelnes Array sortieren

Wenn die sort-Funktion mit einem einzelnen Arrray aufgerufen wird, wird dieses Array direkt sortiert, wie im folgenden Beispiel:

string A[];
int n = 0;
A[n++] = "World";
A[n++] = "Hello";
A[n++] = "The truth is out there...";
sort(n, A);
for (int i = 0; i < n; ++i)
    printf(A[i]);

Einen Satz von Arrays sortieren

Wenn die sort-Funktion mit mehr als einem Array aufgerufen wird, muss das erste Array ein int-Array sein, während alle anderen Arrays von jedem Typ sein können. Sie enthalten die zu sortierenden Daten. Das folgende Beispiel zeigt, wie das erste Array als Pointer verwendet wird:

numeric string Nets[], Parts[], Instances[], Pins[];
int n = 0;
int index[];
schematic(S) {
  S.nets(N) N.pinrefs(P) {
    Nets[n] = N.name;
    Parts[n] = P.part.name;
    Instances[n] = P.instance.name;
    Pins[n] = P.pin.name;
    ++n;
    }
  sort(n, index, Nets, Parts, Instances, Pins);
  for (int i = 0; i < n; ++i)
      printf("%-8s %-8s %-8s %-8s\n",
             Nets[index[i]], Parts[index[i]],
             Instances[index[i]], Pins[index[i]]);
  }

Die Idee dahinter ist, dass an ein Netz mehrere Pins angeschlossen sein können. In einer Netzliste wollen Sie unter Umständen die Netznamen sortieren und innerhalb eines Netzes die Bauteilnamen, und so weiter.

Beachten Sie die Verwendung des Schlüsselworts numeric in den String-Arrays. Das führt dazu, dass die String-Sortierung einen numerischen Teil am Ende des Namens berücksichtigt (IC1, IC2,... IC9, IC10 anstelle von IC1, IC10, IC2,...IC9).

Wenn man einen Satz von Arrays sortiert, muss das erste (Index-)Array vom Typ int sein und braucht nicht initialisiert zu werden. Jeder vor dem Aufruf der sort-Funktion vorhandene Inhalt wird mit den resultierenden Indexwerten überschrieben.

status()

Funktion: Zeigt eine Statusmeldung in der Statuszeile an.
Syntax: void status(string message);

Siehe auch dlgMessageBox()

Die status-Funktion zeigt die angegebene message in der Statuszeile des Editor-Fensters an, in dem das ULP läuft.

system()

Funktion: Führt ein externes Programm aus.
Syntax: int system(string command);
Rückgabewert: Die system-Funktion liefert den "Exit Status" des Befehls zurück. Dieser ist normalerweise 0 wenn alles gut gegangen ist, und ungleich 0 wenn ein Fehler aufgetreten ist.

Die system-Funktion führt das im command angegebene externe Programm aus und wartet, bis dieses beendet ist.

Ein-/Ausgabe-Umleitung

Soll ein externes Programm seine Eingaben von einer bestimmten Datei lesen (bzw. seine Ausgaben in eine bestimmte Datei schreiben), so muss die Ein- bzw. Ausgabe umgeleitet werden.

Unter Linux und Mac OS X geschieht dies einfach durch Anhängen von '<' bzw. '>' an die Befehlszeile, jeweils gefolgt von der gewünschten Datei, wie in
system("program < infile > outfile");
womit program gestartet wird und es von infile liest und nach outfile schreibt.

Unter Windows muss explizit ein Kommando-Prozessor gestartet werden um dies zu ermöglichen, wie in
system("cmd.exe /c program < infile > outfile");
(auf DOS-basierten Windows-Systemen verwenden Sie command.com anstatt cmd.exe).

Ausführung im Hintergrund

Die system-Funktion wartet bis das angegebene Programm beendet ist. Dies ist sinnvoll für Programme, die nur wenige Sekunden laufen, oder die Aufmerksamkeit des Benutzers komplett an sich ziehen.

Läuft ein externes Programm längere Zeit, und Sie wollen, dass der system()-Aufruf sofort zurückkehrt, ohne zu warten, bis das Programm beendet ist, so können Sie unter Linux und Mac OS X einfach ein '&' an die Befehlszeile anfügen, wie in
system("program &");

Unter Windows muss explizit ein Kommando-Prozessor gestartet werden um dies zu ermöglichen, wie in
system("cmd.exe /c start program");
(auf DOS-basierten Windows-Systemen verwenden Sie command.com anstatt cmd.exe).

Beispiel

int result = system("simulate -f filename");

Hiermit würde ein Simulationsprogramm aufgerufen und diesem eine Datei übergeben werden, die das ULP gerade erzeugt hat. Beachten Sie bitte, dass simulate hier nur ein Beispiel und nicht Bestandteil des EAGLE-Paketes ist!

Falls Sie Kontrolle darüber haben wollen, welche externen Programme tatsächlich ausgeführt werden, können Sie sich eine Hilfsfunktion schreiben, welche den Benutzer vor der Ausführung des externen Programms um Bestätigung bittet, wie etwa

int MySystem(string command)
{
  if (dlgMessageBox("!Ok to execute the following command?<p><tt>" + command + "</tt>", "&Yes", "&No") == 0)
     return system(command);
  return -1;
}
int result = MySystem("simulate -f filename");

Einheiten-Konvertierung

Funktion: Konvertiert interne Einheiten.
Syntax: real u2inch(int n);
real u2mic(int n);
real u2mil(int n);
real u2mm(int n);
int inch2u(real n);
int mic2u(real n);
int mil2u(real n);
int mm2u(real n);
Rückgabewert: u2inch liefert den Wert von n in Inch.
u2mic liefert den Wert von n in Micron (1/1000mm).
u2mil liefert den Wert von n in Mil (1/1000inch).
u2mm liefert den Wert von n in Millimeter.
inch2u liefert den Wert von n (der in Inch vorliegt) als interne Einheiten.
mic2u liefert den Wert von n (der in Micron vorliegt) als interne Einheiten.
mil2u liefert den Wert von n (der in Mil vorliegt) als interne Einheiten.
mm2u liefert den Wert von n (der in Millimeter vorliegt) als interne Einheiten.

Siehe auch UL_GRID

EAGLE speichert alle Koordinaten und Größen als int-Werte mit einer Auflösung von 1/320000mm (0.003125µ). Die oben angegebenen Einheiten-Konvertier-Funktionen können dazu verwendet werden, die internen Einheiten in die gewünschten Maßeinheiten umzuwandeln und umgekehrt.

Beispiel

board(B) {
  B.elements(E) {
    printf("%s at (%f, %f)\n", E.name,
           u2mm(E.x), u2mm(E.y));
    }
  }

Netzwerk-Funktionen

Netzwerk-Funktionen dienen der Kommunikation mit entfernten Rechnern im Internet.

Die folgenden Netzwerk-Funktionen sind verfügbar:

neterror()
netget()
netpost()

neterror()

Funktion: Liefert die Fehlermeldung der zuletzt ausgeführten Netzwerk-Funktion.
Syntax: string neterror(void);
Rückgabewert: neterror liefert eine textuelle Meldung, die den Fehler beschreibt, der bei der zuletzt verwendeten Netzwerk-Funktion aufgetreten ist. Falls kein Fehler aufgetreten ist, wird ein leerer String zurückgegeben.

Siehe auch netget, netpost

Die neterror-Funktion sollte nach jeder Verwendung einer der anderen Netzwerk-Funktionen aufgerufen werden, deren Rückgabewert negativ war und somit einen Fehler angezeigt hat. Der Rückgabewert von neterror ist ein textueller String, der dem Benutzer präsentiert werden kann.

Bei Fehlern im Zusammenhang mit SSL-Verbindungen (HTTPS) beachten Sie auch den Hinweis in netget.

Beispiel

string Result;
if (netget(Result, "http://web.cadsoft.de/cgi-bin/http-test?see=me&hear=them") >= 0) {
   // process Result
   }
else
   dlgMessageBox(neterror());

netget()

Funktion: Führt eine GET-Anforderung auf dem Netzwerk aus.
Syntax: int netget(dest, string url[, int timeout]);
Rückgabewert

Siehe auch netpost, neterror, fileread

Die netget-Funktion schickt den angegebenen url an das Netzwerk und speichert das Ergebnis in der Variablen dest. Falls timeout Sekunden lang keine Netzwerkaktivität erfolgt, wird die Verbindung abgebrochen. Der Standardwert hierfür ist 20 Sekunden.
Der url muß das zu verwendende Protokoll enthalten (HTTP, HTTPS oder FTP) und kann Parameter der Form Name=Wert enthalten, wie in

http://web.cadsoft.de/cgi-bin/http-test?see=me&hear=them
ftp://ftp.cadsoft.de/eagle/userfiles/README

Falls für den Zugriff auf den fernen Rechner eine Benutzerkennung und ein Passwort notwendig ist, kann dieses in folgender Form angegeben werden:

https://userid:password@www.secret-site.com/...

Wenn dest ein Character-Array ist, wird das Ergebnis als rohe Binärdaten behandelt und der Rückgabewert entspricht der Anzahl der Bytes, die in dem Character-Array gespeichert wurden.

Wenn dest ein String-Array ist, wird das Ergebnis als Text behandelt (eine Zeile pro Array-Member) und der Rückgabewert entspricht der Anzahl der Zeilen, die in dem Array gespeichert wurden. Newline-Zeichen werden entfernt.

Wenn dest ein String ist, wird das gesamte Ergebnis in diesem String gespeichert und der Rückgabewert entspricht der Länge des Strings. Beachten Sie, dass im Falle von binären Daten das Ergebnis beim ersten Auftreten eines Bytes mit dem Wert 0x00 abgeschnitten wird.

Falls Sie einen Proxy benutzen müssen, um das Internet mit HTTP bzw. HTTPS anzusprechen, so können Sie diesen im "Konfigurieren"-Dialog unter "Hilfe/Auf Update prüfen" im Control Panel konfigurieren.

SSL-Verbindungen

Für SSL-Verbindungen (Anfrage per HTTPS) sind Zertifikate erforderlich, die auf manchen Systemen fehlen können oder deren Gültigkeit abgelaufen sein kann. Die Verbindung scheitert dann mit entsprechender Fehlermeldung, die Sie mit neterror() abfragen können.
Anhand der Fehlermeldung sollte es möglich zu sein, fehlende Zertifikate nachzuinstallieren oder zu aktualisieren und die Verbindung so zum Laufen zu bringen. Wie dies durchzuführen ist, hängt von Ihrem System ab (In Windows z.B. unter Systemsteuerung/Internetoptionen usw.).

Beispiel

string Result;
if (netget(Result, "http://web.cadsoft.de/cgi-bin/http-test?see=me&hear=them") >= 0) {
   // process Result
   }
else
   dlgMessageBox(neterror());

netpost()

Funktion: Führt eine POST-Anforderung auf dem Netzwerk aus.
Syntax: int netpost(dest, string url, string data[, int timeout[, string content_type] ]);
Rückgabewert

Siehe auch netget, neterror, fileread

Die netpost-Funktion schickt die in data angegebenen Daten an den angegebenen url im Netzwerk und speichert das Ergebnis in der Variablen dest. Falls timeout Sekunden lang keine Netzwerkaktivität erfolgt, wird die Verbindung abgebrochen. Der Standardwert hierfür ist 20 Sekunden.
Wird content_type angegeben, so überschreibt das den Standardwert von of "text/html; charset=utf-8".
Der url muß das zu verwendende Protokoll enthalten (HTTP oder HTTPS).

Falls für den Zugriff auf den fernen Rechner eine Benutzerkennung und ein Passwort notwendig ist, kann dieses in folgender Form angegeben werden:

https://userid:password@www.secret-site.com/...

Wenn dest ein Character-Array ist, wird das Ergebnis als rohe Binärdaten behandelt und der Rückgabewert entspricht der Anzahl der Bytes, die in dem Character-Array gespeichert wurden.

Falls Sie mit SSL-Verbindungen (HTTPS) auf Probleme stoßen sollten, beachten Sie den Hinweis in netget

Beispiel

string Data = "see=me\nhear=them";
string Result;
if (netpost(Result, "http://web.cadsoft.de/cgi-bin/http-test", Data) >= 0) {
   // process Result
   }
else
   dlgMessageBox(neterror());

Print-Funktionen

Print-Funktionen dienen zur Ausgabe formatierter Strings.

Die folgenden Print-Funktionen sind verfügbar:

printf()
sprintf()

printf()

Funktion: Schreibt formatiere Ausgaben in eine Datei.
Syntax: int printf(string format[, argument, ...]);
Rückgabewert

Siehe auch sprintf, output, fileerror

Format-String

Der Format-String steuert, wie die Argumente konvertiert, formatiert und ausgegeben werden. Es müssen genau so viele Argumente vorhanden sein, wie für das Format erforderlich sind. Die Zahl und der Typ der Argumente werden für jedes Format geprüft, und wenn sie nicht den Anforderungen entsprechen, wird eine Fehlermeldung ausgegeben.

Der Format-String enthält zwei Objekt-Typen - einfache Zeichen und Format-Specifier:

Einfache Zeichen werden direkt ausgegeben
Format-Specifier holen Argumente von der Argument-Liste und formatieren sie

Format-Specifier

Ein Format-Specifier hat folgende Form:

% [flags] [width] [.prec] type

Jede Format-Spezifizierung beginnt mit dem Prozentzeichen (%). Nach dem % kommt folgendes, in dieser Reihenfolge:

optional eine Folge von Flag-Zeichen, [flags]
optional ein Breiten-Specifier, [width]
optional ein Präzisions-Specifier, [.prec]
das Konvertiertyp-Zeichen, type

Konvertiertyp-Zeichen

`d`		signed decimal int
`o`		unsigned octal int
`u`		unsigned decimal int
`x`		unsigned hexadecimal int (with a, b,...)
`X`		unsigned hexadecimal int (with A, B,...)
`f`		signed real value von der Form `[-]dddd.dddd`
`e`		signed real value von der Form `[-]d.dddd`e`[±]ddd`
`E`		wie `e`, aber mit E für Exponent
`g`		signed real value entweder wie `e` oder `f`, abhängig vom gegebenen Wert und Präzision
`G`		wie `g`, aber mit E für Exponent, wenn `e`-Format verwendet wird
`c`		einzelnes Zeichen
`s`		Character-String
`%`		das `%`-Zeichen wird ausgegeben

Flag-Zeichen

Die folgenden Flag-Zeichen können in jeder Kombination und Reihenfolge auftreten.

"-" das formatierte Argument wird innerhalb des Feldes linksbündig ausgegeben; normalerweise ist die Ausgabe rechtsbündig

"+" ein positiver Wert mit Vorzeichen wird mit Pluszeichen (+) ausgegeben; normalerweise werden nur negative Werte mit Vorzeichen ausgegeben

" " ein positiver Wert mit Vorzeichen wird mit Leerzeichen am Anfang ausgegeben; wenn "+" und " " angegeben sind, überschreibt "+" die Angabe " "

Width-Specifier

Der Width-Specifier setzt die minimale Feldbreite für einen Ausgabewert.

Die Breite wird entweder direkt mit einem Dezimalstellen-String oder indirekt mit einem Stern (*) gesetzt. Wenn Sie * verwenden, legt das Argument, das dem (mit diesem Format formatierten) Argument im Aufruf vorhergeht, (und vom Typ int sein muss) die minimale Feldbreite fest.

Auf keinen Fall führt ein nicht existierendes oder zu ein kleines Feld dazu, dass ein Wert abgeschnitten wird. Wenn das Ergebnis der Konvertierung breiter ist als das Feld, wird das Feld einfach so vergrößert, dass das Ergebnis platz hat.

n Mindestens n Zeichen werden ausgegeben. Wenn der Ausgabewert weniger als n Zeichen hat, wird er mit Leerzeichen aufgefüllt (rechts wenn das "-"-Flag gesetzt ist, sonst links).

0n Mindestens n Zeichen werden ausgegeben. Wenn der Ausgabewert weniger als n Zeichen hat, wird links mit Nullen aufgefüllt.

* Die Argument-Liste liefert den Width-Specifier, der dem eigentlichen (zu formatierenden) Argument vorausgehen muss.

Präzisions-Specifier

Ein Präzisions-Specifier beginnt immer mit einem Punkt (.), um ihn von einem vorangehenden Width-Specifier zu trennen. Dann wird, wie bei "Width", die Präzision entweder direkt mit einem Dezimalstellen-String oder indirekt mit einem Stern (*) angegeben. Wenn Sie * verwenden, legt das Argument, das dem (mit diesem Format formatierten) Argument im Aufruf vorhergeht, (und vom Typ int sein muss) die Präzision fest.

keiner Präzision auf Standardwert gesetzt.

.0 Für int-Typen, Präzision wird auf Default gesetzt; für real-Typen, kein Dezimalpunkt wird ausgegeben.

.n n Zeichen oder n Dezimalstellen werden ausgegeben. Wenn der Ausgabewert mehr als n Zeichen hat, kann er abgeschnitten oder gerundet werden (abhängig vom Typ-Zeichen).

* Die Argument-Liste liefert den Präzisions-Specifier, der dem eigentlichen (zu formatierenden) Argument vorausgehen muss.

Default-Präzisionswerte

`douxX`		1
`eEf`		6
`gG`		alle signifikanten Stellen
`c`		keine Auswirkung
`s`		gesamten String ausgeben

Wie die Präzisionsangabe (`.n`) die Konvertierung beeinflusst

`douxX`		.n spezifiziert dass mindestens n Zeichen ausgegeben werden. Wenn das Eingangs-Argument weniger als n Stellen hat, wird der Ausgangswert links mit Nullen aufgefüllt. Wenn das Eingangs-Argument mehr als n Stellen hat, wir die Ausgabe nicht abgeschnitten.
`eEf`		.n spezifiziert dass n Zeichen nach dem Dezimalpunkt ausgegeben werden, und die letzte ausgegebene Stelle wird gerundet.
`gG`		.n spezifiziert dass höchstens n signifikante Stellen ausgegeben werden.
`c`		.n hat keinen Einfluss auf die Ausgabe.
`s`		.n spezifiziert dass nicht mehr als n Zeichen gedruckt werden.

Der binäre Wert 0

Im Gegensatz zu sprintf kann die printf-Funktion den binären Wert 0 (0x00) ausgeben.

char c = 0x00;
printf("%c", c);

Beispiel

int i = 42;
real r = 3.14;
char c = 'A';
string s = "Hello";
printf("Integer: %8d\n", i);
printf("Hex:     %8X\n", i);
printf("Real:    %8f\n", r);
printf("Char:    %-8c\n", c);
printf("String:  %-8s\n", s);

sprintf()

Funktion: Schreibt eine formatierte Ausgabe in einen String.
Syntax: int sprintf(string result, string format[, argument, ...]);
Rückgabewert: Die sprintf-Funktion liefert die Zahl der Zeichen, die in den result-String geschrieben wurden.
Im Falle eines Fehlers liefert sprintf den Wert -1.

Siehe auch printf

Format-String

Siehe printf.

Der binäre Wert 0

Bitte beachten Sie, dass sprintf den binären Wert 0 (0x00) nicht verarbeiten kann. Wenn der Ergebnis-String 0x00 enthält, werden die folgenden Zeichen ignoriert. Verwenden Sie printf um binäre Daten auszugeben.

Beispiel

string result;
int number = 42;
sprintf(result, "The number is %d", number);

String-Funktionen

String-Funktionen werden dazu verwendet, Character-Strings zu manipulieren.

Die folgenden String-Funktionen sind verfügbar:

strchr()
strjoin()
strlen()
strlwr()
strrchr()
strrstr()
strsplit()
strstr()
strsub()
strtod()
strtol()
strupr()
strxstr()

strchr()

Funktion: Durchsucht einen String nach dem ersten Vorkommen eines gegebenen Zeichens.
Syntax: int strchr(string s, char c[, int index]);
Rückgabewert: Die strchr-Funktion liefert den Integer-Offset des Zeichen im String oder -1, wenn das Zeichen nicht vorkommt.

Siehe auch strrchr, strstr

Falls index angegeben wird, beginnt die Suche an dieser Position. Negative Werte werden vom Ende des Strings her gezählt.

Beispiel

string s = "This is a string";
char c = 'a';
int pos = strchr(s, c);
if (pos >= 0)
   printf("The character %c is at position %d\n", c, pos);
else
   printf("The character was not found\n");

strjoin()

Funktion: Erzeugt aus einem String-Array einen einzelnen String.
Syntax: string strjoin(string array[], char separator);
Rückgabewert: Die strjoin-Funktion liefert die kombinierten Einträge von array.

Siehe auch strsplit, lookup, fileread

strjoin fügt alle Einträge aus array, getrennt durch den angegebenen separator zusammen, und liefert den Ergebnis-String.

Wenn separator ein Newline-Zeichen ('\n') ist, wird der Ergebnis-String mit einem Newline-Zeichen abgeschlossen. So erhält man eine Textdatei mit N Zeilen (jede davon ist mit einem Newline-Zeichen abgeschlossen). Die Datei wird mit den Funktionen fileread() eingelesen und mit split in ein Array mit N Strings aufgeteilt und zu dem ursprünglichen String, der aus der Datei eingelesen wurde, hinzugefügt.

Beispiel

string a[] = { "Field 1", "Field 2", "Field 3" };
string s = strjoin(a, ':');

strlen()

Funktion: Berechnet die Länge eines Strings.
Syntax: int strlen(string s);
Rückgabewert: Die strlen-Funktion liefert die Zahl der Zeichen im String.

Beispiel

string s = "This is a string";
int l = strlen(s);
printf("The string is %d characters long\n", l);

strlwr()

Funktion: Wandelt Großbuchstaben in einem String in Kleinbuchstaben um.
Syntax: string strlwr(string s);
Rückgabewert: Die strlwr-Funktion liefert den modifizierten String. Der Original-String (als Parameter übergeben) wird nicht geändert.

Siehe auch strupr, tolower

Beispiel

string s = "This Is A String";
string r = strlwr(s);
printf("Prior to strlwr: %s - after strlwr: %s\n", s, r);

strrchr()

Funktion: Durchsucht einen String nach dem letzten Vorkommen eines gegebenen Zeichens.
Syntax: int strrchr(string s, char c[, int index]);
Rückgabewert: Die strrchr-Funktion liefert den Integer-Offset des Zeichens im String oder -1, wenn das Zeichen nicht vorkommt.

Siehe auch strchr, strrstr

Falls index angegeben wird, beginnt die Suche an dieser Position. Negative Werte werden vom Ende des Strings her gezählt.

Beispiel

string s = "This is a string";
char c = 'a';
int pos = strrchr(s, c);
if (pos >= 0)
   printf("The character %c is at position %d\n", c, pos);
else
   printf("The character was not found\n");

strrstr()

Funktion: Durchsucht einen String nach dem letzten Vorkommen eines gegebenen Substrings.
Syntax: int strrstr(string s1, string s2[, int index]);
Rückgabewert: Die strrstr-Funktion liefert den Integer-Offset des ersten Zeichens von s2 in s1, oder -1, wenn der Substring nicht vorkommt.

Siehe auch strstr, strrchr

Falls index angegeben wird, beginnt die Suche an dieser Position. Negative Werte werden vom Ende des Strings her gezählt.

Beispiel

string s1 = "This is a string", s2 = "is a";
int pos = strrstr(s1, s2);
if (pos >= 0)
   printf("The substring starts at %d\n", pos);
else
   printf("The substring was not found\n");

strsplit()

Funktion: Teilt einen String in einzelne Felder.
Syntax: int strsplit(string &array[], string s, char separator);
Rückgabewert: Die strsplit-Funktion liefert die Anzahl der Einträge die nach array kopiert wurden.

Siehe auch strjoin, lookup, fileread

strsplit teilt den String s am angegebenen separator und speichert die so erzeugten Felder in array.

Wenn separator ein Newline-Zeichen ist ('\n'), wird das letzte Feld einfach ignoriert, sofern es leer ist. So erhält man eine Textdatei, die aus N Zeilen besteht (jede durch Newline beendet). Diese wird durch die Funktion fileread() eingelesen und in ein Array von N Strings aufgeteilt. Mit jedem anderen separator ist ein leeres Feld am Ende des Strings gültig. So entstehen aus "a:b:c:" 4 Felder, das letzte davon ist leer.

Beispiel

string a[];
int n = strsplit(a, "Field 1:Field 2:Field 3", ':');

strstr()

Funktion: Durchsucht einen String nach dem ersten Vorkommen eines gegebenen Substrings.
Syntax: int strstr(string s1, string s2[, int index]);
Rückgabewert: Die strstr-Funktion liefert den Integer-Offset des ersten Zeichens von s2 in s1, oder -1, wenn der Substring nicht vorkommt.

Siehe auch strrstr, strchr, strxstr

Falls index angegeben wird, beginnt die Suche an dieser Position. Negative Werte werden vom Ende des Strings her gezählt.

Beispiel

string s1 = "This is a string", s2 = "is a";
int pos = strstr(s1, s2);
if (pos >= 0)
   printf("The substring starts at %d\n", pos);
else
   printf("The substring was not found\n");

strsub()

Funktion

Extrahiert einen Substring aus einem String.

Syntax

string strsub(string s, int start[, int length]);

Rückgabewert

Die strsub-Funktion liefert den Substring, der durch start und length definiert ist.

Der Wert für length muss positiv sein, andernfalls wird ein leerer String zurückgegeben. Wenn length nicht angegeben ist, wird der Reststring (beginnend bei start) zurückgegeben.

Wenn start auf eine Position ausserhalb des Strings deutet, wird ein leerer String zurückgegeben.

Beispiel

string s = "This is a string";
string t = strsub(s, 4, 7);
printf("The extracted substring is: %s\n", t);

strtod()

Funktion: Konvertiert einen String in einen Real-Wert.
Syntax: real strtod(string s);
Rückgabewert

Siehe auch strtol

Beispiel

string s = "3.1415";
real r = strtod(s);
printf("The value is %f\n", r);

strtol()

Funktion: Konvertiert einen String in einen Integer-Wert.
Syntax: int strtol(string s);
Rückgabewert

Siehe auch strtod

Beispiel

string s = "1234";
int i = strtol(s);
printf("The value is %d\n", i);

strupr()

Funktion: Konvertiert Kleinbuchstaben in einem String in Großbuchstaben.
Syntax: string strupr(string s);
Rückgabewert: Die strupr-Funktion liefert den modifizierten String. Der Original-String (als Parameter übergeben) wird nicht geändert.

Siehe auch strlwr, toupper

Beispiel

string s = "This Is A String";
string r = strupr(s);
printf("Prior to strupr: %s - after strupr: %s\n", s, r);

strxstr()

Funktion: Durchsucht einen String nach dem ersten Vorkommen eines regulären Ausdrucks.
Syntax: int strxstr(string s1, string s2[, int index[, int &length]]);
Rückgabewert: Die strxstr-Funktion liefert den Integer-Offset des Teilstrings in s1, auf den der reguläre Ausdruck in s2 passt, oder -1, wenn der reguläre Ausdruck nicht passt.

Siehe auch strstr, strchr, strrstr

Falls index angegeben wird, beginnt die Suche an dieser Position. Negative Werte werden vom Ende des Strings her gezählt.

Falls length angegeben wird, wird die aktuelle Länge des gefundenen Teilstrings in dieser Variablen zurückgegeben.

Reguläre Ausdrücke erlauben es Ihnen, ein Muster innerhalb eines Text-Strings zu finden. Zum Beispiel würde der reguläre Ausdruck "i.*a" eine Zeichenfolge finden, die mit 'i' beginnt, gefolgt von einem beliebigen Zeichen ('.') beliebig oft ('*'), und mit 'a' endet. Er würde auf "is a", "is this a" oder "ia" passen.
Einzelheiten zu regulären Ausdrücken finden Sie zum Beispiel in dem Buch Reguläre Ausdrücke von Jeffrey E. F. Friedl.

Beispiel

string s1 = "This is a string", s2 = "i.*a";
int len = 0;
int pos = strxstr(s1, s2, 0, len);
if (pos >= 0)
   printf("The substring starts at %d and is %d charcaters long\n", pos, len);
else
   printf("The substring was not found\n");

Zeit-Funktionen

Zeit-Funktionen werden dazu verwendet, die Zeit- und Datums- Informationen zu erhalten und weiterzuverarbeiten.

Die folgenden Zeit-Funktionen sind verfügbar:

sleep()
t2day()
t2dayofweek()
t2hour()
t2minute()
t2month()
t2second()
t2string()
t2year()
time()
timems()

time()

Funktion: Holt die gegenwärtige Systemzeit.
Syntax: int time(void);
Rückgabewert: Die time-Funktion liefert die gegenwärtige Systemzeit als Zahl von Sekunden, die seit einem systemabhängigen Referenzzeitpunkt vergangen sind.

Siehe auch Zeit-Konvertierungen, filetime

Beispiel

int CurrentTime = time();

timems()

Funktion: Liefert die Zeit in Millisekunden seit dem Start des ULPs.
Syntax: int timems(void);
Rückgabewert: Die timems-Funktion liefert die Zeit in Millisekunden seit dem Start des ULPs.
Nach 86400000 Millisekunden (d.h. alle 24 Stunden) beginnt der Wert wieder bei 0.

Siehe auch Zeit-Konvertierungen, filetime, timems()

Beispiel

int elapsed = timems();

Zeit-Konvertierungen

Funktion: Zeit-Wert in Tag, Monat, Jahr etc. konvertieren.
Syntax: int t2day(int t);
int t2dayofweek(int t);
int t2hour(int t);
int t2minute(int t);
int t2month(int t);
int t2second(int t);
int t2year(int t);

string t2string(int t[, string format]);
Rückgabewert: t2day liefert den Tag des Monats (1..31)
t2dayofweek liefert den Tag der Woche (0=sunday..6)
t2hour liefert die Stunde (0..23)
t2minute liefert die Minute (0..59)
t2month liefert den Monat (0..11)
t2second liefert die Sekunde (0..59)
t2year liefert das Jahr (einschließlich Jahrhundert!)
t2string liefert einen formatierten String, der Datum und Zeit enthält

Siehe auch time

Die t2string-Funktion ohne den optionalen format-Parameter wandelt die gegebene Zeit t in einen landesspezifischen String in Ortszeit um.

Wird t2string mit einem format-String aufgerufen, so bestimmt dieses Format die Darstellung des Ergebnisses.

Folgende Ausdrücke können innerhalb des format-Strings benutzt werden:

d der Tag als Zahl ohne führende Null (1 bis 31)

dd der Tag als Zahl mit führender Null (01 bis 31)

ddd der abgekürzte, landesspezifische Name des Tages (z.B. "Mon" bis "Son")

dddd der ausgeschriebene, landesspezifische Name des Tages (z.B. "Montag" bis "Sonntag")

M der Monat als Zahl ohne führende Null (1-12)

MM der Monat als Zahl mit führender Null (01-12)

MMM der abgekürzte, landesspezifische Name des Monats (z.B. "Jan" bis "Dez")

MMMM der ausgeschriebene, landesspezifische Name des Monats (z.B. "Januar" bis "Dezember")

yy das Jahr als zweistellige Zahl (00-99)

yyyy das Jahr als vierstellige Zahl

h die Stunde ohne führende Null (0 bis 23 bzw. 1 bis 12 in AM/PM-Schreibweise)

hh die Stunde mit führender Null (00 bis 23 bzw. 01 bis 12 in AM/PM-Schreibweise)

m die Minute ohne führende Null (0 bis 59)

mm die Minute mit führender Null (00 bis 59)

s die Sekunde ohne führende Null (0 bis 59)

ss die Sekunde mit führender Null (00 bis 59)

z die Millisekunden ohne führende Nullen (immer 0, da die gegebene Zeit nur eine Auflösung von einer Sekunde hat)

zzz die Millisekunden mit führenden Nullen (immer 000, da die gegebene Zeit nur eine Auflösung von einer Sekunde hat)

AP AM/PM-Schreibweise benutzen (AP wird durch "AM" bzw. "PM" ersetzt)

ap am/pm-Schreibweise benutzen (ap wird durch "am" bzw. "pm" ersetzt)

U die gegebene Zeit in UTC anzeigen (muß das erste Zeichen sein; standardmäßig erfolgt die Anzeige in Ortszeit)

Alle anderen Zeichen werden unverändert übernommen. In einfache Hochkommas eingeschlossene Zeichen werden als Text betrachtet und nicht als Ausdrücke. Zwei aufeinanderfolgende einfache Hochkommas ('') werden im Ergebnis durch ein einfaches Hochkomma ersetzt.

Beispiel

int t = time();
printf("It is now %02d:%02d:%02d\n",
       t2hour(t), t2minute(t), t2second(t));
printf("ISO time is %s\n", t2string(t, "Uyyyy-MM-dd hh:mm:ss"));

Objekt-Funktionen

Objekt-Funktionen werden dazu verwendet, allgemeine Informationen von Objekten zu erfragen.

Die folgenden Objekt-Funktionen sind verfügbar:

clrgroup()
ingroup()
setgroup()
setvariant()
variant()

clrgroup()

Funktion: Löscht die Gruppen-Flags eines Objekts.
Syntax: void clrgroup(object);

Siehe auch ingroup(), setgroup(), GROUP-Befehl

Die clrgroup()-Funktion löscht die Gruppen-Flags des gegebenen Objekts, so dass es nicht mehr Bestandteil einer vorher definierten Gruppe ist.

Wird die Funktion auf ein Objekt angewendet, das andere Objekte enthält (wie etwa ein UL_BOARD oder UL_NET), so werden die Gruppen-Flags aller enthaltenen Objekte rekursiv gelöscht, wobei entsprechende Einschränkungen gelten wie bei setgroup().

Beispiel

board(B) {
  B.elements(E)
    clrgroup(E);
  }

ingroup()

Funktion: Prüft ob ein Objekt in der Gruppe liegt.
Syntax: int ingroup(object);
Rückgabewert: Die ingroup-Funktion liefert einen Wert ungleich 0 wenn das gegebene Objekt in der Gruppe liegt.

Siehe auch clrgroup(), setgroup(), GROUP-Befehl

Wurde im Editor eine Gruppe definiert, so kann die ingroup()-Funktion benutzt werden um zu prüfen, ob ein bestimmtes Objekt Bestandteil der Gruppe ist.

Objekte mit einem einzelnen Aufhängepunkt, die in der aktuellen Zeichnung gezielt selektiert werden können (wie etwa UL_TEXT, UL_VIA, UL_CIRCLE etc.), liefern beim Aufruf von ingroup() einen Wert ungleich 0 wenn dieser Aufhängepunkt innerhalb der Gruppe liegt.

Ein UL_WIRE liefert 0, 1, 2 oder 3, je nachdem, ob keiner, der erste, der zweite oder beide Endpunkte in der Gruppe liegen.

Ein UL_RECTANGLE bzw. UL_FRAME liefert einen Wert ungleich 0 wenn einer oder mehrere seiner Eckpunkte in der Gruppe liegen. Der Wert hat Bit 0 gesetzt für die rechte obere Ecke, Bit 1 für die linke obere, Bit 2 für die linke untere und Bit 3 für die rechte untere Ecke.

Übergeordnete Objekte, die ohne Aufhängepunkt sind (UL_NET, UL_SEGMENT, UL_SIGNAL, UL_POLYGON) oder als Zeichnungsobjekt eigentlich nicht vorhanden sind (UL_SHEET, UL_DEVICESET, UL_SYMBOL, UL_PACKAGE), liefern einen Wert ungleich 0 wenn eines oder mehrere der Objekte, die sie enthalten, in der Gruppe liegen. Details zu den Objekt-Hierarchien siehe Objekt-Typen.
UL_CONTACTREF und UL_PINREF liefern einen Wert ungleich 0 wenn der referenzierte UL_CONTACT bzw. UL_PIN in der Gruppe liegt.
Für andere nicht selektierbare Objekte wie UL_GRID, UL_VARIANT oder Wires eines UL_TEXT- oder UL_FRAME-Objektes ist das Verhalten von ingroup() undefiniert und sollte daher nicht verwendet werden.

Ermitteln des Kontextmenü-Objekts

Wenn das ULP von einem Kontextmenü aus gestartet wurde, wird aus dem Auswahlobjekt eine einelementige Gruppe gebildet, so dass es mit ingroup() identifiziert werden kann (siehe auch SET und RUN).

Beispiel

output("group.txt") {
  board(B) {
    B.elements(E) {
      if (ingroup(E))
         printf("Element %s is in the group\n", E.name);
      }
    }
  }

setgroup()

Funktion: Setzt die Gruppen-Flags eines Objekts.
Syntax: void setgroup(object[, int flags]);

Siehe auch clrgroup(), ingroup(), GROUP-Befehl

Die setgroup()-Funktion setzt die Gruppen-Flags des gegebenen Objekts, so dass es Bestandteil der Gruppe ist.

Werden keine flags angegeben, so wird das Objekt als Ganzes zur Gruppe hinzugefügt (d.h. alle seine Aufhängepunkte, falls es mehrere hat).

Hat flags einen Wert ungleich Null, werden nur die Gruppen-Flags der angegebenen Punkte gesetzt. Für einen UL_WIRE bedeutet dies, dass '1' das Gruppen-Flag des ersten Punkts setzt, '2' das des zweiten und '3' beide. Etwaige bereits gesetzte Gruppen-Flags werden durch den Aufruf von setgroup() nicht verändert.

Wird die Funktion auf ein Objekt angewendet, das andere Objekte enthält (wie etwa ein UL_BOARD oder UL_NET), so werden die Gruppen-Flags aller enthaltenen Objekte rekursiv gesetzt mit folgenden Einschränkungen:
Es gilt nicht für UL_LIBRARY und UL_SCHEMATIC. Untergeordnete Objekte, die nicht oder nicht einzeln selektierbar sind, werden nicht markiert (z.B. UL_GRID- oder UL_VARIANT-Objekte oder Wires von UL_TEXT- oder UL_FRAME-Objekten). Details zu den Objekt-Hierarchien siehe Objekt-Typen.

Beispiel

board(B) {
  B.elements(E)
    setgroup(E);
  }

setvariant()

Funktion: Wählt die aktuelle Bestückungsvariante.
Syntax: int setvariant(string name);

Siehe auch variant(), UL_VARIANTDEF, VARIANT-Befehl

Die setvariant()-Funktion setzt die aktuelle Bestückungsvariante auf die mit name angegebene. Dies kann dazu benutzt werden durch alle Bauteile zu gehen und deren Daten genau so zu "sehen", wie sie in der gegebenen Variante definiert sind.

name muss eine gültige Bestückungsvariante referenzieren, die in der geladenen Zeichnung enthalten ist.

Diese Funktion liefert einen Wert ungleich 0 zurück, falls die angegebene Bestückungsvariante existiert, ansonsten 0.

Die mittels eines Aufrufs von setvariant() eingestellte Bestückungsvariante ist nur so lange gültig, bis das User Language Programm endet. Danach ist die Variante in der Zeichnung wieder die selbe wie vor dem Start des ULPs.

In einem Board kann das Setzen der Bestückungsvariante nur erfolgen, wenn auch ein konsistenter Schaltplan geladen ist.

Beispiel

if (setvariant("My variant")) {
   // do something ...
else
   // error: unknown variant

variant()

Funktion: Abfrage der aktuellen Bestückungsvariante.
Syntax: string variant(void);

Siehe auch setvariant(), UL_VARIANTDEF, VARIANT-Befehl

Die variant()-Funktion liefert den Namen der aktuellen Bestückungsvariante. Ist momentan keine Variante ausgewählt, wird ein leerer String ('') geliefert.

Beispiel

string CurrentVariant = variant();

XML-Funktionen

XML-Funktionen werden dazu verwendet, XML-Daten (Extensible Markup Language) zu verarbeiten.

Die folgenden XML-Funktionen sind verfügbar:

xmlattribute()
xmlattributes()
xmlelement()
xmlelements()
xmltags()
xmltext()

xmlattribute(), xmlattributes()

Funktion: Attribute eines XML-Tags extrahieren.
Syntax: string xmlattribute(string xml, string tag, string attribute);
int xmlattributes(string &array[], string xml, string tag);

Siehe auch xmlelement(), xmltags(), xmltext()

Die xmlattribute-Funktion liefert den Wert des gegebenen Attributs attribute für das gegebene Tag tag innerhalb des gegebenen XML-Codes xml. Kommt ein Attribut mehrfach in einem Tag vor, so wird der Wert des letzten Vorkommens geliefert.

Die xmlattributes-Funktion speichert die Namen aller Attribute des gegebenen Tags innerhalb des gegebenen XML-Codes in array und liefert die Anzahl der gefundenen Attribute zurück. Die Reihenfolge stimmt nicht notwendigerweise mit dem gegebenen XML-Code überein. Kommt ein Attribut mehrfach in einem Tag vor, so erscheint sein Name nur einmal im array.

Das tag wird in Form eines Pfades angegeben.

Falls der gegebene xml-Code einen Fehler enthält, so ist das Ergebnis jeglicher XML-Funktionen leer, und es wird dem Benutzer eine Warnung angezeigt, welche Informationen darüber enthält, an welcher Stelle im ULP bzw. im XML-Code der Fehler aufgetreten ist. Beachten Sie dabei, dass die Zeilen- und Spaltennummer im XML-Code sich auf den an diese Funktion als xml-Parameter übergebenen String bezieht.

Beispiel

// String XML contains the following data:
//<root>
//  <body abc="def" xyz="123">
//    ...
//  </body>
//</root>

string s[];
int n = xmlattributes(s, XML, "root/body");

// Result: { "abc", "xyz" }

string s = xmlattribute(XML, "root/body", "xyz");

// Result: "123"

xmlelement(), xmlelements()

Funktion: Element aus einem XML-Code extrahieren.
Syntax: string xmlelement(string xml, string tag);
int xmlelements(string &array[], string xml, string tag);

Siehe auch xmltags(), xmlattribute(), xmltext()

Die xmlelement-Funktion liefert das komplette XML-Element des gegebenen Tags tag innerhalb des gegebenen XML-Codes xml. Das Ergebnis beinhaltet das äußere XML-Tag des Elements, und kann daher mit den anderen XML-Funktionen weiterverarbeitet werden. Leerzeichen, Tabulatoren und Zeilenumbrüche innerhalb des reinen Textes bleiben erhalten. Die generelle Formatierung der XML-Tags innerhalb des Elements sowie die Reihenfolge von Element-Attributen können sich jedoch von der im ursprünglichen xml -Code unterscheiden.
Falls tag mehrfach in xml vorkommt, wird das erste davon geliefert. Benutzen Sie xmlelements um alle Instanzen zu bekommen.

Die xmlelements-Funktion arbeitet genau wie xmlelement, liefert aber alle Instanzen von Elementen mit dem gegebenen tag. Der Rückgabewert ist die Anzahl der Element, die in array gespeichert wurden.

Das tag wird in Form eines Pfades angegeben.

Beispiel

// String XML contains the following data:
//<root>
//  <body>
//    <contents>
//      <string>Some text 1</string>
//      <any>anything 1</any>
//    </contents>
//    <contents>
//      <string>Some text 2</string>
//      <any>anything 2</any>
//    </contents>
//    <appendix>
//      <string>Some text 3</string>
//    </appendix>
//  </body>
//</root>
//

string s = xmlelement(XML, "root/body/appendix");

// Result: " <appendix>\n  <string>Some text 3</string>\n </appendix>\n"

string s[];
int n = xmlelements(s, XML, "root/body/contents");

// Result: { " <contents>\n  <string>Some text 1</string>\n  <any>anything 1</any>\n </contents>\n",
//           " <contents>\n  <string>Some text 2</string>\n  <any>anything 2</any>\n </contents>\n"
//         }

xmltags()

Funktion: Liste der Tag-Namen aus einem XML-Code extrahieren.
Syntax: int xmltags(string &array[], string xml, string tag);

Siehe auch xmlelement(), xmlattribute(), xmltext()

Die xmltags-Funktion liefert die Namen aller Tags auf der obersten Ebene des gegebenen Tags tag innerhalb des gegebenen XML-Codes xml. Der Rückgabewert ist die Anzahl der in array gespeicherten Tag-Namen.

Jeder Tag-Name wird nur einmal geliefert, auch wenn er mehrfach im XML-Code vorkommt.

Das tag wird in Form eines Pfades angegeben.

Beispiel

//String XML contains the following data:
//<root>
//  <body>
//    <contents>
//      <string>Some text 1</string>
//      <any>anything 1</any>
//    </contents>
//    <contents>
//      <string>Some text 2</string>
//      <any>anything 2</any>
//    </contents>
//    <appendix>
//      <string>Some text 3</string>
//    </appendix>
//  </body>
//</root>
//

string s[];
int n = xmltags(s, XML, "root/body");

// Result: { "contents", "appendix" } 

int n = xmltags(s, XML, "");        

// Result: "root"

xmltext()

Funktion: Text aus einem XML-Element extrahieren.
Syntax: string xmltext(string xml, string tag);

Siehe auch xmlelement(), xmlattribute(), xmltags()

Die xmltext-Funktion liefert den Text des gegebenen Tags tag innerhalb des XML-Codes xml.

Alle Tags innerhalb des Textes werden entfernt, Leerzeichen, Tabulatoren und Zeilenumbrüche bleiben erhalten.

Das tag wird in Form eines Pfades angegeben.

Beispiel

// String XML contains the following data:
//<root>
//  <body>
//    Some <b>text</b>.
//  </body>
//</root>
//

string s = xmltext(XML, "root/body");

// Result: "\n    Some text.\n  "

Builtin-Statements

Builtin-Statements werden im allgemeinen dazu verwendet, einen Kontext zu eröffnen, der den Zugriff auf Datenstrukturen und Dateien erlaubt.

Die allgemeine Syntax von Builtin-Statements ist

name(parameters) statement

wobei name der Name des Builtin-Statement ist, parameters steht für einen oder mehrere Parameter, und statement ist der Code, der innerhalb des vom Builtin-Statement geöffneten Kontexts ausgeführt wird.

Beachten Sie, dass es sich bei statement um eine Compound-Statement handeln kann, wie in

board(B) {
  B.elements(E) printf("Element: %s\n", E.name);
  B.signals(S)  printf("Signal: %s\n", S.name);
  }

Die folgenden Builtin-Statements sind verfügbar:

board()
deviceset()
library()
module()
output()
package()
schematic()
sheet()
symbol()

board()

Funktion: Öffnet einen Board-Kontext.
Syntax: board(identifier) statement

Siehe auch schematic, library

Das board-Statement öffnet einen Board-Kontext wenn das gegenwärtige Editor-Fenster ein Board enthält. Eine Variable vom Typ UL_BOARD wird angelegt und erhält den Namen, den identifier angibt.

Sobald der Board-Kontext erfolgreich geöffnet wurde und eine Board-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die Board-Variable zugreifen, um weitere Daten aus dem Board zu erhalten.

Wenn das gegenwärtige Editor-Fenster kein Board enthält, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob ein Board geladen ist

Mit dem board-Statement ohne Angabe eines Arguments können Sie prüfen, ob das gegenwärtige Editor-Fenster ein Board enthält. In diesem Fall verhält sich board wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern ein Board geladen ist. Andernfalls wird der Wert 0 zurückgegeben.

Zugriff auf ein Board von einem Schaltplan aus

Wenn das gegenwärtige Editor-Fenster einen Schaltplan enthält, können Sie trotzdem auf das zugehörige Board zugreifen, indem Sie dem board-Statement den Präfix project voranstellen, wie in

project.board(B) { ... }

Das öffnet einen Board-Kontext, unabhängig davon, ob das gegenwärtige Editor-Fenster ein Board oder einen Schaltplan enthält. Allerdings muss es auf dem Desktop ein Fenster geben, das dieses Board enthält!

Beispiel

if (board)
   board(B) {
     B.elements(E)
       printf("Element: %s\n", E.name);
     }

deviceset()

Funktion: Öffnet einen Device-Set-Kontext.
Syntax: deviceset(identifier) statement

Siehe auch package, symbol, library

Das deviceset-Statement öffnet einen Device-Set-Kontext wenn das gegenwärtige Editor-Fenster ein Device-Set enthält. Eine Variable vom Typ UL_DEVICESET wird angelegt und erhält den Namen, den identifier angibt.

Sobald der Device-Set-Kontext erfolgreich geöffnet wurde und eine Device-Set-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die Device-Set-Variable zugreifen, um weitere Daten aus dem Device-Set zu erhalten.

Wenn das gegenwärtige Editor-Fenster kein Device-Set enthält, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob ein Device-Set geladen ist

Mit dem deviceset-Statement ohne Angabe eines Arguments können Sie prüfen, ob das gegenwärtige Editor-Fenster ein Device-Set enthält. In diesem Fall verhält sich deviceset wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern ein Device-Set geladen ist. Andernfalls wird der Wert 0 zurückgegeben.

Beispiel

if (deviceset)
   deviceset(D) {
     D.gates(G)
       printf("Gate: %s\n", G.name);
     }

library()

Funktion: Öffnet einen Library-Kontext.
Syntax: library(identifier) statement

Siehe auch board, schematic, deviceset, package, symbol

Das library-Statement öffnet einen Library-Kontext wenn das gegenwärtige Editor-Fenster eine Library enthält. Eine Variable vom Typ UL_LIBRARY wird angelegt und erhält den Namen, den identifier angibt.

Sobald der Library-Kontext erfolgreich geöffnet wurde und eine Board-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die Library-Variable zugreifen, um weitere Daten aus der Bibliothek zu erhalten.

Wenn das gegenwärtige Editor-Fenster keine Bibliothek enthält, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob eine Bibliothek geladen ist

Mit dem library-Statement ohne Angabe eines Arguments können Sie prüfen, ob das gegenwärtige Editor-Fenster eine Bibliothek enthält. In diesem Fall verhält sich library wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern eine Bibliothek geladen ist. Andernfalls wird der Wert 0 zurückgegeben.

Beispiel

if (library)
   library(L) {
     L.devices(D)
       printf("Device: %s\n", D.name);
     }

module()

Funktion: Öffnet einen Modul-Kontext.
Syntax: module(identifier) statement

Siehe auch board, library, schematic, sheet

Das module-Statement öffnet einen Modul-Kontext, wenn im Editor-Fenster gerade ein Modul editiert wird. Eine Variable vom Typ UL_MODULE wird angelegt und erhält den Namen, den identifier angibt.

Sobald der Modul-Kontext erfolgreich geöffnet wurde und eine UL_MODULE-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die UL_MODULE-Variable zugreifen, um weitere Daten aus dem Modul zu erhalten.

Wenn im Editor-Fenster gerade kein Modul editiert wird, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob gerade ein Modul editiert wird

Mit dem module-Statement ohne Angabe eines Arguments können Sie prüfen, ob im Editor-Fenster gerade ein Modul editiert wird. In diesem Fall verhält sich module wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern ein Modul editiert wird. Andernfalls wird der Wert 0 zurückgegeben.

Beispiel

if (module)
   module(M) {
     printf("Module: %s\n", M.name);
     }

output()

Funktion: Öffnet eine Ausgabe-Datei für nachfolgende printf()-Aufrufe.
Syntax: output(string filename[, string mode]) statement

Siehe auch printf, fileerror

Das output-Statement öffnet eine Datei mit dem Namen filename und dem Parameter mode für die Ausgabe mit nachfolgenden printf()-Aufrufen. Sobald die Datei erfolgreich geöffnet wurde, wird statement ausgeführt, und danach wird die Datei geschlossen.

Wenn die Datei nicht geöffnet werden kann, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Standardmäßig wird die erzeugte Datei in das Projekt Verzeichnis geschrieben.

Datei-Modi

Der mode-Parameter definiert, wie die Datei geöffnet werden soll. Wenn kein mode-Parameter angegeben ist, gilt der Standardwert "wt".

a an existierende Datei anhängen oder neue Datei anlegen, falls die Datei nicht existiert

w neue Datei anlegen (existierende überschreiben)

t Datei im Textmodus öffnen

b Datei im Binärmodus öffnen

D Datei am Ende der EAGLE-Sitzung löschen (funktioniert nur zusammen mit w)

F diesen Dateinamen erzwingen (normalerweise werden *.brd, *.sch und *.lbr abgewiesen)

Mode-Parameter können in beliebiger Kombination und Reihenfolge angegeben werden. Allerdings ist nur der letzte aus a und w bzw. t und b signifikant. Die Angabe "abtw" würde zum Beispiel eine Textdatei öffnen (entsprechend "wt").

Verschachtelte Output-Statements

output-Statements können verschachtelt werden, solange genügend Datei-Handles verfügbar sind - vorausgesetzt, es greifen nicht mehrere aktive output-Statements auf dieselbe Datei zu.

Beispiel

void PrintText(string s)
{
  printf("This also goes into the file: %s\n", s);
}
output("file.txt", "wt") {
  printf("Directly printed\n");
  PrintText("via function call");
  }

package()

Funktion: Öffnet einen Package-Kontext.
Syntax: package(identifier) statement

Siehe auch library, deviceset, symbol

Das package-Statement öffnet einen Package-Kontext wenn das gegenwärtige Editor-Fenster ein Package enthält. Eine Variable vom Typ UL_PACKAGE wird angelegt und erhält den Namen, den identifier angibt.

Sobald der Package-Kontext erfolgreich geöffnet wurde und eine Package-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die Package-Variable zugreifen, um weitere Daten aus dem Package zu erhalten.

Wenn das gegenwärtige Editor-Fenster kein Package enthält, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob ein Package geladen ist

Mit dem package-Statement ohne Angabe eines Arguments können Sie prüfen, ob das gegenwärtige Editor-Fenster ein Package enthält. In diesem Fall verhält sich package wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern ein Package geladen ist. Andernfalls wird der Wert 0 zurückgegeben.

Beispiel

if (package)
   package(P) {
     P.contacts(C)
       printf("Contact: %s\n", C.name);
     }

schematic()

Funktion: Öffnet einen Schaltplan-Kontext.
Syntax: schematic(identifier) statement

Siehe auch board, library, module, sheet

Das schematic-Statement öffnet einen Schaltplan-Kontext wenn das gegenwärtige Editor-Fenster einen Schaltplan enthält. Eine Variable vom Typ UL_SCHEMATIC wird angelegt und erhält den Namen, den identifier angibt.

Sobald der Schaltplan-Kontext erfolgreich geöffnet wurde und eine UL_SCHEMATIC-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die UL_SCHEMATIC-Variable zugreifen, um weitere Daten aus dem Schaltplan zu erhalten.

Wenn das gegenwärtige Editor-Fenster keinen Schaltplan enthält, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob ein Schaltplan geladen ist

Mit dem schematic-Statement ohne Angabe eines Arguments können Sie prüfen, ob das gegenwärtige Editor-Fenster einen Schaltplan enthält. In diesem Fall verhält sich schematic wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern ein Schaltplan geladen ist. Andernfalls wird der Wert 0 zurückgegeben.

Zugriff auf einen Schaltplan vom Board aus

Wenn das gegenwärtige Editor-Fenster ein Board enthält, können Sie trotzdem auf den zugehörigen Schaltplan zugreifen, indem Sie dem schematic-Statement den Präfix project voranstellen, wie in

project.schematic(S) { ... }

Das öffnet einen UL_SCHEMATIC-Kontext, unabhängig davon, ob das gegenwärtige Editor-Fenster ein Board oder einen Schaltplan enthält. Allerdings muss es auf dem Desktop ein Fenster geben, das diesen Schaltplan enthält!

Zugriff auf die gegenwärtige Seite eines Schaltplans

Verwenden Sie das sheet-Statement, um direkt auf die gegenwärtig geladene Schaltplanseite zuzugreifen.

Zugriff auf das gerade editierte Modul

Verwenden Sie das module-Statement, um direkt auf das gerade editierte Modul zuzugreifen.

Beispiel

if (schematic)
   schematic(S) {
     S.parts(P)
       printf("Part: %s\n", P.name);
     }

sheet()

Funktion: Öffnet einen UL_SHEET-Kontext.
Syntax: sheet(identifier) statement

Siehe auch schematic

Das sheet-Statement öffnet einen UL_SHEET-Kontext, wenn das gegenwärtige Editor-Fenster eine Schaltplanseite enthält. Eine Variable vom Typ UL_SHEET wird angelegt und erhält den Namen, den identifier angibt.

Sobald der UL_SHEET-Kontext erfolgreich geöffnet wurde und eine UL_SHEET-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die UL_SHEET-Variable zugreifen, um weitere Daten aus der Seite zu erhalten.

Wenn das gegenwärtige Editor-Fenster keine Schaltplanseite enthält, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob eine Schaltplanseite geladen ist

Mit dem sheet-Statement ohne Angabe eines Arguments können Sie prüfen, ob das gegenwärtige Editor-Fenster eine Schaltplanseite enthält. In diesem Fall verhält sich sheet wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern eine Schaltplanseite geladen ist. Andernfalls wird der Wert 0 zurückgegeben.

Beispiel

if (sheet)
   sheet(S) {
     S.instances(I)
       printf("Instance: %s\n", I.name);
     }

symbol()

Funktion: Öffnet einen Symbol-Kontext.
Syntax: symbol(identifier) statement

Siehe auch library, deviceset, package

Das symbol-Statement öffnet einen Symbol-Kontext wenn das gegenwärtige Editor-Fenster ein Symbol enthält. Eine Variable vom Typ UL_SYMBOL wird angelegt und erhält den Namen, den identifier angibt.

Sobald der Symbol-Kontext erfolgreich geöffnet wurde und eine Symbol-Variable angelegt ist, wird statement ausgeführt. Innerhalb des Gültigkeitsbereichs von statement kann man auf die Symbol-Variable zugreifen, um weitere Daten aus dem Symbol zu erhalten.

Wenn das gegenwärtige Editor-Fenster kein Symbol enthält, wird eine Fehlermeldung ausgegeben, und das ULP wird beendet.

Prüfen, ob ein Symbol geladen ist

Mit dem symbol-Statement ohne Angabe eines Arguments können Sie prüfen, ob das gegenwärtige Editor-Fenster ein Symbol enthält. In diesem Fall verhält sich symbol wie eine Integer-Konstante, die den Wert 1 zurückgibt, sofern ein Symbol geladen ist. Andernfalls wird der Wert 0 zurückgegeben.

Beispiel

if (symbol)
   symbol(S) {
     S.pins(P)
       printf("Pin: %s\n", P.name);
     }

Dialoge

User-Language-Dialoge ermöglichen es, ein eigenes Frontend für ein User-Language-Progamm zu definieren.

In den folgenden Abschnitten werden die User-Language-Dialoge detailliert beschrieben:

Vordefinierte Dialoge beschreibt vordefinierte Standard-Dialoge

Dialog-Objekte beschreibt die Objekte aus denen ein Dialog bestehen kann

Layout-Information erklärt wie man die Position von Objekten in einem Dialog bestimmt

Dialog-Funktionen beschreibt besondere Funktionen, die mit Dialogen verwendet werden können

Ein vollständiges Beispiel zeigt ein vollständiges ULP mit einem Dialog zur Daten-Eingabe

Vordefinierte Dialoge

Vordefinierte Dialoge sind die typischen Dialoge, die häufig zur Dateiauswahl oder bei Fehlermeldungen verwendet werden.

Es gibt folgende vordefinierte Dialoge:

dlgDirectory()
dlgFileOpen()
dlgFileSave()
dlgMessageBox()

Siehe Dialog-Objekte für Informationen über das Definieren eigener, komplexer Benutzer-Dialoge.

dlgDirectory()

Funktion: Zeigt den Verzeichnis-Dialog.
Syntax: string dlgDirectory(string Title[, string Start])
Rückgabewert: Die dlgDirectory-Funktion liefert den vollen Pfadnamen des gewählten Verzeichnisses.
Hat der Benutzer den Dialog abgebrochen, ist das Resultat ein leerer String.

Siehe auch dlgFileOpen

Die dlgDirectory-Funktion zeigt einen Verzeichnis-Dialog in dem der Benutzer ein Verzeichnis selektieren kann.

Title zeigt den Titel des Dialogs.

Wenn Start nicht leer ist, wird diese Angabe als Startpunkt für dlgDirectory verwendet.

Beispiel

string dirName;
dirName = dlgDirectory("Select a directory", "");

dlgFileOpen(), dlgFileSave()

Funktion: Zeigt einen Datei-Dialog.
Syntax: string dlgFileOpen(string Title[, string Start[, string Filter]])
string dlgFileSave(string Title[, string Start[, string Filter]])
Rückgabewert: Die Funktionen dlgFileOpen und dlgFileSave liefern die volle Pfadangabe der gewählten Datei.
Bricht der Benutzer den Dialog ab, ist das Ergebnis ein leerer String.

Siehe auch dlgDirectory

Die Funktionen dlgFileOpen und dlgFileSave zeigen einen Datei-Dialog, aus dem der Benutzer eine Datei selektieren kann.

Title wird als Titel des Dialogs verwendet.

Ist Start nicht leer, wird diese Angabe als Startpunkt für den Dialog verwendet. Ansonsten wird das aktuelle Verzeichnis verwendet.

Nur Dateien, die der Angabe von Filter entsprechen, werden angezeigt. Wird kein Filter angegeben, werden alle Dateien angezeigt.

Filter kann entweder ein einfacher Pattern sein (wie in "*.brd"), eine Liste von Patterns (wie in "*.bmp *.jpg") oder kann sogar beschreibenden Text enthalten, wie in "Bitmap-Dateien (*.bmp)". Falls die "Dateityp" Combo-Box des Datei-Dialogs mehrere Einträge haben soll, müssen diese durch zwei Semikolons voneinander getrennt werden, wie in "Bitmap-Dateien (*.bmp);;Andere Bilddateien (*.jpg *.png)".

Beispiel

string fileName;
fileName = dlgFileOpen("Select a file", "", "*.brd");

dlgMessageBox()

Funktion: Zeigt eine Message-Box.
Syntax: int dlgMessageBox(string Message[, button_list])
Rückgabewert: Die dlgMessageBox-Funktion liefert den Index der Schaltfläche, die der Benutzer selektiert hat.
Die erste Schaltfläche in button_list hat den Index 0.

Siehe auch status()

Die dlgMessageBox-Funktion zeigt die angegebene Message in einem modalen Dialog-Fenster und wartet darauf, dass der Benutzer eine der Schaltflächen, die über button_list definiert wurden, selektiert.

Falls Message HTML-Tags enthält, so müssen die Zeichen '<', '>' und '&', damit sie als solche angezeigt werden, als "<", ">" bzw. "&" angegeben werden.

button_list ist eine optionale Liste durch Komma getrennter Strings, die einen Satz von Schaltflächen, die unten im Dialog-Fenster angezeigt werden, definiert.
Es können maximal drei Schaltflächen definiert werden. Wird keine button_list angegeben, erscheint automatisch "OK".

Die erste Schaltfläche in button_list wird die Default-Schaltfläche (sie wird gedrückt, wenn der Benutzer ENTER drückt), und der letzte Eintrag in der Liste wird der "Cancel-Button", der gewählt wird, wenn der Benutzer Esc drückt oder das Dialog-Fenster einfach schließt. Sie können eine andere Schaltfläche als Default-Button definieren, indem Sie den String mit einem '+' beginnen. Wollen Sie eine andere Schaltfläche als Cancel-Button definieren, stellen Sie dem String ein '-' voran. Um einen Schaltflächen-Text mit einem '+' oder '-' zu beginnen, muss das Zeichen mit einem Escape-Zeichen markiert werden.

Enthält der Text ein '&', wird das folgende Zeichen zum Hotkey. Wenn der Benutzer die entsprechende Taste drückt, wird diese Schaltfläche gewählt. Um das Zeichen '&' im Schaltflächen-Text zu verwenden, muss es mit einem Escape-Zeichen markiert werden.

Dem Dialog-Fenster kann ein Icon mitgegeben werden, indem das erste Zeichen in Message auf
   ';' - für eine Information
   '!' - für eine Warnung
   ':' - für einen Fehler
gesetzt wird. Soll die Message jedoch mit einem dieser Zeichen beginnen, so muss dieses mit einem Escape-Zeichen markiert werden.

Unter Mac OS X führt nur das Zeichen ':' tatsächlich zur Darstellung eines Icons. Alle anderen werden ignoriert.

Beispiel

if (dlgMessageBox("Are you sure?", "&Yes", "&No") == 0) {
   // let's do it!
   }

Dialog-Objekte

Ein User-Language-Dialog kann aus folgenden Dialog-Objekten bestehen (die einzelnen Begriffe wurden in diesem Fall nicht ins Deutsche übersetzt, da sonst der Zusammenhang zu den ULP-Objekten verloren ginge):

dlgCell ein Grid-Cell-Kontext

dlgCheckBox eine Checkbox

dlgComboBox ein Combo-Box-Auswahl-Feld

dlgDialog die Grundlage eines jeden Dialogs

dlgGridLayout ein Grid-basierter-Layout-Kontext

dlgGroup ein Group-Feld

dlgHBoxLayout ein Horizontal-Box-Layout-Kontext

dlgIntEdit ein Integer-Eingabe-Feld

dlgLabel ein Text-Label

dlgListBox eine List-Box

dlgListView eine List-View

dlgPushButton ein Push-Button

dlgRadioButton ein Radio-Button

dlgRealEdit ein Real-Eingabe-Feld

dlgSpacing ein Layout-Spacing-Objekt

dlgSpinBox ein Spin-Box-Auswahl-Feld

dlgStretch ein Layout-Stretch-Objekt

dlgStringEdit ein String-Eingabe-Feld

dlgTabPage eine Tab-Page

dlgTabWidget ein Tab-Page-Container

dlgTextEdit ein Text-Eingabe-Feld

dlgTextView ein Text-Viewer-Feld

dlgVBoxLayout ein Vertical-Box-Layout-Kontext

dlgCell

Funktion: Definiert die Position einer Cell (Zelle) in einem Grid-Layout-Kontext.
Syntax: dlgCell(int row, int column[, int row2, int column2]) statement

Siehe auch dlgGridLayout, dlgHBoxLayout, dlgVBoxLayout, Layout-Information, Ein vollständiges Beispiel

Das dlgCell-Statement definiert die Lage einer Cell in einem Grid-Layout-Kontext.

Der Index für Reihe (row) und Spalte (column) beginnt mit 0, so das die obere linke Cell den Index (0, 0) hat.

Mit zwei Parametern wird das Dialog-Objekt, das in statement angegeben wurde, in einer Cell an der Stelle row und column plaziert. Mit vier Parametern erstreckt sich das Objekt über alle Cells von row/column bis zu row2/column2.

Standardmäßig enthält dlgCell ein dlgHBoxLayout. Enthält eine Cell mehr als ein Dialog-Objekt, werden diese nebeneinander horizontal angeordnet.

Beispiel

string Text;
dlgGridLayout {
  dlgCell(0, 0) dlgLabel("Cell 0,0");
  dlgCell(1, 2, 4, 7) dlgTextEdit(Text);
  }

dlgCheckBox

Funktion: Definiert eine Checkbox.
Syntax: dlgCheckBox(string Text, int &Checked) [ statement ]

Siehe auch dlgRadioButton, dlgGroup, Layout-Information, Ein vollständiges Beispiel

Das dlgCheckBox-Statement definiert eine Checkbox mit dem angegebenen Text.

Wenn Text ein '&' enthält, wird das folgende Zeichen als Hotkey markiert. Wenn der Benutzer Alt+hotkey drückt, wird die Checkbox selektiert/deselektiert. Um ein '&'-Zeichen im Text zu verwenden, muss er mit einem Escape-Zeichen markiert werden.

dlgCheckBox wird hauptsächlich in dlgGroup benutzt, kann aber auch anders verwendet werden.
Alle Check-Boxen innerhalb eines gemeinsamen Dialogs müssen unterschiedliche Checked-Variablen haben!

Wenn ein Benutzer eine dlgCheckBox wählt, wird die entsprechende Checked-Variable auf 1 gesetzt, andernfalls ist sie auf 0 gesetzt. Der ursprüngliche Wert von Checked definiert, ob eine Checkbox anfänglich selektiert ist oder nicht. Wenn Checked ungleich 0 ist, ist die Checkbox defaultmäßig selektiert.

Das optionale statement wird jedesmal ausgeführt, wenn Sie die dlgCheckBox selektieren/deselektieren.

Beispiel

int mirror = 0;
int rotate = 1;
int flip   = 0;
dlgGroup("Orientation") {
  dlgCheckBox("&Mirror", mirror);
  dlgCheckBox("&Rotate", rotate);
  dlgCheckBox("&Flip", flip);
  }

dlgComboBox

Funktion: Definiert ein Combo-Box-Auswahl-Feld.
Syntax: dlgComboBox(string array[], int &Selected) [ statement ]

Siehe auch dlgListBox, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgComboBox-Statement definiert ein Combo-Box-Auswahlfeld mit dem Inhalt von array.

Selected reflektiert den Index des selektieren Combo-Box-Eintrags. Der erste Eintrag hat den Index 0.

Jedes Element von array legt den Inhalt eines Eintrags in der Combo-Box fest. Keiner der Strings in array darf leer sein (sollte ein leerer String existieren, werden alle folgenden, inklusive des leeren, ignoriert).

Das optionale statement wird jedesmal ausgeführt, wenn die Auswahl in der dlgComboBox verändert wird.
Bevor statement ausgeführt wird, werden alle Variablen , die in den Dialog-Objekten verwendet werden neu eingelesen und jede Veränderung innerhalb von statement wird im Dialog angezeigt.

Ist der Ausgangswert von Selected ausserhalb des Bereichs der Indices von array, wird dieser auf 0 gesetzt.

Beispiel

string Colors[] = { "red", "green", "blue", "yellow" };
int Selected = 2; // initially selects "blue"
dlgComboBox(Colors, Selected) dlgMessageBox("You have selected " + Colors[Selected]);

dlgDialog

Funktion: Führt einen User-Language-Dialog aus.
Syntax: int dlgDialog(string Title) block ;
Rückgabewert

Siehe auch dlgGridLayout, dlgHBoxLayout, dlgVBoxLayout, dlgAccept, dlgReset, dlgReject, Ein vollständiges Beispiel

Die dlgDialog-Funktion, die durch block definiert wird. Das ist das einzige Dialog-Objekt das tatsächlich eine User-Language-Builtin-Funktion ist. Sie kann überall wo ein Funktionsaufruf erlaubt ist, verwendet werden.

block enthält normalerweise andere Dialog-Objekte. Man kann aber auch andere User-Language-Statements verwenden, zum Beispiel, um bedingungsabhängig dem Dialog Objekte hinzuzufügen (siehe das zweite der folgenden Beispiele).

Standardmäßig enthält dlgDialog ein dlgVBoxLayout, so dass man sich bei einem einfachen Dialog um das Layout kein Gedanken machen muss.

Ein dlgDialog sollte an einer Stelle den Aufruf der dlgAccept() -Funktion enthalten, um dem Benutzer zu erlauben, den Dialog zu schließen und dessen Inhalt zu akzeptieren.

Wenn Sie nur eine einfache Message-Box oder einen einfachen Dialog brauchen, können Sie statt dessen auch einen der Vordefinierten Dialoge verwenden.

Beispiele

int Result = dlgDialog("Hello") {
  dlgLabel("Hello world");
  dlgPushButton("+OK") dlgAccept();
  };
int haveButton = 1;
dlgDialog("Test") {
  dlgLabel("Start");
  if (haveButton)
     dlgPushButton("Here") dlgAccept();
  };

dlgGridLayout

Funktion: Öffnet einen Grid-Layout-Kontext.
Syntax: dlgGridLayout statement

Siehe auch dlgCell, dlgHBoxLayout, dlgVBoxLayout, Layout-Information, Ein vollständiges Beispiel

Das dlgGridLayout-Statement öffnet einen Grid-Layout-Kontext.

Das einzige Dialog-Objekt, das direkt in statement verwendet werden kann, ist dlgCell, das die Position eines Dialog-Objekts im Grid-Layout festlegt.

Die Indices für row und column beginnen mit 0, so dass die obere linke Cell den Index (0, 0) hat.
Die Anzahl der Reihen und Spalten wird automatisch an die Position von Dialog-Objekten, die innerhalb des Grid-Layout-Kontexts definiert werden, angepasst. Die Anzahl der Reihen und Spalten muss nicht explizit definiert werden.

Beispiel

dlgGridLayout {
  dlgCell(0, 0) dlgLabel("Row 0/Col 0");
  dlgCell(1, 0) dlgLabel("Row 1/Col 0");
  dlgCell(0, 1) dlgLabel("Row 0/Col 1");
  dlgCell(1, 1) dlgLabel("Row 1/Col 1");
  }

dlgGroup

Funktion: Definiert ein Group-Feld.
Syntax: dlgGroup(string Title) statement

Siehe auch dlgCheckBox, dlgRadioButton, Layout-Information, Ein vollständiges Beispiel

Das dlgGroup-Statement definiert eine Gruppe mit dem gegebenen Title.

Standardmäßig enthält dlgGroup ein dlgVBoxLayout, so braucht man sich bei einer einfachen Group keine Gedanken zum Layout machen.

dlgGroup wird hauptsächlich für einen Satz von Radio-Buttons oder Check-Boxes verwendet, kann aber auch jedes andere beliebige Objekt in statement enthalten.
Radio-Buttons in einer dlgGroup werden mit 0 beginnend numeriert.

Beispiel

int align = 1;
dlgGroup("Alignment") {
  dlgRadioButton("&Top", align);
  dlgRadioButton("&Center", align);
  dlgRadioButton("&Bottom", align);
  }

dlgHBoxLayout

Funktion: Öffnet einen Horizontal-Box-Layout-Kontext.
Syntax: dlgHBoxLayout statement

Siehe auch dlgGridLayout, dlgVBoxLayout, Layout-Information, Ein vollständige Beispiel

Das dlgHBoxLayout-Statement öffnet einen Horizontal-Box-Layout-Kontext für das angegebene statement.

Beispiel

dlgHBoxLayout {
  dlgLabel("Box 1");
  dlgLabel("Box 2");
  dlgLabel("Box 3");
  }

dlgIntEdit

Funktion: Definiert ein Integer-Eingabe-Feld.
Syntax: dlgIntEdit(int &Value, int Min, int Max)

Siehe auch dlgRealEdit, dlgStringEdit, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgIntEdit-Statement definiert ein Integer-Eingabe-Feld mit einem in Value angegebenen Wert.

Ist Value ursprünglich ausserhalb des Bereichs Min und Max, wird er auf diesen Bereich limitiert.

Beispiel

int Value = 42;
dlgHBoxLayout {
  dlgLabel("Enter a &Number between 0 and 99");
  dlgIntEdit(Value, 0, 99);
  }

dlgLabel

Funktion: Definiert ein Text-Label.
Syntax: dlgLabel(string Text [, int Update])

Siehe auch Layout-Information, Ein vollständiges Beispiel, dlgRedisplay()

Das dlgLabel-Statement definiert ein Label mit dem angegebenen Text.

Text kann entweder ein fester String wie "Hello" sein, oder eine String-Variable.

Falls Text HTML-Tags enthält, so müssen die Zeichen '<', '>' und '&', damit sie als solche angezeigt werden, als "<", ">" bzw. "&" angegeben werden.

Externe Hyperlinks im Text werden mit dem entsprechenden Anwendungsprogramm geöffnet.

Wenn der Update-Parameter nicht 0 ist und Text eine String-Variable, kann deren Inhalt im statement z. B. eines dlgPushButton modifiziert werden, wodurch das Label automatisch aktualisiert wird. Das ist natürlich nur sinnvoll wenn Text eine eindeutig bestimmte String-Variable ist (und beispielsweise keine Loop-Variable eines for-Statements).

Enthält Text ein '&'-Zeichen, und kann das Objekt, das auf das Label folgt, den Keyboard-Fokus bekommen, wird das folgende Zeichen zum Hot-Key. Drückt der Benutzer Alt+hotkey, wird das Objekt, das direkt nach dlgLabel definiert wurde, aktiv. Um ein '&'-Zeichen direkt im Text zu verwenden, muss man es mit einem Escape-Zeichen markieren.

Beispiel

string OS = "Windows";
dlgHBoxLayout {
  dlgLabel(OS, 1);
  dlgPushButton("&Change OS") { OS = "Linux"; }
  }

dlgListBox

Funktion: Definiert ein List-Box-Auswahl-Feld.
Syntax: dlgListBox(string array[], int &Selected) [ statement ]

Siehe auch dlgComboBox, dlgListView, dlgSelectionChanged, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgListBox-Statement definiert ein List-Box-Auswahl-Feld mit dem Inhalt von array.

Selected gibt den Index des selektierten List-Box-Eintrags wieder. Der erste Eintrag hat den Index 0.

Jedes Element von array legt den Inhalt einer Zeile in der List-Box fest. Keiner der Strings in array darf leer sein (sollte ein leerer String existieren, werden alle folgenden, inklusive des leeren, ignoriert).

Das optionale statement wird immer dann ausgeführt, wenn der Benutzer einen Doppelklick auf einen Eintrag der dlgListBox ausführt (siehe dlgSelectionChanged für Hinweise wie das statement auch bei einer bloßen Änderung der Auswahl in der Liste aufgerufen werden kann.
Bevor statement ausgeführt wird, werden alle Variablen, die von Dialog-Objekten benutzt werden, aktualisiert. Alle Änderungen, die in statement gemacht wurden, wirken sich auf den Dialog aus, sobald das Statement zurückgegeben wird.

Ist der Ausgangswert von Selected ausserhalb des Index-Bereichs von array, wird kein Eintrag selektiert.

Beispiel

string Colors[] = { "red", "green", "blue", "yellow" };
int Selected = 2; // initially selects "blue"
dlgListBox(Colors, Selected) dlgMessageBox("You have selected " + Colors[Selected]);

dlgListView

Funktion: Definiert ein mehrspaltiges List-View-Auswahl-Feld.
Syntax: dlgListView(string Headers, string array[], int &Selected[, int &Sort]) [ statement ]

Siehe auch dlgListBox, dlgSelectionChanged, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgListView-Statement definiert ein mehrspaltiges List-View-Auswahl-Feld mit dem Inhalt, der in array angegeben ist.

Headers definiert die durch Tabulatoren getrennte Liste der Spalten-Überschriften.

Selected gibt den Index des selektierten List-View-Eintrags von array wieder (die Reihenfolge in der die Einträge tatsächlich angezeigt werden, kann unterschiedlich sein, da der Inhalt einer dlgListView in den verschiedenen Spalten sortiert werden kann). Der erste Eintrag hat den Index 0.
Wenn kein spezieller Eintrag selektiert werden soll, wählt man für Selected den Wert -1. Wird der Wert auf -2 gesetzt, so wird der erste Eintrag gemäß der aktuellen Sortierspalte selektiert. Wurde kein List-View-Eintrag selektiert, wird -1 zurückgegeben.

Sort gibt an, nach welcher Spalte der List-View sortiert werden soll. Die linke Spalte hat die Nummer 1. Das Vorzeichen dieses Parameters legt die Richtung der Sortierung fest (positive Werte sortieren in aufsteigender Reihenfolge). Falls Sort den Wert 0 hat, oder außerhalb der gültigen Anzahl von Spalten liegt, wird nicht sortiert. Der Rückgabewert von Sort spiegelt die vom Benutzer durch Anklicken der Spalten-Header gewählte Sortierspalte und -richtung wieder. Standardmäßig wird nach der ersten Spalte, in aufsteigender Richtung sortiert.

Jedes Element von array legt den Inhalt einer Zeile in der List-View fest und muss durch Tabulatoren getrennte Werte enthalten. Sind weniger Werte eines Elements in array definiert als im Headers-String vorgegeben, bleiben die restlichen Felder leer. Sind mehr Werte eines Element in array angegeben als im Headers-String, werden die überzählgen stillschweigend ignoriert. Keiner der Strings in array darf leer sein (sollte ein leerer String vorhanden sein, werden alle nachfolgenden, inklusive dem Leerstring ignoriert).

Enthält ein Listeneintrag Zeilenumbrüche ('\n'), so wird er entsprechend mehrzeilig dargestellt.

Das optionale statement wird ausgeführt, wann immer der Benutzer auf einen Eintrag in dlgListView doppelklickt (siehe dlgSelectionChanged für Hinweise wie das statement auch bei einer bloßen Änderung der Auswahl in der Liste aufgerufen werden kann.
Bevor statement ausgeführt wird, werden alle Variablen, die mit den Dialog-Objekten benutzt wurden, aktualisiert. Alle Änderungen, die in statement gemacht wurden, wirken sich auf den Dialog aus, sobald das Statement zurückgegeben wird.

Ist der Ausgangswert von Selected ausserhalb des Index-Bereichs von array, wird kein Eintrag selektiert.

Ist Headers ein leerer String, wird das erste Element von array als Header-String benutzt. Folglich ist der Index des ersten Eintrags dann 1.

Der Inhalt von dlgListView kann in einer beliebigen Spalte sortiert werden, indem man auf dessen Spalten-Header klickt. Die Spalten-Reihenfolge kann man durch Anklicken&Ziehen des Spalten-Headers verändern. Beachten Sie, dass keine dieser Änderunen eine Auswirkung auf den Inhalt von array hat. Soll der Inhalt alphanumerisch sortiert werden, kann ein numeric string[]-Array verwendet werden.

Beispiel

string Colors[] = { "red\tThe color RED", "green\tThe color GREEN", "blue\tThe color BLUE" };
int Selected = 0; // initially selects "red"
dlgListView("Name\tDescription", Colors, Selected) dlgMessageBox("You have selected " + Colors[Selected]);

dlgPushButton

Funktion: Definiert einen Push-Button.
Syntax: dlgPushButton(string Text) statement

Siehe auch Layout-Information, Dialog-Funktionen, Ein vollständige Beispiel

Das dlgPushButton-Statement definiert einen Push-Button mit dem angegebenen Text.

Enthält Text ein '&'-Zeichen, wird das folgende Zeichen zum Hot-Key. Wenn der Benutzer dann Alt+hotkey drückt, wird dieser Button selektiert. Soll ein '&'-Zeichen im Text verwendet werden, muss es mit einem Escape-Zeichen markiert werden.

Beginnt Text mit einem '+'-Zeichen, wird dieser Button der Default-Button. Dieser wird betätigt, wenn der Benutzer ENTER drückt.
Wenn Text mit einem '-'-Zeichen beginnt, wird dieser Button der Cancel-Button. Dieser wird gewählt wenn der Benutzer den Dialog schließt.
Achtung: Stellen Sie sicher, dass das statement eines so markierten Buttons einen Aufruf von dlgReject() enthält! Ansonsten ist es dem Benutzer nicht möglich den Dialog überhaupt zu schließen!
Um ein '+' oder '-'-Zeichen als erstes Zeichen des Textes zu verwenden, muss es mit einem Escape-Zeichen markiert werden.

Wenn der Benutzer einen dlgPushButton selektiert, wird das angegebene statement ausgeführt.
Bevor statement ausgeführt wird, werden alle Variablen, die mit den Dialog-Objekten benutzt wurden, aktualisiert. Alle Änderungen, die in statement gemacht wurden, wirken sich auf den Dialog aus, sobald das Statement zurückgegeben wird.

Beispiel

int defaultWidth = 10;
int defaultHeight = 20;
int width = 5;
int height = 7;
dlgPushButton("&Reset defaults") {
  width = defaultWidth;
  height = defaultHeight;
  }
dlgPushButton("+&Accept") dlgAccept();
dlgPushButton("-Cancel") { if (dlgMessageBox("Are you sure?", "Yes", "No") == 0) dlgReject(); }

dlgRadioButton

Funktion: Definiert einen Radio-Button.
Syntax: dlgRadioButton(string Text, int &Selected) [ statement ]

Siehe auch dlgCheckBox, dlgGroup, Layout-Information, Ein vollständiges Beispiel

Das dlgRadioButton-Statement definiert einen Radio-Button mit dem angegebenen Text.

dlgRadioButton kann nur innerhalb einer dlgGroup verwendet werden.
Alle Radio-Buttons innerhalb derselben Group müssen dieselbe Selected-Variable haben!

Wenn der Benutzer einen dlgRadioButton selektiert, wird der Index dieses Buttons innerhalb der dlgGroup in der Selected-Variablen gespeichert.
Der Ausgangswert von Selected definiert, welcher Radio-button per default selektiert ist. Liegt Selected ausserhalb des gültigen Bereichs dieser Group, ist kein Radio-Button selektiert. Um die richtige Radio-Button-Selektion zu erhalten, muss Selected schon vor der Definition des ersten dlgRadioButton festgelegt werden, und darf nicht verändert werden, während man weitere Radio-Buttons hinzufügt. Ansonsten ist es ungewiss welcher Radio-Button (wenn überhaupt einer) selektiert wird.

Das optionale statement wird ausgeführt, wenn ein dlgRadioButton selektiet wird.

Beispiel

int align = 1;
dlgGroup("Alignment") {
  dlgRadioButton("&Top", align);
  dlgRadioButton("&Center", align);
  dlgRadioButton("&Bottom", align);
  }

dlgRealEdit

Funktion: Definiert ein Real-Eingabe-Feld.
Syntax: dlgRealEdit(real &Value, real Min, real Max)

Siehe auch dlgIntEdit, dlgStringEdit, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgRealEdit-Statement definiert ein Real-Eingabe-Feld mit dem angegebenen Value (Wert).

Wenn Value ursprünglich ausserhalb des Bereiches von Min und Max liegt, wird dieser auf diese Werte begrenzt.

Beispiel

real Value = 1.4142;
dlgHBoxLayout {
  dlgLabel("Enter a &Number between 0 and 99");
  dlgRealEdit(Value, 0.0, 99.0);
  }

dlgSpacing

Funktion: Definiert zusätzlichen Abstand in einem Box-Layout-Kontext.
Syntax: dlgSpacing(int Size)

Siehe auch dlgHBoxLayout, dlgVBoxLayout, dlgStretch, Layout-Information, Ein vollständiges Beispiel

Das dlgSpacing-Statement definiert zusätzlichen Abstand in einem Vertical- bzw. Horizontal-Box-Layout-Kontext.

Size definiert die Anzahl der Pixel des zusätzlichen Abstands.

Beispiel

dlgVBoxLayout {
  dlgLabel("Label 1");
  dlgSpacing(40);
  dlgLabel("Label 2");
  }

dlgSpinBox

Funktion: Definiert ein Spin-Box-Auswahl-Feld.
Syntax: dlgSpinBox(int &Value, int Min, int Max)

Siehe auch dlgIntEdit, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgSpinBox-Statement definiert ein Spin-Box-Auswahl-Feld mit dem angegebenen Value.

Wenn Value ursprünglich ausserhalb des Bereiches von Min und Max liegt, wird dieser auf diese Werte begrenzt.

Beispiel

int Value = 42;
dlgHBoxLayout {
  dlgLabel("&Select value");
  dlgSpinBox(Value, 0, 99);
  }

dlgStretch

Funktion: Definiert einen leeren, dehnbaren Abstand in einem Box-Layout-Kontext.
Syntax: dlgStretch(int Factor)

Siehe auch dlgHBoxLayout, dlgVBoxLayout, dlgSpacing, Layout-Information, Ein vollständiges Beispiel

Das dlgStretch-Statement definiert einen leeren dehnbaren Abstand in einem Vertical- oder einem Horizontal-Box-Layout-Kontext.

Factor definiert den Dehnungsfaktor des Abstands.

Beispiel

dlgHBoxLayout {
  dlgStretch(1);
  dlgPushButton("+OK")    { dlgAccept(); };
  dlgPushButton("Cancel") { dlgReject(); };
  }

dlgStringEdit

Funktion: Definiert ein String-Eingabe-Feld.
Syntax: dlgStringEdit(string &Text[, string &History[][, int Size]])

Siehe auch dlgRealEdit, dlgIntEdit, dlgTextEdit, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgStringEdit-Statement definiert ein einzeiliges Text-Eingabe-Feld mit dem angegebenen Text.

Wird History angegeben, so werden die Strings, die der Benutzer der Reihe nach eingibt, in diesem Array gespeichert. Das Eingabe-Feld enthält dann einen Button, über den der Benutzer aus bereits eingegeben Strings auswählen kann. Wird eine Size größer als Null angegeben, so werden maximal so viele Strings im Array gespeichert. Enthält History beim Öffnen des Dialogs bereits Daten, so werden diese zur Initialisierung der History verwendet. Die zuletzt erfolgte Benutzereingabe wird bei Index 0 gespeichert.
Keiner der Strings in History darf leer sein (sollte ein leerer String vorhanden sein, werden alle nachfolgenden, inklusive dem Leerstring ignoriert).

Beispiel

string Name = "Linus";
dlgHBoxLayout {
  dlgLabel("Enter &Name");
  dlgStringEdit(Name);
  }

dlgTabPage

Funktion: Definiert eine Tab-Page.
Syntax: dlgTabPage(string Title) statement

Siehe auch dlgTabWidget, Layout-Information, Ein vollständiges Beispiel

Das dlgTabPage-Statement definiert eine Tab-Page mit dem angegebenen Title, die statement enthält.

Enthält Title ein '&'-Zeichen, wird das folgende Zeichen zum Hot-Key. Drückt der Benutzer Alt+hotkey, wird diese Tab-Page geöffnet. Soll im Text ein '&'-Zeichen verwendet werden, muss es mit einem Escape-Zeichen markiert werden.

Tab-Pages können nur innerhalb eines dlgTabWidget verwendet werden.

Standardmäßig enthält dlgTabPage ein dlgVBoxLayout, so dass man sich bei einer einfachen Tab-Page nicht um das Layout kümmern muss.

Beispiel

dlgTabWidget {
  dlgTabPage("Tab &1") {
    dlgLabel("This is page 1");
    }
  dlgTabPage("Tab &2") {
    dlgLabel("This is page 2");
    }
  }

dlgTabWidget

Funktion: Definiert einen Container für Tab-Pages.
Syntax: dlgTabWidget { tabpages }
dlgTabWidget(int &Index) { tabpages }

Siehe auch dlgTabPage, Layout-Information, Ein vollständiges Beispiel

dlgTabWidget definiert einen Platzhalter für einen Satz von Tab-Pages.

tabpages ist eine Liste eines oder mehrerer dlgTabPage-Objekte. Es dürfen keine anderen Dialog-Objekte in dieser Liste enthalten sein.

Index gibt an, welche Seite von Beginn an im Vordergrund sein soll. Wenn eine andere Seite angewählt wird, ändert sich die Variable Index dementsprechend. Die erste Seite hat (unabhängig vom Titel) als Index den Wert 0.

Beispiele

dlgTabWidget {
  dlgTabPage("Tab &1") {
    dlgLabel("This is page 1");
    }
  dlgTabPage("Tab &2") {
    dlgLabel("This is page 2");
    }
  }

dlgDialog("test")
{
  int TabNr = 0;
  int CheckBoxValue[];
  dlgTabWidget(TabNr) {
     for (int i = 0; i <= 9; i++) {
         string s;
         sprintf(s, "%d", i);
         dlgTabPage("Tab " + s) {
            dlgLabel("This is page " + s);
            dlgCheckBox(s, CheckBoxValue[i]) {
               string Msg;
               sprintf(Msg, "Value #%d: %d\n", TabNr, CheckBoxValue[TabNr]);
               dlgMessageBox(Msg);
               }
            }
         }
     }
};

dlgTextEdit

Funktion: Definiert ein mehrzeiliges Text-Eingabe-Feld.
Syntax: dlgTextEdit(string &Text)

Siehe auch dlgStringEdit, dlgTextView, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgTextEdit-Statement definiert ein mehrzeiliges text-Eingabe-Feld mit dem angegebenen Text.

Die einzelnen Zeilen in Text müssen mit einem Newline-Zeichen ('\n') getrennt werden. Beliebige Leerzeichen am Ende der Text-Zeilen werden gelöscht. Leere Zeilen am Endes des Textes werden vollständig entfernt.

Beispiel

string Text = "This is some text.\nLine 2\nLine 3";
dlgVBoxLayout {
  dlgLabel("&Edit the text");
  dlgTextEdit(Text);
  }

dlgTextView

Funktion: Definiert ein mehrzeiliges Text-Viewer-Feld.
Syntax: dlgTextView(string Text)
dlgTextView(string Text, string &Link) statement

Siehe auch dlgTextEdit, dlgLabel, Layout-Information, Ein vollständiges Beispiel

Das dlgTextView-Statement definiert ein mehrzeiliges Text-Viewer-Feld mit dem angegebenen Text.

Der Text darf HTML-Tags enthalten.

Externe Hyperlinks im Text werden mit dem entsprechenden Anwendungsprogramm geöffnet.

Falls Link angegeben wird und der Text Hyperlinks enthält, wird statement ausgeführt wenn der Benutzer auf einen Hyperlink klickt, wobei der Wert von Link auf das gesetzt wird, was im <a href=...>-Tag als Wert für href angegeben wurde. Ist die Link-Variable nach der Ausführung von statement nicht leer, so findet die standardmäßige Behandlung von Hyperlinks statt. Dies ist auch der Fall, wenn Link vor dem Öffnen von dlgTextView bereits Text enthält, was es ermöglicht, zu Beginn an eine vorgegebene Textstelle zu positionieren. Ist ein Link angegeben, so werden externe Hyperlinks nicht geöffnet.

Beispiel

string Text = "This is some text.\nLine 2\nLine 3";
dlgVBoxLayout {
  dlgLabel("&View the text");
  dlgTextView(Text);
  }

dlgVBoxLayout

Funktion: Öffnet einen Vertical-Box-Layout-Kontext.
Syntax: dlgVBoxLayout statement

Siehe auch dlgGridLayout, dlgHBoxLayout, Layout-Information, Ein vollständiges Beispiel

Das dlgVBoxLayout-Statement öffnet einen Vertical-Box-Layout-Kontext für das angegebene statement.

Standardmäßig enthält dlgDialog ein dlgVBoxLayout, so dass man sich bei einfachen Dialogen keine Gedanken zum Layout machen muss.

Beispiel

dlgVBoxLayout {
  dlgLabel("Box 1");
  dlgLabel("Box 2");
  dlgLabel("Box 3");
  }

Layout-Information

Alle Objekte eines User-Language-Dialogs werden in einem Layout-Kontext verwendet.

Es gibt verschiedene Layout-Kontexte, wie grid, horizontal oder vertical.

Grid-Layout-Kontext

Objekte in einem Grid-Layout-Kontext müssen die Raster-Koordinaten der Zelle (Cell) oder der Zellen angeben, in der/denen sie plaziert werden sollen. Um einen Text in Reihe (row) 5, Spalte (column) 2 zu plazieren, schreiben Sie

dlgGridLayout {
  dlgCell(5, 2) dlgLabel("Text");
  }

Soll das Objekt über mehr als eine Zelle gehen, müssen Sie die Koordinaten der Start-Zelle und der End-Zelle angeben. Um eine Group zu plazieren, die sich von Reihe 1, Spalte 2 über Reihe 3, Spalte 5 erstreckt, schreiben Sie

dlgGridLayout {
  dlgCell(1, 2, 3, 5) dlgGroup("Title") {
    //...
    }
  }

Horizontal-Layout-Kontext

Objekte in einem Horizontal-Layout-Kontext werden von links nach rechts plaziert.

Die Sonder-Objekte dlgStretch und dlgSpacing können verwendet werden, um die Verteilung der Abstände zu verfeinern.

Um zwei Buttons zu definieren, die sich bis an den rechten Rand des Dialogs erstrecken, schreiben Sie

dlgHBoxLayout {
  dlgStretch(1);
  dlgPushButton("+OK")    dlgAccept();
  dlgPushButton("Cancel") dlgReject();
  }

Vertical-Layout-Kontext

Objekte in einem Vertical-Layout-Kontext folgen denselben Vorschriften wie die in einem Horizontal-Layout-Kontext mit dem Unterschied, dass sie von oben nach unten angeordnet werden.

Gemischter Layout-Kontext

Vertical-, Horizontal- und Grid-Layout-Kontexte können gemischt werden, um die gewünschte Dialog-Struktur zu ezeugen. Siehe Ein vollständiges Beispiel.

Dialog-Funktionen

Folgende Funktionen können mit User-Language-Dialogen verwendet werden:

dlgAccept() schließt den Dialog und akzeptiert dessen Inhalt

dlgRedisplay() aktualisiert den Dialog nachdem beliebige Werte verändert wurden

dlgReset() setzt alle Dialog-Objekte auf den Ursprungswert zurück

dlgReject() schließt den Dialog und verwirft dessen Inhalt

dlgSelectionChanged() gibt an ob sich die aktuelle Auswahl in einer dlgListView oder dlgListBox geändert hat

dlgAccept()

Funktion: Schließt den Dialog und akzeptiert dessen Inhalt.
Syntax: void dlgAccept([ int Result ]);

Siehe auch dlgReject, dlgDialog, Ein vollständiges Beispiel

Die dlgAccept-Funktion schließt dlgDialog, und kehrt zurück nachdem das aktuelle Statement beendet wurde.

Jede Änderung, die der Benutzer im Dialog macht, wird übernommen und an die Variablen, die bei der Definition der Dialog-Objekte angegeben wurden, kopiert.

Die optionale Angabe von Result ist der Wert der vom Dialog geliefert wird. Das sollte typischerweise ein positiver Integer-Wert sein. Wird kein Wert angegeben, ist der Standardwert gleich 1.

Bitte beachten Sie, dass dlgAccept() wieder in die normale Programm- Routine zurückkehrt, so wie in dieser Sequenz:

dlgPushButton("OK") {
  dlgAccept();
  dlgMessageBox("Accepting!");
  }

Das Statement nach dlgAccept() wird noch ausgeführt!

Beispiel

int Result = dlgDialog("Test") {
               dlgPushButton("+OK")    dlgAccept(42);
               dlgPushButton("Cancel") dlgReject();
               };

dlgRedisplay()

Funktion: Aktualisiert den Dialog-Inhalt nachdem Werte verändert wurden.
Syntax: void dlgRedisplay(void);

Siehe auch dlgReset, dlgDialog, Ein vollständiges Beispiel

Die dlgRedisplay-Funktion wird aufgerufen, um den dlgDialog, nach dem Verändern von Variablen, die in den Dialog-Objekten definiert wurden, zu aktualisieren.

Sie brauchen nur dlgRedisplay() aufrufen, wenn der Dialog während der Ausführung des Programmcodes aktualisiert werden soll. Im folgenden Beispiel wird der Status auf "Running..." gesetzt und dlgRedisplay() muss aufgerufen werden, um die Änderungen für die Ausführung des Programms wirksam zu machen. Nach dem Ändern des Status auf "Finished.", braucht man dlgRedisplay() nicht mehr aufrufen, da alle Dialog-Objekte nach dem Verlassen des Statements aktualisiert werden.

Beispiel

string Status = "Idle";
int Result = dlgDialog("Test") {
               dlgLabel(Status, 1); // note the '1' to tell the label to be updated!
               dlgPushButton("+OK")    dlgAccept(42);
               dlgPushButton("Cancel") dlgReject();
               dlgPushButton("Run") {
                 Status = "Running...";
                 dlgRedisplay();
                 // some program action here...
                 Status = "Finished.";
                 }
               };

dlgReset()

Funktion: Setzt alle Dialog-Objekte auf ihren ursprünglichen Wert.
Syntax: void dlgReset(void);

Siehe auch dlgReject, dlgDialog, Ein vollständiges Beispiel

Die dlgReset-Funktion kopiert die ursprünglichen Werte in alle Dialog-Objekte des aktuellen dlgDialog zurück.

Alle Änderungen, die der Benutzer im Dialog machte, werden verworfen.

Ein Aufruf von dlgReject() impliziert einen Aufruf von dlgReset().

Beispiel

int Number = 1;
int Result = dlgDialog("Test") {
               dlgIntEdit(Number);
               dlgPushButton("+OK")    dlgAccept(42);
               dlgPushButton("Cancel") dlgReject();
               dlgPushButton("Reset")  dlgReset();
               };

dlgReject()

Funktion: Schließt den Dialog und verwirft seinen Inhalt.
Syntax: void dlgReject([ int Result ]);

Siehe auch dlgAccept, dlgReset, dlgDialog, Ein vollständiges Beispiel

Die dlgReject-Funktion veranlasst, dass dlgDialog geschlossen wird und nach dem Beenden der aktuellen Statement-Sequenz zurückkehrt.

Jede Änderung, die der Benutzer im Dialog machte, wird verworfen. Die Variablen, die während der Definition der Dialog-Objekte übergeben wurden, werden auf Ihren ursprünglichen Wert zurückgesetzt.

Der optionale Wert für Result wird vom Dialog zurückgegeben. Typischerweise ist das 0 oder ein negativer Integer-Wert. Wird kein Wert angegeben, ist er standardmäßig 0.

Beachten Sie, dass dlgReject() wieder in die normale Programm-Routine zurückkehrt, wie in dieser Sequenz:

dlgPushButton("Cancel") {
  dlgReject();
  dlgMessageBox("Rejecting!");
  }

Das Statement nach dlgReject() wird auch noch ausgeführt!

Der Aufruf von dlgReject() impliziert den Aufruf von dlgReset().

Beispiel

int Result = dlgDialog("Test") {
               dlgPushButton("+OK")    dlgAccept(42);
               dlgPushButton("Cancel") dlgReject();
               };

dlgSelectionChanged()

Funktion: Gibt an ob sich die aktuelle Auswahl in einer dlgListView oder dlgListBox geändert hat.
Syntax: int dlgSelectionChanged(void);
Rückgabewert: Die dlgSelectionChanged-Funktion liefert einen Wert ungleich 0, falls sich lediglich die Auswahl in der Liste geändert hat.

Siehe auch dlgListView, dlgListBox

Die dlgSelectionChanged-Funktion kann innerhalb eines Listen-Kontextes verwendet werden um festzustellen, ob das "statement" einer dlgListView oder dlgListBox aufgerufen wurde weil der Benutzer einen Doppelklick auf ein Listenelement gemacht hat, oder weil sich lediglich die Auswahl in der Liste geändert hat.

Falls das "statement" einer dlgListView oder dlgListBox keinen Aufruf von dlgSelectionChanged enthält, so wird das "statement" nur dann ausgeführt, wenn der Benutzer einen Doppelklick auf ein Listenelement macht. Soll ein ULP auf bloße Änderungen der Auswahl in der Liste reagieren, so kann es dlgSelectionChanged im "statement" der Liste aufrufen. Hierdurch wird erreicht, dass das "statement" auch bei einer Änderungen der Auswahl in der Liste ausgeführt wird.

Ist beim Öffnen des Dialogs bereits ein Listenelement ausgewählt, und das "statement" der Liste enthält einen Aufruf von dlgSelectionChanged, so wird das "statement" ausgeführt und dlgSelectionChanged liefert einen Wert ungleich 0, um den anfänglichen Wechsel von "keine Auswahl" zu einer konkreten Auswahl anzuzeigen. Etwaige spätere programmtechnische Veränderungen der Strings oder der Auswahl der Liste führen nicht zu einer automatischen Ausführung des "statements" der Liste. Dies ist wichtig zu bedenken, falls das ausgewählte Listenelement ein anderes Dialogobjekt steuert, beispielsweise ein dlgTextView, welches eine ausführlichere Darstellung des ausgewählten Listenelements anzeigt.

Beispiel

string Colors[] = { "red\tThe color RED", "green\tThe color GREEN", "blue\tThe color BLUE" };
int Selected = 0; // initially selects "red"
string MyColor;
dlgLabel(MyColor, 1);
dlgListView("Name\tDescription", Colors, Selected) {
  if (dlgSelectionChanged())
     MyColor = Colors[Selected];
  else
     dlgMessageBox("You have chosen " + Colors[Selected]);
  }

Escape-Zeichen

Einige Zeichen haben in Schaltflächen- oder Label-Texten eine besondere Bedeutung, so dass sie mit Escape-Zeichen markiert werden müssen, wenn sie tatsächlich im Text erscheinen sollen.

Dazu müssen Sie dem Zeichen einen Backslash voranstellen, so wie in

dlgLabel("Miller \\& Co.");

Das Ergebnis wird im Dialog so aussehen: "Miller & Co."

Beachten Sie, dass hier in Wirklichkeit zwei Backslash-Zeichen verwendet wurden, da diese Zeile erst durch den User-Language-Parser geht, der den ersten Backslash abzieht.

Ein vollständiges Beispiel

Hier folgt ein vollständiges Beispiel eines User-Language-Dialogs:

int hor = 1;
int ver = 1;
string fileName;
int Result = dlgDialog("Enter Parameters") {
  dlgHBoxLayout {
    dlgStretch(1);
    dlgLabel("This is a simple dialog");
    dlgStretch(1);
    }
  dlgHBoxLayout {
    dlgGroup("Horizontal") {
      dlgRadioButton("&Top", hor);
      dlgRadioButton("&Center", hor);
      dlgRadioButton("&Bottom", hor);
      }
    dlgGroup("Vertical") {
      dlgRadioButton("&Left", ver);
      dlgRadioButton("C&enter", ver);
      dlgRadioButton("&Right", ver);
      }
    }
  dlgHBoxLayout {
    dlgLabel("File &name:");
    dlgStringEdit(fileName);
    dlgPushButton("Bro&wse") {
      fileName = dlgFileOpen("Select a file", fileName);
      }
    }
  dlgGridLayout {
    dlgCell(0, 0) dlgLabel("Row 0/Col 0");
    dlgCell(1, 0) dlgLabel("Row 1/Col 0");
    dlgCell(0, 1) dlgLabel("Row 0/Col 1");
    dlgCell(1, 1) dlgLabel("Row 1/Col 1");
    }
  dlgSpacing(10);
  dlgHBoxLayout {
    dlgStretch(1);
    dlgPushButton("+OK")    dlgAccept();
    dlgPushButton("Cancel") dlgReject();
    }
  };

Unterstützte HTML-Tags

EAGLE unterstützt eine Teilmenge von Tags (Steuerzeichen), die zum Formatieren von HTML-Seiten verwendet werden. Damit kann man Texte von einigen Objekten im User-Language-Dialog, in der #usage-Directive oder in der Description von Bibliotheks-Objekten formatieren.

Text wird zu HTML-Text, wenn die erste Zeile ein Tag enthält. Wenn das nicht der Fall ist und Sie den Text formatieren wollen, schließen Sie den ganzen Text in das <html>...</html> Tag ein.

Die folgende Tabelle listet alle unterstützten HTML-Tags mit ihren verfügbaren Attributen auf:

Tag Beschreibung

<html>...</html> Ein HTML-Dokument.

<body>...</body> Der Inhalt eines HTML-Dokuments. Es versteht folgendes Attribut

bgcolor - Die Hintergrundfarbe, z. B. bgcolor="yellow" oder bgcolor="#0000FF". Dieses Attribut wirkt nur innerhalb einer dlgTextView.

<h1>...</h1> Eine Haupt-Überschrift.

<h2>...</h2> Eine untergeordnete Überschrift.

<h3>...</h3> Eine weiter untergeordnete Überschrift.

<p>...</p> Ein links-bündiger Abschnitt. Bestimmen Sie die Anordnung mit dem align Attribut. Mögliche Werte sind left, right und center.

<center>...</center> Ein zentrierter Abschnitt.

<blockquote>...</blockquote> Ein eingerückter Abschnitt, sinnvoll für Zitate.

<ul>...</ul> Eine ungeordnete Liste. Sie können auch ein type-Argument angeben um einen Bullet-Style zu definieren. Default ist type=disc, andere Typen sind circle und square.

<ol>...</ol> Eine geordnete Liste. Sie können auch ein type-Argument angeben um die Art der Nummerierung zu definieren. Default ist type="1", andere Typen sind "a" und "A".

<li>...</li> Ein Punkt in einer Liste. Dieses Tag kann nur innerhalb eines ol oder ul Kontext verwendet werden.

<pre>...</pre> Für größere Mengen von Code. Leerzeichen im Inhalt bleiben erhalten. Für kleinere Mengen Code, benutzen Sie den Inline-style code.

<a>...</a> Ein Anker oder Link. Folgende Attribute sind erlaubt

href - Das Referenz-Ziel wie in <a href="target.html">...</a>. Sie dürfen auch einen zusätzlichen Anker innerhalb des angegebenen Ziel-Dokuments angeben, z. B. <a href="target.html#123">...</a>. Falls Sie auf eine lokale Datei verlinken wollen, deren Name ein Leerzeichen enthält, müssen Sie dem Dateinamen ein file: voranstellen, wie in <a href="file:/path with blanks/target.html">...</a>.
name - Der Anker-Name, wie in <a name="123">...</a>.

<em>...</em> Emphasized (kursiv)(genauso wie <i>...</i>).

<strong>...</strong> Stark (genauso wie <b>...</b>).

<i>...</i> Kursiver Text.

<b>...</b> Fetter Text.

<u>...</u> Unterstrichener Text.

<big>...</big> Eine größere Texthöhe.

<small>...</small> Eine kleinere Texthöhe.

<code>...</code> Kennzeichnet Code. (wie auch <tt>...</tt>. Für größere Mengen an Code, verwenden Sie das Block-Tag pre.

<tt>...</tt> Typewriter Schriftart.

<font>...</font> Zur Bestimmung von Texthöhe, Schrift-Familie und Textfarbe. Das Tag versteht folgende Attribute:

color - Die Textfarbe, z. B. color="red" oder color="#FF0000".
size - Die logische Größe der Schrift. Logische Größen von 1 bis 7 werden unterstützt. Der Wert darf entweder absolut, z. B. size=3, oder relativ, wie size=-2 sein. Im letzten Fall werden die Größen einfach addiert.
face - Die Schriftart-Familie, z. B. face=times.

<img...> Ein Bild. Dieses Tag versteht die folgenden Attribute:

src - Der Name des Bildes, z. B. <img src="image.png">.
Der URL des Bildes kann auch extern sein, wie in <img src="http://web.cadsoft.de/cslogo.gif">.
width - Die Breite des Bildes. Passt das Bild nicht in die angegebene Größe, wird es automatisch skaliert.
height - Die Höhe des Bildes.
align - Bestimmt wo das Bild plaziert wird. Defaultmäßig wird ein Bild "inline" plaziert, genauso wie ein Buchstabe. Legen Sie left oder right fest, um das Bild an der entsprechenden Stelle zu plazieren.

<hr> Eine waagrechte Linie.

<br> Ein Zeilenumbruch.

<nobr>...</nobr> Kein Zeilenumbruch.Erhält "Word Wrap".

<table>...</table> Eine Tabellen-Definition. Die Standardtabelle ist ohne Rahmen. Geben Sie das boolesche Attribut border an um einen Rahmen zu erhalten. Andere Attribute sind:

bgcolor - Die Hintergrundfarbe.
width - Die Tabellenbreite. Wird entweder in Pixel oder in Prozent der Spaltenbreite angegeben, z. B. width=80%.
border - Die Breite des Tabellenrandes. Default ist 0 (= kein Rand).
cellspacing - Zusätzlicher Leerraum um die Tabellenzelle. Default ist 2.
cellpadding - Zusätzlicher Leerraum um den Inhalt einer Tabellenzelle. Default ist 1.

<tr>...</tr> Eine Tabellen-Reihe. Kann nur mit table verwendet werden. Versteht die Attribute:

bgcolor - Die Hintergrundfarbe.

<td>...</td> Eine Zelle in einer Tabelle. Kann nur innerhalb tr verwendet werden.Versteht die Attribute:

bgcolor - Die Hintergrundfarbe.
width - Die Zellenbreite. Wird entweder in Pixel oder in Prozent der gesamten Tabellenbreite angegeben, z. B. width=50%.
colspan - Legt fest wieviele Spalten diese Zelle belegt. Default ist 1.
rowspan - Legt fest wieviele Reihen diese Zelle belegt. Default ist 1.
align - Positionierung, mögliche Angaben sind left, right und center. Default ist links-bündig.

<th>...</th> Eine "Header"-Zelle in der Tabelle. Wie td aber als default mit zentrierter Ausrichtung und fetter Schriftart.

<author>...</author> Markiert den Autor des Texts.

<dl>...</dl> Eine Definitions-Liste.

<dt>...</dt> Ein Definitions-Tag. Kann nur innerhalb dl verwendet werden.

<dd>...</dd> Definitions-Daten. Kann nur innerhalb dl verwendet werden.

Tag Bedeutung

< <

> >

& &

  Leerzeichen ohne Umbruch

ä ä

ö ö

ü ü

Ä Ä

Ö Ö

Ü Ü

ß ß

© ©

° °

µ µ

± ±

" "

Automatischer Backup

Maximum backup level

Der Write-Befehl erzeugt Backup-Kopien der gesicherten Dateien. Sie haben denselben Namen wie die Originaldateien mit einer modifizierten Extension, nach dem Muster

.x#n

Dabei steht für 'x' der Buchstabe

b in Board-Dateien
s in Schaltplan-Dateien
l in Bibliotheks-Dateien
d in Designblock-Dateien

n steht für eine einstellige Zahl von 1..9. Höhere Ziffern zeigen ältere Dateien an.

Die feste Position des Zeichens '#' ermöglicht das einfache Löschen aller Backup-Dateien aus dem Betriebssystem heraus mit *.?#? als "Wildcard".

Bitte beachten Sie, dass Backup-Dateien mit derselben Ziffer 'n' nicht notwendigerweise konsistente Paare von Platinen- und Schaltplan-Dateien repräsentieren.

Die maximale Zahl von Backup-Kopien kann im Backup-Dialog gesetzt werden.

Auto-Backup-Interval

Wurde eine Zeichnung modifiziert, wird automatisch nach der unter Auto backup interval eingestellten Zeit eine Sicherungskopie erstellt.

Diese Sicherungskopie erhält den Namen nach folgendem Schema:

.x##

Dabei steht für 'x' der Buchstabe

b in Board-Dateien
s in Schaltplan-Dateien
l in Bibliotheks-Dateien
d in Designblock-Dateien

Die Sicherheits-Backup-Datei wird nach einem erfolgreichen Abspeichern der Zeichnung wieder gelöscht. Kann die Zeichnung nicht mit dem WRITE-Befehl gespeichert werden (z. B. aufgrund eines Stromausfalls), benennen Sie die Datei einfach um. So kann sie als normale Schaltplan-, Board- bzw. Bibliotheksdatei wieder geladen werden.

Die Sicherungsintervall kann im Backup-Dialog gesetzt werden.

Datei-Locking

EAGLE unterstützt eine einfache Form des Sperrens von Dateien. Dateien, die in einem EAGLE-Zeichnungs- oder Texteditor geladen sind, werden standardmäßig zum Schreiben gesperrt. Sobald der Editor geschlossen oder eine andere Datei geladen wird, wird der Lock freigegeben.

Der Lock-Mechanismus benutzt eine Lock-Datei namens .file.lck, wobei file der Name der zu sperrenden Datei ist.

Wenn eine bereits gesperrte Datei geladen werden soll, bietet EAGLE in einem Dialog verschiedene Möglichkeiten, wie Speichern der Datei unter einem anderen Namen, Wiederholen, Löschen oder Ignorieren des Locks an.

Wiederholen kann gewählt werden, sobald der Lock-Inhaber die Datei geschlossen hat.

Das Löschen des Locks kann fehlschlagen, wenn Sie nicht die entsprechende Dateirechte für die Lock-Datei haben. Es ist ratsam den Lock-Inhaber zu informieren, wenn Sie seine Lock-Datei gelöscht haben. Die Option Löschen ist auch nützlich, falls die Lock-Datei, zum Beispiel nach einem unbeabsichtigen Stromausfall übrig geblieben ist.

Wenn Sie den Lock ignorieren, können Sie die Datei editieren, aber nur unter einen anderen Namen speichern. Diese Option ist bequem, wenn Sie die Datei nicht verändern, sondern nur zur Überprüfung oder für Testzwecke öffnen wollen.

Im CAM-Prozessor und bei Dateien mit nur Leserechten wird keine Lock-Datei erzeugt.

Das File-Locking kann im Options-Menü des Control-Panels unter Datensicherung / Sperrschutz oder mit dem SET-Befehl aus- und eingeschaltet werden. Wenn das File-Locking ausgeschaltet ist, beachtet EAGLE die Locks von anderen Anwendern mit eingeschaltetem Locking (und berichtet dies wenn nötig). Lediglich eigene Locks werden nicht erzeugt. Die Lock-Einstellung wird in der Eaglerc-Datei gespeichert.

Forward&Back-Annotation

Eine Schaltplandatei und die zugehörigen Platinendatei sind durch automatische Forward&Back-Annotation logisch verknüpft. Der Benutzer muss sich darum normalerweise nicht kümmern. Dennoch wird in diesem Abschnitt beschrieben, was genau bei der Forward&Back-Annotation geschieht:

Holt man ein neues Bauteil in den Schaltplan, so wird das zugehörige Package in der linken unteren Ecke der Platinenzeichnung plaziert. Enthält das Bauteil Pins mit der Direction "Pwr", dann werden die zugehörigen Pads automatisch mit dem entsprechenden Versorgungssignal verbunden.

Wird ein Bauteil aus einem Schaltplan gelöscht, so wird das zugehörige Package auch aus der Platine gelöscht. Leiterbahnen, die mit dem Package verbunden waren, bleiben unberührt. Unter Unständen sind zusätzliche Vias erforderlich, um diese Signale an den Stellen zu verbinden, an denen sich die Pads des gelöschten Bauteils befunden haben.

Löscht man ein Bauteil aus einer Platine, werden alle "Gates", die sich in diesem Bauteil befinden, aus dem Schaltplan gelöscht. Dies kann unterschiedliche Seiten betreffen, falls die "Gates" auf mehrere Seiten verteilt waren.

Nach einer Operation, die ein Pad von einem Signal entfernt bzw. es zu einem Signal hinzufügt, das Polygone enthält, kann die Anzeige der Anschlüsse an das Polygon fehlerhaft sein. Der RATSNEST-Befehl korrigiert die Anzeige. Derselbe Effekt kann bei Undo-/Redo-Operationen auftreten, die sich auf Pads beziehen welche mit Signalen verbinden sind, die Polygone enthalten.
Die Befehle Pinswap und Gateswap im Schaltplan sorgen dafür, dass alle notwendigen Änderungen auch im Board durchgeführt werden. Allerdings können die Leiterbahnen anschließend die Design Rules verletzen. Der Benutzer sollte deshalb nach diesen Befehlen die Platine entsprechend editieren.
Um sicherzustellen, dass eine Platine und ein Schaltplan zusammengehören (und über Forward&Back-Annotation verbunden sind), müssen die beiden Dateien denselben Namen (mit Extensions .brd und .sch) haben und im gleichen Verzeichnis gespeichert sein.
Der Replace-Befehl prüft, ob alle Pads des alten Package, die einem Pin zugewiesen waren, auch im neuen Package vorhanden sind - unabhängig davon, ob sie mit einem Signal verbunden sind oder nicht.
Liegen die Pins zweier Schaltplan-Symbole übereinander (Verbindung ohne sichtbare Netz-Linie), dann wird eine Netz-Linie erzeugt, wenn eines der Bauteile wegbewegt wird. Damit wird eine unnötige Ripup-Operation im Board vermieden.

Konsistenzprüfung

Damit die Forward&Back-Annotation wirksam werden kann, müssen Platine und Schaltplan konsistent sein. Das heisst, sie müssen äquivalente Bauteile und Netze bzw. Signale enthalten.

Unter normalen Umständen sind Platine und Schaltplan immer konsistent, sofern sie nicht separat editiert worden sind (in diesem Fall würden Sie mit der Meldung Die Forward&Back-Annotation ist nicht aktiv! gewarnt worden sein).

Wenn ein Platinen/Schaltplan-Paar geladen wird, überprüft das Programm Konsistenzmarkierungen in den Dateien, um zu sehen, ob sie noch konsistent sind. Weisen diese Markierungen auf eine Inkonsistenz hin, dann bietet Ihnen das Programm an, einen Electrical Rule Check (ERC) auszuführen, der beide Dateien überprüft.

Fällt die Prüfung positiv aus, werden die Dateien als konsistent markiert, und die Forward&Back-Annotation wird aktiviert.

Werden die Dateien als inkonsistent erkannt, erscheint das ERC-Protokoll in einem Dialog und die Forward&Back-Annotation wird nicht aktiviert.

Bitte erschrecken Sie nicht, wenn zahlreiche Fehlermeldungen erscheinen. In den meisten Fällen reduziert schon eine einzige Korrektur (wie die Umbenennung eines Netzes) die Zahl der Meldungen für den nächsten Durchlauf erheblich.

Platine und Schaltplan konsistent machen

Um ein inkonsistentes Schaltplan-/Platinen-Paar konsistent zu machen, müssem Sie alle im ERC-Protokoll aufgeführten Inkonsistenzen manuell beseitigen. Das kann mit Hilfe der Editor-Befehle wie NAME, VALUE, PINSWAP, REPLACE etc. erreicht werden. Nach der Korrektur müssen Sie den ERC-Befehl nochmals verwenden, um die Dateien zu überprüfen und um die Forward&Back-Annotation aktivieren zu können.

Hinweis Attribute:

Namen und Werte von Attributen können mit ATTRIBUTE zur Konsistenzherstellung angepaßt werden. Handelt es sich um Bibliotheks-Attribute, kann ein Austausch der Devices für die betroffenen Bauteile mit REPLACE im Schaltplan erforderlich sein.

Hinweis Packagevarianten:

Hier gibt es mehrere Ansätze:

Austausch der Packages für die betroffenen Elemente mit REPLACE im Board. Ersetzen mit den Packages gemäß der Definition im Schaltplan.
Austausch der Devices für die betroffenen Bauteile mit REPLACE im Schaltplan. Ersetzen mit den Packages gemäß der Definition im Board. Achten Sie dabei auch auf mögliche Änderungen bei den Attributen.
Austausch der Packagevarianten im Schaltplan mit CHANGE PACKAGE.

Einschränkungen

Folgende Aktionen sind in einer Platine nicht erlaubt, wenn die Back-Annotation aktiv ist, wenn also der Schaltplan ebenfalls geladen ist:

Element hinzufügen (ADD) oder kopieren, das Pads oder Smds enthält
Luftlinie löschen
Verbindungen mit dem Signal-Befehl definieren
Schaltplanteile mit Paste von einem Board in ein Board kopieren, wenn darin Pads, Smds oder verbundene Signale enthalten sind

Sollten Sie eine dieser Operationen auszuführen versuchen, dann erhalten Sie eine Meldung, dass dies unter Kontrolle der Back-Annotation nicht möglich ist. Bitte führen Sie die Operation dann im Schaltplan aus, sie wird dann automatisch in die Platine übernommen. Sollten Sie die Operation dennoch im Board ausführen wollen, müssen Sie das Schaltplan-Fenster schließen. In diesem Fall riskieren Sie aber den Verlust der Konsistenz!

Tolerierte Bauteil-/Element- und Netz-/Signal-Abweichungen

Außer Elementen ohne Pads oder Smds toleriert EAGLE auch zusätzliche Elemente mit Pads/Smds, solange diese mit keinem Signal verbunden sind. Signale ohne entsprechende Netze werden toleriert, solange sie keine Verbindung zu einem Pad/Smd haben (dies ist nützlich für Linien in einer Kupferlage ohne elektrische Bedeutung).

Lizenz

Als legaler EAGLE-Benutzer müssen Sie im Besitz einer registrierten Benutzer-Lizenz sein. Bitte überprüfen Sie, ob im Dialog "Hilfe/Über EAGLE" unter "Lizenziert auf:" Ihr Name und Ihre Anschrift eingetragen ist. Sollten Sie Zweifel an der Echtheit Ihrer Lizenz haben, setzen Sie sich bitte mit unserem Support-Personal in Verbindung.

Unter Mac OS X finden Sie diese Angaben unter "EAGLE/Über EAGLE".

Es gibt verschiedene Lizenz-Typen, die sich darin unterscheiden, wie viele Benutzer erlaubt sind und wo das Programm verwendet werden darf.

Einzelplatz-Lizenz

Nur ein Benutzer darf das Programm zu einer bestimmten Zeit benutzen. Der Benutzer darf das Programm allerdings auf unterschiedlichen Computern installieren, solange er sicherstellt, dass nur eine Programmkopie gleichzeitig verwendet wird.

Ein typischer Anwender einer Einzelplatz-Lizenz ist jemand, der einen fest installierten PC und zusätzlich einen Notebook-Computer hat, den er unterwegs benutzt. Da er immer nur einen Computer benutzt, reicht die Einzelplatz-Lizenz aus.

Mehrbenutzer-Lizenz

Eine Mehrbenutzer-Lizenz darf von mehreren Benutzern (bis zu der auf der Lizenz angegebenen maximalen Anzahl) gleichzeitig benutzt werden. Das Programm darf auf beliebig vielen unterschiedlichen Computern am Standort des Lizenznehmers installiert sein.

Commercial License

Das Programm darf für jeden Zweck verwendet werden, kommerziell oder privat.

Educational License

Das Programm darf ausschließlich in Ausbildungsstätten wie Schulen oder Universitäten zu Ausbildungszwecken verwendet werden.

Student License

Das Programm darf ausschließlich für private Zwecke verwendet werden. Jede kommerzielle Anwendung ist untersagt. Es stellt eine Verletzung der Lizenzbedingungen dar, wenn Sie durch Gebrauch einer Studentenversion Geld verdienen.

EAGLE-Editionen

EAGLE ist in verschiedenen Editionen verfügbar, um den Ansprüchen verschiedener Benutzergruppen gerecht zu werden.

Ultimate

Die Ultimate Edition stellt die volle Funktionalität zur Verfügung:

Platinenfläche bis zu 4000x4000mm (157x157inch)
bis zu 16 Signallayer
bis zu 999 Schaltplanseiten

Premium

Die Premium Edition besitzt folgende Einschränkungen:

die Platinenfläche ist auf 160x100mm (ca. 6.3x4inch) beschränkt, was einer ganzen Europakarte entspricht
es stehen nur sechs Signallayer (Top, Route2, Route3, Route14, Route15 und Bottom) zur Verfügung
ein Schaltplan kann aus bis zu 99 Seiten bestehen

Maker

Die Maker Edition besitzt folgende Einschränkungen:

die Platinenfläche ist auf 160x100mm (ca. 6.3x4inch) beschränkt, was einer ganzen Europakarte entspricht
es stehen nur sechs Signallayer (Top, Route2, Route3, Route14, Route15 und Bottom) zur Verfügung
ein Schaltplan kann aus bis zu 99 Seiten bestehen
die Maker Edition darf nur nicht-kommerziell eingesetzt werden

Standard

Die Standard Edition besitzt folgende Einschränkungen:

die Platinenfläche ist auf 100x80mm (4x3.2inch) beschränkt, was einer halben Europakarte entspricht
es stehen nur zwei Signal-Layer (Top und Bottom) zur Verfügung
ein Schaltplan kann nur aus zwei Seiten bestehen

Falls Sie eine Fehlermeldung der Form

Die Standard-Edition von EAGLE kann die gewünschte Aktion nicht ausführen!

erhalten, so bedeutet dies, dass Sie versucht haben, etwas zu tun, das im Widerspruch zu den Einschränkungen der benutzten EAGLE-Edition steht, wie etwa ein Bauteil ausserhalb der zulässigen Fläche zu plazieren.

Alle Editionen von EAGLE sind in der Lage, Dateien zu laden, die mit der Premium oder Ultimate Edition erzeugt wurden, selbst wenn diese Zeichnungen die Editier-Möglichkeiten der verwendeten Edition übersteigen.

Um zu sehen, welcher Edition Ihre Lizenz entspricht, wählen Sie Hilfe/Über EAGLE aus dem Menü des Control Panels.

`F1 HELP`		Hilfe-Funktion
`Alt+F2 WINDOW FIT`		Zeichnung formatfüllend darst.
`F2 WINDOW;`		Bildschirminhalt auffrischen
`F3 WINDOW 2`		In das Bild hineinzoomen, Fakt. 2
`F4 WINDOW 0.5`		Herauszoomen um Faktor 2
`F5 WINDOW (@);`		Neues Zentrum an der Position des Mauszeigers
`F6 GRID;`		Raster ein-/ausblenden

`delete`		Löscht das Attribut mit dem angegebenen Namen aus allen Technology-Varianten (in diesem Fall darf kein 'value' angegeben werden).
`variable`		Das Attribut wird als variabel markiert, so dass es im Schaltplan überschrieben werden kann (dies ist die Standardeinstellung).
`constant`		Attribute, die als konstant markiert sind, können nicht im Schaltplan überschrieben werden (es sei denn, der Anwender besteht darauf).

`ATTRIBUTE ABC '123'`		(standardmäßig variabel)
`ATTRIBUTE ABC constant`		(ABC behält den Wert '123')

`*`		steht für eine beliebige Anzahl beliebiger Zeichen
`?`		steht für genau ein Zeichen
`[...]`		steht für irgend eines der Zeichen zwischen den Klammern

Layer wechseln		`CHANGE LAYER name \| number`
Text ändern		`CHANGE TEXT [ text ]`
Texthöhe		`CHANGE SIZE value`
Textstärke		`CHANGE RATIO ratio`
Text Zeilenabstand		`CHANGE LINEDISTANCE value`
Text Font		`CHANGE FONT VECTOR \| PROPORTIONAL \| FIXED`
Text Ausrichtung		`CHANGE ALIGN BOTTOM \| LEFT \| CENTER \| TOP \| RIGHT`
Linienbreite		`CHANGE WIDTH value`
Linientyp		`CHANGE STYLE value`
Arc-Ende		`CHANGE CAP ROUND \| FLAT`
Pad-Form		`CHANGE SHAPE SQUARE \| ROUND \| OCTAGON \| LONG \| OFFSET`
Pad-/Via-/Smd-Flags		`CHANGE STOP \| CREAM \| THERMALS \| FIRST OFF \| ON`
Pad-/Via-Durchmesser		`CHANGE DIAMETER diameter`
Pad-/Via/Hole-Bohrd.		`CHANGE DRILL value`
Via Layer		`CHANGE VIA from-to`
Smd-Maße		`CHANGE SMD width height`
Smd-Abrundung		`CHANGE ROUNDNESS value`
Pin-Parameter		`CHANGE DIRECTION NC \| IN \| OUT \| IO \| OC \| HIZ \| SUP \| PAS \| PWR`
		`CHANGE FUNCTION NONE \| DOT \| CLK \| DOTCLK`
		`CHANGE LENGTH POINT \| SHORT \| MIDDLE \| LONG`
		`CHANGE VISIBLE BOTH \| PAD \| PIN \| OFF`
		`CHANGE SWAPLEVEL number`
Polygon-Parameter		`CHANGE THERMALS OFF \| ON`
		`CHANGE ORPHANS OFF \| ON`
		`CHANGE ISOLATE distance`
		`CHANGE POUR SOLID \| HATCH \| CUTOUT`
		`CHANGE RANK value`
		`CHANGE SPACING distance`
Gate-Parameter		`CHANGE SWAPLEVEL number`
		`CHANGE ADDLEVEL NEXT \| MUST \| ALWAYS \| CAN \| REQUEST`
Netzklasse		`CHANGE CLASS number \| name`
Package-Variante		`CHANGE PACKAGE part_name [device_name] \| 'device_name' [part_name]`
Technologie		`CHANGE TECHNOLOGY part_name [device_name] \| 'device_name' [part_name]`
Attribute-Anzeige		`CHANGE DISPLAY OFF \| VALUE \| NAME \| BOTH`
Frame-Parameter		`CHANGE COLUMS value`
		`CHANGE ROWS value`
		`CHANGE BORDER NONE \| BOTTOM \| RIGHT \| TOP \| LEFT \| ALL`
Label		`CHANGE XREF OFF \| ON`
Bemaßungs-Typ		`CHANGE DTYPE PARALLEL \| HORIZONTAL \| VERTICAL \| RADIUS \| DIAMETER \| ANGLE \| LEADER`
Bemaßungs-Einheit		`CHANGE DUNIT [MIC \| MM \| MIL \| INCH] [OFF \| ON] [precision]`
Bemaßungs-Linien		`CHANGE DLINE width [ extension_width [ extension_length [ extension_offset ]]] (Hilfslinienwerte können auf AUTO gesetzt werden. Nicht zu verändernde Werte können mit '-' angegeben werden, siehe Beispiele)`
Populate		`CHANGE POPULATE OFF \| ON (ist nur im Board ohne aktiver F/B-Annotation verfügbar)`

`-ecfm`		Blenden-Emulation ein, positive Koordinaten ein, Pads ausfüllen ein, Ausgabe spiegeln
`-ec-f+`		Blenden-Emulation ein, positive Koordinaten aus, Pads ausfüllen ein

Verzeichnisse		Die Datei mit dem Namen DESCRIPTION darin
Bibliotheken		DESCRIPTION-Befehl in der Bibliothek
Devices		DESCRIPTION-Befehl im Device-Editor
Packages		DESCRIPTION-Befehl im Package-Editor
Design-Regeln		Die Beschreibung der Design-Regel-Datei im DRC-Dialog
User-Language-Programme		Text, durch die `#usage`-Anweisung gekennzeichnet
Script-Dateien		Der Kommentar am Anfang der Script-Datei
CAM-Jobs		DESCRIPTION-Befehl im CAM-Prozessor-Job

ADD		Bauteil spiegeln
ARC		aktiven Layer wechseln
CIRCLE		aktiven Layer wechseln
COPY		Objekt spiegeln
INVOKE		Gatter spiegeln
LABEL		aktiven Layer wechseln
LINE		aktiven Layer wechseln
MOVE		Objekt oder Gruppe spiegeln
PASTE		Gruppe spiegeln
POLYGON		aktiven Layer wechseln
RECT		aktiven Layer wechseln
ROUTE		aktiven Layer wechseln
SMD		aktiven Layer wechseln
TEXT		aktiven Layer wechseln

ADD		Bauteil drehen
ARC		Drehsinn des Kreisbogens ändern
BUS		Knickwinkel ändern
CHANGE		Change auf Gruppe anwenden
DELETE		Gruppe löschen
GROUP		Polygon schließen
INVOKE		Gatter drehen
LABEL		Label drehen
LINE		Knickwinkel ändern
MIRROR		Gruppe spiegeln
MOVE		Objekt drehen bzw. Gruppe selektieren
NET		Knickwinkel ändern
PAD		Pad drehen
PASTE		Gruppe drehen
PIN		Pin drehen
POLYGON		Knickwinkel ändern
RIPUP		Ripup auf Gruppe anwenden
ROTATE		Gruppe drehen
ROUTE		Knickwinkel ändern
SMD		Smd drehen
SPLIT		Knickwinkel ändern
TEXT		Text drehen

`%C`		die Spalte, in die der Cursor positioniert werden soll (zur Zeit immer `1`)
`%F`		der Name der zu ladenden Datei
`%L`		die Zeile, in die der Cursor positioniert werden soll

Syntax:		`SET BEEP OFF \| ON;`
Input:		`SET BEEP OFF;`
		oder
		`SET BEEP ON;`

Syntax:		`DISPLAY option layer_name..`
Input:		`DISPLAY TOP PINS VIAS`

Syntax:		`MOVE • •..`
Input:		`MOVE`
		`Mausklick auf erstes zu bewegendes Element`
		`Mausklick auf das Ziel`
		`Mausklick auf zweites zu bewegendes Element`
		`etc.`

`>`		rechte Maustaste
`A`		Alt-Taste
`C`		Ctrl-Taste
`P`		Polar-Koordinaten (relativ zur Marke, x = Radius, y = Winkel in Grad, gegen den Uhrzeigersinn)
`R`		Relative Koordinaten (relativ zur Marke)
`S`		Shift-Taste

`S`		setzt das Spin-Flag, welches die Funktion abschaltet, die Texte von unten oder rechts lesbar hält (nur im Board-Kontext verfügbar)
`M`		setzt das Mirror-Flag, welches das Objekt an der Y-Achse spiegelt
`Rnnn`		setzt die Rotation auf den angegebenen Wert, der im Board-Kontext im Bereich `0.0`...`359.9` (mit einer Auflösung von 0.1 Grad) und im Schaltplan-Kontext einer der Werte `0`, `90`, `180` oder `270` sein darf (Winkel dürfen auch negativ angegeben werden, sie werden dann in den entsprechenden positiven Wert umgewandelt)

R0		keine Rotation
R90		um 90° gegen den Uhrzeigersinn gedreht
R-90		um 90° im Uhrzeigersinn gedreht (wird in 270° umgerechnet)
MR0		an der Y-Achse gespiegelt
SR0		Texte werden mit "Spin" dargestellt
SMR33.3		um 33.3° gegen den Uhrzeigersinn gedreht, gespiegelt und mit "Spin"

0:		Das Symbol (Gate) kann im Schaltplan nicht mit einem anderen vertauscht werden.
>0		Das Symbol (Gate) kann im Schaltplan mit jedem anderen Symbol dieses Typs vertauscht werden, das denselben Swaplevel hat (auch zwischen verschiedenen Devices).

`Gatter`		Löscht das gesamte Bauteil, in dem sich dieses Gatter befindet (auch wenn die Gatter auf mehrere Schaltplan-Seiten verteilt sind). Bei aktiver Forward&Backannotation werden die Leiterbahnen, die an dem Bauteil im Board angeschlossen sind, nicht in Luftlinien umgewandelt (was beim Löschen einzelner Gatter geschehen würde), ausgenommen die Fälle wo ein Pin des gelöschten Bauteils nur direkt mit genau einem anderen Pin und keiner Netzlinie verbunden ist
`Polygon-Linie`		Löscht das gesamte Polygon
`Netz/Bus-Linie`		Löscht das gesamte Netz- bzw. Bus-Segment

gerade Linie		lineare Bemaßung, die den Abstand der Endpunkte der Linie anzeigt
gebogene Linie		radiale Bemaßung, die den Radius des Kreisbogens anzeigt
Circle		Durchmesser-Bemaßung, die den Durchmesser des Kreises anzeigt
Hole		Durchmesser-Bemaßung, die den Durchmesser des Lochs anzeigt

`EDIT name.brd`		lädt eine Platine
`EDIT name.sch`		lädt einen Schaltplan
`EDIT name.pac`		lädt ein Package
`EDIT name.sym`		lädt ein Symbol
`EDIT name.dev`		lädt ein Device
`EDIT name.dbl`		lädt einen Designblock in den Voransicht-Dialog
`EDIT name.dbl;`		lädt einen Designblock in den bzw. die Editor(en)
`EDIT .s3`		lädt Seite 3 eines Schaltplans
`EDIT .s5 .s2`		verschiebt Seite 5 vor Seite 2 und lädt sie (falls Seite 5 nicht existiert, wird eine neue Seite vor Seite 2 eingefügt)
`EDIT .s2 .s5`		verschiebt Seite 2 vor Seite 5 und lädt sie (falls Seite 5 nicht existiert, wird Seite 2 zur letzten Seite)
`EDIT name.mod`		lädt (oder erzeugt) ein Modul in einem Schaltplan
`EDIT name.m2`		lädt (oder erzeugt) Seite 2 eines Moduls
`EDIT .m3`		lädt (oder erzeugt) Seite 3 des aktuellen Moduls
`EDIT .s2 modY.m1`		verschiebt Seite 2 vor Seite 1 von Modul 'modY' und lädt sie
`EDIT modX.m3 modY.m1`		verschiebt Seite 3 von Modul 'modX' vor Seite 1 von Modul 'modY' und lädt sie
`EDIT;`		zeigt das Inhaltsverzeichnis (in einer Bibliothek)

`.bmp`		Windows-Bitmap-Datei
`.png`		Portable-Network-Graphics-Datei
`.pbm`		Portable-Bitmap-Datei
`.pgm`		Portable-Grayscale-Bitmap-Datei
`.ppm`		Portable-Pixelmap-Datei
`.tif`		TIFF-Datei
`.xbm`		X-Bitmap-Datei
`.xpm`		X-Pixmap-Datei

`GRID ON;`		Raster darstellen
`GRID OFF;`		Raster ausschalten
`GRID DOTS;`		Raster als Punkte darstellen
`GRID LINES;`		Raster als Linien darstellen
`GRID MIC;`		Rastereinheit ist Mikrometer
`GRID MM;`		Rastereinheit ist mm
`GRID MIL;`		Rastereinheit ist Mil (0.001 Inch)
`GRID INCH;`		Rastereinheit ist Inch (Zoll)
`GRID FINEST;`		Raster auf kleinstmöglichen Wert einstellen
`GRID grid_size;`		Rasterabstand in der aktuellen Einheit
`GRID LAST;`		Setzt die Grid-Parameter auf die zuletzt
		eingestellten Werte
`GRID DEFAULT;`		Einstellung auf Standardwerte
`GRID grid_size grid_multiple;`
		grid_size = Rasterabstand
		grid_multiple = Rasterfaktor
`GRID ALT ...;`		Definiert das alternative Grid

`%F`		aktiviert das Zeichnen eines Rahmens um das Label
`%N`		der Name des Netzes
`%S`		die nächste Seitennummer
`%C`		die Spalte auf der nächsten Seite
`%R`		die Zeile auf der nächsten Seite

1 Top		Leiterbahnen oben
2 Route2		Innenlage
3 Route3		Innenlage
4 Route4		Innenlage
5 Route5		Innenlage
6 Route6		Innenlage
7 Route7		Innenlage
8 Route8		Innenlage
9 Route9		Innenlage
10 Route10		Innenlage
11 Route11		Innenlage
12 Route12		Innenlage
13 Route13		Innenlage
14 Route14		Innenlage
15 Route15		Innenlage
16 Bottom		Leiterbahnen unten
17 Pads		Pads (bedrahtete Bauteile)
18 Vias		Vias (durchgehend)
19 Unrouted		Luftlinien
20 Dimension		Platinen-Umrisse (und Kreise für Holes)
21 tPlace		Bestückungsdruck oben
22 bPlace		Bestückungsdruck unten
23 tOrigins		Aufhängepunkte oben (Kreuz automatisch generiert)
24 bOrigins		Aufhängepunkte unten (Kreuz automatisch generiert)
25 tNames		Servicedruck oben (Bauteile-Namen, NAME)
26 bNames		Servicedruck unten (Bauteile-Namen, NAME)
27 tValues		Bauteile-Werte oben (VALUE)
28 bValues		Bauteile-Werte unten (VALUE)
29 tStop		Lötstopmaske oben (automatisch generiert)
30 bStop		Lötstopmaske unten (automatisch generiert)
31 tCream		Lotpaste oben
32 bCream		Lotpaste unten
33 tFinish		Veredelung oben
34 bFinish		Veredelung unten
35 tGlue		Klebemaske oben
36 bGlue		Klebemaske unten
37 tTest		Test- und Abgleichinformationen oben
38 bTest		Test- und Abgleichinformationen unten
39 tKeepout		Sperrflächen für Bauteile oben
40 bKeepout		Sperrflächen für Bauteile unten
41 tRestrict		Sperrflächen für Leiterbahnen oben
42 bRestrict		Sperrflächen für Leiterbahnen unten
43 vRestrict		Sperrflächen für Vias
44 Drills		Bohrungen, durchkontaktiert
45 Holes		Bohrungen, nicht durchkontaktiert
46 Milling		CNC-Fräser-Daten (geschlitzte Pads)
47 Measures		Bemaßungen
48 Document		allgemeine Dokumentation
49 Reference		Passermarken
51 tDocu		Bauteiledokumentation oben
52 bDocu		Bauteiledokumentation unten

91 Nets		Netze
92 Busses		Busse
93 Pins		Anschlusspunkte für Schaltplansymbole
		mit Zusatzinformationen
94 Symbols		Umrisse der Schaltplansymbole
95 Names		Namen bei Schaltplansymbolen
96 Values		Werte/Typenbezeichnung bei Schaltplansymbolen
97 Info		Allgemeine Informationen
98 Guide		Hilfslinien

Square		quadratisch
Round		rund
Octagon		achteckig
Long		länglich
Offset		länglich mit Versatz

`NOSTOP`		keine Lötstopmaske generieren
`NOTHERMALS`		keine Thermals generieren
`FIRST`		dies ist das "erste" Pad (und kann mit einer speziellen Form dargestellt werden)

NC		not connected
In		Eingang
Out		Ausgang (totem-pole)
IO		Ein-/Ausgang (bidirektional)
OC		Open Collector oder Open Drain
Hiz		High-Impedance(3-State)-Ausgang
Pas		passiv (für Widerstände, Kondensatoren etc.)
Pwr		Power-Pin (Vcc, Gnd, Vss ...), Stromversorgungs-Eingang
Sup		Stromversorgungs-Ausgang, z.B. Massesymbol.

None		keine spezielle Funktion
Dot		Invertier-Symbol
Clk		Taktsymbol
DotClk		Invertiertes Taktsymbol

Point		Pin wird ohne Linie und Beschriftung dargestellt
Short		Linie ist 0.1 Zoll lang
Middle		Linie ist 0.2 Zoll lang
Long		Linie ist 0.3 Zoll lang

R0		Pin-Symbol rechts
R90		Pin-Symbol oben
R180		Pin-Symbol links
R270		Pin-Symbol unten

Both		Pin- und Pad-Name sind im Schaltplan sichtbar
Pad		nur der Pad-Name ist im Schaltplan sichtbar
Pin		nur der Pin-Name ist im Schaltplan sichtbar
Off		weder Pin- noch Pad-Name im Schaltplan sichtbar

1. Outlines:		"Urzustand", also die Form in der sie vom Benutzer definiert worden sind (Umrisslinien)
2. Real mode:		"freigerechneter" Zustand, also die Form wie sie vom Programm berechnet wird.

`MIRROR`		spiegelt die Ausgabe
`ROTATE`		dreht die Ausgabe um 90°
`UPSIDEDOWN`		dreht die Ausgabe um 180°. Zusammen mit `ROTATE`, wird die Zeichnung um insgesamt 270° gedreht
`BLACK`		ignoriert die Farbeinstellungen der Layer und zeichnet alles in Schwarz
`SOLID`		ignoriert die Füllmuster der Layer und zeichnet alles voll ausgefüllt
`CAPTION`		druckt eine Bildunterschrift
`FILE`		leitet die Ausgabe in eine Datei um; der Dateiname muss unmittelbar nach dieser Option folgen
`PRINTER`		druckt auf einen bestimmten Drucker; der Druckername muss unmittelbar nach dieser Option folgen
`PAPER`		druckt auf das angegebene Papierformat; das Papierformat muss unmittelbar nach dieser Option folgen
`SHEETS`		druckt den angegebenen Bereich von Schaltplanseiten; der Bereich (von-bis) muss unmittelbar nach dieser Option folgen
`ALIGN`		druckt in einer gegebenen Anordnung; die Art der Anordnung muss unmittelbar nach dieser Option folgen
`WINDOW`		druckt den momentan sichtbaren Ausschnitt der Zeichnung
`PORTRAIT`		druckt in Hochformat
`LANDSCAPE`		druckt in Querformat
`HIERARCHY`		druckt die Schaltplanseiten von Modulen in ihrer hierarchischen Verwendung

`%E`		die Extension der geladenen Datei (ohne den `'.'`)
`%N`		der Name der geladenen Datei (ohne Pfad und Extension)
`%P`		Verzeichnis-Pfad der geladenen Datei (ohne Dateinamen)
`%%`		das Zeichen `'%'`