DelphiScript와 Delphi의 차이점

개요

DelphiScript는 Delphi와 유사한 구문을 사용하지만, Altium Designer용 스크립트를 작성할 때 변수, 루틴, 집합, 클래스를 처리하는 방식에는 중요한 차이가 있습니다. 이 문서에서는 이러한 차이점과 지원되지 않는 언어 기능을 설명하고, 스크립트에서 기존 클래스와 Altium Designer API 인터페이스를 사용하는 방법을 소개합니다. DelphiScript가 지원하는 기능을 명확히 이해하고 자신 있게 스크립트를 수정할 수 있도록 계속 읽어보세요.

- Variant 기반 변수, 런타임 형 변환, 그리고 이러한 특성이 테스트와 성능에 미치는 영향을 이해합니다.
- 배열, 집합 연산자, 중첩 루틴, 예외 처리 등 Delphi 기능 중 지원되지 않거나 다르게 동작하는 기능을 알아봅니다.
- PCB에 비아를 생성하는 예제를 통해 기존 클래스와 Altium Designer 객체 인터페이스를 사용하는 방법을 살펴봅니다.
AI로 더 깊이 알아보기:

DelphiScript와 Delphi의 차이점

이 섹션에서는 DelphiScript 스크립팅 언어와 Embarcadero의 Delphi 프로그래밍 언어 간의 주요 차이점과 이러한 차이점이 Altium Designer API에 어떻게 적용되는지 설명합니다.

Altium Designer 스크립팅 시스템은 비타입 언어인 DelphiScript를 사용하므로 스크립트에는 데이터 타입이 없습니다. 가독성을 위해 변수와 해당 타입을 선언하고 함수/프로시저 또는 메서드 파라미터의 타입을 지정할 수 있지만, DelphiScript는 스크립트 실행 시 선언되지 않은 변수를 변환합니다. 따라서 예를 들어 레코드나 클래스를 정의할 수 없습니다.

DelphiScript 변수

스크립트의 모든 변수는 Variant 타입이며, 변수 선언의 타입은 무시되므로 생략할 수 있습니다. 따라서 다음 세 가지 선언은 모두 올바릅니다.

Var
a : Integer;
 
Var
b : Integer;
 
Var
  c, d;

프로시저/함수 선언의 파라미터 타입도 무시되므로 생략할 수 있습니다. 예를 들어 다음 코드는 올바릅니다.

Function Sum(a, b) : Integer;
Begin
  Result := a + b;
End;

일반적으로 Variant는 모든 데이터 타입을 저장하고 다양한 연산과 타입 변환을 수행하는 데 사용할 수 있습니다. Variant의 타입 검사와 계산은 런타임에 수행됩니다. 컴파일러는 코드에서 발생할 수 있는 오류에 대한 경고를 제공하지 않으며, 이러한 오류는 광범위한 테스트를 통해서만 발견할 수 있습니다. 전반적으로 Variant를 사용하는 코드 부분은 많은 연산이 런타임에 이르러서야 결정되므로 인터프리트되는 코드로 볼 수 있습니다. 이는 코드 실행 속도에 영향을 줄 수 있습니다.

따라서 Variant 변수를 선언하고 Variant 값을 할당한 후에는 호환되는 데이터 타입이나 호환되지 않는 데이터 타입으로 복사할 수 있습니다.

Var
V;
Begin
  // variable V can be assigned values of several different types:
  V := 10;
  V := 'Hello, World';
  V := 45.55;
End;

변수에 호환되지 않는 데이터 타입이 할당되면 DelphiScript 인터프리터는 가능한 경우 변환을 수행합니다. 그렇지 않으면 런타임 오류가 발생합니다. 실제로 Variant는 데이터와 함께 타입 정보를 저장하므로, DelphiScript는 동일한 기능을 수행하는 Embarcadero Delphi 컴파일 코드보다 느립니다.

스크립트의 집합

집합 타입과 집합 연산자를 지원하는 Delphi 언어와 달리, DelphiScript에는 집합 타입이 없으며 집합 연산자도 지원하지 않습니다.

DelphiScript 스크립트에서 집합을 사용하려면 스크립트에서 집합을 조작하는 내장 함수를 사용하세요.

자세한 내용은 DelphiScript에서 집합 사용하기 항목을 참조하세요.

내부 함수 또는 프로시저

함수 또는 프로시저 inside 내에서 함수와 프로시저를 사용하려는 경우, 독립적인 함수/프로시저로 작성하는 것이 권장됩니다. 다만 재귀 프로시저/함수도 허용됩니다.

다음 함수 코드 조각은 권장되지 않습니다.

Function A
Function B
Begin
// blah
End;
Begin
B;
End;

