Grafika a kreslení
Grafika a kreslení
Aspose.PDF FOSS for .NET obsahuje subsystém kreslení pro přidávání vektorové grafiky na stránky PDF. Kontejner Graph obsahuje prvky tvarů (Line, Arc, Circle) a je přidán do kolekce Paragraphs stránky.
Vytvoření kontejneru grafu
Graph definuje kreslitelnou oblast s určenou šířkou a výškou.
using var doc = new Document();
var page = doc.Pages.Add();
var graph = new Graph(400, 200);
page.Paragraphs.Add(graph);Kreslení čar
var line = new Line(new float[] { 0, 0, 300, 100 });
graph.Shapes.Add(line);Kreslení oblouků a kruhů
var arc = new Arc(150, 100, 80, 0, 180);
graph.Shapes.Add(arc);
var circle = new Circle(150, 100, 50);
graph.Shapes.Add(circle);Práce s barvami
Třída Color poskytuje tovární metody pro RGB, ARGB a pojmenované barvy.
var red = Color.FromRgb(1.0, 0.0, 0.0);
var semiTransparent = Color.FromArgb(128, 0, 0, 255);Kreslení cest
DrawingPath podporuje MoveTo, LineTo, CurveTo a Close pro volně tvarované vektorové tvary.
var path = new DrawingPath();
path.MoveTo(10, 10);
path.LineTo(100, 10);
path.CurveTo(150, 50, 150, 100, 100, 100);
path.Close();Formáty obrázků
ImageFormat poskytuje výčtové hodnoty pro rastrové formáty používané při převodu stránek na obrázky: Bmp, Jpeg, Png, Tiff, Gif.
Tipy a osvědčené postupy
- Nastavte rozměry grafu tak, aby odpovídaly oblasti, kterou chcete kreslit — souřadnice uvnitř
Graphjsou relativní k jejím hranicím. - Použijte
Color.FromArgbpro poloprůhledné výplně (podpora alfa kanálu). - Kombinujte více tvarů v jednom
Graphpro efektivní vykreslování. DrawingPathje ideální pro složité Bézierovy křivky a libovolné polygonální tvary.- Přidejte
Graphdo kolekceParagraphsstránky — nepřidávejte jej do anotací.
Časté problémy
| Issue | Cause | Fix |
|---|---|---|
| Tvar není viditelný | Rozměry grafu jsou příliš malé pro souřadnice tvaru | Zvyšte Graph šířku/výšku nebo změňte měřítko souřadnic tvaru |
| Barvy se v prohlížeči zobrazují odlišně | Neshoda barevného prostoru | Použijte Color.FromRgb s hodnotami v rozsahu 0.0‑1.0 |
| Kresba překrývá text | Graf umístěn na nesprávné pozici v toku odstavce | Upravte pořadí odstavců nebo použijte FloatingBox pro absolutní umístění |
Často kladené otázky
Mohu kreslit vyplněné tvary?
Ano. Nastavte vlastnost GraphInfo.FillColor tvaru na výplň pevnou barvou.
Jak mohu umístit graf na konkrétní souřadnice stránky?
Zabalte Graph do FloatingBox a nastavte jeho Left a Top vlastnosti pro absolutní umístění.
Podporuje knihovna gradienty?
Třídy Shading podporují základní vzory stínování. Použijte DrawingPath se stínováním pro gradientní výplně.
Souhrn referenčního API
| Třída / Metoda | Popis |
|---|---|
Graph | Kontejner pro kreslené tvary, přidávaný do odstavců stránky |
Line | Přímka mezi dvěma nebo více body |
Arc | Kruhový oblouk definovaný středem, poloměrem a úhly |
Circle | Kruhový tvar definovaný středem a poloměrem |
DrawingPath | Volná cesta s příkazy MoveTo, LineTo, CurveTo, Close |
Color | Hodnota barvy s RGB, ARGB a továrními metodami |
Color.FromRgb | Vytvořit barvu z komponent RGB |
Color.FromArgb | Vytvořit barvu s alfa průhledností |
GraphicElementCollection | Kolekce grafických prvků na stránce |
ImageFormat | Výčet rastrových formátů obrázků (Bmp, Jpeg, Png, Tiff, Gif) |