UL_ELEMENT

Membres de données

angle réel (0...359,9)
attribute[] chaîne (voir remarque)
colonne chaîne (voir remarque)
L'image est verrouillée. int (entier)
symétrie int (entier)
Nom chaîne (ELEMENT_NAME_LENGTH)
empreinte UL_FOOTPRINT (nouveau à partir d’EAGLE 9.1, voir remarque)
package3d UL_PACKAGE3D (voir remarque)
populate entier (0=ne pas remplir, 1=remplir)
ligne chaîne (voir remarque)
smashed entier (voir remarque)
spin int (entier)
valeur chaîne (ELEMENT_VALUE_LENGTH)
x, y entier (point d’origine)

Membres de boucle

attributes() UL_ATTRIBUTE
texts() UL_TEXT (voir remarque)

Voir aussi UL_BOARD, UL_CONTACTREF

Constantes

ELEMENT_NAME_LENGTH longueur maximale recommandée d’un nom d’élément (utilisée dans la sortie formatée uniquement)
ELEMENT_VALUE_LENGTH longueur maximale recommandée d’une valeur d’élément (utilisée dans la sortie formatée uniquement)

Remarques

Le membre de données attribute[] peut être utilisé pour interroger un objet UL_ELEMENT afin d’obtenir la valeur d’un attribut donné (voir le deuxième exemple ci-dessous). La chaîne renvoyée est vide s’il n’y a aucun attribut du nom spécifie ou si cet attribut est explicitement vide.

Le membre de boucle texts() parcourt uniquement les textes de l’élément qui ont été détachés à l’aide de la commande REPOSITION, ainsi que les textes visibles des attributs affectés à cet élément. Pour traiter tous les textes d’un élément (par exemple, lorsque vous le dessinez), vous devez parcourir le membre de boucle texts() de l’élément, ainsi que le membre de boucle texts() de l’encombrement de l’élément.

Notez que le membre footprint est nouveau dans EAGLE 9.1. Pour assurer la compatibilité avec les versions antérieures, le membre de données package est disponible sous forme d’alias.

Les objets UL_ELEMENT ne sont pas toujours dotés de packages 3D. Le membre de données package3d peut être utilisé comme booléen pour vérifier si un package 3D est présent, par exemple (E.package3d).

Le membre de données angle définit le degré de rotation de l’élément dans le sens trigonométrique autour de son origine.

Les membres de données column et row renvoient les numéros de colonne et de ligne correspondant à l’emplacement de l’élément dans le cadre, au sein du dessin de circuit imprimé. Si le dessin ne contient pas de cadre ou si l’élément est placé à l’extérieur du cadre, un point d’interrogation (caractère « ? ») est renvoyé.

Le membre de données smashed indique si l’élément est écrasé. Par ailleurs, pour déterminer s’il existe un paramètre de texte détaché, utilisez cette fonction en spécifiant le nom du paramètre entre crochets, par exemple smashed["VALUE"]. Cette fonction s’avère utile lorsque vous voulez sélectionner un tel texte à l’aide de la commande de déplacement, en exécutant MOVE R5>VALUE. Les noms de paramètres valides sont NAME et VALUE, ainsi que les noms des attributs définis par l’utilisateur. Ils ne sont pas sensibles à la casse et peuvent être précédés du caractère « > ».

Exemples

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"]);
    }
  }