شاشة#

مقدمة #

تتحكم طرق الشاشة في كيفية عرض الدماغ التجريبي للنصوص والأرقام والرسومات على شاشته.

بشكل افتراضي، يكون الخط المستخدم للطباعة على جهاز Brain هو خط صغير أحادي المسافة والذي يحتوي على 7 صفوف و 20 عمودًا.

أما بالنسبة للرسم، فإن دقة الدماغ تبلغ 159 × 107 بكسل.

مخطط شبكي مُعَلَّم لشاشة VEX Brain يُظهر الصفوف والأعمدة وأبعاد البكسل والإحداثيات، مع خطوط حمراء تُحدد الشبكة.

فيما يلي قائمة بالطرق المتاحة:

طباعة المؤشر – عرض النص وإدارة مؤشر الطباعة.

print – يطبع النص أو الأرقام أو قيم المتغيرات في موضع المؤشر الحالي.
print_at – يطبع النص أو الأرقام أو قيم المتغيرات عند إحداثيات x و y محددة.
set_cursor – ينقل المؤشر إلى صف وعمود محددين.
set_origin – يحدد الأصل المستخدم للطباعة والرسم القائم على الإحداثيات.
next_row – ينقل المؤشر إلى الصف التالي.
clear_row – يمسح صفًا من النص.
row – تُرجع الصف الذي سيتم فيه طباعة النص.
column – تُرجع العمود الذي سيتم طباعة النص فيه.
get_string_width – تُرجع عرض السلسلة بالبكسل باستخدام الخط الحالي.
get_string_height – تُرجع ارتفاع السلسلة بالبكسل باستخدام الخط الحالي.

المُعدِّلات – تغيير إعدادات الشاشة والألوان وسلوك الرسم.

clear_screen – يمسح جميع الرسومات والنصوص من شاشة الدماغ.
set_font – يحدد نوع الخط المستخدم لطباعة النص على شاشة الدماغ.
set_pen_width – يحدد سمك الخطوط المرسومة ومخططات الأشكال.
set_pen_color – يحدد لون النص والبكسلات والخطوط ومخططات الأشكال.
set_fill_color – يحدد لون التعبئة للأشكال المرسومة وخلفيات النصوص المطبوعة.

الرسم – إنشاء أشكال وخطوط ورسومات على شاشة الدماغ.

draw_pixel – يرسم بكسل واحد عند إحداثية معينة.
draw_line – يرسم خطًا بين نقطتين.
draw_rectangle – يرسم مستطيلاً باستخدام القلم الحالي وألوان التعبئة.
draw_circle – يرسم دائرة باستخدام القلم الحالي وألوان التعبئة.
draw_image_from_file – يرسم صورة من بطاقة SD.
render – يقوم بتبديل الرسم إلى التخزين المؤقت المزدوج ويعرض شاشة الدماغ.
set_clip_region – يحدد منطقة القص لرسم المستطيل المقدم.

بصمة المؤشر #

print #

print يطبع نصًا أو أرقامًا أو قيمًا متغيرة على شاشة الدماغ في موضع المؤشر الحالي وبنفس نوع الخط.

طريقة الاستخدام:

brain.screen.print(text, sep, precision)

حدود	وصف
`text`	النص أو الرقم أو قيمة المتغير المراد طباعتها.
`sep`	اختياري. سلسلة نصية لإدراجها بين القيم. يجب كتابتها كمعامل كلمة مفتاحية (sep=). القيمة الافتراضية هي `“”`.
`precision`	اختياري. عدد المنازل العشرية المراد عرضها عند طباعة الأرقام البسيطة. يجب كتابة هذا كمعامل كلمة مفتاحية (`precision=`). القيمة الافتراضية هي 2.

brain.screen.print("Hello, Robot!")

لقطة شاشة لدماغ EXP تُظهر عبارة "مرحباً أيها الروبوت" مطبوعة على الشاشة.

# Print the number 1 on the Brain's screen at current
# cursor position.
brain.screen.print(1)

# Print the numbers 1, 2, 3 and 4 on the Brain's screen at
# current cursor position separated by a '-'.
brain.screen.print(1, 2, 3, 4, sep='-')

print_at #

print_at يطبع نصًا أو أرقامًا أو قيمًا متغيرة على شاشة Brain عند إحداثيات x و y محددة.

