Pen Classe

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

Module: aspose.imaging

Full Name: aspose.imaging.Pen

Inheritance: TransparencySupporter

Constructors

NameDescrizione
Pen(brush)Inizializza una nuova istanza della classe Pen con il Pen.brush specificato.
Pen(brush, width)Inizializza una nuova istanza della classe Pen con il Pen.brush e il Pen.width specificati.
Pen(color)Inizializza una nuova istanza della classe Pen con il colore specificato.
Pen(color, width)Inizializza una nuova istanza della classe Pen con le proprietà Pen.color e Pen.width specificate.

Properties

NameTypeAccessDescrizione
alignmentPenAlignmentr/wOttiene o imposta l’allineamento per questo Pen.
brushBrushr/wOttiene o imposta il Pen.brush che determina gli attributi di questo Pen.
colorColorr/wOttiene o imposta il colore di questo Pen.
compound_arrayfloat[]r/wOttiene o imposta un array di valori che specifica una penna composta. Una penna composta disegna una linea composta da linee parallele e spazi.
custom_end_capCustomLineCapr/wOttiene o imposta un cappuccio personalizzato da utilizzare alla fine delle linee disegnate con questo Pen.
custom_start_capCustomLineCapr/wOttiene o imposta un cappuccio personalizzato da utilizzare all’inizio delle linee disegnate con questo Pen.
dash_capDashCapr/wOttiene o imposta lo stile del cappuccio usato alla fine dei trattini che compongono le linee tratteggiate disegnate con questo Pen.
dash_offsetfloatr/wOttiene o imposta la distanza dall’inizio di una linea all’inizio di un modello di trattini.
dash_patternfloat[]r/wOttiene o imposta un array di trattini e spazi personalizzati.
dash_styleDashStyler/wOttiene o imposta lo stile usato per le linee tratteggiate disegnate con questo Pen.
end_capLineCapr/wOttiene o imposta lo stile di estremità usato alla fine delle linee disegnate con questo Pen.
line_joinLineJoinr/wOttiene o imposta lo stile di giunzione per le estremità di due linee consecutive disegnate con questo Pen.
miter_limitfloatr/wOttiene o imposta il limite dello spessore della giunzione su un angolo a spigolo.
opacityfloatr/wOttiene o imposta l’opacità dell’oggetto. Il valore deve essere compreso tra 0 e 1. Un valore di 0 indica che l’oggetto è completamente visibile, un valore di 1 indica che l’oggetto è completamente opaco.
pen_typePenTyperOttiene lo stile delle linee disegnate con questo Pen.
start_capLineCapr/wOttiene o imposta lo stile di estremità usato all’inizio delle linee disegnate con questo Pen.
transformMatrixr/wOttiene o imposta una copia della trasformazione geometrica per questo Pen.
widthfloatr/wOttiene o imposta la larghezza di questo Pen, nelle unità dell’oggetto Graphics usato per il disegno.

Methods

NameDescrizione
create_with_brush(brush)Inizializza una nuova istanza della classe Pen con il Pen.brush specificato.
create_with_brush_width(brush, width)Inizializza una nuova istanza della classe Pen con il Pen.brush e il Pen.width specificati.
create_with_color(color)Inizializza una nuova istanza della classe Pen con il colore specificato.
create_with_color_width(color, width)Inizializza una nuova istanza della classe Pen con le proprietà Pen.color e Pen.width specificate.
multiply_transform(matrix)Moltiplica la matrice di trasformazione per questo Pen per la Matrix specificata.
multiply_transform(matrix, order)Moltiplica la matrice di trasformazione per questo Pen per la Matrix specificata nell’ordine specificato.
reset_transform()Reimposta la matrice di trasformazione geometrica per questo Pen all’identità.
rotate_transform(angle)Ruota la trasformazione geometrica locale dell’angolo specificato. Questo metodo antepone la rotazione alla trasformazione.
rotate_transform(angle, order)Ruota la trasformazione geometrica locale dell’angolo specificato nell’ordine specificato.
scale_transform(sx, sy)Scala la trasformazione geometrica locale dei fattori specificati. Questo metodo antepone la matrice di scala alla trasformazione.
scale_transform(sx, sy, order)Scala la trasformazione geometrica locale dei fattori specificati nell’ordine specificato.
set_line_cap(start_cap, end_cap, dash_cap)Imposta i valori che determinano lo stile di estremità usato per terminare le linee disegnate da questo Pen.
translate_transform(dx, dy)Trasla la trasformazione geometrica locale delle dimensioni specificate. Questo metodo antepone la traslazione alla trasformazione.
translate_transform(dx, dy, order)Trasla la trasformazione geometrica locale delle dimensioni specificate nell’ordine specificato.

