WRESTOOL(1) General Commands Manual WRESTOOL(1)

wrestool - استخراج منابع از فایل‌های باینری Microsoft Windows(R)

wrestool [OPTIONS]... [FILE]...

این صفحه راهنما به طور خلاصه دستور wrestool را شرح می‌دهد. این صفحه راهنما برای توزیع گنو دبیان نوشته شده است، زیرا برنامه اصلی فاقد صفحه راهنما است.

دستور wrestool فایل‌های باینری ۱۶ یا ۳۲ بیتی Microsoft Windows(R) را خوانده و منابع موجود در آن‌ها را فهرست یا استخراج می‌کند. برخی از منابع پیش از نوشته‌شدن در فایل‌ها نیازمند پردازش هستند؛ wrestool قادر است این کار را برای منابع آیکون (icon) و مکان‌نما (cursor) انجام دهد.

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

این برنامه‌ها از ساختار نحوی معمول خط فرمان گنو پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند.

استخراج منابع. (به طور پیش‌فرض، در صورتی که --output مشخص نشده باشد، منابع در خروجی استاندارد استخراج خواهند شد.)
نمایش فهرست منابع (پیش‌فرض).
شناسه نوع منبع برای منابع مورد نظر. اگر با یک خط تیره (``-'') شروع شود، شناسه (ID) باید عددی باشد؛ اگر با علامت مثبت (``+'') شروع شود، شناسه باید یک رشته متنی باشد.

شناسه نوع می‌تواند نام یک نوع منبع نیز باشد. (در این صورت، نباید با خط تیره یا علامت مثبت شروع شود.) فهرستی از انواع منابع را می‌توانید در بخش «انواع منابع (RESOURCE TYPES)» بیابید.

شناسه نام منبع برای منابع مورد نظر. مانند گزینه --type، یک علامت خط تیره یا مثبت ابتدایی، نوع داده شناسه را مشخص می‌کند.
شناسه زبان منبع. هنگام پردازش کتابخانه‌های ۱۶ بیتی بی‌تأثیر است.
انجام عملیات بر روی تمام منابع (پیش‌فرض).
محل قرارگیری منابع استخراج‌شده. اگر ``PATH'' به یک دایرکتوری موجود اشاره نکند و به یک اسلش (``/'') ختم نشود، تمام خروجی در فایل ``PATH'' نوشته خواهد شد. (این بدان معناست که اگر چندین منبع را استخراج کنید، PATH تنها حاوی آخرین منبع خواهد بود.)
محتوای منبع را تجزیه نکن - داده‌های خام را استخراج کن. (این گزینه احتمالاً در نسخه‌های آینده icoutils با --format=raw جایگزین خواهد شد.)
توضیح عملیاتی که در حال انجام است. گزینه پرحرفی (verbose) می‌تواند بیش از یک بار مشخص شود، مانند ``-vv''، تا wrestool توضیحات مفصل‌تری ارائه دهد.
نمایش پیام راهنما و خروج.
نمایش اطلاعات نسخه و خروج.

برنامه wrestool انواع منابع ذکر شده در زیر را شناسایی می‌کند. شناسه‌های این منابع همواره عددی هستند و نه رشته‌های متنی.

یک تصویر بیت‌مپ تک مکان‌نما. به عنوان بخشی از منابع group_cursor خوانده می‌شود.
یک تصویر بیت‌مپ (bitmap).
یک تصویر بیت‌مپ تک آیکون. به عنوان بخشی از منابع group_icon خوانده می‌شود. این منبع شبیه به منابع cursor است؛ مکان‌نماها شامل چهار بایت اضافی برای مختصات نقطه حساس (hotspot) هستند.
منابع مربوط به منوها (در منوهای جهنده (popup) و نوارهای منو). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند.
تعاریف (ویجت‌ها به همراه موقعیت مکانی) برای کادرهای محاوره (dialog boxes). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند.
منبع جدول رشته‌ها، شامل تعدادی رشته یونیکد (unicode). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند.
دایرکتوری فونت، حاوی اطلاعاتی درباره تعدادی از منابع فونت (8). فایل‌های فونت غیر TTF (.FON) در واقع کتابخانه‌هایی هستند که منابع در آن‌ها قرار دارند. در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند.
یک فونت منفرد - محتوای یک فایل .FNT. به عنوان بخشی از منابع fontdir خوانده می‌شود. در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند.
جداول کلیدهای میانبر صفحه‌کلید (accelerator tables). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند.
داده‌های منبع دلخواه، تعریف‌شده توسط کاربر. هیچ محدودیتی برای قالب این منابع وجود ندارد.
پشتیبانی نمی‌شود.
مجموعه‌ای از مکان‌نماها. با اعمال چند تغییر جزئی (و همراه با منابع cursor)، این منبع می‌تواند به عنوان یک فایل .CUR استخراج شود.
مجموعه‌ای از آیکون‌ها. با اعمال چند تغییر جزئی (و همراه با منابع icon)، این منبع می‌تواند به عنوان یک فایل .ICO استخراج شود.
version (16)
اطلاعات نسخه، ذخیره شده به عنوان داده باینری. می‌تواند بدون اعمال تغییرات استخراج شود، اما داده‌های آن احتمالاً کاربرد چندانی نخواهد داشت. در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند.
پشتیبانی نمی‌شود.
پشتیبانی نمی‌شود.
پشتیبانی نمی‌شود.
مکان‌نماهای متحرک. در حال حاضر نه wrestool و نه icotool از مکان‌نماها یا آیکون‌های متحرک پشتیبانی نمی‌کنند.
آیکون‌های متحرک. این موارد فقط در Windows(R) 3.x دیده شده‌اند. در حال حاضر نه wrestool و نه icotool از مکان‌نماها یا آیکون‌های متحرک پشتیبانی نمی‌کنند.

فهرست کردن تمام منابع موجود در فایل `write.exe':
$ wrestool -l write.exe
--type=3 --name=1 --lang=1033 [type=icon offset=0x3120 size=752]
--type=3 --name=2 --lang=1033 [type=icon offset=0x3410 size=304]
--type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540 size=34]
--type=16 --name=1 --lang=1033 [type=version offset=0x3564 size=808]

فهرست کردن تمام منابع آیکون (group-) در فایل `write.exe':
$ wrestool -l --type=group_icon write.exe
--type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540 size=34]

استخراج تمام آیکون‌ها در دایرکتوری جاری و نام‌گذاری فایل‌های مقصد به صورت `write.exe_T_N.ico':
$ wrestool -x --output=. -t14 write.exe
$ ls *.ico
write.exe_14_1.ico

extresso(1), genresscript(1), icotool(1).

این صفحه راهنما توسط Colin Watson <cjwatson@debian.org> برای سیستم گنو دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود). این صفحه بعداً توسط Oskar Liljeblad <oskar@osk.mine.nu> ویرایش شد.

Copyright © 2001 Colin Watson

Copyright © 2001 Oskar Liljeblad

این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به کد منبع مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی ضمانت ضمنی برای قابلیت فروش یا تناسب با یک هدف خاص.

ویندوز (Windows) علامت تجاری ثبت‌شده شرکت مایکروسافت (Microsoft Corporation) در ایالات متحده و سایر کشورها است.

April 18, 2005 wrestool (icoutils)