Pen

Inheritance: java.lang.Object, com.aspose.imaging.TransparencySupporter

public class Pen extends TransparencySupporter

يحدد كائنًا يُستخدم لرسم الخطوط والمنحنيات والأشكال.

المنشئات

المنشئ	الوصف
Pen(Color color)	ينشئ نسخة جديدة من فئة Pen باللون المحدد.
Pen(Color color, float width)	ينشئ نسخة جديدة من فئة Pen بالخصائص المحددة Color و Pen.Width.
Pen(Brush brush)	ينشئ نسخة جديدة من فئة Pen بالـ Brush المحدد.
Pen(Brush brush, float width)	ينشئ نسخة جديدة من فئة Pen بالـ Brush و Pen.Width المحددين.

الطرق

طريقة	الوصف
getWidth()	يحصل على عرض هذا Pen بوحدات كائن Graphics المستخدم في الرسم.
setWidth(float value)	يضبط عرض هذا Pen بوحدات كائن Graphics المستخدم في الرسم.
getStartCap()	يحصل على نمط القمة المستخدم في بداية الخطوط المرسومة بهذا Pen.
setStartCap(int value)	يضبط نمط القمة المستخدم في بداية الخطوط المرسومة بهذا Pen.
getEndCap()	يحصل على نمط القمة المستخدم في نهاية الخطوط المرسومة بهذا Pen.
setEndCap(int value)	يضبط نمط القمة المستخدم في نهاية الخطوط المرسومة بهذا Pen.
getDashCap()	يحصل على نمط القمة المستخدم في نهاية الشرطات التي تشكل الخطوط المتقطعة المرسومة بهذا Pen.
setDashCap(int value)	يضبط نمط الغطاء المستخدم في نهاية الشرطات التي تشكل الخطوط المتقطعة المرسومة بهذا Pen.
getLineJoin()	يحصل على نمط الوصل لنهايات خطين متتاليين مرسومين بهذا Pen.
setLineJoin(int value)	يضبط نمط الوصل لنهايات خطين متتاليين مرسومين بهذا Pen.
getCustomStartCap()	يحصل على غطاء مخصص لاستخدامه في بداية الخطوط المرسومة بهذا Pen.
setCustomStartCap(CustomLineCap value)	يضبط غطاءً مخصصًا لاستخدامه في بداية الخطوط المرسومة بهذا Pen.
getCustomEndCap()	يحصل على غطاء مخصص لاستخدامه في نهاية الخطوط المرسومة بهذا Pen.
setCustomEndCap(CustomLineCap value)	يضبط غطاءً مخصصًا لاستخدامه في نهاية الخطوط المرسومة بهذا Pen.
getMiterLimit()	يحصل على حد سمك الوصل عند زاوية ميتريّة.
setMiterLimit(float value)	يضبط حد سمك الوصل عند زاوية ميتريّة.
getAlignment()	يحصل على المحاذاة لهذا Pen.
setAlignment(int value)	يضبط المحاذاة لهذا Pen.
getTransform()	يحصل على نسخة من التحويل الهندسي لهذا Pen.
setTransform(Matrix value)	يضبط نسخة من التحويل الهندسي لهذا Pen.
getPenType()	يحصل على نمط الخطوط المرسومة بهذا Pen.
getColor()	يحصل على لون هذا Pen.
setColor(Color value)	يضبط لون هذا Pen.
getBrush()	يحصل على الـ Brush الذي يحدد خصائص هذا Pen.
setBrush(Brush value)	يضبط الـ Brush الذي يحدد خصائص هذا Pen.
getDashStyle()	يحصل على النمط المستخدم للخطوط المتقطعة المرسومة بهذا Pen.
setDashStyle(int value)	يضبط النمط المستخدم للخطوط المتقطعة المرسومة بهذا Pen.
getDashOffset()	يحصل على المسافة من بداية الخط إلى بداية نمط الشرطات.
setDashOffset(float value)	يضبط المسافة من بداية الخط إلى بداية نمط الشرطات.
getDashPattern()	يحصل على مصفوفة من الشرطات والمسافات المخصصة.
setDashPattern(float[] value)	يضبط مصفوفة من الشرطات والمسافات المخصصة.
getCompoundArray()	يحصل على مصفوفة من القيم التي تحدد قلمًا مركبًا.
setCompoundArray(float[] value)	يضبط مصفوفة من القيم التي تحدد قلمًا مركبًا.
setLineCap(int startCap, int endCap, int dashCap)	يضبط القيم التي تحدد نمط الغطاء المستخدم لإنهاء الخطوط المرسومة بواسطة هذا Pen.
resetTransform()	يعيد تعيين مصفوفة التحويل الهندسي لهذا Pen إلى الهوية.
multiplyTransform(Matrix matrix)	يضرب مصفوفة التحويل لهذا Pen بالمصفوفة المحددة Matrix.
multiplyTransform(Matrix matrix, int order)	يضرب مصفوفة التحويل لهذا Pen بالمصفوفة المحددة Matrix بالترتيب المحدد.
translateTransform(float dx, float dy)	ينقل التحويل الهندسي المحلي بالأبعاد المحددة.
translateTransform(float dx, float dy, int order)	ينقل التحويل الهندسي المحلي بالأبعاد المحددة بالترتيب المحدد.
scaleTransform(float sx, float sy)	يقوم بتكبير التحويل الهندسي المحلي بالعوامل المحددة.
scaleTransform(float sx, float sy, int order)	يقوم بتكبير التحويل الهندسي المحلي بالعوامل المحددة بالترتيب المحدد.
rotateTransform(float angle)	يدور التحويل الهندسي المحلي بالزاوية المحددة.
rotateTransform(float angle, int order)	يدور التحويل الهندسي المحلي بالزاوية المحددة بالترتيب المحدد.
equals(Object o)	تحقق مما إذا كانت الكائنات متساوية.
hashCode()

