Pen Class

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

Full Name: aspose.imaging.Pen

Inheritance: TransparencySupporter

Constructors

Name	Description
Pen(brush)	Initierar en ny instans av klassen Pen med den angivna Pen.brush.
Pen(brush, width)	Initierar en ny instans av klassen Pen med den angivna Pen.brush och Pen.width.
Pen(color)	Initierar en ny instans av klassen Pen med den angivna färgen.
Pen(color, width)	Initierar en ny instans av klassen Pen med de angivna egenskaperna Pen.color och Pen.width.

Properties

Name	Type	Access	Description
alignment	PenAlignment	r/w	Hämtar eller anger justeringen för denna Pen.
brush	Brush	r/w	Hämtar eller anger Pen.brush som bestämmer attributen för denna Pen.
color	Color	r/w	Hämtar eller anger färgen på denna Pen.
compound_array	float[]	r/w	Hämtar eller anger en array av värden som specificerar en sammansatt penna. En sammansatt penna ritar en sammansatt linje bestående av parallella linjer och mellanrum.
custom_end_cap	CustomLineCap	r/w	Hämtar eller anger en anpassad spets att använda i slutet av linjer som ritas med denna Pen.
custom_start_cap	CustomLineCap	r/w	Hämtar eller anger en anpassad spets att använda i början av linjer som ritas med denna Pen.
dash_cap	DashCap	r/w	Hämtar eller anger spetsstilen som används i slutet av strecken som utgör streckade linjer ritat med denna Pen.
dash_offset	float	r/w	Hämtar eller anger avståndet från början av en linje till början av ett streckmönster.
dash_pattern	float[]	r/w	Hämtar eller anger en array av anpassade streck och mellanslag.
dash_style	DashStyle	r/w	Hämtar eller anger stilen som används för streckade linjer som ritas med denna Pen.
end_cap	LineCap	r/w	Hämtar eller anger kapstil som används i slutet av linjer som ritas med denna Pen.
line_join	LineJoin	r/w	Hämtar eller anger sammanfogningsstil för ändarna på två på varandra följande linjer som ritas med denna Pen.
miter_limit	float	r/w	Hämtar eller anger gränsen för tjockleken på sammanfogningen i ett fasat hörn.
opacity	float	r/w	Hämtar eller anger objektets opacitet. Värdet bör vara mellan 0 och 1. Värdet 0 betyder att objektet är helt synligt, värdet 1 betyder att objektet är helt ogenomskinligt.
pen_type	PenType	r	Hämtar stilen på linjer som ritas med denna Pen.
start_cap	LineCap	r/w	Hämtar eller anger kapstil som används i början av linjer som ritas med denna Pen.
transform	Matrix	r/w	Hämtar eller anger en kopia av den geometriska transformationen för denna Pen.
width	float	r/w	Hämtar eller anger bredden på denna Pen, i enheter av Graphics-objektet som används för ritning.

Methods

Name	Description
create_with_brush(brush)	Initierar en ny instans av klassen Pen med den angivna Pen.brush.
create_with_brush_width(brush, width)	Initierar en ny instans av klassen Pen med den angivna Pen.brush och Pen.width.
create_with_color(color)	Initierar en ny instans av klassen Pen med den angivna färgen.
create_with_color_width(color, width)	Initierar en ny instans av klassen Pen med de angivna egenskaperna Pen.color och Pen.width.
multiply_transform(matrix)	Multiplicerar transformationsmatrisen för denna Pen med den angivna Matrix.
multiply_transform(matrix, order)	Multiplicerar transformationsmatrisen för denna Pen med den angivna Matrix i den angivna ordningen.
reset_transform()	Återställer den geometriska transformationsmatrisen för denna Pen till identitet.
rotate_transform(angle)	Roterar den lokala geometriska transformationen med den angivna vinkeln. Denna metod lägger rotationen före transformationen.
rotate_transform(angle, order)	Roterar den lokala geometriska transformationen med den angivna vinkeln i den angivna ordningen.
scale_transform(sx, sy)	Skalar den lokala geometriska transformationen med de angivna faktorerna. Denna metod lägger skalningsmatrisen före transformationen.
scale_transform(sx, sy, order)	Skalar den lokala geometriska transformationen med de angivna faktorerna i den angivna ordningen.
set_line_cap(start_cap, end_cap, dash_cap)	Anger värdena som bestämmer kapstilen som används för att avsluta linjer ritade av denna Pen.
translate_transform(dx, dy)	Översätter den lokala geometriska transformationen med de angivna dimensionerna. Denna metod lägger översättningen före transformationen.
translate_transform(dx, dy, order)	Översätter den lokala geometriska transformationen med de angivna dimensionerna i den angivna ordningen.