طريقة الاستخدام:

brain.screen.print_at(text, x, y, sep, precision, opaque)

حدود	وصف
`text`	النص أو الرقم أو قيمة المتغير المراد طباعتها.
`x`	إحداثيات x المراد طباعتها كمعامل رئيسي (`x=`)، المشار إليها بأصل الشاشة.
`y`	إحداثيات y المراد طباعتها كمعامل رئيسي (`y=`)، المشار إليها بأصل الشاشة.
`sep`	اختياري. سلسلة نصية لإدراجها بين القيم. يجب كتابتها كمعامل كلمة مفتاحية (sep=). القيمة الافتراضية هي `” “`.
`precision`	اختياري. عدد المنازل العشرية المراد عرضها عند طباعة الأرقام البسيطة. يجب كتابة هذا كمعامل كلمة مفتاحية (`precision=`). القيمة الافتراضية هي 2.
`opaque`	Optional. `opaque=True` — The background of the text will be filled with the current fill color or black by default. `opaque=False` (default) — The background of the text will match the screen’s background color.

# Print the number 1 on the Brain's screen at position (100, 40).
brain.screen.print_at(1, x=100, y=40)

set_cursor moves the cursor to a specific row and column on the Brain screen. The next print call will start printing at that location. The row and column spacing will take into account the selected font. The default cursor position is Row 1, Column 1.

طريقة الاستخدام:

brain.screen.set_cursor(row, column)

حدود	وصف
`row`	الصف الذي سيتم تحريك المؤشر إليه.
`column`	العمود الذي سيتم تحريك المؤشر إليه.

# Display text starting at Row 3 Column 10.
brain.screen.set_cursor(3, 10)
brain.screen.print("R3, C10")

لقطة شاشة لدماغ EXP تُظهر عبارة "R3, C10" مطبوعة على الشاشة.

set_origin #

يُحدد الخيار set_origin نقطة الأصل المستخدمة للرسم والطباعة القائمة على الإحداثيات على شاشة Brain. افتراضيًا، تكون نقطة الأصل هي الزاوية العلوية اليسرى للشاشة.

طريقة الاستخدام:

brain.screen.set_origin(x, y)

حدود	وصف
`x`	موضع نقطة الأصل على المحور السيني بالنسبة للزاوية العلوية اليسرى، من 0 إلى 159.
`y`	موضع الأصل على المحور الصادي بالنسبة للزاوية العلوية اليسرى، من 0 إلى 107.

next_row #

next_row ينقل المؤشر إلى العمود 1 في الصف التالي على شاشة Brain.

طريقة الاستخدام:

brain.screen.next_row()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# Display two lines of text.
brain.screen.print("Line 1")
brain.screen.next_row()
brain.screen.print("Line 2")

لقطة شاشة من برنامج EXP Brain تُظهر النص "3" في الصف 3.

clear_row #

clear_row يمسح صفًا واحدًا من النص على شاشة الدماغ.

طريقة الاستخدام:

brain.screen.clear_row(row)

حدود	وصف
`row`	اختياري. الصف المراد مسحه. القيمة الافتراضية هي صف المؤشر الحالي.
`color`	Optional. A valid ColorType, a hex value, or a web string. `Color.BLACK` `Color.BLUE` `Color.GREEN` `Color.ORANGE` `Color.PURPLE` `Color.RED` `Color.VIOLET` `Color.WHITE` `Color.YELLOW` You can also specify a custom color.

حدود

وصف

row

اختياري. الصف المراد مسحه. القيمة الافتراضية هي صف المؤشر الحالي.

color

Optional. A valid ColorType, a hex value, or a web string.

Color.BLACK
Color.BLUE
Color.GREEN
Color.ORANGE
Color.PURPLE
Color.RED
Color.VIOLET
Color.WHITE
Color.YELLOW

You can also specify a custom color.

# Clear Brain's screen to black.
brain.screen.clear_row()

# Clear Brain's screen to blue using predefined color.
brain.screen.clear_row(2, Color.BLUE)

row #

row تُرجع الصف الذي سيتم فيه طباعة النص كعدد صحيح.

طريقة الاستخدام:

brain.screen.row()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# Display the cursor's current row.
brain.screen.set_cursor(3, 10)
brain.screen.print(brain.screen.row())

