Scherm#

Invoering#

De scherminstellingen bepalen hoe de EXP Brain tekst, cijfers en afbeeldingen op het scherm weergeeft.

Standaard is het lettertype voor afdrukken naar de Brain monospaced small, met 7 rijen en 20 kolommen.

Voor het tekenen heeft de Brain een resolutie van 159 x 107 pixels.

Een gelabeld rasterdiagram van het VEX Brain-scherm met rijen, kolommen, pixelafmetingen en coördinaten, met rode lijnen die het raster omlijnen.

Hieronder vindt u een lijst met beschikbare methoden:

Cursor Print – Tekst weergeven en de printcursor beheren.

  • print – Drukt tekst, getallen of variabele waarden af ​​op de huidige cursorpositie.

  • print_at – Drukt tekst, getallen of variabele waarden af ​​op specifieke x- en y-coördinaten.

  • set_cursor – Verplaatst de cursor naar een specifieke rij en kolom.

  • set_origin – Stelt de oorsprong in die wordt gebruikt voor coördinatengebaseerd afdrukken en tekenen.

  • next_row – Verplaatst de cursor naar de volgende rij.

  • clear_row – Maakt een rij tekst leeg.

  • row – Geeft de rij terug waar de tekst wordt afgedrukt.

  • column – Geeft de kolom terug waar de tekst wordt afgedrukt.

  • 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.

Mutators – Wijzig scherminstellingen, kleuren en tekengedrag.

  • clear_screen – Verwijdert alle tekeningen en tekst van het Brain-scherm.

  • set_font – Stelt het lettertype in dat wordt gebruikt voor het afdrukken van tekst op het scherm van de Brain.

  • 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.

Tekenen – Maak vormen, lijnen en afbeeldingen op het Brain-scherm.

  • draw_pixel – Tekent één pixel op een coördinaat.

  • draw_line – Tekent een lijn tussen twee punten.

  • draw_rectangle – Tekent een rechthoek met de huidige pen- en vulkleuren.

  • draw_circle – Tekent een cirkel met de huidige pen- en vulkleuren.

  • draw_image_from_file – Tekent een afbeelding van de SD-kaart.

  • render – Schakelt het tekenen over naar dubbel gebufferd en geeft het scherm van de hersenen weer.

  • set_clip_region – Stelt het knipgebied in voor het tekenen van de opgegeven rechthoek.

Cursor Print#

print#

print print tekst, getallen of variabele waarden op het Brain-scherm op de huidige cursorpositie en in het huidige lettertype.

Gebruik:

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

Parameters

Beschrijving

text

De tekst, het getal of de variabele waarde die moet worden afgedrukt.

sep

Optioneel. Een tekenreeks die tussen de waarden wordt ingevoegd. Deze moet als trefwoordargument (sep=) worden geschreven. De standaardwaarde is “”.

precision

Optioneel. Het aantal decimalen dat moet worden weergegeven bij het afdrukken van eenvoudige getallen. Dit moet worden opgegeven als een sleutelwoordargument (precision=). De standaardwaarde is 2.

brain.screen.print("Hello, Robot!")

Een screenshot van de EXP Brain waarop "Hello Robot" op het scherm wordt weergegeven.

# Print the number 1 on the Brain's screen at current
# cursor position.
brain.screen.print(1)

# Print the numbers 1, 2, 3 and 4 on the Brain's screen at
# current cursor position separated by a '-'.
brain.screen.print(1, 2, 3, 4, sep='-')

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. De rij- en kolomafstand wordt aangepast aan het geselecteerde lettertype. De standaard cursorpositie is Rij 1, Kolom 1.

Gebruik:

brain.screen.set_cursor(row, column)

Parameters

Beschrijving

row

De rij waarnaar de cursor moet worden verplaatst.

column

De kolom waarnaar de cursor moet worden verplaatst.

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

Een screenshot van de EXP Brain waarop "R3, C10" op het scherm wordt weergegeven.

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

