نام (NAME)

xfontsel - انتخاب و گزینش قلم‌های X11 با اشاره و کلیک

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

xfontsel [-toolkitoption ...] [-help] [-pattern fontname] [-print]
         [-sample text] [-sample16 text16] [-sampleUCS textUCS]
         [-scaled] [-version]

توضیحات (DESCRIPTION)

برنامه xfontsel روشی ساده برای نمایش قلم‌های شناخته‌شده برای کارساز X، بررسی نمونه‌های هر قلم، و دریافت نام کامل توصیف منطقی قلم X («XLFD») را فراهم می‌کند.

اگر -pattern مشخص نشود، تمامی قلم‌های دارای نام‌های ۱۴ بخشی XLFD قابل انتخاب خواهند بود. برای کار با زیرمجموعه‌ای از قلم‌ها، گزینه -pattern را به همراه نام نسبی یا کامل قلم مشخص کنید؛ به عنوان مثال، «-pattern *medium*» زیرمجموعه‌ای از قلم‌ها را انتخاب می‌کند که رشته «medium» در بخشی از نام آن‌ها وجود داشته باشد. در فرار دادن (اسکیپ) نویسه‌های عام (wildcard) در پوسته خود دقت کنید.

اگر -print در خط فرمان مشخص شود، شناسه قلم انتخاب‌شده هنگام فعال شدن دکمه quit در خروجی استاندارد نوشته خواهد شد. صرف‌نظر از مشخص شدن یا نشدن -print، با فعال کردن دکمه select می‌توان شناسه قلم را به انتخاب اصلی متن (PRIMARY) تبدیل کرد.

گزینه -sample متن نمونه مورد استفاده برای نمایش قلم انتخاب‌شده را در صورت اندیس‌گذاری خطی قلم مشخص کرده و مقدار پیش‌فرض را بازنویسی می‌کند.

گزینه -sample16 متن نمونه مورد استفاده برای نمایش قلم انتخاب‌شده را در صورت کدگذاری ماتریسی قلم مشخص کرده و مقدار پیش‌فرض را بازنویسی می‌کند.

گزینه -sampleUCS متن نمونه کدگذاری‌شده با فرمت UTF-8 را برای نمایش قلم انتخاب‌شده در حالتی که مقدار CHARSET_REGISTRY آن برابر با ISO10646 باشد مشخص می‌کند و مقدار پیش‌فرض را بازنویسی می‌نماید.

گزینه -scaled قابلیت انتخاب قلم‌های مقیاس‌پذیر در اندازه‌های دلخواه پیکسلی یا پوینتی را فعال می‌کند.

گزینه -help مشخص می‌کند که xfontsel باید پیام راهنمای استفاده را چاپ کرده و خارج شود.

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

تعاملات (INTERACTIONS)

کلیک کردن روی هر یک از دکمه‌های اشاره‌گر در یکی از نام‌های فیلد XLFD، منویی از گزینه‌های ممکن و شناخته‌شده فعلی برای آن فیلد را باز می‌کند. اگر فیلدهای دیگر از قبل انتخاب شده باشند، تنها مقادیر قلم‌هایی که با فیلدهای قبلاً انتخاب‌شده همخوانی دارند قابل انتخاب خواهند بود؛ برای قابل انتخاب کردن سایر مقادیر، باید انتخاب فیلد(های) دیگر را با گزینش مدخل «*» در آن فیلد لغو کنید. مقادیر غیرقابل انتخاب را می‌توان به عنوان یک گزینه پیکربندی به‌طور کامل از منو حذف کرد؛ منبع ShowUnselectable را در ادامه ببینید. هرگاه تغییری در مقدار یک فیلد ایجاد شود، xfontsel مالکیت انتخاب PRIMARY_FONT را به دست خواهد گرفت. سایر برنامه‌ها (برای نمونه، xterm) پس از آن می‌توانند مشخصات قلم انتخاب‌شده را دریافت کنند.

قلم‌های مقیاس‌پذیر با مقدار صفر برای فیلدهای اندازه پیکسل، اندازه پوینت و پهنای میانگین از سمت کارساز برگردانده می‌شوند. انتخاب نام قلم با مقدار صفر در این جایگاه‌ها منجر به اندازه‌ای وابسته به پیاده‌سازی می‌شود. هر اندازه پیکسل یا پوینتی را می‌توان برای مقیاس‌بندی قلم به اندازه‌ای مشخص انتخاب کرد. هر پهنای میانگینی را نیز می‌توان برای مقیاس‌بندی آنامورفیک قلم برگزید (گرچه با توجه به اندازه منوی پهنای میانگین، ممکن است این کار دشوار باشد).

کلیک کردن با دکمه چپ اشاره‌گر روی ویجت select باعث می‌شود نام قلم انتخاب‌شده فعلی به انتخاب متنی PRIMARY و همچنین انتخاب PRIMARY_FONT تبدیل شود. این قابلیت به شما امکان می‌دهد رشته را در سایر برنامه‌ها جای‌گذاری (paste) کنید. دکمه select به صورت برجسته باقی می‌ماند تا این موضوع را یادآوری کند، و زمانی که برنامه دیگری انتخاب PRIMARY را تصاحب کند از حالت برجسته خارج می‌شود. ویجت select به صورت کلید دوحالته عمل می‌کند؛ فشردن آن در هنگام برجسته بودن باعث می‌شود xfontsel مالکیت انتخاب را رها کرده و ویجت از حالت برجسته خارج شود. دوبار فعال کردن ویجت select تنها راهی است که باعث می‌شود xfontsel انتخاب PRIMARY_FONT را رها سازد.

