Tcl 명령 참조

대소문자 구분 및 슬래시

다음 명령어는 대소문자를 구분합니다. 경로를 지정할 때는 슬래시(/)를 사용하십시오.

정보

개별 명령어의 파라미터를 설명하기 위해 아래에서 사용된 표기법은 Wirth 구문 표기법(WSN)을 기반으로 합니다.

• 중괄호 안에 있는 파라미터 이름은 명령줄에서 이 파라미터에 대해 값을 지정하지 않거나, 하나의 값 또는 여러 값을 지정할 수 있음을 나타냅니다.
• 대괄호 안에 있는 파라미터 이름은 선택적 파라미터를 나타냅니다.

디자인 생성, 로드 및 저장

LoadDesign

명령 구문
LoadDesign FileName

디자인 로드 명령 FileName. 지정합니다. FileName 파일 시스템의 파일 경로와 파일 이름 자체입니다. 파일 확장자(*.va 또는 *.tcl)를 지정하는 것을 잊지 마십시오. 디자인 파일 경로를 나타내려면 슬래시를 사용하십시오.

예: LoadDesign c:/VA_TCL/BaseAreaGray8.va

이미 로드된 디자인이 있는 경우: 다음 명령을 통해 현재 로드된 디자인을 닫습니다. CloseDesign 명령을 사용하기 전에 LoadDesign.

CreateDesign

명령 구문
CreateDesign Name Platform

하드웨어 플랫폼 Platform에 대해 Name이라는 이름으로 새 디자인을 생성하는 명령어입니다. 디자인의 타겟 플랫폼을 지정하려면 다음 중 하나를 사용할 수 있습니다.

• 플랫폼용 VisualApplets 라이브러리 이름(예: "iF-CXP12-Q"), 또는
• 플랫폼의 전체 이름 (예: "imaFlex CXP-12 Quad"). 공백이 포함된 인수에 대해 Tcl 구문에서 요구하는 대로 전체 이름을 따옴표로 감싸는 것을 잊지 마십시오.

이름에 대문자를 사용하는 것은 영향을 미치지 않습니다.

SaveDesign

명령 구문
SaveDesign FileName [SaveOption]

다음 위치에 디자인을 저장하는 명령입니다. FileName. 지정합니다. FileName 파일 경로와 파일 이름입니다. 디자인 파일 경로를 나타낼 때는 슬래시를 사용하세요.

파일 이름에 파일 확장자를 추가하는 것을 잊지 마세요.

• 파일 확장자로 ".va"를 지정하면 디자인이 표준 VisualApplets 디자인 형식으로 저장됩니다. 파일의 모든 내용이 저장됩니다. VisualApplets 디자인의 기본 데이터 형식으로 *.va 파일 형식을 사용하십시오.
• 다음에서 파일 확장자 ".tcl"을 지정하는 경우 FileName, Tcl 스크립트가 내보내집니다. 디자인의 일부 내용은 내보내지지 않을 수 있습니다.

기존 파일을 덮어쓰려면 선택적 파라미터를 설정하세요. SaveOption 에서 overwrite.

Tcl 스크립트로 내보내는 동안 다음 정보가 손실됩니다.

• 사용자 라이브러리 요소 인스턴스에서 수행한 로컬 수정 사항(주변 디자인에 인스턴스를 맞추기 위한 것)은 손실됩니다. Tcl 스크립트를 VisualApplets로 다시 가져오면 해당 인스턴스는 사용자 라이브러리의 새로운 복사본으로 삽입됩니다. 디자인 내 인스턴스의 내용은 Tcl로 저장되지 않았습니다.
• 정보 상자의 텍스트 내용은 Tcl 형식으로 유지됩니다. 그러나 정보 상자의 서식은 손실됩니다.

ChangePlatform

명령 구문
ChangePlatform Platform FileName [SaveOption]

현재 디자인을 다른 하드웨어 플랫폼으로 변환하고 Platform 변환된 디자인을 다음과 같이 저장하는 명령입니다. FileName.

사용 가능한 모든 하드웨어 플랫폼에 대한 개요를 보려면 다음을 입력하십시오. ChangePlatform ? - 사용 가능한 모든 하드웨어 플랫폼의 이름 목록이 반환됩니다. 현재 선택된 하드웨어 플랫폼이 목록의 첫 번째 항목에 표시됩니다.

파라미터에서 원하는 하드웨어 플랫폼의 이름을 지정합니다. Platform. 디자인의 타겟 플랫폼을 지정하려면 다음 중 하나를 사용할 수 있습니다.

• 플랫폼용 VisualApplets 라이브러리 이름(예: "iF-CXP12-Q"), 또는
• 플랫폼의 전체 이름(예: "imaFlex CXP-12 Quad").

이름에 대문자를 사용해도 아무런 영향이 없습니다. 다음에서 지정하십시오. FileName 파일 경로(슬래시 사용), 파일 이름 및 파일 확장자입니다. 기존 파일을 덮어쓰려면 선택적 파라미터를 설정하세요. SaveOption 에서 overwrite.

CloseDesign

명령 구문
CloseDesign [Mode]

현재 열려 있는 디자인을 닫는 명령입니다.

선택적 파라미터를 설정하는 경우 Mode 에서 Discard, 저장하지 않은 변경 사항이 있더라도 디자인이 닫힙니다. 저장되지 않은 변경 사항은 취소됩니다.

사용하는 경우 CloseDesign 파라미터를 사용하지 않고 Mode 아직 저장하지 않은 변경 사항이 디자인에 포함되어 있더라도 명령이 종료되고 관련 오류 메시지가 표시됩니다.

SetDesignProperty

명령 구문
SetDesignProperty Key Value

현재 로드된 디자인에 대한 design properties를 입력하려면 이 명령을 사용합니다.

사용할 수 있는 네 가지 키는 다음과 같습니다.

• ProjectName (프로젝트에 부여하려는 이름)
• Version (디자인 버전)
• Description (프로젝트 설명).

• TargetRuntime (프레임 그래버에서 이 애플릿을 실행하는 호스트 PC에서 사용할 운영 체제를 여기에 지정합니다.)

  다음 값들이 허용됩니다.

  • Win64
  • Win32
  • Linux64
  • Linux32

예:

SetDesignProperty TargetRuntime Win64

SetDesignClock

명령 구문
SetDesignClock NewFrequency

FPGA의 기본 클록 주파수(MHz)를 설정하기 위한 명령입니다.

디자인 개발

CreateProcess

명령 구문
CreateProcess

새 프로세스를 생성하기 위한 명령입니다. VisualApplets은 새 프로세스에 자동으로 번호를 지정합니다.

DeleteProcess

명령 구문
DeleteProcess ProcName

다음 이름의 프로세스를 삭제하기 위한 명령입니다. ProcName.

예: DeleteProcess Process1

CreateModule

명령 구문
CreateModule OperatorType FullModuleName [InPortMultiplicity [OutPortMultiplicity {NamedPortMultiplicity}]]xPos yPos

연산자의 인스턴스(모듈)를 생성하는 명령어 OperatorType, 그리고 디자인 창에서 모듈의 위치를 지정하기 위해.

에서 OperatorType, 인스턴스를 생성할 특정 오퍼레이터의 이름을 간단히 명시하십시오. 오퍼레이터가 속한 라이브러리를 지정할 필요는 없습니다.

을(를) 사용하면 FullModuleName 디자인 내에서 모듈의 계층적 위치를 정의합니다.

FullModuleName 다음과 같은 구문을 가집니다.

<HierLevelPath>/<ModuleName>

• HierLevelPath 디자인의 특정 계층 수준으로 가는 경로를 정의하는 데 사용합니다. 프로세스 수준에서 시작하며 슬래시(/)를 사용하십시오.
• ModuleName 모듈에 지정할 이름을 정의하는 데 사용합니다. 또는 ModuleName 을(를) 비워둘 수 있습니다. 이 경우 다음을 종료해야 합니다. FullModuleName 을(를) 슬래시로 끝나도록 해야 하며, 모듈 이름은 자동으로 지정됩니다.

파라미터를 통해 디자인 창에서 모듈의 위치를 정의합니다. xPos 및 yPos.

예:

CreateModule CxpCamera Process0/cam 123 163

함수의 반환 값은 CreateModule 은(는) FullModuleName (즉, 모듈 이름을 포함하여 모듈에 이르는 전체 계층적 경로).

선택적 파라미터 사용 InPortMultiplicity 및 OutPortMultiplicity:

많은 오퍼레이터는 고정된 수의 포트로 인스턴스화됩니다. 반면 포트 수가 가변적인 오퍼레이터도 있습니다. 포트 수가 가변적인 오퍼레이터를 인스턴스화할 때 모듈이 가질 포트 수를 정의할 수 있습니다.

예를 들어 오퍼레이터 BRANCH을(를) 인스턴스화할 때 인스턴스가 가질 출력 포트 수를 정의할 수 있습니다.

따라서 출력 포트 O의 개수는 가변적입니다. 포트 수가 가변적인 포트를 멀티포트라고 합니다.

Multiport는 기본 이름을 통해 식별됩니다. 예를 들어 BRANCH에서 출력 포트의 기본 이름은 O입니다. 기본 이름에 추가되는 인덱스를 통해 특정 포트를 식별하고 주소를 지정할 수 있습니다.

명령어 CreateModule, 선택적 값 쌍을 사용할 수 있습니다. InPortMultiplicity 및 OutPortMultiplicity 모듈의 벡터 입력 및 벡터 출력의 다중성을 지정합니다. 이렇게 하면 예를 들어 다음과 같은 가변적인 수의 포트를 가진 오퍼레이터의 인스턴스(모듈)에서 포트 수를 정의할 수 있습니다. BRANCH 또는 ADD.

예:

CreateModule BRANCH Process0/branchz 1 3 43 123

Defaults: 사용하지 않는 경우 InPortMultiplicity 및 OutPortMultiplicity, 또는 0으로 설정하면 모듈이 기본 입력 및 출력 포트 수로 생성됩니다(즉, 두 값 중 하나 또는 둘 다를 다음과 같이 설정하는 경우). 0 입력 포트나 출력 포트가 0개가 되는 것은 아닙니다.). 기본적으로 생성되는 포트 수는 오퍼레이터 유형에 따라 다릅니다.

예시:

CreateModule BRANCH Process0/branch 43 123

기본 포트 수인 1개의 입력 포트와 2개의 출력 포트가 생성됩니다.

CreateModule BRANCH Process0/branch3 0 3 43 123

