Scherm#
Invoering#
De scherminstellingen bepalen hoe de V5 Brain tekst, cijfers en afbeeldingen op het touchscreen weergeeft en hoe deze reageert op aanraakinvoer.
Standaard is het lettertype voor afdrukken naar de Brain monospaced small, met 12 rijen en 48 kolommen.
Voor tekenen heeft de Brain een resolutie van 480 x 240 pixels.
Hieronder vindt u een lijst met alle methoden:
Cursor Print — Plaats en print tekst.
print— Drukt tekst, getallen of variabele waarden af op de huidige cursorpositie.set_cursor— Verplaatst de cursor naar een specifieke rij en kolom.next_row— Verplaatst de cursor naar kolom 1 van de volgende rij.clear_row— Maakt een rij tekst leeg.row— Geeft de rij terug waar de tekst zal worden afgedrukt.column— Geeft de kolom terug waar de tekst wordt afgedrukt.print_at— Drukt tekst, getallen of variabele waarden af op een specifieke x- en y-coördinaat.get_string_width— Retourneert de breedte van een tekenreeks in pixels met behulp van het huidige lettertype.get_string_height— Retourneert de hoogte van een tekenreeks in pixels met behulp van het huidige lettertype.clear_line— Maakt een regel tekst leeg.new_line— Verplaatst de cursor naar een nieuwe regel.
Mutators — Wijzig scherminstellingen, kleuren en tekengedrag.
clear_screen— Maakt het scherm leeg van alle tekeningen en tekst.set_font— Stelt het lettertype in voor de afgedrukte tekst.set_pen_width— Stelt de dikte in van getekende lijnen en vormcontouren.set_pen_color— Stelt de kleur in van tekst, pixels, lijnen en vormcontouren.set_fill_color— Stelt de vulkleur in voor getekende vormen en achtergronden van afgedrukte tekst.set_origin— Stelt de oorsprong in die wordt gebruikt voor coördinatengebaseerd afdrukken en tekenen.
Tekenen — Voeg afbeeldingen toe aan het scherm.
draw_pixel— Tekent één pixel op een coördinaat.draw_line— Tekent een lijn tussen twee punten.draw_rectangle— Tekent een rechthoek.draw_circle— Tekent een cirkel.render— Werkt het scherm van de hersenen bij met tekst en tekeningen, maar alleen wanneer deze functie wordt aangeroepen.set_clip_region— Beperkt waar tekeningen en tekst kunnen verschijnen.
Getters — Controleer de aanraakstatus en aanraakpositie.
pressingindrukt — Geeft aan of er op het scherm wordt gedrukt.x_position— Geeft de x-coördinaat van de laatst aangeklikte schermtoets terug.y_position— Geeft de y-coördinaat van de laatst aangeklikte knop op het scherm terug.
Callbacks — Reageren op aanraakgebeurtenissen op het scherm.
pressed— Registreert een functie die moet worden aangeroepen wanneer het scherm wordt ingedrukt.released— Registreert een functie die moet worden aangeroepen wanneer het scherm wordt vrijgegeven.
Voor informatie over het construeren van een Brain om toegang te krijgen tot de screen methoden, zie Brain.
Cursor Print#
print#
print print tekst, getallen of variabele waarden op het Brain-scherm op de huidige cursorpositie en met het huidige lettertype.
Gebruik:
brain.screen.print(text, sep, precision)
Parameters |
Beschrijving |
|---|---|
|
De tekst, het getal of de variabele waarde die moet worden afgedrukt. |
|
Optioneel. Een tekenreeks die tussen waarden moet worden ingevoegd. Deze moet worden geschreven als een sleutelwoordargument (sep=). De standaardwaarde is |
|
Optioneel. Het aantal decimalen dat moet worden weergegeven bij het afdrukken van eenvoudige getallen. Dit moet worden opgegeven als een sleutelwoordargument ( |
# Print on the Brain's screen
brain.screen.print("Hello, Robot!")
set_cursor#
set_cursor verplaatst de cursor naar een specifieke rij en kolom op het Brain-scherm. De volgende print aanroep begint met afdrukken op die locatie. Hoeveel rijen en kolommen er comfortabel passen, hangt af van het geselecteerde lettertype. Met het standaard monospace medium lettertype kunnen maximaal 8 rijen en 13 kolommen duidelijk worden weergegeven. Tekst die buiten dit bereik wordt geplaatst, kan worden afgesneden of moeilijk leesbaar worden.
Monospaced lettertypen hebben tekens die allemaal dezelfde breedte hebben, waardoor de tekst consistent wordt geplaatst. Proportionele lettertypen daarentegen variëren in tekenbreedte, waardoor sommige letters meer ruimte innemen dan andere. Ongeacht welk type wordt gebruikt, positioneert set_cursor de cursor op basis van de rij- en kolomgrootte, niet op basis van de letterstijl. De lettergrootte kan worden aangepast met set_font.
Gebruik:
brain.screen.set_cursor(row, column)
Parameters |
Beschrijving |
|---|---|
|
De rij waarnaar de cursor moet worden verplaatst. |
|
De kolom waarnaar de cursor moet worden verplaatst. |
# 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 verplaatst de cursor naar de volgende rij.
Gebruik:
brain.screen.next_row()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
# 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 wist één regel tekst op het Brain-scherm.
Gebruik:
brain.screen.clear_row(row, color)
Parameters |
Beschrijving |
|---|---|
|
Optioneel. De rij die moet worden gewist. Standaard is dit de huidige cursorrij. |
|
Optioneel. Een geldige kleur, een hexadecimale waarde of een webstring. |
# 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 geeft de rij aan waar de tekst als geheel getal wordt afgedrukt.
Gebruik:
brain.screen.row()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
# Display the cursor's current row
brain.screen.set_cursor(3, 2)
brain.screen.print(brain.screen.row())
column#
column geeft de kolom aan waar de tekst als geheel getal wordt afgedrukt.
Gebruik:
brain.screen.column()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
# Display the cursor's current column
brain.screen.set_cursor(3, 15)
brain.screen.print(brain.screen.column())
print_at#
print_at print tekst, getallen of variabele waarden op het Brain-scherm op specifieke x- en y-coördinaten met de huidige font en origin.
Gebruik:
brain.screen.print_at(text, x, y, sep, precision, opaque)
Parameters |
Beschrijving |
|---|---|
|
De tekst, het getal of de variabele waarde die moet worden afgedrukt. |
|
De x-coördinaat waarop afgedrukt moet worden, wordt als sleutelwoordargument meegegeven ( |
|
De y-coördinaat waarop afgedrukt moet worden, wordt als sleutelwoordargument doorgegeven ( |
|
Optioneel. Een tekenreeks die tussen waarden moet worden ingevoegd. Deze moet worden geschreven als een sleutelwoordargument (sep=). De standaardwaarde is |
|
Optioneel. Het aantal decimalen dat moet worden weergegeven bij het afdrukken van eenvoudige getallen. Dit moet worden opgegeven als een sleutelwoordargument ( |
|
Optioneel. Een Booleaanse waarde die aangeeft of de tekst de achtergrondpixels moet wissen. De standaardwaarde is |
# Display text at the center of the screen
brain.screen.print_at("Center", x=220, y=120)
get_string_width#
get_string_width retourneert de breedte van een tekenreeks in pixels als een geheel getal, gebruikmakend van het huidige font.
Usage:
brain.screen.get_string_width(string)
Parameters |
Beschrijving |
|---|---|
|
Het touwtje om te meten. |
get_string_height#
get_string_height retourneert de hoogte van een tekenreeks in pixels als een geheel getal, gebruikmakend van het huidige font.
Usage:
brain.screen.get_string_height(string)
Parameters |
Beschrijving |
|---|---|
|
Het touwtje om te meten. |
clear_line#
clear_line wist de huidige tekstregel.
Usage:
brain.screen.clear_line()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
new_line#
new_line verplaatst de cursor naar kolom 1 op de volgende regel van het Brain-scherm.
Gebruik:
brain.screen.new_line()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
Mutators#
clear_screen#
clear_screen wist alle tekeningen en tekst van het Brain-scherm.
Gebruik:
brain.screen.clear_screen(color)
Parameters |
Beschrijving |
|---|---|
|
Optioneel. Geldige kleuropties:
|
# 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 stelt het lettertype in dat wordt gebruikt voor het weergeven van tekst op het Brain-scherm. Dit lettertype wordt toegepast op alle tekst die wordt afgedrukt nadat deze methode is uitgevoerd.
Gebruik:
brain.screen.set_font(font)
Parameters |
Beschrijving |
|---|---|
|
Hieronder vindt u een geldige lettertypeoptie. |
|
|
|
|---|---|---|
|
|
|
|
|
|
|
# Set the font type to MONO40
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")
set_pen_width#
set_pen_width stelt de dikte in van getekende lijnen en vormcontouren.
Gebruik:
brain.screen.set_pen_width(value)
Parameters |
Beschrijving |
|---|---|
|
De penbreedte, in pixels, van 0 tot 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 stelt de kleur in van tekst, pixels, lijnen en vormcontouren.
Gebruik:
brain.screen.set_pen_color(color)
Parameters |
Beschrijving |
|---|---|
|
De te gebruiken pen- en letterkleur. Opties zijn onder andere:
|
# 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 stelt de vulkleur in die wordt gebruikt bij het tekenen van vormen.
Gebruik:
brain.screen.set_fill_color(color)
Parameters |
Beschrijving |
|---|---|
|
De opvulkleur die gebruikt moet worden. Opties zijn onder andere:
|
# Draw a purple rectangle
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(50, 130, 100, 60)
set_origin#
set_origin stelt het oorsprongspunt in dat wordt gebruikt voor tekenen en coördinaatgebaseerd afdrukken op het Brain-scherm. Standaard is het oorsprongspunt de linkerbovenhoek van het scherm.
Gebruik:
brain.screen.set_origin(x, y)
Parameters |
Beschrijving |
|---|---|
|
De x-coördinaat die als oorsprong moet worden ingesteld, van 0 tot 479. |
|
De y-coördinaat die als oorsprong moet worden ingesteld, ligt tussen 0 en 239. |
Tekenen#
draw_pixel#
draw_pixel tekent één pixel op de geselecteerde x- en y-coördinaat met de huidige penkleur.
Gebruik:
brain.screen.draw_pixel(x, y)
Parameters |
Beschrijving |
|---|---|
|
De x-coördinaat om de pixel te tekenen, van 0 tot 479, ten opzichte van de oorsprong van het scherm. |
|
De y-coördinaat om de pixel te tekenen, van 0 tot 239, ten opzichte van de oorsprong van het scherm. |
# 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 tekent een lijn van de eerste schermcoördinaat naar de tweede schermcoördinaat met de huidige pendikte en penkleur.
Gebruik:
brain.screen.draw_line(start_x, start_y, end_x, end_y)
Parameters |
Beschrijving |
|---|---|
|
De x-coördinaat in pixels van het begin van de lijn, van 0 tot 479, ten opzichte van de schermoorsprong. |
|
De y-coördinaat in pixels van het begin van de lijn, van 0 tot 239, ten opzichte van de schermoorsprong. |
|
De x-coördinaat in pixels van het einde van de lijn, van 0 tot 479, ten opzichte van de oorsprong van het scherm. |
|
De y-coördinaat in pixels van het einde van de lijn, van 0 tot 239, ten opzichte van de oorsprong van het scherm. |
# 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 tekent een rechthoek met de huidige penbreedte, penkleur en vulkleur, tenzij de optionele parameter color wordt gebruikt.
Gebruik:
brain.screen.draw_rectangle(x, y, width, height, color)
Parameters |
Beschrijving |
|---|---|
|
De x-coördinaat in pixels van de linkerbovenhoek van de rechthoek, van 0 tot 479. |
|
De y-coördinaat in pixels van de linkerbovenhoek van de rechthoek, van 0 tot 239. |
|
De breedte van de rechthoek. |
|
De hoogte van de rechthoek. |
|
Optioneel. Een geldige kleuroptie:
|
# Draw a rectangle on the screen
brain.screen.draw_rectangle(50, 50, 130, 60)
draw_circle#
draw_circle tekent een cirkel met de huidige penbreedte, penkleur en vulkleur, tenzij de optionele parameter color wordt gebruikt.
Gebruik:
brain.screen.draw_circle(x, y, radius, color)
Parameters |
Beschrijving |
|---|---|
|
De x-coördinaat in pixels van het middelpunt van de cirkel, van 0 tot 479, ten opzichte van de schermoorsprong. |
|
De y-coördinaat in pixels van het middelpunt van de cirkel, van 0 tot 239, ten opzichte van de oorsprong van het scherm. |
|
De straal van de cirkel, in pixels. |
|
Optioneel. De opvulkleur die gebruikt moet worden. Opties zijn onder andere:
Color.TRANSPARENT |
# Draw a circle on the screen
brain.screen.draw_circle(120, 120, 40)
render#
render maakt dubbele buffering mogelijk voor het scherm van de Brain. Zodra deze functie is aangeroepen, zullen tekenopdrachten (zoals tekst, vormen of afbeeldingen) niet langer direct zichtbaar zijn gedurende de rest van het project. Updates worden pas weergegeven wanneer render opnieuw wordt gebruikt. Dit zorgt voor vloeiendere en meer gecontroleerde schermupdates, maar betekent wel dat er niets zichtbaar zal zijn totdat render wordt gebruikt.
Gebruik:
brain.screen.render()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
# 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 definieert een rechthoekig gebied op het scherm waarbinnen alle tekeningen en tekst worden weergegeven. Inhoud buiten dit gebied wordt niet getoond.
Gebruik:
brain.screen.set_clip_region(x, y, width, height)
Parameters |
Beschrijving |
|---|---|
|
De x-positie van de linkerbovenhoek van de rechthoek, ten opzichte van de schermoorsprong. |
|
De y-positie van de linkerbovenhoek van de rechthoek, ten opzichte van de schermoorsprong. |
|
De breedte van de rechthoek. |
|
De hoogte van de rechthoek. |
# 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)
Aanraken#
pressing#
pressing retourneert een Booleaanse waarde die aangeeft of het Brain-scherm momenteel wordt ingedrukt.
True- Er wordt op het scherm gedrukt.False- Er wordt niet op het scherm gedrukt.
Gebruik:
brain.screen.pressing()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
# 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 retourneert de x-coördinaat van de laatst aangeklikte knop op het scherm als een geheel getal van 0 (links) tot 479 (rechts).
Gebruik:
brain.screen.x_position()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
# 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 retourneert de y-coördinaat van de laatst aangeklikte knop op het scherm als een geheel getal van 0 (boven) tot 239 (onder).
Gebruik:
brain.screen.y_position()
Parameters |
Beschrijving |
|---|---|
Deze methode heeft geen parameters. |
# 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)
Terugbelverzoeken#
pressed#
pressed registreert een functie die moet worden aangeroepen wanneer het scherm van de hersenen wordt ingedrukt.
Gebruik:
brain.screen.pressed(callback, arg)
Parameters |
Beschrijving |
|---|---|
|
Een eerder gedefinieerde functie die wordt uitgevoerd wanneer op het Brain-scherm wordt gedrukt. |
|
Optioneel. Een tuple met argumenten die aan de callbackfunctie moeten worden doorgegeven. Zie Functies gebruiken met parameters voor meer informatie. |
def my_function():
brain.screen.print("Screen pressed")
# Call my_function whenever the Brain screen is pressed
brain.screen.pressed(my_function)
released#
released registreert een functie die moet worden aangeroepen wanneer het scherm wordt losgelaten (aanraking verwijderd).
Gebruik:
brain.screen.released(callback, arg)
Parameters |
Beschrijving |
|---|---|
|
Een eerder gedefinieerde functie die wordt uitgevoerd wanneer het Brain-scherm wordt losgelaten. |
|
Optioneel. Een tuple met argumenten die aan de callbackfunctie moeten worden doorgegeven. Zie Functies gebruiken met parameters voor meer informatie. |
def my_function():
brain.screen.print("Screen released")
# Call my_function whenever the Brain screen is released
brain.screen.released(my_function)