Scripting Examples Reference

IniFileEg

Ten skrypt demonstruje użycie obiektu TIniFile oraz metod odczytu i zapisu.

Mandelbrot

Ten skrypt demonstruje wykorzystanie grafiki do utworzenia zbioru Mandelbrota na formularzu skryptowym.

MM

Ten skrypt demonstruje użycie komponentu TMediaPlayer. Do działania skryptu MM wymagany jest plik Protel.avi.

ShowModalEg

Ten skrypt demonstruje użycie właściwości ShowModal formularza skryptowego.

SineWave

Ten skrypt demonstruje generowanie i rysowanie sinusoidy na formularzu skryptowym.

TextFileConvert

Plik input.txt jest udostępniony do celów demonstracyjnych.

TicTac

Gra w kółko i krzyżyk.

UpdateTime

Ten skrypt demonstruje użycie komponentu TTimer oraz funkcji Time.

HelloWorldDialog

Prosty komunikat „Witaj, świecie!” wyświetlany za pomocą formularza skryptowego.

HelloWorld

Prosty przykład „Witaj, świecie!” — wprowadzenie do języka DelphiScript.

ZipperForm

Ten skrypt korzysta z API kompresji ZIP udostępnionego w silniku skryptowym. Projekt ten kompresuje projekt projektowy i powiązane z nim pliki do archiwum ZIP.

ClientServerInterfacesReport

Ten skrypt demonstruje korzystanie z interfejsów Client i pobiera informacje o plikach instalacyjnych serwerów, typach okien, poleceniach i panelach.

ExtractFilesFromIntLibs

Ten skrypt demonstruje wyodrębnianie źródłowych plików bibliotek z plików bibliotek zintegrowanych o rozszerzeniu INTLIB.

IntLibSearchDemo

Ten skrypt demonstruje wyszukiwanie footprintów i modeli 3D w plikach bibliotek zintegrowanych oraz w plikach PCBLIB.

OpenADoc

Ten skrypt demonstruje otwieranie dokumentu tekstowego za pomocą metody OpenDocument interfejsu Client.

ReportIntLibData

Ten skrypt demonstruje użycie interfejsów Integrated Library Manager i Model Type Manager do wyodrębniania danych powiązanych z każdym z nich.

ReportPCBViews

Ten skrypt raportuje wszystkie otwarte dokumenty PCB i ich widoki w X2.

ServerProcessReport

Ten skrypt demonstruje generowanie raportu dotyczącego procesów wszystkich zainstalowanych serwerów w X2.

SettingDocumentDirty

Ten skrypt demonstruje oznaczanie dokumentu jako zmodyfikowanego, aby został zapisany po wywołaniu polecenia Zapisz.

DXPVersionUnit

Ten skrypt demonstruje ustalanie numeru wersji aplikacji X2.

Count_Connection_Lines

Ten skrypt demonstruje zliczanie linii połączeń (niepoprowadzonych ścieżek) w dokumencie PCB i wyświetla wyniki w panelu Messages.

CreateAVia

Ten skrypt demonstruje tworzenie nowego obiektu przelotki w dokumencie PCB.

CreateComponentOnPCB

Ten skrypt demonstruje tworzenie nowego komponentu w dokumencie PCB.

CreateFootprintInLibrary

Ten skrypt demonstruje tworzenie nowego footprintu w dokumencie biblioteki.

CreatePCBObjects

Ten skrypt zawiera różne funkcje do tworzenia rozmaitych obiektów PCB w dokumencie PCB. Do wysyłania komunikatów PCB wykorzystuje metodę SendMessageToRobots.

CreateRules

Ten skrypt demonstruje tworzenie dwóch różnych reguł — reguły maksymalnej i minimalnej szerokości oraz reguły definicji obszaru Room (ograniczenia umieszczenia).

Cycle_Pcb_Cursor_Type

Ten skrypt przełącza kolejno dostępne typy kursora w dokumencie PCB.

DeletePCBObjects

Ten skrypt demonstruje usuwanie obiektów PCB i prawidłowe aktualizowanie systemu cofania.

EmbeddedObjects

Ten skrypt demonstruje użycie obiektów osadzonych, czyli ich tworzenie i pobieranie w bieżącym dokumencie PCB.

NetObjectAssign

