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 디자인 형식으로 저장됩니다. 파일의 모든 내용이 저장됩니다. *.va 파일 형식을 VisualApplets 디자인의 기본 데이터 형식으로 사용하십시오.
• 다음에서 파일 확장자 ".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

이 예제 명령어의 의미는 다음과 같습니다. 연산자(operator)의 인스턴스(모듈)를 생성합니다. BRANCH. 최상위 레벨의 프로세스 0에 이 모듈을 배치하고 이름을 ‘branch’로 지정하십시오. 출력 포트 3개를 생성하고(출력용 멀티포트 기본 이름은 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 유니코드 문자를 사용할 수 있습니다. 주석을 따옴표로 묶는 것을 잊지 마세요. 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 내보내기 전용입니다. 주소가 지정된 열거형 매개변수를 설정하는 명령어입니다. Value enum 값의 문자열입니다.

예시 (연산자 인스턴스의 경우 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 내보내기 용도로만 사용됩니다. 매개변수를 정적(static)으로 설정하는 명령어입니다. 매개변수가 정적 및 동적 모두 가능할 경우, 대부분의 경우 해당 매개변수는 기본적으로 동적으로 설정됩니다. 이러한 매개변수를 정적으로 설정하려면 이 명령어를 사용하십시오.

정보

이 명령어는 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: 요청된 매개변수가 동적일 경우 1을 반환하고, 그렇지 않으면 0을 반환합니다.
• isStatic: 요청된 매개변수가 정적일 경우 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.
  • 열거형 매개변수의 경우, 이 명령어는 열거형 이름과 열거형 값으로 구성된 쌍의 목록을 반환합니다.

GetLinkProperty

명령 구문
GetLinkProperty FullModuleName PortName Property

이 명령어는 특정 링크의 특정 속성을 반환합니다. 만약, FullModuleName 및 PortName, 계층적 상자의 특정 포트를 지정할 경우, 해당 계층적 상자 내에서 해당 포트로 연결되거나 해당 포트에서 연결되는 링크가 있는 한 이 명령은 정상적으로 작동합니다.

매개변수에 대한 다음 옵션 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 시뮬레이션 소스의 (Type = source) 또는 시뮬레이션 프로브 (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

계층 구조의 디자인 창을 열고(활성 상태로 설정하는) 명령 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: 이미지 파일의 비트 폭 설정을 정수 값으로 반환합니다. BITS. 허용되는 값은 1, 8, 16입니다.
• imageFileNormalize: 시뮬레이션 결과 이미지 저장 설정에 따라 1 또는 0을 반환합니다. 1로 설정된 경우, 1비트 시뮬레이션 결과를 8비트 * 파일로 저장하는 동안 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에서 이미지 내의 결과를 시각화하기 위해.

이미지의 변경 내용은 일시적입니다. 동일한 시뮬레이션 모듈의 다른 이미지를 선택하거나 변경된 이미지를 다시 선택하는 즉시, 변경된 이미지는 하드 디스크에서 새로 불러오게 되며 변경 내용은 모두 삭제됩니다. (새 이미지를 위한 명령을 입력하면 다른 이미지를 선택하게 됩니다.) ImageIndex (TCL 콘솔에서 (동일한 시뮬레이션 모듈의) 이미지를 입력하거나, VisualApplets GUI의 뷰어에서 동일한 시뮬레이션 모듈의 다른 이미지를 클릭하면.)

하지만, 수정된 이미지가 활성 상태인 동안 새 파일 이름으로 저장하면 변경 사항을 영구적으로 적용할 수 있습니다.

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

픽셀당 하나의 값: 명령 SetSimImageData 픽셀당 정확히 하나의 값만 기록할 수 있습니다. 따라서 그레이스케일 픽셀의 경우, 다음 명령을 실행해야 합니다. SetSimImageData 픽셀당 전체 색상 정보를 기록하는 데 단 한 번만 필요합니다. 컬러 픽셀의 경우, 픽셀당 세 가지 색상 구성 요소 중 하나만 기록할 수 있습니다. 따라서 컬러 픽셀의 세 가지 색상 구성 요소를 모두 변경하려면 다음 명령을 실행해야 합니다. SetSimImageData 세 번.

커널이 있는 이미지에 쓰기: 커널이 설정된 이미지에 데이터를 기록할 때, `command`를 사용할 경우 (덮어쓰고자 하는 (첫 번째) 픽셀의 정확한 위치 외에도) 해당 픽셀의 어떤 커널 요소를 덮어쓸지 지정해야 합니다. 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, 하지만 다음의 자리 표시자(예: command 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까지입니다. VisualAppets의 현재 버전 및 향후 버전과의 충돌을 방지하려면 이 범위 내의 값만 사용하십시오.

설정하려는 속성을 식별하려면 Text 메시지를 입력하려면 여기를 누르세요. 메시지 끝에는 자동으로 점이 추가됩니다.

Exit

명령 구문
Exit [Mode]

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

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

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