Scripting Examples Reference

IniFileEg

Ten skrypt demonstruje użycie obiektu TIniFile oraz metod odczytu/zapisu (Read/Write).

Mandelbrot

Ten skrypt demonstruje użycie grafiki do zbudowania zbioru Mandelbrota na formularzu skryptu.

MM

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

ShowModalEg

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

SineWave

Ten skrypt pokazuje, jak wygenerować i wykreślić falę sinusoidalną na formularzu skryptu.

TextFileConvert

Plik input.txt jest dostarczony w celach demonstracyjnych.

TicTac

Gra w kółko i krzyżyk.

UpdateTime

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

HelloWorldDialog

Prosty komunikat „hello world” z użyciem formularza skryptu.

HelloWorld

Prosty „hello world” – wprowadzenie do języka DelphiScript.

ZipperForm

Ten skrypt korzysta z API kompresji (zip) udostępnionego w silniku skryptowym. Projekt pakuje do ZIP projekt projektowy (Design project) oraz powiązane z nim pliki.

ClientServerInterfacesReport

Ten skrypt pokazuje, jak używać interfejsów Client, i pobiera informacje o plikach instalacyjnych serwera, typach okien, poleceniach i panelach.

ExtractFilesFromIntLibs

Ten skrypt pokazuje, jak wyodrębniać źródłowe pliki bibliotek z plików bibliotek zintegrowanych o rozszerzeniu INTLIB.

IntLibSearchDemo

Ten skrypt pokazuje, jak wyszukiwać footprinty i modele 3D w plikach bibliotek zintegrowanych oraz w plikach PCBLIB.

OpenADoc

Ten skrypt pokazuje, jak otworzyć dokument tekstowy przy użyciu metody OpenDocument klienta (Client).

ReportIntLibData

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

ReportPCBViews

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

ServerProcessReport

Ten skrypt pokazuje, jak wygenerować raport dla procesów wszystkich zainstalowanych serwerów w X2.

SettingDocumentDirty

Ten skrypt pokazuje, jak oznaczyć dokument jako zmodyfikowany (dirty), aby został zapisany po wywołaniu polecenia Save.

DXPVersionUnit

Ten skrypt pokazuje, jak znaleźć numer wersji aplikacji X2.

Count_Connection_Lines

Ten skrypt pokazuje, jak zliczać linie połączeń (niepoprowadzone ścieżki) w dokumencie PCB i wyświetla wyniki w panelu Messages.

CreateAVia

Ten skrypt pokazuje, jak utworzyć nowy obiekt Via w dokumencie PCB.

CreateComponentOnPCB

Ten skrypt pokazuje, jak utworzyć nowy komponent w dokumencie PCB.

CreateFootprintInLibrary

Ten skrypt pokazuje, jak utworzyć nowy footprint w dokumencie biblioteki.

CreatePCBObjects

Ten skrypt zawiera różne funkcje do tworzenia różnych obiektów PCB w dokumencie PCB. Skrypt używa metody SendMessageToRobots do wysyłania komunikatów PCB.

CreateRules

Ten skrypt pokazuje, jak utworzyć dwie różne reguły: regułę maksymalnej–minimalnej szerokości oraz regułę definicji pomieszczenia (room) (ograniczenie obszaru, confinement constraint).

Cycle_Pcb_Cursor_Type

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

DeletePCBObjects

Ten skrypt pokazuje, jak usuwać obiekty PCB i prawidłowo aktualizować system Cofnij (Undo).

EmbeddedObjects

Ten skrypt demonstruje użycie obiektów osadzonych; tj. tworzy i pobiera te obiekty osadzone w bieżącym dokumencie PCB.

NetObjectAssign

Ten skrypt pokazuje, jak przypisać właściwość netu do nowego obiektu umieszczonego w dokumencie PCB.

PadViaCacheProperties

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

PadStackInfo

Ten skrypt pokazuje, jak pobierać różne informacje o stosie pada (pad stack) w dokumencie PCB.

QueryBoard

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

Undo

Ten skrypt demonstruje system Cofnij (Undo) w PCB. Dwie procedury pokazują, jak działa system Undo — jako jedno duże cofnięcie lub wiele mniejszych cofnięć.

CopyBoardOutlineForm

Ten skrypt kopiuje obrys płytki jako ścieżki i łuki na wskazaną warstwę. Przed kontynuacją użytkownik musi określić wartości Layer i Width.

ConvertPicture

Główny formularz skryptu.

ConstructContourSetFromPicture

Skrypt odpowiedzialny za tworzenie zestawu konturów z wczytanej bitmapy.

ConstructRegionsFromContourSet

Skrypt odpowiedzialny za tworzenie regionów z każdego zestawu konturów.