Ten skrypt demonstruje przypisywanie właściwości sieci do nowego obiektu umieszczonego w dokumencie PCB.

PadViaCacheProperties

Ten skrypt demonstruje użycie rekordu TPadCache oraz metody GetObjectAtCursor dla obiektów pól lutowniczych i przelotek. Przed uruchomieniem skryptu wczytaj PadViaExamples.PcbDoc z folderu \DelphiScript Scripts\PCB.

PadStackInfo

Ten skrypt demonstruje pobieranie różnych informacji o stosie pola lutowniczego w dokumencie PCB.

QueryBoard

Ten skrypt odpytuje bieżący dokument PCB o informacje dotyczące ustawień płytki.

Undo

Ten skrypt demonstruje system cofania PCB. Dwie procedury pokazują działanie tego systemu — jako jednej dużej operacji cofania lub wielu mniejszych.

CopyBoardOutlineForm

Ten skrypt kopiuje obrys płytki w postaci ścieżek i łuków na wskazaną warstwę. Przed kontynuowaniem użytkownik musi określić warstwę i szerokość.

ConvertPicture

Główny formularz skryptu.

ConstructContourSetFromPicture

Skrypt służący do tworzenia zestawu konturów z wczytanej bitmapy.

ConstructRegionsFromContourSet

Skrypt służący do tworzenia regionów z każdego zestawu konturów.

FindFootprintUnit

Wyszukiwanie footprintu w bibliotece PCB za pomocą API PCB.

CreateInterComponentFromTos

Skrypt prosi użytkownika o wybranie dwóch komponentów, a następnie łączy pola lutownicze przypisane do tych samych sieci. Ograniczenia skryptu: aby zakończyć, należy odsunąć kursor od komponentu. Po uruchomieniu skryptu wszystkie sieci trzeba przebudować ręcznie.

formFormTos

Formularz skryptowy tego projektu.

HSForm

Okno dialogowe edytora określonego rozmiaru otworu, służące do zmiany jednego z rozmiarów otworów.

HSEditForm

Główny skrypt edytora rozmiarów otworów.

Customsort

Ten skrypt customsort zawiera procedury sortowania dla skryptu Hole Size Editor.

MillExporter

Plik projektu. Eksportuje projekt PCB do formatu, który można wykorzystać do obróbki na frezarce CNC. Obecnie obsługiwany jest tylko język frezowania Roland RML.

MillExporter

Ten moduł przekształca obrys płytki w dokumencie PCB w wielokąt, aby można było wygenerować dane dla dokumentu PCB i wykonać płytkę na frezarce CNC.

MMExportDlg

Ten moduł steruje ustawieniami eksportu dokumentu PCB na potrzeby obróbki na frezarce.

MMSetup

Ustawia w pliku tekstowym INI domyślne wartości parametrów frezarki używanej przez MillExporter.

PCB_Class_Generator.PrjScr

Plik projektu generatora klas PCB.

PCB_Class_Generator_Form.dfm

Ten formularz skryptu jest powiązany ze skryptem PCB_Class_Generator_Form.

PCB_Class_Generator_Form.pas

Ten skrypt dodaje sieci wybranych obiektów PCB do klasy sieci i ma odpowiadający mu formularz.

Count_pads

Ten skrypt zlicza pola lutownicze w bieżącym dokumencie PCB.

CountTracksInComponent

Ten skrypt zlicza ścieżki pięciu różnych komponentów w bieżącym dokumencie PCB.

IterateComponentBodies

Ten skrypt pobiera bryły komponentów z bieżącego dokumentu PCB.

IterateNets

Ten skrypt pokazuje, jak iterować po sieciach bieżącego dokumentu PCB.

IteratePolygons

Ten skrypt iteruje po poligonach bieżącego dokumentu PCB.

IterateRegions

Ten skrypt iteruje po regionach bieżącego dokumentu PCB.

LibraryIterator

Ten skrypt demonstruje użycie iteratora biblioteki i wyświetla liczbę obiektów podrzędnych (prymitywów footprintu) dla każdego footprintu znalezionego w bibliotece PCB.

SpatialIterator

Ten skrypt demonstruje użycie metody ChooseRectangleByCorners i iteratora przestrzennego. Zaznacza tylko niezależne prymitywy na aktywnej płytce PCB.