권장되는 함수 구조:

Function B
Begin
// blah
End;

Function A
Begin
B;
End;

Result 키워드

함수 블록 내에서 반환값을 설정하려면 Result 키워드를 사용하세요. 예:

Function Foo : String;
Begin
Result := 'Foo Foo';
End;

중첩 루틴

중첩 루틴은 지원되지만, 중첩 루틴에서는 최상위 함수의 변수를 사용할 수 없습니다.

배열 요소

배열 요소의 타입은 무시되며 생략할 수 있으므로 다음 두 선언은 동일합니다.

Var
x : array [1..2] of double;

Var
x : array [1..2];

배열 타입을 선언할 수는 없지만, 변수를 배열로 선언할 수는 있습니다.

Illegal example:

Type
TVertices = Array [1..50] Of TLocation;
Var
NewVertices : TVertices;

Legal example:

Var
NewVertices : Array [1..50] of TLocation;

개방형 배열 선언

Open Array 선언은 지원되지 않습니다.

Case 키워드

Case 키워드는 모든 타입에 사용할 수 있습니다. 따라서 다음은 유효합니다.

Case UserName of
'Alex', 'John' : IsAdministrator := true;
'Peter' : IsAdministrator := false;
Else
Raise('Unknown user');
End;

클래스 선언

DelphiScript에서 새 클래스를 정의할 수는 없지만, 기존 DelphiScript 클래스를 사용하고 인스턴스화할 수는 있습니다. 예를 들어 스크립트에서 TList 및 TStringList 클래스를 생성하고 사용할 수 있습니다.
See also
TList
TStringList

CreateObject 함수

CreateObject 함수를 사용하면 더 이상 사용하지 않을 때 자동으로 해제되는 객체를 생성할 수 있습니다.

따라서 다음과 같이 작성하는 대신:

Procedure Proc;
Var
  l;
Begin
    l := TList.Create;
  Try
    // do something with l
  Finally
  L.Free;
End;

...다음과 같이 작성할 수 있습니다.

Procedure Proc;
Var
  l;
Begin
  l := CreateObject(TList);
  // Do something with l
End;

See also
CreateObject 함수.

예외 발생시키기

Raise 키워드를 파라미터 없이 사용하면 마지막 예외를 다시 발생시킬 수 있습니다. Raise에 문자열 파라미터를 전달하면 지정된 메시지 문자열로 예외를 발생시킬 수도 있습니다. DelphiScript에서는 On 키워드가 지원되지 않으므로 Exception 객체가 지원되지 않습니다.

Example:

Raise(Format('Invalid value : %d', [Height]));

See also
Try, Finally 및 Raise 키워드.

ThreadVar

DelphiScript에서 Threadvar 키워드는 Var로 처리됩니다. Embarcadero Delphi에서는 Threadvar 키워드를 사용하여 선언한 변수가 스레드마다 서로 다른 값을 갖는다는 점에 유의하세요.

집합 연산자

집합 연산자 In은 지원되지 않습니다. InSet 연산자를 사용하면 특정 값이 집합의 원소인지 확인할 수 있습니다. 예:

If InSet(fsBold, Font.Style) then
ShowMessage('Bold');

Delphi 집합 연산자 +, -, *, <=, >=은 올바르게 작동하지 않습니다. 대신 DelphiScript 내장 함수 MkSet, MkSetRange, SetUnion, SetDifference, SetIntersection, SubSet and InSet을 사용합니다.

ASet := BSet + CSet; \\ should be changed to
ASet := SetUnion(BSet, CSet);

[...] 집합 생성자는 지원되지 않습니다. 집합을 생성하려면 MkSet 함수를 사용하세요.:

Font.Style := MkSet(fsBold, fsItalic); 

See also
MkSet 키워드
MkSetRange 키워드
InSet 키워드
SetDifference 키워드
SetIntersection 키워드
SetUnion 키워드
SubSet 키워드
InSet 키워드

연산자

^ 및 @ 연산자는 지원되지 않습니다.

지시문

다음 지시문은 지원되지 않습니다. 일부는 더 이상 사용되지 않으며 Embarcadero Delphi에서도 지원되지 않습니다. absolute, abstract, assembler, automated, cdecl, contains, default, dispid, dynamic, export, external, far, implements, index, message, name, near, nodefault, overload, override, package, pascal, private protected, public, published, read, readonly, register, reintroduce, requires, resident, safecall, stdcall, stored, virtual, write, writeonly.

또한 Uses 절의 in 지시문은 무시됩니다.

무시되는 키워드

DelphiScript에서는 interface, implementation, program 및 unit 키워드가 무시됩니다. 스크립트에 이러한 키워드가 포함될 수는 있지만 아무런 효과가 없습니다. 다만 이러한 키워드는 스크립트의 가독성을 높일 수 있습니다.