FindFootprintUnit

Wyszukuje footprint w bibliotece PCB przy użyciu PCB API.

CreateInterComponentFromTos

Skrypt prosi użytkownika o wybranie dwóch komponentów, a następnie łączy pady o tych samych przypisaniach netów. Ograniczenia skryptu: aby wyjść, trzeba odsunąć kursor od komponentu. Po uruchomieniu skryptu wszystkie nety trzeba ręcznie przebudować.

formFormTos

Formularz skryptu dla tego projektu.

HSForm

To jest okno dialogowe edytora konkretnych rozmiarów otworów (Specific Hole Size Editor) do zmiany jednego z rozmiarów otworów.

HSEditForm

To jest główny skrypt edytora rozmiaru otworów.

Customsort

Ten skrypt customsort zawiera procedury sortowania dla skryptu edytora rozmiaru otworów.

MillExporter

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

MillExporter

Ta jednostka konwertuje obrys płytki z dokumentu PCB na wielokąt, aby można było wygenerować dane dla dokumentu PCB i wyfrezować je na frezarce CNC.

MMExportDlg

Ta jednostka steruje ustawieniami eksportu dokumentu PCB do obróbki na frezarce.

MMSetup

Ustawia wartości domyślne dla frezarki, które mają być używane przez MillExporter w tekstowym pliku INI.

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 nety wybranych obiektów PCB do klasy netów i ma odpowiadający mu formularz skryptu.

Count_pads

Ten skrypt zlicza liczbę padów 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 netach bieżącego dokumentu PCB.

IteratePolygons

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

IterateRegions

Ten skrypt iteruje po regionach z 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 oraz iteratora przestrzennego. Zaznacza wyłącznie wolne prymitywy na aktywnej (focused) płytce PCB.

Layers_Info

Ten skrypt pobiera informacje o warstwach dla stosu warstw PCB.

QueryLayerPairs

Ten skrypt odpytuje bieżący dokument PCB o pary warstw PCB.

QueryLayersOfMechType

Ten skrypt odpytuje bieżący dokument PCB o warstwy mechaniczne.

QueryLayerStack

Ten skrypt odpytuje stos warstw (Layer Stack) bieżącego dokumentu PCB.

QueryMechLayers

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

QueryUsedLayers

Ten skrypt odpytuje bieżący dokument PCB o warstwy, które są używane.

RebuildInternalAndSplitPlanes

Ten skrypt wymusza przebudowę warstw zasilania wewnętrznych oraz podzielonych (internal i split planes) dla PCB.

Toggle_Connect_layer_display

Skrypt przełącza widoczność warstwy połączeń (connect layer) na bieżącej płytce PCB.

ValidateLayerStack

Ten skrypt weryfikuje stos 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 wybór grubości ścieżek, tego czy odbić lustrzanie itp.

OffSetObjectsForm

Formularz dla projektu.

OffSetObjects

Demonstracja użycia metody ChooseRectangleByCorners oraz iteratora przestrzennego. Przesuwa obiekty w obrębie zdefiniowanej granicy na PCB.

PCBOutputGenerator

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

1. LookForFiducials.
2. Sprawdź wymiary obrysu płytki.
3. Wygeneruj wyjście (PickPlace i BOM).

Naruszenia

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

GetObjectClasses

Formularz skryptu raportowania klas obiektów. Wybierasz klasę obiektu przed wygenerowaniem listy klas obiektów danego typu jako pliku tekstowego.

IterateRules

Ten skrypt pobiera istniejące reguły dla bieżącej płytki PCB i generuje tekstowy raport o użytych regułach, ich identyfikatorach oraz nazwach.

ModifyWidthRules

Ten skrypt modyfikuje istniejące ograniczenia szerokości (Width Constraints), które mają wartości Min, Favored i Max mniejsze niż 20 mils, i aktualizuje je do 10 mils.

FootprintInfoReport

Ten skrypt generuje raport w formacie CSV dla wszystkich footprintów, zawierający ich nazwy, wysokości i opisy.

SwapComponentsUnit

Zamienia miejscami dwa podobne komponenty lub obraca komponent.
Skrypt prosi użytkownika o wskazanie dwóch komponentów, a następnie zamienia ich pozycje; jeśli ten sam komponent zostanie wybrany dwa razy, zostanie obrócony.
Ograniczenia tego skryptu: aby wyjść, trzeba odsunąć kursor od komponentu.

Common

Wspólne procedury do wykorzystania w projekcie.

ObjectChecker

Sprawdza zduplikowane sieci (Nets) i komponenty w bieżącym dokumencie PCB.

Form_ChooseNetClass

