Класс Pen

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

Full Name: aspose.imaging.Pen

Inheritance: TransparencySupporter

Constructors

Name	Description
Pen(brush)	Инициализирует новый экземпляр класса Pen с указанным Pen.brush.
Pen(brush, width)	Инициализирует новый экземпляр класса Pen с указанными Pen.brush и Pen.width.
Pen(color)	Инициализирует новый экземпляр класса Pen с указанным цветом.
Pen(color, width)	Инициализирует новый экземпляр класса Pen с указанными свойствами Pen.color и Pen.width.

Properties

Name	Type	Access	Description
alignment	PenAlignment	r/w	Получает или задаёт выравнивание для этого Pen.
brush	Brush	r/w	Получает или задаёт Pen.brush, определяющий атрибуты этого Pen.
color	Color	r/w	Получает или задаёт цвет этого Pen.
compound_array	float[]	r/w	Получает или задаёт массив значений, определяющих составное перо. Составное перо рисует составную линию, состоящую из параллельных линий и промежутков.
custom_end_cap	CustomLineCap	r/w	Получает или задаёт пользовательскую насадку, используемую в конце линий, нарисованных этим Pen.
custom_start_cap	CustomLineCap	r/w	Получает или задаёт пользовательскую насадку, используемую в начале линий, нарисованных этим Pen.
dash_cap	DashCap	r/w	Получает или задаёт стиль насадки, используемый в конце штрихов, составляющих пунктирные линии, нарисованные этим Pen.
dash_offset	float	r/w	Получает или задает расстояние от начала линии до начала шаблона штриха.
dash_pattern	float[]	r/w	Получает или задает массив пользовательских штрихов и пробелов.
dash_style	DashStyle	r/w	Получает или задает стиль, используемый для пунктирных линий, нарисованных с помощью этого Pen.
end_cap	LineCap	r/w	Получает или задает стиль окончания, используемый в конце линий, нарисованных с помощью этого Pen.
line_join	LineJoin	r/w	Получает или задает стиль соединения для концов двух последовательных линий, нарисованных с помощью этого Pen.
miter_limit	float	r/w	Получает или задает предел толщины соединения на скошенном угле.
opacity	float	r/w	Получает или задает непрозрачность объекта. Значение должно быть от 0 до 1. Значение 0 означает, что объект полностью видим, значение 1 означает, что объект полностью непрозрачен.
pen_type	PenType	r	Получает стиль линий, нарисованных с помощью этого Pen.
start_cap	LineCap	r/w	Получает или задает стиль окончания, используемый в начале линий, нарисованных с помощью этого Pen.
transform	Matrix	r/w	Получает или задает копию геометрического преобразования для этого Pen.
width	float	r/w	Получает или задает ширину этого Pen, в единицах объекта Graphics, используемого для рисования.

Methods

Name	Description
create_with_brush(brush)	Инициализирует новый экземпляр класса Pen с указанным Pen.brush.
create_with_brush_width(brush, width)	Инициализирует новый экземпляр класса Pen с указанными Pen.brush и Pen.width.
create_with_color(color)	Инициализирует новый экземпляр класса Pen с указанным цветом.
create_with_color_width(color, width)	Инициализирует новый экземпляр класса Pen с указанными свойствами Pen.color и Pen.width.
multiply_transform(matrix)	Умножает матрицу преобразования для этого Pen на указанную Matrix.
multiply_transform(matrix, order)	Умножает матрицу преобразования для этого Pen на указанную Matrix в заданном порядке.
reset_transform()	Сбрасывает матрицу геометрического преобразования для этого Pen к единичной.
rotate_transform(angle)	Вращает локальное геометрическое преобразование на указанный угол. Этот метод добавляет вращение в начало преобразования.
rotate_transform(angle, order)	Вращает локальное геометрическое преобразование на указанный угол в заданном порядке.
scale_transform(sx, sy)	Масштабирует локальное геометрическое преобразование на указанные коэффициенты. Этот метод добавляет матрицу масштабирования в начало преобразования.
scale_transform(sx, sy, order)	Масштабирует локальное геометрическое преобразование на указанные коэффициенты в заданном порядке.
set_line_cap(start_cap, end_cap, dash_cap)	Устанавливает значения, определяющие стиль окончания, используемый для завершения линий, нарисованных этим Pen.
translate_transform(dx, dy)	Перемещает локальное геометрическое преобразование на указанные размеры. Этот метод добавляет трансляцию в начало преобразования.
translate_transform(dx, dy, order)	Перемещает локальное геометрическое преобразование на указанные размеры в заданном порядке.

