Bildschirm

Einführung

Die Bildschirmmethoden steuern, wie das V5 Brain Text, Zahlen und Grafiken auf seinem Touchscreen anzeigt und wie es auf Berührungseingaben reagiert.

Standardmäßig wird für den Druck auf Brain die Schriftart monospaced small verwendet, die 12 Zeilen und 48 Spalten hat.

Für Zeichenaufgaben beträgt die Auflösung des Brain 480 x 240 Pixel.

Nachfolgend finden Sie eine Liste aller Methoden:

Cursor Print – Text platzieren und drucken.

• print — Gibt Text, Zahlen oder Variablenwerte an der aktuellen Cursorposition aus.

• set_cursor — Verschiebt den Cursor in eine bestimmte Zeile und Spalte.

• next_row — Bewegt den Cursor in Spalte 1 der nächsten Zeile.

• clear_row — Löscht eine Textzeile.

• row — Gibt die Zeile zurück, in der der Text gedruckt werden soll.

• column — Gibt die Spalte zurück, in der der Text gedruckt werden soll.

• print_at — Gibt Text, Zahlen oder Variablenwerte an einer bestimmten x- und y-Koordinate aus.

• get_string_width — Gibt die Breite einer Zeichenkette in Pixeln unter Verwendung der aktuellen Schriftart zurück.

• get_string_height — Gibt die Höhe einer Zeichenkette in Pixeln unter Verwendung der aktuellen Schriftart zurück.

• clear_line — Löscht eine Textzeile.

• new_line — Bewegt den Cursor in eine neue Zeile.

Mutatoren – Ändern Bildschirmeinstellungen, Farben und Zeichenverhalten.

• clear_screen — Löscht alle Zeichnungen und Texte auf dem Bildschirm.

• set_font — Legt die Schriftart für gedruckten Text fest.

• set_pen_width — Legt die Dicke der gezeichneten Linien und Formumrisse fest.

• set_pen_color — Legt die Farbe von Text, Pixeln, Linien und Formumrissen fest.

• set_fill_color — Legt die Füllfarbe für gezeichnete Formen und gedruckte Texthintergründe fest.

• set_origin — Legt den Ursprung fest, der für koordinatenbasiertes Drucken und Zeichnen verwendet wird.

Zeichnen – Grafiken auf dem Bildschirm hinzufügen.

• draw_pixel — Zeichnet ein Pixel an einer Koordinate.

• draw_line — Zeichnet eine Linie zwischen zwei Punkten.

• draw_rectangle — Zeichnet ein Rechteck.

• draw_circle — Zeichnet einen Kreis.

• render — Aktualisiert den Bildschirm des Gehirns nur dann mit Text und Zeichnungen, wenn er aufgerufen wird.

• set_clip_region — Beschränkt, wo Zeichnungen und Text erscheinen können.

Getter – Berührungsstatus und Berührungsposition prüfen.

• pressing — Gibt zurück, ob der Bildschirm gedrückt wird.

• x_position — Gibt die x-Koordinate des letzten Bildschirmdrucks zurück.

• y_position — Gibt die y-Koordinate des letzten Bildschirmdrucks zurück.

Callbacks – Reagieren auf Berührungsereignisse auf dem Bildschirm.

• pressed — Registriert eine Funktion, die aufgerufen werden soll, wenn der Bildschirm gedrückt wird.

• released — Registriert eine Funktion, die aufgerufen werden soll, wenn der Bildschirm losgelassen wird.

Informationen zum Aufbau eines Gehirns, um Zugriff auf die Methoden screen zu erhalten, finden Sie unter Gehirn.

Cursor Drucken

print

print gibt Text, Zahlen oder Variablenwerte an der aktuellen Cursorposition und in der aktuellen Schriftart auf dem Brain-Bildschirm aus.

Verwendung:

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

Parameter	Beschreibung
text	Der auszugebende Text, die Zahl oder der Variablenwert.
sep	Optional. Eine Zeichenkette, die zwischen den Werten eingefügt wird. Diese muss als Schlüsselwortargument (sep=) angegeben werden. Der Standardwert ist “”.
precision	Optional. Die Anzahl der Dezimalstellen, die beim Drucken einfacher Zahlen angezeigt werden sollen. Dies muss als Schlüsselwortargument angegeben werden (precision=). Der Standardwert ist 2.

# Print on the Brain's screen
brain.screen.print("Hello, Robot!")

set_cursor

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. How many rows and columns can comfortably fit depends on the selected font. With the default monospaced medium font, up to 8 rows and 13 columns can be displayed clearly. Text placed beyond this range may be cut off or become difficult to read.

