VisualApplets
Operator Reference

Library Parameters는 디자인 타임과 런타임 모두에서 디자인을 매개변수화하는 데 다음과 같은 몇 가지 주요 이점을 제공합니다:

파라미터 라이브러리의 장점은 디자인의 실제 데이터 흐름 구조를 건드리지 않고도 디자인 내의 파라미터 값 사이에 연결(넷 또는 체인)을 설정할 수 있다는 것입니다.

Library Parameters에는 7개의 레퍼런스 오퍼레이터와 4개의 변환 오퍼레이터가 포함되어 있습니다. 두 오퍼레이터 유형에 대한 자세한 내용은 아래를 참조하십시오.

You find example designs using the operators of the Parameters Library in your VisualApplets installation: <installation_directory>\VisualApplets\Examples\AdvancedVAFunctions\Parameters Library.

************************************************************

레퍼런스 오퍼레이터

Parameters 라이브러리의 Reference 오퍼레이터를 사용하면 오퍼런스 오퍼레이터의 맵 파라미터 Value(또는 Field)에 오퍼레이터 파라미터를 1:1로 매핑할 수 있습니다. "Reference" 파라미터에서 참조할 파라미터(경로 및 이름)를 지정합니다.

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

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

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

맵 파라미터를 설정하려면 간단히 2~3단계만 거치면 됩니다.

모든 맵 파라미터는 환경에 의해 일반 파라미터로 취급됩니다. Framegrabber API 또는 Framegrabber SDK 도구(microDiagnostics 및 microDisplay)를 사용하여 "원본" 오퍼레이터 파라미터에 액세스하는 것과 동일한 방식으로 이들에 액세스할 수 있습니다.

레퍼런스 오퍼레이터의 각 인스턴스를 사용하면 디자인 내 모든 파라미터의 값과 레퍼런스 오퍼레이터 인스턴스의 맵 파라미터(파라미터 Value) 사이에 1:1 관계를 설정할 수 있습니다.

레퍼런스 오퍼레이터에서 지원하는 데이터 유형:

맵 파라미터를 생성하려면 먼저 하나의 레퍼런스 오퍼레이터를 인스턴스화해야 합니다. 지원되는 각 데이터 유형별로 하나의 레퍼런스 오퍼레이터를 사용할 수 있습니다.

Reference Operators를 사용하여 맵 값을 생성하는 절차:

아래 예시에서는 이름이 Reference Operator Example인 operator IntParamReference의 인스턴스가 모듈 Buffer의 파라미터 YLength에 연결됩니다. 이 예시에서 두 모듈(Reference Operator Example 및 Buffer)은 동일한 계층 수준에 위치합니다.

참조된 파라미터의 경로:

참조된 파라미터:

본 예시에서는 operator Buffer의 파라미터 YLength 값이 이제 reference operator 인스턴스의 파라미터 Value에서도 사용 가능합니다:

reference operator의 파라미터 Value를 사용하여 다양한 작업을 수행할 수 있습니다.

예를 들어, 파라미터 Value에 있는 값을 디자인 내의 다른 위치에 있는 또 다른 모듈(operator 인스턴스 또는 계층형 상자)에서 사용할 수 있게 만들 수 있습니다. 방법은 다음과 같습니다:

본 예시에서 reference operator 인스턴스의 파라미터 Value는 모듈 ModuleWithConnectedParameter의 새로운 파라미터 ConnectionToYLengthInModuleBuffer에 연결됩니다:

파라미터 Activate가 "Yes"로 설정된 상태에서 Apply 버튼을 클릭하면, 연결된 모듈에 새 파라미터가 올바른 값과 함께 표시됩니다:

따라서 모듈 ModuleWithConnectedParameter의 새 파라미터 ConnectionToYLengthInModuleBuffer는 모듈 Buffer의 파라미터 YLength와 동일한 값을 갖게 됩니다.

매핑은 reference operator 인스턴스에 의해 수행됩니다.

세 모듈 중 하나의 연결된 파라미터가 재설정되면, 다른 모든 모듈의 값도 함께 재설정됩니다:

계층형 박스(Hierarchical Boxes):

Parameters 라이브러리의 Reference 연산자를 사용하면 디자인의 파라미터를 원하는 계층 수준(디자인 내)에서 사용할 수 있습니다. 이는 보호된 계층형 박스 내부에 깊게 중첩된 파라미터를 런타임 중에 매개변수화하려는 경우(즉, 동적 쓰기 파라미터로 사용할 수 있도록 하려는 경우) 특히 유용합니다. 계층형 박스의 손쉬운 매개변수화를 허용하기 위해, 이제 계층형 박스 자체가 파라미터를 가질 수 있습니다(계층형 박스 자체의 Properties에 있는 파라미터로 지정됨).

Reference 연산자를 사용하면 계층형 박스의 표면(계층형 박스의 Properties)에서 깊게 임베디드되어 있을 수 있는 특정 파라미터로의 경로를 설정할 수 있습니다. 이렇게 하면 보호된 계층형 박스(또는 다른 보호된 계층형 박스 내부에 중첩된 보호된 계층형 박스)에 있는 파라미터라 할지라도 런타임 중에 설정 및 재설정할 수 있습니다. 해당 파라미터의 매개변수화 인터페이스가 접근이 제한되지 않는 상위 계층 수준으로 끌어올려지기 때문입니다.

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

우리 예시에서 이는 모듈 ReferenceOperatorExample의 파라미터 Value뿐만 아니라 모듈 ModuleWithConnectedParameter의 파라미터 ConnectionToYLengthInModuleBuffer도 참조할 수 있음을 의미합니다.

참조 연산자 인스턴스 ReferenceOperatorExample의 파라미터 Value에 대한 참조:

