Running Scripts in Altium Designer

알티움 디자이너 스크립팅 시스템은 알티움 디자이너를 위한 복잡한 자동화된 작업을 생성하는 수단을 제공하지만, 생성된 Script는 디자인 Process 중에 쉽게 접근할 수 있어야 합니다. 예를 들어, PCB 편집 중에 복잡한 작업을 수행하는 Script는 PCB Editor 자체에서 쉽게 사용할 수 있어야 하며, 마우스 클릭 또는 두 번의 클릭으로 Run할 수 있어야 합니다.

알티움 디자이너는 이러한 요구를 충족하기 위해 Script를 Process 런처에 할당하고, 메뉴, 툴바 및 단축키에 할당할 수 있는 명령으로 지정할 수 있도록 합니다.

Script Run

Script Editor에서 열린 Script는 Editor의 Run » Run 명령을 사용하여 Run할 수 있습니다(단축키: F9). Run » Set Project Startup Procedure 명령에 의해 현재 Script가 Run됩니다.

Run 명령은 Altium Designer에서 Script Project가 열려 있어야 하므로 PCB 설계 과정 중 필요한 Script에 접근하기에는 편리하지 않습니다. 대신, Select Item To Run 대화 상자 (File » Script Run)를 사용하여 로컬 하드 드라이브나 연결된 워크스페이스에서 Script를 찾거나 Project 패널에서 열려 있는 Script를 선택한 후 원하는 Process를 Run할 수 있습니다. Script는 현재 세션 동안 로드된 상태로 유지됩니다.

Script Process 런처를 사용하여 Script를 Run하는 방법을 보여주는 Select Item to Run 대화 상자.

자주 사용되는 Script에 접근하기 위한 더 적합한 방법은 Global Project로 Project를 설치하는 것입니다. 이는 Scripting System - Global Project 페이지에서 환경 설정 대화 상자로부터 수행됩니다. 이 경우, Project는 Altium Designer가 시작될 때 자동으로 로드되며, File » Script Run 명령을 통해 언제든지 Run할 수 있습니다.

Script의 기능에 접근하는 이상적인 방법은 Altium Designer의 GUI에 메뉴 또는 도구 모음 명령으로 통합되는 경우입니다. 이는 일반적으로 두 단계 Process로 이루어집니다. Script를 명령으로 구현하고 (선택적으로 단축키를 지정), 그런 다음 명령을 메뉴 (정적 또는 팝업) 또는 도구 모음에 할당하는 것입니다.

명령으로 Script 구현하기

Script는 Altium Designer의 내장 서버 Process 또는 더 구체적으로 ScriptingSystem:RunScript Process를 활용하여 응용 프로그램 명령으로 구현될 수 있습니다.

명령은 수행된 동작을 나타내며, 패키지화된 Process 런처를 통해 Process 문자열을 지원합니다. ScriptingSystem:RunScript Process의 경우, 특정 Script Project File, 구성 Script File (*.pas) 및 해당 Script 내의 Process를 가리키는 Parameter가 포함됩니다. 적절하게 정렬되면 이러한 요소들은 명령 문자열을 구성합니다.

이 접근 방식의 장점은 Script를 Process로 Run함으로써 Script를 직접 열거나 Global Project로 로드 할 필요가 없다는 것입니다. Script를 Run하기 위해 Process 방법을 사용하는 더 중요한 장점은 Altium Designer 명령으로 구현할 수 있다는 것입니다. 이는 Altium Designer의 메뉴 시스템을 사용자 정의하는 것으로 수행되며, Script를 지정된 서버 (예: File 시스템 또는 설계 문서 Editor와 같은 하위 응용 프로그램)에 대한 명령으로 할당할 수 있습니다.

명령 생성

예를 들어 HelloWorld Script를 PCB Editor의 명령으로 지정하려면, 먼저 PCB 문서 (따라서 Editor)를 열고 메인 메뉴에서 View » Tools » Customize를 선택하여 PCB Editor 사용자 정의 대화 상자를 엽니다. 대화 상자는 메뉴 바나 도구 모음을 마우스 오른쪽 버튼으로 클릭한 다음 드롭다운 메뉴에서 Customize를 선택하거나 메뉴 바나 도구 모음의 명령이 없는 공백 영역 (명령이 없는 공백 영역)을 더블 클릭하여 액세스할 수도 있습니다.

새 명령을 만들려면 대화 상자의 New 버튼을 클릭하여 명령 편집 대화 상자를 엽니다. 여기에 서버 Process 및 Script 경로 세부 정보를 포함할 수 있습니다. Script에서 명령을 만들 때 [Scripts] 카테고리가 선택되지 않도록 주의하십시오.

대화 상자의 Action 항목은 다음과 같은 형식을 취합니다:

Process: ScriptingSystem:RunScript
Parameter: ProjectName|ProcName>Process

