C++에서 PDF 그래픽 작업하기

Aspose.PDF FOSS for C++에는 PDF 페이지에 자유형 형태를 직접 그릴 수 있는 작은 벡터 그래픽 API가 포함되어 있습니다 — 라이브러리의 래스터 렌더링 장치(BmpDevice, JpegDevice, TiffDevice)와는 별도로, 기존 페이지 콘텐츠를 이미지로 변환합니다. 이 가이드는 Graph 컨테이너를 만들고, Circle, Ellipse, Line 형태를 추가하며, GraphInfo로 해당 형태들을 스타일링하고, 완성된 Graph를 페이지에 배치하는 과정을 안내합니다. 라이브러리는 CMake를 통해 프로젝트에 추가됩니다.

단계별 가이드

add_subdirectory(aspose.pdf-foss-for-cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)

#include <aspose/pdf/document.hpp>
#include <iostream>

int main() {
    Aspose::Pdf::Document doc;
    std::cout << "Linked OK — pages: " << doc.Pages().Count() << "\n";
}

#include <aspose/pdf/document.hpp>
#include <aspose/pdf/drawing/graph.hpp>
#include <aspose/pdf/drawing/circle.hpp>
#include <aspose/pdf/drawing/ellipse.hpp>
#include <aspose/pdf/drawing/line.hpp>
#include <aspose/pdf/graph_info.hpp>
#include <aspose/pdf/border_info.hpp>
#include <aspose/pdf/color.hpp>

using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Drawing;

Document doc;
Page page = doc.Pages().Add();

auto graph = std::make_shared<Graph>();
graph->Left(50.0);
graph->Top(50.0);
graph->Width(400.0);
graph->Height(400.0);

page.Paragraphs().Add(graph);

auto circle = std::make_unique<Circle>();
circle->PosX(150.0);
circle->PosY(150.0);
circle->Radius(75.0);
graph->Shapes().push_back(std::move(circle));

auto ellipse = std::make_unique<Ellipse>();
ellipse->Left(20.0);
ellipse->Bottom(20.0);
ellipse->Width(120.0);
ellipse->Height(60.0);
graph->Shapes().push_back(std::move(ellipse));

bool circleFits = circle->CheckBounds(graph->Width(), graph->Height());

auto line = std::make_unique<Line>();
line->PositionArray({0.0f, 0.0f, 400.0f, 400.0f});
graph->Shapes().push_back(std::move(line));

GraphInfo stroke;
stroke.LineWidth(2.0f);
stroke.Color(Color::FromRgb(1.0, 0.0, 0.0));
stroke.FillColor(Color::FromRgb(1.0, 0.9, 0.9));

BorderInfo border{BorderSide::All, 1.5f, Color::Black()};
border.RoundedBorderRadius(6.0);
graph->Border(border);

doc.Save("graphics.pdf");

일반적인 문제 및 해결 방법

내가 만든 도형이 페이지에 절대 나타나지 않음

단독으로 Circle, Ellipse, 또는 Line를 생성해도, 해당 객체가 소유자 Graph의 Shapes()가 반환하는 벡터에 추가되고, 그 Graph가 Page.Paragraphs().Add()을 통해 페이지에 추가될 때까지 효과가 없습니다. 세 단계—생성, 추가, Graph을 페이지에 추가—가 모두 필요합니다.

도형이 잘못된 위치에 렌더링됩니다

Graph.Left()와 Graph.Top()은 페이지에 컨테이너를 배치합니다; 도형 속성(Circle.PosX()/PosY(), Ellipse.Left()/Bottom(), Line.PositionArray() 좌표)은 해당 컨테이너 내의 기하학을 설명합니다. 출력이 어긋난 것처럼 보일 때는 컨테이너 배치와 도형 자체 좌표를 모두 확인하십시오.

CheckBounds returns false unexpectedly

CheckBounds(containerWidth, containerHeight)는 전달된 치수와 도형 자체의 기하학을 비교합니다 — 일반적으로 페이지 전체 미디어 박스가 아니라 소유자 Graph의 Width()/Height()을 사용합니다. 잘못된 치수를 전달하면 도형이 실제로 Graph 안에 들어갈 수 있음에도 불구하고 false negative가 발생합니다.

A Line 표시되지 않거나, 단일 점으로 표시됩니다

PositionArray()는 가시적인 구간을 설명하기 위해 최소 두 개의 (x, y) 쌍, 즉 네 개의 float 값이 필요합니다. 짧은 벡터는 선을 형성하지 못합니다.

Confusing Circle with AnnotationType::Circle or CircleAnnotation

이 라이브러리에는 별도의 PDF 주석 API도 있으며, 여기서 AnnotationType::Circle와 CircleAnnotation은 원형 마크업 주석을 나타냅니다. 이 가이드에서 다루는 Circle 클래스는 관련이 없으며 — Aspose::Pdf::Drawing에 존재하고 주석 객체를 추가하는 대신 페이지 콘텐츠에 직접 그립니다.

자주 묻는 질문

GraphInfo와 BorderInfo의 차이점은 무엇인가요?

GraphInfo은 단일 스트로크 — 선 두께, 색상, 채우기 색상, 대시 패턴 — 를 스타일링하며, 개별 도형(Shape.GraphInfo()을 통해)과 BorderInfo 내부의 각 가장자리 모두에 사용됩니다. BorderInfo은 네 가지 GraphInfo 값(Left(), Right(), Top(), Bottom())과 RoundedBorderRadius() 하나를 그룹화하여 Graph 컨테이너 자체의 테두리 프레임을 설명합니다.

도형을 단색으로 채울 수 있나요?

예. GraphInfo.FillColor()은 도형이 소유하고 있는 Graph을 통해 그려질 때 사용되는 채우기 색상을 설정합니다.

Circle은 Ellipse처럼 경계 상자를 저장하나요?

No. Circle은 PosX(), PosY(), Radius()을 공개합니다; Ellipse은 Left(), Bottom(), Width(), Height()을 공개합니다. 이들은 추상 Shape 기반 및 GraphInfo 스타일링을 제외하고는 공통된 기하학 표현을 공유하지 않습니다.

하나의 Graph가 둘 이상의 도형을 보유할 수 있나요?

예. Graph.Shapes()은 해당 Graph 내에 배치된 Shape 객체의 전체 컬렉션을 반환합니다 — 원, 타원 및 선을 모두 동일한 컨테이너에 추가할 수 있습니다.

페이지를 이미지로 렌더링하는 것과 동일한가요?

아니요. BmpDevice, JpegDevice, TiffDevice는 기존 페이지 콘텐츠를 이미지 형식으로 래스터화합니다. Graph, Shape, Circle, Ellipse, Line는 문서가 생성되거나 편집되는 동안 PDF 콘텐츠에 직접 새로운 벡터 기하학을 구성합니다.

참조

• 개발자 가이드
• 설치 가이드
• PDF 페이지에 벡터 그래픽 그리기 (블로그)
• API Reference
• GitHub 저장소
• Aspose.PDF for C++ — Enterprise Knowledge Base