Pen Klasse

Summary: Defines an object used to draw lines, curves and figures.

Full Name: aspose.imaging.Pen

Inheritance: TransparencySupporter

Constructors

Name	Beschreibung
Pen(brush)	Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush.
Pen(brush, width)	Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush und Pen.width.
Pen(color)	Initialisiert eine neue Instanz der Pen Klasse mit der angegebenen Farbe.
Pen(color, width)	Initialisiert eine neue Instanz der Pen Klasse mit den angegebenen Pen.color und Pen.width Eigenschaften.

Properties

Name	Type	Access	Beschreibung
alignment	PenAlignment	r/w	Liest oder setzt die Ausrichtung für dieses Pen.
brush	Brush	r/w	Liest oder setzt den Pen.brush, der die Attribute dieses Pen bestimmt.
color	Color	r/w	Liest oder setzt die Farbe dieses Pen.
compound_array	float[]	r/w	Liest oder setzt ein Array von Werten, das einen zusammengesetzten Stift definiert. Ein zusammengesetzter Stift zeichnet eine zusammengesetzte Linie, die aus parallelen Linien und Lücken besteht.
custom_end_cap	CustomLineCap	r/w	Liest oder setzt eine benutzerdefinierte Endkappe, die am Ende von mit diesem Pen gezeichneten Linien verwendet wird.
custom_start_cap	CustomLineCap	r/w	Liest oder setzt eine benutzerdefinierte Anfangskappe, die am Anfang von mit diesem Pen gezeichneten Linien verwendet wird.
dash_cap	DashCap	r/w	Liest oder setzt den Kappenstil, der am Ende der Striche verwendet wird, aus denen gestrichelte Linien bestehen, die mit diesem Pen gezeichnet werden.
dash_offset	float	r/w	Liest oder setzt den Abstand vom Anfang einer Linie bis zum Beginn eines Strichmusters.
dash_pattern	float[]	r/w	Liest oder setzt ein Array benutzerdefinierter Striche und Lücken.
dash_style	DashStyle	r/w	Liest oder setzt den Stil, der für gestrichelte Linien verwendet wird, die mit diesem Pen gezeichnet werden.
end_cap	LineCap	r/w	Liest oder setzt den Kap-Stil, der am Ende von Linien verwendet wird, die mit diesem Pen gezeichnet werden.
line_join	LineJoin	r/w	Liest oder setzt den Verbindungsstil für die Enden zweier aufeinanderfolgender Linien, die mit diesem Pen gezeichnet werden.
miter_limit	float	r/w	Liest oder setzt die Begrenzung der Dicke der Verbindung an einer Gehrungsecke.
opacity	float	r/w	Liest oder setzt die Deckkraft des Objekts. Der Wert sollte zwischen 0 und 1 liegen. Ein Wert von 0 bedeutet, dass das Objekt vollständig sichtbar ist, ein Wert von 1 bedeutet, dass das Objekt vollständig undurchsichtig ist.
pen_type	PenType	r	Liest den Stil der mit diesem Pen gezeichneten Linien.
start_cap	LineCap	r/w	Liest oder setzt den Kap-Stil, der am Anfang von Linien verwendet wird, die mit diesem Pen gezeichnet werden.
transform	Matrix	r/w	Liest oder setzt eine Kopie der geometrischen Transformation für diesen Pen.
width	float	r/w	Liest oder setzt die Breite dieses Pen, in Einheiten des zum Zeichnen verwendeten Graphics-Objekts.

Methods

Name	Beschreibung
create_with_brush(brush)	Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush.
create_with_brush_width(brush, width)	Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush und Pen.width.
create_with_color(color)	Initialisiert eine neue Instanz der Pen Klasse mit der angegebenen Farbe.
create_with_color_width(color, width)	Initialisiert eine neue Instanz der Pen Klasse mit den angegebenen Pen.color und Pen.width Eigenschaften.
multiply_transform(matrix)	Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix.
multiply_transform(matrix, order)	Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix in der angegebenen Reihenfolge.
reset_transform()	Setzt die geometrische Transformationsmatrix für diesen Pen auf die Identität zurück.
rotate_transform(angle)	Dreht die lokale geometrische Transformation um den angegebenen Winkel. Diese Methode fügt die Rotation der Transformation voran.
rotate_transform(angle, order)	Dreht die lokale geometrische Transformation um den angegebenen Winkel in der angegebenen Reihenfolge.
scale_transform(sx, sy)	Skaliert die lokale geometrische Transformation um die angegebenen Faktoren. Diese Methode fügt die Skalierungsmatrix der Transformation voran.
scale_transform(sx, sy, order)	Skaliert die lokale geometrische Transformation um die angegebenen Faktoren in der angegebenen Reihenfolge.
set_line_cap(start_cap, end_cap, dash_cap)	Setzt die Werte, die den Kap-Stil bestimmen, der zum Beenden von Linien verwendet wird, die mit diesem Pen gezeichnet werden.
translate_transform(dx, dy)	Verschiebt die lokale geometrische Transformation um die angegebenen Dimensionen. Diese Methode fügt die Translation der Transformation voran.
translate_transform(dx, dy, order)	Verschiebt die lokale geometrische Transformation um die angegebenen Dimensionen in der angegebenen Reihenfolge.

