فئة Matrix

Summary: Replaces the GDI+ Matrix.

Module: aspose.imaging

Full Name: aspose.imaging.Matrix

Constructors

Name	الوصف
Matrix()	ينشئ نسخة جديدة من فئة Matrix كمصفوفة هوية.
Matrix(m11, m12, m21, m22, m31, m32)	ينشئ نسخة جديدة من فئة Matrix.
Matrix(origin)	ينشئ نسخة من فئة Matrix.
Matrix(rect, plgpts)	ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.
Matrix(rect, plgpts)	ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.

Properties

Name	Type	Access	الوصف
TYPE_FLIP [static]	int	r	تشير هذه البتة flag إلى أن التحويل المحدد بهذا الكائن يقوم بقلب صورة مرآة حول محور ما مما يغيّر نظام الإحداثيات اليدوي الأيمن المعتاد إلى نظام يدوي أيسر بالإضافة إلى التحويلات المشار إليها ببتات flag الأخرى. نظام الإحداثيات اليدوي الأيمن هو ذلك الذي يدور فيه المحور X الموجب عكس اتجاه عقارب الساعة ليطابق المحور Y الموجب مشابهًا لاتجاه انحناء أصابع يدك اليمنى عندما تنظر مباشرة إلى إبهامك. نظام الإحداثيات اليدوي الأيسر هو ذلك الذي يدور فيه المحور X الموجب مع اتجاه عقارب الساعة ليطابق المحور Y الموجب مشابهًا لاتجاه انحناء أصابع يدك اليسرى. لا توجد طريقة رياضية لتحديد زاوية القلب أو الانعكاس الأصلي لأن جميع زوايا القلب متطابقة عند تطبيق دوران تعديل مناسب. ملاحظة: تم إضافة TypeFlip بعد أن كان GENERAL_TRANSFORM متاحًا للجمهور ولم يعد من الممكن إعادة ترقيم بتات flag بسهولة دون إدخال عدم توافق ثنائي في الشيفرة الخارجية.
TYPE_GENERAL_ROTATION [static]	int	r	تشير هذه البتة flag إلى أن التحويل المحدد بهذا الكائن يقوم بدوران بزاوية عشوائية بالإضافة إلى التحويلات المشار إليها ببتات flag الأخرى. يغيّر الدوران زوايا المتجهات بنفس المقدار بغض النظر عن الاتجاه الأصلي للمتجه ودون تغيير طول المتجه. هذه البتة flag لا يمكن استخدامها مع الـ
TYPE_GENERAL_SCALE [static]	int	r	يقوم المقياس العام بضرب طول المتجهات بمقادير مختلفة في اتجاهي x و y دون تغيير الزاوية بين المتجهات المتعامدة. هذه البتة flag لا يمكن استخدامها مع علم TypeUniformScale.
TYPE_GENERAL_TRANSFORM [static]	int	r	تشير هذه الثابتة إلى أن التحويل المحدد بهذا الكائن يقوم بتحويل تعسفي لإحداثيات الإدخال. إذا كان يمكن تصنيف هذا التحويل بأي من الثوابت المذكورة أعلاه، سيكون النوع إما الثابتة TypeIdentity أو مجموعة من بتات flag المناسبة لمختلف التحويلات الإحداثية التي يقوم بها هذا التحويل.
TYPE_IDENTITY [static]	int	r	تحويل الهوية هو التحويل الذي تكون فيه إحداثيات الخرج دائمًا هي نفسها إحداثيات الإدخال. إذا كان هذا التحويل أي شيء غير تحويل الهوية، سيكون النوع إما الثابتة GENERAL_TRANSFORM أو مجموعة من بتات flag المناسبة لمختلف التحويلات الإحداثية التي يقوم بها هذا التحويل.
TYPE_MASK_ROTATION [static]	int	r	هذه الثابتة هي قناع بت لأي من بتات flag الخاصة بالدوران.
TYPE_MASK_SCALE [static]	int	r	هذه الثابتة هي قناع بت لأي من بتات flag الخاصة بالمقياس.
TYPE_QUADRANT_ROTATION [static]	int	r	تشير هذه البتة flag إلى أن التحويل المحدد بهذا الكائن يقوم بدوران ربعي بضعف من 90 درجة بالإضافة إلى التحويلات المشار إليها ببتات flag الأخرى. يغيّر الدوران زوايا المتجهات بنفس المقدار بغض النظر عن الاتجاه الأصلي للمتجه ودون تغيير طول المتجه. هذه البتة flag لا يمكن استخدامها مع علم TypeGeneralRotation.
TYPE_TRANSLATION [static]	int	r	الترجمة تحرك الإحداثيات بمقدار ثابت في x و y دون تغيير طول المتجه أو زاويته.
TYPE_UNIFORM_SCALE [static]	int	r	المقياس المتجانس يضاعف طول المتجهات بنفس المقدار في كل من اتجاهي x و y دون تغيير الزاوية بين المتجهات. هذه البتة flag لا يمكن استخدامها مع علم TypeGeneralScale.
elements	float[]	r	يحصل على مصفوفة من القيم العائمة التي تمثل عناصر هذا Matrix.
m11	float	r	يحصل على عنصر المصفوفة في الصف الأول العمود الأول. يمثل المقياس على المحور X.
m12	float	r	يحصل على عنصر المصفوفة في الصف الأول العمود الثاني. يمثل القص على المحور Y.
m21	float	r	يحصل على عنصر المصفوفة في الصف الثاني العمود الأول. يمثل القص على المحور X.
m22	float	r	يحصل على عنصر المصفوفة في الصف الثاني العمود الثاني. يمثل التحجيم على المحور Y.
m31	float	r	يحصل على عنصر المصفوفة في الصف الثالث العمود الأول. يمثل الإزاحة على المحور X.
m32	float	r	يحصل على عنصر المصفوفة في الصف الثالث العمود الأول. يمثل الإزاحة على المحور Y.