지원되지 않는 키워드

DelphiScript에서는 다음 키워드가 지원되지 않습니다.

  • as, asm, class, dispinterface, exports, finalization, inherited, initialization, inline, interface, is, library, object, out, property, record, resourcestring, set, supports, type.

DelphiScript에서는 다음 Delphi RTL 함수가 지원되지 않습니다.

  • Abort, Addr, Assert, Dec, FillChar, Finalize, Hi, High, Inc, Initialize, Lo, Low, New, Ptr, SetString, SizeOf, Str, UniqueString, VarArrayRedim, VarArrayRef, VarCast, VarClear, VarCopy.

Delphi의 Windows 유닛(windows.pas 파일)에 포함된 함수는 지원되지 않습니다. 예를 들어 RGB 함수는 지원되지 않습니다.

스크립트에서 Altium Designer API 사용하기

DelphiScript를 사용하여 자체 레코드나 클래스 타입을 생성하고 스크립트에서 인스턴스화할 수는 없지만, Altium Designer API의 특정 클래스는 사용할 수 있습니다. 예를 들어 TStringList 및 TList 클래스를 인스턴스화하여 스크립트의 요구에 맞게 데이터 저장용 컨테이너로 사용할 수 있습니다. 일반적으로 이러한 컨테이너에는 동일한 타입의 데이터를 저장합니다.

Altium Designer 객체를 나타내는 API의 객체 인터페이스를 스크립트에서 사용할 수 있습니다. 예를 들어 Schematic 객체 인터페이스와 PCB 객체 인터페이스를 사용하여 Schematic 및 PCB 문서의 설계 객체를 업데이트할 수 있습니다.

관례상 인터페이스 이름 앞에는 'I'를 붙입니다. 예를 들어 IPCB_Board는 기존 PCB 문서의 인터페이스를 나타냅니다.

스크립트에서 PCB 인터페이스를 사용하는 예:

Procedure ViaCreation;
Var
  Board : IPCB_Board;
  Via : IPCB_Via;
Begin
  Board := PCBServer.GetCurrentPCBBoard;
  If Board = Nil Then Exit;
 
  (\* Create a Via object\* )
  Via           := PCBServer.PCBObjectFactory(eViaObject, eNoDimension, eCreate_Default);
  Via.X         := MilsToCoord(7500);
  Via.Y         := MilsToCoord(7500);
  Via.Size      := MilsToCoord(50);
  Via.HoleSize  := MilsToCoord(20);
  Via.LowLayer  := eTopLayer;
  Via.HighLayer := eBottomLayer;
 
  (* Put this via in the Board object*)
  Board.AddPCBObject(Via);
End;

스크립트에서 사용할 수 있는 API는 다음과 같습니다.

  • 일부 Embarcadero Delphi™ 함수 및 클래스와 DelphiScript 확장 기능
  • Client API
  • PCB Server API
  • Schematic Server API
  • 워크스페이스 Manager Server API
  • Integrated Library API
  • Altium Designer API 함수
  • 파라미터 기반 프로세스

추가 정보

다운로드 가능한 스크립트 모음에서 Altium Designer 객체 인터페이스 및 함수와 Delphi 객체 및 함수가 스크립트에서 어떻게 사용되는지 확인하세요.

Altium Designer용 스크립트 작성에 대한 자세한 내용은 기본 스크립팅 문서를 참조하세요.

스크립트에서 설계 객체와 해당 인터페이스를 사용하는 방법에 대한 자세한 내용은 Altium Designer API 사용 가이드를 참조하세요.

Altium Designer API의 종류와 스크립트용 인터페이스 객체에 대한 자세한 내용은 Altium Designer API 참조를 참조하세요.

AI-LocalizedAI로 번역됨
만약 문제가 있으시다면, 텍스트/이미지를 선택하신 상태에서 Ctrl + Enter를 누르셔서 저희에게 피드백을 보내주세요.
Nav
Contents
기능 가용성

사용할 수 있는 기능은 보유한 Altium 솔루션(Altium Develop, Altium Agile Teams, Altium Agile Enterprise, 또는 Altium Designer(활성 기간 중))에 따라 달라집니다.

실제 소프트웨어에서 문서화된 기능이 보이지 않는 경우, Altium 영업팀에 문의하여 자세한 내용을 확인하세요.

구버전 문서

Altium Designer 문서는 더 이상 버전별로 제공되지 않습니다. 이전 버전의 Altium Designer 문서가 필요하신 경우, Other Installers 페이지의 Legacy Documentation 섹션을 방문해 주세요.

Contents