Global Functions - ABBYY Vantage Documentation

영역 연산
거리 연산
숫자형 데이터 타입에 대한 연산
사각형 및 영역 연산
문자열 연산
XML 파일에 대한 접근
형 변환 및 검사
좌표 연산
데이터 카탈로그에 대한 액세스
Text 형식 Skill Parameter에 대한 액세스
기타

영역 연산

Function	Description
`Area Max( Area a1, Area a2 )`	a1, a2 중 더 큰 영역 값(최댓값)을 반환합니다.
`Area Min( Area a1, Area a2 )`	a1, a2 중 더 작은 영역 값(최솟값)을 반환합니다.
`Area ObjectsArea( Rect, ImageObjectType )`	지정된 사각형(Rect) 내에서 지정된 유형의 객체가 차지하는 전체 영역을 반환합니다. 전역 좌표계에서 동작합니다.
`Area ObjectsIntersectionArea( Rect, ImageObjectType )`	지정된 사각형(Rect) 내에서 지정된 유형의 객체가 차지하는 영역을 반환합니다. 객체의 영역이 지정된 사각형을 벗어나는 경우, 객체의 영역과 지정된 사각형의 교집합 영역을 반환합니다. 전역 좌표계에서 동작합니다.

거리 연산

Function	Description
`Distance Abs( Distance )`	거리의 절대값을 반환합니다.
`Distance AverageInterLineInterval()`	페이지의 텍스트 줄 평균 높이를 반환합니다. 이 함수는 문서의 최소 및 최대 페이지 수가 1로 설정된 경우에만 사용할 수 있습니다. 여러 페이지로 구성된 문서의 경우 Page 형식의 해당 메서드를 사용하십시오: `Page( N ).AverageLineHeight`.
`Distance AverageLineHeight()`	페이지의 텍스트 줄 사이 평균 거리(줄 간격)를 반환합니다. 이 함수는 문서의 최소 및 최대 페이지 수가 1로 설정된 경우에만 사용할 수 있습니다. 여러 페이지로 구성된 문서의 경우 Page 형식의 해당 메서드를 사용하십시오: `Page( N ).AverageInterLineInterval`.
`Distance Min( Distance d1, Distance d2 )`	d1, d2 중 최소값을 반환합니다.
`Distance Max( Distance d1, Distance d2 )`	d1, d2 중 최대값을 반환합니다.

숫자형 데이터 타입에 대한 연산

Function	Description
`Int abs( Int )`	숫자의 절댓값을 반환합니다.
`Int Ceil( Real )`	인수보다 작지 않은 최소 정수를 반환합니다.
`Int Floor( Real )`	인수보다 크지 않은 최대 정수를 반환합니다.
`Int Max( Int n1, Int n2 )`	n1, n2 중 더 큰 값을 반환합니다.
`Int Min( Int n1, Int n2 )`	n1, n2 중 더 작은 값을 반환합니다.
`Int Round( Real )`	인수 값과 가장 가까운 정수를 반환합니다.
`Real Min( Real d1, Real d2 )`	d1, d2 중 더 작은 값을 반환합니다.
`Real Max( Real d1, Real d2 )`	d1, d2 중 더 큰 값을 반환합니다.

사각형 및 영역 연산

Function	Description
`Rect DocumentRect()`	전체 문서의 사각형 영역(전역 좌표계 기준)을 반환합니다.
`Rect PageRect()`	전체 이미지의 사각형을 반환합니다. 이 함수는 문서의 페이지 최소 및 최대 개수가 모두 1로 설정된 경우에만 사용할 수 있습니다.
`Region FormRegion( RectArray included, RectArray excluded )`	포함할 사각형 배열은 포함하고, 제외할 사각형 배열은 제외하는 영역을 생성합니다.

문자열 연산

Function	Description
`String Chr( Int )`	지정된 유니코드 코드값(코드는 10진수로 지정해야 함)에 해당하는 문자를 문자열로 반환합니다.
`String LCase( String )`	지정된 문자열의 모든 문자를 소문자로 변경한 문자열을 반환합니다.
`String RealToStrVariants( Real value, String fractionalPartSeparators, Int maxDigitsCountInFractionalPart = 2 )`	지정된 실수 값 value, 소수 구분자 fractionalPartSeparators, 소수 부분 자릿수의 최대 개수 maxDigitsCountInFractionalPart를 사용하여, 수직 막대 기호(	)로 구분된 여러 문자열 표현을 생성합니다.
`String Str( ... )`	데이터 타입 값을 문자열로 표현한 것입니다. Int, Logic, Real, XInterval, YInterval, DistInterval, FuzzyRect, Hypothesis, RectArray, Region, Area, Quality, Distance, PageInterval에 사용할 수 있습니다.
`String RemoveSpaces( String )`	지정된 문자열에서 모든 공백을 제거한 문자열을 반환합니다.
`String UCase( String )`	지정된 문자열의 모든 문자를 대문자로 변경한 문자열을 반환합니다.

