SD-kaart#

Invoering #

Met een SD-kaart in combinatie met de VEX V5 kunt u bestanden opslaan en openen op een verwijderbare SD-kaart die in de SD-kaartsleuf van de Brain is geplaatst. Of u nu sensorgegevens opslaat of aangepaste afbeeldingen laadt, deze methoden bieden volledige controle over bestandsbewerkingen. De verwijderbare SD-kaart maakt het bovendien eenvoudig om gegevens tussen uw Brain en computer over te dragen.

De V5 Brain vereist een SD-kaart van maximaal 32 GB, geformatteerd als FAT32. SD-kaarten groter dan 32 GB gebruiken standaard exFAT-formattering, wat niet compatibel is met de V5 Brain. Zorg ervoor dat uw SD-kaart correct is geformatteerd naar FAT32 voordat u deze gebruikt.

Alle bestanden moeten in de hoofdmap van de SD-kaart worden geplaatst om toegankelijk te zijn.

Voor de onderstaande voorbeelden bevat de geconstrueerde Brain toegang tot de SD-kaartmethoden en zal in alle volgende voorbeelden in deze API-documentatie worden gebruikt wanneer naar die methoden wordt verwezen.

Hieronder vindt u een lijst met alle methoden:

Acties – Bestandsbewerkingen uitvoeren en afbeeldingen van de SD-kaart weergeven.

loadfile – Laadt een bestand van de SD-kaart in een bytearray.
savefile – Slaat een bytearray op de SD-kaart op.
appendfile – Voegt een bytearray toe aan een bestaand bestand.
draw_image_from_file – Geeft een bitmapafbeelding van de SD-kaart weer.

Getters – Retourneer SD-kaart en bestandsinformatie.

is_inserted – Retourneert een Booleaanse waarde die aangeeft of er een SD-kaart in de Brain is geplaatst.
filesize – Geeft de grootte van een bestand in bytes terug.
size – Geeft de grootte van een bestand in bytes terug.
exists – Retourneert een Booleaanse waarde die aangeeft of een bestand op de SD-kaart is gevonden.

Voor informatie over het bouwen van een Brain om toegang te krijgen tot de sdcard methoden, zie Brain.

Acties #

loadfile #

loadfile laadt een bestand van de SD-kaart in een bytearray.

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

Parameters	Beschrijving
`filename`	De naam van het te laden bestand als tekenreeks. De bestandsnaam moet de bestandsextensie bevatten.
`buffer`	Optioneel. Een bestaande bytearray om de inhoud van het bestand in te laden. Als de bestaande bytearray groter is, wordt de inhoud ervan overschreven. Als de bestaande bytearray kleiner is, laadt de methode mogelijk niet alle gegevens. Standaard wordt een nieuwe bytearray geretourneerd als er geen buffer wordt opgegeven.

# 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 slaat een bytearray op de SD-kaart op.

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

Parameters	Beschrijving
`filename`	De naam van het op te slaan bestand moet als tekenreeks worden ingevoerd. De bestandsnaam moet de bestandsextensie bevatten. Als het bestand al bestaat, wordt het overschreven. Als het bestand niet bestaat, wordt een nieuw bestand aangemaakt.
`buffer`	Optioneel. Een bytearray om naar het bestand te schrijven.

# 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 voegt een bytearray toe aan een bestaand bestand, waarbij nieuwe gegevens aan het einde van het bestand worden toegevoegd zonder de huidige inhoud te wijzigen.

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

Parameters	Beschrijving
`filename`	De naam van het bestand dat moet worden toegevoegd, als tekenreeks. De bestandsnaam moet de bestandsextensie bevatten.
`buffer`	Een bytearray met de toe te voegen gegevens.

# 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 geeft een bitmapafbeelding (BMP) weer die op de SD-kaart is opgeslagen.

.bmp bestanden zijn beperkt tot 5120 pixels en 6 KB groot.

Let op: De V5 Brain ondersteunt alleen de weergave van .bmp bestanden. 8-bits RLE-codering wordt aanbevolen om de bestandsgrootte te minimaliseren.

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

Parameters	Beschrijving
`filename`	De bestandsnaam van de afbeelding.
`x`	De x-coördinaat van de linkerbovenhoek van de afbeelding op het scherm.
`y`	De y-coördinaat van de linkerbovenhoek van de afbeelding op het scherm.

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

Getters #

is_inserted #

is_inserted retourneert een Booleaanse waarde die aangeeft of er momenteel een SD-kaart in de Brain is geplaatst.

True - Er is een SD-kaart in de hersenen geplaatst.
False - Er is geen SD-kaart in de hersenen geplaatst.

Usage:
brain.sdcard.is_inserted()

Parameters	Beschrijving
	Deze methode heeft geen parameters.

# 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 geeft de grootte van een bestand in bytes weer.

Usage:
brain.sdcard.filesize(filename)

Parameters	Beschrijving
`filename`	De naam van het bestand als een tekenreeks. De bestandsnaam moet de bestandsextensie bevatten.

# 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 geeft de grootte van een bestand in bytes weer.

Usage:
brain.sdcard.size(filename)

Parameters	Beschrijving
`filename`	De naam van het bestand als een tekenreeks. De bestandsnaam moet de bestandsextensie bevatten.

# 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 retourneert een Booleaanse waarde die aangeeft of er een bestand op de SD-kaart is gevonden.

True - Het bestand staat op de SD-kaart.
False - Het bestand staat niet op de SD-kaart.

Usage:
brain.sdcard.exists(filename)

Parameters	Beschrijving
`filename`	De naam van het bestand als een tekenreeks. De bestandsnaam moet de bestandsextensie bevatten.

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