Monospaced fonts have characters that are all the same width, making text placement consistent. In contrast, proportional fonts vary in character width, so some letters take up more space than others. However, regardless of which type is used, set_cursor positions the cursor based on row and column size, not font style. The font size can be adjusted using the set_font.

Verwendung:

brain.screen.set_cursor(row, column)

Parameter	Beschreibung
row	Die Zeile, in die der Cursor bewegt werden soll.
column	Die Spalte, in die der Cursor bewegt werden soll.

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

next_row

next_row bewegt den Cursor zur nächsten Zeile.

Verwendung:

brain.screen.next_row()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

# Print two lines of text on the Brain's screen
brain.screen.print("Line 1")
brain.screen.next_row()
brain.screen.print("Line 2")

clear_row

clear_row löscht eine einzelne Textzeile auf dem Brain-Bildschirm.

Verwendung:

brain.screen.clear_row(row, color)

Parameter	Beschreibung
row	Optional. Die zu löschende Zeile. Standardmäßig wird die Zeile der aktuellen Cursorposition verwendet.
color	Optional. Eine gültige Farbe, ein Hexadezimalwert oder eine Webzeichenfolge.

# Only keep the text on row 1
brain.screen.print("This text stays")
brain.screen.next_row
brain.screen.print("This text disappears")
wait(3, SECONDS)

brain.screen.clear_row()

row

row gibt die Zeile zurück, in der der Text als Ganzzahl ausgegeben wird.

Verwendung:

brain.screen.row()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

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

column

column gibt die Spalte zurück, in der der Text als ganze Zahl ausgegeben wird.

Verwendung:

brain.screen.column()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

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

print_at

print_at gibt Text, Zahlen oder Variablenwerte auf dem Brain-Bildschirm an bestimmten x- und y-Koordinaten mit der aktuellen font und origin aus.

Verwendung:

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

Parameter	Beschreibung
text	Der auszugebende Text, die Zahl oder der Variablenwert.
x	Die x-Koordinate, an der gedruckt werden soll, wird als Schlüsselwortargument angegeben (x=), bezogen auf den Bildschirmursprung.
y	Die y-Koordinate, an der gedruckt werden soll, wird als Schlüsselwortargument (y=) angegeben und bezieht sich auf den Bildschirmursprung.
sep	Optional. Eine Zeichenkette, die zwischen den Werten eingefügt wird. Diese muss als Schlüsselwortargument (sep=) angegeben werden. Der Standardwert ist ” “.
precision	Optional. Die Anzahl der Dezimalstellen, die beim Drucken einfacher Zahlen angezeigt werden sollen. Dies muss als Schlüsselwortargument angegeben werden (precision=). Der Standardwert ist 2.
opaque	Optional. Ein boolescher Wert, der angibt, ob der Text Hintergrundpixel löschen soll oder nicht. Standardwert: True.

# Display text at the center of the screen
brain.screen.print_at("Center", x=220, y=120)

get_string_width

get_string_width gibt die Breite einer Zeichenkette in Pixeln als ganze Zahl zurück, wobei die aktuelle Schriftart verwendet wird.

Usage:
brain.screen.get_string_width(string)

Parameter	Beschreibung
string	Die zu messende Schnur.

get_string_height

get_string_height gibt die Höhe einer Zeichenkette in Pixeln als ganze Zahl zurück, wobei die aktuelle Schriftart verwendet wird.

Usage:
brain.screen.get_string_height(string)

Parameter	Beschreibung
string	Die zu messende Schnur.

clear_line

clear_line löscht die aktuelle Textzeile.

Usage: brain.screen.clear_line()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

new_line

new_line bewegt den Cursor in die erste Spalte der nächsten Zeile auf dem Brain-Bildschirm.

Verwendung:

brain.screen.new_line()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

Mutatoren

clear_screen

clear_screen löscht alle Zeichnungen und Texte vom Brain-Bildschirm.

Verwendung:

brain.screen.clear_screen(color)

Parameter	Beschreibung
color	Optional. Eine gültige Farboption: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.BLACK (Standard) Color.WHITE

# Print VEXcode on the screen
brain.screen.print("VEXcode")
wait(2, SECONDS)
# Clear screen to black
brain.screen.clear_screen()

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

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

set_font

set_font legt die Schriftart für die Textanzeige auf dem Brain-Bildschirm fest. Diese Schriftart wird für alle nach Ausführung dieser Methode ausgegebenen Texte verwendet.

Verwendung:

brain.screen.set_font(font)

Parameter	Beschreibung
font	Eine gültige Schriftartoption finden Sie unten.

FontType.MONO12	FontType.MONO15	FontType.MONO20
FontType.MONO30	FontType.MONO40	FontType.MONO60
FontType.PROP20	FontType.PROP30	FontType.PROP40
FontType.PROP60

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

