Οθόνη

Εισαγωγή

Η κλάση screen προέρχεται από την βασική κλάση brain. Ελέγχει τον τρόπο με τον οποίο το EXP Brain εμφανίζει κείμενο, αριθμούς και γραφικά στην οθόνη του.

Η οθόνη του EXP Brain έχει έναν καθορισμένο αριθμό γραμμών και στηλών που μπορούν να χρησιμοποιηθούν κατά την εκτύπωση κειμένου στην οθόνη της.

Από προεπιλογή, η γραμματοσειρά για εκτύπωση στο Brain είναι mono20 , η οποία έχει 7 γραμμές και 20 στήλες.

Για το σχέδιο, η ανάλυση του Brain είναι 159 x 107 pixel.

Πρόσβαση

Η πρόσβαση στην κλάση screen είναι δυνατή μέσω:

Brain.Screen

Σημειώσεις

• Το αντικείμενο screen παρέχεται από τον Εγκέφαλο. Δεν κατασκευάζεται απευθείας.

• Τα έργα χρησιμοποιούν ένα μόνο καθολικό αντικείμενο Brain , επομένως οι συναρτήσεις οθόνης καλούνται χρησιμοποιώντας το Brain.Screen.

Παράδειγμα

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the EXP Brain
brain Brain = brain();

// Print text to the Brain screen
Brain.Screen.print("Hello!");

Συναρτήσεις Μελών

Η κλάση screen περιλαμβάνει τις ακόλουθες συναρτήσεις-μέλη:

• print — Εκτυπώνει μορφοποιημένο κείμενο, αριθμούς ή λογικές τιμές στην οθόνη Brain.

• setCursor — Μετακινεί τον κέρσορα κειμένου σε μια καθορισμένη γραμμή και στήλη.

• newLine — Διαγράφει το υπόλοιπο της τρέχουσας γραμμής και μετακινεί τον κέρσορα στην επόμενη γραμμή.

• clearLine — Διαγράφει το υπόλοιπο της τρέχουσας γραμμής ή διαγράφει μια συγκεκριμένη γραμμή.

• row — Επιστρέφει τη γραμμή όπου θα εκτυπωθεί το κείμενο.

• column — Επιστρέφει τη στήλη όπου θα εκτυπωθεί το κείμενο.

• getStringHeight — Επιστρέφει το ύψος μιας συμβολοσειράς σε pixel χρησιμοποιώντας την τρέχουσα γραμματοσειρά.

• getStringWidth — Επιστρέφει το πλάτος μιας συμβολοσειράς σε pixel χρησιμοποιώντας την τρέχουσα γραμματοσειρά.

• printAt — Εκτυπώνει μορφοποιημένο κείμενο σε μια θέση εικονοστοιχείου x, y (προαιρετικά αδιαφανές).

• clearScreen — Καθαρίζει ολόκληρη την οθόνη (προαιρετικά σε ένα καθορισμένο χρώμα).

• setFont — Ορίζει τη γραμματοσειρά που χρησιμοποιείται για την εκτύπωση στην οθόνη.

• setPenWidth — Ορίζει το πάχος των γραμμών που έχουν σχεδιαστεί και των περιγραμμάτων των σχημάτων.

• setPenColor — Ορίζει το χρώμα κειμένου, pixel, γραμμών και περιγραμμάτων σχήματος.

• setFillColor — Ορίζει το χρώμα γεμίσματος για τα σχεδιασμένα σχήματα και τα φόντα εκτυπωμένου κειμένου.

• setOrigin — Ορίζει την αρχή που χρησιμοποιείται για τις συντεταγμένες της οθόνης.

• setClipRegion — Περιορίζει την έξοδο της οθόνης σε μια ορθογώνια περιοχή.

• drawPixel — Σχεδιάζει ένα pixel σε μια συντεταγμένη.

• drawLine — Σχεδιάζει μια γραμμή μεταξύ δύο σημείων.

• drawRectangle — Σχεδιάζει ένα ορθογώνιο σε μια θέση x, y με ένα καθορισμένο μέγεθος.

• drawCircle — Σχεδιάζει έναν κύκλο σε μια θέση x, y με καθορισμένη ακτίνα.

• drawImageFromFile — Σχεδιάζει μια εικόνα από ένα αρχείο κάρτας SD στην οθόνη.

• render — Ενεργοποιεί τη διπλή προσωρινή αποθήκευση ή αποδίδει την προσωρινή αποθήκευση στην οθόνη.

Πριν από την κλήση οποιασδήποτε συνάρτησης μέλους screen , πρέπει να δημιουργηθεί μια παρουσία brain , όπως φαίνεται παρακάτω:

// Create the EXP Brain
brain Brain = brain();

print

Εμφανίζει κείμενο, αριθμούς ή λογικές τιμές στην οθόνη EXP Brain.

Available Functions

1 — Εκτυπώνει μορφοποιημένο κείμενο χρησιμοποιώντας κυριολεκτικές συμβολοσειρές ή συμβολοσειρές τύπου C μόνο για ανάγνωση.

void print(
    const char* format,
    ... );

2 — Εκτυπώνει μορφοποιημένο κείμενο χρησιμοποιώντας τροποποιήσιμους πίνακες χαρακτήρων.

