UL_ELEMENT
Члени даних
| кут | реальний (0,0…359,9) |
| атрибут[] | рядок (див. примітку) |
| колонка | рядок (див. примітку) |
| заблокований | внутр |
| дзеркало | внутр |
| назва | рядок (ELEMENT_NAME_LENGTH) |
| слід | UL_FOOTPRINT (новий з EAGLE 9.1, див. примітку) |
| package3d | UL_PACKAGE3D (див. примітку) |
| заселяти | int (0=не заповнювати, 1=заповнювати) |
| рядок | рядок (див. примітку) |
| розбитий | int (див. примітку) |
| спина | внутр |
| значення | рядок (ELEMENT_VALUE_LENGTH) |
| x, y | int (точка початку) |
Члени циклу
| атрибути() | UL_ATTRIBUTE |
| тексти() | UL_TEXT (див. примітку) |
Дивіться також UL_BOARD, UL_CONTACTREF
Константи
| ELEMENT_NAME_LENGTH | макс. рекомендована довжина імені елемента (використовується лише у форматованому виведенні) |
| ELEMENT_VALUE_LENGTH | макс. рекомендована довжина значення елемента (використовується лише у форматованому виведенні |
Примітки
Член attribute[] може бути використаний для запиту UL_ELEMENT на значення даного атрибута (див. другий приклад нижче). Повернений рядок є порожнім, якщо немає атрибута з заданим іменем або якщо цей атрибут явно порожній.
Член texts() переглядає лише ті тексти елемента, які були від’єднані за допомогою REPOSITION, а також видимі тексти будь-яких атрибутів, призначених цьому елементу. Щоб обробити всі тексти елемента (наприклад, під час його малювання), ви повинні прокрутити власний елемент texts() елемента, а також член texts() сліду елемента.
Зауважте, що елемент сліду є новим у EAGLE 9.1. Для зворотної сумісності зі старішими версіями пакет доступний як псевдонім.
Не всі UL_ELEMENT мають пакети 3D. Член package3d можна використовувати як логічне значення для перевірки наявності 3D-пакета, наприклад if (E.package3d) .
кут визначає, на скільки градусів елемент повернуто проти годинникової стрілки навколо свого початку.
Елементи стовпців і рядків повертають розташування стовпців і рядків у рамці на кресленні дошки. Якщо на кресленні немає рамки або елемент розміщено поза рамкою, символ «?» (знак питання) повертається.
Розбитий елемент повідомляє, чи розбитий елемент. Цю функцію також можна використовувати, щоб дізнатися, чи є відокремлений текстовий параметр, вказавши назву цього параметра в квадратних дужках, наприклад, smashed["VALUE"] . Це корисно, якщо ви хочете виділити такий текст за допомогою команди MOVE, виконавши MOVE R5>VALUE . Дійсні імена параметрів: "NAME" і "VALUE", а також імена будь-яких визначених користувачем атрибутів. Вони розглядаються без урахування регістру, і їм може передувати символ «>».
Приклади
board ( B ) { B . elements ( E ) { printf ( "Element: %s, (%f %f), Footprint=%s
" , E . name , u2mm ( E . x ), u2mm ( E . y ), E . footprint . name );
}
} board ( B ) { B . elements ( E ) {
if ( E . attribute [ "REMARK" ]) printf ( "%s: %s
" , E . name , E . attribute [ "REMARK" ]);
}
}
Орігінал сторінки: UL_ELEMENT