DivisionUnit.Transform 속성

아티클
11/04/2008

업데이트: 2007년 11월

DivisionUnit 개체를 사용하여 스트로크를 가로로 회전하는 변환 매트릭스를 가져옵니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public ReadOnly Property Transform As Matrix
‘사용 방법
Dim instance As DivisionUnit
Dim value As Matrix

value = instance.Transform

public Matrix Transform { get; }

public:
property Matrix^ Transform {
    Matrix^ get ();
}

/** @property */
public Matrix get_Transform()

public function get Transform () : Matrix

속성 값

형식: System.Drawing.Drawing2D.Matrix
DivisionUnit 개체를 사용하여 스트로크를 가로로 회전하는 변환 매트릭스입니다.

설명

텍스트 인식기는 가로 필기에 대해 가장 뛰어난 성능을 발휘합니다. 스트로크를 RecognizerContext 개체에 전달하기 전에 이 변환을 DivisionUnit 개체의 Strokes 속성에 적용합니다.

매트릭스의 회전 지점은 세그먼트와 줄 모두에 대해 줄의 경계 상자 왼쪽 아래 모퉁이로 설정됩니다. 인식 세그먼트의 회전 각도는 세그먼트가 포함된 줄의 각도와 같습니다.

참고

DivisionUnit 개체가 단락 또는 그리기를 나타내는 경우 이 속성은 항등 매트릭스를 반환합니다.

이 속성을 사용하여 필기를 평균화하거나 기울인 필기를 중심으로 선이나 모양을 정확하게 그립니다.

예제

이 C# 예제에서는 Strokes 컬렉션인 theStrokes를 포함하고 RecognizerContext 개체인 theRecognizerContext를 사용하는 theDivider라는 Divider 개체를 만듭니다. Divide 메서드를 호출하여 분석 결과인 theResult의 스냅숏을 가져옵니다. divisionType 매개 변수를 InkDivisionType 열거형인 Line으로 설정하고 ResultByType 메서드를 호출하여 theResult 내의 모든 줄 단위를 검색합니다. 컬렉션의 각 줄인 theLine에 대해 DivisionType, Strokes, RecognitionString 및 Transform 속성을 검색합니다.

// Create the Divider and assign a Strokes collection to it.
Divider theDivider = new Divider(theStrokes, theRecognizerContext);

// Retrieve the analysis result, and divide the result by line.
DivisionResult theResult = theDivider.Divide();
DivisionUnits theDivisionUnits =
    theResult.ResultByType(InkDivisionType.Line);
foreach (DivisionUnit theLine in theDivisionUnits)
{
    // For each line element in the collection
    // retrieve the division type, the strokes,
    // the recognition string, and the rotation transform.
    InkDivisionType theDivisionType = theLine.DivisionType;
    Strokes elementStrokes = theLine.Strokes;
    string theRecognitionString = theLine.RecognitionString;
    System.Drawing.Drawing2D.Matrix theInkTransform =
        theLine.Transform;
}

이 Microsoft® Visual Basic® .NET 예제에서는 Strokes 컬렉션인 theStrokes를 포함하고 RecognizerContext 개체인 theRecognizerContext를 사용하는 theDivider라는 Divider 개체를 만듭니다. Divide 메서드를 호출하여 분석 결과인 theResult의 스냅숏을 가져옵니다. divisionType 매개 변수를 InkDivisionType 열거형인 Line으로 설정하고 ResultByType 메서드를 호출하여 theResult 내의 모든 줄 단위를 검색합니다. 컬렉션의 각 줄인 theLine에 대해 DivisionType, Strokes, RecognitionString 및 Transform 속성을 검색합니다.

' Create the Divider and assign a Strokes collection to it.
Dim theDivider As Divider = New Divider(theStrokes, theRecognizerContext)

' Retrieve the analysis result, and divide the result by line.
Dim theResult As DivisionResult = theDivider.Divide()
Dim theDivisionUnits As DivisionUnits = _
    theResult.ResultByType(InkDivisionType.Line)
Dim theLine As DivisionUnit
For Each theLine In theDivisionUnits
    ' For each line element in the collection
    ' retrieve the division type, the strokes,
    ' the recognition string, and the rotation transform.
    Dim theDivisionType As InkDivisionType = theLine.DivisionType
    Dim elementStrokes As Strokes = theLine.Strokes
    Dim theRecognitionString As String = theLine.RecognitionString
    Dim theInkTransform As System.Drawing.Drawing2D.Matrix = _
        theLine.Transform
Next