วิธีทำงานกับกราฟิก PDF ใน C++

Aspose.PDF FOSS สำหรับ C++ มี API เวกเตอร์กราฟิกขนาดเล็กสำหรับวาดรูปทรงอิสระโดยตรงบนหน้า PDF — แยกจากอุปกรณ์เรสเตอร์เรนเดอร์ของไลบรารี (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) ตรวจสอบรูปทรงของรูปร่างเองเทียบกับมิติที่ส่งเข้ามา — ปกติจะเป็น Width()/Height() ของ Graph ที่เป็นเจ้าของ, ไม่ใช่กล่องสื่อเต็มของหน้า. การส่งมิติผิดทำให้ได้ผลลัพธ์เป็นลบเท็จแม้ว่ารูปร่างจะพอดีภายใน Graph จริงๆ.

A Line ไม่ปรากฏ หรือปรากฏเป็นจุดเดียว

PositionArray() ต้องมีอย่างน้อยสองคู่ (x, y) — สี่ค่า float — เพื่ออธิบายส่วนที่มองเห็นได้. เวกเตอร์ที่สั้นกว่าจะไม่สร้างเส้น.

Confusing Circle with AnnotationType::Circle or CircleAnnotation

ไลบรารียังมี API คำอธิบายประกอบ PDF แยกต่างหาก โดยที่ 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 เก็บ bounding box เช่นเดียวกับ Ellipse หรือไม่?

โหนด Circle เปิดเผย PosX(), PosY() และ Radius(); Ellipse เปิดเผย Left(), Bottom(), Width() และ Height(). พวกเขาไม่มีการแสดงผลเรขาคณิตร่วมกันนอกเหนือจากฐาน Shape แบบนามธรรมและสไตลิ่ง GraphInfo.

กราฟหนึ่งสามารถเก็บมากกว่าหนึ่งรูปทรงได้หรือไม่?

ใช่. Graph.Shapes() คืนค่าชุดทั้งหมดของออบเจ็กต์ Shape ที่วางอยู่ภายใน Graph นั้น — วงกลม, รูปรี, และเส้นสามารถเพิ่มลงในคอนเทนเนอร์เดียวกันได้ทั้งหมด.

นี่เหมือนกับการเรนเดอร์หน้าเป็นภาพหรือไม่?

ไม่. BmpDevice, JpegDevice และ TiffDevice ทำการแปลงข้อมูลหน้าเดิมเป็นรูปแบบภาพแบบแรสเตอร์. Graph, Shape, Circle, Ellipse, และ Line สร้างเรขาคณิตเวกเตอร์ใหม่โดยตรงในเนื้อหา PDF ขณะที่เอกสารถูกสร้างหรือแก้ไข.

ดูเพิ่มเติม

• คู่มือสำหรับนักพัฒนา
• คู่มือการติดตั้ง
• การวาดกราฟิกเวกเตอร์บนหน้า PDF (บล็อก)
• API Reference
• รีโพสิตอรี GitHub
• Aspose.PDF for C++ — Enterprise Knowledge Base