Example: This example shows the creation and usage Pen objects.

يوضح هذا المثال إنشاء واستخدام كائنات Pen. ينشئ المثال صورة جديدة ويرسم مستطيلات على سطح الصورة.

// أنشئ مثيلاً من BmpOptions واضبط خصائصه المتنوعة.
com.aspose.imaging.imageoptions.BmpOptions bmpOptions = new com.aspose.imaging.imageoptions.BmpOptions();
bmpOptions.setBitsPerPixel(24);

// أنشئ مثيلاً من FileCreateSource وعيّنه كخاصية Source لمثيل BmpOptions.
// المعامل البولياني الثاني يحدد ما إذا كان الملف الذي سيتم إنشاؤه مؤقتًا أم لا.
bmpOptions.setSource(new com.aspose.imaging.sources.FileCreateSource("C:\\temp\\sample.bmp", false));

// إنشاء نسخة من Image في المسار المحدد
com.aspose.imaging.Image image = com.aspose.imaging.Image.create(bmpOptions, 500, 500);
try {
    // إنشاء نسخة من Graphics وتهيئتها بكائن Image
    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(image);

    // امسح سطح Graphics باللون الأبيض
    graphics.clear(com.aspose.imaging.Color.getWhite());

    // إنشاء نسخة من Pen باللون الأحمر وعرض 5
    com.aspose.imaging.Pen pen = new com.aspose.imaging.Pen(com.aspose.imaging.Color.getRed(), 5);

    // إنشاء نسخة من HatchBrush وتعيين خصائصه
    com.aspose.imaging.brushes.HatchBrush brush = new com.aspose.imaging.brushes.HatchBrush();
    brush.setBackgroundColor(com.aspose.imaging.Color.getWheat());
    brush.setForegroundColor(com.aspose.imaging.Color.getRed());

    // إنشاء نسخة من Pen وتهيئتها بكائن HatchBrush والعرض
    com.aspose.imaging.Pen brushedpen = new com.aspose.imaging.Pen(brush, 5);

    // ارسم مستطيلات بتحديد كائن Pen
    graphics.drawRectangles(pen, new com.aspose.imaging.Rectangle[]
            {
                    new com.aspose.imaging.Rectangle(new com.aspose.imaging.Point(210, 210), new com.aspose.imaging.Size(100, 100)),
                    new com.aspose.imaging.Rectangle(new com.aspose.imaging.Point(110, 110), new com.aspose.imaging.Size(100, 100)),
                    new com.aspose.imaging.Rectangle(new com.aspose.imaging.Point(310, 310), new com.aspose.imaging.Size(100, 100))
            });

    // ارسم مستطيلات بتحديد كائن Pen
    graphics.drawRectangles(
            brushedpen,
            new com.aspose.imaging.Rectangle[]
                    {
                            new com.aspose.imaging.Rectangle(new com.aspose.imaging.Point(310, 110), new com.aspose.imaging.Size(100, 100)),
                            new com.aspose.imaging.Rectangle(new com.aspose.imaging.Point(110, 310), new com.aspose.imaging.Size(100, 100))
                    });

    // حفظ جميع التغييرات.
    image.save();
} finally {
    image.dispose();
}

