UL_ELEMENT

Datenelemente

angle Reell (0.0...359.9)
attribute[] Zeichenfolge (siehe Anmerkung)
Spalte Zeichenfolge (siehe Anmerkung)
Das Bild ist gesperrt. int
Spiegeln int
Benennen Zeichenfolge (ELEMENT_NAME_LENGTH)
Grundriss UL_FOOTPRINT (neu ab EAGLE 9.1, siehe Anmerkung)
package3d UL_PACKAGE3D (siehe Anmerkung)
populate Ganzzahl (0=nicht auffüllen, 1=auffüllen)
Zeile Zeichenfolge (siehe Anmerkung)
smashed Ganzzahl (siehe Anmerkung)
spin int
value Zeichenfolge (ELEMENT_VALUE_LENGTH)
x, y Ganzzahl (Ursprungspunkt)

Loop-Members

attributes() UL_ATTRIBUTE
texts() UL_TEXT (siehe Anmerkung)

Siehe auch UL_BOARD, UL_CONTACTREF.

Konstanten

ELEMENT_NAME_LENGTH Max. empfohlene Länge eines Elementnamens (nur in formatierter Ausgabe verwendet)
ELEMENT_VALUE_LENGTH Max. empfohlene Länge eines Elementwerts (nur in formatierter Ausgabe verwendet)

Anmerkungen

Das attribute[]-Element kann verwendet werden, um eine UL_ELEMENT-Abfrage für den Wert eines bestimmten Attributs vorzunehmen (siehe zweites Beispiel unten). Die zurückgegebene Zeichenfolge ist leer, wenn kein Attribut mit dem angegebenen Namen vorhanden ist oder wenn dieses Attribut explizit leer ist.

Das texts()-Element durchläuft nur die Texte des Elements, die mithilfe von NEU POSITIONIEREN gelöst wurden, sowie die sichtbaren Texte aller Attribute, die diesem Element zugewiesen sind. Um alle Texte eines Elements (z. B. beim Zeichnen) zu verarbeiten, müssen Sie das eigene texts()-Element des Elements sowie das texts()-Element der Grundfläche des Elements durchlaufen.

Beachten Sie, dass das footprint-Element neu in EAGLE 9.1 ist. Für die Abwärtskompatibilität mit früheren Versionen steht package als Alias zur Verfügung.

Nicht alle UL_ELEMENT-Objekte verfügen über 3D-Packages. Das package3d-Element kann als boolesche Operation verwendet werden, um zu testen, ob ein 3D-Package vorhanden ist, z. B. (E.package3d).

angle definiert, um wie viel Grad das Element gegen den Uhrzeigersinn um seinen Ursprung gedreht wird.

Die column*- und *row-Elemente geben die Spalten- und Zeilenposition innerhalb des Rahmens in der Leiterplattenzeichnung zurück. Wenn sich in der Zeichnung kein Rahmen befindet oder das Element außerhalb des Rahmens platziert wird, wird ein '?' (Fragezeichen) zurückgegeben.

Das smashed-Element gibt an, ob das Element gelöst ist. Diese Funktion kann auch verwendet werden, um herauszufinden, ob ein abgetrennter text-Parameter vorhanden ist, indem der Name dieses Parameters in eckigen Klammern angegeben wird, z. B. smashed["VALUE"]. Dies ist nützlich, wenn Sie einen solchen Text mit dem Befehl VERSCHIEBEN unter Verwendung von MOVE R5>VALUE auswählen möchten. Gültige Parameternamen sind NAME und VALUE sowie die Namen aller benutzerdefinierten Attribute. Die Groß- und Kleinschreibung wird nicht beachtet, und das Zeichen '>' kann vorangestellt werden.

Beispiele

board(B) {
  B.elements(E) {
    printf("Element: %s, (%f %f), Footprint=%s\n",
           E.name, u2mm(E.x), u2mm(E.y), E.footprint.name);
    }
  }
board(B) {
  B.elements(E) {
    if (E.attribute["REMARK"])
       printf("%s: %s\n", E.name, E.attribute["REMARK"]);
    }
  }