Methods

Name	الوصف
create_with_rect(rect, plgpts)	ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.
create_with_rect_f(rect, plgpts)	ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.
get_elements()	يحصل على نسخة من عناصر المصفوفة.
multiply(t_tx)	يضرب هذه Matrix بالمصفوفة المحددة في معلمة matrix باستخدام ترتيب (Prepend) الافتراضي.
multiply(t_tx, order)	يضرب هذه Matrix بالمصفوفة المحددة في معلمة matrix، وبالترتيب المحدد في معلمة order.
reset()	يعيد تعيين هذه Matrix لتحتوي على عناصر مصفوفة الهوية.
rotate(angle)	يطبق دورانًا باتجاه عقارب الساعة بمقدار محدد في معلمة angle، حول الأصل (إحداثيات x و y الصفرية) لهذه Matrix بالترتيب الافتراضي (Prepend).
rotate(angle, order)	يطبق دورانًا باتجاه عقارب الساعة بمقدار محدد في معلمة angle، حول الأصل (إحداثيات x و y الصفرية) لهذه Matrix بالترتيب المحدد.
rotate_at(angle, point)	يطبق دورانًا باتجاه عقارب الساعة حول النقطة المحددة على هذه Matrix بالترتيب الافتراضي (Prepend).
rotate_at(angle, point, order)	يطبق دورانًا باتجاه عقارب الساعة حول النقطة المحددة على هذه Matrix بالترتيب المحدد.
scale(scale_x, scale_y, order)	يطبق متجه التحجيم المحدد (scaleX و scaleY) على هذه Matrix باستخدام الترتيب المحدد.
scale(sx, sy)	يطبق متجه التحجيم المحدد (scaleX و scaleY) على هذه Matrix باستخدام ترتيب (Prepend) الافتراضي.
transform_points(points)	يطبق التحويل الهندسي المُمَثَّل بهذه Matrix على مصفوفة محددة من النقاط.
translate(offset_x, offset_y, order)	يطبق متجه الإزاحة المحدد على هذه Matrix بالترتيب المحدد.
translate(tx, ty)	يطبق متجه الإزاحة المحدد على هذه Matrix باستخدام ترتيب (Prepend) الافتراضي.