Constructor: Pen(brush)

 Pen(brush) 

Inizializza una nuova istanza della classe Pen con il Pen.brush specificato.

Parameters:

ParametroTipoDescrizione
brushBrushUn Pen.brush che determina le proprietà di riempimento di questo Pen.

Constructor: Pen(brush, width)

 Pen(brush, width) 

Inizializza una nuova istanza della classe Pen con il Pen.brush e il Pen.width specificati.

Parameters:

ParametroTipoDescrizione
brushBrushUn Pen.brush che determina le caratteristiche di questo Pen.
widthfloatLa larghezza del nuovo Pen.

Constructor: Pen(color)

 Pen(color) 

Inizializza una nuova istanza della classe Pen con il colore specificato.

Parameters:

ParametroTipoDescrizione
colorColorUna struttura Pen.color che indica il colore di questo Pen.

Constructor: Pen(color, width)

 Pen(color, width) 

Inizializza una nuova istanza della classe Pen con le proprietà Pen.color e Pen.width specificate.

Parameters:

ParametroTipoDescrizione
colorColorUna struttura Pen.color che indica il colore di questo Pen.
widthfloatUn valore che indica la larghezza di questo 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) 

Inizializza una nuova istanza della classe Pen con il Pen.brush specificato.

Parameters:

ParametroTipoDescrizione
brushBrushUn Pen.brush che determina le proprietà di riempimento di questo Pen.

Returns

TipoDescrizione
Pen

Method: create_with_brush_width(brush, width) [static]

 create_with_brush_width(brush, width) 

Inizializza una nuova istanza della classe Pen con il Pen.brush e il Pen.width specificati.

Parameters:

ParametroTipoDescrizione
brushBrushUn Pen.brush che determina le caratteristiche di questo Pen.
widthfloatLa larghezza del nuovo Pen.

Returns

TipoDescrizione
Pen

Method: create_with_color(color) [static]

 create_with_color(color) 

Inizializza una nuova istanza della classe Pen con il colore specificato.

Parameters:

ParametroTipoDescrizione
colorColorUna struttura Pen.color che indica il colore di questo Pen.

Returns

TipoDescrizione
Pen

Method: create_with_color_width(color, width) [static]

 create_with_color_width(color, width) 

Inizializza una nuova istanza della classe Pen con le proprietà Pen.color e Pen.width specificate.

Parameters:

ParametroTipoDescrizione
colorColorUna struttura Pen.color che indica il colore di questo Pen.
widthfloatUn valore che indica la larghezza di questo Pen.

Returns

TipoDescrizione
Pen

Method: multiply_transform(matrix)

 multiply_transform(matrix) 

Moltiplica la matrice di trasformazione per questo Pen per la Matrix specificata.

Parameters:

ParametroTipoDescrizione
matrixMatrixL’oggetto Matrix con cui moltiplicare la matrice di trasformazione.

Method: multiply_transform(matrix, order)

 multiply_transform(matrix, order) 

Moltiplica la matrice di trasformazione per questo Pen per la Matrix specificata nell’ordine specificato.

Parameters:

ParametroTipoDescrizione
matrixMatrixLa Matrix con cui moltiplicare la matrice di trasformazione.
orderMatrixOrderL’ordine in cui eseguire l’operazione di moltiplicazione.

Method: rotate_transform(angle)

 rotate_transform(angle) 

Ruota la trasformazione geometrica locale dell’angolo specificato. Questo metodo antepone la rotazione alla trasformazione.

Parameters:

ParametroTipoDescrizione
anglefloatL’angolo di rotazione.

Method: rotate_transform(angle, order)

 rotate_transform(angle, order) 

Ruota la trasformazione geometrica locale dell’angolo specificato nell’ordine specificato.

