قلم

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. ينشئ المثال صورة جديدة Image ويرسم مستطيلات على سطح الصورة.

// إنشاء مثيل من 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 باستخدام White Color.
    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.
العرض	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.
العرض	float	عرض الـ Pen الجديد.

getWidth()

public float getWidth()

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

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

setWidth(float value)

public void setWidth(float value)

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

Parameters:

معامل	نوع	الوصف
القيمة	float	عرض هذا Pen.

getStartCap()

public int getStartCap()

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

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

setStartCap(int value)

public void setStartCap(int value)

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

Parameters:

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

getEndCap()

public int getEndCap()

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

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

setEndCap(int value)

public void setEndCap(int value)

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

Parameters:

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

getDashCap()

public int getDashCap()

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

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

setDashCap(int value)

public void setDashCap(int value)

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

Parameters:

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

getLineJoin()

public int getLineJoin()

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

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

setLineJoin(int value)

public void setLineJoin(int value)

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

Parameters:

معامل	نوع	الوصف
القيمة	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:

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

getAlignment()

public int getAlignment()

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

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

setAlignment(int value)

public void setAlignment(int value)

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

Parameters:

معامل	نوع	الوصف
القيمة	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:

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

getDashOffset()

public float getDashOffset()

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

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

setDashOffset(float value)

public void setDashOffset(float value)

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

Parameters:

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

getDashPattern()

public float[] getDashPattern()

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

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

setDashPattern(float[] value)

public void setDashPattern(float[] value)

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

Parameters:

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

getCompoundArray()

public float[] getCompoundArray()

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

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

setCompoundArray(float[] value)

public void setCompoundArray(float[] value)

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

Parameters:

معامل	نوع	الوصف
القيمة	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 الذي يُستخدم لضرب مصفوفة التحويل.
order	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.
order	int	الترتيب (prepend أو append) الذي تُطبق فيه الترجمة.

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.
order	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	زاوية الدوران.
order	int	MatrixOrder الذي يحدد ما إذا كان سيتم إلحاق أو إضافة مصفوفة الدوران.

equals(Object o)

public boolean equals(Object o)

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

Parameters:

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

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

hashCode()

public int hashCode()

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

Returns: int