Pen(Color color)

public Pen(Color color)

ينشئ نسخة جديدة من فئة Pen باللون المحدد.

Parameters:

معامل	نوع	الوصف
color	Color	Color بنية تشير إلى لون هذا Pen.

Pen(Color color, float width)

public Pen(Color color, float width)

ينشئ نسخة جديدة من فئة Pen بالخصائص المحددة Color و Pen.Width.

Parameters:

معامل	نوع	الوصف
color	Color	Color بنية تشير إلى لون هذا Pen.
width	float	قيمة تشير إلى عرض هذا Pen.

Pen(Brush brush)

public Pen(Brush brush)

ينشئ نسخة جديدة من فئة Pen بالـ Brush المحدد.

Parameters:

معامل	نوع	الوصف
brush	Brush	Brush يحدد خصائص التعبئة لهذا Pen.

Pen(Brush brush, float width)

public Pen(Brush brush, float width)

ينشئ نسخة جديدة من فئة Pen بالـ Brush و Pen.Width المحددين.

Parameters:

معامل	نوع	الوصف
brush	Brush	Brush يحدد خصائص هذا Pen.
width	float	عرض الـ Pen الجديد.

getWidth()

public float getWidth()

يحصل على عرض هذا Pen بوحدات كائن Graphics المستخدم في الرسم.

Returns: float - عرض هذا Pen.

setWidth(float value)

public void setWidth(float value)

يضبط عرض هذا Pen بوحدات كائن Graphics المستخدم في الرسم.

Parameters:

معامل	نوع	الوصف
value	float	عرض هذا Pen.

getStartCap()

public int getStartCap()

يحصل على نمط القمة المستخدم في بداية الخطوط المرسومة بهذا Pen.

Returns: int - إحدى قيم LineCap التي تمثل نمط الغطاء المستخدم في بداية الخطوط المرسومة بهذا Pen.

setStartCap(int value)

public void setStartCap(int value)

يضبط نمط القمة المستخدم في بداية الخطوط المرسومة بهذا Pen.

Parameters:

معامل	نوع	الوصف
value	int	إحدى قيم LineCap التي تمثل نمط الغطاء المستخدم في بداية الخطوط المرسومة بهذا Pen.

getEndCap()

public int getEndCap()

يحصل على نمط القمة المستخدم في نهاية الخطوط المرسومة بهذا Pen.

Returns: int - إحدى قيم LineCap التي تمثل نمط الغطاء المستخدم في نهاية الخطوط المرسومة بهذا Pen.

setEndCap(int value)

public void setEndCap(int value)

يضبط نمط القمة المستخدم في نهاية الخطوط المرسومة بهذا Pen.

Parameters:

معامل	نوع	الوصف
value	int	إحدى قيم LineCap التي تمثل نمط الغطاء المستخدم في نهاية الخطوط المرسومة بهذا Pen.

getDashCap()

public int getDashCap()

يحصل على نمط القمة المستخدم في نهاية الشرطات التي تشكل الخطوط المتقطعة المرسومة بهذا Pen.