void print(
    char* format,
    ... );

Parameters

Παράμετρος	Τύπος	Περιγραφή
format	const char*	Μια συμβολοσειρά μορφοποίησης που παρέχεται ως κυριολεκτική συμβολοσειρά ή συμβολοσειρά τύπου C μόνο για ανάγνωση (για παράδειγμα, “Score: %d”).
format	char*	Μια συμβολοσειρά μορφοποίησης που παρέχεται ως τροποποιήσιμος πίνακας χαρακτήρων.
…		Μία ή περισσότερες πρόσθετες τιμές που εισάγονται στη συμβολοσειρά μορφοποίησης, διαχωρισμένες με κόμματα.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Output begins at the current cursor position on the screen.

• Το τυπωμένο κείμενο χρησιμοποιεί την τρέχουσα γραμματοσειρά οθόνης .

• Το εκτυπωμένο κείμενο χρησιμοποιεί το τρέχον χρώμα πένας .

• Το κείμενο που εκτυπώνεται με print εκτυπώνεται πάντα με φόντο και το χρώμα φόντου καθορίζεται από το τρέχον χρώμα γεμίσματος .

• Όταν χρησιμοποιείτε μια συμβολοσειρά μορφοποίησης, ο αριθμός και οι τύποι των τιμών που διαβιβάζονται πρέπει να ταιριάζουν με τους προσδιοριστές μορφής στη συμβολοσειρά.

Examples

// Display a message at the starting cursor
Brain.Screen.print("Hello, Robot!");

setCursor

Μετακινεί τον κέρσορα σε μια συγκεκριμένη γραμμή και στήλη στην οθόνη EXP Brain. Η επόμενη κλήση print θα ξεκινήσει την εκτύπωση σε αυτήν την τοποθεσία.

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

Παράμετρος	Τύπος	Περιγραφή
row	int32_t	Η γραμμή στην οποία θα μετακινηθεί ο κέρσορας.
col	int32_t	Η στήλη στην οποία θα μετακινηθεί ο κέρσορας.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Επηρεάζει την έναρξη της επακόλουθης εξόδου κειμένου όταν χρησιμοποιείται print.

• Οι γραμμές και οι στήλες βασίζονται στην τρέχουσα γραμματοσειρά οθόνης.

• Η προεπιλεγμένη γραμματοσειρά (mono20) χρησιμοποιεί 12 γραμμές και 48 στήλες.

• Η κλήση του setCursor επηρεάζει μόνο τη θέση του επόμενου κειμένου που εμφανίζεται.

Examples

// Display text starting at Row 3 Column 10
Brain.Screen.setCursor(3, 10);
Brain.Screen.print("R3, C10");

newLine

Μετακινεί τον κέρσορα στην αρχή της επόμενης γραμμής στην οθόνη Brain.

Available Functions

void newLine();

Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Εάν ο δρομέας βρίσκεται στη μέση μιας πρότασης, η εντολή newLine θα διαγράψει την υπόλοιπη γραμμή μετά τον δρομέα πριν μετακινηθεί στην επόμενη γραμμή.

• Μετά την κλήση της εντολής newLine, ο κέρσορας τοποθετείται στην πρώτη στήλη της επόμενης γραμμής.

• Η θέση του δρομέα και η αρίθμηση γραμμών ορίζονται χρησιμοποιώντας setCursor.

Examples

// Display two lines of text
Brain.Screen.print("Line 1");
Brain.Screen.newLine();
Brain.Screen.print("Line 2");

clearLine

Διαγράφει κείμενο από μια σειρά στην οθόνη EXP Brain.

Available Functions

1 — Διαγράφει το υπόλοιπο της τρέχουσας γραμμής από τη θέση του κέρσορα.

void clearLine();

2 — Διαγράφει την καθορισμένη γραμμή χρησιμοποιώντας το τρέχον διαμορφωμένο χρώμα γεμίσματος.

void clearLine(
    int number );

3 — Διαγράφει την καθορισμένη γραμμή χρησιμοποιώντας ένα προκαθορισμένο ή προσαρμοσμένο χρώμα αντικείμενο.

void clearLine(
    int          number,
    const color& color );

4 — Διαγράφει την καθορισμένη γραμμή χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος.

void clearLine(
    int         number,
    const char* color );

5 — Διαγράφει την καθορισμένη γραμμή χρησιμοποιώντας μια τιμή απόχρωσης.

void clearLine(
    int number,
    int hue );

Parameters