set_pen_width

set_pen_width legt die Dicke der gezeichneten Linien und Formkonturen fest.

Verwendung:

brain.screen.set_pen_width(value)

Parameter	Beschreibung
value	Die Stiftbreite in Pixeln, von 0 bis 32.

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

set_pen_color

set_pen_color legt die Farbe von Text, Pixeln, Linien und Formumrissen fest.

Verwendung:

brain.screen.set_pen_color(color)

Parameter	Beschreibung
color	Die zu verwendende Stift- und Schriftfarbe. Optionen: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Sie können auch eine benutzerdefinierte Farbe angeben.

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

set_fill_color

set_fill_color legt die Füllfarbe fest, die beim Zeichnen von Formen verwendet wird.

Verwendung:

brain.screen.set_fill_color(color)

Parameter	Beschreibung
color	Die zu verwendende Füllfarbe. Optionen: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Sie können auch eine benutzerdefinierte Farbe angeben.

# Draw a purple rectangle
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(50, 130, 100, 60)

set_origin

Mit dem Befehl set_origin wird der Ursprung für das Zeichnen und koordinatenbasierte Drucken auf dem Brain-Bildschirm festgelegt. Standardmäßig befindet sich der Ursprung in der oberen linken Ecke des Bildschirms.

Verwendung:

brain.screen.set_origin(x, y)

Parameter	Beschreibung
x	Die x-Koordinate, die als Ursprung festgelegt werden soll, von 0 bis 479.
y	Die y-Koordinate, die als Ursprung festgelegt werden soll, von 0 bis 239.

Ziehen

draw_pixel

draw_pixel zeichnet ein Pixel an der ausgewählten x- und y-Koordinate mit der aktuellen Stiftfarbe.

Verwendung:

brain.screen.draw_pixel(x, y)

Parameter	Beschreibung
x	Die x-Koordinate zum Zeichnen des Pixels, von 0 bis 479, bezogen auf den Bildschirmursprung.
y	Die y-Koordinate zum Zeichnen des Pixels, von 0 bis 239, bezogen auf den Bildschirmursprung.

# Draw the pixels marking the corners of a square
brain.screen.draw_pixel(250, 100)
brain.screen.draw_pixel(275, 100)
brain.screen.draw_pixel(250, 125)
brain.screen.draw_pixel(275, 125)

draw_line

draw_line zeichnet eine Linie von der ersten Bildschirmkoordinate zur zweiten Bildschirmkoordinate unter Verwendung der aktuellen Stiftbreite und Stiftfarbe.

Verwendung:

brain.screen.draw_line(start_x, start_y, end_x, end_y)

Parameter	Beschreibung
start_x	Die x-Koordinate in Pixeln des Zeilenanfangs, von 0 bis 479, bezogen auf den Bildschirmursprung.
start_y	Die y-Koordinate in Pixeln des Linienanfangs, von 0 bis 239, bezogen auf den Bildschirmursprung.
end_x	Die x-Koordinate in Pixeln des Zeilenendes, von 0 bis 479, bezogen auf den Bildschirmursprung.
end_y	Die y-Koordinate in Pixeln des Linienendes, von 0 bis 239, bezogen auf den Bildschirmursprung.

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

draw_rectangle

draw_rectangle zeichnet ein Rechteck unter Verwendung der aktuellen Stiftbreite, Stiftfarbe und Füllfarbe, es sei denn, der optionale Parameter color wird verwendet.

Verwendung:

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

Parameter	Beschreibung
x	Die x-Koordinate in Pixeln der oberen linken Ecke des Rechtecks ​​von 0 bis 479.
y	Die y-Koordinate in Pixeln der oberen linken Ecke des Rechtecks ​​von 0 bis 239.
width	Die Breite des Rechtecks.
height	Die Höhe des Rechtecks.
color	Optional. Eine gültige Farboption: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Sie können auch eine benutzerdefinierte Farbe angeben.

# Draw a rectangle on the screen
brain.screen.draw_rectangle(50, 50, 130, 60)

draw_circle

draw_circle zeichnet einen Kreis unter Verwendung der aktuellen Stiftbreite, Stiftfarbe und Füllfarbe, es sei denn, der optionale Parameter color wird verwendet.

Verwendung:

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

Parameter	Beschreibung
x	Die x-Koordinate des Mittelpunkts des Kreises in Pixeln, von 0 bis 479, bezogen auf den Bildschirmursprung.
y	Die y-Koordinate des Mittelpunkts des Kreises in Pixeln, von 0 bis 239, bezogen auf den Bildschirmursprung.
radius	Der Radius des Kreises in Pixeln.
color	Optional. Die zu verwendende Füllfarbe. Optionen: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Sie können auch eine benutzerdefinierte Farbe angeben.