1개의 입력 포트(기본값)와 3개의 출력 포트가 생성됩니다.

CreateModule BRANCH Process0/branch3 3 3 43 123

1개의 입력 포트와 3개의 출력 포트가 생성됩니다. 오퍼레이터 유형상 1개의 입력만 허용되므로 3개의 입력 포트 정의는 무시됩니다.

CreateModule BRANCH Process0/branch4 0 4 43 123

선택적 파라미터 NamedPortMultiplicity: 다양한 종류의 멀티포트가 있는 오퍼레이터(즉, 입력 I 또는 출력 O 이외의 멀티포트를 가진 오퍼레이터)의 경우, 파라미터를 사용할 수 있습니다. NamedPortMultiplicity 모듈에 적용할 멀티포트의 기본 이름을 지정하고 이 멀티포트의 다중성(수)을 지정합니다. 형식은 다음과 같습니다. NamedPortMultiplicity 은(는) MultiportBaseName:Number. 다음을 사용할 수 있습니다. NamedPortMultiplicity 한 명령 줄에서 여러 번. 사용 NamedPortMultiplicity 파라미터에서 지정했을 수 있는 모든 내용을 무시합니다. InPortMultiplicity 또는 OutPortMultiplicity.

예:

CreateModule BRANCH Process0/branch 0 0 O:3 100 100

예시 명령어는 다음과 같이 변환됩니다: 연산자의 인스턴스(모듈)를 생성합니다 BRANCH. 최상위 수준의 process 0에 배치하고 이름을 branch로 지정합니다. 세 개의 출력 포트(멀티포트 기본 이름 O)를 제공하고 디자인 창의 y=100픽셀, x=100픽셀 위치에 모듈을 배치합니다.

대상: MultiportBaseName, VA GUI에서 확인되는 멀티포트의 기본 이름을 사용합니다. 해당 MultiportBaseName 이름은 가변적인 수의 포트를 가진 연산자를 인스턴스화할 때 나타나는 대화 상자에 표시됩니다. 멀티포트 기본 이름은 멀티포트의 단축 이름(GUI에 괄호 안에 표시됨)입니다.

여기서 멀티포트 기본 이름은 다음과 같습니다 I.

또한 포트에 마우스를 올렸을 때 표시되는 정보에서도 멀티포트 기본 이름을 확인할 수 있습니다:

여기서 멀티포트 기본 이름은 I입니다(멀티포트의 개별 인스턴스를 식별하는 I 인덱스가 뒤에 붙음).

InstUserLibOperator

명령 구문
InstUserLibOperator LibName OperatorName FullModuleName xPos yPos

사용자 라이브러리 요소를 인스턴스화하기 위한 명령어입니다. 파라미터를 통해 사용자 라이브러리를 지정하고, LibName파라미터를 통해 라이브러리 내 요소(오퍼레이터)의 이름을 지정하며, OperatorName파라미터를 통해 디자인에서 모듈에 지정할 이름과 계층 구조 내 배치 위치를 지정합니다. FullModuleName디자인 창에서의 모듈 위치뿐만 아니라 파라미터를 통해 xPos및 YPos.

InstCustomLibOperator

명령 구문
InstCustomLibOperator LibName OperatorName FullModuleName xPos yPos

사용자 지정 라이브러리 요소를 인스턴스화하기 위한 명령어입니다. 파라미터를 통해 사용자 라이브러리를 지정하고, LibName파라미터를 통해 라이브러리 내 요소(오퍼레이터)의 이름을 지정하며, OperatorName파라미터를 통해 디자인에서 모듈에 지정할 이름과 계층 구조 내 배치 위치를 지정합니다. FullModuleName디자인 창에서의 모듈 위치뿐만 아니라 파라미터를 통해 xPos및 YPos.

DeleteModule

명령 구문
DeleteModule FullModuleName

모듈을 삭제하기 위한 명령어입니다. FullModuleName.

FullModuleName 다음과 같은 구문을 가집니다. <HierLevelPath>/<ModuleName>.

• HierLevelPath 모듈이 위치한 디자인의 계층 수준에 대한 경로를 지정하는 데 사용합니다. 프로세스 수준에서 시작합니다. 슬래시(/)를 사용하세요.
• ModuleName 삭제하려는 모듈의 이름을 지정하는 데 사용합니다.

시뮬레이션 모듈은 이 명령어로 삭제할 수 없습니다. 시뮬레이션 모듈을 삭제하려면 다음 명령어를 사용하세요. DeleteSimModule.

ConnectModules

명령 구문
ConnectModules FromModule FromModuleOutputPort ToModule ToModulePort [x1 [y2 x3]]

모듈 포트를 연결하기 위한 명령어입니다.

파라미터 FromModule 및 ToModule 다음 구문을 가진 계층적 이름입니다: <HierLevelPath>/<ModuleName>.

내부 계층적 상자 노드(즉, 계층적 상자 포트를 연결하기 위한 내부 노드)는 접두사를 통해 INBOUND# 또는 OUTBOUND#.

예시식별됩니다: 아래 그림에 있는 계층적 상자의 두 인바운드 노드는 다음으로 지정해야 합니다 INBOUND#I000 및 INBOUND#I001.

선택적 파라미터를 통해 x1, y2및 x3 연결 폴리곤의 지오메트리를 정의할 수 있습니다. 다음 위치에서 시작하는 수평선: FromModuleOutputPort X 위치까지 x1, Y 위치까지의 수직선 y2, X 위치까지의 수평선 x3, 수직선의 높이: ToModulePort, 수평선의 위치: ToModulePort.

예:

ConnectModules Process0/CxpCamera O Process0/FrameBufferMultiRoi I 90 500 120

DisconnectModules

명령 구문
DisconnectModules FullModuleName ModulePort

포트에 연결된 링크를 삭제하는 명령 ModulePort 모듈의 FullModuleName.

예:

DisconnectModules Process0/Cam1 O

CreateComment

명령 구문
CreateComment FullBoxName Text xPos yPos

코멘트 박스를 생성하는 명령입니다.

구문 FullBoxName 은(는) <HierLevelPath>/<BoxName>.

• HierLevelPath 디자인의 특정 계층 수준으로 가는 경로를 정의하는 데 사용합니다. 프로세스 수준에서 시작하며 슬래시(/)를 사용하십시오.
• BoxName 주석 상자에 지정할 이름을 설정하는 데 사용합니다. 또는 비워 둘 수도 있습니다 BoxName 을(를) 비워둘 수 있습니다. 이 경우 다음을 종료해야 합니다. FullBoxName 을(를) 슬래시로 끝나도록 해야 하며, 모듈 이름은 자동으로 지정됩니다.

예:

CreateComment Process0/MyComment "This is my comment." 400 400