Returns: int - إحدى قيم DashCap التي تمثل نمط الغطاء المستخدم في بداية ونهاية الشرطات التي تشكل الخطوط المتقطعة المرسومة بهذا Pen.

setDashCap(int value)

public void setDashCap(int value)

يضبط نمط الغطاء المستخدم في نهاية الشرطات التي تشكل الخطوط المتقطعة المرسومة بهذا Pen.

Parameters:

معامل	نوع	الوصف
value	int	إحدى قيم DashCap التي تمثل نمط الغطاء المستخدم في بداية ونهاية الشرطات التي تشكل الخطوط المتقطعة المرسومة بهذا Pen.

getLineJoin()

public int getLineJoin()

يحصل على نمط الوصل لنهايات خطين متتاليين مرسومين بهذا Pen.

Returns: int - LineJoin الذي يمثل نمط الوصل لنهايات خطين متتاليين مرسومين بهذا Pen.

setLineJoin(int value)

public void setLineJoin(int value)

يضبط نمط الوصل لنهايات خطين متتاليين مرسومين بهذا Pen.

Parameters:

معامل	نوع	الوصف
value	int	LineJoin الذي يمثل نمط الوصل لنهايات خطين متتاليين مرسومين بهذا Pen.

getCustomStartCap()

public CustomLineCap getCustomStartCap()

يحصل على غطاء مخصص لاستخدامه في بداية الخطوط المرسومة بهذا Pen.

Returns: CustomLineCap - A CustomLineCap that represents the cap used at the beginning of lines drawn with this Pen.

setCustomStartCap(CustomLineCap value)

public void setCustomStartCap(CustomLineCap value)

يضبط غطاءً مخصصًا لاستخدامه في بداية الخطوط المرسومة بهذا Pen.

Parameters:

معامل	نوع	الوصف
value	CustomLineCap	CustomLineCap الذي يمثل الغطاء المستخدم في بداية الخطوط المرسومة بهذا Pen.

getCustomEndCap()

public CustomLineCap getCustomEndCap()

يحصل على غطاء مخصص لاستخدامه في نهاية الخطوط المرسومة بهذا Pen.

Returns: CustomLineCap - A CustomLineCap that represents the cap used at the end of lines drawn with this Pen.

setCustomEndCap(CustomLineCap value)

public void setCustomEndCap(CustomLineCap value)

يضبط غطاءً مخصصًا لاستخدامه في نهاية الخطوط المرسومة بهذا Pen.

Parameters:

معامل	نوع	الوصف
value	CustomLineCap	CustomLineCap الذي يمثل الغطاء المستخدم في نهاية الخطوط المرسومة بهذا Pen.

getMiterLimit()

public float getMiterLimit()

يحصل على حد سمك الوصل عند زاوية ميتريّة.

Returns: float - الحد الأقصى لسماكة الوصل عند زاوية ميتير.

setMiterLimit(float value)

public void setMiterLimit(float value)

يضبط حد سمك الوصل عند زاوية ميتريّة.

Parameters:

معامل	نوع	الوصف
value	float	الحد الأقصى لسماكة الوصل عند زاوية ميتير.

getAlignment()

public int getAlignment()

يحصل على المحاذاة لهذا Pen.

Returns: int - PenAlignment الذي يمثل المحاذاة لهذا Pen.

setAlignment(int value)

public void setAlignment(int value)

يضبط المحاذاة لهذا Pen.

Parameters:

معامل	نوع	الوصف
value	int	PenAlignment الذي يمثل المحاذاة لهذا Pen.

getTransform()

public Matrix getTransform()

يحصل على نسخة من التحويل الهندسي لهذا Pen.

Returns: Matrix - A copy of the Matrix that represents the geometric transformation for this Pen.

setTransform(Matrix value)

public void setTransform(Matrix value)

يضبط نسخة من التحويل الهندسي لهذا Pen.

Parameters:

معامل	نوع	الوصف
value	Matrix	نسخة من Matrix التي تمثل التحويل الهندسي لهذا Pen.

getPenType()

public int getPenType()

يحصل على نمط الخطوط المرسومة بهذا Pen.

