문서와 별도로 모양 렌더링
문서를 처리할 때 일반적인 작업은 문서에 있는 모든 이미지를 추출하여 외부 위치로 내보내는 것입니다. 이 작업은 이미 이미지 데이터 추출 및 저장 기능을 제공하는 Aspose.Words API를 사용하면 간단해집니다. 그러나 때로는 다른 유형의 그리기 개체(예: 단락이 포함된 텍스트 상자, 화살표 모양 및 작은 이미지)로 표시되는 다른 유형의 그래픽 콘텐츠를 유사하게 추출하려는 경우도 있습니다. 이 개체는 개별 콘텐츠 요소의 조합이므로 렌더링하는 간단한 방법은 없습니다. 내용이 하나의 이미지처럼 보이는 객체로 그룹화되어 있는 경우도 있을 수 있습니다.
Aspose.Words는 렌더링된 콘텐츠로 모양에서 간단한 이미지를 추출할 수 있는 것과 동일한 방식으로 이러한 유형의 콘텐츠를 추출하는 기능을 제공합니다. 이 문서에서는 이 기능을 활용하여 문서와 관계없이 모양을 렌더링하는 방법을 설명합니다.
Aspose.Words의 모양 유형
문서 그리기 레이어의 모든 콘텐츠는 Aspose.Words DOM(문서 개체 모듈)의 Shape 또는 GroupShape 노드로 표시됩니다. 이러한 콘텐츠는 텍스트 상자, 이미지, 도형, OLE 개체 등이 될 수 있습니다. 일부 필드(예: INCLUDEPICTURE 필드)도 모양으로 가져옵니다.
간단한 이미지는 ShapeType.Image의 Shape 노드로 표현됩니다. 이 모양 노드에는 하위 노드가 없지만 이 모양 노드에 포함된 이미지 데이터는 Shape.ImageData 속성을 통해 액세스할 수 있습니다. 반면에 모양은 많은 하위 노드로 구성될 수도 있습니다. 예를 들어 ShapeType.TextBox 속성으로 표현되는 텍스트 상자 모양은 Paragraph, Table 등 여러 노드로 구성될 수 있습니다. 대부분의 셰이프에는 Paragraph 및 Table 블록 수준 노드가 포함될 수 있습니다. 본체에 등장하는 노드와 동일한 노드입니다. 도형은 항상 인라인으로 직접 포함되거나 **절,**에 고정되지만 문서 페이지의 어느 곳에나 “떠다니는” 일부 단락의 일부입니다.
문서에는 함께 그룹화된 모양이 포함될 수도 있습니다. 여러 개체를 선택하고 마우스 오른쪽 버튼 클릭 메뉴에서 “Group"를 클릭하면 Microsoft Word에서 Grouping을 활성화할 수 있습니다.
Aspose.Words에서 이러한 모양 그룹은 GroupShape 노드로 표시됩니다. 전체 그룹을 이미지로 렌더링하는 것과 동일한 방식으로 호출할 수도 있습니다.
DOCX 형식에는 다이어그램이나 차트와 같은 특수한 유형의 이미지가 포함될 수 있습니다. 이러한 모양은 Aspose.Words의 Shape 노드를 통해서도 표현되며, 이는 이미지로 렌더링하는 유사한 방법도 제공합니다. 설계상 해당 모양이 이미지(ShapeType.Image)가 아닌 한 모양은 다른 모양을 하위로 포함할 수 없습니다. 예를 들어 Microsoft Word에서는 다른 텍스트 상자 안에 텍스트 상자를 삽입하는 것을 허용하지 않습니다.
위에서 설명한 모양 유형은 ShapeRenderer 클래스를 통해 모양을 렌더링하는 특별한 방법을 제공합니다. ShapeRenderer 클래스의 인스턴스는 GetShapeRenderer 메서드를 통해 또는 Shape을 ShapeRenderer 클래스의 생성자에 전달하여 Shape 또는 GroupShape에 대해 검색됩니다. 이 클래스는 다음에 대한 모양을 렌더링할 수 있는 멤버에 대한 액세스를 제공합니다
- Save 메소드 오버로드를 사용하는 디스크의 파일
- Save 메서드 오버로드를 사용한 스트리밍
- RenderToSize 및 RenderToScale 방식을 사용하는 .NET 그래픽 개체
파일 또는 스트림으로 렌더링
Save 메서드는 셰이프를 파일이나 스트림에 직접 렌더링하는 오버로드를 제공합니다. 두 오버로드 모두 모양 렌더링을 위한 옵션을 정의할 수 있는 ImageSaveOptions 클래스의 인스턴스를 허용합니다. 이는 Document.Save 메서드와 동일한 방식으로 작동합니다. 이 매개변수가 필수이더라도 사용자 정의 옵션이 없음을 지정하여 null 값을 전달할 수 있습니다.
모양은 SaveFormat 열거에 지정된 모든 이미지 형식으로 내보낼 수 있습니다. 예를 들어 이미지는 SaveFormat.Jpeg 열거를 지정하여 JPEG와 같은 래스터 이미지로 렌더링하거나 SaveFormat.Emf을 지정하여 EMF와 같은 벡터 이미지로 렌더링할 수 있습니다.
아래 코드 예제에서는 문서와 별도로 모양을 EMF 이미지로 렌더링하고 디스크에 저장하는 방법을 보여줍니다
아래 코드 예제에서는 문서와 별도로 모양을 JPEG 이미지로 렌더링하고 스트림에 저장하는 방법을 보여줍니다
ImageSaveOptions 클래스를 사용하면 이미지 렌더링 방법을 제어하는 다양한 옵션을 지정할 수 있습니다. 위에서 설명한 기능은 GroupShape 및 Shape 노드에도 동일한 방식으로 적용될 수 있습니다.
.NET 그래픽 개체로 렌더링
Graphics 개체에 직접 렌더링하면 Graphics 개체에 대한 고유한 설정과 상태를 정의할 수 있습니다. 일반적인 시나리오에는 Windows 양식 또는 비트맵에서 검색된 Graphics 개체에 직접 모양을 렌더링하는 작업이 포함됩니다. Shape 노드가 렌더링되면 설정이 모양 모양에 영향을 미칩니다. 예를 들어 Graphics 개체에 대해 RotateTransform 또는 ScaleTransform 메서드를 사용하여 모양을 회전하거나 크기를 조정할 수 있습니다.
아래 예에서는 문서와 별도로 모양을 .NET Graphics 개체로 렌더링하고 렌더링된 이미지에 회전을 적용하는 방법을 보여줍니다
마찬가지로 RenderToSize 메서드와 마찬가지로 NodeRendererBase에서 상속된 렌더 크기 메서드는 문서 콘텐츠의 축소판을 만드는 데 유용합니다. 모양 크기는 생성자를 통해 지정됩니다. RenderToSize 메서드는 Graphics 개체, 이미지 위치의 X 및 Y 좌표, Graphics 개체에 그려질 이미지의 크기(너비 및 높이)를 허용합니다.
Shape는 NodeRendererBase 클래스에서 상속된 ShapeRenderer.RenderToScale 메서드를 사용하여 특정 규모로 렌더링할 수 있습니다. 이는 동일한 주요 매개변수를 허용하는 Document.RenderToScale 방법과 유사합니다. 이 두 가지 방법의 차이점은 ShapeRenderer.RenderToScale 방법을 사용하면 리터럴 크기 대신 렌더링 중에 모양의 크기를 조정하는 부동 소수점 값을 선택한다는 것입니다. float 값이 1.0이면 모양이 원래 크기의 100%로 렌더링됩니다. float 값이 0.5이면 이미지 크기가 절반으로 줄어듭니다.
모양 이미지 렌더링
Shape 클래스는 도형, 텍스트 상자, 자유형, OLE 개체, ActiveX 컨트롤 또는 그림과 같은 그리기 레이어의 개체를 나타냅니다. Shape 클래스를 사용하면 Microsoft Word 문서에서 모양을 만들거나 수정할 수 있습니다. 모양의 중요한 속성은 ShapeType입니다. 다양한 유형의 도형은 Word 문서에서 다양한 기능을 가질 수 있습니다. 예를 들어, 이미지와 OLE 셰이프에만 이미지가 포함될 수 있고 대부분의 셰이프에는 텍스트만 포함될 수 있습니다.
다음 예에서는 문서와 별도로 Shape 이미지를 JPEG 이미지로 렌더링하고 디스크에 저장하는 방법을 보여줍니다
모양 크기 검색
ShapeRenderer 클래스는 GetSizeInPixels 메서드를 통해 모양의 크기를 픽셀 단위로 검색하는 기능도 제공합니다. 이 방법은 모양이 렌더링될 때 모양 크기를 계산하는 데 사용되는 두 개의 부동(단일) 매개변수인 배율과 DPI를 허용합니다. 이 메서드는 계산된 크기의 너비와 높이가 포함된 Size 객체를 반환합니다. 이는 렌더링된 출력에서 새 비트맵을 생성할 때와 같이 렌더링된 모양의 크기를 미리 알아야 할 때 유용합니다.
아래 예에서는 렌더링할 모양의 너비와 높이를 사용하여 새 비트맵 및 그래픽 개체를 만드는 방법을 보여줍니다
RenderToSize 또는 RenderToScale 메소드를 사용하는 경우 렌더링된 이미지 크기도 SizeF 객체로 반환됩니다. 이는 변수에 할당되어 필요한 경우 사용할 수 있습니다.
SizeInPoints 속성은 포인트 단위로 측정된 모양 크기를 반환합니다(ShapeRenderer 참조). 결과는 너비와 높이를 포함하는 SizeF 객체입니다.