Ten formularz skryptu prosi o wybór klasy sieci, aby obiekty należące do tej klasy mogły zostać „unrouted” (usunięte prowadzenie).

ValuesCheckerUnit

Ten skrypt sprawdza, czy obiekty w dokumencie PCB zawierają poprawne wartości, zanim wygeneruje wyjście do wczytania w edytorze CAM.

PCBAPI functions

Moduł skryptu zawierający funkcje używane w oknie dialogowym Values Checker.

AddModelToComponentScript

Ten skrypt pokazuje, 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 pokazuje, jak umieścić komponent w dokumencie schematu.

CreateSchObjects

Ten skrypt tworzy obiekty schematu na dwa sposoby;

1. pierwsza procedura umieszcza dwa porty i tylko jedno cofnięcie (Undo) usunie oba
2. druga procedura umieszcza dwa porty i potrzeba dwóch cofnięć (Undo), aby usunąć oba.

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

DeleteSchObjects

Skrypt pokazuje, jak usuwać obiekty schematu i aktualizować system cofania (Undo) przy użyciu interfejsu RobotManager do wysyłania komunikatów schematu.

FetchParameters

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

IterateSchSheets

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

ModelsOfaComponent

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

ModifySchObjects

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

MoveParameters

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

ParentChild_Iterators

Ten skrypt używa iteratora do wyszukiwania symboli arkuszy (sheet symbols), a następnie w każdym symbolu arkusza używa iteratora tego symbolu do wyszukiwania wpisów arkusza (sheet entries).

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 łączniki międzyarkuszowe (cross sheet connectors) obiektami portów i automatycznie przenosi informacje o sieci.

SchDocsRenamer

Ten skrypt wykorzystuje funkcję FileCopy z jednostki Delphi Windows do kopiowania istniejących plików pod innymi nazwami.

SimModelsOfComponents

Ten skrypt pobiera modele symulacyjne i ich istotne parametry dla każdego komponentu, a następnie generuje tekstowy raport o tych modelach i parametrach.

UndoRedo

Ten skrypt pokazuje, jak używać systemu Undo, gdy dokument schematu jest modyfikowany.

UsingaSpatialIterator

Ten skrypt demonstruje użycie iteratora przestrzennego do przeprowadzenia wyszukiwania w zdefiniowanym obszarze.

UsingSchInterfaces

Ten skrypt demonstruje interfejsy schematu.

UsingWSMInterfaces

Ten skrypt demonstruje interfejsy WorkSpace Manager.

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ębnienia danych komponentów z określonej biblioteki schematów.

LibIterator

Ten skrypt pokazuje, jak iterować po bibliotece schematów i pobierać symbole.

ParametersOfSymbolsInALibrary

Ten skrypt pokazuje, jak pobierać parametry symboli w bibliotece schematów przy użyciu iteratora.

SymbolPrimsIterator

Ten skrypt pokazuje, jak pobierać prymitywy symbolu.

StringUtils

Ten moduł dotyczy typów danych.

DesignSettings

Ten moduł dotyczy odczytu tabeli Settings dla danych CirCad.

Log

Ten moduł dotyczy generowania pliku dziennika (log) z wynikami.

ImportUtils

Ten moduł dotyczy translacji danych CirCad dla Altium Designer.

InputForm

Ten moduł dotyczy okna dialogowego translatora.

Test

Ten samodzielny moduł dotyczy testowania danych CirCad.

ReplaceSelectedComponent

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

Connectivity

Ten moduł generuje parametry z informacjami Pin-Net dla pinów komponentów z aktywnego schematu lub wybranych schematów projektu PCB.

DefnForm

Formularz skryptu do obsługi danych wejściowych użytkownika.

FontsDialog

Ten skrypt demonstruje użycie interfejsu Schematic Font Manager.

ImportPinsForm

ImportPinsForm to główny formularz. Potrzebujesz pliku CSV  zawierającego dane pinów do importu i utworzenia nowych pinów w dokumencie SchLib .
Aby użyć skryptu:

1. Uruchom procedurę ImportPins, a pojawi się 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 Import przycisk, aby wygenerować listę różnych pinów na stronie biblioteki Sch.

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 biblioteki (Library Path). Zdarzają się sytuacje, gdy komponenty mają tę samą nazwę footprintu, ale pochodzą z różnych bibliotek.
Ten skrypt pozwala wybrać nazwę footprintu z aktualnie otwartego schematu, a następnie wybrać jedną z dostępnych lokalizacji footprintu. Lokalizacje są oparte na istniejących lokalizacjach footprintów komponentów. Po zamknięciu okna dialogowego wszystkie komponenty o tej samej nazwie footprintu mają zaktualizowane lokalizacje do wskazanej lokalizacji.
Upewnij się, że masz zainstalowane biblioteki dla komponentów schematu, aby mogły pojawić się lokalizacje (ścieżki) bibliotek footprintów.