Script의 소스 경로에 따라 Parameter 문자열은 다음과 유사할 수 있습니다:

ProjectName=C:\Users\Public\Documents\Altium\Delphiscript Scripts\General\HelloWorld.PRJSCR|ProcName=HelloWorld.pas>HelloWorld

Edit Command 대화 상자에는 명령 캡션, 설명, 바로 가기 및 연결된 비트맵 이미지 (BMP/GIF/PNG; 18 x 18 픽셀)를 입력할 수 있는 필드도 제공됩니다. 이러한 설정은 명령과 함께 저장되며 메뉴, 도구 모음 및 팝업에 삽입된 모든 인스턴스에 적용됩니다. 자세한 내용은 아래의 메뉴 명령 할당 섹션에서 설명되어 있습니다.

세부 정보를 입력하고 편집 대화 상자를 닫으면 (), HelloWorld Script가 PCB Editor의 사용자 정의 명령 ([Custom])으로 사용할 수 있게 됩니다.

RunScriptFile Process를 사용하여 Script Run

Altium Designer에서 DelphiScript 단위 Script(*.pas 확장자)를 RunScriptFile Process를 사용하여 Run할 수 있습니다. 참고로, 폼을 가지고 있는 Script가 아닌 DelphiScript 단위 Script만 사용할 수 있습니다. 이 경우, 대화 상자의 Action 항목은 다음과 같습니다:

Process: ScriptingSystem:RunScriptFile
Parameter: FileName|ProcName

Script File의 소스 경로에 따라 Parameter 문자열은 다음과 유사할 수 있습니다:

FileName=C:\Users\Public\Documents\Altium\Delphiscript Scripts\Processes\ShowNetList.pas|ProcName=RunNetList

RunScriptText Process를 사용하여 Script Run

이 Process는 Begin End; 블록 내에서 일련의 명령을 Run하는 데 사용될 수 있습니다. 이 경우, 대화 상자의 Action 항목은 다음과 같습니다:

Process: ScriptingSystem:RunScriptText
Parameter: Text

예를 들어, Microsoft Notepad와 같은 외부 응용 프로그램을 Altium Designer에서 소프트웨어 제어를 통해 Run할 수 있습니다. 이 경우, 명령 Process와 Parameter 항목은 다음과 같습니다:

Process: ScriptingSystem:RunScriptText
Parameter: Text=Begin RunApplication('notepad.exe'); End;

이 경우 소프트웨어 Process인 ScriptingSystem:RunScriptText는 특정 Script File을 열고 Run하는 대신 Script 문장의 일련을 Run합니다.

대안적인 접근 방식은 몇 줄의 동등한 코드로 Script를 작성한 다음 전통적인 ScriptingSystem:RunScript 명령 항목을 생성하는 것입니다.

Procedure RunNotepad;
Begin
    RunApplication('notepad.exe');
End;

외부 Notepad 명령을 구현하는 두 가지 접근 방식 모두에 대해, RunApplication의 Parameter로 'notepad.exe'만 입력하면 됩니다. 애플리케이션의 전체 경로와 File 이름을 지정할 필요는 없습니다. 계산기와 메모장과 같은 Windows 애플리케이션은 운영 체제에서 이미 경로가 지정되어 있습니다.

Windows 경로가 내재되지 않은 Altium Designer에서 애플리케이션을 Run하려면 애플리케이션의 전체 경로와 File 이름을 지정해야 합니다(경로에 공백이 있는 경우를 대비하여 단일 따옴표로 감싸야 함). 예를 들어, 두 번째 Altium Designer 사본을 Run하려면 RunApplication Process와 Parameter는 다음과 같습니다:

RunApplication('C:\Program Files\Altium\xx\X2.EXE') - 여기서 xx는 Altium Designer 버전 폴더 이름을 나타냅니다.

메뉴 명령 할당

위에서 설명한대로 Altium Designer의 사용자 정의 기능(View » Toolbars » Customize)으로 구현된 Script는 간단한 드래그 앤 드롭 Process를 통해 서버 GUI에 할당할 수 있습니다.

► 또한 디자인 공간 사용자 정의도 참조하세요.

도구 모음

예를 들어, 사용자 정의 명령을 PCB Editor의 주 메뉴 또는 도구 모음 메뉴에 할당하려면, PCB Editor 사용자 정의 대화 상자를 열고, 사용자 정의 명령을 찾아 원하는 메뉴 위치로 끌어다 놓으세요. PCB Editor 메뉴에 액세스하려면 PCB 문서가 열려 있어야 함을 유의하세요. 사용자 정의 대화 상자를 닫으면 새로운 메뉴 명령은 언제든지 PCB Editor에서 액세스할 수 있습니다.

사용자 정의 명령을 필요한 메뉴 위치로 끌어다 놓을 수 있습니다.