Constructor: Pen(brush)

 Pen(brush)

Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush.

Parameters:

Parameter	Typ	Beschreibung
brush	Brush	Ein Pen.brush, der die Fülleigenschaften dieses Pen bestimmt.

Constructor: Pen(brush, width)

 Pen(brush, width)

Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush und Pen.width.

Parameters:

Parameter	Typ	Beschreibung
brush	Brush	Ein Pen.brush, der die Merkmale dieses Pen bestimmt.
width	float	Die Breite des neuen Pen.

Constructor: Pen(color)

 Pen(color)

Initialisiert eine neue Instanz der Pen Klasse mit der angegebenen Farbe.

Parameters:

Parameter	Typ	Beschreibung
color	Color	Eine Pen.color Struktur, die die Farbe dieses Pen angibt.

Constructor: Pen(color, width)

 Pen(color, width)

Initialisiert eine neue Instanz der Pen Klasse mit den angegebenen Pen.color und Pen.width Eigenschaften.

Parameters:

Parameter	Typ	Beschreibung
color	Color	Eine Pen.color Struktur, die die Farbe dieses Pen angibt.
width	float	Ein Wert, der die Breite dieses Pen angibt.

See also:

Example # 1: This example shows the creation and usage Pen objects. The example creates a …

Method: create_with_brush(brush) [static]

 create_with_brush(brush)

Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush.

Parameters:

Parameter	Typ	Beschreibung
brush	Brush	Ein Pen.brush, der die Fülleigenschaften dieses Pen bestimmt.

Returns

Typ	Beschreibung
Pen

Method: create_with_brush_width(brush, width) [static]

 create_with_brush_width(brush, width)

Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Pen.brush und Pen.width.

Parameters:

Parameter	Typ	Beschreibung
brush	Brush	Ein Pen.brush, der die Merkmale dieses Pen bestimmt.
width	float	Die Breite des neuen Pen.

Returns

Typ	Beschreibung
Pen

Method: create_with_color(color) [static]

 create_with_color(color)

Initialisiert eine neue Instanz der Pen Klasse mit der angegebenen Farbe.

Parameters:

Parameter	Typ	Beschreibung
color	Color	Eine Pen.color Struktur, die die Farbe dieses Pen angibt.

Returns

Typ	Beschreibung
Pen

Method: create_with_color_width(color, width) [static]

 create_with_color_width(color, width)

Initialisiert eine neue Instanz der Pen Klasse mit den angegebenen Pen.color und Pen.width Eigenschaften.

Parameters:

Parameter	Typ	Beschreibung
color	Color	Eine Pen.color Struktur, die die Farbe dieses Pen angibt.
width	float	Ein Wert, der die Breite dieses Pen angibt.

Returns

Typ	Beschreibung
Pen

Method: multiply_transform(matrix)

 multiply_transform(matrix)

Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix.

Parameters:

Parameter	Typ	Beschreibung
matrix	Matrix	Das Matrix-Objekt, mit dem die Transformationsmatrix multipliziert wird.

Method: multiply_transform(matrix, order)

 multiply_transform(matrix, order)

Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix in der angegebenen Reihenfolge.

Parameters:

Parameter	Typ	Beschreibung
matrix	Matrix	Die Matrix, mit der die Transformationsmatrix multipliziert wird.
order	MatrixOrder	Die Reihenfolge, in der die Multiplikationsoperation ausgeführt wird.

Method: rotate_transform(angle)

 rotate_transform(angle)

Dreht die lokale geometrische Transformation um den angegebenen Winkel. Diese Methode fügt die Rotation der Transformation voran.

Parameters:

Parameter	Typ	Beschreibung
angle	float	Der Rotationswinkel.

Method: rotate_transform(angle, order)

 rotate_transform(angle, order)

Dreht die lokale geometrische Transformation um den angegebenen Winkel in der angegebenen Reihenfolge.

Parameters:

Parameter	Typ	Beschreibung
angle	float	Der Rotationswinkel.
order	MatrixOrder	Ein MatrixOrder, der angibt, ob die Rotationsmatrix angehängt oder vorangestellt wird.

Method: scale_transform(sx, sy)

 scale_transform(sx, sy)

Skaliert die lokale geometrische Transformation um die angegebenen Faktoren. Diese Methode fügt die Skalierungsmatrix der Transformation voran.

Parameters:

Parameter	Typ	Beschreibung
sx	float	Der Faktor, um den die Transformation in x-Richtung skaliert wird.
sy	float	Der Faktor, um den die Transformation in y-Richtung skaliert wird.

Method: scale_transform(sx, sy, order)

 scale_transform(sx, sy, order)

Skaliert die lokale geometrische Transformation um die angegebenen Faktoren in der angegebenen Reihenfolge.

Parameters:

Parameter	Typ	Beschreibung
sx	float	Der Faktor, um den die Transformation in x-Richtung skaliert wird.
sy	float	Der Faktor, um den die Transformation in y-Richtung skaliert wird.
order	MatrixOrder	Ein MatrixOrder der angibt, ob die Skalierungsmatrix angehängt oder vorangestellt werden soll.

Method: set_line_cap(start_cap, end_cap, dash_cap)

 set_line_cap(start_cap, end_cap, dash_cap)

Setzt die Werte, die den Kap-Stil bestimmen, der zum Beenden von Linien verwendet wird, die mit diesem Pen gezeichnet werden.

Parameters:

Parameter	Typ	Beschreibung
start_cap	LineCap	Ein LineCap, der den Endstil darstellt, der am Anfang von mit diesem Pen gezeichneten Linien verwendet wird.
end_cap	LineCap	Ein LineCap, der den Endstil darstellt, der am Ende von mit diesem Pen gezeichneten Linien verwendet wird.
dash_cap	DashCap	Ein LineCap, der den Endstil darstellt, der am Anfang oder Ende von gestrichelten Linien, die mit diesem Pen gezeichnet werden, verwendet wird.

Method: translate_transform(dx, dy)

 translate_transform(dx, dy)

Verschiebt die lokale geometrische Transformation um die angegebenen Dimensionen. Diese Methode fügt die Translation der Transformation voran.

Parameters:

Parameter	Typ	Beschreibung
dx	float	Der Wert der Verschiebung in x.
dy	float	Der Wert der Verschiebung in y.

Method: translate_transform(dx, dy, order)

 translate_transform(dx, dy, order)

Verschiebt die lokale geometrische Transformation um die angegebenen Dimensionen in der angegebenen Reihenfolge.

Parameters:

Parameter	Typ	Beschreibung
dx	float	Der Wert der Verschiebung in x.
dy	float	Der Wert der Verschiebung in y.
order	MatrixOrder	Die Reihenfolge (voranstellen oder anhängen), in der die Verschiebung angewendet wird.

Examples

This example shows the creation and usage Pen objects. The example creates a new Image and draw rectangles on the Image surface.


from aspose.imaging import Image, Graphics, Color, Pen, Rectangle, Point, Size
from aspose.imaging.brushes import HatchBrush
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.sources import FileCreateSource

# Erstellen Sie eine Instanz von BmpOptions und setzen Sie deren verschiedenen Eigenschaften
bmpOptions = BmpOptions()
bmpOptions.bits_per_pixel = 24
# Erstellen Sie eine Instanz von FileCreateSource und weisen Sie sie als Quelle für die Instanz von BmpOptions zu
# Der zweite boolesche Parameter bestimmt, ob die zu erstellende Datei temporär ist oder nicht
bmpOptions.source = FileCreateSource(r"C:\temp\sample.bmp", False)
# Erstellen Sie eine Instanz von Image am angegebenen Pfad
with Image.create(bmpOptions, 500, 500) as image:
	# Erstellen Sie eine Instanz von Graphics und initialisieren Sie sie mit einem Image‑Objekt
	graphics = Graphics(image)
	# Löschen Sie die Graphics‑Oberfläche mit weißer Farbe
	graphics.clear(Color.white)
	#Erstellen Sie eine Instanz von Pen mit der Farbe Rot und einer Breite von 5
	pen = Pen(Color.red, 5.0);
	# Erstellen Sie eine Instanz von HatchBrush und setzen Sie deren Eigenschaften
	brush = HatchBrush()
	brush.background_color = Color.wheat;
	brush.foreground_color = Color.red;
	# Erstellen Sie eine Instanz von Pen
	# Initialisieren Sie es mit einem HatchBrush-Objekt und einer Breite
	brusedpen = Pen(brush, 5.0)
	# Zeichnen Sie Rechtecke, indem Sie ein Pen-Objekt angeben
	graphics.draw_rectangles(pen, [
		Rectangle(Point(210, 210), Size(100, 100)),
		Rectangle(Point(110, 110), Size(100, 100)),
		Rectangle(Point(310, 310), Size(100, 100)) ])

	# Zeichnen Sie Rechtecke, indem Sie ein Pen-Objekt angeben
	graphics.draw_rectangles(brusedpen, [
		Rectangle(Point(310, 110), Size(100, 100)),
		Rectangle(Point(110, 310), Size(100, 100)) ])

	# Alle Änderungen speichern.
	image.save()

OpenTypeFontsCache‑Klasse PixelDataFormat Klasse