x

De x-positie van de oorsprong ten opzichte van de linkerbovenhoek, van 0 tot 159.

y

De y-positie van de oorsprong ten opzichte van de linkerbovenhoek, van 0 tot 107.

next_row#

next_row verplaatst de cursor naar kolom 1 op de volgende rij van het Brain-scherm.

Gebruik:

brain.screen.next_row()

Parameters

Beschrijving

Deze methode heeft geen parameters.

# Display two lines of text.
brain.screen.print("Line 1")
brain.screen.next_row()
brain.screen.print("Line 2")

Een screenshot van de EXP Brain waarop de tekst "3" op rij 3 te zien is.

clear_row#

clear_row wist één regel tekst op het Brain-scherm.

Gebruik:

brain.screen.clear_row(row)

Parameters

Beschrijving

row

Optioneel. De rij die moet worden gewist. Standaard is dit de huidige cursorrij.

color

Optioneel. Een geldig ColorType, een hexadecimale waarde of een webstring.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
U kunt ook een aangepaste kleur opgeven.

# Clear Brain's screen to black.
brain.screen.clear_row()

# Clear Brain's screen to blue using predefined color.
brain.screen.clear_row(2, Color.BLUE)

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, 10)
brain.screen.print(brain.screen.row())

Een screenshot van de EXP Brain waarop de tekst "3" op rij 3 te zien is.

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, 10)
brain.screen.print(brain.screen.column())

Een screenshot van de EXP Brain waarop de tekst "10" in kolom 10 te zien is.

get_string_width#

get_string_width retourneert de breedte van een tekenreeks in pixels als een geheel getal, gebruikmakend van het huidige font.

Gebruik:

brain.screen.get_string_width(string)

Parameters

Beschrijving

string

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.

Gebruik:

brain.screen.get_string_height(string)

Parameters

Beschrijving

string

Het touwtje om te meten.

Mutators#

clear_screen#

clear_screen wist alle tekeningen en tekst van het scherm van de hersenen.

Gebruik:

brain.screen.clear_screen(color)

Parameters

Beschrijving

color

Optioneel. Een geldig ColorType, een hexadecimale waarde of een webstring.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
U kunt ook een aangepaste kleur opgeven.

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

# Clear screen to black.
brain.screen.clear_screen()

# Print VEXcode on the Brain's 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(fontname)

Parameters

Beschrijving

fontname

The font size (examples below):

  • MONO12
  • MONO15
  • MONO20
  • MONO30
  • MONO40
  • MONO60
  • PROP20
  • PROP30
  • PROP40
  • PROP60
Note: Extra small and small sizes are not available for proportional fonts.

Het scherm van The Brain print cijfers en letters met lettergrootte MONO 12. Het toont de letters A tot en met Z en alle cijfers. Onderaan het scherm staat 9 rijen, 26 kolommen.
MONO12

Het scherm van The Brain toonde cijfers en letters in lettertypegrootte MONO 15. Het toonde de letters A tot en met T en alle cijfers. Onderaan het scherm stond: 7 rijen, 22 kolommen.
MONO15

Het scherm van The Brain print cijfers en letters met lettergrootte MONO 20. Het toont de letters A tot en met P en alle cijfers. Onderaan het scherm staat 5 rijen, 16 kolommen.
MONO20

Het scherm van The Brain print cijfers en letters met lettergrootte MONO 30. Het toont de letters A tot en met J. Onderaan het scherm staat R:3 C:10.
MONO30

De cijfers en letters op het scherm van The Brain zijn afgedrukt in lettertypegrootte MONO 40. Onderaan het scherm staat R:2 C:8.
MONO40

De cijfers en letters op het scherm van The Brain zijn afgedrukt met lettertypegrootte MONO 60. Alleen MON60 wordt weergegeven.
MONO60