Constructor: Pen(brush)

 Pen(brush)

Initierar en ny instans av klassen Pen med den angivna Pen.brush.

Parameters:

Parameter	Typ	Beskrivning
brush	Brush	En Pen.brush som bestämmer fyllningsegenskaperna för denna Pen.

Constructor: Pen(brush, width)

 Pen(brush, width)

Initierar en ny instans av klassen Pen med den angivna Pen.brush och Pen.width.

Parameters:

Parameter	Typ	Beskrivning
brush	Brush	En Pen.brush som bestämmer egenskaperna för denna Pen.
width	float	Bredden på den nya Pen.

Constructor: Pen(color)

 Pen(color)

Initierar en ny instans av klassen Pen med den angivna färgen.

Parameters:

Parameter	Typ	Beskrivning
color	Color	En Pen.color struktur som anger färgen på denna Pen.

Constructor: Pen(color, width)

 Pen(color, width)

Initierar en ny instans av klassen Pen med de angivna egenskaperna Pen.color och Pen.width.

Parameters:

Parameter	Typ	Beskrivning
color	Color	En Pen.color struktur som anger färgen på denna Pen.
width	float	Ett värde som anger bredden på denna Pen.

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)

Initierar en ny instans av klassen Pen med den angivna Pen.brush.

Parameters:

Parameter	Typ	Beskrivning
brush	Brush	En Pen.brush som bestämmer fyllningsegenskaperna för denna Pen.

Returns

Typ	Beskrivning
Pen

Method: create_with_brush_width(brush, width) [static]

 create_with_brush_width(brush, width)

Initierar en ny instans av klassen Pen med den angivna Pen.brush och Pen.width.

Parameters:

Parameter	Typ	Beskrivning
brush	Brush	En Pen.brush som bestämmer egenskaperna för denna Pen.
width	float	Bredden på den nya Pen.

Returns

Typ	Beskrivning
Pen

Method: create_with_color(color) [static]

 create_with_color(color)

Initierar en ny instans av klassen Pen med den angivna färgen.

Parameters:

Parameter	Typ	Beskrivning
color	Color	En Pen.color struktur som anger färgen på denna Pen.

Returns

Typ	Beskrivning
Pen

Method: create_with_color_width(color, width) [static]

 create_with_color_width(color, width)

Initierar en ny instans av klassen Pen med de angivna egenskaperna Pen.color och Pen.width.

Parameters:

Parameter	Typ	Beskrivning
color	Color	En Pen.color struktur som anger färgen på denna Pen.
width	float	Ett värde som anger bredden på denna Pen.

Returns

Typ	Beskrivning
Pen

Method: multiply_transform(matrix)

 multiply_transform(matrix)

Multiplicerar transformationsmatrisen för denna Pen med den angivna Matrix.

Parameters:

Parameter	Typ	Beskrivning
matrix	Matrix	Det Matrix‑objektet som ska multipliceras med transformationsmatrisen.

Method: multiply_transform(matrix, order)

 multiply_transform(matrix, order)

Multiplicerar transformationsmatrisen för denna Pen med den angivna Matrix i den angivna ordningen.

Parameters:

Parameter	Typ	Beskrivning
matrix	Matrix	Den Matrix som ska multipliceras med transformationsmatrisen.
order	MatrixOrder	Den ordning i vilken multiplikationsoperationen ska utföras.

Method: rotate_transform(angle)

 rotate_transform(angle)

Roterar den lokala geometriska transformationen med den angivna vinkeln. Denna metod lägger rotationen före transformationen.

Parameters:

Parameter	Typ	Beskrivning
vinkel	float	Rotationsvinkeln.

Method: rotate_transform(angle, order)

 rotate_transform(angle, order)

