Automatyzacja zadań projektowych za pomocą skryptów

Skrypty to skuteczny sposób na rozszerzenie możliwości i zwiększenie wydajności pracy w Altium Designer. Skrypt zawiera zestaw instrukcji (zautomatyzowanych poleceń), które są interpretowane podczas jego wykonywania w Altium Designer. Skrypty można pisać w różnych językach, wyposażać w rozbudowane okna dialogowe i debugować w Altium Designer. Za pomocą skryptów można realizować cele projektowe przy minimalnej ingerencji użytkownika oraz mniejszej liczbie naciśnięć klawiszy i kliknięć myszą.

Skrypty pozwalają automatyzować powtarzalne zadania i wprowadzać zmiany, których nie da się wykonać za pomocą istniejących poleceń w Altium Designer. Na przykład skrypt może służyć do wyszukiwania i aktualizowania znaczników odniesienia na dokumencie PCB lub do eksportowania niestandardowej listy połączeń.

Skrypty można zapisywać w projekcie skryptowym lub w projekcie układu elektronicznego. W Altium Designer dostępnych jest kilka języków skryptowych.

Przegląd i konfiguracja systemu skryptowego

System skryptowy Altium Designer zapewnia wszystkie narzędzia i funkcje potrzebne do tworzenia skryptów automatyzujących zadania w programie.

Skrypty można pisać w celu automatyzacji powtarzalnych zadań lub rozszerzenia funkcji Altium Designer. System skryptowy składa się z dwóch głównych części: edytora i debuggera. Edytor skryptów, debugger i panele skryptowe współpracują ze sobą, ułatwiając pisanie i debugowanie skryptów. Skrypt można uruchomić bezpośrednio z edytora skryptów lub przypisać do menu, paska narzędzi albo skrótu klawiaturowego, aby w dowolnym momencie zastosować go do bieżącego dokumentu, na przykład PCB.

► Przeczytaj o systemie skryptowym w Altium Designer

Tworzenie i przechowywanie skryptów

Skrypty Altium Designer są zazwyczaj tworzone i przechowywane w projekcie skryptowym (*.PrjScr), ale można je dodawać do projektów dowolnego typu lub w nich przechowywać.

Aby rozpocząć pisanie skryptów, utwórz nowy projekt skryptowy i dodaj do niego pliki skryptów.

Projekt skryptowy ułatwia zarządzanie skryptami. Można go utworzyć, wybierając File » New » Project » Script Project z menu głównego. Nowy projekt pojawi się w panelu Projects. Aby dodać nowy skrypt do projektu, kliknij prawym przyciskiem myszy nazwę projektu i wybierz Add New to Project z menu kontekstowego.

Podczas tworzenia nowego skryptu można wybrać jeden z dwóch typów, w zależności od wymagań projektu: moduł skryptowy lub formularz skryptowy. Moduły skryptowe umożliwiają pisanie samodzielnych procedur i funkcji. Formularze skryptowe pozwalają tworzyć okna dialogowe z kontrolkami i procedurami obsługi zdarzeń, a także procedurami i funkcjami.

► Przeczytaj o tworzeniu i przechowywaniu skryptów w Altium Designer

Pisanie skryptów

Z pisaniem skryptów wiąże się kilka podstawowych pojęć i terminów:

• Procesy to ciągi poleceń, których można używać do wykonywania poleceń w skryptach.

• Komponenty to wizualne obiekty kontrolek dostępne w panelu Tool Palette, które można przeciągać i upuszczać na formularzu skryptowym, aby manipulować projektem.

• Komponent umieszczony na formularzu skryptowym ma metody, właściwości i zdarzenia.

• Interfejsy obiektów to specjalne interfejsy umożliwiające odczytywanie i modyfikowanie danych w dokumentach projektowych za pomocą skryptów.

Domyślnym językiem skryptowym jest DelphiScript (*.pas). Sam silnik skryptowy został napisany w Embarcadero Delphi, a panel Tool Palette jest oparty na bibliotece VCL (Visual Component Library) języka Delphi.

► Przeczytaj o pisaniu skryptów w Altium Designer

Narzędzia do edycji i debugowania skryptów

System skryptowy Altium Designer składa się z dwóch głównych części: edytora i debuggera. Edytor oferuje szereg funkcji wspomagających pisanie i analizę kodu skryptów, a debugger zapewnia dostęp do komponentów skryptowych i funkcji debugowania. Narzędzia edytora skryptów stanowią istotną pomoc podczas debugowania skryptów.

System skryptowy udostępnia szereg narzędzi ułatwiających debugowanie skryptów. Obejmują one ustawianie wielu punktów przerwania w skrypcie, używanie panelu Watch List do monitorowania wartości zmiennych, korzystanie z zakładek w celu sprawniejszego poruszania się po kodzie oraz śledzenie wykonania skryptów za pomocą funkcji pracy krokowej z wchodzeniem do procedur lub ich pomijaniem.

