.\" -*- nroff -*- .\" wrestool.1 - Manual page for wrestool. .\" .\" Copyright (C) 2001 Colin Watson .\" Copyright (C) 2001 Oskar Liljeblad .\" .\" This program is free software: you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation, either version 3 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . .\" .TH WRESTOOL "1" "April 18, 2005" "wrestool (icoutils)" .SH "نام (NAME)" wrestool \- استخراج منابع از فایل‌های باینری Microsoft Windows(R) .SH "خلاصه دستور (SYNOPSIS)" .B wrestool .RI [ OPTIONS "]... [" FILE ]... .SH "توضیحات (DESCRIPTION)" این صفحه راهنما به طور خلاصه دستور \fBwrestool\fP را شرح می‌دهد. این صفحه راهنما برای توزیع گنو دبیان نوشته شده است، زیرا برنامه اصلی فاقد صفحه راهنما است. .PP دستور wrestool فایل‌های باینری ۱۶ یا ۳۲ بیتی Microsoft Windows(R) را خوانده و منابع موجود در آن‌ها را فهرست یا استخراج می‌کند. برخی از منابع پیش از نوشته‌شدن در فایل‌ها نیازمند پردازش هستند؛ wrestool قادر است این کار را برای منابع آیکون (icon) و مکان‌نما (cursor) انجام دهد. فیلترها که به عنوان گزینه‌های خط فرمان مشخص می‌شوند، کنترل می‌کنند که چه منابعی استخراج شوند. .SH "گزینه‌ها (OPTIONS)" این برنامه‌ها از ساختار نحوی معمول خط فرمان گنو پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند. .TP .B \-x, \-\-extract استخراج منابع. (به طور پیش‌فرض، در صورتی که \-\-output مشخص نشده باشد، منابع در خروجی استاندارد استخراج خواهند شد.) .TP .B \-l, \-\-list نمایش فهرست منابع (پیش‌فرض). .TP .B \-t, \-\-type=[+|\-]ID شناسه نوع منبع برای منابع مورد نظر. اگر با یک خط تیره (``-'') شروع شود، شناسه (ID) باید عددی باشد؛ اگر با علامت مثبت (``+'') شروع شود، شناسه باید یک رشته متنی باشد. شناسه نوع می‌تواند نام یک نوع منبع نیز باشد. (در این صورت، نباید با خط تیره یا علامت مثبت شروع شود.) فهرستی از انواع منابع را می‌توانید در بخش «انواع منابع (RESOURCE TYPES)» بیابید. .TP .B \-n, \-\-name=[+|\-]ID شناسه نام منبع برای منابع مورد نظر. مانند گزینه \-\-type، یک علامت خط تیره یا مثبت ابتدایی، نوع داده شناسه را مشخص می‌کند. .TP .B \-L, \-\-language=[+|\-]ID شناسه زبان منبع. هنگام پردازش کتابخانه‌های ۱۶ بیتی بی‌تأثیر است. .TP .B \-a, \-\-all انجام عملیات بر روی تمام منابع (پیش‌فرض). .TP .B \-o, \-\-output=PATH محل قرارگیری منابع استخراج‌شده. اگر ``PATH'' به یک دایرکتوری موجود اشاره نکند و به یک اسلش (``/'') ختم نشود، تمام خروجی در فایل ``PATH'' نوشته خواهد شد. (این بدان معناست که اگر چندین منبع را استخراج کنید، PATH تنها حاوی آخرین منبع خواهد بود.) .TP .B \-R, \-\-raw محتوای منبع را تجزیه نکن - داده‌های خام را استخراج کن. (این گزینه احتمالاً در نسخه‌های آینده icoutils با \-\-format=raw جایگزین خواهد شد.) .TP .B \-v, \-\-verbose توضیح عملیاتی که در حال انجام است. گزینه پرحرفی (verbose) می‌تواند بیش از یک بار مشخص شود، مانند ``\-vv''، تا wrestool توضیحات مفصل‌تری ارائه دهد. .TP .B \-\-help نمایش پیام راهنما و خروج. .TP .B \-\-version نمایش اطلاعات نسخه و خروج. .SH "انواع منابع (RESOURCE TYPES)" برنامه wrestool انواع منابع ذکر شده در زیر را شناسایی می‌کند. شناسه‌های این منابع همواره عددی هستند و نه رشته‌های متنی. .TP .B cursor (1) یک تصویر بیت‌مپ تک مکان‌نما. به عنوان بخشی از منابع group_cursor خوانده می‌شود. .TP .B bitmap (2) یک تصویر بیت‌مپ (bitmap). .TP .B icon (3) یک تصویر بیت‌مپ تک آیکون. به عنوان بخشی از منابع group_icon خوانده می‌شود. این منبع شبیه به منابع cursor است؛ مکان‌نماها شامل چهار بایت اضافی برای مختصات نقطه حساس (hotspot) هستند. .TP .B menu (4) منابع مربوط به منوها (در منوهای جهنده (popup) و نوارهای منو). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند. .TP .B dialog (5) تعاریف (ویجت‌ها به همراه موقعیت مکانی) برای کادرهای محاوره (dialog boxes). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند. .TP .B string (6) منبع جدول رشته‌ها، شامل تعدادی رشته یونیکد (unicode). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند. .TP .B fontdir (7) دایرکتوری فونت، حاوی اطلاعاتی درباره تعدادی از منابع فونت (8). فایل‌های فونت غیر TTF (.FON) در واقع کتابخانه‌هایی هستند که منابع در آن‌ها قرار دارند. در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند. .TP .B font (8) یک فونت منفرد - محتوای یک فایل .FNT. به عنوان بخشی از منابع fontdir خوانده می‌شود. در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند. .TP .B accelerator (9) جداول کلیدهای میانبر صفحه‌کلید (accelerator tables). در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند. .TP .B rcdata (10) داده‌های منبع دلخواه، تعریف‌شده توسط کاربر. هیچ محدودیتی برای قالب این منابع وجود ندارد. .TP .B messagelist (11) پشتیبانی نمی‌شود. .TP .B group_cursor (12) مجموعه‌ای از مکان‌نماها. با اعمال چند تغییر جزئی (و همراه با منابع cursor)، این منبع می‌تواند به عنوان یک فایل .CUR استخراج شود. .TP .B group_icon (14) مجموعه‌ای از آیکون‌ها. با اعمال چند تغییر جزئی (و همراه با منابع icon)، این منبع می‌تواند به عنوان یک فایل .ICO استخراج شود. .TP .B version (16) اطلاعات نسخه، ذخیره شده به عنوان داده باینری. می‌تواند بدون اعمال تغییرات استخراج شود، اما داده‌های آن احتمالاً کاربرد چندانی نخواهد داشت. در حال حاضر wrestool از این نوع منبع پشتیبانی نمی‌کند. .TP .B dlginclude (17) پشتیبانی نمی‌شود. .TP .B plugplay (19) پشتیبانی نمی‌شود. .TP .B vxd (20) پشتیبانی نمی‌شود. .TP .B anicursor (21) مکان‌نماهای متحرک. در حال حاضر نه wrestool و نه icotool از مکان‌نماها یا آیکون‌های متحرک پشتیبانی نمی‌کنند. .TP .B aniicon (22) آیکون‌های متحرک. این موارد فقط در Windows(R) 3.x دیده شده‌اند. در حال حاضر نه wrestool و نه icotool از مکان‌نماها یا آیکون‌های متحرک پشتیبانی نمی‌کنند. .SH "مثال‌ها (EXAMPLES)" فهرست کردن تمام منابع موجود در فایل `write.exe': .br $ \fBwrestool \-l write.exe\fP \-\-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] .PP فهرست کردن تمام منابع آیکون (group-) در فایل `write.exe': .br $ \fBwrestool \-l \-\-type=group_icon write.exe\fP \-\-type=14 \-\-name=1 \-\-lang=1033 [type=group_icon offset=0x3540 size=34] .PP استخراج تمام آیکون‌ها در دایرکتوری جاری و نام‌گذاری فایل‌های مقصد به صورت `write.exe_T_N.ico': .br $ \fBwrestool \-x \-\-output=. \-t14 write.exe\fP $ \fBls *.ico\fP write.exe_14_1.ico .SH "همچنین ببینید (SEE ALSO)" .BR extresso (1), .BR genresscript (1), .BR icotool (1). .SH "نویسندگان (AUTHORS)" این صفحه راهنما توسط Colin Watson برای سیستم گنو دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود). این صفحه بعداً توسط Oskar Liljeblad ویرایش شد. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" Copyright \(co 2001 Colin Watson Copyright \(co 2001 Oskar Liljeblad این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به کد منبع مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی ضمانت ضمنی برای قابلیت فروش یا تناسب با یک هدف خاص. .SH "علائم تجاری (TRADEMARKS)" ویندوز (Windows) علامت تجاری ثبت‌شده شرکت مایکروسافت (Microsoft Corporation) در ایالات متحده و سایر کشورها است.