UL_FOOTPRINT

Datenelemente

area UL_AREA
Beschreibung Zeichenfolge
headline Zeichenfolge
Bibliothek Zeichenfolge
libraryurn Zeichenfolge (siehe Anmerkung)
libraryversion Ganzzahl (siehe Anmerkung)
locallymodified Ganzzahl (siehe Anmerkung)
librarylocallymodified Ganzzahl (siehe Anmerkung)
Benennen Zeichenfolge (PACKAGE_NAME_LENGTH)
urn Zeichenfolge (siehe Anmerkung)

Loop-Members

circles() UL_CIRCLE
contacts() UL_CONTACT
dimensions() UL_DIMENSION
frames() UL_FRAME
holes() UL_HOLE
polycutouts() UL_POLYCUTOUT
polyshapes() UL_POLYSHAPE (siehe Anmerkung)
rectangles() UL_RECTANGLE
texts() UL_TEXT (siehe Anmerkung)
wires() UL_WIRE (siehe Anmerkung)

Siehe auch UL_DEVICE, UL_ELEMENT, UL_LIBRARY, UL_PACKAGE3D.

Konstanten

PACKAGE_NAME_LENGTH Max. empfohlene Länge eines Package-Namens (nur in formatierter Ausgabe verwendet)

Anmerkung

Das UL_FOOTPRINT-Objekt ist neu in EAGLE 9.1. Für die Abwärtskompatibilität mit früheren EAGLE-Versionen steht UL_PACKAGE als Alias zur Verfügung.

Das description-Element gibt den gesamten beschreibenden Text zurück, der mit dem Befehl BESCHREIBUNG definiert wurde, während das headline-Element nur die erste Zeile der Beschreibung ohne HTML-Tags zurückgibt. Beachten Sie bei Verwendung des description-Texts, dass dieser möglicherweise Zeilenumbruchzeichen ('\n') enthält.

Wenn das UL_FOOTPRINT-Objekt von einem UL_ELEMENT-Objekt abgeleitet wird, durchläuft das texts()-Element nur die nicht abgetrennten Texte dieses Elements.

Wenn das UL_FOOTPRINT-Objekt aus einem UL_ELEMENT-Objekt abgeleitet wird, sind Polygonformen und Linien, die zu Kontakten mit beliebigen Pad-Formen gehören, über die polygons()- und wires()-Loop-Members dieses Kontakts verfügbar.

Das urn-Element enthält eine eindeutige Kennung für diesen Footprint (in der Form urn:adsk.eagle:footprint:123/4), wobei der Teil nach dem / die Version des Footprints ist. Um den Basis-URN (ohne Version) abzurufen, verwenden Sie urnbase(); um die Version abzurufen, verwenden Sie urnversion().

libraryurn und libraryversion sind nur dann anwendbar, wenn dieses UL_FOOTPRINT-Objekt aus einer verwalteten Bibliothek stammt. Wenn nicht, ist libraryurn die leere Zeichenfolge und libraryversion der Wert -1.

Das locallymodified-Element hat den Wert 0, wenn dieses UL_FOOTPRINT-Objekt keine lokalen Änderungen aufweist, oder 1, wenn das UL_FOOTPRINT-Objekt lokale Änderungen aufweist. Das librarylocallymodified-Element lautet 0 (wenn dieses UL_FOOTPRINT-Objekt nicht aus einer lokal modifizierten Bibliothek stammt) oder 1 (wenn dieses UL_FOOTPRINT-Objekt aus einer lokal modifizierten Bibliothek stammt).

Beispiel

library(L) {
  L.footprints(FPT) {
    printf("Footprint: %s\n", FPT.name);
    FPT.contacts(C) {
      if (C.pad)
         printf("\tPad: %s, (%f %f)\n",
                 C.name, u2mm(C.pad.x), u2mm(C.pad.y));
      else if (C.smd)
         printf("\tSmd: %s, (%f %f)\n",
                 C.name, u2mm(C.smd.x), u2mm(C.smd.y));
      }
    }
  }
board(B) {
  B.elements(E) {
    printf("Element: %s, Footprint: %s\n", E.name, E.footprint.name);
    }
  }