Scripting Examples Reference

IniFileEg

Этот скрипт демонстрирует использование объекта TIniFile и методов Read/Write.

Mandelbrot

Этот скрипт демонстрирует использование графики для построения множества Мандельброта на форме скрипта.

MM

Этот скрипт демонстрирует использование компонента TMediaPlayer. Для этого скрипта MM требуется файл Protel.avi.

ShowModalEg

Этот скрипт демонстрирует использование свойства ShowModal для формы скрипта.

SineWave

Этот скрипт демонстрирует, как сгенерировать и построить синусоиду на форме скрипта.

TextFileConvert

Файл input.txt предоставлен в демонстрационных целях.

TicTac

Игра «Крестики‑нолики».

UpdateTime

Этот скрипт демонстрирует использование компонента TTimer и функции Time.

HelloWorldDialog

Простое сообщение «hello world» с использованием формы скрипта.

HelloWorld

Простой «hello world» — введение в язык DelphiScript.

ZipperForm

Этот скрипт использует API архивации (zipping), доступный в движке скриптинга. Этот проект упаковывает в архив проект Design и связанные с ним файлы.

ClientServerInterfacesReport

Этот скрипт демонстрирует, как использовать интерфейсы Client, и извлекает информацию об установочных файлах серверов, типах окон, командах и панелях.

ExtractFilesFromIntLibs

Этот скрипт демонстрирует, как извлекать исходные файлы библиотек из файлов интегрированных библиотек с расширением INTLIB.

IntLibSearchDemo

Этот скрипт демонстрирует, как находить посадочные места и 3D‑модели в файлах интегрированных библиотек и в файлах PCBLIB.

OpenADoc

Этот скрипт демонстрирует, как открыть текстовый документ с помощью метода OpenDocument клиента (Client).

ReportIntLibData

Этот скрипт демонстрирует использование интерфейсов Integrated Library Manager и Model Type Manager для извлечения данных, связанных с каждым интерфейсом.

ReportPCBViews

Этот скрипт формирует отчёт обо всех открытых документах PCB и их представлениях (views) в X2.

ServerProcessReport

Этот скрипт демонстрирует, как сформировать отчёт по процессам всех установленных серверов в X2.

SettingDocumentDirty

Этот скрипт демонстрирует, как пометить документ как изменённый (dirty), чтобы он был сохранён при вызове команды Save.

DXPVersionUnit

Этот скрипт демонстрирует, как определить номер версии приложения X2.

Count_Connection_Lines

Этот скрипт демонстрирует, как подсчитать линии соединений (неразведённые дорожки) в документе PCB и вывести результаты на панели Messages.

CreateAVia

Этот скрипт демонстрирует, как создать новый объект Via в документе PCB.

CreateComponentOnPCB

Этот скрипт демонстрирует, как создать новый компонент в документе PCB.

CreateFootprintInLibrary

Этот скрипт демонстрирует, как создать новое посадочное место (footprint) в документе библиотеки.

CreatePCBObjects

Этот скрипт содержит различные функции для создания разных объектов PCB в документе PCB. Скрипт использует метод SendMessageToRobots для отправки сообщений PCB.

CreateRules

Этот скрипт демонстрирует, как создать два разных правила: правило максимальной/минимальной ширины и правило определения комнаты (room definition rule, ограничение confinement constraint).

Cycle_Pcb_Cursor_Type

Этот скрипт циклически переключает доступные типы курсора в документе PCB.

DeletePCBObjects

Этот скрипт демонстрирует, как удалять объекты PCB и корректно обновлять систему Undo.

EmbeddedObjects

Этот скрипт демонстрирует использование встроенных объектов: создаёт и извлекает эти встроенные объекты в текущем документе PCB.

NetObjectAssign

Этот скрипт демонстрирует, как назначить свойство цепи (net) новому объекту, размещённому в документе PCB.

PadViaCacheProperties

Этот скрипт демонстрирует использование записи TPadCache и метода GetObjectAtCursor для объектов Pad и Via. Перед запуском скрипта загрузите PadViaExamples.PcbDoc из папки \DelphiScript Scripts\PCB.

PadStackInfo

Этот скрипт демонстрирует, как получить различную информацию о стеке площадки (pad stack) в документе PCB.

QueryBoard

Этот скрипт запрашивает у текущего документа PCB информацию о настройках платы.

Undo

Этот скрипт демонстрирует систему Undo в PCB. Две процедуры показывают, как работает Undo: как одно большое Undo или как несколько меньших Undo.

