Gràfics i Dibuix
Gràfics i Dibuix
Aspose.PDF FOSS for .NET inclou un subsistema de dibuix per afegir gràfics vectorials a les pàgines PDF. El contenidor Graph conté elements de forma (Line, Arc, Circle) i s’afegeix a la col·lecció Paragraphs d’una pàgina.
Creant un contenidor de gràfic
Graph defineix una àrea dibuixable amb una amplada i alçada especificades.
using var doc = new Document();
var page = doc.Pages.Add();
var graph = new Graph(400, 200);
page.Paragraphs.Add(graph);Dibuixant línies
var line = new Line(new float[] { 0, 0, 300, 100 });
graph.Shapes.Add(line);Dibuixant arcs i cercles
var arc = new Arc(150, 100, 80, 0, 180);
graph.Shapes.Add(arc);
var circle = new Circle(150, 100, 50);
graph.Shapes.Add(circle);Treballant amb colors
La classe Color proporciona mètodes de fàbrica per a RGB, ARGB i colors amb nom.
var red = Color.FromRgb(1.0, 0.0, 0.0);
var semiTransparent = Color.FromArgb(128, 0, 0, 255);Dibuix de camins
DrawingPath admet MoveTo, LineTo, CurveTo i Close per a formes vectorials de forma lliure.
var path = new DrawingPath();
path.MoveTo(10, 10);
path.LineTo(100, 10);
path.CurveTo(150, 50, 150, 100, 100, 100);
path.Close();Formats d’imatge
ImageFormat proporciona valors d’enumeració per a formats raster utilitzats quan es converteixen pàgines a imatges: Bmp, Jpeg, Png, Tiff, Gif.
Consells i bones pràctiques
- Estableix les dimensions del gràfic per coincidir amb l’àrea on vols dibuixar — les coordenades dins de
Graphsón relatives als seus límits. - Utilitza
Color.FromArgbper a emplenaments semitransparents (suport del canal alfa). - Combina diverses formes en un únic
Graphper a una representació eficient. DrawingPathés ideal per a corbes de Bézier complexes i formes de polígon arbitràries.- Afegeix el
Grapha la col·leccióParagraphsde la pàgina — no l’afegeixis a les anotacions.
Problemes comuns
| Problema | Causa | Solució |
|---|---|---|
| Forma no visible | Dimensions del gràfic massa petites per a les coordenades de la forma | Augmenta l’amplada/alçada de Graph o escala les coordenades de la forma |
| Els colors apareixen diferents al visualitzador | Desajust d’espai de color | Utilitza Color.FromRgb amb valors en l’interval 0.0-1.0 |
| El dibuix se superposa al text | El gràfic col·locat a una posició incorrecta en el flux del paràgraf | Ajusta l’ordre dels paràgrafs o utilitza FloatingBox per a posicionament absolut |
PMF
Puc dibuixar formes omplertes?
Sí. Estableix la propietat GraphInfo.FillColor de la forma per omplir amb un color sòlid.
Com puc posicionar un gràfic a coordenades de pàgina específiques?
Envolta el Graph en un FloatingBox i estableix les seves propietats Left i Top per al posicionament absolut.
La biblioteca admet gradients?
Les classes Shading admeten patrons d’ombreig bàsics. Utilitzeu DrawingPath amb ombreig per a emplenaments degradats.
Resum de la referència de l’API
| Classe / Mètode | Descripció |
|---|---|
Graph | Contenidor per a formes dibuixables, afegit als paràgrafs de la pàgina |
Line | Línia recta entre dos o més punts |
Arc | Arc circular definit per centre, radi i angles |
Circle | Forma de cercle definida per centre i radi |
DrawingPath | Camí de forma lliure amb MoveTo, LineTo, CurveTo, Close |
Color | Valor de color amb RGB, ARGB i mètodes de fàbrica |
Color.FromRgb | Crea un color a partir de components RGB |
Color.FromArgb | Crea un color amb transparència alfa |
GraphicElementCollection | Col·lecció d’elements gràfics en una pàgina |
ImageFormat | Enumeració de formats d’imatge raster (Bmp, Jpeg, Png, Tiff, Gif) |