Gràfics i Dibuix

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 Graph són relatives als seus límits.
  • Utilitza Color.FromArgb per a emplenaments semitransparents (suport del canal alfa).
  • Combina diverses formes en un únic Graph per a una representació eficient.
  • DrawingPath és ideal per a corbes de Bézier complexes i formes de polígon arbitràries.
  • Afegeix el Graph a la col·lecció Paragraphs de la pàgina — no l’afegeixis a les anotacions.

Problemes comuns

ProblemaCausaSolució
Forma no visibleDimensions del gràfic massa petites per a les coordenades de la formaAugmenta l’amplada/alçada de Graph o escala les coordenades de la forma
Els colors apareixen diferents al visualitzadorDesajust d’espai de colorUtilitza Color.FromRgb amb valors en l’interval 0.0-1.0
El dibuix se superposa al textEl gràfic col·locat a una posició incorrecta en el flux del paràgrafAjusta 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ètodeDescripció
GraphContenidor per a formes dibuixables, afegit als paràgrafs de la pàgina
LineLínia recta entre dos o més punts
ArcArc circular definit per centre, radi i angles
CircleForma de cercle definida per centre i radi
DrawingPathCamí de forma lliure amb MoveTo, LineTo, CurveTo, Close
ColorValor de color amb RGB, ARGB i mètodes de fàbrica
Color.FromRgbCrea un color a partir de components RGB
Color.FromArgbCrea un color amb transparència alfa
GraphicElementCollectionCol·lecció d’elements gràfics en una pàgina
ImageFormatEnumeració de formats d’imatge raster (Bmp, Jpeg, Png, Tiff, Gif)

Vegeu també

 Català