Skärm#

Introduktion#

Skärmblocken styr hur VEX AIM-kodningsroboten visar text, siffror och grafik på skärmen, och hur den reagerar på skärmtryckningar.

Nedan följer en lista över alla block:

Markörutskrift — Hantera textvisning med ett markörsystem med rader och kolumner.

XY-utskrift — Skriv ut text med pixelbaserade koordinater.

Inställningar — Anpassa textformatering och skärmvisning.

Rita — Skapa grafik och visuella element.

Pekskärm — Upptäck skärminteraktioner.

  • skärm nedtryckt — Rapporterar om skärmen trycks ned för närvarande.

  • skärmposition — Rapporterar den valda x- eller y-koordinaten för det senaste skärmtrycket.

  • vid skärmhändelse — Kör bifogade block när skärmen trycks ned eller släpps.

Markörutskrift#

placera markören på radkolumnen på skärmen#

Blocket ställ markören till rad/kolumn på skärmen flyttar markören till en specifik rad och kolumn på robotens skärm. Nästa block skriv ut på skärmen börjar skrivas ut på den platsen. Hur många rader och kolumner som bekvämt får plats beror på det valda teckensnittet. Med standardteckensnittet med fast radavstånd kan upp till 8 rader och 13 kolumner visas tydligt. Text som placeras utanför detta intervall kan bli avklippt eller svårläst.

Monospaced-teckensnitt har tecken som alla har samma bredd, vilket gör textplaceringen konsekvent. Däremot varierar proportionella teckensnitt i teckenbredd, så vissa bokstäver tar upp mer plats än andra. Oavsett vilken typ som används placerar dock stapelblocket ställ markören till rad/kolumn på skärmen markören baserat på rad- och kolumnstorlek, inte teckensnittsstil. Teckenstorleken kan justeras med stapelblocket ställ teckensnitt på skärmen.

Ställ in markörens stackblock#
ställ markör på rad [1] kolumn [1] på skärmen

Parametrar

Beskrivning

rad

Raden att flytta markören till.

kolumn

Kolumnen att flytta markören till.

Exempel

När den startas flyttas markören till rad 3, kolumn 2 på skärmen och ‘Rad 3, kolumn 2’ skrivs ut.#
när startad
[Display text starting at Row 3 Column 2.]
ställ markör på rad (3) kolumn (2) på skärmen
skriv ut [Row 3, Column 2] på skärmen ▶

En skärmdump av robotens skärm, med rad 3, kolumn 2 tryckt i vitt precis ovanför mitten av skärmen, med början på rad 3 kolumn 2.

när startad
[Display cargo amounts in an organized list.]
ställ in teckensnitt till [proportionell v] [stor v] på skärmen
skriv ut [Sports Balls] på skärmen ◀ och flytta markör till nästa rad
skriv ut [Orange Barrels] på skärmen ◀ och flytta markör till nästa rad
skriv ut [Blue Barrels] på skärmen ▶
ställ markör på rad [1] kolumn [11] på skärmen
skriv ut [2] på skärmen ▶
ställ markör på rad [2] kolumn [11] på skärmen
skriv ut [3] på skärmen ▶
ställ markör på rad [3] kolumn [11] på skärmen
skriv ut [3] på skärmen ▶

En skärmdump av robotens skärm visar tre rader vit text, som listar Sportbollar 2, Orangea tunnor 3 och Blå tunnor 3. Numren är justerade till höger om varje etikett, och listan börjar högst upp på skärmen.

när startad
[Display the ID of the detected AprilTag.]
ställ in teckensnitt till [proportionell v] [extra stor v] på skärmen
för alltid
rensa skärm
skriv ut [AprilTag] på skärmen ▶
hämta [alla AprilTags v]-data från AI Vision
om <AI Vision-objekt finns?> då
ställ markör på rad [3] kolumn [4] på skärmen
skriv ut (AI Vision-objekt [tagID v]) på skärmen ▶
avsluta
vänta [0.1] sekunder

En skärmdump av robotens skärm med vit text tryckt nära mitten, med AprilTag på första raden och 4 på andra raden.

placera markören på nästa rad på skärmen#

Stapelblocket ställ markören till nästa rad på skärmen flyttar markören till kolumn 1 på nästa rad på robotens skärm.

