وحدة التحكم

مقدمة

تظهر وحدة تحكم VEXcode V5 في نافذة المراقبة داخل VEXcode. يمكن لوظائف وحدة التحكم عرض النصوص والأرقام وقيم المتغيرات أثناء تشغيل المشروع. كما يمكنها مسح وحدة التحكم، وقراءة مدخلات المستخدم، وتحديد لون النص المطبوع بعد تغيير اللون.

عند استخدام VS Code، يظهر إخراج وحدة التحكم المستند إلى النص في الطرفية بدلاً من وحدة تحكم VEXcode.

ملاحظة: عند استخدام وحدة تحكم VEXcode، يجب عليك الاتصال بمنفذ التسلسل الخاص بوحدة التحكم قبل أن تتمكن من طباعة أي مخرجات إلى وحدة التحكم.

فيما يلي قائمة بجميع الطرق:

الإجراءات — إخراج نص أو مسح وحدة التحكم.

• print — يعرض النص أو الأرقام أو قيم المتغيرات في وحدة التحكم أو الطرفية.

• clear_console — يمسح جميع الصفوف في وحدة التحكم.

المُستقبِل — قراءة مُدخلات المستخدم.

• input — يعرض سلسلة نصية اختيارية، وينتظر إدخال المستخدم، ويعيد الاستجابة كنص.

المُعدِّل — تنسيق النص المطبوع.

• set_console_text_color — يحدد اللون المستخدم للنص المطبوع في وحدة التحكم.

الإجراءات

print

يعرض الأمر print نصًا أو أرقامًا أو قيم متغيرات في وحدة التحكم. في VS Code، يعرض الأمر print الناتج في الطرفية.

استخدم تنسيق السلاسل النصية المخصص عندما تريد أن تتضمن الرسالة المطبوعة قيمًا من مشروعك، مثل النتيجة أو المؤقت أو قراءة المستشعر. راجع صفحة تنسيق السلاسل النصية لمزيد من المعلومات.

افتراضيًا، تنتهي كل عبارة print() بـ \n ما يُمثل سطرًا جديدًا. ينقل هذا المؤشر إلى السطر التالي بعد طباعة القيمة. يُغيّر المعامل end ما يُضاف بعد القيمة المطبوعة.

Usage:
print(value, end=“\n”)

المعلمة	وصف
value	النص أو الرقم أو قيمة المتغير المراد عرضها في وحدة التحكم أو الطرفية.
end	Optional. The text added after value is printed. The default is “\n”, which moves the cursor to the next line. Use end=“” to keep the next printed value immediately after the previous value on the same line. Use another string, such as end=”, “, to add text between printed values.

# Display two messages on separate lines
print("Hello, robot!")
print("This prints on the next line.")

# Display two messages on the same line
print("Hello,", end=" ")
print("robot!")

# Print three colors on one line, separated by commas
colors = ["Red", "Green", "Blue"]

for color in colors:
    print(color, end=", ")

تسلسلات الهروب

تسلسلات الهروب هي رموز قصيرة يمكن طباعتها باستخدام print لتغيير كيفية ظهور النص في وحدة التحكم.

Most projects should use set_console_text_color to change text color and clear_console to clear the Console. Escape sequences are useful when you want to do those things directly inside a print statement.

لتغيير لون النص، اطبع \033 متبوعًا برمز اللون.

لون	تسلسل الهروب
أحمر	\033[31m
أخضر	\033[32m
أزرق	\033[34m
أسود	\033[30m
أبيض	\033[37m
أصفر	\033[33m
البرتقالي	\033[91m
أرجواني	\033[35m
سماوي	\033[36m
شفاف	\033[97m

# Print VEXcode in red
print("\033[31mVEXcode")

# Print text in different colors
print("Default text color")
print("\033[31m")
print("Red text color")

لمسح وحدة التحكم بالكامل باستخدام تسلسل الهروب، اطبع \033[2Jهذا أيضًا يعيد المؤشر إلى الصف 1.

# Clear the Console after two seconds
print("VEXcode")
wait(2, SECONDS)
print("\033[2J")

clear_console

clear_console يمسح جميع الصفوف من وحدة التحكم.

Usage:
clear_console()

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

# Display text, then clear it after two seconds
print("This will disappear...")
wait(2, SECONDS)
clear_console()

المحصل

input

يعرض الأمر input سلسلة نصية اختيارية، وينتظر من المستخدم إدخال رد، ثم يعيد هذا الرد كنص.

يتوقف المشروع عند المدخل input() حتى يتم إدخال استجابة في وحدة التحكم. في VS Code، يتم إدخال الاستجابة في الطرفية.

القيمة المُعادة من input() نص. لاستخدام الاستجابة كرقم، قم بتحويلها أولًا باستخدام int() () أو float()

Usage:
input(prompt)

المعلمة	وصف
prompt	اختياري. نص يُعرض في وحدة التحكم أو الطرفية قبل انتظار الرد. في حال عدم تضمين أي موجه، لن تُعرض أي رسالة قبل الانتظار.

# Ask for a name, then print a greeting
answer = input("What's your name?")
print("Hello, " + answer)

# Ask for a number, then use it in math
answer = input("Enter a number:")
number = float(answer)
print(number + 1)

المُعدِّل

set_console_text_color

يُحدد set_console_text_color لون النص المطبوع في وحدة التحكم بعد استخدام هذه الطريقة. عند بدء المشروع، يكون لون نص وحدة التحكم هو BLUE.

تُغيّر هذه الطريقة لون النص في وحدة تحكم VEXcode. أما في VS Code، فقد يختلف دعم ألوان الطرفية باختلاف الطرفية.

Usage:
set_console_text_color(color)

المعلمة	وصف
color	اللون المستخدم للنص المطبوع في وحدة التحكم: Color.BLACK Color.BLUE Color.CYAN Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.TRANSPARENT Color.WHITE Color.YELLOW

# Print text in different colors
print("Default text color")
set_console_text_color(Color.RED)
print("Red text color")