Κάρτα SD#

Εισαγωγή #

Η χρήση κάρτας SD με το VEX V5 σάς επιτρέπει να αποθηκεύετε και να έχετε πρόσβαση σε αρχεία σε μια αφαιρούμενη κάρτα SD που έχει εισαχθεί στην υποδοχή κάρτας SD του Brain. Είτε αποθηκεύετε δεδομένα αισθητήρα είτε φορτώνετε προσαρμοσμένες εικόνες, αυτές οι μέθοδοι παρέχουν πλήρη έλεγχο στις λειτουργίες των αρχείων. Η αφαιρούμενη κάρτα SD σάς επιτρέπει να μεταφέρετε εύκολα δεδομένα μεταξύ του Brain και του υπολογιστή σας.

Το V5 Brain απαιτεί κάρτα SD όχι μεγαλύτερη από 32GB, με μορφοποίηση FAT32. Οι κάρτες SD μεγαλύτερες από 32GB χρησιμοποιούν μορφοποίηση exFAT από προεπιλογή, η οποία δεν είναι συμβατή με το V5 Brain. Βεβαιωθείτε ότι η κάρτα SD σας έχει μορφοποιηθεί σωστά σε FAT32 πριν από τη χρήση.

Όλα τα αρχεία πρέπει να τοποθετούνται στον ριζικό φάκελο της κάρτας SD για να είναι προσβάσιμα.

Για τα παρακάτω παραδείγματα, το constructed Brain περιλαμβάνει πρόσβαση στις μεθόδους της κάρτας SD και θα χρησιμοποιηθεί σε όλα τα επόμενα παραδείγματα σε όλη την τεκμηρίωση αυτού του API κατά την αναφορά σε αυτές τις μεθόδους.

Παρακάτω είναι μια λίστα με όλες τις μεθόδους:

Ενέργειες – Εκτελέστε λειτουργίες αρχείων και εμφανίστε εικόνες από την κάρτα SD.

loadfile – Loads a file from the SD card into a bytearray.
savefile – Saves a bytearray onto the SD card.
appendfile – Appends a bytearray to an existing file.
draw_image_from_file – Displays a Bitmap Image from the SD card.

Λήπτες – Επιστρέφουν πληροφορίες κάρτας SD και αρχείων.

is_inserted – Returns a Boolean indicating whether an SD card is inserted into the Brain.
filesize – Returns the size of a file in bytes.
size – Returns the size of a file in bytes.
exists – Returns a Boolean indicating whether a file is found on the SD card.

For information on constructing a Brain to gain access to the sdcard methods, see Brain.

Ενέργειες #

loadfile #

loadfile loads a file from the SD card into a bytearray.

Usage:
brain.sdcard.loadfile(filename, buffer)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου που θα φορτωθεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.
`buffer`	Προαιρετικό. Ένα υπάρχον bytearray για τη φόρτωση του περιεχομένου του αρχείου. Εάν το υπάρχον bytearray είναι μεγαλύτερο, το περιεχόμενό του θα αντικατασταθεί. Εάν το υπάρχον bytearray είναι μικρότερο, η μέθοδος ενδέχεται να μην φορτώσει όλα τα δεδομένα. Από προεπιλογή, θα επιστραφεί ένα νέο bytearray εάν δεν παρέχεται buffer.

Παράμετροι

Περιγραφή

filename

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

buffer

Προαιρετικό. Ένα υπάρχον bytearray για τη φόρτωση του περιεχομένου του αρχείου. Εάν το υπάρχον bytearray είναι μεγαλύτερο, το περιεχόμενό του θα αντικατασταθεί. Εάν το υπάρχον bytearray είναι μικρότερο, η μέθοδος ενδέχεται να μην φορτώσει όλα τα δεδομένα. Από προεπιλογή, θα επιστραφεί ένα νέο bytearray εάν δεν παρέχεται buffer.

# Check for SD card and show a file's text
if brain.sdcard.is_inserted():
    # Save new text to a file
    brain.sdcard.savefile("Note.txt", bytearray("VEX"))
    # Load the file and print it
    data = brain.sdcard.loadfile("Note.txt")
    brain.screen.print(data.decode("utf-8"))
else:
    brain.screen.print("Insert SD card")

savefile #

savefile saves a bytearray onto the SD card.

Usage:
brain.sdcard.savefile(filename, buffer)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου που θα αποθηκευτεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου. Εάν το αρχείο υπάρχει ήδη, θα αντικατασταθεί. Εάν το αρχείο δεν υπάρχει, θα δημιουργηθεί ένα νέο αρχείο.
`buffer`	Προαιρετικό. Ένα bytearray για εγγραφή στο αρχείο.

Παράμετροι

Περιγραφή

filename

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

buffer

Προαιρετικό. Ένα bytearray για εγγραφή στο αρχείο.

# Check for SD card and show a file's text
if brain.sdcard.is_inserted():
    # Save new text to a file
    brain.sdcard.savefile("Note.txt", bytearray("VEX"))
    # Load the file and print it
    data = brain.sdcard.loadfile("Note.txt")
    brain.screen.print(data.decode("utf-8"))
else:
    brain.screen.print("Insert SD card")

appendfile #

appendfile appends a bytearray to an existing file, adding new data to the end of the file without altering the current contents.

Usage:
brain.sdcard.appendfile(filename, buffer)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου που θα προστεθεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.
`buffer`	Ένα bytearray που περιέχει τα δεδομένα που θα προστεθούν.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray("code"))
    size = brain.sdcard.size("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)

draw_image_from_file #

draw_image_from_file displays a Bitmap Image (BMP) stored on the SD card.

.bmp files are limited to 5120 pixels and 6KB in size.

Note: The V5 Brain only supports displaying .bmp files. 8-bit RLE encoding is recommended to minimize file size.

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

Παράμετροι	Περιγραφή
`filename`	Το όνομα αρχείου της εικόνας.
`x`	Η συντεταγμένη x για την επάνω αριστερή γωνία της εικόνας στην οθόνη.
`y`	Η συντεταγμένη y για την επάνω αριστερή γωνία της εικόνας στην οθόνη.

# Draw a bmp file on the Brain's screen at coordinate 0, 0
brain.screen.draw_image_from_file('test_image.bmp', 0, 0)

Αποκτητές #

is_inserted #

is_inserted returns a Boolean indicating whether an SD card is currently inserted into the Brain.

True - The Brain has an SD card inserted.
False - The Brain does not have an SD card inserted.

Usage:
brain.sdcard.is_inserted()

Παράμετροι	Περιγραφή
	Αυτή η μέθοδος δεν έχει παραμέτρους.

# Check for SD card and show a file's text
if brain.sdcard.is_inserted():
    # Save new text to a file
    brain.sdcard.savefile("Note.txt", bytearray("VEX"))
    # Load the file and print it
    data = brain.sdcard.loadfile("Note.txt")
    brain.screen.print(data.decode("utf-8"))
else:
    brain.screen.print("Insert SD card")

filesize #

filesize returns the size of a file in bytes.

Usage:
brain.sdcard.filesize(filename)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray("code"))
    size = brain.sdcard.filesize("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)

size #

size returns the size of a file in bytes.

Usage:
brain.sdcard.size(filename)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray("code"))
    size = brain.sdcard.size("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)

exists #

exists returns a Boolean indicating whether a file is found on the SD card.

True - The file is on the SD card.
False - The file is not on the SD card.

Usage:
brain.sdcard.exists(filename)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray(" World"))
    size = brain.sdcard.size("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)