► Przeczytaj o narzędziach do edycji skryptów w Altium Designer

► Przeczytaj o debugowaniu skryptów w Altium Designer

Uruchamianie skryptów

System skryptowy Altium Designer umożliwia tworzenie rozbudowanych zautomatyzowanych zadań, ale powstałe skrypty muszą być również łatwo dostępne podczas projektowania. Na przykład skrypt wykonujący złożony zestaw operacji podczas edycji PCB powinien być łatwo dostępny bezpośrednio w edytorze PCB, gdzie można go uruchomić jednym lub dwoma kliknięciami myszy.

Altium Designer zapewnia taką możliwość, pozwalając przypisać skrypt do mechanizmu uruchamiania procesów, a tym samym do polecenia, które można przypisać do menu, paska narzędzi i skrótu klawiaturowego.

Skrypt otwarty w edytorze skryptów można wykonać za pomocą polecenia Run tego edytora. Wymaga to otwarcia projektu skryptowego w Altium Designer, co nie jest wygodnym sposobem dostępu do skryptu potrzebnego na przykład podczas projektowania PCB. Alternatywnie okno dialogowe Select Item To Run (File » Run Script) pozwala wskazać skrypt na lokalnym dysku twardym lub w połączonym obszarze roboczym, a następnie uruchomić żądany proces. Skrypt pozostaje załadowany przez całą bieżącą sesję.

Wygodniejszym sposobem uzyskania dostępu do często używanego skryptu jest zainstalowanie projektu jako projektu globalnego na stronie Scripting System – Global Projects okna dialogowego Preferences. W takim przypadku projekt jest automatycznie ładowany przy uruchamianiu Altium Designer i można go wykonać w dowolnym momencie za pomocą polecenia File » Run Script.

► Przeczytaj o uruchamianiu skryptów w Altium Designer

Komponenty graficzne w skryptach

Wizualne komponenty formularzy dostępne w skryptach Altium Designer pochodzą w większości z biblioteki Visual Component Library (VCL) firmy Embarcadero. Jest to zbiór zdefiniowanych komponentów wizualnych służących do tworzenia aplikacji Windows w językach Delphi i C++.

VCL została opracowana jako biblioteka klas wizualnych. Jej klasy wywodzą się z obiektu TComponent (który sam jest potomkiem obiektu głównego TObject) w liniowej hierarchii obiektów. Dlatego typowy komponent skryptowy, taki jak obiekt TButton, dziedziczy właściwości, metody i zdarzenia po swoich obiektach nadrzędnych. W tym przypadku hierarchia klas wygląda następująco: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Należy pamiętać, że komponenty wywodzące się z obiektu TControl są zazwyczaj komponentami wizualnymi (kontrolkami), a typowe komponenty wywodzące się z TWinControl to głównie obiekty opakowujące interfejs API systemu Windows.

Podczas tworzenia formularza w edytorze skryptów Altium Designer komponenty są dostępne w panelu Tool Palette. Formularze skryptowe mają powiązany plik *.DFM, który zawiera szczegóły konfiguracji formularza, położenia jego komponentów i innych atrybutów. Plik ten znajduje się w folderze projektu skryptowego. Altium Designer umożliwia korzystanie z komponentów zarówno w DelphiScript, jak i VBScript podczas projektowania formularzy skryptowych.

► Przeczytaj o komponentach graficznych w skryptach Altium Designer

Przykłady skryptów

Aby przybliżyć ogólne zagadnienia związane z systemem skryptowym oraz wykorzystaniem Delphi i modeli obiektowych X2 w skryptach, przeanalizowano pod kątem funkcjonalności dwa przykładowe projekty — skrypt kopiujący obrys płytki oraz skrypt generujący listę połączeń. Skrypty Board Outline Copier i Netlister opracowano z wykorzystaniem modeli obiektowych X2, aby zilustrować możliwości systemu skryptowego w Altium Designer.

Są to istniejące skrypty dostępne w pakiecie przykładów do pobrania od Altium. Należy pamiętać, że ten plik ZIP utworzono w momencie premiery Altium Designer 10. Folder Scripts w pliku ZIP zawiera podfoldery uporządkowane według języków skryptowych.

Warto pamiętać, że szeroki wybór przydatnych skryptów można znaleźć w zbiorze Altium Designer w serwisie GitHub.

► Przeczytaj o analizie przykładowych skryptów w Altium Designer

► Przeczytaj o przykładowych skryptach dla Altium Designer

Obsługa języków skryptowych

Skrypty dla Altium Designer można pisać w kilku językach skryptowych. Należy pamiętać, że podstawowym językiem, do którego najczęściej odwołuje się dokumentacja skryptów, jest DelphiScript, ściśle powiązany z Embarcadero Delphi™.

► Przeczytaj o obsłudze języków skryptowych w Altium Designer