ألوان مخصصة#

مقدمة #

تدعم طائرة VEX AIR بدون طيار استخدام ألوان مخصصة للرسم وطباعة النصوص. يمكن إنشاء هذه الألوان باستخدام قيم RGB أو رموز سداسية عشرية. كما تتضمن الألوان المخصصة طرقًا لتحديث عناصر الألوان أثناء تنفيذ المشروع.

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

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

Color(value) – إنشاء لون باستخدام سلسلة سداسية عشرية (على سبيل المثال "#FFF700") أو عدد صحيح سداسي عشري (على سبيل المثال 0xFFF700).
Color(r, g, b) – يقوم بإنشاء لون باستخدام قيم الأحمر والأخضر والأزرق.

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

rgb – يقوم بتعيين كائن لون تم إنشاؤه إلى لون جديد باستخدام قيم RGB.
hsv – يقوم بتعيين كائن لون تم إنشاؤه إلى لون جديد باستخدام قيم الصبغة والتشبع والسطوع.
web – تعيين كائن لون تم إنشاؤه إلى لون جديد باستخدام سلسلة ألوان سداسية عشرية للويب (على سبيل المثال "#32C8B6").

الدوال المُسترجعة – تُعيد قيمة درجة اللون أو التشبع لكائن اللون.

saturation – تُرجع قيمة التشبع للون مخصص.
hue – تُرجع قيمة اللون المخصص.

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

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

Hexadecimal String #

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

Usage:
Color(value)

المعلمة	وصف
`value`	رمز سداسي عشري مكون من ستة أرقام كسلسلة نصية (على سبيل المثال، `“#FF700”` للون الأصفر).

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

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

Hexadecimal Integer #

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

Usage:
Color(value)

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

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

controller.screen.set_pen_color(yellow)
controller.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)

controller.screen.set_pen_color(yellow)
controller.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
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.rgb(170, 40, 150)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

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
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.hsv(300, 0.75, 0.78)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

web #

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

Usage:
variable_name.web(value)

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

# Create a custom teal color
my_fill_color = Color("#32C8B6")

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.web("#AA2896")
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

المحصلون #

saturation #

saturation تُرجع قيمة التشبع للون مخصص كعدد عشري من 0 إلى 1.

Usage:
my_color.saturation()

استبدل my_color باسم كائن اللون المخصص.

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

# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the saturation value of teal
controller.screen.print(color_teal.saturation())

hue #

hue تُرجع قيمة اللون المخصص كعدد عشري من 0 إلى 359.

Usage:
my_color.hue()

استبدل my_color باسم كائن اللون المخصص.

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

# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the hue value of teal
controller.screen.print(color_teal.hue())