এসডি কার্ড#

ভূমিকা #

VEX IQ (২য় জেনারেশন)-এর এসডি কার্ড এপিআই আপনাকে ব্রেইনের এসডি কার্ড স্লটে ঢোকানো একটি অপসারণযোগ্য এসডি কার্ডে ফাইল সংরক্ষণ এবং অ্যাক্সেস করার সুবিধা দেয়। আপনি সেন্সর ডেটা সংরক্ষণ করুন বা কাস্টম ছবি লোড করুন, এই পদ্ধতিগুলো ফাইল পরিচালনার উপর সম্পূর্ণ নিয়ন্ত্রণ প্রদান করে। অপসারণযোগ্য এসডি কার্ডটি আপনাকে আপনার ব্রেইন এবং কম্পিউটারের মধ্যে সহজেই ডেটা স্থানান্তর করতে দেয়।

IQ (২য় জেনারেশন) ব্রেইন ব্যবহারের জন্য ৩২ জিবির বেশি নয় এমন একটি SD কার্ড প্রয়োজন, যা FAT32 ফরম্যাটে ফরম্যাট করা থাকবে। ৩২ জিবির চেয়ে বড় SD কার্ডগুলো ডিফল্টভাবে exFAT ফরম্যাটিং ব্যবহার করে, যা VEX IQ (২য় জেনারেশন) ব্রেইনের সাথে সামঞ্জস্যপূর্ণ নয়। ব্যবহারের আগে নিশ্চিত করুন যে আপনার SD কার্ডটি সঠিকভাবে FAT32 ফরম্যাটে ফরম্যাট করা আছে।

অ্যাক্সেসযোগ্য হওয়ার জন্য সমস্ত ফাইল এসডি কার্ডের রুট ফোল্ডারে রাখতে হবে।

এই পৃষ্ঠাটি উদাহরণ মস্তিষ্ক নাম হিসেবে brain ব্যবহার করে। প্রয়োজন অনুযায়ী আপনার নিজের কনফিগার করা নাম দিয়ে এটি প্রতিস্থাপন করুন।

নিম্নে সকল পদ্ধতির একটি তালিকা দেওয়া হলো:

ক্রিয়াকলাপ — ফাইল সংক্রান্ত কার্যক্রম সম্পাদন করা এবং এসডি কার্ড থেকে ছবি প্রদর্শন করা।

loadfile — এসডি কার্ড থেকে একটি ফাইলের বিষয়বস্তু ব্যবহারকারীর সরবরাহ করা মেমরি বাফারে লোড করে।
savefile — ব্যবহারকারীর দেওয়া বাফার থেকে ডেটা IQ (2nd gen) Brain-এর SD কার্ডের একটি ফাইলে সংরক্ষণ করে।
appendfile — IQ (2nd gen) Brain-এর SD কার্ডে থাকা কোনো ফাইলের শেষে ব্যবহারকারীর দেওয়া বাফার থেকে ডেটা যুক্ত করে।
draw_image_from_file — এসডি কার্ড থেকে একটি বিটম্যাপ ছবি প্রদর্শন করে।

গেটার্স — এসডি কার্ড এবং ফাইলের তথ্য ফেরত দেয়।

is_inserted — ব্রেইনে একটি SD কার্ড ঢোকানো আছে কিনা তা ফেরত দেয়।
filesize — একটি ফাইলের আকার ফেরত দেয়।
size — একটি ফাইলের আকার ফেরত দেয়।
exists — এসডি কার্ডে ফাইলটি পাওয়া গেছে কিনা তা ফেরত দেয়।

কর্ম #

loadfile #

loadfile এসডি কার্ড থেকে একটি ফাইলকে বাইটঅ্যারেতে লোড করে।

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

প্যারামিটার	বর্ণনা
`filename`	লোড করার জন্য ফাইলের নামটি একটি স্ট্রিং হিসেবে দিতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন থাকতে হবে।
`buffer`	ঐচ্ছিক। ফাইলের বিষয়বস্তু লোড করার জন্য একটি বিদ্যমান বাইটঅ্যারে। যদি বিদ্যমান বাইটঅ্যারেটি বড় হয়, তবে এর বিষয়বস্তু ওভাররাইট করা হবে। যদি বিদ্যমান বাইটঅ্যারেটি ছোট হয়, তবে পদ্ধতিটি সমস্ত ডেটা লোড নাও করতে পারে। ডিফল্টরূপে, কোনো বাফার প্রদান করা না হলে একটি নতুন বাইটঅ্যারে ফেরত দেওয়া হবে।

প্যারামিটার

বর্ণনা

filename

লোড করার জন্য ফাইলের নামটি একটি স্ট্রিং হিসেবে দিতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন থাকতে হবে।

buffer

