VisualApplets
Operator Reference

라이브러리 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)를 통해 “원본” 연산자 매개변수에 접근하는 것과 동일한 방식으로 이 매개변수들에 접근할 수 있습니다.

참조 연산자의 각 인스턴스를 사용하면 설계 내의 임의의 매개변수 값과 참조 연산자 인스턴스의 맵 매개변수(매개변수 값) 사이에 1:1 관계를 설정할 수 있습니다.

참조 연산자가 지원하는 데이터 유형:

맵 매개변수를 생성하려면 먼저 참조 연산자 하나를 인스턴스화해야 합니다. 사용 가능한 각 데이터 유형마다 하나의 참조 연산자를 사용할 수 있습니다:

참조 연산자를 사용하여 맵 값을 생성하는 절차:

아래 예제에서는, “Reference Operator Example”이라는 이름의 IntParamReference 연산자 인스턴스가 “Buffer” 모듈의 YLength 매개변수에 연결됩니다. 이 예제에서 두 모듈 (Reference Operator Example 및 Buffer)은 모두 동일한 계층 수준에 위치합니다.

참조된 매개변수의 경로:

참조된 매개변수:

이 예제에서, 연산자 Buffer의 매개변수 YLength 의 값은 이제 참조 연산자 인스턴스의 매개변수 Value에서도 사용할 수 있습니다:

참조 연산자에 ‘Value’ 매개변수를 사용하면 다양한 작업을 수행할 수 있습니다.

예를 들어, 매개변수 Value에 저장된 값을 설계의 어느 곳에서나 또 다른 모듈(연산자 인스턴스 또는 계층적 박스)에서 사용할 수 있도록 할 수 있습니다. 이를 위해서는 다음과 같이 하십시오:

이 예제에서, 참조 연산자 인스턴스의 매개변수 Value는 ModuleWithConnectedParameter 모듈의 새로운 매개변수 ConnectionToYLengthInModuleBuffer에 연결되어 있습니다:

Activate 매개변수가 "Yes"로 설정된 경우, 다음 버튼을 적용 버튼을 클릭하면, 연결된 모듈에 새 매개변수가 올바른 값과 함께 표시됩니다:

따라서, 모듈 ModuleWithConnectedParameter 의 새로운 매개변수 ConnectionToYLengthInModuleBuffer는 모듈 Buffer의 매개변수 YLength 와 동일한 값을 가집니다.

매핑 작업은 참조 연산자 인스턴스에 의해 수행됩니다.

세 모듈 중 어느 하나에 연결된 매개변수가 재설정되면, 해당 값은 다른 모든 모듈에서도 재설정됩니다:

계층적 상자:

“Parameters” 라이브러리의 참조 연산자를 사용하면 설계의 어떤 계층 수준에서든 원하는 매개변수를 사용할 수 있게 할 수 있습니다. 이는 실행 시점에 보호된 계층적 박스 깊숙이 중첩된 매개변수의 매개변수화를 허용하고자 할 때(즉, 이를 동적 쓰기 매개변수로 사용할 수 있게 하려는 경우)에 특히 유용합니다. 계층적 박스의 매개변수화를 용이하게 하기 위해, 이제 계층적 박스 자체가 매개변수를 포함할 수 있습니다(계층적 박스 자체의속성 내 매개변수 형태로).

참조 연산자를 사용하면 계층적 상자의 표면(계층적 상자의 속성 )에서 깊숙이 중첩된 특정 매개변수까지 경로를 설정할 수 있습니다. 이러한 방식으로, 보호된 계층적 박스 내의 매개변수(또는 다른 보호된 계층적 박스 내에 중첩된 보호된 계층적 박스 내의 매개변수)조차도 런타임 중에 설정 및 재설정할 수 있습니다. 이는 해당 매개변수화 인터페이스가 계층 구조 내에서 접근 제한이 없는 계층 수준으로 상향 조정되기 때문입니다.

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

이 예제에서 이는 `ReferenceOperatorExample ` 모듈의 매개변수 Value는 물론, `ModuleWithConnectedParameter` 모듈의 매개변수 ConnectionToYLengthInModuleBuffer도 참조할 수 있음을 의미합니다. Value는 `ModuleWithConnectedParameter` 모듈의 매개변수입니다.

매개변수 참조 참조의 값 연산자 인스턴스 ReferenceOperatorExample:

모듈 ModuleWithConnectedParameter의 매개변수 ConnectionToYLengthInModuleBuffer 참조:

사용 가능한 6개의 참조 연산자를 통해, 보호된 계층적 박스 내에서 매개변수 값으로 사용될 수 있는 모든 데이터 유형이 제공됩니다.

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

번역 연산자

매개변수 라이브러리의 변환 연산자를 사용하면 하나 또는 여러 개의 다른 연산자의 매개변수에 변환된 형태로 접근할 수 있습니다.

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

읽기 작업:

ReadAction 매개변수에서는 번역 연산자의 Value 매개변수에 대한 읽기 액세스 시 어떤 동작이 수행될지 정의합니다.