Layers_Info

Ten skrypt pobiera informacje o warstwach ze stosu warstw PCB.

QueryLayerPairs

Ten skrypt wyszukuje pary warstw PCB w bieżącym dokumencie PCB.

QueryLayersOfMechType

Ten skrypt wyszukuje warstwy mechaniczne w bieżącym dokumencie PCB.

QueryLayerStack

Ten skrypt pobiera informacje o stosie warstw bieżącego dokumentu PCB.

QueryMechLayers

Ten skrypt wyszukuje warstwy mechaniczne bieżącego dokumentu PCB.

QueryUsedLayers

Ten skrypt wyszukuje używane warstwy w bieżącym dokumencie PCB.

RebuildInternalAndSplitPlanes

Ten skrypt wymusza przebudowę wewnętrznych i dzielonych płaszczyzn zasilania PCB.

Toggle_Connect_layer_display

Ten skrypt przełącza widoczność warstwy połączeń na bieżącej płytce PCB.

ValidateLayerStack

Ten skrypt sprawdza poprawność stosu warstw i zgłasza ostrzeżenie, jeśli stos jest nieprawidłowy.

Converter

Formularz skryptu w postaci okna dialogowego, które prosi użytkownika o wczytanie obrazu monochromatycznego, a następnie wybranie szerokości ścieżek, zastosowania odbicia lustrzanego itp.

OffSetObjectsForm

Formularz projektu.

OffSetObjects

Demonstruje użycie metody ChooseRectangleByCorners i iteratora przestrzennego. Przesuwa obiekty znajdujące się w określonym obszarze na płytce PCB.

PCBOutputGenerator

Ten moduł wykonuje następujące czynności:

1. Wyszukuje znaczniki referencyjne.
2. Sprawdza wymiary obrysu płytki.
3. Generuje dane wyjściowe (PickPlace i BOM).

Violations

Pobiera istniejące obiekty naruszeń i generuje raport przedstawiający różne naruszenia.

GetObjectClasses

Formularz skryptu raportowania klas obiektów. Umożliwia wybór klasy obiektów przed wygenerowaniem listy klas obiektów określonego rodzaju w postaci pliku tekstowego.

IterateRules

Ten skrypt pobiera istniejące reguły dla bieżącej płytki PCB i generuje raport tekstowy dotyczący używanych reguł, ich identyfikatorów i nazw.

ModifyWidthRules

Ten skrypt modyfikuje istniejące ograniczenia szerokości, których minimalna, preferowana i maksymalna szerokość są mniejsze niż 20 mils, ustawiając je na 10 mils.

FootprintInfoReport

Ten skrypt generuje raport w formacie CSV obejmujący wszystkie footprinty wraz z ich nazwami, wysokościami i opisami.

SwapComponentsUnit

Zamienia miejscami dwa podobne komponenty lub obraca komponent.
Skrypt prosi użytkownika o wybranie dwóch komponentów, a następnie zamienia je miejscami. Jeśli ten sam komponent zostanie wybrany dwukrotnie, zostanie obrócony.
Ograniczenia tego skryptu: aby zakończyć działanie, należy odsunąć kursor od komponentu.

Common

Wspólne procedury do wykorzystania w projekcie.

ObjectChecker

Sprawdza, czy w bieżącym dokumencie PCB występują zduplikowane sieci i komponenty.

Form_ChooseNetClass

Ten formularz skryptu prosi o wybranie klasy sieci, aby można było usunąć trasowanie obiektów należących do tej klasy.

ValuesCheckerUnit

Ten skrypt sprawdza, czy obiekty w dokumencie PCB zawierają prawidłowe wartości, przed wygenerowaniem danych wyjściowych do wczytania w edytorze CAM.

Funkcje PCBAPI

Moduł skryptu zawierający funkcje używane w oknie dialogowym narzędzia do sprawdzania wartości.

AddModelToComponentScript

Ten skrypt demonstruje, jak dodać model symulacyjny do komponentu 555. Odbywa się to przez dodanie pliku 555.ckt do tego komponentu.

CountPorts

Ten skrypt używa iteratora do zliczania portów.

CreateComponent_on_Sch

Ten skrypt demonstruje, jak umieścić komponent w dokumencie schematu.

