IntFieldParamReference 오퍼레이터

Operator Library: Parameters

이 오퍼레이터는 디자인 내에 있는 임의의 field 파라미터로부터 (파라미터 Field에) 1:1 맵 파라미터를 생성합니다. 참조할 파라미터(경로 및 이름)는 파라미터 Reference에 지정합니다.

참조되는 필드 파라미터는 VA_SINTFIELD 또는 VA_UINTFIELD 형식 중 하나일 수 있습니다. 맵 파라미터는 참조된 파라미터의 모든 속성을 미러링합니다.

Since there are no field parameters specified in the GenICam standard, the created GenICam API and the created Framegtabber API code (FgLib) vary on this point. In the GenICam API code, the two parameters <DisplayName>_Index and <DisplayName>_Value are created.

참조된 파라미터가 표시되고 액세스될 디자인 계층 내의 대상을 정의할 수 있습니다. 대상은 DisplayHierarchy와 DisplayName이라는 두 가지 파라미터로 정의됩니다. DisplayHierarchy에서는 레퍼런스 오퍼레이터 자체가 위치한 프로세스와 동일한 프로세스 내의 계층적 상자(hierarchical box)를 지정합니다. DisplayName 파라미터에서는 타겟 파라미터의 이름을 설정합니다. DisplayHierarchy와 DisplayName이 모두 설정된 경우, DisplayName으로 정의된 파라미터는 DisplayHierarchy로 지정된 계층적 상자에서 사용할 수 있게 됩니다. DisplayName이 비어 있으면 파라미터가 생성되지 않습니다. DisplayName은 설정되어 있지만 DisplayHierarchy가 비어 있는 경우, DisplayName으로 정의된 파라미터가 상위 계층(즉, 레퍼런스 오퍼레이터 자체가 위치한 계층적 상자)에 추가됩니다.

이를 통해 디자인의 field 파라미터를 원하는 계층 수준에서 사용할 수 있습니다. 예를 들어, 보호된 계층적 상자 내 모듈의 field 파라미터를 보호된 계층적 상자 자체의 속성 바로 아래에서 파라미터화할 수 있도록 만들 수 있습니다.

매핑된 파라미터 자체를 참조할 수도 있습니다. 따라서 참조 연산자에서 Field 파라미터의 내용을 참조하거나, DisplayName 및 DisplayHierarchy 파라미터에서 정의한 파라미터를 참조할 수 있습니다. 이는 보호된 계층적 박스가 다른 보호된 계층적 박스로 구성될 때 특히 중요합니다.

[참고] 연결된 모든 파라미터가 한 번에 업데이트됩니다.

연결된 파라미터 중 하나가 변경되면(참조된 파라미터, 맵 파라미터 Field, 또는 타겟 파라미터), 연결된 다른 모든 파라미터의 값도 함께 변경됩니다.

이 오퍼레이터는 디자인의 데이터 흐름 구조를 방해하지 않으므로 입력과 출력이 없습니다.

라이브러리 파라미터에 대한 일반적인 소개는 Library Parameters에서 확인할 수 있습니다.

예:

맵 파라미터인 FieldValues 이제 Process0/Level0/Level1에서 사용할 수 있습니다:

I/O Properties

Property Value
Operator Type None (입력 또는 출력이 없는 경우)

지원되는 Link Format

None

Parameters

Status
Type 정적 읽기(GUI에는 쓰기로 표시됨) 파라미터
Default 없음
Range OK 또는 오류 메시지

에러 상태를 표시합니다. 파라미터 Activate가 Yes로 설정된 경우, 다른 모듈 파라미터를 확인합니다. 이 파라미터는 이 확인 결과, 즉 OK 또는 에러 메시지를 표시합니다.

이 파라미터는 최종 앱릿에 포함되지 않습니다.

DisplayName
Type 정적 쓰기 파라미터
Default 없음
Range 임의의 문자열

(reference 오퍼레이터 인스턴스 자체 외에) 디자인의 다른 지점에서 참조된 field 파라미터(파라미터 Reference에 정의됨)에 대한 액세스를 허용하거나 그로부터 액세스하려면 새 파라미터를 정의해야 합니다. 여기에 이 새 파라미터의 이름을 지정하십시오.

이 필드가 비어 있으면 새 매개변수가 생성되지 않습니다.

DisplayHierarchy
Type 정적 쓰기 파라미터
Default 없음
Range 임의의 문자열

