نام (NAME)

windmc - تولید منابع پیام ویندوز

خلاصه دستور (SYNOPSIS)

windmc [options] input-file

توضیحات (DESCRIPTION)

دستور windmc تعاریف پیام را از یک فایل ورودی (.mc) خوانده و آن‌ها را به مجموعه‌ای از فایل‌های خروجی تبدیل می‌کند. فایل‌های خروجی ممکن است از چهار نوع باشند:

"h": یک فایل سرآیند C حاوی تعاریف پیام.
"rc": یک فایل منبع (resource) قابل کامپایل توسط ابزار windres.
"bin": یک یا چند فایل باینری حاوی داده‌های منبع برای یک زبان پیام خاص.
"dbg": یک فایل include زبان C که شناسه‌های پیام را به نام نمادین آن‌ها نگاشت می‌کند.

توضیحات دقیق این قالب‌های مختلف در مستندات مایکروسافت در دسترس است.

هنگامی که windmc از قالب "mc" به قالب "bin"، "rc"، "h" و به صورت اختیاری "dbg" تبدیل انجام می‌دهد، مانند کامپایلر پیام ویندوز (Windows Message Compiler) عمل می‌کند.

گزینه‌ها (OPTIONS)

-a
--ascii_in: مشخص می‌کند که فایل ورودی مشخص‌شده ASCII است. این رفتار پیش‌فرض است.
-A
--ascii_out: مشخص می‌کند که پیام‌ها در فایل‌های خروجی "bin" باید با قالب ASCII باشند.
-b
--binprefix: مشخص می‌کند که نام فایل‌های "bin" باید پیشوندی از نام پایه (basename) فایل مبدأ داشته باشند.
-c
--customflag: بیت مشتری (customer bit) را در تمام شناسه‌های پیام تنظیم می‌کند.
-C codepage
--codepage_in codepage: تنظیم کدپیج پیش‌فرض برای تبدیل فایل ورودی به UTF16. مقدار پیش‌فرض کدپیج 1252 است.
-d
--decimal_values: ثابت‌ها را در فایل سرآیند در مبنای ده‌دهی (decimal) خروجی می‌دهد. پیش‌فرض استفاده از خروجی هگزادسیمال است.
-e ext
--extension ext: پسوند برای فایل سرآیند. مقدار پیش‌فرض پسوند .h است.
-F target
--target target: مشخص کردن قالب BFD مورد استفاده برای فایل باینری به عنوان خروجی. این یک نام هدف BFD است؛ می‌توانید از گزینه --help برای مشاهده فهرست اهداف پشتیبانی‌شده استفاده کنید. به‌طور معمول windmc از قالب پیش‌فرض استفاده خواهد کرد که اولین مورد فهرست‌شده با گزینه --help است.
-h path
--headerdir path: پوشه مقصد برای فایل سرآیند تولیدشده. پیش‌فرض پوشه جاری است.
-H
--help: فهرستی از گزینه‌های خط فرمان را نمایش داده و سپس خارج می‌شود.
-m characters
--maxlength characters: به windmc دستور می‌دهد در صورتی که طول هر پیامی از عدد مشخص‌شده فراتر رفت، یک هشدار تولید کند.
-n
--nullterminate: پایان دادن به متن پیام در فایل‌های "bin" با صفر (null-terminate). به‌طور پیش‌فرض آن‌ها با CR/LF خاتمه می‌یابند.
-o
--hresult_use: هنوز پیاده‌سازی نشده است. به "windmc" دستور می‌دهد با استفاده از تعاریف HRESULT یک فایل سرآیند OLE2 تولید کند. در صورتی که این پرچم مشخص نشود، از کدهای وضعیت استفاده می‌شود.
-O codepage
--codepage_out codepage: تنظیم کدپیج پیش‌فرض برای خروجی دادن فایل‌های متنی. مقدار پیش‌فرض کدپیج 1252 است.
-r path
--rcdir path: پوشه مقصد برای اسکریپت "rc" تولیدشده و فایل‌های "bin" تولیدشده که اسکریپت کامپایلر منابع شامل آن‌ها می‌شود. مقدار پیش‌فرض پوشه جاری است.
-u
--unicode_in: مشخص می‌کند که فایل ورودی UTF16 است.
-U
--unicode_out: مشخص می‌کند که پیام‌ها در فایل خروجی "bin" باید با قالب UTF16 باشند. این رفتار پیش‌فرض است.
-v
--verbose: فعال کردن حالت با جزئیات کامل (verbose).
-V
--version: شماره نسخه windmc را چاپ می‌کند.
-x path
--xdgb path: مسیر فایل include زبان C از نوع "dbg" که شناسه‌های پیام را به نام نمادین نگاشت می‌کند. بدون مشخص کردن این سوییچ هیچ فایلی از این دست تولید نمی‌شود.
@file: خواندن گزینه‌های خط فرمان از file. گزینه‌های خوانده‌شده در محل قرارگیری گزینه اصلی @file جایگزین می‌شوند. اگر file وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت لفظی برخورد شده و حذف نخواهد شد.
گزینه‌ها در file با نویسه‌های فاصله خالی از یکدیگر جدا می‌شوند. یک نویسه فاصله خالی می‌تواند با احاطه کردن کل گزینه درون علامت نقل‌قول تکی یا دوتایی در گزینه گنجانده شود. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با قرار دادن یک بک‌اسلش در پیش از آن درج کرد. فایل file ممکن است خود شامل گزینه‌های اضافی @file باشد؛ چنین گزینه‌هایی به‌صورت بازگشتی پردازش خواهند شد.

همچنین ببینید (SEE ALSO)

مدخل‌های Info برای binutils.

حق نشر (COPYRIGHT)

اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد، و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.