# Draw a circle on the screen
brain.screen.draw_circle(120, 120, 40)

render

Die Option render aktiviert die doppelte Pufferung für den Bildschirm des Brains. Nach dem Aufruf werden Zeichenbefehle (wie Text, Formen oder Bilder) für den Rest des Projekts nicht mehr sofort angezeigt. Aktualisierungen werden erst sichtbar, wenn render erneut verwendet wird. Dies ermöglicht flüssigere und kontrolliertere Bildschirmaktualisierungen, bedeutet aber, dass bis zur Verwendung von render nichts sichtbar ist.

Verwendung:

brain.screen.render()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

# Render text after moving
brain.screen.render()
brain.screen.print("Render later...")
drivetrain.drive_for(FORWARD, 100, MM)
drivetrain.turn_for(RIGHT, 90, DEGREES)
brain.screen.render()

set_clip_region

set_clip_region wird ein rechteckiger Bereich auf dem Bildschirm definiert, in dem alle Zeichnungen und Texte angezeigt werden. Inhalte außerhalb dieses Bereichs werden nicht dargestellt.

Verwendung:

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

Parameter	Beschreibung
x	Die x-Position der oberen linken Ecke des Rechtecks, bezogen auf den Bildschirmursprung.
y	Die y-Position der oberen linken Ecke des Rechtecks, bezogen auf den Bildschirmursprung.
width	Die Breite des Rechtecks.
height	Die Höhe des Rechtecks.

# Restrict text and drawings to a specific region
brain.screen.set_clip_region(0, 0, 120, 120)
brain.screen.draw_rectangle(60, 60, 100, 100, Color.RED)
brain.screen.print_at("Cut off!", x=60, y=60)

Berühren

pressing

pressing wird ein boolescher Wert zurückgegeben, der angibt, ob der Brain-Bildschirm gerade gedrückt wird.

• True - Der Bildschirm wird gedrückt.

• False - Der Bildschirm wird nicht berührt.

Verwendung:

brain.screen.pressing()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

# Change the screen's color after it's pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.set_fill_color(Color.GREEN)
brain.screen.draw_rectangle(0, 0, 479, 239)

# Display different messages after the screen is pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.print("First message!")
brain.screen.next_row()
# Lift finger to press the screen again
while brain.screen.pressing():
    wait(5, MSEC)
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.print("Second message!")
brain.screen.next_row()

x_position

x_position gibt die x-Koordinate des letzten Bildschirmdrucks als ganze Zahl von 0 (links) bis 479 (rechts) zurück.

Verwendung:

brain.screen.x_position()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

# Display a circle where the screen is pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.set_fill_color(Color.WHITE)
brain.screen.draw_circle(brain.screen.x_position(), brain.screen.y_position(), 20)

y_position

y_position gibt die y-Koordinate des letzten Bildschirmdrucks als ganze Zahl von 0 (oben) bis 239 (unten) zurück.

Verwendung:

brain.screen.y_position()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

# Display a circle where the screen is pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.set_fill_color(Color.WHITE)
brain.screen.draw_circle(brain.screen.x_position(), brain.screen.y_position(), 20)

Rückrufe

pressed

pressed registriert eine Funktion, die aufgerufen werden soll, wenn der Bildschirm des Gehirns gedrückt wird.

Verwendung:

brain.screen.pressed(callback, arg)

Parameter	Beschreibung
callback	Eine zuvor definierte Funktion, die ausgeführt wird, wenn der Brain-Bildschirm gedrückt wird.
arg	Optional. Ein Tupel mit Argumenten, die an die Callback-Funktion übergeben werden sollen. Weitere Informationen finden Sie unter Verwendung von Funktionen mit Parametern.

def my_function():
  brain.screen.print("Screen pressed")

# Call my_function whenever the Brain screen is pressed
brain.screen.pressed(my_function)

released

released registriert eine Funktion, die aufgerufen werden soll, wenn der Bildschirm losgelassen wird (Berührung entfernt).

Verwendung:

brain.screen.released(callback, arg)

Parameter	Beschreibung
callback	Eine zuvor definierte Funktion, die ausgeführt wird, wenn der Brain-Bildschirm losgelassen wird.
arg	Optional. Ein Tupel mit Argumenten, die an die Callback-Funktion übergeben werden sollen. Weitere Informationen finden Sie unter Verwendung von Funktionen mit Parametern.

def my_function():
  brain.screen.print("Screen released")

# Call my_function whenever the Brain screen is released
brain.screen.released(my_function)