CreateSchObjects

Ten skrypt tworzy obiekty schematu na dwa sposoby:

1. pierwsza procedura umieszcza dwa porty, a pojedyncze cofnięcie usuwa oba
2. druga procedura umieszcza dwa porty, a usunięcie obu wymaga dwukrotnego cofnięcia.

Ten skrypt używa interfejsu RobotManager do wysyłania komunikatów schematu.

DeleteSchObjects

Ten skrypt demonstruje, jak usuwać obiekty schematu i aktualizować system cofania przy użyciu interfejsu RobotManager do wysyłania komunikatów schematu.

FetchParameters

Ten skrypt zawiera dwie procedury. Pierwsza pobiera parametry systemowe (parametry dokumentu), a druga pokazuje, jak pobrać parametry komponentu.

IterateSchSheets

Ten skrypt pokazuje, jak pobierać uchwyty otwartych arkuszy schematu w Altium Designer.

ModelsOfaComponent

Ten skrypt pobiera modele każdego komponentu w dokumencie schematu i generuje raport z listą komponentów oraz powiązanych z nimi modeli.

ModifySchObjects

Ten skrypt pokazuje, jak pobierać i modyfikować obiekty schematu oraz aktualizować system cofania przy użyciu interfejsu RobotManager do wysyłania komunikatów schematu.

MoveParameters

Ten skrypt pokazuje, jak przesuwać graficznie parametry obiektu nadrzędnego, takiego jak komponent, przy użyciu właściwości Location i jej metod get/set.

ParentChild_Iterators

Ten skrypt używa iteratora do wyszukiwania symboli arkuszy, a następnie iteratora każdego symbolu arkusza do wyszukiwania wejść arkusza.

PlaceAPort

Ten prosty skrypt pokazuje, jak umieścić nowy obiekt portu na arkuszu schematu.

PlaceSchObjects

Ten prosty skrypt umieszcza różne obiekty na arkuszu schematu.

ReplaceSchObjects

Ten skrypt zastępuje złącza międzyarkuszowe obiektami portów, automatycznie przenosząc informacje o sieciach.

SchDocsRenamer

Ten skrypt wykorzystuje funkcję FileCopy z modułu Windows języka Delphi do kopiowania istniejących plików pod innymi nazwami.

SimModelsOfComponents

Ten skrypt pobiera modele symulacyjne i ich odpowiednie parametry dla każdego komponentu, a następnie generuje raport tekstowy dotyczący tych modeli i parametrów.

UndoRedo

Ten skrypt pokazuje, jak korzystać z systemu cofania operacji podczas modyfikowania dokumentu schematu.

UsingaSpatialIterator

Ten skrypt pokazuje, jak używać iteratora przestrzennego do wyszukiwania w określonym obszarze.

UsingSchInterfaces

Ten skrypt prezentuje interfejsy edytora schematów.

UsingWSMInterfaces

Ten skrypt prezentuje interfejsy menedżera przestrzeni roboczej.

CheckPins

Ten skrypt sprawdza poprawność pinów symboli w bibliotece.

CreateComp_in_Lib

Ten skrypt pokazuje, jak utworzyć nowy symbol w bibliotece.

CompLibReader

Ten skrypt używa metody CreateLibCompInfoReader do wyodrębniania danych komponentów z określonej biblioteki schematów.

LibIterator

Ten skrypt pokazuje, jak przeglądać bibliotekę schematów za pomocą iteratora i pobierać symbole.

ParametersOfSymbolsInALibrary

Ten skrypt pokazuje, jak pobierać parametry symboli w bibliotece schematów za pomocą iteratora.

SymbolPrimsIterator

Ten skrypt pokazuje, jak pobierać obiekty podstawowe symbolu.

StringUtils

Ten moduł obsługuje typy danych.

DesignSettings

Ten moduł służy do odczytywania tabeli ustawień danych CirCad.

Log

Ten moduł służy do generowania pliku dziennika z wynikami.

ImportUtils

Ten moduł służy do konwersji danych CirCad do formatu Altium Designer.

InputForm

Ten moduł obsługuje okno dialogowe translatora.

Test

Ten samodzielny moduł służy do testowania danych CirCad.

ReplaceSelectedComponent