ställ markören till nästa radstapelblock#
flytta markör till nästa rad på skärmen

Parametrar

Beskrivning

Det här blocket har inga parametrar.

Exempel

När den startas skrivs ‘Rad 1’ ut på skärmen, markören flyttas till nästa rad och sedan skrivs ‘Rad 2’ ut.#
när startad
[Display two lines of text.]
skriv ut [Line 1] på skärmen ▶
flytta markör till nästa rad på skärmen
skriv ut [Line 2] på skärmen ▶

En skärmdump av robotens skärm med vit text. Skärmen visar rad 1 på den översta raden, vänsterjusterad, och rad 2 direkt nedanför.

rensa raden på skärmen#

Stackblocket rensa rad på skärmen rensar en enda textrad på robotens skärm.

Rensa radstackblock#
rensa rad [1] på skärmen

Parametrar

Beskrivning

rad

Radnumret som ska rensas.

Exempel

När programmet startas skrivs texten ut på två rader. Den första raden finns kvar, medan den andra raden försvinner efter 3 sekunder.#
när startad
[Display text on two rows.]
skriv ut [This text stays] på skärmen ▶
flytta markör till nästa rad på skärmen
skriv ut [This text disappears] på skärmen ▶
vänta [3] sekunder
rensa rad [2] på skärmen

skärmmarkörkolumn#

Reporterblocket skärmmarkörkolumn rapporterar kolumnnumret där texten kommer att skrivas ut som ett heltal.

skärmmarkörkolumnreporterblock#
(skärmmarkörkolumn)

Parametrar

Beskrivning

Det här blocket har inga parametrar.

Exempel