참조 연산자와의 주요 차이점 중 하나는, 변환 연산자가 단순히 값을 보유하지 않는다는 점입니다. 대신, 매개변수 Value의 값은 수식을 통해 계산됩니다. 이 수식은 매개변수 ReadAction에서 정의합니다.

매개변수 Value에 대한 읽기 액세스가 발생하자마자, ReadAction에서 정의한 수식이 실행되고 그 결과가 값을 요청한 요소로 전달됩니다.

수식에는 설계 내 어디에서나 연산자 매개변수의 값이 포함될 수 있습니다. 이러한 값 중 하나가 변경되는 즉시, 변환 연산자의 매개변수 Value에 대한 계산 결과는 (이전에 매 개변수 Value가 가졌던 값과는 다른) 새로운 값이 됩니다.

이 공식은 매개변수의 값뿐만 아니라, 최소값, 최대값, 단계 크기, 또는 열거 항목의 수치와 같은 매개변수의 특정 속성도 포함할 수 있습니다.

Write Action

WriteAction 매개변수에서는 번역 연산자의 Value 매개변수에 대한 쓰기 액세스 시 어떤 동작이 수행될지 정의합니다.

참조 연산자와는 달리, 매개변수 Value의 값을 설계 내의 다른 매개변수로 단순히 전달하는 것이 아닙니다. 대신, 매개변수 Value의 값은 변환 연산자의 매개변수 WriteAction에서 정의한 일련의 쓰기 동작에 사용됩니다. 쓰기 작업은 하나 이상의 방정식으로 구성됩니다. 이 방정식들의 좌변을 통해 어떤 연산자의 어떤 매개변수가 계산 결과를 수신할지 정의합니다. 두 개 이상의 방정식을 정의할 경우, 방정식들을 세미콜론으로 구분하십시오.

매개변수 Value에 쓰기 액세스 요청이 발생하면, 매개변수 WriteAction에서 정의한 방정식의 우측에 있는 수식(들)이 실행되고, 그 결과가 방정식의 좌측에 지정된 매개변수들로 전달됩니다.

이 수식은 설계 내 어디에나 있는 연산자 매개변수의 값을 참조할 수 있습니다. 이러한 값 중 하나가 변경되는 즉시, 이전에와 마찬가지로 동일한 값을 ‘값’ 매개변수에 다시 입력하면 계산 결과가 달라집니다.

이 공식은 매개변수의 값뿐만 아니라, 최소값, 최대값, 단계 크기, 또는 열거 항목의 수치와 같은 매개변수의 특정 속성도 포함할 수 있습니다.

데이터 유형:

선택한 연산자는 해당 매개변수의 데이터형을 결정합니다. 값, 즉:

IntParamTranslator 연산자 -> 정수 값

연산자 FloatParamTranslator -> float integer 값

EnumParamTranslator 연산자 -> 열거형의 값

그러나 연산자가 매개변수 Value의 형식을 정의하더라도, 쓰기 또는 읽기 연산 중에 액세스되는 매개변수의 데이터 형식은 제한하지 않습니다. 예를 들어, 연산자 IntParamTranslator는 매개변수 Value의 유형을 정수형으로 정의하지만, 이 연산자에 정의된 수식에는 예를 들어 double 유형의 매개변수에 대한 접근이 포함될 수 있습니다.

값 범위 계산 공식

또한 매개변수 Value의 현재 값 범위를 계산하는 수식을 추가할 수도 있습니다. 해당 수식은 RangeFrom, RangeTo 및 RangeIncrement (단계 크기) 매개변수에서 정의합니다.

수식에는 설계의 어느 부분에서나 모듈 매개변수의 값은 물론, 최소값, 최대값, 단계 크기 또는 열거 항목의 수치와 같은 해당 매개변수의 특정 속성도 포함될 수 있습니다.

전역 상수 참조

모듈 매개변수 및 해당 속성에 접근하는 것 외에도, 변환 식에서는 전역 상수를 참조할 수 있습니다. 전역 상수는 매개변수 변환 식에서 사용할 수 있는 시스템 전체에 적용되는 값을 제공합니다.

번역 공식에서는 다음을 사용하여 전역 상수를 참조할 수 있습니다. :: 접두사. 일반적인 구문은 다음과 같습니다. ${::ConstantName}, 예를 들어 ${::DesignClock} 또는 ${::ConstantName}

다음과 같은 표준 전역 상수들은 번역 공식에서 사용할 수 있도록 기본적으로 제공됩니다:

언제 Value 정적이라면, 다음을 설정하여 사용자 정의 전역 상수를 생성할 수 있습니다. DisplayHierarchy 모듈 매개변수 ~ :: (으)로 설정합니다. IntVariable, FloatVariable, IntParamTranslator, 또는 FloatParamTranslator 연산자. 이렇게 하면 변환 공식에서 사용할 전역 상수가 생성됩니다. 다음과 같이 사용하여 이 상수에 접근할 수 있습니다. ${::myGlobalConst}.

운영자 목록

다음 목록은 라이브러리 매개변수의 모든 연산자를 요약한 것입니다.