XML 파일에 대한 접근

Function	Description
`StringArray ReadFromXML( String filename, String xPathQuery )`	”filename” XML 파일에서 string 배열을 읽습니다. 이 배열의 요소는 전달된 xPath 쿼리 “xPathQuery”를 평가하여 가져옵니다. XML 파일 사용에 대한 자세한 내용은 User Dictionaries를 참조하십시오. 참고: 코드의 가독성을 높이기 위해 자주 사용하는 xPath 쿼리에 대해 치환 가능한 매개 변수를 포함하는 상수를 정의하고, 함수 호출 시 이러한 상수를 사용할 수 있습니다.
`String ReadSingleStringFromXML( String filename, String xPathQuery )`	”filename” XML 파일에서 하나의 string을 읽습니다. 이 string은 전달된 xPath 쿼리 “xPathQuery”를 평가하여 가져옵니다. XML 파일 사용에 대한 자세한 내용은 User Dictionaries를 참조하십시오.

형 변환 및 검사

Function	Description
`Logic IsReal( String numberString, String separators = ".,", Logic isStrictMode = false )`	입력 문자열 `inputString`이(가) 실수로 안전하게 변환될 수 있는지 확인합니다. 허용되는 소수 구분자 목록은 “separators” 인수로 지정합니다.
`Logic IsRealFuzzy( String, String separators = defaultDecimalSeparators, Logic isStrictMode = false )`	문자열 `inputString`이(가) 문자열에서 발생했을 수 있는 인식 오류를 고려하여 실수로 안전하게 변환될 수 있는지 확인합니다.
`Logic IsInt( String inputString, Logic isStrictMode = false )`	입력 문자열 `inputString`이(가) 정수로 안전하게 변환될 수 있는지 확인합니다.
`Logic IsIntFuzzy( String inputString, Logic isStrictMode = false )`	문자열 `inputString`이(가) 문자열에서 발생했을 수 있는 인식 오류를 고려하여 정수로 안전하게 변환될 수 있는지 확인합니다.
`Real StrToRealFuzzy( String, String separators = defaultDecimalSeparators, Logic isStrictMode = false )`	문자열 `inputString`의 값을, 인식 오류가 발생했을 수 있음을 고려하여 실수로 변환한 결과를 반환합니다.
`Real StrToReal( String numberString, String separators = ".,", Logic isStrictMode = false )`	문자열 `inputString`을(를) 실수로 변환한 결과를 반환합니다. 공백은 무시합니다.
`Int StrToInt( String inputString, Logic isStrictMode = false )`	문자열 `inputString` 값을 정수로 변환한 결과를 반환합니다. 공백은 무시합니다.
`Int StrToIntFuzzy( String, Logic isStrictMode = false )`	문자열 `inputString`의 값을, 인식 오류가 발생했을 수 있음을 고려하여 정수로 변환한 결과를 반환합니다.
`Int LogicToInt( Logic value )`	값이 `true`이면 “1”을, 값이 `false`이면 “0”을 반환합니다.

좌표 연산

Function	Description
`XCoordinate Min( XCoordinate x1, XCoordinate x2 )`	x1과 x2 중 최소값을 반환합니다.
`XCoordinate Max( XCoordinate x1, XCoordinate x2 )`	x1과 x2 중 최대값을 반환합니다.
`XCoordinate MiddleBetween( XCoordinate x1, XCoordinate x2 )`	( x1 + x2 ) / 2로 계산된 X 좌표를 반환합니다.
`XCoordinate Between( XCoordinate x1, XCoordinate x2, Real ratio )`	x1 + ( x2 – x1 ) * ratio로 계산된 X 좌표를 반환합니다.
`YCoordinate Min( YCoordinate y1, YCoordinate y2 )`	y1과 y2 중 최소값을 반환합니다.
`YCoordinate Max( YCoordinate y1, YCoordinate y2 )`	y1과 y2 중 최대값을 반환합니다.
`YCoordinate MiddleBetween( YCoordinate y1, YCoordinate y2 )`	( y1 + y2 ) / 2로 계산된 YInterval을 반환합니다.
`YCoordinate Between( YCoordinate y1, YCoordinate y2, Real ratio )`	y1 + ( y2 – y1 ) * ratio로 계산된 YInterval을 반환합니다.
`XInterval MiddleBetween( Xinterval x1, XInterval x2 )`	( x1 + x2 ) / 2로 계산된 XInterval을 반환합니다.
`XInterval Between( Xinterval x2, Xinterval x2, Real ratio )`	x1 + ( x2 – x1 ) * ratio로 계산된 XInterval을 반환합니다.
`YInterval MiddleBetween( Yinterval y1, Yinterval y2 )`	( y1 + y2 ) / 2로 계산된 YInterval을 반환합니다.
`YInterval Between( Yinterval y1, Yinterval y2, Real ratio )`	y1 + ( y2 – y1 ) * ratio로 계산된 YInterval을 반환합니다.

