SD kortelė#

Įvadas #

SD kortelės API, skirta „VEX IQ“ (2-osios kartos), leidžia saugoti ir pasiekti failus išimamoje SD kortelėje, įdėtoje į „Brain“ SD kortelės lizdą. Nesvarbu, ar išsaugote jutiklių duomenis, ar įkeliate pasirinktinius vaizdus, šie metodai suteikia visišką failų operacijų valdymą. Išimama SD kortelė leidžia lengvai perkelti duomenis tarp „Brain“ ir kompiuterio.

„IQ (2-os kartos) Brain“ sistemai reikalinga ne didesnė nei 32 GB talpos SD kortelė, suformatuota FAT32 formatu. Didesnės nei 32 GB SD kortelės pagal numatytuosius nustatymus naudoja „exFAT“ formatavimą, kuris nesuderinamas su „VEX IQ (2-os kartos) Brain“. Prieš naudodami įsitikinkite, kad SD kortelė tinkamai suformatuota į FAT32.

Visi failai turi būti patalpinti SD kortelės šakniniame aplanke, kad būtų galima prie jų prisijungti.

Šiame puslapyje kaip Brain pavadinimo pavyzdys naudojamas brain Prireikus pakeiskite jį savo sukonfigūruotu pavadinimu.

Žemiau pateikiamas visų metodų sąrašas:

Veiksmai – atlikti failų operacijas ir rodyti vaizdus iš SD kortelės.

loadfile – Įkelia failo turinį iš SD kortelės į vartotojo pateiktą atminties buferį.
savefile – Įrašo duomenis iš vartotojo pateikto buferio į failą IQ (2-osios kartos) smegenų SD kortelėje.
appendfile – Prideda duomenis iš vartotojo pateikto buferio prie esamo failo pabaigos IQ (2-osios kartos) smegenų SD kortelėje.
draw_image_from_file — Rodo bitmap vaizdą iš SD kortelės.

Getteriai – grąžina SD kortelės ir failo informaciją.

is_inserted — Grąžina, ar į „Brain“ įdėta SD kortelė.
filesize — Grąžina failo dydį.
size — Grąžina failo dydį.
exists — Grąžina, ar SD kortelėje rastas failas.

Veiksmai #

loadfile #

loadfile įkelia failą iš SD kortelės į „bytearray“ diską.

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

Parametrai	Aprašymas
`filename`	Įkeliamo failo pavadinimas kaip eilutė. Failo pavadinime turi būti failo plėtinys.
`buffer`	Pasirinktinai. Esamas „bytearray“ masyvas, į kurį įkeliamas failo turinys. Jei esamas „bytearray“ masyvas yra didesnis, jo turinys bus perrašytas. Jei esamas „bytearray“ masyvas yra mažesnis, metodas gali neįkelti visų duomenų. Pagal numatytuosius nustatymus, jei nepateiktas buferis, bus grąžintas naujas „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")

savefile #

savefile išsaugo baitų failą į SD kortelę.

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

Parametrai	Aprašymas
`filename`	Failo, kurį reikia išsaugoti kaip eilutę, pavadinimas. Failo pavadinime turi būti failo plėtinys. Jei failas jau yra, jis bus perrašytas. Jei failo nėra, bus sukurtas naujas failas.
`buffer`	Pasirinktinai. Bytearray, skirtas įrašyti į failą.

# 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 prideda baitų masyvą (baitų masyvą) prie esamo failo, pridėdamas naujus duomenis failo pabaigoje nekeisdamas dabartinio turinio.

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

Parametrai	Aprašymas
`filename`	Failo, kurį reikia pridėti kaip eilutę, pavadinimas. Failo pavadinime turi būti failo plėtinys.
`buffer`	Baitų rinkinys, kuriame yra duomenys, kuriuos reikia pridėti.

# 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 rodo SD kortelėje saugomą bitmap vaizdą (BMP).

.bmp failų dydis ribojamas iki 5120 pikselių ir 6 KB.

Pastaba: IQ (2-osios kartos) Brain palaiko tik .bmp failų rodymą. Norint sumažinti failo dydį, rekomenduojama naudoti 8 bitų RLE kodavimą.

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

Parametrai	Aprašymas
`filename`	Vaizdo failo pavadinimas.
`x`	Viršutinio kairiojo vaizdo kampo ekrane x koordinatė.
`y`	Viršutinio kairiojo vaizdo kampo ekrane y koordinatė.

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

Getteriai #

is_inserted #

is_inserted grąžina loginę reikšmę, nurodančią, ar SD kortelė šiuo metu įdėta į „Brain“.

True — Smegenyse įdėta SD kortelė.
False — Smegenyse nėra įdėta SD kortelė.

Usage:
brain.sdcard.is_inserted()

Parametrai	Aprašymas
	Šis metodas neturi parametrų.

# 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 grąžina failo dydį baitais dešimtainiu tikslumu (float).

Usage:
brain.sdcard.filesize(filename)

Parametrai	Aprašymas
`filename`	Failo pavadinimas eilutėje. Failo pavadinime turi būti failo plėtinys.

# 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 grąžina failo dydį baitais dešimtainiu tikslumu (float).

Usage:
brain.sdcard.size(filename)

Parametrai	Aprašymas
`filename`	Failo pavadinimas eilutėje. Failo pavadinime turi būti failo plėtinys.

# 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 grąžina loginę reikšmę, nurodančią, ar SD kortelėje yra failas.

True — Failas yra SD kortelėje.
False — Failo nėra SD kortelėje.

Usage:
brain.sdcard.exists(filename)

Parametrai	Aprašymas
`filename`	Failo pavadinimas eilutėje. Failo pavadinime turi būti failo plėtinys.

# Add more text and display file size if the file exists
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)