Roterar den lokala geometriska transformationen med den angivna vinkeln i den angivna ordningen.

Parameters:

Parameter	Typ	Beskrivning
vinkel	float	Rotationsvinkeln.
order	MatrixOrder	En MatrixOrder som specificerar om rotationsmatrisen ska läggas till i slutet eller i början.

Method: scale_transform(sx, sy)

 scale_transform(sx, sy)

Skalar den lokala geometriska transformationen med de angivna faktorerna. Denna metod lägger skalningsmatrisen före transformationen.

Parameters:

Parameter	Typ	Beskrivning
sx	float	Faktorn som ska skalas transformationen i x‑axelns riktning.
sy	float	Faktorn som ska skalas transformationen i y‑axelns riktning.

Method: scale_transform(sx, sy, order)

 scale_transform(sx, sy, order)

Skalar den lokala geometriska transformationen med de angivna faktorerna i den angivna ordningen.

Parameters:

Parameter	Typ	Beskrivning
sx	float	Faktorn som ska skalas transformationen i x‑axelns riktning.
sy	float	Faktorn som ska skalas transformationen i y‑axelns riktning.
order	MatrixOrder	En MatrixOrder som anger om skalningsmatrisen ska läggas till eller föregås.

Method: set_line_cap(start_cap, end_cap, dash_cap)

 set_line_cap(start_cap, end_cap, dash_cap)

Anger värdena som bestämmer kapstilen som används för att avsluta linjer ritade av denna Pen.

Parameters:

Parameter	Typ	Beskrivning
start_cap	LineCap	En LineCap som representerar kapstilen att använda i början av linjer som ritas med denna Pen.
end_cap	LineCap	En LineCap som representerar kapstilen att använda i slutet av linjer som ritas med denna Pen.
dash_cap	DashCap	En LineCap som representerar kapstilen att använda i början eller slutet av streckade linjer som ritas med denna Pen.

Method: translate_transform(dx, dy)

 translate_transform(dx, dy)

Översätter den lokala geometriska transformationen med de angivna dimensionerna. Denna metod lägger översättningen före transformationen.

Parameters:

Parameter	Typ	Beskrivning
dx	float	Värdet för translationen i x.
dy	float	Värdet för translationen i y.

Method: translate_transform(dx, dy, order)

 translate_transform(dx, dy, order)

Översätter den lokala geometriska transformationen med de angivna dimensionerna i den angivna ordningen.

Parameters:

Parameter	Typ	Beskrivning
dx	float	Värdet för translationen i x.
dy	float	Värdet för translationen i y.
order	MatrixOrder	Ordningen (före eller efter) i vilken translationen ska tillämpas.

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

# Skapa en instans av BmpOptions och sätt dess olika egenskaper
bmpOptions = BmpOptions()
bmpOptions.bits_per_pixel = 24
# Skapa en instans av FileCreateSource och tilldela den som källa för instansen av BmpOptions
# Den andra booleska parametern bestämmer om filen som ska skapas är temporär eller inte
bmpOptions.source = FileCreateSource(r"C:\temp\sample.bmp", False)
# Skapa en instans av Image på angiven sökväg
with Image.create(bmpOptions, 500, 500) as image:
	# Skapa en instans av Graphics och initiera den med Image‑objektet
	graphics = Graphics(image)
	# Rensa Graphics‑ytan med vit färg
	graphics.clear(Color.white)
	#Skapa en instans av Pen med färgen röd och bredd 5
	pen = Pen(Color.red, 5.0);
	# Skapa en instans av HatchBrush och sätt dess egenskaper
	brush = HatchBrush()
	brush.background_color = Color.wheat;
	brush.foreground_color = Color.red;
	# Skapa en instans av Pen
	# initiera den med HatchBrush-objekt och bredd
	brusedpen = Pen(brush, 5.0)
	# Rita rektanglar genom att ange Pen-objekt
	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)) ])

	# Rita rektanglar genom att ange Pen-objekt
	graphics.draw_rectangles(brusedpen, [
		Rectangle(Point(310, 110), Size(100, 100)),
		Rectangle(Point(110, 310), Size(100, 100)) ])

	# spara alla ändringar.
	image.save()

OpenTypeFontsCache-klass PixelDataFormat klass