Gráficos y Dibujo

Gráficos y Dibujo

Gráficos y Dibujo

Aspose.PDF FOSS para .NET incluye un subsistema de dibujo para agregar gráficos vectoriales a páginas PDF. El contenedor Graph contiene elementos de forma (Line, Arc, Circle) y se agrega a la colección Paragraphs de una página.


Creando un contenedor de gráfico

Graph define un área dibujable con un ancho y una altura especificados.

using var doc = new Document();
var page = doc.Pages.Add();

var graph = new Graph(400, 200);
page.Paragraphs.Add(graph);

Dibujando líneas

var line = new Line(new float[] { 0, 0, 300, 100 });
graph.Shapes.Add(line);

Dibujando arcos y círculos

var arc = new Arc(150, 100, 80, 0, 180);
graph.Shapes.Add(arc);

var circle = new Circle(150, 100, 50);
graph.Shapes.Add(circle);

Trabajando con colores

La clase Color proporciona métodos de fábrica para RGB, ARGB y colores con nombre.

var red = Color.FromRgb(1.0, 0.0, 0.0);
var semiTransparent = Color.FromArgb(128, 0, 0, 255);

Dibujar rutas

DrawingPath admite MoveTo, LineTo, CurveTo y Close para formas vectoriales libres.

var path = new DrawingPath();
path.MoveTo(10, 10);
path.LineTo(100, 10);
path.CurveTo(150, 50, 150, 100, 100, 100);
path.Close();

Formatos de imagen

ImageFormat proporciona valores de enumeración para formatos raster utilizados al convertir páginas a imágenes: Bmp, Jpeg, Png, Tiff, Gif.


Consejos y Mejores Prácticas

  • Establezca las dimensiones del gráfico para que coincidan con el área en la que desea dibujar — las coordenadas dentro de Graph son relativas a sus límites.
  • Use Color.FromArgb para rellenos semitransparentes (soporte de canal alfa).
  • Combine múltiples formas en un solo Graph para una renderización eficiente.
  • DrawingPath es ideal para curvas Bezier complejas y formas de polígonos arbitrarios.
  • Añada el Graph a la colección Paragraphs de la página — no lo añada a anotaciones.

Problemas comunes

ProblemaCausaSolución
Forma no visibleDimensiones del gráfico demasiado pequeñas para las coordenadas de la formaAumente el ancho/alto de Graph o escale las coordenadas de la forma
Los colores aparecen diferentes en el visorDesajuste del espacio de colorUtilice Color.FromRgb con valores en el rango 0.0-1.0
El dibujo se superpone al textoGráfico colocado en posición incorrecta en el flujo del párrafoAjuste el orden de los párrafos o use FloatingBox para posicionamiento absoluto

Preguntas frecuentes

¿Puedo dibujar formas rellenas?

Sí. Establezca la propiedad GraphInfo.FillColor de la forma para rellenar con un color sólido.

¿Cómo posiciono un Graph en coordenadas específicas de la página?

Envuelva el Graph en un FloatingBox y establezca sus propiedades Left y Top para posicionamiento absoluto.

¿La biblioteca admite degradados?

Las clases Shading admiten patrones de sombreado básicos. Utilice DrawingPath con sombreado para rellenos degradados.


Resumen de Referencia de API

Clase / MétodoDescripción
GraphContenedor para formas dibujables, añadido a los párrafos de la página
LineLínea recta entre dos o más puntos
ArcArco circular definido por centro, radio y ángulos
CircleForma de círculo definida por centro y radio
DrawingPathRuta libre con MoveTo, LineTo, CurveTo, Close
ColorValor de color con RGB, ARGB y métodos de fábrica
Color.FromRgbCrear un color a partir de componentes RGB
Color.FromArgbCrear un color con transparencia alfa
GraphicElementCollectionColección de elementos gráficos en una página
ImageFormatEnumeración de formatos de imagen raster (Bmp, Jpeg, Png, Tiff, Gif)

Ver también

 Español