Constructor: Matrix()

 Matrix() 

ينشئ نسخة جديدة من فئة Matrix كمصفوفة هوية.

Constructor: Matrix(m11, m12, m21, m22, m31, m32)

 Matrix(m11, m12, m21, m22, m31, m32) 

ينشئ نسخة جديدة من فئة Matrix.

Parameters:

معامل	نوع	الوصف
m11	float	m00 M11 تحجيم X
m12	float	m10 M12 قص Y
m21	float	m01 M21 قص X
m22	float	m11 M22 تحجيم Y
m31	float	m02 M31 إزاحة X
m32	float	m12 M32 ترجمة Y

Constructor: Matrix(origin)

 Matrix(origin) 

ينشئ نسخة من فئة Matrix.

Parameters:

معامل	نوع	الوصف
origin	Matrix	مصفوفة أساسية للمعالجة

Constructor: Matrix(rect, plgpts)

 Matrix(rect, plgpts) 

ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.

Parameters:

معامل	نوع	الوصف
rect	RectangleF	هيكل RectangleF يمثل المستطيل الذي سيتم تحويله.
plgpts	PointF[]	مصفوفة من ثلاثة هياكل PointF تمثل نقاط متوازي أضلاع يتم تحويل الزوايا العلوية اليسرى والعليا اليمنى والسفلية اليسرى للمستطيل إليه. الزاوية السفلية اليمنى لمتوازي الأضلاع مفترضة بناءً على الزوايا الثلاث الأولى.

Constructor: Matrix(rect, plgpts)

 Matrix(rect, plgpts) 

ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.

Parameters:

معامل	نوع	الوصف
rect	Rectangle	هيكل RectangleF يمثل المستطيل الذي سيتم تحويله.
plgpts	Point[]	مصفوفة من ثلاثة هياكل PointF تمثل نقاط متوازي أضلاع يتم تحويل الزوايا العلوية اليسرى والعليا اليمنى والسفلية اليسرى للمستطيل إليه. الزاوية السفلية اليمنى لمتوازي الأضلاع مفترضة بناءً على الزوايا الثلاث الأولى.

Method: create_with_rect(rect, plgpts) [static]

 create_with_rect(rect, plgpts) 

ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.

Parameters:

معامل	نوع	الوصف
rect	Rectangle	هيكل RectangleF يمثل المستطيل الذي سيتم تحويله.
plgpts	Point[]	مصفوفة من ثلاثة هياكل PointF تمثل نقاط متوازي أضلاع يتم تحويل الزوايا العلوية اليسرى والعليا اليمنى والسفلية اليسرى للمستطيل إليه. الزاوية السفلية اليمنى لمتوازي الأضلاع مفترضة بناءً على الزوايا الثلاث الأولى.

Returns

نوع	الوصف
Matrix

Method: create_with_rect_f(rect, plgpts) [static]

 create_with_rect_f(rect, plgpts) 

ينشئ نسخة جديدة من فئة Matrix للتحويل الهندسي المحدد بالمستطيل المحدد ومجموعة النقاط.

Parameters:

معامل	نوع	الوصف
rect	RectangleF	هيكل RectangleF يمثل المستطيل الذي سيتم تحويله.
plgpts	PointF[]	مصفوفة من ثلاثة هياكل PointF تمثل نقاط متوازي أضلاع يتم تحويل الزوايا العلوية اليسرى والعليا اليمنى والسفلية اليسرى للمستطيل إليه. الزاوية السفلية اليمنى لمتوازي الأضلاع مفترضة بناءً على الزوايا الثلاث الأولى.

Returns

نوع	الوصف
Matrix