Returns: int - تعداد PenType الذي يحدد نمط الخطوط المرسومة بهذا Pen.

getColor()

public Color getColor()

يحصل على لون هذا Pen.

Returns: Color - A Color structure that represents the color of this Pen.

setColor(Color value)

public void setColor(Color value)

يضبط لون هذا Pen.

Parameters:

معامل	نوع	الوصف
value	Color	هيكل Color الذي يمثل لون هذا Pen.

getBrush()

public Brush getBrush()

يحصل على الـ Brush الذي يحدد خصائص هذا Pen.

Returns: Brush - A Brush that determines attributes of this Pen.

setBrush(Brush value)

public void setBrush(Brush value)

يضبط الـ Brush الذي يحدد خصائص هذا Pen.

Parameters:

معامل	نوع	الوصف
value	Brush	Brush الذي يحدد خصائص هذا Pen.

getDashStyle()

public int getDashStyle()

يحصل على النمط المستخدم للخطوط المتقطعة المرسومة بهذا Pen.

Returns: int - DashStyle الذي يمثل النمط المستخدم للخطوط المتقطعة المرسومة بهذا Pen.

setDashStyle(int value)

public void setDashStyle(int value)

يضبط النمط المستخدم للخطوط المتقطعة المرسومة بهذا Pen.

Parameters:

معامل	نوع	الوصف
value	int	DashStyle الذي يمثل النمط المستخدم للخطوط المتقطعة المرسومة بهذا Pen.

getDashOffset()

public float getDashOffset()

يحصل على المسافة من بداية الخط إلى بداية نمط الشرطات.

Returns: float - المسافة من بداية الخط إلى بداية نمط الشرطة.

setDashOffset(float value)

public void setDashOffset(float value)

يضبط المسافة من بداية الخط إلى بداية نمط الشرطات.

Parameters:

معامل	نوع	الوصف
value	float	المسافة من بداية الخط إلى بداية نمط الشرطة.

getDashPattern()

public float[] getDashPattern()

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

Returns: float[] - مصفوفة من الأعداد الحقيقية التي تحدد أطوال الشرطات والمسافات المتناوبة في الخطوط المتقطعة.

setDashPattern(float[] value)

public void setDashPattern(float[] value)

يضبط مصفوفة من الشرطات والمسافات المخصصة.

Parameters:

معامل	نوع	الوصف
value	float[]	مصفوفة من الأعداد الحقيقية التي تحدد أطوال الشرطات والمسافات المتناوبة في الخطوط المتقطعة.

getCompoundArray()

public float[] getCompoundArray()

يحصل على مصفوفة من القيم التي تحدد قلم مركب. القلم المركب يرسم خطًا مركبًا مكوّنًا من خطوط متوازية وفراغات.

Returns: float[] - مصفوفة من الأعداد الحقيقية التي تحدد مصفوفة المركب. يجب أن تكون عناصر المصفوفة بترتيب تصاعدي، لا تقل عن 0، ولا تزيد عن 1.

setCompoundArray(float[] value)

public void setCompoundArray(float[] value)

يضبط مصفوفة من القيم التي تحدد قلمًا مركبًا. القلم المركب يرسم خطًا مركبًا مكوّنًا من خطوط متوازية وفراغات.

Parameters:

معامل	نوع	الوصف
value	float[]	مصفوفة من الأعداد الحقيقية التي تحدد مصفوفة المركب. يجب أن تكون عناصر المصفوفة بترتيب تصاعدي، لا تقل عن 0، ولا تزيد عن 1.

setLineCap(int startCap, int endCap, int dashCap)

public void setLineCap(int startCap, int endCap, int dashCap)

يضبط القيم التي تحدد نمط الغطاء المستخدم لإنهاء الخطوط المرسومة بواسطة هذا Pen.

Parameters:

معامل	نوع	الوصف
startCap	int	LineCap التي تمثل نمط القمة لاستخدامه في بداية الخطوط المرسومة بهذا Pen.
endCap	int	LineCap التي تمثل نمط القمة لاستخدامه في نهاية الخطوط المرسومة بهذا Pen.
dashCap	int	LineCap التي تمثل نمط القمة لاستخدامه في بداية أو نهاية الخطوط المتقطعة المرسومة بهذا Pen.