لقطة شاشة من برنامج EXP Brain تُظهر النص "3" في الصف 3.

column #

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

طريقة الاستخدام:

brain.screen.column()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# Display the cursor's current column.
brain.screen.set_cursor(3, 10)
brain.screen.print(brain.screen.column())

لقطة شاشة من برنامج EXP Brain تُظهر النص "10" في العمود 10.

get_string_width #

get_string_width تُرجع عرض السلسلة بالبكسل كعدد صحيح، باستخدام font.

طريقة الاستخدام:

brain.screen.get_string_width(string)

حدود	وصف
`string`	الخيط المراد قياسه.

get_string_height #

get_string_height تُرجع ارتفاع السلسلة بالبكسل كعدد صحيح، باستخدام font.

طريقة الاستخدام:

brain.screen.get_string_height(string)

حدود	وصف
`string`	الخيط المراد قياسه.

المتحولون #

clear_screen #

clear_screen يمسح جميع الرسومات والنصوص من شاشة الدماغ.

طريقة الاستخدام:

brain.screen.clear_screen(color)

حدود	وصف
`color`	Optional. A valid ColorType, a hex value, or a web string. `Color.BLACK` `Color.BLUE` `Color.GREEN` `Color.ORANGE` `Color.PURPLE` `Color.RED` `Color.VIOLET` `Color.WHITE` `Color.YELLOW` You can also specify a custom color.

حدود

وصف

color

Optional. A valid ColorType, a hex value, or a web string.

Color.BLACK
Color.BLUE
Color.GREEN
Color.ORANGE
Color.PURPLE
Color.RED
Color.VIOLET
Color.WHITE
Color.YELLOW

You can also specify a custom color.

# Print VEXcode on the Brain's screen.
brain.screen.print("VEXcode")

# Clear screen to black.
brain.screen.clear_screen()

# Print VEXcode on the Brain's screen.
brain.screen.print("VEXcode")

# Clear screen to blue using predefined color.
brain.screen.clear_screen(Color.BLUE)

set_font #

يُحدد set_font الخط المستخدم لعرض النصوص على شاشة الدماغ. سيتم تطبيق هذا الخط على جميع النصوص المطبوعة بعد تشغيل هذه الطريقة.

طريقة الاستخدام:

brain.screen.set_font(fontname)

حدود	وصف
`fontname`	The font size (examples below): `MONO12` `MONO15` `MONO20` `MONO30` `MONO40` `MONO60` `PROP20` `PROP30` `PROP40` `PROP60` Note: Extra small and small sizes are not available for proportional fonts.

حدود

وصف

fontname

The font size (examples below):

MONO12
MONO15
MONO20
MONO30
MONO40
MONO60
PROP20
PROP30
PROP40
PROP60

Note: Extra small and small sizes are not available for proportional fonts.

`MONO12`	`MONO15`	`MONO20`
`MONO30`	`MONO40`	`MONO60`
`PROP20`	`PROP30`	`PROP40`
`PROP60`

# Set the font type to MONO40.
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")

لقطة شاشة لدماغ EXP تُظهر النص "VEX" بخط أكبر من الخط الافتراضي.

set_pen_width #

set_pen_width يحدد سمك الخطوط المرسومة ومخططات الأشكال.

طريقة الاستخدام:

brain.screen.set_pen_width(width)

حدود	وصف
`width`	عرض القلم، بالبكسل، من 0 إلى 32.

# Draw a rectangle with a pen width of 10.
brain.screen.set_pen_width(10)
brain.screen.draw_rectangle(20, 20, 75, 50)

لقطة شاشة لدماغ EXP تُظهر مستطيلاً بحدود سميكة.

set_pen_color #

set_pen_color يحدد لون النص والبكسلات والخطوط ومخططات الأشكال.

طريقة الاستخدام:

brain.screen.set_pen_color(color)

حدود	وصف
`color`	The pen and font color to use. This can be a valid ColorType, a hex value, or a web string. `Color.BLACK` `Color.BLUE` `Color.GREEN` `Color.ORANGE` `Color.PURPLE` `Color.RED` `Color.VIOLET` `Color.WHITE` `Color.YELLOW` You can also specify a custom color.

حدود

وصف

color

The pen and font color to use. This can be a valid ColorType, a hex value, or a web string.