이 예제에서 새로운 사용자 정의 명령은 PCB Active Bar에 할당되었으므로, PCB Editor 사용자 정의 대화 상자에서 PCB Active Bar 명령 카테고리 아래에서 확인할 수 있습니다.

메뉴에 할당된 사용자 지정 Script 명령은 사용자 지정 대화 상자에서 해당 메뉴의 범주 아래에 나타납니다.

메뉴에서 명령을 제거하려면 사용자 지정 대화 상자를 열고 메뉴 명령 아이콘을 대화 상자로 드래그하십시오.

툴바에 할당된 명령을 제거하는 방법.

메뉴

사용자 지정 명령은 동일한 드래그 앤 드롭 Process를 사용하여 메뉴에 할당할 수 있습니다. 메뉴의 어떤 깊이에 있든지 가능합니다.

서버가 사용자 지정 모드에 있을 때 메뉴는 마우스 포인터에 반응하여 확장 및 축소됩니다. 예를 들어 PCB Editor의 Report 메뉴에 명령을 배치하려면 명령을 메뉴로 드래그하고 목록 아래로 이동하여 적절한 위치에 놓을 수 있습니다. 사용자 지정 대화 상자가 닫힌 후에는 새로운 메뉴 명령(여기서는 메모장)을 Report 메뉴에서 액세스할 수 있습니다.

사용자 정의 명령을 드롭다운 메뉴로 끌어서 넣을 수 있는 사용자 정의 메뉴

Pop-up 메뉴

명령은 하위 메뉴의 깊이에 제한이 없이 오른쪽 클릭 팝업 메뉴에 할당될 수 있습니다.

이 예제에서는 명령을 PCB Popups » Right Mouse Click Free Space 메뉴 경로를 통해 드래그하여 아래와 같이 하위 메뉴에 드롭합니다. 할당된대로 사용자 정의 메모장 Script 명령은 PCB Editor에서 빈 공간을 오른쪽 클릭할 때 사용할 수 있습니다.

오른쪽 클릭 하위 메뉴에 할당된 사용자 정의 명령

직접 Script 할당

Script를 재사용 가능한 사용자 정의 명령으로 만들고 메뉴에 할당하는 대신, Script를 빠르고 일회성으로 메뉴에 직접 적용할 수 있습니다.

이는 로드된 Script를 메뉴에 직접 할당함으로써, 사용자 정의 명령 단계의 생성을 우회하도록 합니다. 일치하는 사용자 정의 명령이 없는 경우, 여러 메뉴에 완전히 구성된 명령으로 적용할 수 있는 사용자 정의 명령이 없으므로 이 직접적인 방법은 Script 메뉴 액세스에 대한 단일 솔루션입니다. 따라서 다양한 명령 설정인 캡션, 설명, 이미지 및 바로 가기는 할당된 인스턴스에만 적용됩니다.

Script를 메뉴에 직접 할당하려면 Script Project를 로드하고, 서버의 사용자 정의 대화 상자(View » Toolbars » Customize)를 열고, 카테고리 목록에서 [Script]를 선택한 다음 원하는 Script를 찾아 메뉴 위치로 끌어다 놓으십시오. 를 클릭하여 명령 편집 대화 상자를 닫습니다.

명령이 아닌 Script도 메뉴에 직접 할당할 수 있습니다.

모든 메뉴 배치와 마찬가지로, 새로운 메뉴 항목이 여전히 기본 설정(캡션 이름, 바로 가기 등)인 경우, 메뉴 항목을 마우스 오른쪽 버튼으로 클릭하고 하위 메뉴에서 Edit을 선택하여 이를 수정할 수 있습니다. 이렇게 하면 명령 편집 대화 상자가 열리며 적절한 설정을 입력할 수 있습니다.

사용자 정의 모드에서 메뉴를 마우스 오른쪽 버튼으로 클릭하여 해당 Parameter에 액세스합니다.

구성된 후에는 Script Project를 명시적으로 로드하거나 Global Project로 설치할 필요 없이 새로운 메뉴가 디자인 시간에 사용할 수 있습니다.

메뉴에 Script를 적용하는 이 접근 방식은 필요한 명령을 자동으로 생성합니다. 이는 위의 방법에서 설명한 것과 같이 재할당 가능한 사용자 정의, 완전히 구성된 명령이 아니라 해당 메뉴 항목을 위해 생성된 명령입니다.

이는 Customizing 대화 상자의 실제 메뉴 카테고리 항목에서 확인할 수 있습니다. 위의 예에서는 Customizing PCB Editor 대화 상자의 Reports 카테고리에서 개별로 구성된 명령을 볼 수 있습니다.

메뉴에 직접 Script를 적용할 때 해당 메뉴 항목에 대한 일치하는 명령이 생성됩니다.