Παράμετρος	Τύπος	Περιγραφή
number	int	Ο αριθμός γραμμής που θα διαγραφεί. Η αρίθμηση γραμμών ξεκινά από 1.
color	const color&	Clears the row using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Καθαρίζει τη γραμμή χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος (για παράδειγμα, “#000000”).
hue	int	Καθαρίζει τη γραμμή χρησιμοποιώντας μια ακέραια τιμή απόχρωσης στην περιοχή 0–359, που αντιπροσωπεύει μοίρες γύρω από έναν χρωματικό τροχό.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Η διαγραφή μιας γραμμής δεν αλλάζει την τρέχουσα θέση του κέρσορα.

• Η θέση του δρομέα και η αρίθμηση γραμμών ορίζονται χρησιμοποιώντας setCursor.

• Η τιμή της παραμέτρου hue βασίζεται σε έναν κυκλικό χρωματικό τροχό, όπως φαίνεται παρακάτω, όπου οι τιμές αντιπροσωπεύουν μοίρες γύρω από τον τροχό (για παράδειγμα, κόκκινο κοντά στις 0°, πράσινο κοντά στις 120° και μπλε κοντά στις 240°).

Examples

// Display text on two rows
Brain.Screen.print("This text stays");
Brain.Screen.newLine();
Brain.Screen.print("This disappears");

// Wait 3 seconds before clearing row 2
wait(3, seconds);
Brain.Screen.clearLine(2);

row

Επιστρέφει τη γραμμή όπου θα εκτυπωθεί το κείμενο στην οθόνη EXP Brain.

Available Functions

int32_t row();

Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει τη γραμμή όπου θα εκτυπωθεί το κείμενο.

Η αρίθμηση γραμμών ξεκινά από το 1.

Notes

• Η θέση του κέρσορα βασίζεται στην τρέχουσα γραμματοσειρά οθόνης .

• Η επιστρεφόμενη τιμή υποδεικνύει πού θα εμφανιστεί η επόμενη εκτυπωμένη έξοδος.

• Η τιμή της γραμμής αλλάζει όταν εκτυπώνεται κείμενο ή όταν καλείται η συνάρτηση setCursor.

Examples

// Display the cursor's current row
Brain.Screen.setCursor(3, 10);
Brain.Screen.print(Brain.Screen.row());

column

Επιστρέφει τη στήλη όπου θα εκτυπωθεί το κείμενο στην οθόνη EXP Brain.

Available Functions

int32_t column();

Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει τη στήλη όπου θα εκτυπωθεί το κείμενο.

Η αρίθμηση στηλών ξεκινά από το 1.

Notes

• Η θέση του κέρσορα βασίζεται στην τρέχουσα γραμματοσειρά οθόνης .

• Η επιστρεφόμενη τιμή υποδεικνύει πού θα εμφανιστεί η επόμενη εκτυπωμένη έξοδος.

• Η τιμή της στήλης αλλάζει όταν εκτυπώνεται κείμενο ή όταν καλείται η συνάρτηση setCursor.

Examples

// Display the cursor's current column
Brain.Screen.setCursor(3, 10);
Brain.Screen.print(Brain.Screen.column());

getStringHeight

Επιστρέφει το ύψος, σε pixel, μιας συμβολοσειράς όταν αποδίδεται στην οθόνη EXP Brain.

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

Παράμετρος	Τύπος	Περιγραφή
cstr	const char*	Το κείμενο που θα μετρηθεί, παρέχεται ως συμβολοσειρά τύπου C (για παράδειγμα, “Hello”).

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει το ύψος της συμβολοσειράς σε pixel όταν αποδίδεται στην οθόνη Brain.

Notes

• Το επιστρεφόμενο ύψος εξαρτάται από την τρέχουσα επιλεγμένη γραμματοσειρά οθόνης .

• Αυτή η συνάρτηση μετρά τη συμβολοσειρά χωρίς να την απεικονίζει στην οθόνη.

• Το επιστρεφόμενο ύψος αντικατοπτρίζει τον τρόπο με τον οποίο θα εμφανιζόταν η συμβολοσειρά κατά την εκτύπωση.

getStringWidth

Επιστρέφει το πλάτος, σε pixel, μιας συμβολοσειράς όταν αποδίδεται στην οθόνη EXP Brain.

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

Παράμετρος	Τύπος	Περιγραφή
cstr	const char*	Το κείμενο που θα μετρηθεί, παρέχεται ως συμβολοσειρά τύπου C (για παράδειγμα, “Hello”).

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει το πλάτος της συμβολοσειράς σε pixel όταν αποδίδεται στην οθόνη Brain.

Notes

• The returned width depends on the currently selected screen font.

• Αυτή η συνάρτηση μετρά τη συμβολοσειρά χωρίς να την απεικονίζει στην οθόνη.

• Το επιστρεφόμενο πλάτος αντικατοπτρίζει τον τρόπο με τον οποίο θα εμφανιζόταν η συμβολοσειρά κατά την εκτύπωση.

printAt

Εκτυπώνει κείμενο, αριθμούς ή λογικές τιμές σε μια συγκεκριμένη συντεταγμένη στην οθόνη EXP Brain.

Available Functions

1 — Εκτυπώνει τη μορφοποιημένη έξοδο στην καθορισμένη θέση pixel.

void printAt(
    int32_t    x,
    int32_t    y,
    const char* format,
    ... );

2 — Εκτυπώνει τη μορφοποιημένη έξοδο στην καθορισμένη θέση pixel και ορίζει εάν το φόντο κειμένου είναι αδιαφανές ή διαφανές.

void printAt(
    int32_t    x,
    int32_t    y,
    bool       bOpaque,
    const char* format,
    ... );

Parameters

Παράμετρος	Τύπος	Περιγραφή
x	int32_t	Η θέση x για εκτύπωση, με αναφορά στην αρχή της οθόνης.
y	int32_t	Η θέση y για εκτύπωση, με αναφορά στην αρχή της οθόνης.
bOpaque	bool	Ελέγχει εάν το εκτυπωμένο κείμενο σχεδιάζεται αδιαφανώς ή διαφανώς: true — Το φόντο του εκτυπωμένου κειμένου γεμίζεται χρησιμοποιώντας το τρέχον χρώμα γεμίσματος. false — Το κείμενο σχεδιάζεται διαφανώς και το φόντο δεν γεμίζεται.
format	const char*	Μια συμβολοσειρά μορφοποίησης που ελέγχει τι εκτυπώνεται στην οθόνη (για παράδειγμα, “Score: %d”).
…		Μία ή περισσότερες πρόσθετες τιμές που εισάγονται στη συμβολοσειρά μορφοποίησης, διαχωρισμένες με κόμματα.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• Το τυπωμένο κείμενο χρησιμοποιεί την τρέχουσα γραμματοσειρά οθόνης .

• Το εκτυπωμένο κείμενο χρησιμοποιεί το τρέχον χρώμα πένας .

• Όταν χρησιμοποιείτε μια συμβολοσειρά μορφοποίησης, ο αριθμός και οι τύποι των τιμών που διαβιβάζονται πρέπει να ταιριάζουν με τους προσδιοριστές μορφής στη συμβολοσειρά.

Examples

// Print the number 1 at pixel (100, 40)
Brain.Screen.printAt(100, 40, "1");

clearScreen

Διαγράφει όλα τα σχέδια και το κείμενο από την οθόνη του Εγκεφάλου.

Available Functions

1 — Μαυρίζει την οθόνη.

void clearScreen();

2 — Καθαρίζει την οθόνη χρησιμοποιώντας ένα προκαθορισμένο ή προσαρμοσμένο χρώμα αντικείμενο.

void clearScreen(
    const color& color );

3 — Καθαρίζει την οθόνη χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος.

void clearScreen(
    const char* color );

4 — Καθαρίζει την οθόνη χρησιμοποιώντας μια τιμή απόχρωσης.

void clearScreen(
    int hue );

Parameters

Παράμετρος	Τύπος	Περιγραφή
color	const color&	Clears the screen using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Καθαρίζει την οθόνη χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος που αναπαρίσταται ως συμβολοσειρά (για παράδειγμα, “#000000”).
hue	int	Καθαρίζει την οθόνη χρησιμοποιώντας μια ακέραια τιμή απόχρωσης στην περιοχή 0–359, που αντιπροσωπεύει μοίρες γύρω από έναν χρωματικό κύκλο.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Η τιμή της παραμέτρου hue βασίζεται σε έναν κυκλικό χρωματικό τροχό, όπως φαίνεται παρακάτω, όπου οι τιμές αντιπροσωπεύουν μοίρες γύρω από τον τροχό (για παράδειγμα, κόκκινο κοντά στις 0°, πράσινο κοντά στις 120° και μπλε κοντά στις 240°).

Examples

// Clear screen after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen();

---

// Clear screen to blue after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen(blue);

setFont

Ορίζει τη γραμματοσειρά που χρησιμοποιείται για το κείμενο που εμφανίζεται στην οθόνη EXP Brain.

Αυτό ελέγχει τη γραμματοσειρά που εφαρμόζεται στην επακόλουθη έξοδο κειμένου όταν χρησιμοποιούνται συναρτήσεις κειμένου οθόνης όπως print.

Available Functions

void setFont(
  fontType font );

Parameters

Παράμετρος	Τύπος	Περιγραφή
font	fontType	Ορίζει τη γραμματοσειρά σε μία από τις ακόλουθες ρυθμίσεις: mono12 mono15 mono20 mono30 mono40 mono60 prop20 prop30 prop40 prop60 Αυτές οι επιλογές εμφανίζονται παρακάτω.

mono12	mono15	mono20
mono30	mono40	mono60
prop20	prop30	prop40
prop60

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Examples

// Print larger text
Brain.Screen.setFont(mono40);
Brain.Screen.print("VEX");

setPenWidth

Ορίζει το πάχος των γραμμών που σχεδιάζονται και των περιγραμμάτων σχήματος.

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

Παράμετρος	Τύπος	Περιγραφή
width	uint32_t	Το πλάτος της πένας σε pixel ως εύρος από 0 έως 32.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Το πλάτος της πένας εφαρμόζεται σε συναρτήσεις σχεδίασης όπως drawLine, drawRectangle και drawCircle.

Examples

// Draw a rectangle with a pen width of 10
Brain.Screen.setPenWidth(10);
Brain.Screen.drawRectangle(20, 20, 75, 50);

setPenColor

Ορίζει το χρώμα της πένας που χρησιμοποιείται για τη σχεδίαση γραμμών, σχημάτων και κειμένου.

Available Functions

1 — Ορίζει το χρώμα της πένας χρησιμοποιώντας ένα προκαθορισμένο ή προσαρμοσμένο χρώμα αντικείμενο.

void setPenColor(
    const color& color );

2 — Ορίζει το χρώμα της πένας χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος.

void setPenColor(
    const char* color );

3 — Ορίζει το χρώμα της πένας χρησιμοποιώντας μια τιμή απόχρωσης.

void setPenColor(
    int hue );

Parameters

Παράμετρος	Τύπος	Περιγραφή
color	const color&	Ορίζει το χρώμα της πένας χρησιμοποιώντας ένα αντικείμενο color Τα προκαθορισμένα χρώματα περιλαμβάνουν: black white red green blue yellow orange purple cyan transparent Αυτό μπορεί επίσης να χρησιμοποιήσει ένα αντικείμενο προσαρμοσμένου χρώματος.
color	const char*	Ορίζει το χρώμα της πένας χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος που αναπαρίσταται ως συμβολοσειρά (για παράδειγμα, “#FF0000”).
hue	int	Ορίζει το χρώμα της πένας χρησιμοποιώντας μια ακέραια τιμή απόχρωσης στην περιοχή 0–359, που αντιπροσωπεύει μοίρες γύρω από έναν χρωματικό κύκλο (για παράδειγμα, 0 είναι κόκκινο, 120 είναι πράσινο και 240 είναι μπλε).

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Το προεπιλεγμένο χρώμα πένας στην αρχή ενός έργου είναι white.

• Το χρώμα της πένας χρησιμοποιείται για περιγράμματα σχημάτων (όπως με drawCircle ή drawRectangle), κείμενο και αριθμητική έξοδο (με print και printAt), και μεμονωμένα pixel που σχεδιάζονται με drawPixel.

• Η τιμή της παραμέτρου hue βασίζεται σε έναν κυκλικό χρωματικό τροχό, όπως φαίνεται παρακάτω, όπου οι τιμές αντιπροσωπεύουν μοίρες γύρω από τον τροχό (για παράδειγμα, κόκκινο κοντά στις 0°, πράσινο κοντά στις 120° και μπλε κοντά στις 240°).

Examples

// Draw a rectangle with orange borders
Brain.Screen.setPenColor(orange);
Brain.Screen.drawRectangle(20, 20, 75, 50);

setFillColor

Ορίζει το χρώμα γεμίσματος που χρησιμοποιείται κατά τη σχεδίαση σχημάτων.

Available Functions

1 — Ορίζει το χρώμα γεμίσματος χρησιμοποιώντας ένα προκαθορισμένο ή προσαρμοσμένο χρώμα αντικείμενο.

void setFillColor(
    const color& color );

2 — Ορίζει το χρώμα γεμίσματος χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος.

void setFillColor(
    const char* color );

3 — Ορίζει το χρώμα γεμίσματος χρησιμοποιώντας μια τιμή απόχρωσης.

void setFillColor(
    int hue );

Parameters

Παράμετρος	Τύπος	Περιγραφή
color	const color&	Ορίζει το χρώμα γεμίσματος χρησιμοποιώντας ένα αντικείμενο color Τα προκαθορισμένα χρώματα περιλαμβάνουν: black white red green blue yellow orange purple cyan transparent Αυτό μπορεί επίσης να χρησιμοποιήσει ένα αντικείμενο προσαρμοσμένου χρώματος.
color	const char*	Ορίζει το χρώμα γεμίσματος χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος που αναπαρίσταται ως συμβολοσειρά (για παράδειγμα, “#00FF00”).
hue	int	Ορίζει το χρώμα γεμίσματος χρησιμοποιώντας μια ακέραια τιμή απόχρωσης στην περιοχή 0–359, που αντιπροσωπεύει μοίρες γύρω από έναν χρωματικό κύκλο (για παράδειγμα, 0 είναι κόκκινο, 120 είναι πράσινο και 240 είναι μπλε).

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Το προεπιλεγμένο χρώμα γεμίσματος στην αρχή ενός έργου είναι black.

• Το χρώμα γεμίσματος χρησιμοποιείται για το εσωτερικό των σχημάτων (όπως με drawCircle ή drawRectangle).

• Το χρώμα γεμίσματος χρησιμοποιείται ως χρώμα φόντου για εκτυπωμένο κείμενο (όπως με τις συναρτήσεις print και printAt).

  • Εάν χρησιμοποιηθεί transparent με τυπωμένο κείμενο, το φόντο θα είναι black.

• Η τιμή της παραμέτρου hue βασίζεται σε έναν κυκλικό χρωματικό τροχό, όπως φαίνεται παρακάτω, όπου οι τιμές αντιπροσωπεύουν μοίρες γύρω από τον τροχό (για παράδειγμα, κόκκινο κοντά στις 0°, πράσινο κοντά στις 120° και μπλε κοντά στις 240°).

Examples

// Draw a rectangle filled with purple
  Brain.Screen.setFillColor(purple);
  Brain.Screen.drawRectangle(20, 20, 75, 50);

setOrigin

Ορίζει την προέλευση που χρησιμοποιείται για τη σχεδίαση γραφικών στην οθόνη του εγκεφάλου.

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

Παράμετρος	Τύπος	Περιγραφή
x	int32_t	Η θέση x της αρχής των αξόνων σε σχέση με την επάνω αριστερή γωνία της οθόνης του εγκεφάλου από 0 έως 159.
y	int32_t	Η θέση y της αρχής των αξόνων σε σχέση με την επάνω αριστερή γωνία της οθόνης του εγκεφάλου από 0 έως 107.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Η προεπιλεγμένη αρχή είναι η επάνω αριστερή γωνία της οθόνης στη συντεταγμένη (0, 0).

• Η αρχή των αξόνων ισχύει για συναρτήσεις συντεταγμένων όπως drawLine, drawRectangle, drawCircle και printAt.

• Η προέλευση παραμένει σε ισχύ μέχρι να αλλάξει ξανά ή να γίνει επαναφορά του έργου.

setClipRegion

Ορίζει μια ορθογώνια περιοχή στην οθόνη όπου θα περιορίζονται όλα τα σχέδια και το κείμενο. Δεν θα εμφανίζεται κανένα περιεχόμενο εκτός αυτής της περιοχής.

Available Functions

void setClipRegion(
  int x,
  int y,
  int width,
  int height );

Parameters

Παράμετρος	Τύπος	Περιγραφή
x	int	Η συντεταγμένη x της επάνω αριστερής γωνίας της περιοχής αποκοπής, που δίνεται ως ακέραιος αριθμός από 0 έως 159.
y	int	Η συντεταγμένη y της επάνω αριστερής γωνίας της περιοχής αποκοπής, που δίνεται ως ακέραιος αριθμός από 0 έως 107.
width	int	Το πλάτος της περιοχής κλιπ σε pixel, που δίνεται ως ακέραιος αριθμός από 0 έως 159.
height	int	Το ύψος της περιοχής κλιπ σε pixel, που δίνεται ως ακέραιος αριθμός από 0 έως 107.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Οι συναρτήσεις σχεδίασης εξακολουθούν να εκτελούνται ακόμη και αν βρίσκονται εκτός της περιοχής κλιπ, αλλά μόνο το τμήμα εντός της περιοχής είναι ορατό.

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• Η περιοχή αποκοπής ισχύει μόνο για το τρέχον νήμα.

• Ο ορισμός μιας νέας περιοχής κλιπ αντικαθιστά οποιαδήποτε προηγουμένως ορισμένη περιοχή κλιπ για το τρέχον νήμα.

Examples

drawPixel

Σχεδιάζει ένα pixel στην οθόνη EXP Brain στην επιλεγμένη θέση pixel x και y.

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

Παράμετρος	Τύπος	Περιγραφή
x	int	Η συντεταγμένη x όπου θα σχεδιαστεί το εικονοστοιχείο, η οποία δίνεται ως ακέραιος αριθμός από 0 έως 159.
y	int	Η συντεταγμένη y όπου θα σχεδιαστεί το εικονοστοιχείο, η οποία δίνεται ως ακέραιος αριθμός από 0 έως 107.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Τα pixel σχεδιάζονται χρησιμοποιώντας το τρέχον χρώμα πένας που έχει οριστεί με setPenColor.

• The x and y coordinates are relative to the current screen origin, which can be set using setOrigin.

• Εάν η καθορισμένη θέση του pixel βρίσκεται εκτός των ορίων της οθόνης, το pixel δεν σχεδιάζεται.

Examples

// Draw the pixels marking the corners of a square
Brain.Screen.drawPixel(50, 50);
Brain.Screen.drawPixel(50, 75);
Brain.Screen.drawPixel(75, 50);
Brain.Screen.drawPixel(75, 75);

drawLine

Σχεδιάζει μια ευθεία γραμμή που συνδέει δύο σημεία στην οθόνη EXP Brain.

Available Functions

void drawLine(
  int x1,
  int y1,
  int x2,
  int y2 );

Parameters

Παράμετρος	Τύπος	Περιγραφή
x1	int	Η αρχική συντεταγμένη x της γραμμής, που δίνεται ως ακέραιος αριθμός από 0 έως 159.
y1	int	Η αρχική συντεταγμένη y της γραμμής, που δίνεται ως ακέραιος αριθμός από 0 έως 107.
x2	int	Η τελική συντεταγμένη x της γραμμής, που δίνεται ως ακέραιος αριθμός από 0 έως 159.
y2	int	Η τελική συντεταγμένη y της γραμμής, η οποία δίνεται ως ακέραιος αριθμός από 0 έως 107.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Οι γραμμές σχεδιάζονται χρησιμοποιώντας το τρέχον χρώμα πένας που έχει οριστεί με setPenColor.

• Το πλάτος της γραμμής καθορίζεται από το τρέχον πλάτος πένας που έχει οριστεί με setPenWidth.

• The x and y coordinates are relative to the current screen origin, which can be set using setOrigin.

• Εάν οποιοδήποτε τμήμα της γραμμής βρίσκεται εκτός των ορίων της οθόνης, σχεδιάζεται μόνο το ορατό τμήμα.

Examples

// Draw a line from the top left to bottom right of the screen
Brain.Screen.drawLine(0, 0, 159, 107);

drawRectangle

Σχεδιάζει ένα ορθογώνιο στην οθόνη EXP Brain στην καθορισμένη θέση και μέγεθος.

Available Functions

1 — Σχεδιάζει και γεμίζει ένα ορθογώνιο χρησιμοποιώντας το τρέχον διαμορφωμένο χρώμα γεμίσματος.

void drawRectangle(
    int x,
    int y,
    int width,
    int height );

2 — Σχεδιάζει και γεμίζει ένα ορθογώνιο χρησιμοποιώντας ένα προκαθορισμένο ή προσαρμοσμένο χρώμα αντικείμενο.

void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const color&  color );

3 — Σχεδιάζει και γεμίζει ένα ορθογώνιο χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος.

void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const char*   color );

4 — Σχεδιάζει και γεμίζει ένα ορθογώνιο χρησιμοποιώντας μια τιμή απόχρωσης.

void drawRectangle(
    int x,
    int y,
    int width,
    int height,
    int hue );

Parameters

Παράμετρος	Τύπος	Περιγραφή
x	int	Η συντεταγμένη x της επάνω αριστερής γωνίας του ορθογωνίου, που δίνεται ως ακέραιος αριθμός από 0 έως 159.
y	int	Η συντεταγμένη y της επάνω αριστερής γωνίας του ορθογωνίου, που δίνεται ως ακέραιος αριθμός από 0 έως 107.
width	int	Το πλάτος του ορθογωνίου, που δίνεται ως ακέραιος αριθμός από 0 έως 159.
height	int	Το ύψος του ορθογωνίου, που δίνεται ως ακέραιος αριθμός από 0 έως 107.
color	const color&	Fills the rectangle using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Γεμίζει το ορθογώνιο χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος (για παράδειγμα, “#FF0000”).
hue	int	Γεμίζει το ορθογώνιο χρησιμοποιώντας μια τιμή απόχρωσης στην περιοχή 0–359.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Το περίγραμμα του ορθογωνίου σχεδιάζεται χρησιμοποιώντας το τρέχον χρώμα πένας που έχει οριστεί με setPenColor.

• Το πάχος του περιγράμματος καθορίζεται από το τρέχον πλάτος πένας που έχει οριστεί με setPenWidth.

• Όταν δεν παρέχεται παράμετρος color , το εσωτερικό του ορθογωνίου γεμίζεται χρησιμοποιώντας το τρέχον χρώμα γεμίσματος που έχει οριστεί με setFillColor.

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• Εάν οποιοδήποτε τμήμα του ορθογωνίου βρίσκεται εκτός των ορίων της οθόνης, σχεδιάζεται μόνο το ορατό τμήμα.

• Η τιμή της παραμέτρου hue βασίζεται σε έναν κυκλικό χρωματικό τροχό, όπως φαίνεται παρακάτω, όπου οι τιμές αντιπροσωπεύουν μοίρες γύρω από τον τροχό (για παράδειγμα, κόκκινο κοντά στις 0°, πράσινο κοντά στις 120° και μπλε κοντά στις 240°).

Examples

// Draw a rectangle on the screen
Brain.Screen.drawRectangle(20, 20, 80, 30);

drawCircle

Σχεδιάζει έναν κύκλο στην οθόνη EXP Brain στην καθορισμένη θέση και ακτίνα.

Available Functions

1 — Σχεδιάζει και γεμίζει έναν κύκλο χρησιμοποιώντας το τρέχον διαμορφωμένο χρώμα γεμίσματος.

void drawCircle(
    int x,
    int y,
    int radius );

2 — Σχεδιάζει και γεμίζει έναν κύκλο χρησιμοποιώντας ένα προκαθορισμένο ή προσαρμοσμένο χρώμα αντικείμενο.

void drawCircle(
    int           x,
    int           y,
    int           radius,
    const color&  color );

3 — Σχεδιάζει και γεμίζει έναν κύκλο χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος.

void drawCircle(
    int           x,
    int           y,
    int           radius,
    const char*   color );

4 — Σχεδιάζει και γεμίζει έναν κύκλο χρησιμοποιώντας μια τιμή απόχρωσης.

void drawCircle(
    int x,
    int y,
    int radius,
    int hue );

Parameters

Παράμετρος	Τύπος	Περιγραφή
x	int	Η συντεταγμένη x του κέντρου του κύκλου, που δίνεται ως ακέραιος αριθμός από 0 έως 159.
y	int	Η συντεταγμένη y του κέντρου του κύκλου, που δίνεται ως ακέραιος αριθμός από 0 έως 107.
radius	int	Η ακτίνα του κύκλου, που δίνεται ως ακέραιος αριθμός από 0 έως 107 pixel.
color	const color&	Fills the circle using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Γεμίζει τον κύκλο χρησιμοποιώντας μια δεκαεξαδική τιμή χρώματος (για παράδειγμα, “#FF0000”).
hue	int	Γεμίζει τον κύκλο χρησιμοποιώντας μια τιμή απόχρωσης στην περιοχή 0–359.

Return Values

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

Notes

• Το περίγραμμα του κύκλου σχεδιάζεται χρησιμοποιώντας το τρέχον χρώμα πένας που έχει οριστεί με setPenColor.

• Το πάχος του περιγράμματος καθορίζεται από το τρέχον πλάτος πένας που έχει οριστεί με setPenWidth.

• Όταν δεν παρέχεται παράμετρος color , το εσωτερικό του κύκλου γεμίζεται χρησιμοποιώντας το τρέχον χρώμα γεμίσματος που έχει οριστεί με setFillColor.

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• Η τιμή της παραμέτρου hue βασίζεται σε έναν κυκλικό χρωματικό τροχό, όπως φαίνεται παρακάτω, όπου οι τιμές αντιπροσωπεύουν μοίρες γύρω από τον τροχό (για παράδειγμα, κόκκινο κοντά στις 0°, πράσινο κοντά στις 120° και μπλε κοντά στις 240°).

Examples

// Draw a circle on the screen
Brain.Screen.drawCircle(80, 50, 20);

drawImageFromFile

Σχεδιάζει μια εικόνα στην οθόνη EXP Brain χρησιμοποιώντας ένα αρχείο εικόνας που είναι αποθηκευμένο στην κάρτα SD.

Available Functions

bool drawImageFromFile(
  const char* name,
  int x,
  int y );

Parameters

Παράμετρος	Τύπος	Περιγραφή
name	const char*	Το όνομα αρχείου της εικόνας στην κάρτα SD. Το αρχείο πρέπει να έχει επέκταση .bmp ή .png.
x	int	Η συντεταγμένη x, σε pixel από 0 έως 159, στην οποία θα σχεδιαστεί η αριστερή άκρη της εικόνας.
y	int	Η συντεταγμένη y, σε pixel από 0 έως 107, στην οποία θα σχεδιαστεί το πάνω άκρο της εικόνας.

Return Values

Επιστρέφει μια λογική τιμή που υποδεικνύει εάν η εικόνα σχεδιάστηκε με επιτυχία:

• true — Η εικόνα φορτώθηκε και σχεδιάστηκε με επιτυχία στην οθόνη.
• false — Η εικόνα δεν ήταν δυνατό να σχεδιαστεί (για παράδειγμα, εάν το αρχείο δεν υπάρχει ή δεν είναι έγκυρο).

Notes

• Οι υποστηριζόμενες μορφές εικόνας είναι .bmp και .png.

• Το μέγεθος του αρχείου εικόνας δεν πρέπει να υπερβαίνει 512 KB.

  • Συνιστάται η κωδικοποίηση RLE 8-bit για την ελαχιστοποίηση του μεγέθους του αρχείου.

• Οι μέγιστες υποστηριζόμενες διαστάσεις εικόνας είναι το μέγεθος της οθόνης Brain (περίπου 159 x 107 pixel).

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

Examples

// Draw a bmp file on the Brain's screen at coordinate 0, 0
Brain.Screen.drawImageFromFile("test_image.bmp", 0, 0);

render

Ενεργοποιεί τη διπλή προσωρινή αποθήκευση για την οθόνη του Brain. Μόλις κληθούν, τυχόν συναρτήσεις σχεδίασης (όπως κείμενο, σχήματα ή εικόνες) δεν θα εμφανίζονται πλέον αμέσως για το υπόλοιπο έργο. Αντίθετα, οι ενημερώσεις θα εμφανίζονται μόνο όταν χρησιμοποιηθεί ξανά η απόδοση render Αυτό επιτρέπει ομαλότερες και πιο ελεγχόμενες ενημερώσεις οθόνης, αλλά σημαίνει ότι τίποτα δεν θα είναι ορατό μέχρι να χρησιμοποιηθεί η απόδοση render.

Available Functions

1 — Ενεργοποιεί τη διπλή προσωρινή αποθήκευση ή αποδίδει την προσωρινή αποθήκευση στην οθόνη.

bool render();

2 — Αποδίδει το back buffer στην οθόνη με έλεγχο της συμπεριφοράς κάθετου συγχρονισμού και προαιρετική εκτέλεση χρονοδιαγράμματος.

bool render(
    bool bVsyncWait,
    bool bRunScheduler = true );

Parameters

Παράμετρος	Τύπος	Περιγραφή
bVsyncWait	bool	​ true — Περιμένετε την κάθετη ανανέωση της οθόνης πριν από την απόδοση για να μειώσετε το οπτικό σκίσιμο. false — Μην περιμένετε την κάθετη ανανέωση της οθόνης πριν από την απόδοση.
bRunScheduler	bool	Προαιρετικό. true (προεπιλογή) — Επιτρέπεται η εκτέλεση εργασιών παρασκηνίου κατά την αναμονή της απόδοσης. false — Δεν επιτρέπεται η εκτέλεση εργασιών παρασκηνίου κατά την αναμονή της απόδοσης.

Return Values

Επιστρέφει μια λογική τιμή που υποδεικνύει εάν τα αποθηκευμένα σχέδια στο buffer αποδώθηκαν με επιτυχία στην οθόνη:

• true — Τα σχέδια αποδώθηκαν με επιτυχία στην οθόνη.
• false — Τα σχέδια δεν ήταν δυνατό να αποδοθούν στην οθόνη.
Notes

• Η κλήση της συνάρτησης render θα απαιτήσει τη χρήση της συνάρτησης render για το υπόλοιπο έργο.

Examples

Brain.Screen.render();

// Draw text to the back buffer
Brain.Screen.print("Render later...");

// Wait for a screen press to render drawings
while (!Brain.Screen.pressing()) {
  wait(20, msec);
}
Brain.Screen.render();