آموزش کتابخانه گرافیکی دوبعدی جلسه ی نهم
آموزش کتابخانه گرافیکی دوبعدی جلسه ی نهم
در آموزش کتابخانه گرافیکی دوبعدی به جلسه ی نهم رسیدیم که بحث اون در مورد ترسیم کد های QR می باشد
این توابع در ورژن ۵٫۳۴ emwin به مجموعه توابع رافیکی اضافه شده و برای اجرای آن بایستی هسته ی اصلی و فایل های مربوط به emwin حداقل به ورژن ۵٫۳۴ ارتقا یابند
در emwin این گروه شامل ۴ تابع می باشد که در زیر تمامی آنها تشریح شده است
تابع نمونه :
GUI_HMEM GUI_QR_Create(const char * pText, int PixelSize, int EccLevel,int Version);
پارامترهای تابع
pText | متن با فرمت UTF-8 |
PixelSize | اندازه ی پیکسل های کد QR بر حسب پیکسل |
EccLevel | سطح تصحیح خطا توسط تصحیح خطا Reed-Solomon |
Version | اندازه مورد نظر در ماژول QR کد می باشد. اگر ۰ تنظیم شود (توصیه می شود) اندازه به صورت خودکار محاسبه می شود. در غیر اینصورت باید بین ۱ و ۴۰ تنظیم شود. اگر کمتر از مقدار مورد نیاز برای متن داده شده با EccLevel داده شده باشد، تابع با شکست مواجه می شود. |
مقادیر مجاز برای پارامتر EccLevel | |
GUI_QR_ECLEVEL_L | حدود ۷٪ و یا کمتر خطا می تواند اصلاح شود. |
GUI_QR_ECLEVEL_M | حدود ۱۵٪ و یا کمتر خطا می تواند اصلاح شود. |
GUI_QR_ECLEVEL_Q | حدود ۲۵٪ و یا کمتر خطا می تواند اصلاح شود. |
GUI_QR_ECLEVEL_H | حدود ۳۰٪ و یا کمتر خطا می تواند اصلاح شود. |
توضیحات :
این تابع بیت مپ کد QR متن را ایجاد میکند. بیت مپ توسط تابع GUI_QR_Draw می تواند ترسیم شود.
در صورتی که از کد ایجاد شده به مدت طولانی استفاده نمیکنید توسط تابع GUI_QR_Delete آنرا پاک کنید.
تابع نمونه :
void GUI_QR_Delete(GUI_HMEM hQR);
پارامترهای تابع
GUI_HMEM | هندل کد QR |
توضیحات :
حافظه ای که کد QR آنرا اشغال کرده را خالی میکند
در صورتی که کد QR ایجاد شده و مورد استفاده قرار نمیگیرد باید پاک شود.
تابع نمونه :
void GUI_QR_Draw(GUI_HMEM hQR, int xPos, int yPos);
پارامترهای تابع
hQR | هندل کد QR |
xPos | نقطه ی x ترسیم گوشه ی سمت چپ بالا |
yPos | نقطه ی y ترسیم گوشه ی سمت چپ بالا |
توضیحات :
کد QR ایجاد شده را با این تابع در موقعیت مشخص می توان به نمایش در آورد.
تابع نمونه :
void GUI_QR_GetInfo(GUI_HMEM hQR, GUI_QR_INFO * pInfo);
پارامترهای تابع
hQR | هندل کد QR |
pInfo | اشاره گر به ساختار GUI_QR_INFO |
نوع دیتا | عنصر | شرح |
int | Version | ورژن نسخه با توجه به اسناد و مدارک کد QR |
int | Width | تعداد ماژول ها |
int | Size | اندازه بیت مپ بر حسب پیکسل |
توضیحات :
یک ساختار اطلاعات حاوی داده QR کد را بر میگرداند.