Constructor: Pen(brush)

 Pen(brush)

Инициализирует новый экземпляр класса Pen с указанным Pen.brush.

Parameters:

Параметр	Тип	Описание
brush	Brush	Объект Pen.brush, определяющий свойства заливки этого Pen.

Constructor: Pen(brush, width)

 Pen(brush, width)

Инициализирует новый экземпляр класса Pen с указанными Pen.brush и Pen.width.

Parameters:

Параметр	Тип	Описание
brush	Brush	Объект Pen.brush, определяющий характеристики этого Pen.
width	float	Ширина нового Pen.

Constructor: Pen(color)

 Pen(color)

Инициализирует новый экземпляр класса Pen с указанным цветом.

Parameters:

Параметр	Тип	Описание
color	Color	Структура Pen.color, указывающая цвет этого Pen.

Constructor: Pen(color, width)

 Pen(color, width)

Инициализирует новый экземпляр класса Pen с указанными свойствами Pen.color и Pen.width.

Parameters:

Параметр	Тип	Описание
color	Color	Структура Pen.color, указывающая цвет этого Pen.
width	float	Значение, указывающее ширину этого 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)

Инициализирует новый экземпляр класса Pen с указанным Pen.brush.

Parameters:

Параметр	Тип	Описание
brush	Brush	Объект Pen.brush, определяющий свойства заливки этого Pen.

Returns

Тип	Описание
Pen

Method: create_with_brush_width(brush, width) [static]

 create_with_brush_width(brush, width)

Инициализирует новый экземпляр класса Pen с указанными Pen.brush и Pen.width.

Parameters:

Параметр	Тип	Описание
brush	Brush	Объект Pen.brush, определяющий характеристики этого Pen.
width	float	Ширина нового Pen.

Returns

Тип	Описание
Pen

Method: create_with_color(color) [static]

 create_with_color(color)

Инициализирует новый экземпляр класса Pen с указанным цветом.

Parameters:

Параметр	Тип	Описание
color	Color	Структура Pen.color, указывающая цвет этого Pen.

Returns

Тип	Описание
Pen

Method: create_with_color_width(color, width) [static]

 create_with_color_width(color, width)

Инициализирует новый экземпляр класса Pen с указанными свойствами Pen.color и Pen.width.

Parameters:

Параметр	Тип	Описание
color	Color	Структура Pen.color, указывающая цвет этого Pen.
width	float	Значение, указывающее ширину этого Pen.

Returns

Тип	Описание
Pen

Method: multiply_transform(matrix)

 multiply_transform(matrix)

Умножает матрицу преобразования для этого Pen на указанную Matrix.

Parameters:

Параметр	Тип	Описание
matrix	Matrix	Объект Matrix, с помощью которого умножать матрицу преобразования.

Method: multiply_transform(matrix, order)

 multiply_transform(matrix, order)

Умножает матрицу преобразования для этого Pen на указанную Matrix в заданном порядке.

Parameters:

Параметр	Тип	Описание
matrix	Matrix	Matrix, с помощью которого умножать матрицу преобразования.
order	MatrixOrder	Порядок, в котором выполнять операцию умножения.

Method: rotate_transform(angle)

 rotate_transform(angle)

Вращает локальное геометрическое преобразование на указанный угол. Этот метод добавляет вращение в начало преобразования.

Parameters:

Параметр	Тип	Описание
угол	float	Угол вращения.

Method: rotate_transform(angle, order)

 rotate_transform(angle, order)

Вращает локальное геометрическое преобразование на указанный угол в заданном порядке.

Parameters:

Параметр	Тип	Описание
угол	float	Угол вращения.
order	MatrixOrder	Структура MatrixOrder, указывающая, следует ли добавить в конец или в начало матрицу вращения.

Method: scale_transform(sx, sy)

 scale_transform(sx, sy)

Масштабирует локальное геометрическое преобразование на указанные коэффициенты. Этот метод добавляет матрицу масштабирования в начало преобразования.

Parameters:

Параметр	Тип	Описание
sx	float	Коэффициент, на который масштабировать преобразование по оси x.
sy	float	Коэффициент, на который масштабировать преобразование по оси y.

Method: scale_transform(sx, sy, order)

 scale_transform(sx, sy, order)

Масштабирует локальное геометрическое преобразование на указанные коэффициенты в заданном порядке.

Parameters:

Параметр	Тип	Описание
sx	float	Коэффициент, на который масштабировать преобразование по оси x.
sy	float	Коэффициент, на который масштабировать преобразование по оси y.
order	MatrixOrder	Тип MatrixOrder который указывает, добавлять или предварять матрицу масштабирования.

Method: set_line_cap(start_cap, end_cap, dash_cap)

 set_line_cap(start_cap, end_cap, dash_cap)

Устанавливает значения, определяющие стиль окончания, используемый для завершения линий, нарисованных этим Pen.

Parameters:

Параметр	Тип	Описание
start_cap	LineCap	Объект LineCap, представляющий стиль окончания, используемый в начале линий, нарисованных этим Pen.
end_cap	LineCap	Объект LineCap, представляющий стиль окончания, используемый в конце линий, нарисованных этим Pen.
dash_cap	DashCap	Объект LineCap, представляющий стиль окончания, используемый в начале или в конце пунктирных линий, нарисованных этим Pen.

Method: translate_transform(dx, dy)

 translate_transform(dx, dy)

Перемещает локальное геометрическое преобразование на указанные размеры. Этот метод добавляет трансляцию в начало преобразования.

Parameters:

Параметр	Тип	Описание
dx	float	Значение трансляции по оси x.
dy	float	Значение трансляции по оси y.

Method: translate_transform(dx, dy, order)

 translate_transform(dx, dy, order)

Перемещает локальное геометрическое преобразование на указанные размеры в заданном порядке.

Parameters:

Параметр	Тип	Описание
dx	float	Значение трансляции по оси x.
dy	float	Значение трансляции по оси y.
order	MatrixOrder	Порядок (предварительно или последовательно), в котором применяется трансляция.

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

# Создайте экземпляр BmpOptions и задайте его различные свойства
bmpOptions = BmpOptions()
bmpOptions.bits_per_pixel = 24
# Создайте экземпляр FileCreateSource и назначьте его в качестве Source для экземпляра BmpOptions
# Второй параметр типа Boolean определяет, будет ли создаваемый файл IsTemporal или нет
bmpOptions.source = FileCreateSource(r"C:\temp\sample.bmp", False)
# Создайте экземпляр Image по указанному пути
with Image.create(bmpOptions, 500, 500) as image:
	# Создайте экземпляр Graphics и инициализируйте его объектом Image
	graphics = Graphics(image)
	# Очистите поверхность Graphics белым цветом
	graphics.clear(Color.white)
	#Создайте экземпляр Pen с красным цветом и шириной 5
	pen = Pen(Color.red, 5.0);
	# Создайте экземпляр HatchBrush и задайте его свойства
	brush = HatchBrush()
	brush.background_color = Color.wheat;
	brush.foreground_color = Color.red;
	# Создайте экземпляр Pen
	# инициализировать его объектом HatchBrush и шириной
	brusedpen = Pen(brush, 5.0)
	# Рисовать прямоугольники, указывая объект 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)) ])

	# Рисовать прямоугольники, указывая объект Pen
	graphics.draw_rectangles(brusedpen, [
		Rectangle(Point(310, 110), Size(100, 100)),
		Rectangle(Point(110, 310), Size(100, 100)) ])

	# Сохраните все изменения.
	image.save()

Класс OpenTypeFontsCache Класс PixelDataFormat