ألوان مخصصة#

مقدمة#

يدعم VEX V5 استخدام الألوان المخصصة للرسم والنصوص ومصابيح LED. يمكن إنشاء الألوان المخصصة باستخدام قيم RGB أو رموز HEX أو قيم HSV أو ثوابت مُعرَّفة مسبقًا. تتضمن الألوان المخصصة طرقًا لإنشاء وتحديث كائنات الألوان. فيما يلي قائمة بالطرق المتاحة:

الدوال البانية – إنشاء كائن جديد بلون Color.

  • Color(value) – يقبل ثابتًا محددًا مسبقًا، أو سلسلة سداسية عشرية (على سبيل المثال “#FFF700”)، أو عددًا صحيحًا سداسيًا عشريًا (على سبيل المثال 0xFFF700).

  • Color(r, g, b) – إنشاء لون باستخدام قيم الأحمر والأخضر والأزرق (0–255).

المُعدِّلات – تحديث كائن موجود بلون Color.

  • rgb – تحديث اللون باستخدام قيم RGB الجديدة.

  • hsv – تحديث اللون باستخدام درجة اللون (0–360) والتشبع والسطوع (0.0–1.0).

  • web – تحديث اللون باستخدام سلسلة ألوان سداسية عشرية للويب (على سبيل المثال “#32C8B6”).

إنشاء لون مخصص#

لاستخدام لون مخصص، يجب عليك أولاً إنشاء كائن Color باستخدام أحد المنشئات التالية:

Hexadecimal Integer#

يُنشئ لونًا باستخدام عدد صحيح سداسي عشري مكون من ستة أرقام.

Usage:
Color(value)

المعلمة

وصف

value

عدد صحيح مكون من ستة أرقام بتنسيق سداسي عشري (على سبيل المثال، 0xFFF700 للون الأصفر).

# Construct a yellow Color "yellow" using a
# hexadecimal value
yellow = Color(0xFFF700)

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

RGB#

يُنشئ لونًا باستخدام قيم منفصلة للأحمر والأخضر والأزرق.

Usage:
Color(r, g, b)

المعلمة

وصف

r

عدد صحيح من 0 إلى 255 يمثل المكون الأحمر.

g

عدد صحيح من 0 إلى 255 يمثل المكون الأخضر.

b

عدد صحيح من 0 إلى 255 يمثل المكون الأزرق.

# Construct a yellow Color "yellow" using
# RGB values
yellow = Color(255, 247, 0)

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

Web Color#

يقوم بإنشاء لون باستخدام سلسلة ألوان الويب (رمز سداسي عشري).

Usage:
Color(value)

المعلمة

وصف

value

لون الويب كسلسلة نصية (رمز سداسي عشري) (على سبيل المثال، “#FFF700”).

# Construct a yellow Color "yellow" using a
# web string
yellow = Color("#FFF700")

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

Predefined Color#

يقوم بإنشاء لون باستخدام ثابت محدد مسبقًا Color.

Usage:
Color(value)

المعلمة

وصف

value

ثابت لون مدمج:
BLACK، BLUE، CYAN، GREEN، ORANGE، PURPLE، RED، TRANSPARENT، WHITE، YELLOW.

# Construct a yellow Color "yellow" using a
# predefined Color constant
yellow = Color.YELLOW

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

المتحولون#

تُحدّث هذه الطرق لون كائن موجود من النوع Color لاستخدامها، قم بتعيين قيمة من النوع Color لمتغير عند إنشائه، ثم استدعِ الطريقة على ذلك المتغير لتغيير لونه.

rgb#

rgb يقوم بتحديث لون كائن موجود من النوع Color باستخدام قيم RGB.

Usage:
variable_name.rgb(r, g, b)

حدود

وصف

r

عدد صحيح من 0 إلى 255 يمثل المكون الأحمر للون.

g

عدد صحيح من 0 إلى 255 يمثل المكون الأخضر للون.

b

عدد صحيح من 0 إلى 255 يمثل المكون الأزرق للون.

# Create a custom teal color and set it as the pen color
brain_color = Color(50, 200, 180)
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with a magenta outline
brain_color.rgb(170, 40, 150)
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)

hsv#

hsv يقوم بتحديث لون كائن موجود Color باستخدام قيم HSV.

ملاحظة: لا يمكن استخدام hsv إلا لتغيير كائن Color تم إنشاؤه مسبقًا. ولا يمكن استخدامه لإنشاء كائن Color جديد.

Usage:
variable_name.hsv(h, s, v)

حدود

وصف

h

عدد صحيح من 0 إلى 359 يمثل درجة اللون.

s

قيمة عشرية من 0.0 إلى 1.0 تمثل تشبع اللون.

v

قيمة عشرية من 0.0 إلى 1.0 تمثل سطوع اللون.

# Create a custom teal color using RGB (HSV can't be used)
brain_color = Color(50, 200, 180)
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with a magenta outline
brain_color.hsv(300, 0.75, 0.78)
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)

web#

web يقوم بتحديث لون كائن موجود Color باستخدام لون الويب (رمز سداسي عشري).

Usage:
variable_name.web(value)

حدود

وصف

value

لون الويب كسلسلة نصية (رمز سداسي عشري) (على سبيل المثال، “#FFF700”).

# Create a custom teal color and set it as the pen color
brain_color = Color("#32C8B6")
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with the new magenta outline
brain_color.web("#AA2896")
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)