CopyBoardOutlineForm

Этот скрипт копирует контур платы в виде дорожек и дуг на указанный слой. Перед продолжением пользователь должен задать значения Layer и Width.

ConvertPicture

Главная форма для скрипта.

ConstructContourSetFromPicture

Скрипт, который занимается созданием набора контуров из загруженного растрового изображения (bitmap).

ConstructRegionsFromContourSet

Скрипт, который занимается созданием регионов из каждого набора контуров.

FindFootprintUnit

Поиск посадочного места в библиотеке PCB с использованием PCB API.

CreateInterComponentFromTos

Скрипт предлагает пользователю выбрать два компонента, после чего соединяет площадки с одинаковыми назначениями цепей (net). Ограничения этого скрипта: чтобы выйти, нужно увести курсор от компонента. После выполнения скрипта все цепи необходимо перестроить вручную.

formFormTos

Форма скрипта для этого проекта.

HSForm

Это диалоговое окно Specific Hole Size Editor для изменения одного из размеров отверстий.

HSEditForm

Это основной скрипт для редактора размеров отверстий (Hole Size editor).

Customsort

Этот скрипт customsort содержит процедуры сортировки для скрипта Hole Size Editor.

MillExporter

Файл проекта. Экспортирует проект PCB в формат, который может быть обработан на фрезерном станке с ЧПУ. В настоящее время поддерживается только язык фрезерования Roland RML.

MillExporter

Этот модуль преобразует контур платы (Board Outline) документа PCB в полигон, чтобы можно было сгенерировать данные для документа PCB и выполнить фрезерование на станке с ЧПУ.

MMExportDlg

Этот модуль управляет настройками экспорта документа PCB для обработки на фрезерном станке.

MMSetup

Задаёт значения по умолчанию для фрезерного станка, которые будут использоваться MillExporter, в текстовом INI‑файле.

PCB_Class_Generator.PrjScr

Файл проекта PCB Class Generator.

PCB_Class_Generator_Form.dfm

Эта форма скрипта связана со скриптом PCB_Class_Generator_Form.

PCB_Class_Generator_Form.pas

Этот скрипт добавляет цепи (nets) выбранных объектов PCB в класс цепей (net class) и имеет соответствующую форму скрипта.

Count_pads

Этот скрипт подсчитывает количество площадок (pads) в текущем документе PCB.

CountTracksInComponent

Этот скрипт подсчитывает дорожки (tracks) у пяти разных компонентов в текущем документе PCB.

IterateComponentBodies

Этот скрипт извлекает тела компонентов (component bodies) из текущего документа PCB.

IterateNets

Этот скрипт демонстрирует, как выполнять итерацию по цепям (Nets) текущего документа PCB.

IteratePolygons

Этот скрипт выполняет итерацию по полигонам (Polygons) текущего документа PCB.

IterateRegions

Этот скрипт выполняет итерацию по регионам (regions) текущего документа PCB.

LibraryIterator

Этот скрипт демонстрирует использование итератора библиотеки и отображает количество дочерних объектов (примитивов посадочного места) для каждого посадочного места, найденного в библиотеке PCB.

SpatialIterator

Этот скрипт демонстрирует использование метода ChooseRectangleByCorners и пространственного итератора. Выбирает только свободные примитивы на PCB, находящейся в фокусе.

Layers_Info

Этот скрипт извлекает информацию о слоях для стека слоёв PCB.

QueryLayerPairs

Этот скрипт запрашивает у текущего документа PCB пары слоёв PCB.

QueryLayersOfMechType

Этот скрипт запрашивает у текущего документа PCB механические слои.

QueryLayerStack

Этот скрипт запрашивает стек слоёв (Layer Stack) текущего документа PCB.

QueryMechLayers

Этот скрипт запрашивает механические слои текущего документа PCB.

QueryUsedLayers

Этот скрипт запрашивает у текущего документа PCB слои, которые используются.

RebuildInternalAndSplitPlanes

Этот скрипт принудительно выполняет перестроение внутренних слоёв питания (internal planes) и разделённых плоскостей (split planes) для PCB.

Toggle_Connect_layer_display

Этот скрипт переключает видимость слоя connect на текущей PCB.

ValidateLayerStack

Этот скрипт проверяет стек слоёв и выдаёт предупреждение, если стек некорректен.

Converter

Форма скрипта в виде диалога, который предлагает пользователю загрузить монохромное изображение, а затем выбрать толщину дорожек, нужно ли зеркалировать и т. д.