Parameters:

ParametroTipoDescrizione
anglefloatL’angolo di rotazione.
orderMatrixOrderUn MatrixOrder che specifica se aggiungere o pre-pendere la matrice di rotazione.

Method: scale_transform(sx, sy)

 scale_transform(sx, sy) 

Scala la trasformazione geometrica locale dei fattori specificati. Questo metodo antepone la matrice di scala alla trasformazione.

Parameters:

ParametroTipoDescrizione
sxfloatIl fattore con cui scalare la trasformazione nella direzione dell’asse x.
syfloatIl fattore con cui scalare la trasformazione nella direzione dell’asse y.

Method: scale_transform(sx, sy, order)

 scale_transform(sx, sy, order) 

Scala la trasformazione geometrica locale dei fattori specificati nell’ordine specificato.

Parameters:

ParametroTipoDescrizione
sxfloatIl fattore con cui scalare la trasformazione nella direzione dell’asse x.
syfloatIl fattore con cui scalare la trasformazione nella direzione dell’asse y.
orderMatrixOrderUn MatrixOrder che specifica se aggiungere o anteporre la matrice di scaling.

Method: set_line_cap(start_cap, end_cap, dash_cap)

 set_line_cap(start_cap, end_cap, dash_cap) 

Imposta i valori che determinano lo stile di estremità usato per terminare le linee disegnate da questo Pen.

Parameters:

ParametroTipoDescrizione
start_capLineCapUn LineCap che rappresenta lo stile di estremità da usare all’inizio delle linee disegnate con questo Pen.
end_capLineCapUn LineCap che rappresenta lo stile di estremità da usare alla fine delle linee disegnate con questo Pen.
dash_capDashCapUn LineCap che rappresenta lo stile di estremità da usare all’inizio o alla fine delle linee tratteggiate disegnate con questo Pen.

Method: translate_transform(dx, dy)

 translate_transform(dx, dy) 

Trasla la trasformazione geometrica locale delle dimensioni specificate. Questo metodo antepone la traslazione alla trasformazione.

Parameters:

ParametroTipoDescrizione
dxfloatIl valore della traslazione in x.
dyfloatIl valore della traslazione in y.

Method: translate_transform(dx, dy, order)

 translate_transform(dx, dy, order) 

Trasla la trasformazione geometrica locale delle dimensioni specificate nell’ordine specificato.

Parameters:

ParametroTipoDescrizione
dxfloatIl valore della traslazione in x.
dyfloatIl valore della traslazione in y.
orderMatrixOrderL’ordine (anteporre o aggiungere) con cui applicare la traslazione.

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

# Crea un'istanza di BmpOptions e imposta le sue varie proprietà
bmpOptions = BmpOptions()
bmpOptions.bits_per_pixel = 24
# Crea un'istanza di FileCreateSource e assegnala come sorgente per l'istanza di BmpOptions
# Il secondo parametro Booleano determina se il file da creare è temporaneo o meno
bmpOptions.source = FileCreateSource(r"C:\temp\sample.bmp", False)
# Crea un'istanza di Image nel percorso specificato
with Image.create(bmpOptions, 500, 500) as image:
	# Crea un'istanza di Graphics e inizializzala con l'oggetto Image
	graphics = Graphics(image)
	# Cancella la superficie Graphics con colore bianco
	graphics.clear(Color.white)
	#Crea un'istanza di Pen con colore rosso e larghezza 5
	pen = Pen(Color.red, 5.0);
	# Crea un'istanza di HatchBrush e imposta le sue proprietà
	brush = HatchBrush()
	brush.background_color = Color.wheat;
	brush.foreground_color = Color.red;
	# Crea un'istanza di Pen
	# inizializzalo con l'oggetto HatchBrush e la larghezza
	brusedpen = Pen(brush, 5.0)
	# Disegna rettangoli specificando l'oggetto Pen
	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)) ])

	# Disegna rettangoli specificando l'oggetto Pen
	graphics.draw_rectangles(brusedpen, [
		Rectangle(Point(310, 110), Size(100, 100)),
		Rectangle(Point(110, 310), Size(100, 100)) ])

	# salva tutte le modifiche.
	image.save()