코멘트 박스 내용으로 Text Unicode 문자를 사용할 수 있습니다. 주석은 반드시 따옴표로 묶어 설정해야 합니다. ASCII에 포함되지 않은 문자를 사용하는 경우, 유니코드를 나타내는 해당 TCL 구문을 사용하십시오(예:

[encoding convertfrom utf-8 "A-Umlaut: \xc3\x84"]

디자인 창에서 주석 상자의 위치는 다음 파라미터를 통해 정의합니다. xPos 및 yPos.

함수의 반환 값은 CreateComment 은(는) FullBoxName (코멘트 박스 이름을 포함한 코멘트 박스의 전체 계층 경로)입니다.

DeleteComment

명령 구문
DeleteComment FullBoxName

주석 상자 삭제 명령어 FullBoxName.

구문 FullBoxName 은(는) <HierLevelPath>/<BoxName>.

• HierLevelPath 주석 상자가 위치한 디자인의 계층 수준에 대한 경로를 지정하는 데 사용합니다. 프로세스 레벨에서 시작하며, 슬래시(/)를 사용합니다.
• BoxName 삭제하려는 주석 상자의 이름을 지정하는 데 사용합니다.

예:

DeleteComment Process0/MyComment

상자 이름 정보: 삭제하려는 주석 상자의 이름을 확인하려면 TCL을 사용하여 디자인에 배치된 상자를 조회할 수 있습니다. VisualApplets 설치 폴더의 TCL 예제 QueryDesign.tcl을 참고하십시오. <VA installation directory>\Examples\AdvancedVAFunctions\Tcl Scripting\QueryDesign.tcl.

Parameterizing Operators and Links

SetModuleParam

명령 구문
SetModuleParam FullModuleName ParameterName [FieldIndex] Value {OtherValues}

모듈 파라미터를 설정하는 명령입니다.

정보

이 명령어는 존재하는 파라미터에 특정 값을 설정할 때만 사용해야 합니다. 메타데이터 파라미터를 생성하는 데는 이 명령어를 사용할 수 없습니다. (새 메타데이터 파라미터를 생성하려면 명령어 SetParamString 을(를) 대신 사용하십시오.)

예:

SetModuleParam Process0/HierchBox1/module6 XLength 512

필드 파라미터: 필드 파라미터를 참조하는 경우, 파라미터를 지정해야 합니다. FieldIndex 지정하기 전에 Value. 필드 파라미터를 참조하는 경우에만 다음 이후에 추가 값을 지정할 수 있습니다. Value.

필드 파라미터 편집 예제:

명령어 입력 전:

명령 입력

SetModuleParam Process0/module3 LUTcontent 4 12 13 14

의 결과는 다음과 같습니다.

명령 SetModuleParam (사용하는 파라미터에 따라) 명령어와 동일한 기능이 있습니다. SetParamInt, SetParamFloat, SetParamEnum, SetParamString, SetParamIntField및 SetParamFloatField. 하지만 이 명령어들은 내보내기 전용입니다.

설정하려는 속성을 식별하려면 SetModuleParam 스크립트를 수동으로 작성할 때.

예외: 새로운 메타데이터 파라미터를 추가하려는 경우, 수동으로 스크립트를 작성할 때 다음을 사용해야 합니다. SetParamString 명령어 정의 참조 SetParamString.

SetModuleParamProperty

명령 구문
SetModuleParamProperty FullModuleName ParameterName PropertyName PropertyValue {OtherPropertyValue}

모듈 파라미터의 속성을 변경하기 위한 명령어입니다. 이 명령어는 다음을 대체할 수 있습니다. SetModuleParamType. 개별 속성 이름은 여러 개의 값을 가질 수 있습니다. 다음 속성을 변경할 수 있습니다.

access: 여기에 여러 플래그를 값으로 나열할 수 있습니다.

• write: 매개변수를 이 방향으로 전환할 수 있는 경우(예: 연산자 LinkParamTranslator), 쓰기 매개변수가 됩니다.
• read: 매개변수를 이 방향으로 전환할 수 있는 경우(예: 연산자 LinkParamTranslator), 읽기 매개변수가 됩니다.
• dynamic: 파라미터가 동적이거나 정적일 수 있는 경우, 이로 인해 동적 파라미터가 됩니다(이는 명령어를 대체합니다. SetParamDynamic).
• static: 파라미터가 동적이거나 정적일 수 있는 경우, 이로 인해 정적 파라미터가 됩니다(이는 명령어를 대체합니다. SetParamStatic).

position: 파라미터에 대한 정수 값 정의 PropertyValue, 계층적 상자의 파라미터 목록에서 파라미터의 위치를 정의합니다.

SetParamInt

명령 구문
SetParamInt FullModuleName ParameterName Value

TCL 내보내기에만 사용됩니다. 정수 매개변수를 설정하는 명령어입니다.

정보

이 명령어는 VisualApplets에서 *.tcl 파일로 TCL을 내보낼 때 사용됩니다.

직접 작성하는 스크립트에서는 이 명령어를 사용하지 마십시오. 명령어를 사용하십시오. SetModuleParam 명령을 사용하십시오.

SetParamFloat

명령 구문
SetParamFloat FullModuleName ParameterName Value

TCL 내보내기에만 사용됩니다. 부동 소수점 매개변수를 설정하는 명령어입니다.

정보

이 명령어는 VisualApplets에서 *.tcl 파일로 TCL을 내보낼 때 사용됩니다.

직접 작성하는 스크립트에서는 이 명령어를 사용하지 마십시오. 명령어를 사용하십시오. SetModuleParam 명령을 사용하십시오.

SetParamEnum

명령 구문
SetParamEnum FullModuleName ParameterName Value

TCL 내보내기에만 사용됩니다. 주소가 지정된 열거형(enum) 매개변수를 설정하는 명령어입니다. Value 은(는) 열거형 값의 문자열입니다.

예시 (오퍼레이터 인스턴스의 경우 SetSignalStatus 레벨에 배치되며 Process0 이름을 가진 SetSigSt):

SetParamEnum Process0/SetSigSt Mode High

매개변수를 설정합니다 Mode 오퍼레이터의 SetSigSt 위치한 Process0 에서 High.

정보

이 명령어는 VisualApplets에서 *.tcl 파일로 TCL을 내보낼 때 사용됩니다.

직접 작성하는 스크립트에서는 이 명령어를 사용하지 마십시오. 명령어를 사용하십시오. SetModuleParam 명령을 사용하십시오.

SetParamString

명령 구문
SetParamString FullModuleName ParameterName Value

이 명령을 사용하여 특정 모듈의 메타데이터 매개변수를 정의하십시오.

TCL 내보내기 파일에서 명령어 SetParamString 은(는) 기존 모듈 매개변수인 경우에도 모든 문자열 매개변수를 설정하는 데 사용됩니다. 하지만 이는 직접 작성하는 스크립트에서는 실용적이지 않습니다.

정보

직접 스크립트를 작성할 때는, 모듈 매개변수가 문자열 타입인 경우라 하더라도 기존 모듈 매개변수를 새 값으로 설정하기 위해 이 명령어를 사용하지 마십시오.

기존 모듈 매개변수를 새 값으로 설정하려면 항상 명령어를 사용하십시오. SetModuleParam 사용하십시오.

SetParamIntField

명령 구문
SetParamIntField FullModuleName ParameterName Index Value {OtherValues}

TCL 내보내기에만 사용됩니다. 정수 타입의 필드 매개변수를 설정하는 명령어입니다. 필드 설정 Index 에서 Value1지정된 순서대로 다음 필드에 다음 값들이 채워집니다.

정보

이 명령어는 VisualApplets에서 *.tcl 파일로 TCL을 내보낼 때 사용됩니다.

직접 작성하는 스크립트에서는 이 명령어를 사용하지 마십시오. 명령어를 사용하십시오. SetModuleParam 명령을 사용하십시오.

SetParamFloatField

명령 구문
SetParamFloatField FullModuleName ParameterName Index Value {OtherValues}

TCL 내보내기에만 사용됩니다. float 타입의 필드 매개변수를 설정하는 명령어입니다. 필드 설정 Index 에서 Value1지정된 순서대로 다음 필드에 다음 값들이 채워집니다.

정보

이 명령어는 VisualApplets에서 *.tcl 파일로 TCL을 내보낼 때 사용됩니다.

직접 작성하는 스크립트에서는 이 명령어를 사용하지 마십시오. 명령어를 사용하십시오. SetModuleParam 명령을 사용하십시오.

SetParamStatic

명령 구문
SetParamStatic FullModuleName ParameterName

TCL 내보내기에만 사용됩니다. 매개변수를 정적으로 만드는 명령어입니다. 매개변수가 정적 및 동적 모두 가능할 경우, 대부분의 경우 기본적으로 동적으로 설정됩니다. 이러한 매개변수를 정적으로 설정하려면 이 명령어를 사용하십시오.

정보

이 명령어는 VisualApplets에서 *.tcl 파일로 TCL을 내보낼 때 사용됩니다.

직접 작성하는 스크립트에서는 이 명령어를 사용하지 마십시오. 명령어를 사용하십시오. SetModuleParamType 명령을 사용하십시오.

SetParamDynamic

명령 구문
SetParamDynamic FullModuleName ParameterName

TCL 내보내기에만 사용됩니다. 매개변수를 동적으로 만드는 명령어입니다. 매개변수가 동적으로 설정 가능한 경우에만 작동합니다.

정보

이 명령어는 VisualApplets에서 *.tcl 파일로 TCL을 내보낼 때 사용됩니다.

직접 작성하는 스크립트에서는 이 명령어를 사용하지 마십시오. 명령어를 사용하십시오. SetModuleParamType 명령을 사용하십시오.

SetModuleParamType

명령 구문
SetModuleParamType FullModuleName ParameterName TypeFlag {OtherTypeFlags}

매개변수 유형을 변경하기 위한 명령입니다. 다음과 같은 유형 플래그를 사용할 수 있습니다.

• Dynamic: 매개변수가 동적 또는 정적일 수 있는 경우, 이 플래그는 해당 매개변수를 동적 매개변수로 만듭니다(명령어 대체 SetParamStatic).
• Static: 매개변수가 동적 또는 정적일 수 있는 경우, 이 플래그는 해당 매개변수를 정적 매개변수로 만듭니다(명령어 대체 SetParamStatic).

Dynamic 및 Static 상호 배타적입니다.

타입 플래그를 사용할 때 Dynamic 또는 Static이 명령어는 명령어와 동일한 기능을 수행합니다. SetParamStatic 및 SetParamDynamic. 하지만 다음을 사용하십시오: SetModuleParamType 스크립트를 수동으로 작성할 때.

SetLinkParam

명령 구문
SetLinkParam FullModuleName PortName ParameterName Value {OtherParameterName OtherParameterValue}

링크 형식을 구성하는 명령입니다. 링크는 모듈의 연결 노드(포트)를 통해 식별됩니다. 링크 형식 파라미터의 이름은 VisualApplets GUI와 동일합니다.

정보

TCL 스크립트를 수동으로 작성할 때 이 명령은 변경 가능한 파라미터에만 적용할 수 있습니다. 변경할 수 없는 링크 파라미터를 설정하려고 하면 해당 오류 메시지가 표시됩니다:

SetResourceMapping

명령 구문
SetResourceMapping FullModuleName ResourceName [Index] NewMapping

모듈에 대한 리소스 매핑을 변경하는 명령입니다. 리소스 ResourceName 새 인덱스에 매핑됩니다 NewMapping. 모듈이 동일한 유형의 리소스를 여러 개 할당하는 경우, 선택적 파라미터인 Index 을(를) 사용하여 리소스를 선택합니다.

SplitLink

명령 구문
SplitLink FullModuleName PortName [Number]

모듈을 생성하기 위한 명령 BRANCH. 새 분기 모듈은 모듈에서 나가는 링크에 삽입됩니다. FullModuleName 포트 위치: NodeName. 새 분기 모듈에는 Number 개의 출력 포트가 있습니다. 선택적 파라미터를 사용하지 않는 경우 Number, 새 분기 모듈에는 두 개의 출력 포트가 있습니다.

함수의 반환 값은 SplitLink 은(는) FullModuleName 새 분기 모듈의 (모듈 이름을 포함한 모듈의 전체 계층 경로)입니다.

Querying Design Structure and Design Details

GetDesignProperty

명령 구문
GetDesignProperty PropertyName

이 명령은 디자인 속성을 검색합니다. 다음 값을 사용할 수 있습니다 PropertyName:

• ProjectName: 프로젝트 이름
• FileName: 현재 로드된 디자인 파일 *.va의 경로 및 이름
• HardwarePlatform: 대상 하드웨어 플랫폼의 라이브러리 이름(예: iF-CXP12-Q)
• Version: 디자인의 버전입니다.
• Description: 프로젝트에 대한 설명입니다.
• Loaded: 디자인 로드 여부(1 또는 0)

Design property Loaded 은(는) 로드된 디자인이 전혀 없는 상태에서도 요청할 수 있습니다. 이 경우 오류 메시지가 발생하지 않습니다. 디자인이로드되지 않은 상태에서 다른 Design property를 요청하면 오류 메시지가 발생합니다.

GetDesignClock

명령 구문
GetDesignClock

이 명령은 FPGA의 기본 클럭 주파수(MHz)를 반환합니다.

GetProcesses

명령 구문
GetProcesses

이 명령은 디자인의 모든 프로세스 이름이 포함된 목록을 반환합니다.

GetSubModules

명령 구문
GetSubModules HierarchyName

이 명령은 요청된 계층 구조에 있는 모듈의 이름 목록을 반환합니다. HierarchyName.

각 하위 모듈에 대해 전체 계층 구조 이름이 나열됩니다.

GetParentHier

명령 구문
GetParentHier FullElementName

이 명령어는 지정된 요소의 상위 요소에 대한 계층 구조 이름(FullModuleName)을(를) 반환합니다. FullElementName, 즉 요소 FullModuleName 이(가) 위치한 계층 구조 요소의 FullElementName 입니다.

FullElementName 은(는) 모듈, 시뮬레이션 모듈 또는 주석 상자일 수 있습니다.

GetModules

명령 구문
GetModules Scope Specifier {ModuleList}

이 명령은 디자인 내의 특정 모듈을 필터링합니다. 이 명령은 지정한 특성을 가진 모듈 목록을 반환합니다. Scope 및 Specifier. 목록에는 다음이 포함됩니다. FullModuleName 검색된 모든 모듈에 대해 (개별 모듈 이름을 포함한 모듈 경로). 디자인 전체가 아니라 특정 모듈 세트에서만 검색하려면 다음에서 해당 모듈을 지정할 수 있습니다. ModuleList (다음 항목을 통해 FullModuleName).

Scope 은(는) 다음과 같은 값을 가질 수 있습니다:

• pattern: 사용 Specifier 을(를) 와일드카드 표현식으로 사용 FullModuleName. 지정자로 "*"를 지정하면 디자인의 모든 모듈이 반환됩니다.
• flat: 사용 Specifier 을(를) 다음의 와일드카드 표현식으로 사용합니다. FullModuleName 모듈(패턴과 같은 방식). 계층형 상자는 반환되지 않습니다.
• ordered: 디자인의 모든 모듈을 반환합니다. 사용 Specifier 정렬 패턴을 정의합니다. 다음과 같은 옵션이 있습니다:
  • path: 디자인 그래프에서의 위치에 따라 모듈이 정렬됩니다(즉, 시뮬레이션 중에 모듈을 통과하는 데이터 스트림의 순서대로 정렬).
  • name: 모듈이 다음을 기준으로 알파벳순으로 정렬됩니다. FullModuleName.
• operatorType: 사용 Specifier 을(를) 사용하여 찾고 있는 모듈의 연산자 유형("O", "M", "P", "O+P", "M+P", "unknown")을 정의합니다.
• operator: 특정 연산자의 모든 인스턴스를 가져오기 위한 것입니다. 사용 Specifier 을(를) 사용하여 연산자 이름을 지정합니다(예: "NOP").
• libraryType: 사용 Specifier 을(를) 사용하여 특정 라이브러리 유형을 정의합니다. 이 유형의 라이브러리에 포함된 연산자의 인스턴스인 디자인의 모든 모듈이 반환됩니다. 다음과 같은 값을 사용할 수 있습니다: operator, user 및 custom (다음 내용도 참조하십시오. GetModuleProperty).
• library: 사용 Specifier 을(를) 사용하여 특정 라이브러리를 정의합니다. 이 라이브러리의 연산자 인스턴스인 모든 모듈이 반환됩니다.
• version: 사용 Specifier 을(를) 사용하여 특정 연산자 버전을 정의합니다. 이 버전의 연산자 인스턴스인 모든 모듈이 반환됩니다.

GetModulePorts

명령 구문
GetModulePorts FullModuleName [Scope]

이 명령은 지정된 모듈의 모든 포트 이름이 포함된 목록을 반환합니다. 선택적 파라미터를 사용할 수 있습니다. Scope 을(를) 사용하여 특정 포트를 필터링합니다:

• inputs: 입력 포트만 반환됩니다.
• outputs: 출력 포트만 반환됩니다.
• all: 모듈의 모든 포트가 반환됩니다(기본값).

GetModulePortProperty

명령 구문
GetModulePortProperty FullModuleName PortName Property

이 명령어는 모듈 포트의 Property를 검색합니다. Property 에 사용할 수 있는 값은 다음과 같습니다.

• isConnected: 포트가 연결된 경우 1을 반환하고, 그렇지 않으면 0을 반환합니다.
• position: 다이어그램(디자인 창)에서 지정된 포트의 위치를 목록으로 반환합니다(xPos, yPos). 지정한 PortName 내부 계층형 상자 노드를 지정합니다(예: INBOUND#I000), 계층형 상자 디자인 창 내에서 이 노드의 위치가 반환됩니다.

GetModuleProperty

명령 구문
GetModuleProperty FullModuleName Property

이 명령어는 모듈의 Property를 반환합니다.

에 사용할 수 있는 값은 다음과 같습니다. Property 에 사용할 수 있는 값은 다음과 같습니다.

• status: 모듈에 오류 상태가 없으면 0을 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
• operator: 모듈이 인스턴스인 오퍼레이터의 이름을 반환합니다(예: BRANCH.
• operatorType: 오퍼레이터 유형(O, P, M, unknown)을 반환합니다. 계층형 박스 및 사용자 라이브러리 모듈의 경우 "Unknown"이 반환됩니다.
• libraryType: 오퍼레이터가 속한 라이브러리의 라이브러리 유형을 반환합니다. 다음 값 중 하나가 반환됩니다. operator, user, custom.
• version: 모듈이 인스턴스인 오퍼레이터의 버전을 반환합니다.
• type: 모듈 유형을 반환합니다. 다음 값 중 하나가 반환됩니다. process, hierBox, operator, user, custom.
• isHierModule: 지정된 모듈이 하위 모듈을 포함할 수 있는 경우 1을 반환하고, 지정된 모듈이 하위 모듈을 가질 수 없는 경우 0을 반환합니다.
• isProtected: 모듈이 보호된 라이브러리 요소의 인스턴스인 경우 1을 반환합니다.
• library: 오퍼레이터가 속한 라이브러리의 이름을 반환합니다.
• position: 디자인 창 내의 위치를 리스트 형태로 반환합니다(xPos, yPos).
• resources: (쌍의 목록을 반환합니다)ResourceName,ResourceMapping)
• name: 모듈 이름을 반환합니다.

GetModuleParams

명령 구문
GetModuleParams FullModuleName {ParameterNames}

모듈 파라미터 목록과 현재 값을 반환합니다.

모듈의 모든 parameter와 현재 설정된 값을 함께 가져오려면 다음 명령을 사용합니다. GetModuleParams parameter 지정 시에만 FullModuleName.

예:

특정 파라미터의 값만 가져오려면 선택적으로 출력 범위를 제한할 수 있습니다 {ParameterNames}. 출력 순서는 지정한 파라미터 이름의 순서와 일치합니다 {ParameterNames}.

예:

puts [GetModuleParams Process0/FrameBufferMultiRoi RamDataWidth MaxFrameCount]

GetModuleParamProperty

명령 구문
GetModuleParamProperty FullModuleName ParameterName Property

parameter Property를 검색하기 위한 명령입니다.

parameter Property에 대해 다음 값을 사용할 수 있습니다.

• status: 파라미터에 오류 상태가 없으면 0을 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
• type: 파라미터 타입을 반환합니다: int, intField, float, floatField, enum, 또는 string.
• access: 접근 방향을 반환합니다: write 또는 read).
• unit: parameter의 단위를 반환합니다.
• range: 정수 및 부동 소수점 데이터 타입의 경우, 이 명령은 세 개의 항목을 포함하는 리스트로 값 범위를 반환합니다. Min, Max, Step. 열거형 parameter의 경우, 열거형 이름과 열거형 값의 쌍으로 이루어진 리스트를 반환합니다.
• size: 필드 크기를 반환합니다. 대상: IntField 및 FloatField 매개변수.
• isDynamic: 요청된 파라미터가 동적(dynamic)인 경우 1을 반환하고, 그렇지 않으면 0을 반환합니다.
• isStatic: 요청된 파라미터가 정적(static)인 경우 1을 반환하고, 그렇지 않으면 0을 반환합니다.
• isEditable: 요청된 파라미터를 편집할 수 있는 경우 1을 반환하고, 그렇지 않으면 0을 반환합니다.

GetLinkParams

명령 구문
GetLinkParams FullModuleName PortName {ParameterNames}

특정 링크의 링크 파라미터 이름과 현재 설정된 값의 목록을 반환합니다. 링크는 모듈의 연결 노드(포트)를 통해 식별됩니다. 반환된 목록에는 다음 값 쌍이 포함됩니다 <ParameterName><Value> 링크 파라미터를 설정할 때 사용하는 쌍에 해당하는 값입니다 SetLinkParam.

현재 설정된 값과 함께 링크의 모든 파라미터를 가져오려면 다음 명령을 사용하십시오 GetLinkParams 파라미터에만 해당 FullModuleName 및 PortName.

특정 파라미터의 값만 가져오려면 선택적으로 출력 범위를 제한할 수 있습니다 {ParameterNames}. 출력 순서는 지정한 파라미터 이름의 순서와 일치합니다 {ParameterNames}.

예:

GetLinkParamProperty

명령 구문
GetLinkParamProperty FullModuleName PortName ParameterName Property

이 명령은 특정 링크 매개변수의 속성을 검색합니다.

매개변수에 대한 다음 값 Property 을(를) 사용할 수 있습니다.

• status: 파라미터에 오류 조건이 없으면 0을 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
• isEditable: 파라미터 값을 변경할 수 있는 경우 1을 반환하고, 그렇지 않으면 0을 반환합니다.
• range:
  • For integer data types, the command returns the value range either as a list containing three elements (Min, Max, Step), or as a list containing all allowed values. You distinguish the two kinds of lists as follows: The Min-Max-Step list contains 3 list elements; the third list element is smaller or equal to the second list element. A list stating all allowed values starts with the smalles value and ends with the highest value. If only one value is allowed, the value is returned in format {Value Value 1}, for example, { 4 4 1} for min=4, max=4, step=1.
  • 열거형(enum) 파라미터의 경우, 이 명령어는 열거형 이름과 열거형 값의 쌍 목록을 반환합니다.

GetLinkProperty

명령 구문
GetLinkProperty FullModuleName PortName Property

이 명령어는 특정 링크의 특정 property를 검색합니다. 만약 FullModuleName 및 PortName을(를) 사용하여 계층적 상자(hierarchical box)의 포트를 지정하는 경우, 계층적 상자 내부에 해당 포트로 향하거나 포트에서 나오는 링크가 있는 한 명령어가 정상적으로 작동합니다.

매개변수에 대한 다음 옵션 Property 에 사용할 수 있는 값은 다음과 같습니다.

• status: 모든 것이 정상인 경우(즉, 링크 소스와 링크 타겟의 파라미터 설정이 일치하고 DRC에서 오류가 발견되지 않은 경우) 0을 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
• from: 링크의 시작점을 반환합니다. 시작점은 이전 모듈의 out 포트이거나 내부 계층 구조 Box 노드(INBOUND#...) 링크가 연결되어 있습니다. 이 명령어는 두 개의 값이 포함된 목록을 반환합니다 FullModuleName 및 PortName.
• to: 링크의 끝점을 반환합니다. 끝점은 다음 모듈의 in 포트이거나 내부 계층 구조 Box 노드(OUTBOUND#...) 링크가 연결되어 있습니다. 이 명령어는 두 개의 값이 포함된 목록을 반환합니다 FullModuleName 및 PortName.
• source: 값 쌍이 포함된 목록을 반환합니다 FullModuleName 및 PortName 링크의 소스까지의 모든 이전 링크에 대해 적용됩니다. 링크 체인은 지정한 모듈에서 시작하여 계층 구조를 거쳐 거꾸로 추적됩니다. FullModuleName 시작점으로 돌아갑니다. 반환된 리스트 내 요소의 순서는 조회 역방향 경로와 일치합니다(소스 모듈이 리스트의 마지막 항목임).
• dest: 값 쌍이 포함된 목록을 반환합니다 FullModuleName 및 PortName 링크의 타겟 모듈까지의 모든 다음 링크에 대해 적용됩니다. 링크 체인은 지정한 모듈에서 시작하여 계층 구조를 통과하여 FullModuleName 끝(싱크)까지 진행됩니다. 반환된 리스트 내 요소의 순서는 조회 정방향 경로와 일치하며, 타겟 모듈(대상)이 리스트의 마지막 항목이 됩니다.
• hasConnectedSimModule: 링크에 시뮬레이션 모듈이 연결되어 있으면 1을 반환하고, 연결되어 있지 않으면 0을 반환합니다.
• connectedSimModule: 연결된 시뮬레이션 모듈의 계층적 이름을 반환합니다.

GetSimModules

명령 구문
GetSimModules Type Scope Specifier

이 명령어는 다음을 검색합니다. FullModuleName 시뮬레이션 소스(or simulation sources)(Type = source) 또는 시뮬레이션 프로브(simulation probes)(Type = probe)의 리스트를 반환합니다. 이 명령어는 매개변수를 통해 지정한 특성을 가진 시뮬레이션 모듈의 리스트를 반환합니다. Scope 및 Specifier. 목록에는 다음이 포함됩니다. FullModuleNames (개별 경로를 포함하여 각 시뮬레이션 모듈에 이르는 계층적 경로).

Scope 다음 옵션을 제공합니다:

• hierarchy: 매개변수에서 특정 계층 구조를 정의합니다. Specifier.
• pattern: 매개변수를 사용합니다. Specifier 을(를) 와일드카드 표현식으로 사용 FullModuleNames 시뮬레이션 모듈의 지정자로 "*"를 지정하면, 디자인의 모든 소스 또는 프로브 시뮬레이션 모듈이 반환됩니다.

GetCommentBoxes

명령 구문
GetCommentBoxes Scope Specifier

이 명령어는 디자인 내의 주석 Box를 가져옵니다. 이 명령어는 파라미터를 통해 지정한 특성을 가진 모든 주석 Box의 리스트를 반환합니다. Scope 및 Specifier. 목록에는 다음이 포함됩니다. FullElementNames (Box 이름을 포함한 계층적 이름).

Scope 다음 옵션을 제공합니다:

• hierarchy: 특정 계층 구조를 정의합니다(다음을 통해 HierLevelPath) 내부 Specifier.
• pattern: 사용 Specifier 을(를) 다음의 와일드카드 표현식으로 사용합니다. FullElementName 코멘트 박스입니다. 지정자로 "*"를 지정하면 디자인 내의 모든 코멘트 박스가 반환됩니다.

GetCommentProperty

명령 구문
GetCommentProperty FullBoxName Property

이 명령어는 주석 Box의 속성을 가져옵니다.

FullBoxName 다음과 같은 구문을 가집니다. <HierLevelPath>/<BoxName>.

• HierLevelPath 주석 상자가 위치한 디자인의 계층 수준에 대한 경로를 지정하는 데 사용합니다. 프로세스 레벨에서 시작하며, 슬래시(/)를 사용합니다.
• BoxName 개별 코멘트 박스의 이름을 지정하는 데 사용합니다.

Property 다음 옵션을 제공합니다:

• content: 코멘트 박스의 내용이 반환됩니다.
• position: 디자인 창에서 코멘트 박스의 왼쪽 상단 모서리의 X 및 Y 위치가 반환됩니다.

박스 이름 정보: 세부 정보를 확인하려는 코멘트 박스의 이름을 가져오려면 TCL을 사용하여 디자인에 배치된 박스를 조회할 수 있습니다. TCL 예시를 참조하십시오. QueryDesign.tcl VisualApplets 설치 폴더 내(예:<YourVisualAppletsInstallationDirectory>\Examples\AdvancedVAFunctions\Tcl Scripting\QueryDesign.tcl)

디자인 편집 – 추가 명령

Move

명령 구문
Move FullModuleName [HierNodeName] PosX PosY

디자인 창 내에서 모듈, 계층형 박스 노드, 코멘트 상자 또는 시뮬레이션 모듈의 위치를 새로 재조정하기 위한 명령입니다.

매개변수를 사용하십시오. [HierNodeName] 계층형 박스 노드를 선택하는 경우에만 해당됩니다. 계층형 박스 내의 노드는 접두사로 식별됩니다. INBOUND# 또는 OUTBOUND#(명령을 사용할 때와 마찬가지로 ConnectModules), 예를 들어, INBOUND#I000.

Select

명령 구문
Select FullModuleName [PortName]

모듈, 시뮬레이션 모듈, 코멘트 박스 또는 링크를 선택하기 위한 명령입니다. 매개변수를 사용하십시오. PortName 링크를 선택하는 경우에만 해당됩니다(링크는 해당 모듈과 링크를 연결하는 포트를 통해 식별됩니다).

ClearSelection

명령 구문
ClearSelection [ParentHierarchy]

선택한 요소(모듈, 계층형 박스 노드, 링크, 코멘트 상자 또는 시뮬레이션 모듈)를 삭제하기 위한 명령입니다.

선택적 매개변수 사용 ParentHierarchy 계층 수준의 모든 요소 선택을 해제합니다. ParentHierarchy.

사용하지 않는 경우 ParentHierarchy, 요소 선택이 전역적으로 해제되며 명령을 실행한 후에는 디자인 내의 어떠한 요소도 선택되지 않습니다.

CopySelected

명령 구문
CopySelected [ParentHierarchy]

계층 수준에서 선택한 요소를 복사하기 위한 명령 ParentHierarchy. 선택적 파라미터를 사용하지 않는 경우 ParentHierarchy, 현재 활성 디자인 창의 계층 수준에 있는 선택된 요소가 복사됩니다.

DeleteSelected

명령 구문
DeleteSelected [ParentHierarchy]

계층 수준에서 선택한 요소를 삭제하기 위한 명령어입니다. ParentHierarchy. 아래에서 지정한 계층 수준의 선택된 모듈만 ParentHierarchy 삭제되며, 다른 수준의 선택된 모듈은 유지됩니다. 선택적 파라미터를 사용하지 않는 경우 ParentHierarchy, 현재 활성 디자인 창의 계층 수준에 있는 선택된 요소가 삭제됩니다.

CutSelected

명령 구문
CutSelected [ParentHierarchy]

계층 수준에서 선택한 요소를 잘라내기 위한 명령어입니다. ParentHierarchy. 선택적 파라미터를 사용하지 않는 경우 ParentHierarchy, 현재 활성 디자인 창의 계층 수준에 있는 선택된 요소가 잘라내기 됩니다.

GetSelected

명령 구문
GetSelected Scope [ParentHierarchy]

계층 수준의 선택된 요소 목록을 반환합니다. ParentHierarchy. Scope를 통해 선택한 모듈(Modules), 선택한 링크(Links), 선택한 시뮬레이션 모듈(SimModules) 또는 선택한 코멘트 박스(CommentBoxes).

선택적 파라미터를 사용하지 않는 경우 ParentHierarchy, 현재 활성 디자인 창의 계층 수준에 있는 선택된 요소가 반환됩니다.

사용하는 경우 Scope = Modules/SimModules/CommentBoxes, 목록 FullModuleNames (모듈 이름을 포함하여 각 모듈에 이르는 계층 경로)가 반환됩니다.

사용하는 경우 Scope = Links 다음으로 구성된 링크 식별 튜플 목록을 얻을 수 있습니다. FullModuleName 및 PortName (링크가 연결된 포트).

Paste

명령 구문
Paste [ParentHierarchy] [xPos yPos]

클립보드에서 계층 레벨로 요소를 붙여넣기 위한 명령입니다. ParentHierarchy(즉, 이전에 복사하거나 잘라낸 요소를 붙여넣습니다).

선택적 파라미터를 사용하지 않는 경우 ParentHierarchy, 요소가 현재 활성화된 디자인 창의 계층 레벨에 붙여넣어집니다.

선택적 매개변수를 사용하십시오. xPos 및 yPos 디자인 창에 삽입된 콘텐츠의 좌측 상단 위치를 정의합니다.

InsertModulePort

명령 구문
InsertModulePort FullModuleName PortName [Where]

포트 옆에 새 모듈 포트를 삽입하기 위한 명령입니다. PortName.

정보

명령에서 다중성을 지정할 수 있는 포트만 삽입할 수 있습니다. CreateModule.

여기서 제공하는 옵션은 다음과 같습니다:

• before 또는 above: 새 포트가 포트 바로 앞에 삽입됩니다. PortName.
• after 또는 below: 새 포트가 포트 바로 뒤에 삽입됩니다. PortName (기본값).

선택적 파라미터를 사용하지 않는 경우 Where, 새 포트가 다음 포트 바로 뒤에 삽입됩니다. PortName.

RemoveModulePort

명령 구문
RemoveModulePort FullModuleName PortName

모듈 포트를 삭제하기 위한 명령입니다.

정보

명령에서 다중성(multiplicity)을 지정할 수 있는 포트만 삭제할 수 있습니다. CreateModule. 특정 종류의 포트 최소 개수는 항상 유지됩니다. 최소 개수 미만으로 줄이려고 하면 관련 에러 메시지가 표시됩니다. 예: Branch 오퍼레이터의 세 번째 출력 포트(포트 이름: O002)는 삭제할 수 있지만, 최소 출력 포트 두 개(O001 및 O000)는 삭제할 수 없습니다.

AppendModulePort

명령 구문
AppendModulePort FullHierBoxName Direction

계층형 박스에 입력 포트 또는 출력 포트를 추가하기 위한 명령입니다.

FullHierBoxName 은(는) 다음의 구문과 동일합니다. FullModuleName.

Direction=input: 입력 포트가 생성됩니다.

Direction=output: 출력 포트가 생성됩니다.

이름 변경

명령 구문
이름 변경 FullModuleName NewName

모듈 또는 시뮬레이션 박스의 이름을 변경하기 위한 명령어입니다. NewName 계층 경로를 제외한 인스턴스의 새로운 개별 이름을 지정합니다.

예:

Rename Process0/module1 DMA

SetActiveWindow

명령 구문
SetActiveWindow Hierarchy

VisualApplets에서 계층 구조의 디자인 창을 열고(활성 상태로 설정) 위한 명령입니다. Hierarchy VisualApplets에서.

GetActiveWindow

명령 구문
GetActiveWindow

현재 VisualApplets에서 열려 있고 활성화된 디자인 창의 계층 수준에 대한 정보를 반환합니다.

디자인 시뮬레이션

CreateSimSource

명령 구문
CreateSimSource FullSimModuleName xPos yPos

시뮬레이션 소스 모듈을 생성하고 디자인 창에 배치하기 위한 명령어입니다.

FullSimModuleName 다음과 같은 구문을 가집니다. <HierLevelPath>/<SimModuleName>

• HierLevelPath 디자인 내의 특정 계층 수준에 대한 경로를 정의하는 데 사용됩니다.
• SimModuleName 시뮬레이션 소스 모듈에 지정할 개별 이름을 지정하는 데 사용됩니다. 또는 다음을 그대로 둘 수도 있습니다. SimModuleName 을(를) 비워둘 수 있습니다. 이 경우 다음을 종료해야 합니다. FullSimModuleName 을(를) 슬래시로 끝나도록 해야 하며, 모듈 이름은 자동으로 지정됩니다.

함수의 반환 값은 CreateSimSource 은(는) FullModuleName 새 시뮬레이션 소스 모듈의 (모듈 이름을 포함한 시뮬레이션 소스 모듈의 전체 계층 경로)입니다.

CreateSimProbe

명령 구문
CreateSimProbe FullSimModuleName xPos yPos

시뮬레이션 프로브 모듈을 생성하고 디자인 창에 배치하기 위한 명령어입니다.

FullSimModuleName 다음과 같은 구문을 가집니다. <HierLevelPath>/<SimModuleName>

• HierLevelPath 디자인 내의 특정 계층 수준에 대한 경로를 정의하는 데 사용됩니다.
• SimModuleName 시뮬레이션 프로브 모듈에 지정할 이름을 지정하는 데 사용됩니다. 또는 SimModuleName 을(를) 비워둘 수 있습니다. 이 경우 다음을 종료해야 합니다. FullSimModuleName 을(를) 슬래시로 끝나도록 해야 하며, 모듈 이름은 자동으로 지정됩니다.

함수의 반환 값은 CreateSimProbe 은(는) FullModuleName 새 시뮬레이션 프로브 모듈의 (모듈 이름을 포함한 시뮬레이션 프로브 모듈의 전체 계층 경로)입니다.

DeleteSimModule

명령 구문
DeleteSimModule FullSimModuleName

시뮬레이션 모듈(시뮬레이션 소스 또는 시뮬레이션 프로브)을 삭제하기 위한 명령어입니다.

구문 FullSimModuleName 의 구문은 다음과 같습니다. FullModuleName.

ConnectSimModule

명령 구문
ConnectSimModule FullSimModuleName TargetModuleName TargetModulePortName [xPos yPos]

시뮬레이션 모듈을 링크에 연결하기 위한 명령입니다. 링크가 연결된 모듈 포트를 통해 링크를 식별합니다.

구문 FullSimModuleName 및 TargetModuleName 의 구문은 다음과 같습니다. FullModuleName. 의 구문은 TargetModulePortName 의 구문은 다음과 같습니다. PortName.

Module TargetModuleName 및 시뮬레이션 모듈 FullSimModuleName 을(를) 서로 연결하려면 동일한 계층 구조 내에 있어야 합니다.

선택적으로, 다음을 통해 링크에서 연결점의 위치를 정의할 수 있습니다. xPos 및 yPos.

DisconnectSimModule

명령 구문
DisconnectSimModule FullSimModuleName

시뮬레이션 모듈을 링크에서 분리하기 위한 명령어입니다.

SetSimModuleProperty

명령 구문
SetSimModuleProperty FullSimModuleName Key Value {OtherValue}

시뮬레이션 모듈의 속성을 정의하는 명령입니다.

설정하려는 속성을 식별하려면 Key 을(를) 사용하세요. 개별 속성은 아래 명시된 형식으로 설정합니다. 사용 가능한 속성과 그에 해당하는 값 형식은 다음과 같습니다.

pixelAlignmentOffset BITS

정수 값으로 정렬 오프셋을 지정하려면 이 파라미터를 사용하세요. BITS.

imageFileSubPixels NUMBER

정수 값으로 링크 픽셀에 할당된 파일 픽셀 수를 지정하려면 이 파라미터를 사용하세요. NUMBER.

소스: NUMBER 개의 픽셀이 하나의 픽셀로 병합됩니다.

프로브: 하나의 픽셀이 NUMBER 개의 파일 픽셀로 분할됩니다.

imageFilePixelBits BITS

정수 값으로 이미지 파일의 Bit Width을(를) 지정하려면 이 파라미터를 사용하세요. BITS. 허용되는 값은 1, 8, 16입니다.

imageFileNormalize CHOICE

시뮬레이션 결과 이미지가 저장되는 방식을 구성하려면 이 속성을 사용하세요.

1비트 시뮬레이션 결과를 8비트 파일 형식으로 저장하려면 imageFileNormalize 을(를) 1로 설정하세요. 여기서 "정규화(Normalizing)"는 0을 0(검은색)으로, 1을 255(흰색)로 매핑하는 것을 의미합니다.

에 사용할 수 있는 값은 다음과 같습니다. CHOICE 을(를) 사용할 수 있습니다. CHOICE = "1" | "0"

cropRect [imageNr] X Y WIDTH HEIGHT

이 속성은 시뮬레이션 소스에서만 사용할 수 있습니다. 이미지 인덱스 지정은 [imageNr] 필수입니다. 이미지를 자르고 시뮬레이션에 사용할 이미지 영역(ROI)을 지정하려면 이 파라미터를 사용하세요. 다음을 사용합니다: X 및 Y ROI의 좌측 상단 모서리를 정의합니다.

currentImage INDEX

이 파라미터를 사용하여 시뮬레이션 모듈 내에서 이미지를 선택합니다. 지정하십시오. INDEX 정수 값으로 지정합니다.

AddImage

명령 구문
AddImage FullSimModuleName ImageFileName1 {OtherImageFileName} [ImageLibrary]

시뮬레이션 소스 모듈에 이미지를 추가하기 위한 명령입니다. 시뮬레이션 소스가 연결된 링크의 커널 요소 수가 1보다 큰 경우, 커널 요소 수만큼 이미지를 지정해야 합니다.

선택적으로 사용할 이미지 라이브러리를 지정할 수 있습니다( ImageLibrary = "Native" | "ImageMagick").

RemoveImage

명령 구문
RemoveImage FullSimSourceName {ImageIndex}

시뮬레이션 소스 모듈에서 하나 또는 모든 이미지를 삭제하기 위한 명령입니다. 선택적 파라미터 사용 ImageIndex 을 사용하여 삭제할 이미지를 지정합니다. 설정하는 경우 ImageIndex 을 -1로 설정하거나 사용하지 않는 경우 ImageIndex 전체, 시뮬레이션 모듈의 모든 이미지가 삭제됩니다.

Simulate

명령 구문
Simulate ProcessingCycles [SaveLogfilename]

디자인을 시뮬레이션하기 위한 명령입니다. 파라미터 사용 ProcessingCycles 명령으로 수행할 처리 주기 수를 정의합니다.

선택적 매개변수 사용 SaveLogfilename 수행된 주기의 로그를 파일로 저장합니다. 지정 위치 SaveLogfilename 파일 경로 및 파일 이름 자체. 로그가 HTML 형식으로 작성되므로 파일 이름 확장자 *.html을 사용하십시오. 경로를 나타낼 때는 슬래시를 사용하십시오.

예:

Simulate 1 c:/temp/simlog.html

ResetSimulation

명령 구문
ResetSimulation

시뮬레이션 엔진을 재설정하기 위한 명령입니다. 그 결과로 디자인의 모든 시뮬레이션 프로브가 지워집니다.

GetSimModuleProperty

명령 구문
GetSimModuleProperty FullSimModuleName Property [ImageIndex [LineIndex [LineCount] ] ]

시뮬레이션 모듈의 속성을 검색하기 위한 명령입니다. 다음 속성을 사용할 수 있습니다.

• isConnected: 시뮬레이션 모듈이 링크에 연결되어 있으면 1을 반환하고, 그렇지 않으면 0을 반환합니다.
• connectedLink: 다음을 포함하는 목록을 반환합니다. FullModuleName 링크가 연결된 모듈의 속성과, 링크가 연결된 모듈의 포트입니다. 반환 값은 항상 실제 모듈 포트로 링크를 설명하며, 즉 내부 H 상자 노드(예: 다음과 같은 노드)를 명시하지 않습니다. INBOUND#I000 또는 OUTBOUND#O000).
• isSource: 시뮬레이션 모듈이 다음 조건에 해당하면 1을 반환합니다: SimulationSource; 그렇지 않으면 0을 반환합니다.
• isProbe: 시뮬레이션 모듈이 다음 조건에 해당하면 1을 반환합니다: SimulationProbe; 그렇지 않으면 0을 반환합니다.
• position: 프로그램 창 내 시뮬레이션 모듈의 위치를 목록으로 반환합니다(xPos, yPos).
• imageCount: 시뮬레이션 모듈의 이미지 개수를 반환합니다(=값: IMAGECOUNT).
• imageSize: 파라미터 사용 ImageIndex 은(는) 필수입니다. 지정한 이미지의 크기를 반환합니다. ImageIndex 목록 형태 {Width <WIDTH> Height <HEIGHT>}.
• pixelAligmentOffset: 정수 값으로 정렬 오프셋을 반환합니다. BITS.
• imageFileSubPixels: 링크 픽셀에 할당된 파일 픽셀의 개수를 정수 값으로 반환합니다. NUMBER.
• imageFilePixelBits: 이미지 파일의 Bit Width 설정을 정수 값으로 반환합니다. BITS. 허용되는 값은 1, 8, 16입니다.
• imageFileNormalize: 시뮬레이션 결과 이미지 저장 설정에 따라 1 또는 0을 반환합니다. 1로 설정된 경우, 8비트 * 파일로 1비트 시뮬레이션 결과를 저장하는 동안 format: 0은 0(검은색)에 매핑되고 1은 255(흰색)에 매핑됩니다. 즉, 시뮬레이션 이미지의 형식이 "정규화(normalized)"됩니다.
• cropRect: 이 Property는 시뮬레이션 소스에서만 사용할 수 있습니다. 파라미터 사용 ImageIndex 은(는) 필수입니다. 다음 항목들로 구성된 목록을 반환합니다: {X Y WIDTH HEIGHT}.
• currentImage: 현재 선택된 이미지를 정수 값으로 반환합니다. INDEX.

SetSimImageData

명령 구문
SetSimImageData FullSimModuleName ImageIndex KernelRow KernelCol Component X Y Width Value {OtherValues}

시뮬레이션 모듈(소스 또는 프로브) 내 이미지에서 하나의 픽셀 또는 여러 개의 인접 픽셀을 덮어쓰기 위한 명령어입니다.

이 명령어를 사용할 수 있습니다_

• SimSources에서 시뮬레이션용 이미지를 변경하기 위해.
• SimProbes에서 이미지 내의 결과를 시각화하기 위해.

이미지 변경 사항은 일시적입니다. 동일한 시뮬레이션 모듈의 다른 이미지를 선택하거나 변경된 이미지를 다시 선택하면, 변경된 이미지가 하드 디스크에서 새로 로드되며 기존 변경 사항은 폐기됩니다. (TCL 콘솔에서 새 이미지에 대한 명령어를 입력하거나 VisualApplets GUI의 뷰어에서 동일한 시뮬레이션 모듈의 다른 이미지를 클릭하면 다른 이미지가 선택됩니다.) ImageIndex (동일한 시뮬레이션 모듈의)

그러나 변경된 이미지가 활성화되어 있는 동안 새 파일 이름으로 저장하면 변경 사항을 영구적으로 유지할 수 있습니다.

일시적으로 변경된 이미지를 시뮬레이션에 사용할 수 있습니다. 단, 변경된 상태의 시뮬레이션에는 SimSource 모듈당 하나의 이미지만 사용할 수 있습니다(동일한 SimSource 내에서 다른 이미지를 변경하면 이전에 변경했던 이미지의 픽셀 값이 재설정되기 때문입니다). 시뮬레이션 모듈당 하나의 일시적으로 변경된 이미지만 사용하는 한, 원하는 만큼 많은 일시적으로 변경된 이미지를 시뮬레이션에 사용할 수 있습니다.

픽셀당 하나의 값: 명령 SetSimImageData 을(를) 사용하면 픽셀당 정확히 하나의 값을 쓸 수 있습니다. 따라서 그레이스케일 픽셀의 경우, 픽셀당 완전한 색상 정보를 작성하려면 명령어를 수행해야 합니다. SetSimImageData 완전히 한 번만 실행하면 됩니다. 컬러 픽셀의 경우 픽셀당 세 가지 색상 성분 중 하나만 쓸 수 있습니다. 따라서 컬러 픽셀의 세 가지 색상 성분을 모두 변경하려면 명령어를 수행해야 합니다. SetSimImageData 세 번.

커널이 있는 이미지에 쓰기: 커널이 있는 이미지에 쓸 때는 명령어 사용 시 덮어쓰려는 (첫 번째) 픽셀의 정확한 위치 외에도, 해당 픽셀(들)의 어떤 커널 요소를 덮어쓸 것인지 지정해야 합니다. SetSimImageData. 모든 커널 요소를 덮어쓰려면 다음 명령어를 수행해야 합니다. SetSimImageData 정확히 KernelRow * KernelCol 번 수행해야 합니다.

명령 사용 방법:

명령을 사용하기 전에, 변경하려는 이미지가 있는 시뮬레이션 모듈의 이미지 뷰어를 닫으십시오.

인덱스(으)로 변경할 이미지를 지정합니다. ImageIndex.

ImageIndex 은(는) 0부터 시작하는 반면, VisualApplets GUI의 시뮬레이션 모듈 내 이미지 번호는 1부터 시작합니다. 값은 다음과 같이 매핑됩니다:

ImageIndex = 0 VisualApplets GUI의 뷰어에서 이미지 1을 나타냅니다.

ImageIndex = 1 VisualApplets GUI의 뷰어에서 이미지 2를 나타냅니다.

ImageIndex = 2 이미지 3을 나타냅니다.

이와 같은 방식으로 계속됩니다.

정보: VisualApplets의 GUI에서는 다음 시뮬레이션 주기에서 사용되는 이미지의 인덱스가 대괄호 안에 표시되며 앞에 "sim"이 붙습니다(예: sim[2]).

설정하려는 속성을 식별하려면 KernelRow 및 KernelCol 픽셀 값을 변경할 커널 요소를 지정합니다.

시뮬레이션 이미지의 커널 크기는 시뮬레이션 모듈이 연결된 링크의 링크 속성에서 확인할 수 있습니다. 커널 크기가 1픽셀보다 큰 링크 앞에는 항상 커널을 지정할 수 있는 오퍼레이터의 인스턴스가 선행됩니다(예: FIRkernelNxM).

커널 열과 커널 행은 0부터 카운트됩니다. 따라서 요소가 하나뿐인 커널의 경우 두 값 모두(KernelRow 및 KernelCol)를 0으로 설정합니다:

요소가 4개인 커널의 경우 다음과 같이 개별 커널 요소를 식별합니다.

요소가 9개인 커널의 경우 다음과 같이 개별 커널 요소를 식별합니다.

파라미터 Component 설정하려는 픽셀의 색상 성분을 지정합니다. 그레이 스케일 이미지에서는 Component 을(를) 0으로 설정합니다. 다중 성분 이미지(컬러)에서는 색상 모델에서의 위치를 통해 작성하려는 성분을 지정합니다. 예: RGB 이미지에서 빨간색 성분을 지정하려면 Component 을(를) 0으로 설정하고, RGB 이미지에서 녹색 성분을 지정하려면 Component 을(를) 1로 설정하며, RGB 이미지에서 파란색 성분을 지정하려면 Component 을(를) 2로 설정합니다.

위치(X,Y)을(를) 설정하여 이미지 내에서 쓰기 작업의 시작점(첫 번째 픽셀)을 정의합니다.

설정하려는 속성을 식별하려면 Width 행당 덮어쓸 인접 픽셀 수를 지정합니다. 한 행에 쓰는 픽셀보다 더 많은 Values 을(를) 지정하는 경우(Width), 위치 X의 다음 행에서 쓰기 작업이 계속됩니다. 이 방식으로 너비를 가진 관심 영역(ROI)을 작성할 수 있습니다. Width.

개별 픽셀 값을 지정합니다. Value {OtherValues} 앞에 "0x"를 붙이지 않고 16진수로 표기합니다. 음수 값은 2의 보수 표기법으로 지정합니다. Value {OtherValues} 이미지 내에서 변경할 픽셀의 개수를 결정합니다.

GetSimImageData

명령 구문
GetSimImageData FullSimModuleName ImageIndex KernelRow KernelCol Component X Y [Width [Height]]

시뮬레이션 모듈(소스 또는 프로브) 내 이미지에서 하나 또는 여러 개의 인접 픽셀 값을 읽기 위한 명령어입니다.

픽셀당 하나의 값: 명령 GetSimImageData 픽셀당 정확히 하나의 값을 반환합니다. 따라서 그레이 스케일 픽셀에서는 픽셀당 완전한 색상 정보를 검색하려면 명령어를 GetSimImageData 한 번만 실행해야 합니다. 컬러 픽셀에서는 픽셀당 세 가지 색상 성분 중 하나만 검색할 수 있습니다. 따라서 컬러 픽셀의 세 가지 색상 성분을 모두 읽으려면 명령어를 실행해야 합니다. GetSimImageData 세 번.

커널을 사용하여 이미지 읽기: 커널이 있는 이미지에서 읽을 때는 명령어를 사용할 때 읽으려는 (첫 번째) 픽셀의 정확한 위치 외에도 해당 픽셀의 어떤 커널 요소를 읽을 것인지 지정해야 합니다. GetSimImageData. 모든 커널 요소를 읽으려면 명령어를 실행해야 합니다. GetSimImageData 정확히 KernelRow * KernelCol 번 수행해야 합니다.

명령 사용 방법:

다음에 지정된 인덱스로 이미지를 지정합니다. ImageIndex.

ImageIndex 은(는) 0부터 시작하는 반면, VisualApplets GUI의 시뮬레이션 모듈 내 이미지 번호는 1부터 시작합니다. 값은 다음과 같이 매핑됩니다:

ImageIndex = 0 VisualApplets GUI의 뷰어에서 이미지 1을 나타냅니다.

ImageIndex = 1 VisualApplets GUI의 뷰어에서 이미지 2를 나타냅니다.

ImageIndex = 2 VisualApplets GUI의 뷰어에 있는 이미지 3을 참조하며,

이와 같은 방식으로 계속됩니다.

정보: VisualApplets의 GUI에서는 다음 시뮬레이션 주기에서 사용되는 이미지의 인덱스가 대괄호 안에 표시되며 앞에 "sim"이 붙습니다(예: sim[2]).

설정하려는 속성을 식별하려면 KernelRow 및 KernelCol 읽어올 커널 요소를 지정합니다.

시뮬레이션 이미지의 커널 크기는 시뮬레이션 모듈이 연결된 링크의 링크 Properties에서 확인할 수 있습니다. 1개보다 큰 커널 크기를 가진 링크 앞에는 항상 커널 지정을 허용하는 오퍼레이터의 인스턴스가 선행됩니다(예: FIRkernelNxM).

커널의 열과 행 카운팅은 0부터 시작합니다. 따라서 요소가 하나뿐인 커널의 경우 두 값 모두 0으로 설정합니다.

요소가 4개인 커널의 경우 다음과 같이 개별 커널 요소를 식별합니다.

요소가 9개인 커널의 경우 다음과 같이 개별 커널 요소를 식별합니다.

파라미터 Component 을(를) 사용하여 픽셀에서 읽어올 색상 성분을 지정합니다. 그레이스케일 이미지의 경우 Component 을(를) 0으로 설정합니다. 멀티 컴포넌트 이미지(컬러)의 경우 색상 모델에서의 위치를 통해 읽어올 컴포넌트를 지정합니다. 예: RGB 이미지에서 레드 성분을 읽으려면 Component 을(를) 0으로 설정하고, RGB 이미지에서 그린 성분을 읽으려면 Component 을(를) 1로 설정하거나 다음과 같이 설정합니다. Component RGB 이미지에서 파란색 성분을 읽으려면 2로 설정합니다.

위치(X,Y)를 사용하여 이미지 내 읽기 시작점(첫 번째 픽셀)을 정의합니다.

파라미터를 사용하지 않는 경우 Width, 정확히 하나의 픽셀 값이 반환됩니다. 다음만 지정하는 경우 Width, Width 라인의 값이 Y 반환됩니다. 다음을 지정하는 경우 Width 및 Height, Width * Height 값이 반환됩니다. 사용 Width 및 Height 픽셀 값(회색)/픽셀 성분 값(색상)을 읽으려는 ROI(Region of Interest)를 정의할 수 있습니다.

개별 픽셀 값은 앞에 "0x"를 붙이지 않고 16진수로 반환됩니다. 음수 값은 2의 보수 표기법으로 반환됩니다.

GetSimImageProperty

명령 구문
GetSimImageProperty FullSimModuleName Property ImageIndex [LineIndex [LineCount] ]

시뮬레이션 이미지의 속성을 검색하기 위한 명령어입니다(소스 또는 프로브 모듈 내).

에 대해 다음 값이 Property 사용 가능합니다:

LineWidth: 대상을 통해 정의 LineIndex 너비에 대한 정보를 가져올 라인입니다. 사용하는 경우 LineCount, 여러 개의 너비 값(목록 형태)을 얻을 수 있습니다. 첫 번째 값은 다음 라인의 너비가 됩니다. LineIndex.

SaveImage

명령 구문
SaveImage FullSimProbeName {ImageIndex} ImageBaseName

시뮬레이션 프로브에서 결과 이미지 하나 또는 전체를 저장하기 위한 명령어입니다.

선택적 매개변수 사용 ImageIndex 결과 이미지 중 특정 이미지를 저장하려는 경우입니다. 사용하지 마십시오 ImageIndex 또는 프로브의 모든 이미지를 저장하려면 -1로 설정하십시오.

설정하려는 속성을 식별하려면 ImageBaseName 을(를) 설정하여 이미지(들)를 저장할 파일 시스템의 디렉터리 경로와 이미지 파일의 파일 이름을 지정합니다. 지정한 디렉터리가 파일 시스템에 이미 존재하는지 확인하십시오. 그렇지 않은 경우 명령어를 사용하여 생성할 수 있습니다. MakeDirectoryPath (참조).

예: "c:/images/testimage". 저장 프로세스 중에 파일 이름 확장자(예: *.tif)가 이름에 자동으로 추가됩니다.

프로브의 모든 이미지를 저장하는 경우, 파일 이름에 이미지 인덱스가 자동으로 추가됩니다.

예 1:

다음과 같이 입력합니다.

SaveImage Process0/mySimProbe c:/images/testimage

을(를) 사용하여 다음 파일을 가져옵니다:

c:/images/testimage_0001.tif

c:/images/testimage_0002.tif

c:/images/testimage_0003.tif

…

예 2:

다음과 같이 입력합니다.

SaveImage Process0/mySimProbe 4 c:/images/testimage

을(를) 사용하여 다음 파일을 가져옵니다:

c:/images/testimage.tif

Building the Design

Drc

명령 구문
Drc [SaveLogfileName]

디자인 규칙 검사 1단계(DRC 1)를 시작하기 위한 명령어입니다.

로그 출력을 얻으려면 매개변수에서 html 로그 파일(*.html)의 경로와 이름을 선택적으로 지정할 수 있습니다. [SaveLogfileName].

Drc2

명령 구문
Drc2 Name Platform

디자인 규칙 검사 2단계(DRC 2)를 시작하기 위한 명령어입니다.

로그 출력을 얻으려면 매개변수에서 html 로그 파일(*.html)의 경로와 이름을 선택적으로 지정할 수 있습니다. [SaveLogfileName].

SelectBuildConfiguration

명령 구문
SelectBuildConfiguration ConfigurationName

저장된 빌드 구성 중 하나를 활성 빌드 구성으로 선택하기 위한 명령어입니다.

파라미터에 원하는 빌드 구성의 이름을 지정합니다. ConfigurationName.

사용 가능한 모든 빌드 구성을 확인하려면 다음을 입력하십시오. SelectBuildConfiguration ? - 사용 가능한 모든 빌드 구성의 이름 목록이 반환됩니다. 현재 선택된 빌드 구성이 목록의 첫 번째 항목에 표시됩니다.

예:

이 명령어는 현재 선택된 빌드 구성을 반환합니다. 이 반환 값을 통해 빌드 구성 재설정이 성공했는지 확인할 수 있습니다.

예:

Build

명령 구문
Build [SaveLogfilename [MaxTime] ]

빌드 프로세스를 시작하기 위한 명령어입니다.

로그 출력을 얻으려면 매개변수에서 html 로그 파일(*.html)의 경로와 이름을 선택적으로 지정할 수 있습니다. [SaveLogfileName].

빌드 프로세스에 시간 제한을 설정하려면 매개변수에서 최대 빌드 시간을 선택적으로 지정할 수 있습니다. [MaxTime] (단위: 시간). 매개변수 [MaxTime] 의 형식은 부동 소수점입니다. 이를 통해 1시간 미만의 시간 단위도 지정할 수 있습니다. 기본 설정값 [MaxTime] 은(는) 24시간입니다.

로그 파일을 생성하는 명령어 예시 build_log.html 및 최대 빌드 시간을 0.5시간으로 지정:

Build build_log.html 0.5

파일, 경로, 프로그램 인스턴스 및 메시지 처리

Source

명령 구문
Source FilePath

파일에서 TCL 스크립트를 실행하기 위한 명령입니다. 경로를 지정할 때 슬래시(/)를 사용하십시오. 이 명령은 다음과 같은 TCL 명령처럼 작동합니다. source, 단 다음과 같은 자리 표시자(예: 명령)를 자동으로 바꿉니다. MakeDirectoryPath):

%UserDir%: 현재 사용자의 사용자 데이터 디렉토리(예: c:/Users/Smith)

%AppDataDir%: VisualApplets 애플리케이션 데이터 디렉터리

%VaInstallDir%: VisualApplets 설치 디렉터리

%UserLibDir%: 사용자 라이브러리 디렉터리

%CustomLibDir%: 사용자 지정 라이브러리 디렉터리

%VaVersion%: VisualApplets 프로그램 버전(예: "3.1")

%CurrDateTime%: ISO 8601(기본 형식)에 따른 현재 날짜 및 시간(예: "20170530T134522")

%DateTime%: ISO 8601(기본 형식)에 따른 VisualApplets 시작 시의 날짜 및 시간(예: "20170530T134350")

%CurrDesignDir%: 현재 로드된 디자인이 저장되어 있는 디렉토리입니다.

MakeDirectoryPath

명령 구문
MakeDirectoryPath FullPath

원하는 깊이의 경로(및 해당 디렉토리)를 생성하는 명령어입니다.

이 명령어는 다음과 같은 플레이스홀더를 자동으로 대체합니다.

%UserDir%: 현재 사용자의 사용자 데이터 디렉토리(예: c:/Users/Smith)

%AppDataDir%: VisualApplets 애플리케이션 데이터 디렉터리

%VaInstallDir%: VisualApplets 설치 디렉터리

%UserLibDir%: 사용자 라이브러리 디렉터리

%CustomLibDir%: 사용자 지정 라이브러리 디렉터리

%VaVersion%: VisualApplets 프로그램 버전(예: "3.1")

%CurrDateTime%: ISO 8601(기본 형식)에 따른 현재 날짜 및 시간(예: "20170530T134522")

%DateTime%: ISO 8601(기본 형식)에 따른 VisualApplets 시작 시의 날짜 및 시간(예: "20170530T134350")

%CurrDesignDir%: 현재 로드된 디자인이 저장되어 있는 디렉토리입니다.

명령어가 성공적으로 수행되면 절대 경로가 반환됩니다.

GetAbsolutePath

명령 구문
GetAbsolutePath Path

파라미터에서 지정한 경로의 절대 경로를 반환합니다. Path.

이 명령어는 다음 명령어와 동일한 별칭(플레이스홀더)을 자동으로 대체합니다. MakeDirectoryPath.

다음 항목에서 참조할 수 있습니다. Path 존재하지 않는 디렉토리나 파일을 참조하도록 하여, 결과 경로 이름이 존재하지 않는 디렉토리나 파일을 가리키도록 할 수 있습니다.

Wait

명령 구문
Wait TimeInMilliseconds

지정된 시간 동안 대기하기 위한 명령어입니다. TimeInMilliseconds. 대기 시간 동안 VisualApplets GUI는 활성 상태를 유지합니다.

설정하는 경우 TimeInMilliseconds 0으로 설정하면 VisualApplets에서 GUI의 이벤트 루프 업데이트가 최소 한 번 수행됩니다. 이를 사용하여 GUI에 이전 명령의 결과가 표시되도록 할 수 있습니다.

Message

명령 구문
Message Type Code Text

출력하기 위한 명령어입니다.

• 오류 메시지(Type=error),
• 경고(Type=warning), 또는
• 정보 메시지(Type=info)

에서 Code, 메시지의 메시지 코드를 정의합니다. Code 은(는) -999부터 +999까지의 값 범위를 갖습니다. 현재 및/또는 향후 버전의 VisualApplets와의 충돌을 방지하려면 이 범위 내의 값만 사용하십시오.

설정하려는 속성을 식별하려면 Text 메시지를 입력하려면 사용하십시오. 메시지는 자동으로 마침표로 완성됩니다.

Exit

명령 구문
Exit [Mode]

현재 VisualApplets 세션을 종료하기 위한 명령어입니다. 다음을 사용할 수 있습니다. Exit 여전히 디자인이 열려 있는 경우에도 마찬가지입니다. 하지만 그 전에 변경 사항을 저장하는 것을 잊지 마십시오.

디자인이 여전히 열려 있고 해당 디자인에 저장되지 않은 변경 사항이 포함되어 있는 경우:

• 선택적 파라미터를 설정하는 경우 Mode 에서 Discard, 아직 저장하지 않은 변경 사항이 포함되어 있더라도 열려 있는 디자인이 닫힙니다. 저장되지 않은 변경 사항은 취소됩니다.
• 사용하는 경우 Exit 파라미터를 사용하지 않고 Mode 열려 있는 디자인에 저장되지 않은 변경 사항이 포함되어 있어도 명령이 종료되며 해당 오류 메시지가 표시됩니다.