OffSetObjectsForm

Форма для проекта.

OffSetObjects

Демонстрирует использование метода ChooseRectangleByCorners и пространственного итератора. Перемещает объекты в пределах заданной границы на плате.

PCBOutputGenerator

Этот модуль выполняет следующее:

1. LookForFiducials.
2. Проверка размеров контура платы.
3. Генерация выходных данных (PickPlace и BOM).

Violations

Извлекает существующие объекты нарушений и формирует отчёт с описанием различных нарушений.

GetObjectClasses

Форма скрипта отчёта по классам объектов. Перед генерацией списка классов объектов определённого типа в виде текстового файла вы выбираете нужный класс объектов.

IterateRules

Этот скрипт извлекает существующие правила для текущей PCB и формирует текстовый отчёт об используемых правилах, их ID и названиях.

ModifyWidthRules

Этот скрипт изменяет существующие ограничения ширины (Width Constraints), у которых Min, Favored и Max Width меньше 20 mil, и обновляет их до 10 mil.

FootprintInfoReport

Этот скрипт формирует отчёт в формате CSV по всем футпринтам с их именами, высотами и описаниями.

SwapComponentsUnit

Меняет местами два похожих компонента или поворачивает компонент.
Скрипт просит пользователя выбрать два компонента, после чего меняет их позиции местами; либо, если один и тот же компонент выбран дважды, поворачивает его.
Ограничения этого скрипта: чтобы выйти, нужно отвести курсор от компонента.

Common

Общие процедуры для использования в проекте.

ObjectChecker

Проверяет наличие дублирующихся цепей (Nets) и компонентов в текущем документе PCB.

Form_ChooseNetClass

Эта форма скрипта предлагает выбрать класс цепей (net class), чтобы объекты, принадлежащие этому классу, можно было «развести обратно» (unroute).

ValuesCheckerUnit

Этот скрипт проверяет, содержат ли объекты в документе PCB корректные значения, перед генерацией выходных данных для загрузки в CAM Editor.

PCBAPI functions

Модуль скрипта, содержащий функции, используемые диалогом Values Checker.

AddModelToComponentScript

Этот скрипт демонстрирует, как добавить модель симуляции к компоненту 555. Это делается путём добавления файла 555.ckt к этому компоненту.

CountPorts

Этот скрипт использует итератор для подсчёта портов.

CreateComponent_on_Sch

Этот скрипт демонстрирует, как разместить компонент на документе схемы.

CreateSchObjects

Этот скрипт создаёт объекты схемы двумя способами;

1. первая процедура размещает два порта, и одной отменой (undo) удаляются оба
2. вторая процедура размещает два порта, и для удаления обоих нужны две отмены (undo).

Этот скрипт использует интерфейс RobotManager для отправки сообщений схемы.

DeleteSchObjects

Скрипт демонстрирует, как удалять объекты схемы и обновлять систему Undo, используя интерфейс RobotManager для отправки сообщений схемы.

FetchParameters

Этот скрипт содержит две процедуры. Первая извлекает системные параметры (параметры документа), а вторая показывает, как извлекать параметры компонента.

IterateSchSheets

Этот скрипт показывает, как получить дескрипторы (handles) открытых листов схемы в Altium Designer.

ModelsOfaComponent

Этот скрипт получает модели для каждого компонента на документе схемы и формирует отчёт со списком компонентов и связанных (linked) с ними моделей.

ModifySchObjects

Этот скрипт показывает, как извлекать и изменять объекты схемы и обновлять систему Undo, используя интерфейс RobotManager для отправки сообщений схемы.

MoveParameters

Этот скрипт показывает, как графически перемещать параметры родительского объекта, например компонента, используя свойство Location и его методы get/set.

ParentChild_Iterators

Этот скрипт использует итератор для поиска sheet symbol, а затем внутри каждого sheet symbol использует его итератор для поиска sheet entry.

PlaceAPort

Этот простой скрипт показывает, как разместить новый объект порта на листе схемы.

PlaceSchObjects

Этот простой скрипт размещает различные объекты на листе схемы.

ReplaceSchObjects

Этот скрипт заменяет межлистовые соединители (cross sheet connectors) объектами портов и автоматически переносит информацию о цепях (net).

SchDocsRenamer

Этот скрипт использует функцию FileCopy из модуля Delphi Windows для копирования существующих файлов с другими именами.

SimModelsOfComponents