När den startas flyttas markören till rad 3, kolumn 2 på skärmen och markörens aktuella kolumnnummer skrivs ut.#
när startad
[Display the cursor's current column.]
ställ markör på rad [3] kolumn [2] på skärmen
skriv ut (skärmmarkörkolumn) på skärmen ▶

En skärmdump av robotens skärm, med en vit 2:a tryckt nära mitten av den övre vänstra kvadranten, på rad 3 kolumn 2.

skärmmarkörrad#

Reporterblocket skärmmarkörrad rapporterar radnumret där texten kommer att skrivas ut som ett heltal.

skärmmarkörrad reporterblock#
(skärmmarkörrad)

Parametrar

Beskrivning

Det här blocket har inga parametrar.

Exempel

När den startas flyttas markören till rad 6, kolumn 2 på skärmen och markörens aktuella radnummer skrivs ut.#
när startad
[Display the cursor's current row.]
ställ markör på rad [3] kolumn [2] på skärmen
skriv ut (skärmmarkörrad) på skärmen ▶

En skärmdump av robotens skärm, med en vit 3:a tryckt nära mitten av den övre vänstra kvadranten, på rad 3 kolumn 2.

XY-utskrift#

ange skärmens ursprung#

Stackblocket ställ in skärmorigo ändrar origo (0, 0) som används för att rita eller skriva ut på robotens skärm. Som standard är origo skärmens övre vänstra hörn. Detta block kan återställa origo till en alternativ (x, y) skärmkoordinatposition.

ange skärmursprungsstacksblock#
ställ in skärmens ursprung x: [0] y: [0]

Parametrar

Beskrivning

x

X-koordinaten i pixlar som ska anges som nytt origo.

y

Y-koordinaten i pixlar som ska anges som ny origo.

Exempel

När den startas, sätts skärmens origo till (120, 120) och en rektangel ritas vid den nya origo med övre vänstra hörnet vid (0,0), bredd 80 pixlar och höjd 40 pixlar.#
när startad
[Set the origin to the center of the screen.]
ställ in skärmens ursprung x: [120] y: [120]
[Draw a rectangle at the new origin.]
rita rektangel [0] [0] [80] [40] på skärmen

En skärmdump av robotens skärm med en vit rektangel ritad i den nedre vänstra kvadranten. Rektangelns övre vänstra hörn är skärmens mittpunkt.

Inställningar#

rensa skärmen#

Stackblocket rensa skärmen rensar alla ritningar och text från robotens skärm och återställer markörens position till rad 1, kolumn 1.

rensa skärmstackblocket#
rensa skärm

Parametrar

Beskrivning

Det här blocket har inga parametrar.

Exempel

När den startas ritas en cirkel med centrum (120,120) och radie 40 pixlar. Efter 2 sekunder rensas skärmen.#
när startad
[Draw a circle, and clear it after 2 seconds.]
rita cirkel [120] [120] [40] på skärmen
vänta [2] sekunder
rensa skärm

fyll skärm#

Stackblocket fyll skärm rensar alla teckningar och text från robotens skärm och ändrar sedan bakgrunden till en specificerad färg.

fyll skärm stapelblock#
fyll skärmen med [röd v]

Parametrar

Beskrivning

färg

Bakgrundsfärgen att använda:

  • röd
  • grön
  • blå
  • svart
  • vit
  • gul
  • orange
  • lila
  • cyan

Exempel

när startad
[Say "Hello" then turn screen yellow.]
skriv ut [Hello] på skärmen ▶
vänta [2] sekunder
fyll skärmen med [gul v]

ställ in teckensnitt på skärmen#

Stackblocket ställ in teckensnitt på skärmen anger teckensnittet och storleken som används för att visa text på robotens skärm. Detta teckensnitt kommer att gälla för all efterföljande text som skrivs ut.

ange teckensnittsblock#
ställ in teckensnitt till [monospace v] [superliten v] på skärmen

Parametrar

Beskrivning

typ

Typsnitt: monospaced eller proportional

storlek

Teckenstorleken (visas nedan):

  • superliten
  • extraliten
  • liten
  • mellan
  • stor
  • extra stor
  • superstor

En skärmdump av robotens skärm som visar ett urval av siffror och bokstäver tryckta i teckensnittet Mono 12. Alfabetet sträcker sig över 1 rad text. Nederdelen har 26 tecken bredd och 15 rader.
superliten med fast radavstånd

Samma bild som den föregående, med teckensnittet Mono 15. Bokstäverna AT sträcker sig över 1 rad text. Den nedre delen är 20 tecken bred och 12 rader bred.
extra liten med fast radavstånd

Samma bild som den föregående, med teckensnittet Mono 20. Bokstäverna AP sträcker sig över 1 rad text. Nederdelen är 16 tecken bred och 9 rader bred.
liten med fast radavstånd

Samma bild som den föregående, med teckensnittet Mono 24. Bokstäverna AM sträcker sig över 1 rad text. Nederdelen är 13 tecken bred och 8 rader bred.
monospaced medium

Samma bild som den föregående, med teckensnittet Mono 30. Bokstäverna AK sträcker sig över 1 rad text. Nederdelen är 11 tecken bred och 6 rader bred.
stor med fast radavstånd

Samma bild som den föregående, med teckensnittet Mono 40. Bokstäverna AH sträcker sig över 1 rad text. Nederkanten är 8 tecken bred och 5 rader bred.
extra stor med fast radavstånd

Samma bild som den föregående, med teckensnittet Mono 60. Siffrorna 1-6 sträcker sig över 1 rad text. Nederkanten visar 3 rader.
superstor med fast radavstånd

Samma bild som den föregående, med typsnittet Prop 20. Bokstäverna A sträcker sig över 1 rad text. Nederdelen är 20 tecken bred och 9 rader bred.
proportionell liten

Samma bild som den föregående, med typsnittet Prop 30. Bokstäverna AM sträcker sig över 1 rad text. Nederdelen är 15 tecken bred och 6 rader bred.
proportionell stor

Samma bild som den föregående, med typsnittet Prop 40. Bokstäverna AJ sträcker sig över 1 rad text. Nederdelen är 11 tecken bred och 5 rader bred.
proportionell extra stor

En skärmdump av robotens skärm som visar ett urval av siffror tryckta i typsnittet Prop 60. Siffrorna 1-7 sträcker sig över 1 rad text. Nederdelen är 7 gånger 3.
proportionell superstor

Exempel

När programmet startas, ställer det in teckensnittet till ‘monospaced extra large’ och skriver ut ‘VEX’ på skärmen.#
när startad
[Display text using a larger font]
ställ in teckensnitt till [monospace v] [extra stor v] på skärmen
skriv ut [VEX] på skärmen ▶

En skärmdump av robotens skärm visar ordet VEX i teckensnittet Mono 40 tryckt i vitt i det övre vänstra hörnet.

ställ in utskriftsprecision på skärmen#

Stackblocket ställ in utskriftsprecision på skärmen anger hur många decimaler som ska visas när siffror skrivs ut på robotens skärm. Denna utskriftsprecision gäller för alla efterföljande utskrivna siffror.

ställ in utskriftsprecisionsstapelblock#
ställ in utskriftsprecision till [0.1 v] på skärmen

Parametrar

Beskrivning

precision

Utskriftsnoggrannheten att använda:

  • 1
  • 0,1
  • 0,01
  • 0,001
  • Alla siffror

Exempel

När den startas ställs utskriftsprecisionen in på två decimaler och 1/3 skrivs ut som 0,33 på skärmen.#
när startad
[Print 1/3 as 0.33.]
ställ in utskriftsprecision till [0.01 v] på skärmen
skriv ut ([1] [math_division v] [3]) på skärmen ▶

En skärmdump av robotens skärm visar 0,33 i vitt i det övre vänstra hörnet.

ställ in pennbredd på skärmen#

Stapelblocket ställ in pennbredd på skärmen anger tjockleken på ritade linjer och formerkunder.

ställ in pennbreddstapelblock#
ställ in pennbredd till [10] på skärmen

Parametrar

Beskrivning

bredd

Pennans bredd, i pixlar, från 0 till 32.

Exempel

När den startas, ställs pennans bredd in på 10 pixlar och en rektangel ritas med det övre vänstra hörnet vid (50,50), bredd 130 pixlar och höjd 60 pixlar.#
när startad
[Draw a rectangle with a pen width of 10.]
ställ in pennbredd till [10] på skärmen
rita rektangel [50] [50] [130] [60] på skärmen

En skärmdump av robotens skärm med en tjock vit rektangel ritad över den övre halvan.

ställ in penn-/teckensnittsfärg på skärmen#

Stapelblocket ställ in penn-/teckensnittsfärg på skärmen anger färgen på text, pixlar, linjer och formerkunder.

ställ in penna/teckensnittsfärgstapelblock#
ställ in penn-/teckensnittsfärg till [röd v] på skärmen

Parametrar

Beskrivning

färg

Penn- och teckenfärg att använda:

  • röd
  • grön
  • blå
  • svart
  • vit
  • gul
  • orange
  • lila
  • cyan
  • transparent

Exempel

När den startas ställs pennfärgen in på röd och en rektangel ritas med det övre vänstra hörnet vid (50, 50), bredd 130 pixlar och höjd 60 pixlar.#
när startad
[Draw a rectangle with a red pen.]
ställ in penn-/teckensnittsfärg till [röd v] på skärmen
rita rektangel [50] [50] [130] [60] på skärmen

En skärmdump av robotens skärm med en röd rektangel med en tunn kantlinje ritad över den övre halvan.

ställ in fyllningsfärg på skärmen#

Stapelblocket ställ in fyllningsfärg på skärmen anger fyllningsfärgen som används när former ritas.

ange fyllningsfärgsstapelblock#
ställ in fyllnadsfärg till [röd v] på skärmen

Parametrar

Beskrivning

färg

Fyllningsfärgen som ska användas:

  • röd
  • grön
  • blå
  • svart
  • vit
  • gul
  • orange
  • lila
  • cyan
  • transparent

Exempel

När den startas, sätts fyllningsfärgen till orange och två rektanglar ritas. Den första är vid (50, 50), och den andra är vid (50, 130), båda med en bredd på 100 pixlar och en höjd på 60 pixlar.#
när startad
[Draw two orange rectangles.]
ställ in fyllnadsfärg till [orange v] på skärmen
rita rektangel [50] [50] [100] [60] på skärmen
rita rektangel [50] [130] [100] [60] på skärmen

En skärmdump av robotens skärm med två parallella orange rektanglar med tunna, vita konturer placerade till vänster i mitten av skärmen.


När den startas, ställer den in bakgrundsfärgen på lila och skriver ut ‘Markera’ på skärmen.#
när startad
[Display text with a purple background.]
ställ in fyllnadsfärg till [lila v] på skärmen
skriv ut [Highlight] på skärmen ▶

En skärmdump av robotens skärm visar "Markera" i vit text med en lila markering runtom, med början i det övre vänstra hörnet.

Dra#

visa bildfilen på skärmen#

Stackblocket visa bildfil på skärmen ritar en anpassad användaruppladdad bild på robotens skärm.

visa användarbildsstackblock#
visa bildfil [1 v]

Parametrar

Beskrivning

bildplatsnummer

Den anpassade bilden som ska användas, nummer 1 till 10. Bildnumret är i linje med numret som visas i AIM-kontrollpanelen.

Exempel

när startad
[Draw uploaded Image 1.]
visa bildfil [1 v]

rita pixlar på skärmen#

Stackblocket rita pixel på skärmen ritar en pixel vid den valda x- och y-koordinaten med hjälp av den aktuella pennfärgen.

Som standard är origo placerat i skärmens övre vänstra hörn vid (0, 0). På x-axeln är 0 på skärmens vänstra sida och 240 på höger sida. På y-axeln är 0 högst upp på skärmen och 240 längst ner. Du kan använda blocket set screen origin för att flytta origo till en annan plats. När origo ändras ändras även x- och y-koordinatintervallen.

Om till exempel origo är satt till (120, 120), kommer x- och y-intervallet att vara från -120 till 120 för x- och y-koordinaterna.

rita pixelstackblock#
rita pixel [0] [0] på skärmen

Parametrar

Beskrivning

x

X-koordinaten för att rita pixeln, från 0 till 240 med standardorigo.

y

Y-koordinaten för att rita pixeln, från 0 till 240 med standardorigo.

Exempel

När den startas, ritar en pixel i mitten av skärmen vid koordinaterna (120, 120).#
när startad
[Draw a pixel at the center of the screen.]
rita pixel [120] [120] på skärmen

En skärmdump av robotens skärm med en enda vit pixel i mitten.

rita en linje på skärmen#

Stackblocket rita linje på skärmen ritar en linje från den första skärmkoordinaten (x1, y1) till den andra skärmkoordinaten (x2, y2) med hjälp av aktuell pennbredd och pennfärg.

Som standard är origo placerat i skärmens övre vänstra hörn vid (0, 0). På x-axeln är 0 på skärmens vänstra sida och 240 på höger sida. På y-axeln är 0 högst upp på skärmen och 240 längst ner. Du kan använda blocket set screen origin för att flytta origo till en annan plats. När origo ändras ändras även x- och y-koordinatintervallen.

Om till exempel origo är satt till (120, 120), kommer x- och y-intervallet att vara från -120 till 120 för x- och y-koordinaterna.

rita linjestapelblock#
rita linje [0] [0] [10] [10] på skärmen

Parametrar

Beskrivning

x1

X-koordinaten i pixlar för raden börjar, från 0 till 240 med standardorigo.

år1

Y-koordinaten i pixlar för linjens början, från 0 till 240 med standardorigo.

x2

X-koordinaten i pixlar för slutet av linjen, från 0 till 240 med standardorigo.

y2

Y-koordinaten i pixlar för slutet av linjen, från 0 till 240 med standardorigo.

Exempel

När den startas, ritas en diagonal linje från skärmens övre vänstra hörn (0,0) till det nedre högra hörnet (240,240).#
när startad
[Draw a line from the top left to bottom right of the screen.]
rita linje [0] [0] [240] [240] på skärmen

En skärmdump av robotens skärm med en tunn vit diagonal linje dragen från det övre vänstra hörnet till det nedre högra hörnet.

rita rektangel på skärmen#

Stackblocket rita rektangel på skärmen ritar en rektangel med hjälp av aktuell pennbredd, pennfärg och fyllningsfärg.

Som standard är origo placerat i skärmens övre vänstra hörn vid (0, 0). På x-axeln är 0 på skärmens vänstra sida och 240 på höger sida. På y-axeln är 0 högst upp på skärmen och 240 längst ner. Du kan använda blocket set screen origin för att flytta origo till en annan plats. När origo ändras ändras även x- och y-koordinatintervallen.

Om till exempel origo är satt till (120, 120), kommer x- och y-intervallet att vara från -120 till 120 för x- och y-koordinaterna.

rita rektangelstapelblock#
rita rektangel [0] [0] [10] [10] på skärmen

Parametrar

Beskrivning

x

X-koordinaten i pixlar för rektangelns övre vänstra hörn, från 0 till 240 med standardorigo.

y

Y-koordinaten i pixlar för rektangelns övre vänstra hörn, från 0 till 240 med standardorigo.

bredd

Rektangelns bredd i pixlar.

höjd

Rektangelns höjd i pixlar.

Exempel

När den startas ritas en rektangel på skärmen med det övre vänstra hörnet vid (50,50), bredden 130 pixlar och höjden 60 pixlar.#
när startad
[Draw a rectangle on the screen.]
rita rektangel [50] [50] [130] [60] på skärmen

En skärmdump av robotens skärm med en vit rektangel ritad över den övre halvan.

rita en cirkel på skärmen#

Stapelblocket rita cirkel på skärmen ritar en cirkel med hjälp av aktuell pennbredd, pennfärg och fyllningsfärg.

Som standard är origo placerat i skärmens övre vänstra hörn vid (0, 0). På x-axeln är 0 på skärmens vänstra sida och 240 på höger sida. På y-axeln är 0 högst upp på skärmen och 240 längst ner. Du kan använda blocket set screen origin för att flytta origo till en annan plats. När origo ändras ändras även x- och y-koordinatintervallen.

Om till exempel origo är satt till (120, 120), kommer x- och y-intervallet att vara från -120 till 120 för x- och y-koordinaterna.

rita cirkelstapelblock#
rita cirkel [0] [0] [10] på skärmen

Parametrar

Beskrivning

x

X-koordinaten i pixlar för cirkelns centrum, från 0 till 240 med standardorigo.

y

Y-koordinaten i pixlar för cirkelns centrum, från 0 till 240 med standardorigo.

radie

Cirkelns radie i pixlar.

Exempel

När den startas ritas en cirkel på skärmen med mittpunkten vid (120,120) och en radie på 40 pixlar.#
när startad
[Draw a circle on the screen.]
rita cirkel [120] [120] [40] på skärmen

En skärmdump av robotens skärm med en vit cirkel ritad i mitten.

Röra#

skärmtryckt#

Det booleska blocket skärm nedtryckt rapporterar om robotens skärm trycks ned för närvarande.

  • Sant — Skärmen trycks ner.

  • Falskt — Skärmen trycks inte.

skärmtryckt booleskt block#
<skärm tryckt?>

Parametrar

Beskrivning

Det här blocket har inga parametrar.

Exempel

Kontrollerar kontinuerligt om skärmen trycks ner vid start. Om den trycks ner blir alla lysdioder vita; annars förblir de släckta.#
när startad
[Turn LEDs white only when the screen is pressed.]
för alltid
om <skärm tryckt?> då
ställ in [lightall v] LED-färg till [vit v]
annars
ställ in [lightall v] LED-färg till [av v]
avsluta
avsluta

skärmposition#

Blocket skärmposition rapporterar den valda koordinaten för det senaste skärmtrycket. X-koordinaten är från 0 (vänster) till 240 (höger). Y-koordinaten är från 0 (överst) till 240 (nederst).

skärmpositionsreporterblock#
(skärm [x v] position)

Parametrar

Beskrivning

samordna

Koordinaten för den senaste skärmen som trycktes för att rapportera: x rapporterar den horisontella positionen och y rapporterar den vertikala positionen.

Exempel

När den startas kontrolleras kontinuerligt om det finns några skärmtryckningar. Om den trycks ner rensas skärmen och x- och y-koordinaterna för pekpositionen skrivs ut.#
när startad
[Display the x and y coordinate of where the screen is pressed.]
för alltid
om <skärm tryckt?> då
rensa skärm
skriv ut (skärm [x v] position) på skärmen ▶
flytta markör till nästa rad på skärmen
skriv ut (skärm [y v] position) på skärmen ▶
avsluta
avsluta

när skärmhändelse#

Händelsen when screen kör den bifogade stapeln av block när robotens skärm trycks ned eller släpps.

när skärmhändelsehattblock#
när skärmen [tryckt v]

Parametrar

Beskrivning

handling

När den bifogade blockstapeln ska köras: tryckt körs när skärmen trycks ner och släppt körs när skärmen släpps.

Exempel

När skärmen trycks ned lyser alla lysdioder grönt.#
när skärmen [tryckt v]
[Set the LEDs to green when the screen is pressed.]
ställ in [lightall v] LED-färg till [grön v]