منابع (RESOURCES)

کلاس برنامه XFontSel است. بخش عمده رابط کاربری در فایل app-defaults پیکربندی می‌شود؛ در صورت مفقود بودن این فایل، یک پیام هشدار در خروجی استاندارد چاپ شده و پنجره حاصل تقریباً غیرقابل درک خواهد بود.

بخش عمده‌ای از قسمت‌های مهم ساختار سلسله‌مراتبی ویجت‌ها در مسیر زیر مستند شده‌اند: /usr/share/X11/app-defaults/XFontSel،

منابع خاص برنامه:

cursor (class Cursor): مکان‌نما (cursor) را برای پنجره برنامه مشخص می‌کند.
pattern (class Pattern): الگوی نام قلم را برای انتخاب زیرمجموعه‌ای از قلم‌های موجود مشخص می‌کند. معادل گزینه -pattern است. کاربردی‌ترین الگوها دست‌کم شامل یک جداکننده فیلد خواهند بود؛ مانند «*-m-*» برای قلم‌های تک‌فاصله (monospaced).
pixelSizeList (class PixelSizeList): فهرستی از اندازه‌های پیکسلی را جهت افزودن به منوی اندازه پیکسل مشخص می‌کند، تا بتوان قلم‌های مقیاس‌پذیر را در آن اندازه‌های پیکسلی انتخاب کرد. فهرست پیش‌فرض pixelSizeList شامل مقادیر 7، 30، 40، 50 و 60 است.
pointSizeList (class PointSizeList): فهرستی از اندازه‌های پوینت (بر حسب یک‌دهم پوینت) را برای افزودن به منوی اندازه پوینت مشخص می‌کند تا بتوان قلم‌های مقیاس‌پذیر را در آن اندازه‌های پوینت انتخاب کرد. فهرست پیش‌فرض pointSizeList شامل مقادیر 250، 300، 350 و 400 است.
printOnQuit (class PrintOnQuit): در صورت تنظیم روی True، نام قلمِ در حال حاضر انتخاب‌شده، هنگام فعال شدن دکمه خروج در خروجی استاندارد چاپ می‌شود. معادل گزینه -print است.
sampleText (class Text): متن نمونه ۱ بایتی مورد استفاده برای قلم‌های اندیس‌گذاری‌شده خطی. هر نمایه گلیف (glyph index) یک بایت است و خطوط با نویسه خط جدید از هم جدا می‌شوند.
sampleText16 (class Text16): متن نمونه ۲ بایتی مورد استفاده برای قلم‌های کدگذاری‌شده ماتریسی. هر نمایه گلیف دو بایت است و خطوط با نویسه ۱ بایتی خط جدید از هم جدا می‌شوند.
scaledFonts (class ScaledFonts): در صورت تنظیم روی True، امکان انتخاب اندازه‌های پیکسلی و پوینتی دلخواه برای قلم‌های مقیاس‌پذیر فعال می‌شود.

منابع خاص ویجت‌ها:

showUnselectable (class ShowUnselectable): برای هر منوی فیلد مشخص می‌کند که آیا مقادیری که در حال حاضر بر اساس فیلدهای قبلی انتخاب‌شده قابل انتخاب نیستند نمایش داده شوند یا خیر. در صورت نمایش، مقادیر غیرقابل انتخاب به وضوح مشخص می‌شوند و با حرکت دادن نشانگر روی منو برجسته نخواهند شد. نام کامل این منبع fieldN.menu.options.showUnselectable و کلاس آن MenuButton.SimpleMenu.Options.ShowUnselectable است؛ که در آن N با شماره فیلد (از چپ‌ترین فیلد با شماره 0) جایگزین می‌شود. مقدار پیش‌فرض برای همه به جز فیلد 11 (میانگین پهنای نویسه‌ها در قلم) برابر با True و برای فیلد 11 برابر با False است. اگر هرگز نمی‌خواهید ورودی‌های غیرقابل انتخاب را ببینید، مقدار '*menu.options.showUnselectable:False' گزینه مناسبی برای درج در فایل منابع است.

فایل‌ها (FILES)

$XFILESEARCHPATH/XFontSel

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

xrdb(1), xfd(1), X Logical Font Description Conventions

اشکالات (BUGS)

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

باید بتواند برای انتخاب PRIMARY یک FONT بازگرداند، نه فقط یک STRING.

هرگونه تغییر در مقدار یک فیلد باعث می‌شود xfontsel ادعای مالکیت انتخاب PRIMARY_FONT را داشته باشد. شاید بهتر باشد این مورد پارامتریک و قابل تنظیم شود.

هنگام اجرا روی یک سیستم کند، این احتمال وجود دارد که کاربر پیش از تجزیه کامل نام‌های قلم، منوی فیلدی را درخواست کند. در این حالت پیام خطایی مبنی بر گم شدن منو در stderr چاپ می‌شود اما به غیر از آن اتفاق بد (یا خوبی) رخ نمی‌دهد.

منوی میانگین پهنا (average-width) برای کاربردی بودن بیش از حد بزرگ است.

نویسنده (AUTHOR)

Ralph R. Swick, Digital Equipment Corporation/MIT Project Athena

Mark Leisher <mleisher@crl.nmsu.edu> پشتیبانی از متن نمونه UTF-8 را اضافه کرد.