SD Kart#

giriiş#

VEX IQ (2. nesil) için SD kart API’si, Brain’in SD kart yuvasına takılan çıkarılabilir bir SD karta dosya kaydetmenizi ve dosyalara erişmenizi sağlar. İster sensör verilerini kaydediyor olun ister özel görüntüler yüklüyor olun, bu yöntemler dosya işlemleri üzerinde tam kontrol sağlar. Çıkarılabilir SD kart, Brain’iniz ve bilgisayarınız arasında kolayca veri aktarmanıza olanak tanır.

VEX IQ (2. nesil) Brain, en fazla 32 GB boyutunda ve FAT32 olarak biçimlendirilmiş bir SD kart gerektirir. 32 GB’den büyük SD kartlar varsayılan olarak exFAT biçimlendirmesini kullanır ve bu VEX IQ (2. nesil) Brain ile uyumlu değildir. Kullanmadan önce SD kartınızın FAT32 olarak doğru şekilde biçimlendirildiğinden emin olun.

Erişilebilmesi için tüm dosyaların SD kartın kök klasörüne yerleştirilmesi gerekmektedir.

Bu sayfada örnek Beyin adı olarak brain kullanılmıştır. Gerektiğinde kendi yapılandırdığınız adla değiştirin.

Aşağıda tüm yöntemlerin listesi bulunmaktadır:

İşlemler — SD karttaki dosyaları işleme ve görüntüleri görüntüleme.

  • loadfile — SD karttaki bir dosyanın içeriğini kullanıcı tarafından sağlanan bir bellek arabelleğine yükler.

  • savefile — Kullanıcı tarafından sağlanan bir arabellekten verileri IQ (2. nesil) Beynin SD kartındaki bir dosyaya kaydeder.

  • appendfile — Kullanıcı tarafından sağlanan bir arabellekten gelen verileri, IQ (2. nesil) Beynin SD kartındaki mevcut bir dosyanın sonuna ekler.

  • draw_image_from_file — SD karttan bir Bitmap Görüntüsü görüntüler.

Getters — SD kart ve dosya bilgilerini döndürür.

  • is_inserted — Beyne bir SD kartın takılı olup olmadığını döndürür.

  • filesize — Bir dosyanın boyutunu döndürür.

  • size — Bir dosyanın boyutunu döndürür.

  • exists — SD kartta dosya bulunup bulunmadığını döndürür.

Eylemler#

loadfile#

loadfile , SD karttan bir dosyayı bayt dizisine yükler.

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

Parametreler

Tanım

filename

Yüklenecek dosyanın adı, metin dizesi olarak belirtilmelidir. Dosya adı, dosya uzantısını da içermelidir.

buffer

İsteğe bağlı. Dosyanın içeriğini yüklemek için mevcut bir bayt dizisi. Mevcut bayt dizisi daha büyükse, içeriği üzerine yazılacaktır. Mevcut bayt dizisi daha küçükse, yöntem tüm verileri yüklemeyebilir. Varsayılan olarak, bir arabellek sağlanmazsa yeni bir bayt dizisi döndürülür.

# 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 bir bayt dizisini SD karta kaydeder.

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

Parametreler

Tanım

filename

Kaydedilecek dosyanın adı, bir metin dizesi olarak belirtilmelidir. Dosya adı, dosya uzantısını içermelidir. Dosya zaten mevcutsa, üzerine yazılacaktır. Dosya mevcut değilse, yeni bir dosya oluşturulacaktır.

buffer

İsteğe bağlı. Dosyaya yazılacak bayt dizisi.

# 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 , mevcut bir dosyaya bayt dizisi ekler ve mevcut içeriği değiştirmeden dosyanın sonuna yeni veriler ekler.

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

Parametreler

Tanım

filename

Eklenecek dosyanın adı, bir metin dizesi olarak belirtilmelidir. Dosya adı, dosya uzantısını da içermelidir.

buffer

Eklenecek verileri içeren bir bayt dizisi.

# 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 , SD kartta depolanan bir Bitmap Görüntüsünü (BMP) görüntüler.

.bmp dosyası 5120 piksel ve 6 KB boyutla sınırlıdır.

Not: IQ (2. nesil) Beyin yalnızca .bmp dosyasını görüntülemeyi destekler. Dosya boyutunu en aza indirmek için 8 bit RLE kodlaması önerilir.

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

Parametreler

Tanım

filename

Görüntünün dosya adı.

x

Ekrandaki görüntünün sol üst köşesinin x koordinatı.

y

Ekrandaki görüntünün sol üst köşesinin 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)

Getters#

is_inserted#

is_inserted , Brain’e şu anda bir SD kart takılı olup olmadığını gösteren bir Boolean değer döndürür.

  • True — Beyne bir SD kart takılı.

  • False — Beyine SD kart takılı değil.

Usage:
brain.sdcard.is_inserted()

Parametreler

Tanım

Bu yöntemin parametresi yoktur.

# 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 , bir dosyanın boyutunu bayt cinsinden ondalık sayı olarak döndürür (float).

Usage:
brain.sdcard.filesize(filename)

Parametreler

Tanım

filename

Dosyanın adı, metin dizisi olarak belirtilmelidir. Dosya adı, dosya uzantısını da içermelidir.

# 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 bir dosyanın boyutunu bayt cinsinden ondalık sayı olarak döndürür (float).

Usage:
brain.sdcard.size(filename)

Parametreler

Tanım

filename

Dosyanın adı, metin dizisi olarak belirtilmelidir. Dosya adı, dosya uzantısını da içermelidir.

# 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 SD kartta dosya bulunup bulunmadığını gösteren bir Boolean değer döndürür.

  • True — Dosya SD kartta.

  • False — Dosya SD kartta değil.

Usage:
brain.sdcard.exists(filename)

Parametreler

Tanım

filename

Dosyanın adı, metin dizisi olarak belirtilmelidir. Dosya adı, dosya uzantısını da içermelidir.

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