Color.BLACK
Color.BLUE
Color.GREEN
Color.ORANGE
Color.PURPLE
Color.RED
Color.VIOLET
Color.WHITE
Color.YELLOW

You can also specify a custom color.

# Draw a rectangle with orange borders.
brain.screen.set_pen_color(Color.ORANGE)
brain.screen.draw_rectangle(20, 20, 75, 50)

لقطة شاشة لدماغ EXP تُظهر مستطيلاً بحدود برتقالية.

# Set pen color red using a hex value.
brain.screen.set_pen_color(0xFF0000)

# Set pen color blue using predefined color.
brain.screen.set_pen_color(Color.BLUE)

# Set pen color green using web string.
brain.screen.set_pen_color("#00FF00")

set_fill_color #

set_fill_color يحدد لون التعبئة المستخدم لرسم المستطيلات والدوائر.

طريقة الاستخدام:

brain.screen.set_fill_color(color)

حدود	وصف
`color`	The fill color to use. This can be a valid ColorType, a hex value, or a web string. `Color.BLACK` `Color.BLUE` `Color.GREEN` `Color.ORANGE` `Color.PURPLE` `Color.RED` `Color.VIOLET` `Color.WHITE` `Color.YELLOW` You can also specify a custom color.

حدود

وصف

color

The fill color to use. This can be a valid ColorType, a hex value, or a web string.

Color.BLACK
Color.BLUE
Color.GREEN
Color.ORANGE
Color.PURPLE
Color.RED
Color.VIOLET
Color.WHITE
Color.YELLOW

You can also specify a custom color.

# Draw a purple rectangle.
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(20, 20, 75, 50)

لقطة شاشة لدماغ EXP تُظهر مستطيلاً مملوءًا باللون الأرجواني.

# Set fill color red using a hex value.
brain.screen.set_fill_color(0xFF0000)

# Set fill color blue using predefined color.
brain.screen.set_fill_color(Color.BLUE)

# Set fill color green using web string.
brain.screen.set_fill_color("#00FF00")

يرسم #

draw_pixel #

draw_pixel draws one pixel at the selected x and y coordinate using the current pen color.

طريقة الاستخدام:

brain.screen.draw_pixel(x, y)

حدود	وصف
`x`	إحداثيات x لرسم البكسل، من 0 إلى 159، بالرجوع إلى أصل الشاشة.
`y`	إحداثيات y لرسم البكسل، من 0 إلى 107، بالرجوع إلى أصل الشاشة.

# Draw the pixels marking the corners of a square.
brain.screen.draw_pixel(50, 50)
brain.screen.draw_pixel(50, 75)
brain.screen.draw_pixel(75, 50)
brain.screen.draw_pixel(75, 75)

draw_line #

draw_line يرسم خطًا من إحداثيات الشاشة الأولى (x1, y1) إلى إحداثيات الشاشة الثانية (x2, y2) باستخدام عرض القلم ولون القلم.

طريقة الاستخدام:

brain.screen.draw_line(x1, y1, x2, y2)

حدود	وصف
`x1`	إحداثيات x بالبكسل لبداية الخط، من 0 إلى 159، بالرجوع إلى أصل الشاشة.
`y1`	إحداثيات y بالبكسل لبداية الخط، من 0 إلى 107، بالرجوع إلى أصل الشاشة.
`x2`	إحداثيات x بالبكسل لنهاية الخط، من 0 إلى 159، بالرجوع إلى أصل الشاشة.
`y2`	إحداثيات y بالبكسل لنهاية الخط، من 0 إلى 107، بالرجوع إلى أصل الشاشة.

# Draw a line from the top left to bottom right of the screen.
brain.screen.draw_line(0, 0, 159, 107)

تظهر شاشة الدماغ خطًا قطريًا رفيعًا عبر المنتصف، من الزاوية العلوية اليسرى إلى الزاوية السفلية اليمنى.

draw_rectangle #

draw_rectangle يرسم مستطيلاً باستخدام عرض القلم، لون القلم، ولون التعبئة، ما لم يتم استخدام المعلمة الاختيارية color.

طريقة الاستخدام:

brain.screen.draw_rectangle(x, y, width, height, color)