파라미터 DisplayName에서 정의한 새 맵 파라미터를 연결할 계층적 상자(Hierarchical Box)를 여기에 지정합니다.

이 파라미터에서는 자동 완성 기능과 구문 강조 표시를 사용할 수 있습니다. 자동 완성을 사용하려면 Module Properties 대화 상자에서 이 파라미터의 Parameter Values 필드를 클릭하고 키보드의 TAB 키를 누르세요. 자동 완성 기능에 대한 자세한 지침은 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'에서 확인할 수 있습니다.

새 파라미터 DisplayName을 정의했으나 파라미터 DisplayHierarchy를 비워둔 경우: 새 파라미터는 참조 연산자 인스턴스를 포함하는 계층적 상자에 추가됩니다. (참조 연산자 인스턴스가 최상위(프로세스) 수준에 있는 경우에는 이 작업이 불가능합니다.)

[참고] 표시 대상 경로 설정 구문

새 파라미터가 디자인의 다른 위치에 표시되도록 하려면, 파라미터 DisplayHierarchy에 새 파라미터를 포함할 계층적 상자의 경로를 지정해야 합니다.

구문은 다음과 같습니다:

<Path> is the relative path from process level to the hierarchical level of the design where the <Hierarchical Box> is located that is to receive the new parameter. Thus, parameter DisplayHierarchy can only address hierarchical boxes within the same process. Use a slash as separator between different hierarchical levels.

<HierarchicalBox> is the name of the hierarchical box that is to receive the new map parameter.

예: Level0/Level1

Index
Type dynamic write 파라미터
Default 0
Range UInt

여기서 field 인덱스를 설정합니다.

Value
Type 동적, 쓰기, 읽기 파라미터
Default 0
Range 부호 있는 정수(64비트), 부호 없는 정수(64비트)

파라미터 Index로 지정된 field 항목을 설정하거나 읽습니다.

필드
Type 정적, 동적, 쓰기, 읽기 파라미터
Default 없음
Range 배열

참조된 field 파라미터에 액세스하기 위한 맵 파라미터입니다. 이 파라미터는 참조된 field 파라미터의 모든 속성을 미러링합니다.

설명
Type 정적 쓰기 파라미터
Default -
Range 임의의 텍스트

여기에 매개변수 Value의 설명을 입력하세요.

Reference
Type 정적 쓰기 파라미터
Default 없음
Range 참조된 파라미터를 정의하는 임의의 문자열: 모듈에 대한 상대 경로, 모듈 이름 및 파라미터 이름

여기서는 디자인 내에서 참조된 파라미터의 위치를 정의합니다.

이 파라미터에서는 자동 완성 기능과 구문 강조 표시를 사용할 수 있습니다. 자동 완성을 사용하려면 Module Properties 대화 상자에서 이 파라미터의 Parameter Values 필드를 클릭하고 키보드의 TAB 키를 누르세요. 자동 완성 기능에 대한 자세한 지침은 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'에서 확인할 수 있습니다.

[참고] 참조 구문

구문은 다음과 같습니다:

<Path> is the relative path to the hierarchical level where the referenced module "Module" is located. Use a slash as separator between different hierarchical levels. Define the path as relative path from the hierarchical level the reference operator instance is located in.

<Module> is the name of the module (operator instance or hierarchical box) that contains the referenced parameter.

<ParamName> is the actual name of the referenced parameter.

If <Path> starts with a slash, the path is interpreted as absolute path starting from design level (e.g., /Process0/UUT/LUT.LUTContent).

다음도 사용할 수 있습니다. ../ 상위 레벨로 이동합니다. 단, 자유롭게 복제 또는 재배치 가능한 모듈을 설계할 때는 이 옵션을 사용하지 않도록 주의하십시오.

Activate
Type dynamic write 파라미터
Default 아니요
Range {No,Yes}

Yes = 참조된 파라미터에 대한 및 파라미터로부터의 접근(Map 파라미터 Value를 통해)이 활성화됩니다.

No = 참조된 파라미터에 대한 및 파라미터로부터의 접근이 비활성화되며 파라미터 Status가 비활성화됩니다. 파라미터 DisplayName 및 DisplayHierarchy는 효과가 없습니다.

사용 예

IntFieldParamReference 연산자의 사용법은 다음 예시와 같습니다.

  이전     상위 레벨     다음  
콘텐츠 맨 위로 홈