ComponentParameters

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

Clrins1

Ten skrypt pokazuje, jak usuwać obiekty w obszarze zdefiniowanym przez użytkownika.

Clrins2

Ten skrypt pokazuje, jak usuwać obiekty w obszarze zdefiniowanym przez użytkownika. Przed wyczyszczeniem obiektów użytkownik jest proszony o potwierdzenie.

CirWiz

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

PCBColor

Ten skrypt pokazuje, jak zmieniać kolory PCB dla dokumentu PCB przy użyciu procesu SetupPreferences.

PCBLayer

Ten skrypt pokazuje, jak przełączać widoczność warstw PCB przy użyciu procesu DocumentPreference.

PlacePCBPolygon

Ten skrypt umieszcza nowy obiekt poligonu PCB w dokumencie PCB przy użyciu procesu PlacePolygonPlane.

PlaceSchPort

Ten skrypt umieszcza nowy obiekt Port schematu na dokumencie schematu, używając procesu PlacePort.

PublishToPDFScript

Ten skrypt publikuje z dokumentu OutJob bieżącego projektu do PDF i pomija okno dialogowe Publish to PDF Settings.

QuikCopy

Ten skrypt pokazuje, jak zaznaczać obiekty, a następnie kopiować i wklejać je przy użyciu 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 jest wygenerować raport przy użyciu procesu GenerateReport w WorkspaceManager.

SimpleExample

Ten skrypt demonstruje użycie funkcji AddIntegerParameter i GetIntegerParameter.

AddDocToProject

Ten skrypt pokazuje, jak wstawić 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 tym projekty Free w X2. Projekt Free to grupa dokumentów, które nie są powiązane z żadnym projektem.

UsingMessagePanel

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

ScripterProtelNetlist

Ten skrypt demonstruje użycie interfejsów WorkSpace Manager do wygenerowania netlisty typu Protel. Plik netlisty jest generowany w folderze Generated dla bieżącego projektu w panelu Projects.
Aby uruchomić ten skrypt, musisz mieć otwarty 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 wtedy netlistę dla bieżącego projektu, więc upewnij się, że projekt jest aktywny przed uruchomieniem skryptu.

AddDocToProject

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

BuiltInFunctions

Ten skrypt pokazuje, jak używać wbudowanych obiektów daty i matematyki oraz wyświetlać wyniki przy użyciu funkcji ShowMessage.

CopyBoardOutlineForm

Ten skrypt kopiuje obrys płytki jako ścieżki i łuki na wskazaną warstwę.

GetScriptEngineInfo

Pobiera numer wersji Microsoft Scripting Engine.

HelloWorld

Proste „hello world” – wprowadzenie do języka JScript.

ParentChild_Iterators

Ten skrypt używa iteratora do wyszukiwania symboli arkuszy, a następnie w obrębie każdego symbolu arkusza używa iteratora tego symbolu do wyszukiwania wpisów arkusza.

ServerProcessReport

Ten skrypt pokazuje, jak wygenerować raport procesów wszystkich zainstalowanych serwerów w Altium Designer.

SineWave

Ten skrypt pokazuje, jak wykreślić falę sinusoidalną w formularzu skryptu.

ViaCreation

Ten skrypt pokazuje, jak utworzyć nowy obiekt przelotki (Via) na PCB.

AddDocToProject

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

CopyBoardOutline

Ten skrypt kopiuje obrys płytki jako ścieżki i łuki na wskazaną warstwę. Wartości warstwy i szerokości muszą zostać podane przez użytkownika przed kontynuowaniem. Używa PCB Object Model.

GetScriptEngineInfo

Pobiera numer wersji Microsoft Scripting Engine.

HelloWorld

Proste „hello world” – wprowadzenie do języka VBScript.

ParentChild_Iterators

Ten skrypt używa iteratora do wyszukiwania symboli arkuszy, a następnie w obrębie każdego symbolu arkusza używa iteratora tego symbolu do wyszukiwania wpisów arkusza. Używa Schematic Object Model.

ServerProcessReport

Ten skrypt pokazuje, jak wygenerować raport procesów wszystkich zainstalowanych serwerów w Altium Designer.

SineWave

Ten skrypt pokazuje, jak wygenerować i wykreślić falę sinusoidalną w formularzu skryptu. Używa Components oraz formularza skryptu.

ViaCreation

Ten skrypt pokazuje, jak utworzyć nowy obiekt przelotki (Via) w dokumencie PCB. Używa PCB Object Model.