حدود	وصف
`x`	إحداثيات x بالبكسل للزاوية العلوية اليسرى للمستطيل، من 0 إلى 159، بالرجوع إلى أصل الشاشة.
`y`	إحداثيات y بالبكسل للزاوية العلوية اليسرى للمستطيل، من 0 إلى 107، بالرجوع إلى أصل الشاشة.
`width`	عرض المستطيل.
`height`	ارتفاع المستطيل.
`color`	Optional. A valid ColorType, a hex value, or a web string. `Color.BLACK` `Color.BLUE` `Color.GREEN` `Color.ORANGE` `Color.PURPLE` `Color.RED` `Color.VIOLET` `Color.WHITE` `Color.YELLOW` You can also specify a custom color.

# Draw a rectangle on the screen.
brain.screen.draw_rectangle(20, 20, 80, 30)

تظهر شاشة الدماغ مستطيلاً بإطار أبيض رفيع.

# Draw a green rectangle on the screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_rectangle(10, 10, 20, 20)

# Draw a green rectangle on the screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_rectangle(50, 50, 20, 20, Color.RED)

draw_circle #

draw_circle يرسم دائرة باستخدام عرض القلم، لون القلم، ولون التعبئة، ما لم يتم استخدام المعلمة الاختيارية color.

طريقة الاستخدام:

brain.screen.draw_circle(x, y, radius, color)

حدود	وصف
`x`	إحداثيات x بالبكسل لمركز الدائرة، من 0 إلى 159، بالرجوع إلى أصل الشاشة.
`y`	إحداثيات y بالبكسل لمركز الدائرة، من 0 إلى 107، نسبة إلى أصل الشاشة.
`radius`	نصف قطر الدائرة.
`color`	Optional. A valid ColorType, a hex value, or a web string. `Color.BLACK` `Color.BLUE` `Color.GREEN` `Color.ORANGE` `Color.PURPLE` `Color.RED` `Color.VIOLET` `Color.WHITE` `Color.YELLOW` You can also specify a custom color.

# Draw a circle on the screen.
brain.screen.draw_circle(80, 50, 20)

تظهر شاشة الدماغ دائرة ذات إطار أبيض رفيع مرسوم في المنتصف.

# Draw a green circle on the Brain's screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_circle(50, 50, 10)

# Draw a green circle on the Brain's screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_circle(100, 50, 10, Color.RED)

draw_image_from_file #

draw_image_from_file يرسم صورة من بطاقة الذاكرة الخارجية (SD). يجب أن يكون اسم الملف الذي تحدده عند استدعاء الدالة موجودًا على بطاقة الذاكرة الخارجية (SD).

طريقة الاستخدام:

brain.screen.draw_image_from_file(filename, x, y)

حدود	وصف
`filename`	اسم ملف الصورة.
`x`	إحداثي س للزاوية العلوية اليسرى للصورة على الشاشة.
`y`	إحداثيات y للزاوية العلوية اليسرى للصورة على الشاشة.

# Draw the vex.bmp image on the Brain's screen at coordinate 0, 0.
brain.screen.draw_image_from_file('vex.bmp', 0, 0)

render #

يُفعّل render عملية الرسم باستخدام التخزين المؤقت المزدوج، ثم يعرض شاشة الدماغ. بعد استدعاء هذا الأمر، لن يظهر أي رسم إضافي على شاشة الدماغ حتى يتم استدعاء render مرة أخرى.

True إذا تم عرض المخزن المؤقت بنجاح على الشاشة.
False إذا لم يتم عرض المخزن المؤقت بنجاح على الشاشة.

طريقة الاستخدام:

brain.screen.render()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

set_clip_region #

يُحدد set_clip_region منطقة مستطيلة على الشاشة حيث سيتم حصر جميع الرسومات والنصوص. ولن يتم عرض أي محتوى خارج هذه المنطقة.

طريقة الاستخدام:

brain.screen.set_clip_region(x, y, width, height)

حدود	وصف
`x`	موضع الزاوية العلوية اليسرى للمستطيل على المحور السيني، نسبةً إلى نقطة الأصل على الشاشة.
`y`	موضع الزاوية العلوية اليسرى للمستطيل على المحور الصادي، نسبةً إلى نقطة الأصل على الشاشة.
`width`	عرض المستطيل.
`height`	ارتفاع المستطيل.