وحدة التحكم

مقدمة

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

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

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

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

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

• new_line — ينقل مؤشر وحدة التحكم إلى بداية السطر التالي.

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

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

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

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

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

الإجراءات

print

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

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

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

Usage:
brain.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
brain.print("Hello, CTE!")
brain.print("This prints on the next line.")

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

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

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

new_line

يؤدي الأمر new_line إلى نقل المؤشر إلى العمود 1 في الصف التالي في وحدة التحكم. ستظهر القيمة التالية المطبوعة في ذلك الصف.

Use this method when you want the next printed value to start on a new row. If this method is not used, and the previous brain.print() statement used end=“” or another value that does not include \n, the next printed value will appear immediately after the previous value on the same row.

Usage:
brain.new_line()

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

# Print on two lines
brain.print("Row 1", end="")
brain.new_line()
brain.print("Row 2")

clear

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

Usage:
brain.clear()

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

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

المحصل

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?")
brain.print("Hello, " + answer)

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

المُعدِّل

set_print_color

set_print_color sets the color used for text printed in the Console after this method is used. At the start of a project, the Console text color is set to BLACK.

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

Usage:
brain.set_print_color(color)

حدود	وصف
color	اللون المستخدم للنص المطبوع في وحدة التحكم: BLACK BLUE GREEN RED

# Print text in different colors
brain.print("Default text color")
brain.new_line()
brain.set_print_color(RED)
brain.print("Red text color")