Zastępuje wybrany komponent na schemacie symbolem 2N3904 z biblioteki Miscellaneous Devices.IntLib.

Connectivity

Ten moduł generuje parametry zawierające informacje o sieciach pinów komponentów z aktywnego schematu lub wybranych schematów projektu PCB.

DefnForm

Formularz skryptu do obsługi danych wprowadzanych przez użytkownika.

FontsDialog

Ten skrypt pokazuje, jak korzystać z interfejsu menedżera czcionek schematu.

ImportPinsForm

ImportPinsForm to formularz główny. Potrzebny jest plik CSV zawierający dane pinów, które mają zostać zaimportowane i utworzone w dokumencie SchLib.
Aby użyć skryptu:

1. Uruchom procedurę ImportPins, aby otworzyć okno dialogowe Pins Importer.
2. Kliknij przycisk przeglądania, aby wczytać plik CSV z danymi pinów schematu.
3. Kliknij przycisk Update Mapping, aby odświeżyć powiązania między polami tekstowymi a właściwościami pinów, a następnie kliknij przycisk Import , aby wygenerować listę różnych pinów na stronie biblioteki schematów.

ChangeMappingForm

Okno dialogowe Change Mapping do mapowania pól z pliku tekstowego CSV. Ten skrypt jest używany przez główne okno dialogowe Import Pin.

ConvUtils

Ten skrypt zawiera procedury Conversion of Schematic Types To Strings i Vice Versa.

PinData.CSV

Ten plik zawiera informacje o pinach używane przez skrypt ImportPins.

UpdateFootprintPathsOfComps

Komponent schematu ma właściwość Footprint (model PCB) oraz właściwość ścieżki do jego biblioteki. Zdarza się, że komponenty mają footprinty o tej samej nazwie, ale pochodzące z różnych bibliotek.
Ten skrypt pozwala wybrać nazwę footprintu z aktualnie otwartego schematu, a następnie jedną z dostępnych lokalizacji footprintów. Lokalizacje są określane na podstawie lokalizacji footprintów istniejących komponentów. Po zamknięciu okna dialogowego lokalizacje wszystkich komponentów o tej samej nazwie footprintu zostają zaktualizowane do wskazanej lokalizacji.
Upewnij się, że biblioteki komponentów schematu są zainstalowane, aby lokalizacje (ścieżki) bibliotek footprintów mogły być wyświetlane.

ComponentParameters

Ten skrypt pokazuje, jak tworzyć, modyfikować i usuwać parametry zdefiniowane przez użytkownika dla komponentów na schematach projektu hierarchicznego.

Clrins1

Ten skrypt pokazuje, jak usuwać obiekty z obszaru zdefiniowanego przez użytkownika.

Clrins2

Ten skrypt pokazuje, jak usuwać obiekty z obszaru zdefiniowanego przez użytkownika. Przed usunięciem obiektów użytkownik jest proszony o potwierdzenie.

CirWiz

Ten formularz skryptu generuje prosty układ filtra i umieszcza go na arkuszu schematu.

PCBColor

Ten skrypt pokazuje, jak zmieniać kolory PCB w dokumencie PCB za pomocą procesu SetupPreferences.

PCBLayer

Ten skrypt pokazuje, jak przełączać widoczność warstw PCB za pomocą procesu DocumentPreference.

PlacePCBPolygon

Ten skrypt umieszcza nowy obiekt poligonu w dokumencie PCB za pomocą procesu PlacePolygonPlane.

PlaceSchPort

Ten skrypt umieszcza nowy obiekt portu schematu w dokumencie schematu za pomocą procesu PlacePort.

PublishToPDFScript

Ten skrypt publikuje wyniki z dokumentu OutJob bieżącego projektu w pliku PDF, z pominięciem okna dialogowego Publish to PDF Settings.

QuikCopy

Ten skrypt pokazuje, jak zaznaczać obiekty, a następnie kopiować je i wklejać za pomocą procesów ToggleSelection, Deselect, Paste i Copy.

RunCommonDialog

Ten skrypt pokazuje, jak wywołać okno dialogowe Common modułu Client i pobrać parametry.

ShowNetlist

Ten skrypt pokazuje, jak łatwo wygenerować raport za pomocą procesu GenerateReport modułu WorkspaceManager.