데이터 카탈로그에 대한 액세스

참고: 데이터 카탈로그에 액세스하려면 먼저 해당 카탈로그를 참조하는 Skill Parameter를 생성한 다음, 메서드 호출에서 그 Parameter 이름을 사용해야 합니다.

Function	Description
`Logic TestAccessToCatalog( String catalogParameterName )`	catalogParameterName Parameter가 참조하는 데이터 카탈로그에 대한 액세스를 테스트합니다.
`Logic TestCatalogSearchCriteria( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria )`	데이터 카탈로그에 설정된 검색 기준의 유효성을 검사합니다. 검색 기준은 NamedValueArray를 사용해 설정되며, 각 NamedValue는 열 이름과 해당 열의 예상 값을 나타냅니다. searchColumns 배열은 응답에 포함할 데이터 카탈로그 레코드의 열을 지정합니다.
`StringArray FieldNamesOfCatalog( String catalogParameterName )`	catalogParameterName Parameter가 참조하는 데이터 카탈로그의 모든 열 이름 목록을 반환합니다. 열은 인덱스 번호 기준으로 오름차순으로 정렬됩니다.
`StringArray FieldNamesOfCatalog( String catalogParameterName, StringArray searchColumnNames )`	searchColumnNames 배열에 포함된 데이터 카탈로그 열 이름(대소문자 구분 없음) 목록을 반환합니다. 열은 인덱스 번호 기준으로 오름차순으로 정렬됩니다. 이 메서드를 사용하여 열 인덱스를 확인할 수 있습니다.
`Int RecordCountOfCatalog( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria = EmptyNamedValueArray )`	지정된 검색 기준을 만족하는 데이터 카탈로그 레코드 수를 반환합니다.
`Void PrepareRecordsetOfCatalog( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria = EmptyNamedValueArray, Int maxRecordsCount = 1000 )`	검색 기준을 만족하는 데이터 카탈로그 레코드를 가져옵니다.
`StringArray RecordOfCatalog( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria = EmptyNamedValueArray, Int rowIndex )`	검색 기준을 만족하는 데이터 카탈로그 레코드를 반환합니다.
`Quality ValidateByCatalog( String word, String catalogParameterName, Int columnIndex, NamedValueArray searchCriteria = EmptyNamedValueArray, Int maxErrors, Rational maxErrorsPart, Logic ignoreSpaces = true, Int maxRecordsCount = 1000 )`	지정된 word string을 데이터 카탈로그에서 columnIndex 인덱스를 가진 열의 값들과 비교하여 검사합니다. 지정된 string과 데이터 카탈로그 열에서 가장 잘 일치하는 값 간의 일치 품질을 반환합니다.
`Int GetCatalogColumnIndex( String catalogParameterName, String columnName )`	catalogParameterName Parameter가 참조하는 데이터 카탈로그에서 지정된 이름을 가진 첫 번째 열의 인덱스를 반환합니다. 열 이름은 대소문자를 구분하지 않습니다.
`IntArray GetCatalogColumnIndices( String catalogParameterName, String columnName )`	catalogParameterName Parameter가 참조하는 데이터 카탈로그에서 지정된 이름을 가진 모든 열의 인덱스를 반환합니다. 열 이름은 대소문자를 구분하지 않습니다.

Text 형식 Skill Parameter에 대한 액세스

Function	Description
`Logic NamedParameterStringExists( String parameterName )`	지정된 이름의 Text Parameter가 Skill 내에 존재하는지 확인합니다. Parameter 이름은 대소문자를 구분합니다.
`String GetNamedParameterString( String parameterName )`	지정된 이름의 Text Parameter 값을 반환합니다. Parameter 이름은 대소문자를 구분합니다.

기타

Function	Description
`InputFieldArray InputFields()`	이전 문서 처리 단계에서 문서에서 발견된 field 객체 컬렉션을 반환합니다.
`Int PagesCount()`	문서의 페이지 수를 반환합니다.
`Page Page( Int PageNumber )`	지정된 번호의 페이지를 나타내는 Page 객체를 반환합니다.
`Logic IsOnSameLine( Hypothesis, Hypothesis )`	두 가설이 수직 방향으로 서로 겹치는지 확인합니다.

미리 정의된 Field 영역 설명 변수 사용자 사전