Этот скрипт извлекает модели симуляции и соответствующие параметры для каждого компонента, а затем формирует текстовый отчёт по этим моделям и параметрам.

UndoRedo

Этот скрипт демонстрирует, как использовать систему Undo при изменении документа схемы.

UsingaSpatialIterator

Этот скрипт демонстрирует использование пространственного итератора для поиска в пределах заданной области.

UsingSchInterfaces

Этот скрипт демонстрирует интерфейсы схемы (Schematic interfaces).

UsingWSMInterfaces

Этот скрипт демонстрирует интерфейсы WorkSpace Manager.

CheckPins

Этот скрипт проверяет корректность выводов (pins) символов в библиотеке.

CreateComp_in_Lib

Этот скрипт демонстрирует, как создать новый символ в библиотеке.

CompLibReader

Этот скрипт использует метод CreateLibCompInfoReader для извлечения данных компонентов из указанной библиотеки схем.

LibIterator

Этот скрипт показывает, как пройти итератором по библиотеке схем и получить символы.

ParametersOfSymbolsInALibrary

Этот скрипт показывает, как извлекать параметры символов в библиотеке схем с помощью итератора.

SymbolPrimsIterator

Этот скрипт показывает, как извлекать примитивы символа.

StringUtils

Этот модуль работает с типами данных.

DesignSettings

Этот модуль занимается чтением таблицы Settings для данных CirCad.

Log

Этот модуль занимается формированием лог-файла с результатами.

ImportUtils

Этот модуль занимается преобразованием данных CirCad для Altium Designer.

InputForm

Этот модуль относится к диалогу транслятора.

Test

Этот автономный модуль предназначен для тестирования данных CirCad.

ReplaceSelectedComponent

Заменяет выбранный компонент на схеме на символ 2N3904 из библиотеки Miscellaneous Devices.IntLib.

Connectivity

Этот модуль генерирует параметры с информацией Pin Net Info для выводов компонентов из активной схемы или выбранных схем PCB-проекта.

DefnForm

Форма скрипта для обработки пользовательского ввода.

FontsDialog

Этот скрипт демонстрирует использование интерфейса Schematic Font Manager.

ImportPinsForm

ImportPinsForm — это главная форма. Нужен файл CSV с данными выводов для импорта и создания новых выводов (Pins) в документе SchLib .
Чтобы использовать скрипт:

1. Выполните процедуру ImportPins, и появится диалог Pins Importer.
2. Нажмите кнопку обзора (browse), чтобы загрузить файл CSV с данными выводов схемы.
3. Нажмите кнопку Update Mapping, чтобы обновить связи между текстовыми полями и свойствами выводов, затем нажмите кнопку Import , чтобы сформировать список различных выводов на странице библиотеки Sch.

ChangeMappingForm

Диалог Change Mapping для сопоставления полей из текстового файла CSV. Этот скрипт используется основным диалогом Import Pin.

ConvUtils

Этот скрипт содержит процедуры Conversion of Schematic Types To Strings и Vice Versa.

PinData.CSV

Этот файл содержит информацию о выводах, используемую скриптом ImportPins.

UpdateFootprintPathsOfComps

Компонент на схеме имеет свойство Footprint (PCB Model) и свойство Library Path. Бывают ситуации, когда компоненты имеют одинаковое имя футпринта, но происходят из разных библиотек.
Этот скрипт позволяет выбрать имя футпринта из текущей открытой схемы, а затем выбрать одно из доступных расположений (locations) футпринта. Эти расположения основаны на существующих расположениях футпринтов компонентов. Затем, после закрытия диалога, у всех компонентов с тем же именем футпринта расположение обновляется на указанное.
Убедитесь, что у вас установлены библиотеки для компонентов схемы, чтобы могли отображаться расположения (пути) библиотек футпринтов.

ComponentParameters

Этот скрипт демонстрирует, как создавать, изменять и удалять пользовательские параметры для компонентов в схемных проектах иерархического проекта.

Clrins1

Этот скрипт демонстрирует, как удалять объекты в области, заданной пользователем.

Clrins2

Этот скрипт демонстрирует, как удалять объекты в области, заданной пользователем. Перед очисткой объектов пользователю выводится запрос.

CirWiz

Эта форма скрипта генерирует простую фильтрующую схему и размещает её на листе схемы.

PCBColor

Этот скрипт демонстрирует, как изменять цвета PCB-документа с помощью процесса SetupPreferences.

PCBLayer