resetTransform()

public void resetTransform()

يعيد تعيين مصفوفة التحويل الهندسي لهذا Pen إلى الهوية.

multiplyTransform(Matrix matrix)

public void multiplyTransform(Matrix matrix)

يضرب مصفوفة التحويل لهذا Pen بالمصفوفة المحددة Matrix.

Parameters:

معامل	نوع	الوصف
matrix	Matrix	كائن Matrix الذي يُستخدم لضرب مصفوفة التحويل.

multiplyTransform(Matrix matrix, int order)

public void multiplyTransform(Matrix matrix, int order)

يضرب مصفوفة التحويل لهذا Pen بالمصفوفة المحددة Matrix بالترتيب المحدد.

Parameters:

معامل	نوع	الوصف
matrix	Matrix	Matrix الذي يُستخدم لضرب مصفوفة التحويل.
الترتيب	int	الترتيب الذي يتم فيه تنفيذ عملية الضرب.

translateTransform(float dx, float dy)

public void translateTransform(float dx, float dy)

يُترجم التحويل الهندسي المحلي بالأبعاد المحددة. تُضيف هذه الطريقة الإزاحة إلى التحويل في البداية.

Parameters:

معامل	نوع	الوصف
dx	float	قيمة الإزاحة في الاتجاه x.
dy	float	قيمة الإزاحة في الاتجاه y.

translateTransform(float dx, float dy, int order)

public void translateTransform(float dx, float dy, int order)

ينقل التحويل الهندسي المحلي بالأبعاد المحددة بالترتيب المحدد.

Parameters:

معامل	نوع	الوصف
dx	float	قيمة الإزاحة في الاتجاه x.
dy	float	قيمة الإزاحة في الاتجاه y.
الترتيب	int	الترتيب (إضافة في البداية أو في النهاية) الذي يُطبق فيه الإزاحة.

scaleTransform(float sx, float sy)

public void scaleTransform(float sx, float sy)

يقوم بتكبير التحويل الهندسي المحلي بالعوامل المحددة. تُضيف هذه الطريقة مصفوفة التكبير إلى التحويل في البداية.

Parameters:

معامل	نوع	الوصف
sx	float	العامل الذي يُستخدم لتكبير التحويل في اتجاه المحور x.
sy	float	العامل الذي يُستخدم لتكبير التحويل في اتجاه المحور y.

scaleTransform(float sx, float sy, int order)

public void scaleTransform(float sx, float sy, int order)

يقوم بتكبير التحويل الهندسي المحلي بالعوامل المحددة بالترتيب المحدد.

Parameters:

معامل	نوع	الوصف
sx	float	العامل الذي يُستخدم لتكبير التحويل في اتجاه المحور x.
sy	float	العامل الذي يُستخدم لتكبير التحويل في اتجاه المحور y.
الترتيب	int	MatrixOrder التي تحدد ما إذا كان سيتم إضافة مصفوفة التكبير في النهاية أو في البداية.

rotateTransform(float angle)

public void rotateTransform(float angle)

يدور التحويل الهندسي المحلي بالزاوية المحددة. تُضيف هذه الطريقة الدوران إلى التحويل في البداية.

Parameters:

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

rotateTransform(float angle, int order)

public void rotateTransform(float angle, int order)

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

Parameters:

معامل	نوع	الوصف
angle	float	زاوية الدوران.
الترتيب	int	MatrixOrder التي تحدد ما إذا كان سيتم إضافة مصفوفة الدوران في النهاية أو في البداية.

equals(Object o)

public boolean equals(Object o)

تحقق مما إذا كانت الكائنات متساوية.

Parameters:

معامل	نوع	الوصف
o	java.lang.Object	الكائن الآخر.

Returns: boolean - نتيجة مقارنة المساواة.

hashCode()

public int hashCode()

احصل على رمز التجزئة للكائن الحالي.

Returns: int