Het scherm van The Brain toont cijfers en letters met lettergrootte PROP 20. Het toont de letters A tot en met W en alle cijfers. Onderaan het scherm staat 5 rijen, 16 kolommen.
PROP20

Het scherm van The Brain toont cijfers en letters met lettergrootte PROP 30. Het toont de letters A tot en met P. Onderaan het scherm staat R:3 C:10.
PROP30

De cijfers en letters op het scherm van The Brain zijn afgedrukt met lettertypegrootte PROP 40. Onderaan het scherm staat R:2 C:8.
PROP40

De cijfers en letters van The Brain zijn afgedrukt met lettertypegrootte PROP 60. Alleen PROP60 wordt weergegeven.
PROP60

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

Een screenshot van de EXP Brain waarop de tekst "VEX" in een groter lettertype dan standaard te zien is.

set_pen_width#

set_pen_width stelt de dikte in van getekende lijnen en vormcontouren.

Gebruik:

brain.screen.set_pen_width(width)

Parameters

Beschrijving

width

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(20, 20, 75, 50)

Een screenshot van de EXP Brain met een rechthoek met dikke randen.

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

color

De te gebruiken pen- en letterkleur. Dit kan een geldig ColorType, een hexadecimale waarde of een webstring zijn.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
U kunt ook een aangepaste kleur opgeven.

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

Een screenshot van de EXP Brain met een rechthoek met oranje randen.

# Set pen color red using a hex value.
brain.screen.set_pen_color(0xFF0000)

# Set pen color blue using predefined color.
brain.screen.set_pen_color(Color.BLUE)

# Set pen color green using web string.
brain.screen.set_pen_color("#00FF00")

set_fill_color#

set_fill_color stelt de vulkleur in die wordt gebruikt voor het tekenen van rechthoeken en cirkels.

Gebruik:

brain.screen.set_fill_color(color)

Parameters

Beschrijving

color

De opvulkleur die gebruikt moet worden. Dit kan een geldig ColorType, een hexadecimale waarde of een webstring zijn.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
U kunt ook een aangepaste kleur opgeven.

# Draw a purple rectangle.
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(20, 20, 75, 50)

Een screenshot van de EXP Brain met een rechthoek gevuld met paars.

# Set fill color red using a hex value.
brain.screen.set_fill_color(0xFF0000)

# Set fill color blue using predefined color.
brain.screen.set_fill_color(Color.BLUE)

# Set fill color green using web string.
brain.screen.set_fill_color("#00FF00")

Tekenen#

draw_pixel#

draw_pixel tekent één pixel op de geselecteerde x- en y-coördinaat met behulp van de huidige penkleur.

Gebruik:

brain.screen.draw_pixel(x, y)

Parameters

Beschrijving

x

De x-coördinaat om de pixel te tekenen, van 0 tot 159, ten opzichte van de oorsprong van het scherm.

y

De y-coördinaat om de pixel te tekenen, van 0 tot 107, ten opzichte van de oorsprong van het scherm.

# Draw the pixels marking the corners of a square.
brain.screen.draw_pixel(50, 50)
brain.screen.draw_pixel(50, 75)
brain.screen.draw_pixel(75, 50)
brain.screen.draw_pixel(75, 75)

Een screenshot van de EXP Brain met een verzameling pixels die de hoeken van een vierkant weergeven.

draw_line#

draw_line tekent een lijn van de eerste schermcoördinaat (x1, y1) naar de tweede schermcoördinaat (x2, y2) met behulp van de huidige penbreedte en penkleur.

Gebruik:

brain.screen.draw_line(x1, y1, x2, y2)

Parameters

Beschrijving

x1

De x-coördinaat in pixels van het begin van de lijn, van 0 tot 159, ten opzichte van de schermoorsprong.

y1

De y-coördinaat in pixels van het begin van de lijn, van 0 tot 107, ten opzichte van de schermoorsprong.

x2

De x-coördinaat in pixels van het einde van de lijn, van 0 tot 159, ten opzichte van de oorsprong van het scherm.