SimpleExample

Ten skrypt pokazuje, jak korzystać z funkcji AddIntegerParameter i GetIntegerParameter.

AddDocToProject

Ten skrypt pokazuje, jak dodać arkusz schematu do nowego projektu PCB. Najpierw w folderze C:\ musi znajdować się plik sheet1.schdoc.

Netlister

Ten skrypt pokazuje, jak wygenerować plik w określonym formacie PackingList dla projektu schematu.

ProjectReporter

Ten skrypt wyszukuje aktualnie otwarte projekty w X2, w tym projekty niezależne. Projekt niezależny to grupa dokumentów, które nie są powiązane z żadnym projektem.

UsingMessagePanel

Ten skrypt pokazuje, jak dodawać komunikaty tekstowe do panelu Messages w Altium Designer. Jest to przydatne narzędzie do debugowania.

ScripterProtelNetlist

Ten skrypt demonstruje wykorzystanie interfejsów WorkSpace Manager do generowania listy połączeń w formacie Protel. Plik listy połączeń jest generowany w folderze Generated dla bieżącego projektu na panelu Projects.
Aby uruchomić ten skrypt, należy otworzyć projekt ScripterProtelNetlist.PRJSCR, następnie wywołać polecenie Run script z menu File i wybrać plik ScripterProtelNetlist.pas w oknie dialogowym Select Item to Run.
Skrypt wygeneruje następnie listę połączeń dla bieżącego projektu, dlatego przed jego uruchomieniem należy upewnić się, że projekt jest aktywny.

AddDocToProject

Ten skrypt demonstruje, jak wstawić arkusz do projektu PCB. W folderze C:\ musi wcześniej znajdować się plik sheet1.schdoc.

BuiltInFunctions

Ten skrypt demonstruje, jak korzystać z wbudowanych obiektów daty i obiektów matematycznych oraz wyświetlać wyniki za pomocą funkcji ShowMessage.

CopyBoardOutlineForm

Ten skrypt kopiuje obrys płytki na wskazaną warstwę w postaci ścieżek i łuków.

GetScriptEngineInfo

Pobiera numer wersji silnika Microsoft Scripting Engine.

HelloWorld

Prosty przykład „Hello World” — wprowadzenie do języka JScript.

ParentChild_Iterators

Ten skrypt używa iteratora do wyszukiwania symboli arkuszy, a następnie w każdym symbolu arkusza korzysta z jego iteratora, aby wyszukać wejścia arkusza.

ServerProcessReport

Ten skrypt demonstruje, jak wygenerować raport dotyczący procesów wszystkich zainstalowanych serwerów w Altium Designer.

SineWave

Ten skrypt demonstruje, jak narysować przebieg sinusoidalny na formularzu skryptu.

ViaCreation

Ten skrypt demonstruje, jak utworzyć nowy obiekt przelotki na PCB.

AddDocToProject

Ten skrypt demonstruje, jak wstawić arkusz schematu do nowego projektu PCB. W folderze C:\ musi wcześniej znajdować się plik sheet1.schdoc.

CopyBoardOutline

Ten skrypt kopiuje obrys płytki na wskazaną warstwę w postaci ścieżek i łuków. Przed kontynuowaniem użytkownik musi określić wartości warstwy i szerokości. Korzysta z modelu obiektowego PCB.

GetScriptEngineInfo

Pobiera numer wersji silnika Microsoft Scripting Engine.

HelloWorld

Prosty przykład „Hello World” — wprowadzenie do języka VBScript.

ParentChild_Iterators

Ten skrypt używa iteratora do wyszukiwania symboli arkuszy, a następnie w każdym symbolu arkusza korzysta z jego iteratora, aby wyszukać wejścia arkusza. Korzysta z modelu obiektowego schematu.

ServerProcessReport

Ten skrypt demonstruje, jak wygenerować raport dotyczący procesów wszystkich zainstalowanych serwerów w Altium Designer.

SineWave

Ten skrypt demonstruje, jak wygenerować i narysować przebieg sinusoidalny na formularzu skryptu. Korzysta z komponentów i formularza skryptu.

ViaCreation

Ten skrypt demonstruje, jak utworzyć nowy obiekt przelotki w dokumencie PCB. Korzysta z modelu obiektowego PCB.