스크립팅 시스템 개요 및 설정

Altium Designer 스크립팅 시스템은 소프트웨어에서 작업을 자동화하는 스크립트를 만들기 위해 필요한 모든 도구와 기능을 제공합니다.

스크립트 편집기, 디버거, 그리고 스크립팅 패널은 함께 작동하여 스크립트를 쉽게 작성하고 디버깅할 수 있도록 도와줍니다. 스크립트는 스크립트 편집기에서 직접 실행할 수도 있고, 메뉴/툴바/단축키에 할당하여 언제든지 PCB Layout과 같은 현재 문서에 적용할 수도 있습니다.

Altium Designer에서 Script Code 및 Form 창과 Object Inspector, Code Explorer, Tool Palette 패널을 표시한 모습.

스크립팅 시스템 기능

스크립팅 시스템은 두 가지 주요 부분(편집기와 디버거)으로 구성됩니다. 주요 기능은 다음과 같습니다.

• Project access – 스크립트는 스크립트 프로젝트 또는 디자인 프로젝트에 저장할 수 있습니다. 프로젝트 내 어떤 스크립트의 루틴이든 동일 프로젝트의 다른 스크립트에서 접근할 수 있습니다.

• Scripting Editor – 스크립팅 편집기는 편집 환경 설정과 구문 색상 지정 등 다양한 옵션을 제공하는 전용 텍스트 편집기를 갖추고 있습니다.

• Scripting Panels – 스크립팅 시스템에는 스크립트를 빠르게 코딩하고 디버깅하는 데 도움이 되는 여러 패널이 포함되어 있습니다.

• Scripting Debugger – 스크립트 실행 중 오류가 발생하면 간결한 오류 메시지가 포함된 대화상자가 표시됩니다. Watches 창에서 변수를 미리 확인하고, Script Debugger로 코드를 추적하며 스크립트 실행을 제어할 수 있습니다.

• Scripting Languages – 스크립트는 DelphiScript로 만들 수 있으며, 레거시 언어로 활성화한 경우 VBScript로도 만들 수 있습니다.

스크립트 유닛과 폼

스크립트 프로젝트는 Script Units와 Script Forms라는 두 가지 스크립트 문서 유형을 지원합니다. Script Units에서는 독립 실행형 프로시저와 함수를 작성할 수 있습니다. Script Forms에서는 컨트롤과 이벤트 핸들러가 포함된 대화상자를 구성할 수 있으며, 프로시저와 함수도 작성할 수 있습니다.

• Script Unit은 X2 Application Programming Interface(API)를 사용하여 설계 문서의 디자인 객체를 수정하거나 조작할 수 있습니다. Script Form은 사용자 인터페이스로서 컨트롤을 호스팅하고 X2 API를 활용하여 활성 설계 문서에 작동하는 스크립트 대화상자를 제공합니다.
• Script Form은 스크립트에서 지원되는 시각적 폼 유닛입니다. 폼이 활성화되면 대화상자 창을 나타냅니다.
• Script Form에는 Script Code 보기와 Script Form 보기, 두 가지 보기가 있습니다. Script Code 보기에는 이벤트 핸들러와 프로시저/함수가 포함됩니다. Script Form 보기는(여러 유형의) 대화상자 폼을 나타내며, 컨트롤과 해당 컨트롤에 연결된 이벤트 핸들러를 포함합니다.
• Script Form에는 연결된 파일이 두 개 있습니다. 이벤트 핸들러와 프로시저/함수를 포함하는 *.pas 파일과, 스크립트 폼 자체의 세부 정보 및 구성 요소와 그 위치를 포함하는 *.dfm 파일입니다.
• 컴포넌트는( Tool Palette panel에서 배치하는) 시각적 또는 비시각적 컨트롤 객체로, 마우스 클릭이나 문자 입력 시퀀스 등 사용자 입력을 받습니다. 설계 중에는 Object Inspector panel을 사용하여 Script Form의 컴포넌트를 조작할 수 있습니다. 컴포넌트는 스크립팅 시스템이 지원하는 어떤 언어 세트에서든, 어떤 Script Form에서도 사용할 수 있습니다.
• 컴포넌트(컨트롤 객체)에는 Script Form에서 사용할 수 있는 메서드, 속성, 이벤트가 있습니다.
  • 메서드(Methods)는 객체가 수행할 수 있는 동작입니다.
  • 속성(Properties)은 객체에 포함된 데이터로, 접근하거나 수정할 수 있습니다.
  • 이벤트(Events)는 Script Form의 컴포넌트가 반응할 수 있는 조건입니다.