y2

De y-coördinaat in pixels van het einde van de lijn, van 0 tot 107, 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, 159, 107)

Het scherm van de hersenen toont een dunne diagonale lijn dwars door het midden, van de linkerbovenhoek naar de rechteronderhoek.

draw_rectangle#

draw_rectangle tekent een rechthoek met de huidige penbreedte, penkleur en vulkleur, tenzij de optionele color parameter wordt gebruikt.

Gebruik:

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

Parameters

Beschrijving

x

De x-coördinaat in pixels van de linkerbovenhoek van de rechthoek, van 0 tot 159, ten opzichte van de schermoorsprong.

y

De y-coördinaat in pixels van de linkerbovenhoek van de rechthoek, van 0 tot 107, ten opzichte van de schermoorsprong.

width

De breedte van de rechthoek.

height

De hoogte van de rechthoek.

color

Optioneel. Een geldig ColorType, een hexadecimale waarde of een webstring.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
U kunt ook een aangepaste kleur opgeven.

# Draw a rectangle on the screen.
brain.screen.draw_rectangle(20, 20, 80, 30)

Het scherm van de hersenen toont een rechthoek met een dunne witte rand.

# Draw a green rectangle on the screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_rectangle(10, 10, 20, 20)

# Draw a green rectangle on the screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_rectangle(50, 50, 20, 20, Color.RED)

draw_circle#

draw_circle tekent een cirkel met de huidige penbreedte, penkleur en vulkleur, tenzij de optionele color parameter wordt gebruikt.

Gebruik:

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

Parameters

Beschrijving

x

De x-coördinaat in pixels van het middelpunt van de cirkel, van 0 tot 159, ten opzichte van de oorsprong van het scherm.

y

De y-coördinaat in pixels van het middelpunt van de cirkel, van 0 tot 107, ten opzichte van de oorsprong van het scherm.

radius

De straal van de cirkel.

color

Optioneel. Een geldig ColorType, een hexadecimale waarde of een webstring.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
U kunt ook een aangepaste kleur opgeven.

# Draw a circle on the screen.
brain.screen.draw_circle(80, 50, 20)

Het scherm van de hersenen toont een cirkel met een dunne witte rand in het midden.

# Draw a green circle on the Brain's screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_circle(50, 50, 10)

# Draw a green circle on the Brain's screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_circle(100, 50, 10, Color.RED)

draw_image_from_file#

draw_image_from_file tekent een afbeelding van de SD-kaart. De bestandsnaam die je opgeeft bij het aanroepen van de methode moet op de SD-kaart staan.

Gebruik:

brain.screen.draw_image_from_file(filename, x, y)

Parameters

Beschrijving

filename

De bestandsnaam van de afbeelding.

x

De x-coördinaat van de linkerbovenhoek van de afbeelding op het scherm.

y

De y-coördinaat van de linkerbovenhoek van de afbeelding op het scherm.

# Draw the vex.bmp image on the Brain's screen at coordinate 0, 0.
brain.screen.draw_image_from_file('vex.bmp', 0, 0)

render#

render schakelt het tekenen over naar dubbel gebufferd en geeft het scherm van de Brain weer. Nadat deze functie is aangeroepen, zal er geen verder tekenen op het scherm van de Brain verschijnen totdat render de volgende keer wordt aangeroepen.

  • True als de buffer succesvol op het scherm is weergegeven.

  • False als de buffer niet succesvol op het scherm is weergegeven.

Gebruik:

brain.screen.render()

Parameters

Beschrijving

Deze methode heeft geen parameters.

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

x

De x-positie van de linkerbovenhoek van de rechthoek, ten opzichte van de schermoorsprong.

y

De y-positie van de linkerbovenhoek van de rechthoek, ten opzichte van de schermoorsprong.

width

De breedte van de rechthoek.

height

De hoogte van de rechthoek.