reswrap(1) FOX Programmers Manual reswrap(1)

reswrap - بسته‌بندی منابع آیکون در قالب کد C

reswrap [گزینه‌ها] [-o[a] outfile] files...

Reswrap ابزاری برای تبدیل تصاویر، متون و سایر پرونده‌های منابع به آرایه‌های داده‌ای ++C است. این قابلیت امکان جاسازی منابع دودویی گوناگون را در کد منبع و کامپایل آن‌ها به همراه برنامه فراهم می‌آورد.

در توسعه برنامه‌های گرافیکی با FOX، از این ابزار برای جاسازی آیکون‌ها و تصاویر رابط کاربری در فایل اجرایی استفاده می‌شود تا نیاز به توزیع جداگانه فایل‌های آیکون و تصویر از بین برود.

Reswrap معمولاً به عنوان بخشی از فرآیند ساخت برای تولید پرونده‌های منبع ++C از مجموعه‌ای از آیکون‌ها، تصاویر و سایر منابع باینری فراخوانی می‌شود.

به‌طور پیش‌فرض، reswrap پرونده‌های مشخص‌شده در files را به عنوان جریانی از بایت‌های خام تفسیر کرده و آن‌ها را به صورت یک آرایه داده مقداردهی‌شده در خروجی استاندارد (stdout) می‌نویسد.

نتیجه را به جای نوشتن در خروجی استاندارد، در پرونده outfile می‌نویسد. با گزینه -o محتوای قبلی پرونده outfile با داده‌های حاصل از ورودی بازنویسی خواهد شد. با گزینه -oa کد تولیدشده به انتهای پرونده outfile افزوده می‌شود، که امکان قرار دادن چندین پرونده ورودی در یک پرونده منبع واحد را فراهم می‌سازد.
پیام کوتاه راهنمای استفاده از دستور را نمایش می‌دهد.
فقط شماره نسخه و اطلاعات پروانه برنامه را چاپ می‌کند.
داده‌ها را به جای استفاده از اعداد هگزادسیمال پیش‌فرض، به صورت اعداد دهدهی (دسی‌مال) می‌نویسد.
پرونده‌ها را در حالت MS-DOS می‌خواند (حالت پیش‌فرض دودویی است). این کار هنگام خواندن پرونده منبع، "\r\n" را با "\n" جایگزین می‌کند.
داده‌ها را به صورت اعداد هگزادسیمال می‌نویسد (پیش‌فرض).
داده‌ها را به صورت یک رشته متنی می‌نویسد، به طوری که هر بایت به صورت یک توالی گریز (escape sequence) هگزادسیمال، مانند "\x33" نمایش داده می‌شود.

توجه داشته باشید که کامپایلر ++C یک نویسه تهی (nul-character) به انتهای رشته متنی اضافه می‌کند، بنابراین آرایه داده یک نویسه طولانی‌تر از پرونده خواهد بود.

با گزینه a نویسه‌های اسکی قابل چاپ بدون گریزدهی ارسال می‌شوند، در حالی که نویسه‌های خاص مانند تب‌ها و خط‌های جدید با کدهای گریز معمول درج می‌گردند.

اصلاح‌کننده ذخیره‌سازی extern را در ابتدای آرایه داده قرار می‌دهد تا اطمینان حاصل شود که آرایه داده می‌تواند با سایر واحدهای کامپایل پیوند (link) داده شود. به طور معمول، اعلان‌های ثابت در سایر واحدهای کامپایل قابل مشاهده نیستند.
به جای تولید تعریف آرایه، تنها یک اعلان (declaration) می‌نویسد که می‌تواند به عنوان یک پرونده سرآیند (header) گنجانده شود.
این گزینه باعث می‌شود reswrap پسوند پرونده را حفظ کرده و نقطه "." را با زیرخط "_" جایگزین کند. استفاده از این گزینه توصیه می‌شود زیرا خطاهای هنگام استفاده از آرایه‌های داده را کاهش می‌دهد.
این گزینه از درج توضیحاتی (کامنت‌هایی) که reswrap برای نشان دادن نام پرونده اصلیِ منبع داده اضافه می‌کند، جلوگیری می‌نماید.
پیشوند مشخص‌شده در prefix را پیش از نام منبع اضافه می‌کند؛ این قابلیت می‌تواند برای ایجاد نام کلاس‌ها یا فضاهای نام (namespaces) در ابتدای نمادها استفاده شود.
تمام اعلان‌ها را درون اعلان namespace (فضای نام) مشخص‌شده ++C تولید می‌کند. استفاده از یک namespace می‌تواند برای اطمینان از اینکه اعلان‌ها تنها در حوزه (scope) داده‌شده قابل دسترسی هستند و با نمادهای دیگر تداخل پیدا نمی‌کنند، به کار گرفته شود.
در عبارات داده تولیدشده توسط reswrap، به جای تعداد ستون‌های پیش‌فرض، cols ستون می‌نویسد. تعداد ستون‌های پیش‌فرض برای خروجی‌های دهدهی و هگزادسیمال ۱۶ نویسه است؛ مقدار پیش‌فرض برای خروجی رشته متنی ۸۰ نویسه است.
در حالت متنی، خروجی را به صورت نویسه‌های بدون علامت (unsigned char) اجبار می‌کند.
اندازه منبع را در اعلان آرایه منبع چاپ می‌کند. این امر به عملگر sizeof() در ++C اجازه می‌دهد تا حتی برای اعلان‌های خارجی (external declarations)، اندازه صحیح منبع را برگرداند. توجه داشته باشید که در حالت متنی (گزینه -t)، یک بایت اضافی به اندازه برای نویسه پایان رشته افزوده می‌شود.
به جای استفاده از یک نام منبع بر اساس نام پرونده، reswrap مقدار name را به عنوان نام منبع مورد استفاده در اعلان یا تعریف پرونده منبع بعدی جایگزین می‌کند. این قابلیت زمانی مفید است که نتوان از نام پرونده به عنوان یک شناسه استفاده کرد؛ برای مثال اگر نام پرونده یکی از کلمات کلیدی رزروشده در C یا ++C مانند "while" باشد.

هنگام استفاده از حالت رشته متنی، لطفاً به یاد داشته باشید که کامپایلر C یک نویسه تهی (nul-character) پس از رشته اضافه می‌کند که باعث می‌شود آرایه داده یک عنصر طولانی‌تر از پرونده منبع باشد.

این صفحه راهنما در ابتدا توسط Torsten Landschoff (torsten@debian.org) برای توزیع دبیان FOX Toolkit نوشته شد و در حال حاضر توسط Jeroen van der Zijp (jeroen@fox-toolkit.org) نگهداری می‌شود.

حق نشر © 1997,2005 Jeroen van der Zijp.
این یک نرم‌افزار آزاد است؛ برای شرایط نسخه‌برداری کد منبع را ببینید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

برنامه reswrap بخشی از جعبه‌ابزار رابط گرافیکی FOX GUI Toolkit است. اطلاعات بیشتر درباره reswrap را می‌توانید در نشانی زیر بیابید:

http://www.fox-toolkit.org

وب‌سایت FOX Toolkit شامل اطلاعات دقیق و جامعی درباره reswrap و نحوه استفاده از آن است.

Sept 2005 The FOX C++ GUI Toolkit