• Script Form에는 폼 버튼 클릭과 같이 캡처된 조건을 처리하는 이벤트 핸들러가 있습니다.

Altium Designer 스크립트 예제

예제 및 참조 스크립트는 객체 인터페이스, 메서드, 프로세스, 속성, 컴포넌트가 스크립트에서 어떻게 적용되는지 이해하는 데 유용한 자료입니다. 또한 자체 스크립트 프로젝트의 기반으로 사용할 수도 있습니다.

예제 실행하기

Altium Designer에서 스크립트 예제를 빠르게 실행하려면, 먼저 예제 스크립트 폴더 중 하나에서 예제 프로젝트 또는 개별 스크립트 파일을 여십시오. 예를 들어 Scripts\Delphiscript Scripts\General 폴더에 있는 간단한 'Hello World' 프로젝트(HelloWorld.PRJSCR)가 있습니다.

Projects panel에서 DelphiScript Hello World 프로젝트가 열린 모습.

이 프로젝트에는 'Hello World' 스크립트의 두 가지 버전이 포함되어 있으며, 두 번째(HelloWorlDialog.pas)는 Form 유닛의 기본 사용법을 보여줍니다. 스크립트 이름을 더블 클릭하면 편집기에서 스크립트를 열어 확인할 수 있습니다. 단, 스크립트는 편집기에서 열려 있지 않아도 실행할 수 있습니다.

스크립트 중 하나를 실행하려면 메인 메뉴에서 File » Run Script를 선택한 다음, Select Item To Run 대화상자에서 사용 가능한 스크립트 프로시저를 선택하십시오. 버전을 실행하면 메시지를 표시하는 대화상자가 열립니다.

예제 스크립트를 빠르고 간단하게 실행하는 방법.

스크립팅 시스템 설정

환경설정

스크립팅 시스템의 기본 환경설정은 Preferences 대화상자에서 구성할 수 있으며, 이 대화상자는 디자인 공간 오른쪽 상단의 컨트롤 버튼을 클릭하여 열 수 있습니다.

일반 환경설정

Preferences dialog의 Text Editors – General 페이지에서는 문자열 검색 동작, 탭/들여쓰기 방식, 키 매핑, 기타 여러 고급 옵션 등 스크립트 편집 요구사항을 설정할 수 있습니다.

Preferences dialog

Color Preferences의 Text Editors – General 페이지

색상 환경설정

Preferences dialog의 Text Editors – Colors 페이지에서는 선택한 스크립팅 언어에 대한 Script Editor의 구문 색상 지정(syntax coloring)을 구성하고, 스크립트 편집기 내 요소의 색상을 설정할 수 있습니다. 예를 들어 배경은 검정, 주석 키워드는 흰색 등으로 설정할 수 있습니다.

Preferences dialog

Display Preferences의 Text Editors – Colors 페이지

표시 환경설정

Preferences dialog의 Text Editors – Display 페이지에서는 오른쪽 여백 및 줄 번호 표시, 구문 강조 표시, 코드 아웃라이닝 등 스크립트의 시각적 기능을 구성할 수 있습니다.

Preferences dialog

Global Projects Preferences의 Text Editors – Display 페이지

전역 프로젝트 환경설정

Preferences dialog의 Scripting System – Global Projects 페이지에는 사용 가능한(설치된) 스크립트 프로젝트 목록이 표시됩니다. 스크립트 프로젝트는 설치, 제거 또는 순서 변경이 가능합니다.

Preferences dialog

Form Designer Preferences의 Scripting System – Global Projects 페이지

폼 디자이너 환경설정

Preferences dialog의 Scripting System – Form Designer 페이지에서는 스크립팅 폼 문서에 대한 그리드 및 컴포넌트 디자인레이터 옵션을 제공합니다.

Preferences dialog의 Scripting System – Form Designer 페이지