Method: get_elements()

 get_elements() 

يحصل على نسخة من عناصر المصفوفة.

Returns

نوع	الوصف
float[]	نسخة عناصر المصفوفة.

Method: multiply(t_tx)

 multiply(t_tx) 

يضرب هذه Matrix بالمصفوفة المحددة في معلمة matrix باستخدام ترتيب (Prepend) الافتراضي.

Parameters:

معامل	نوع	الوصف
t_tx	Matrix	المصفوفة التي سيتم الضرب معها.

Method: multiply(t_tx, order)

 multiply(t_tx, order) 

يضرب هذه Matrix بالمصفوفة المحددة في معلمة matrix، وبالترتيب المحدد في معلمة order.

Parameters:

معامل	نوع	الوصف
t_tx	Matrix	القيمة tx. القيمة tx. القيمة tx.
order	MatrixOrder	الترتيب. الترتيب. الترتيب.

Method: rotate(angle)

 rotate(angle) 

يطبق دورانًا باتجاه عقارب الساعة بمقدار محدد في معلمة angle، حول الأصل (إحداثيات x و y الصفرية) لهذه Matrix بالترتيب الافتراضي (Prepend).

Parameters:

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

Method: rotate(angle, order)

 rotate(angle, order) 

يطبق دورانًا باتجاه عقارب الساعة بمقدار محدد في معلمة angle، حول الأصل (إحداثيات x و y الصفرية) لهذه Matrix بالترتيب المحدد.

Parameters:

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

Method: rotate_at(angle, point)

 rotate_at(angle, point) 

يطبق دورانًا باتجاه عقارب الساعة حول النقطة المحددة على هذه Matrix بالترتيب الافتراضي (Prepend).

Parameters:

معامل	نوع	الوصف
angle	float	الزاوية.
point	PointF	النقطة.

Method: rotate_at(angle, point, order)

 rotate_at(angle, point, order) 

يطبق دورانًا باتجاه عقارب الساعة حول النقطة المحددة على هذه Matrix بالترتيب المحدد.

Parameters:

معامل	نوع	الوصف
angle	float	الزاوية.
point	PointF	النقطة.
order	MatrixOrder	الترتيب.

Method: scale(scale_x, scale_y, order)

 scale(scale_x, scale_y, order) 

يطبق متجه التحجيم المحدد (scaleX و scaleY) على هذه Matrix باستخدام الترتيب المحدد.

Parameters:

معامل	نوع	الوصف
scale_x	float	المقياس X.
scale_y	float	المقياس Y.
order	MatrixOrder	الترتيب.

Method: scale(sx, sy)

 scale(sx, sy) 

يطبق متجه التحجيم المحدد (scaleX و scaleY) على هذه Matrix باستخدام ترتيب (Prepend) الافتراضي.

Parameters:

معامل	نوع	الوصف
sx	float	القيمة sx. القيمة sx. القيمة sx.
sy	float	القيمة sy. القيمة sy. القيمة sy.

Method: transform_points(points)

 transform_points(points) 

يطبق التحويل الهندسي المُمَثَّل بهذه Matrix على مصفوفة محددة من النقاط.

Parameters:

معامل	نوع	الوصف
points	PointF[]	النقاط.

Method: translate(offset_x, offset_y, order)

 translate(offset_x, offset_y, order) 

يطبق متجه الإزاحة المحدد على هذه Matrix بالترتيب المحدد.

Parameters:

معامل	نوع	الوصف
offset_x	float	الإزاحة X.
offset_y	float	الإزاحة Y.
order	MatrixOrder	الترتيب.

Method: translate(tx, ty)

 translate(tx, ty) 

يطبق متجه الإزاحة المحدد على هذه Matrix باستخدام ترتيب (Prepend) الافتراضي.

Parameters:

معامل	نوع	الوصف
tx	float	القيمة tx. القيمة tx. القيمة tx.
ty	float	القيمة ty. القيمة ty. القيمة ty.