فئة Pen

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

Module: aspose.imaging

Full Name: aspose.imaging.Pen

Inheritance: TransparencySupporter

Constructors

Name	الوصف
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	الوصف
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	الوصف
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:

معامل	نوع	الوصف
angle	float	زاوية الدوران.

Method: rotate_transform(angle, order)

 rotate_transform(angle, order) 

يدور التحويل الهندسي المحلي بالزاوية المحددة بالترتيب المحدد.

Parameters:

معامل	نوع	الوصف
angle	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 وتعيينها كمصدر للنسخة من BmpOptions
# المعامل البولياني الثاني يحدد ما إذا كان الملف الذي سيتم إنشاؤه 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()