Hogyan dolgozzunk PDF grafikákkal C++-ban

Aspose.PDF FOSS for C++ tartalmaz egy kis vektoros grafikai API eszközt, amely lehetővé teszi szabad formájú alakzatok közvetlen rajzolását egy PDF oldalon — elkülönítve a könyvtár raster-megjelenítő eszközeitől (BmpDevice, JpegDevice, TiffDevice), amelyek a meglévő oldal tartalmat képekké konvertálják. Ez az útmutató végigvezet egy Graph konténer létrehozásán, Circle, Ellipse és Line alakzatok hozzáadásán, ezeknek az alakzatoknak a GraphInfo stílusozásán, és a kész Graph elhelyezésén egy oldalon. A könyvtárat a projektbe CMake-en keresztül adhatjuk hozzá.

Lépésről-lépésre útmutató

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");

Gyakori problémák és megoldások

Az általam létrehozott alakzat soha nem jelenik meg az oldalon

Egy Circle, Ellipse vagy Line önmagában történő létrehozása nem jár hatással, amíg nem fűzzük hozzá a tulajdonos Graph által visszaadott vektorhoz a Shapes() segítségével, és az a Graph egy oldalhoz kerül a Page.Paragraphs().Add() útján. A három lépés – létrehozás, hozzáfűzés, a Graph oldalhoz adása – mind szükséges.

Az alakzatok rossz helyen jelennek meg

Graph.Left() és Graph.Top() helyezik el a konténert az oldalon; az alakzat tulajdonságai (Circle.PosX()/PosY(), Ellipse.Left()/Bottom(), Line.PositionArray() koordináták) a konténeren belüli geometriát írják le. Ellenőrizze mind a konténer elhelyezését, mind az alakzat saját koordinátáit, ha a kimenet eltoltnak tűnik.

CheckBounds returns false unexpectedly

CheckBounds(containerWidth, containerHeight) az alakzat saját geometriáját a megadott méretekkel hasonlítja össze – általában a tulajdonos Graph Width()/Height() értékeivel, nem pedig az oldal teljes media box-ával. A helytelen méretek átadása hamis negatív eredményt ad még akkor is, ha az alakzat valójában belefér a Graph belsejébe.

A Line nem jelenik meg, vagy egyetlen pontként jelenik meg

PositionArray() legalább két (x, y) párra – négy float értékre – van szüksége egy látható szegmens leírásához. Egy rövidebb vektor nem alkot vonalat.

Confusing Circle with AnnotationType::Circle or CircleAnnotation

A könyvtárnak van egy külön PDF-annotációs API is, ahol a AnnotationType::Circle és a CircleAnnotation kör alakú jelölő annotációkat jelentenek. Az ebben az útmutatóban tárgyalt Circle osztály nem kapcsolódik ehhez — Aspose::Pdf::Drawing-ban található, és közvetlenül az oldal tartalmába rajzol, ahelyett, hogy annotációs objektumot adna hozzá.

Gyakran Ismételt Kérdések

Mi a különbség a GraphInfo és a BorderInfo között?

GraphInfo egyetlen vonalat stílusoz — vonalvastagság, szín, kitöltő szín és szaggatott minta — és használható mind egyedi alakzatokon (a Shape.GraphInfo() segítségével), mind egy BorderInfo élénként. BorderInfo négy GraphInfo értéket (Left(), Right(), Top(), Bottom()) plusz egy RoundedBorderRadius() csoportba foglal, hogy leírja egy Graph tároló saját keretét.

Kitölthetek egy alakzatot egyszínű színnel?

Igen. A GraphInfo.FillColor() beállítja a kitöltő színt, amelyet az alakzat a saját Graph segítségével rajzoláskor használ.

A Circle tárol-e körülíró dobozt, ahogy az Ellipse?

Nem. Circle megjeleníti a(z) PosX(), PosY() és Radius() elemeket; Ellipse megjeleníti a(z) Left(), Bottom(), Width() és Height() elemeket. Nem osztanak közös geometriai ábrázolást az absztrakt Shape alapon és a GraphInfo stíluson kívül.

Egy Graph tartalmazhat több mint egy alakzatot?

Igen. Graph.Shapes() visszaadja a(z) Shape objektumok teljes gyűjteményét, amely a(z) Graph belsejébe van elhelyezve — körök, ellipszisek és vonalak is hozzáadhatók ugyanahhoz a konténerhez.

Ez ugyanaz, mint egy oldal képpé renderelése?

Nem. BmpDevice, JpegDevice és TiffDevice raszterizálják a meglévő oldal tartalmat képfájlformátumokra. Graph, Shape, Circle, Ellipse és Line új vektoros geometriát hoznak létre közvetlenül a PDF tartalomban, miközben a dokumentum épül vagy szerkesztés alatt áll.

Lásd még:

• Fejlesztői útmutató
• Telepítési útmutató
• Vektoros grafika rajzolása PDF oldalon (Blog)
• API Reference
• GitHub tároló
• Aspose.PDF for C++ — Enterprise Knowledge Base