SD-kártya#

Bevezetés #

Egy SD-kártya használata a VEX V5-tel lehetővé teszi fájlok tárolását és elérését egy, a Brain SD-kártyanyílásába helyezett cserélhető SD-kártyán. Akár szenzoradatokat ment, akár egyéni képeket tölt be, ezek a módszerek teljes kontrollt biztosítanak a fájlműveletek felett. A cserélhető SD-kártya lehetővé teszi az adatok egyszerű átvitelét az Brain és a számítógép között.

A V5 Brain használatához legfeljebb 32 GB-os, FAT32 fájlrendszerű SD-kártya szükséges. A 32 GB-nál nagyobb SD-kártyák alapértelmezés szerint exFAT formázást használnak, amely nem kompatibilis a V5 Brainnel. Használat előtt győződjön meg arról, hogy az SD-kártya megfelelően FAT32 fájlrendszerre van formázva.

Minden fájlnak az SD-kártya gyökérmappájába kell kerülnie ahhoz, hogy elérhető legyen.

Az alábbi példákban a constructed Brain hozzáférést biztosít az SD-kártya metódusaihoz, és az API dokumentáció összes további példájában erre a metódusra fogunk hivatkozni.

Az alábbiakban felsoroljuk az összes módszert:

Műveletek – Fájlműveletek végrehajtása és képek megjelenítése az SD-kártyáról.

loadfile – Betölt egy fájlt az SD-kártyáról egy bájttömbbe.
savefile – Bájttömböt ment az SD-kártyára.
appendfile – Hozzáfűz egy bájttömböt egy meglévő fájlhoz.
draw_image_from_file – Megjeleníti az SD-kártyán található bitképet.

Getterek – SD-kártya és fájlinformációk visszaadása.

is_inserted – Logikai értéket ad vissza, amely jelzi, hogy van-e SD-kártya behelyezve az agyba.
filesize – Visszaadja a fájl méretét bájtban.
size – Visszaadja a fájl méretét bájtban.
exists – Logikai értéket ad vissza, amely jelzi, hogy található-e fájl az SD-kártyán.

A sdcard metódusok eléréséhez szükséges Brain felépítéséről a Brain című dokumentumban talál további információkat.

Műveletek #

loadfile #

loadfile Betölt egy fájlt az SD kártyáról egy bytearray tárolóba.

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

Paraméterek	Leírás
`filename`	A betöltendő fájl neve karakterláncként. A fájl nevének tartalmaznia kell a fájlkiterjesztést.
`buffer`	Opcionális. Egy meglévő bytearray, amelybe a fájl tartalma betöltésre kerül. Ha a meglévő bytearray nagyobb, akkor a tartalma felülírásra kerül. Ha a meglévő bytearray kisebb, előfordulhat, hogy a metódus nem tölti be az összes adatot. Alapértelmezés szerint egy új bytearray kerül visszaadásra, ha nincs megadva puffer.

# 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 elment egy bájtméretű fájlt az SD kártyára.

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

Paraméterek	Leírás
`filename`	A mentendő fájl neve karakterláncként. A fájlnévnek tartalmaznia kell a fájlkiterjesztést. Ha a fájl már létezik, akkor felülírja. Ha a fájl nem létezik, akkor egy új fájl jön létre.
`buffer`	Opcionális. Egy bytearray, ami a fájlba írható.

# 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 függvény egy bájttömböt fűz hozzá egy meglévő fájlhoz, új adatokat adva a fájl végéhez a jelenlegi tartalom megváltoztatása nélkül.

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

Paraméterek	Leírás
`filename`	A karakterláncként hozzáfűzendő fájl neve. A fájlnévnek tartalmaznia kell a fájlkiterjesztést.
`buffer`	Egy bájtsorozat, amely a hozzáfűzendő adatokat tartalmazza.

# 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 parancs egy SD-kártyán tárolt bitképet (BMP) jelenít meg.

.bmp fájlok mérete 5120 képpontra és 6 KB-ra korlátozódik.

Megjegyzés: A V5 Brain csak .bmp fájlok megjelenítését támogatja. A fájlméret minimalizálása érdekében 8 bites RLE kódolás ajánlott.

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

Paraméterek	Leírás
`filename`	A kép fájlneve.
`x`	A kép bal felső sarkának x koordinátája a képernyőn.
`y`	A kép bal felső sarkának y koordinátája a képernyőn.

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

Getterek #

is_inserted #

is_inserted egy logikai értéket ad vissza, amely azt jelzi, hogy jelenleg van-e SD-kártya a Brain-ben.

True - Az agyban SD-kártya van behelyezve.
False - Az agyban nincs SD-kártya behelyezve.

Usage:
brain.sdcard.is_inserted()

Paraméterek	Leírás
	Ennek a metódusnak nincsenek paraméterei.

# 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 paraméter visszaadja a fájl méretét bájtban.

Usage:
brain.sdcard.filesize(filename)

Paraméterek	Leírás
`filename`	A fájl neve karakterláncként. A fájlnévnek tartalmaznia kell a fájlkiterjesztést.

# 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 visszaadja a fájl méretét bájtban.

Usage:
brain.sdcard.size(filename)

Paraméterek	Leírás
`filename`	A fájl neve karakterláncként. A fájlnévnek tartalmaznia kell a fájlkiterjesztést.

# 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 pedig egy logikai értéket ad vissza, amely azt jelzi, hogy található-e fájl az SD-kártyán.

True - A fájl az SD-kártyán található.
False - A fájl nincs az SD-kártyán.

Usage:
brain.sdcard.exists(filename)

Paraméterek	Leírás
`filename`	A fájl neve karakterláncként. A fájlnévnek tartalmaznia kell a fájlkiterjesztést.

# 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)