Этот скрипт демонстрирует, как переключать видимость слоёв PCB с помощью процесса DocumentPreference.

PlacePCBPolygon

Этот скрипт размещает новый объект полигона PCB в документе PCB с помощью процесса PlacePolygonPlane.

PlaceSchPort

Этот скрипт размещает новый объект Schematic Port на схематическом документе, используя процесс PlacePort.

PublishToPDFScript

Этот скрипт выполняет публикацию из документа OutJob текущего проекта в PDF и обходит диалог Publish to PDF Settings.

QuikCopy

Этот скрипт демонстрирует, как выбирать объекты, а затем копировать и вставлять их с использованием процессов ToggleSelection, Deselect, Paste и Copy.

RunCommonDialog

Этот скрипт демонстрирует, как вызвать диалог Common модуля Client и получить параметры.

ShowNetlist

Этот скрипт демонстрирует, насколько просто сформировать отчёт с использованием процесса GenerateReport WorkspaceManager.

SimpleExample

Этот скрипт демонстрирует использование функций AddIntegerParameter и GetIntegerParameter.

AddDocToProject

Этот скрипт демонстрирует, как вставить лист схемы в новый PCB Project. Сначала в папке C:\ должен находиться файл sheet1.schdoc.

Netlister

Этот скрипт демонстрирует, как сформировать файл заданного формата PackingList для проекта схемы.

ProjectReporter

Этот скрипт находит текущие открытые проекты, включая Free projects в X2. Free project — это группа документов, не относящихся ни к одному проекту.

UsingMessagePanel

Этот скрипт демонстрирует, как вставлять текстовые сообщения в панель Messages в Altium Designer. Это полезный инструмент для отладки.

ScripterProtelNetlist

Этот скрипт демонстрирует использование интерфейсов WorkSpace Manager для генерации нетлиста типа Protel. Файл нетлиста создаётся в папке Generated для текущего проекта на панели Projects.
Чтобы запустить этот скрипт, необходимо открыть проект ScripterProtelNetlist.PRJSCR, затем вызвать команду Run script из меню File и выбрать файл ScripterProtelNetlist.pas в диалоге Select Item to Run.
После этого скрипт сгенерирует нетлист для текущего проекта, поэтому перед запуском убедитесь, что проект находится в фокусе.

AddDocToProject

Этот скрипт демонстрирует, как вставить лист в PCB Project. Сначала в папке C:\ должен находиться файл sheet1.schdoc.

BuiltInFunctions

Этот скрипт демонстрирует, как использовать встроенные объекты даты и математики и отображать результаты с помощью функции ShowMessage.

CopyBoardOutlineForm

Этот скрипт копирует контур платы в виде дорожек и дуг на указанный слой.

GetScriptEngineInfo

Получает номер версии Microsoft Scripting Engine.

HelloWorld

Простой «hello world» — введение в язык JScript.

ParentChild_Iterators

Этот скрипт использует итератор для поиска символов листов, а затем внутри каждого символа листа — итератор символа листа для поиска sheet entries.

ServerProcessReport

Этот скрипт демонстрирует, как сформировать отчёт по процессам всех установленных серверов в Altium Designer.

SineWave

Этот скрипт демонстрирует, как построить синусоиду в форме скрипта.

ViaCreation

Этот скрипт демонстрирует, как создать новый объект Via на PCB.

AddDocToProject

Этот скрипт демонстрирует, как вставить лист схемы в новый PCB Project. Сначала в папке C:\ должен находиться файл sheet1.schdoc.

CopyBoardOutline

Этот скрипт копирует контур платы в виде дорожек и дуг на указанный слой. Значения Layer и Width должны быть заданы пользователем перед продолжением. Использует объектную модель PCB.

GetScriptEngineInfo

Получает номер версии Microsoft Scripting Engine.

HelloWorld

Простой «hello world» — введение в язык VBScript.

ParentChild_Iterators

Этот скрипт использует итератор для поиска символов листов, а затем внутри каждого символа листа — итератор символа листа для поиска sheet entries. Использует объектную модель схемы.

ServerProcessReport

Этот скрипт демонстрирует, как сформировать отчёт по процессам всех установленных серверов в Altium Designer.

SineWave

Этот скрипт демонстрирует, как сгенерировать и построить синусоиду в форме скрипта. Использует Components и форму скрипта.

ViaCreation

Этот скрипт демонстрирует, как создать новый объект Via на PCB-документе. Использует объектную модель PCB.