모듈 ModuleWithConnectedParameter의 파라미터 ConnectionToYLengthInModuleBuffer에 대한 참조:

사용 가능한 6개의 참조 연산자를 통해 보호된 계층형 박스에서 파라미터 값으로 발생할 수 있는 모든 데이터 타입이 제공됩니다.

************************************************************

변환 연산자(The Translation Operators)

Parameters 라이브러리의 변환 연산자를 사용하면 하나 이상의 다른 연산자 파라미터에 대해 변환된 접근이 가능합니다.

계산을 위해 공식을 정의합니다. 이러한 공식의 구문은 GenICam API 버전 2.0을 준수하며 아래에 설명되어 있습니다.

읽기 작업(Read Action):

파라미터 ReadAction에서는 변환 연산자의 파라미터 Value에 대한 읽기 접근이 발생할 때 수행될 동작을 정의합니다.

참조 연산자와의 주요 차이점 중 하나는 변환 연산자가 단순히 값을 보유하는 것이 아니라는 점입니다. 대신, 파라미터 Value의 값은 공식으로부터 계산됩니다. 이 공식은 파라미터 ReadAction에서 정의합니다.

파라미터 Value에 대한 읽기 접근이 발생하는 즉시, ReadAction에서 정의한 공식이 실행되고 그 결과가 값을 요청한 요소로 전달됩니다.

공식에는 디자인 내 어디에 있든 연산자 파라미터의 값이 포함될 수 있습니다. 이 값들 중 하나라도 변경되는 즉시, 변환 연산자의 파라미터 Value 계산은 이전 파라미터 Value가 가졌던 값과 다른 새로운 결과를 산출하게 됩니다.

공식에는 파라미터의 값뿐만 아니라 최소값, 최대값, 스텝 크기 또는 열거형 항목의 수치 값과 같은 파라미터의 특정 속성도 포함될 수 있습니다.

Write Action

파라미터 WriteAction에서는 변환 연산자의 파라미터 Value에 대한 쓰기 접근 중에 수행될 동작을 정의합니다.

참조 연산자와 달리, 파라미터 Value의 값을 디자인 내의 다른 파라미터로 단순 전달하지 않습니다. 대신, 파라미터 Value의 값은 변환 연산자의 파라미터 WriteAction에서 정의하는 일련의 쓰기 작업에 사용됩니다. 쓰기 작업은 하나 또는 여러 개의 방정식으로 구성됩니다. 이 방정식들의 좌측을 통해 어떤 연산자의 어떤 파라미터가 계산 결과를 받을지 정의합니다. 둘 이상의 방정식을 정의하는 경우 세미콜론으로 방정식을 구분하십시오.

파라미터 Value에 대한 쓰기 접근이 발생하는 즉시, 파라미터 WriteAction에서 정의한 방정식의 우측에 있는 공식이 실행되며 그 결과가 방정식의 좌측에 지정된 파라미터로 전달됩니다.

공식은 디자인 내 어디에 있든 연산자 파라미터의 값을 참조할 수 있습니다. 이 값들 중 하나가 변경되면, 이전에 쓰였던 것과 동일한 값을 Value 파라미터에 다시 쓸 때 계산 결과가 달라지게 됩니다.

공식에는 파라미터의 값뿐만 아니라 최소값, 최대값, 스텝 크기 또는 열거형 항목의 수치 값과 같은 파라미터의 특정 속성도 포함될 수 있습니다.

데이터 타입(Data Types):

선택한 연산자에 따라 파라미터 Value의 데이터 타입이 정의됩니다. 즉:

Operator IntParamTranslator -> 정수 값

Operator FloatParamTranslator -> 부동소수점 정수 값

Operator EnumParamTranslator -> 열거형(enumeration)의 값

그러나 operator가 해당 파라미터 Value의 타입을 정의하더라도, 쓰기 또는 읽기 작업 중에 액세스되는 파라미터의 데이터 타입은 제한하지 않습니다. 예를 들어 operator IntParamTranslator는 파라미터 Value의 타입이 정수라고 정의하지만, operator에 정의된 수식에는 예를 들어 double 타입의 파라미터에 대한 액세스가 포함될 수 있습니다.

값 범위 계산을 위한 수식

파라미터 Value의 현재 값 범위를 계산하는 수식을 추가할 수도 있습니다. 해당 수식은 파라미터 RangeFrom, RangeTo, RangeIncrement(증분 크기)에 정의합니다.

수식에는 디자인 내 모든 위치의 모듈 파라미터 값뿐만 아니라 최소값, 최대값, 증분 크기, 열거형 항목의 숫자 값과 같은 이러한 파라미터의 특정 Property도 포함될 수 있습니다.

Referencing Global Constants

모듈 파라미터 및 해당 Property에 액세스하는 것 외에도 변환 수식은 전역 상수를 참조할 수 있습니다. 전역 상수는 파라미터 변환 표현식에서 사용할 수 있는 시스템 전체의 값을 제공합니다.

변환 수식에서 다음을 사용하여 전역 상수를 지정할 수 있습니다. :: prefix. The general syntax is ${::ConstantName}, 예: ${::DesignClock} 또는 ${::ConstantName}

변환 수식에서 사용할 수 있는 다음 표준 전역 상수가 기본적으로 제공됩니다:

활성화되어 있을 때 Value is static, you can create user-defined global constants by setting the DisplayHierarchy module parameter to :: (으)로 IntVariable, FloatVariable, IntParamTranslator, 또는 FloatParamTranslator operators. 변환 수식에서 사용할 전역 상수가 생성됩니다. 다음을 사용하여 액세스할 수 있습니다. ${::myGlobalConst}.

Operator List

다음 목록은 Library Parameters의 모든 Operator를 요약합니다.