ঐচ্ছিক। ফাইলের বিষয়বস্তু লোড করার জন্য একটি বিদ্যমান বাইটঅ্যারে। যদি বিদ্যমান বাইটঅ্যারেটি বড় হয়, তবে এর বিষয়বস্তু ওভাররাইট করা হবে। যদি বিদ্যমান বাইটঅ্যারেটি ছোট হয়, তবে পদ্ধতিটি সমস্ত ডেটা লোড নাও করতে পারে। ডিফল্টরূপে, কোনো বাফার প্রদান করা না হলে একটি নতুন বাইটঅ্যারে ফেরত দেওয়া হবে।

# 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 এসডি কার্ডে একটি বাইটঅ্যারে সংরক্ষণ করে।

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

প্যারামিটার	বর্ণনা
`filename`	ফাইলটির নাম একটি স্ট্রিং হিসেবে সংরক্ষণ করতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন থাকতে হবে। ফাইলটি আগে থেকে বিদ্যমান থাকলে, এটি ওভাররাইট করা হবে। ফাইলটি বিদ্যমান না থাকলে, একটি নতুন ফাইল তৈরি করা হবে।
`buffer`	ঐচ্ছিক। ফাইলে লেখার জন্য একটি বাইটঅ্যারে।

প্যারামিটার

বর্ণনা

filename

ফাইলটির নাম একটি স্ট্রিং হিসেবে সংরক্ষণ করতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন থাকতে হবে। ফাইলটি আগে থেকে বিদ্যমান থাকলে, এটি ওভাররাইট করা হবে। ফাইলটি বিদ্যমান না থাকলে, একটি নতুন ফাইল তৈরি করা হবে।

buffer

ঐচ্ছিক। ফাইলে লেখার জন্য একটি বাইটঅ্যারে।

# 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 একটি বিদ্যমান ফাইলে একটি বাইটঅ্যারে যুক্ত করে, যা বর্তমান বিষয়বস্তু পরিবর্তন না করে ফাইলের শেষে নতুন ডেটা যোগ করে।

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

প্যারামিটার	বর্ণনা
`filename`	যে ফাইলটি যুক্ত করতে হবে তার নামটি স্ট্রিং হিসেবে দিতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন থাকতে হবে।
`buffer`	যুক্ত করার ডেটা ধারণকারী একটি বাইটঅ্যারে।

# 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 এসডি কার্ডে সংরক্ষিত একটি বিটম্যাপ ইমেজ (BMP) প্রদর্শন করে।

.bmp ৫১২০ পিক্সেল এবং ৬ কিলোবাইট আকারে সীমাবদ্ধ।

দ্রষ্টব্য: IQ (২য় প্রজন্ম) ব্রেইন শুধুমাত্র .bmp ফাইল প্রদর্শন করতে পারে। ফাইলের আকার কমানোর জন্য 8-বিট RLE এনকোডিং সুপারিশ করা হয়।

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 একটি বুলিয়ান মান রিটার্ন করে যা নির্দেশ করে যে বর্তমানে ব্রেইন-এ কোনো এসডি কার্ড ঢোকানো আছে কিনা।

True — মস্তিষ্কে একটি এসডি কার্ড ঢোকানো আছে।
False — ব্রেইনটিতে কোনো এসডি কার্ড ঢোকানো নেই।

Usage:
brain.sdcard.is_inserted()

প্যারামিটার	বর্ণনা
	এই পদ্ধতিতে কোনো প্যারামিটার নেই।

# 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 একটি ফাইলের আকার বাইটে দশমিক (ফ্লোট) হিসাবে ফেরত দেয়।

Usage:
brain.sdcard.filesize(filename)

প্যারামিটার	বর্ণনা
`filename`	ফাইলের নামটি একটি স্ট্রিং হিসেবে হতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন অন্তর্ভুক্ত থাকতে হবে।

# 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 একটি ফাইলের আকার বাইটে দশমিক (ফ্লোট) হিসাবে ফেরত দেয়।

Usage:
brain.sdcard.size(filename)

প্যারামিটার	বর্ণনা
`filename`	ফাইলের নামটি একটি স্ট্রিং হিসেবে হতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন অন্তর্ভুক্ত থাকতে হবে।

# 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 একটি বুলিয়ান মান প্রদান করে যা নির্দেশ করে যে এসডি কার্ডে ফাইলটি পাওয়া গেছে কিনা।

True — ফাইলটি এসডি কার্ডে আছে।
False — ফাইলটি এসডি কার্ডে নেই।

Usage:
brain.sdcard.exists(filename)

প্যারামিটার	বর্ণনা
`filename`	ফাইলের নামটি একটি স্ট্রিং হিসেবে হতে হবে। ফাইলের নামে অবশ্যই ফাইল এক্সটেনশন অন্তর্ভুক্ত থাকতে হবে।

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