Cara Bekerja dengan Grafik PDF di C++

Aspose.PDF FOSS untuk C++ menyertakan sebuah API vektor-grafik kecil untuk menggambar bentuk bebas langsung pada halaman PDF — terpisah dari perangkat raster-rendering perpustakaan (BmpDevice, JpegDevice, TiffDevice), yang mengubah konten halaman yang ada menjadi gambar. Panduan ini menjelaskan cara membuat sebuah wadah Graph, menambahkan bentuk Circle, Ellipse, dan Line ke dalamnya, memberi gaya pada bentuk-bentuk tersebut dengan GraphInfo, dan menempatkan Graph yang selesai pada halaman. Perpustakaan ditambahkan ke proyek melalui CMake.

Panduan Langkah demi Langkah

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

Masalah Umum dan Solusinya

Sebuah bentuk yang saya buat tidak pernah muncul di halaman

Membuat sebuah Circle, Ellipse, atau Line secara terpisah tidak berpengaruh sampai itu ditambahkan ke vektor yang dikembalikan oleh Graph’s Shapes(), dan Graph itu ditambahkan ke halaman melalui Page.Paragraphs().Add(). Semua tiga langkah — membuat, menambahkan, menambahkan Graph ke halaman — diperlukan.

Bentuk-bentuk dirender pada posisi yang salah

Graph.Left() dan Graph.Top() menempatkan kontainer pada halaman; properti bentuk (Circle.PosX()/PosY(), Ellipse.Left()/Bottom(), koordinat Line.PositionArray()) menggambarkan geometri di dalam kontainer tersebut. Periksa baik penempatan kontainer maupun koordinat bentuk itu sendiri ketika output tampak bergeser.

CheckBounds returns false unexpectedly

CheckBounds(containerWidth, containerHeight) memeriksa geometri bentuk itu sendiri terhadap dimensi yang diberikan — biasanya Graph’s Width()/Height() milik, bukan kotak media penuh halaman. Mengirim dimensi yang salah menghasilkan negatif palsu bahkan ketika bentuk sebenarnya muat di dalam Graph.

A Line tidak muncul, atau muncul sebagai satu titik

PositionArray() membutuhkan setidaknya dua pasang (x, y) — empat nilai float — untuk menggambarkan segmen yang terlihat. Vektor yang lebih pendek tidak membentuk garis.

Confusing Circle with AnnotationType::Circle or CircleAnnotation

Perpustakaan juga memiliki API anotasi PDF terpisah, di mana AnnotationType::Circle dan CircleAnnotation mewakili anotasi markup berbentuk lingkaran. Kelas Circle yang dibahas dalam panduan ini tidak terkait — ia berada di Aspose::Pdf::Drawing dan menggambar langsung ke konten halaman alih-alih menambahkan objek anotasi.

Pertanyaan yang Sering Diajukan

Apa perbedaan antara GraphInfo dan BorderInfo?

GraphInfo mengatur satu goresan — lebar garis, warna, warna isi, dan pola dash — dan digunakan baik pada bentuk individual (melalui Shape.GraphInfo()) maupun per tepi di dalam BorderInfo. BorderInfo mengelompokkan empat nilai GraphInfo (Left(), Right(), Top(), Bottom()) plus sebuah RoundedBorderRadius() untuk mendeskripsikan bingkai batas kontainer Graph itu sendiri.

Bisakah saya mengisi bentuk dengan warna solid?

Ya. GraphInfo.FillColor() menentukan warna isi yang digunakan ketika bentuk digambar melalui Graph miliknya.

Apakah Circle menyimpan kotak pembatas seperti yang dilakukan Ellipse?

Tidak. Circle mengekspos PosX(), PosY(), dan Radius(); Ellipse mengekspos Left(), Bottom(), Width(), dan Height(). Mereka tidak memiliki representasi geometri umum selain basis abstrak Shape dan gaya GraphInfo.

Apakah satu Graph dapat menampung lebih dari satu bentuk?

Ya. Graph.Shapes() mengembalikan seluruh koleksi objek Shape yang ditempatkan dalam Graph tersebut — lingkaran, elips, dan garis semuanya dapat ditambahkan ke kontainer yang sama.

Apakah ini sama dengan merender halaman menjadi gambar?

Tidak. BmpDevice, JpegDevice, dan TiffDevice merasterkan konten halaman yang ada ke format gambar. Graph, Shape, Circle, Ellipse, dan Line membuat geometri vektor baru secara langsung dalam konten PDF saat dokumen sedang dibuat atau diedit.

Lihat Juga

• Panduan Pengembang
• Panduan Instalasi
• Menggambar Grafik Vektor pada Halaman PDF (Blog)
• API Reference
• Repositori GitHub
• Aspose.PDF for C++ — Enterprise Knowledge Base