SD卡#

介绍 #

VEX IQ（第二代）的 SD 卡 API 允许您将可移动 SD 卡插入 Brain 的 SD 卡槽，从而存储和访问其中的文件。无论您是保存传感器数据还是加载自定义图像，这些方法都能让您完全控制文件操作。可移动 SD 卡让您可以轻松地在 Brain 和计算机之间传输数据。

IQ（第二代）Brain 需要一张容量不超过 32GB 且格式为 FAT32 的 SD 卡。大于 32GB 的 SD 卡默认使用 exFAT 格式，这与 VEX IQ（第二代）Brain 不兼容。使用前请确保您的 SD 卡已正确格式化为 FAT32 格式。

所有文件必须放在 SD 卡的根文件夹中才可访问。

对于以下示例，构造的 Brain 包括对 SD 卡方法的访问，并且在本 API 文档的所有后续示例中引用这些方法时都将使用它。

以下是所有方法的列表：

操作——执行文件操作并显示 SD 卡中的图像。

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

Getters – 返回 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.

行动 #

loadfile #

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

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

参数	描述
`filename`	要加载的文件的名称（以字符串形式）。文件名必须包含文件扩展名。
`buffer`	可选。一个现有的字节数组，用于加载文件内容。如果现有字节数组较大，其内容将被覆盖。如果现有字节数组较小，该方法可能无法加载所有数据。默认情况下，如果未提供缓冲区，则将返回一个新的字节数组。

# Display a .txt file's contents on the brain
# Change the name of the file
text_file = brain.sdcard.loadfile("Text.txt")
brain.screen.print(text_file.decode("utf-8"))

savefile #

savefile saves a bytearray into the SD card.

Usage
brain.sdcard.savefile(filename, buffer)

参数	描述
`filename`	要保存为字符串的文件名称。文件名必须包含文件扩展名。如果文件已存在，则会覆盖该文件。如果文件不存在，则会创建一个新文件。
`buffer`	可选。要写入文件的字节数组。

# Overwrite an existing txt file and display the new text
brain.sdcard.savefile("Text.txt", bytearray("Hello "))
text_file = brain.sdcard.loadfile("Text.txt")
brain.screen.print(text_file.decode("utf-8"))

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`	包含要附加的数据的字节数组。

# Append "World" to an existing txt file then display it
brain.sdcard.appendfile('Text.txt', bytearray("World "))
text_file = brain.sdcard.loadfile("Text.txt")
brain.screen.print(text_file.decode("utf-8"))

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 IQ (2nd gen) 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()

参数	描述
	该方法没有参数。

# Display a message if the SDcard is inserted
if brain.sdcard.is_inserted():
    brain.screen.print("Inserted!")

filesize #

filesize returns the size of a file in bytes as a float.

Usage:
brain.sdcard.filesize(filename)

参数	描述
`filename`	文件名（字符串形式）。文件名必须包含文件扩展名。

# Display the amount of bytes in a txt file
brain.screen.print(brain.sdcard.filesize("Text.txt"))

size #

size returns the size of a file in bytes as a float.

Usage:
brain.sdcard.size(filename)

参数	描述
`filename`	文件名（字符串形式）。文件名必须包含文件扩展名。

# Display the amount of bytes in a txt file
brain.screen.print(brain.sdcard.size("Text.txt"))

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`	文件名（字符串形式）。文件名必须包含文件扩展名。

# Determine if a requested file exists
if brain.sdcard.exists("Text.txt"):
    brain.screen.print("File exists")
else:
    brain.screen.print("Create file")