نام (NAME)

xfd - نمایش تمام نویسه‌ها در یک فونت X

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

xfd [-options ...] -fn fontname

xfd [-options ...] -fa fontname

توضیحات (DESCRIPTION)

ابزار xfd پنجره‌ای حاوی نام فونت در حال نمایش، یک ردیف دکمه‌های فرمان، چندین سطر متن برای نمایش مشخصات ابعادی نویسه (metrics)، و شبکه‌ای شامل یک گلیف در هر خانه ایجاد می‌کند. نویسه‌ها به ترتیب افزایشی از چپ به راست، از بالا به پایین نشان داده می‌شوند. نخستین نویسه نمایش‌یافته در بالا سمت چپ، نویسه شماره 0 خواهد بود مگر اینکه گزینه -start مشخص شده باشد که در این صورت از نویسه‌ای با شماره داده‌شده در گزینه -start استفاده خواهد شد.

نویسه‌ها در شبکه‌ای از جعبه‌ها نمایش می‌یابند که هر یک برای نگه‌داری هر نویسه تکی در فونت به اندازه کافی بزرگ است. بسته به اینکه گزینه -fn یا -fa داده شده باشد، گلیف هر نویسه با استفاده از درخواست PolyText16 (مورد استفاده در روتین XDrawString16 از Xlib) یا روتین XftDrawString32 رسم می‌شود. اگر گزینه -box ارائه شود، مستطیلی دور هر نویسه کشیده می‌شود که نشان می‌دهد درخواست ImageText16 (مورد استفاده در روتین XDrawImageString16 از Xlib) رنگ پس‌زمینه را در چه محدوده‌ای نمایش خواهد داد.

مبدأ هر گلیف معمولاً طوری تنظیم می‌شود که نویسه در گوشه بالا سمت چپ خانه شبکه رسم شود. با این حال، اگر گلیفی دارای تراز چپ (left bearing) منفی یا بالارفتگی (ascent)، پایین‌رفتگی (descent) یا تراز راست (right bearing) غیرعادی بزرگی باشد (همان‌طور که در مورد فونت cursor صادق است)، ممکن است برخی نویسه‌ها در خانه شبکه اختصاصی خود ظاهر نشوند. گزینه -center می‌تواند برای مجبور ساختن تمام گلیف‌ها به قرارگیری در مرکز خانه‌های مربوطه‌شان به کار رود.

ممکن است تمام نویسه‌های فونت به طور هم‌زمان در پنجره نگنجند. برای مشاهده صفحه بعدی گلیف‌ها، دکمه Next را در بالای پنجره فشار دهید. برای مشاهده صفحه قبلی، Prev را فشار دهید. برای خروج از xfd، دکمه Quit را فشار دهید.

مشخصات ابعادی تک‌تک نویسه‌ها (شناسه، عرض، ترازها، بالارفتگی و پایین‌رفتگی) با کلیک روی نویسه مورد نظر می‌تواند در بالای پنجره نمایش داده شود.

نام فونت نمایش‌یافته در بالای پنجره، نام کامل فونت بر اساس تعیین کارساز (سرور) است. برای بررسی روش‌های تهیه فهرستی از فونت‌ها و همچنین خلاصه‌ای دقیق‌تر از مشخصات ابعادی و ویژگی‌های آن‌ها، به xlsfonts(1) و fc-list(1) مراجعه کنید.

گزینه‌ها (OPTIONS)

xfd تمام گزینه‌های خط فرمان استاندارد toolkit را به همراه گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد:

-fn font: این گزینه فونت سمت کارسازِ اصلی X را برای نمایش مشخص می‌کند. این مورد همچنین می‌تواند با منبع font در FontGrid تنظیم شود. مشخص کردن یک فونت الزامی است.
-fa font: این گزینه یک فونت Xft را برای نمایش مشخص می‌کند. این مورد همچنین می‌تواند با منبع face در FontGrid تنظیم شود. یک الگوی فونت باید مشخص شود.
-box: این گزینه مشخص می‌کند کادری به دور ناحیه‌ای که با رنگ پس‌زمینه توسط درخواست ImageText پر می‌شود، رسم گردد. این مورد همچنین می‌تواند با منبع boxChars در FontGrid تنظیم شود. مقدار پیش‌فرض False است.
-center: این گزینه نشان می‌دهد که هر گلیف باید در خانه شبکه خود وسط‌چین شود. این مورد همچنین می‌تواند با منبع centerChars در FontGrid تنظیم شود. مقدار پیش‌فرض False است.
-start number: این گزینه شناسه گلیف در گوشه بالا سمت چپ شبکه را مشخص می‌کند. این مورد برای مشاهده نویسه‌ها در مکان‌های دلخواه در فونت به کار می‌رود. این مورد همچنین می‌تواند با منبع startChar در FontGrid تنظیم شود. مقدار پیش‌فرض 0 است.
-bc color: این گزینه رنگ مورد استفاده در صورت رسم کادرهای ImageText را مشخص می‌کند. این مورد همچنین می‌تواند با منبع boxColor در FontGrid تنظیم شود.
-rows numrows: این گزینه تعداد ردیف‌ها در شبکه را تعیین می‌کند. این مورد همچنین می‌تواند با منبع cellRows در FontGrid تنظیم شود.
-columns numcols: این گزینه تعداد ستون‌ها در شبکه را تعیین می‌کند. این مورد همچنین می‌تواند با منبع cellColumns در FontGrid تنظیم شود.
-help: این گزینه مشخص می‌کند که xfd باید پیام راهنمای نحوه استفاده را چاپ کرده و خارج شود.
-version: این گزینه مشخص می‌کند که xfd باید اطلاعات نسخه را چاپ کرده و خارج شود.

ویجت‌ها (WIDGETS)

برای تعیین منابع (resources)، دانستن ویجت‌هایی که xfd را تشکیل می‌دهند مفید است. در ساختار زیر، تورفتگی نشان‌دهنده ساختار سلسله‌مراتبی است. نام رده (class) ویجت ابتدا و به دنبال آن نام نمونه (instance) ویجت آمده است. نام رده برنامه Xfd است.

Xfd  xfd
	Paned  pane
		Label  fontname
		Box  box
			Command  quit
			Command  prev
			Command  next
		Label  select
		Label  metrics
		Label  range
		Label  start
		Form  form
			FontGrid  grid

منابع FONTGRID (FONTGRID RESOURCES)

ویجت FontGrid یک ویجت خاص این برنامه و زیررده‌ای از ویجت Simple در مجموعه ویجت Athena است. اثرات و نام‌های نمونه منابع این ویجت در بخش گزینه‌ها (OPTIONS) ارائه شده است. برای به دست آوردن نام رده متناظر، نخستین حرف از نام نمونه منبع را با حروف بزرگ بنویسید.

منابع خاص برنامه (APPLICATION SPECIFIC RESOURCES)

نام‌های نمونه منابع خاص این برنامه در زیر آمده است. نخستین حرف از نام نمونه منبع را برای به دست آوردن نام رده متناظر به حروف بزرگ تبدیل کنید. این منابع احتمالاً کاربرد چندانی نخواهند داشت مگر اینکه در حال بومی‌سازی xfd برای زبان دیگری باشید.

selectFormat: یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش اطلاعات مربوط به نویسه انتخاب‌شده به کار می‌رود. مقدار پیش‌فرض “character 0x%02x%02x (%u,%u) (%#o,%#o)” است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند عبارتند از: char.byte1، char.byte2، char.byte1، char.byte2، char.byte1، char.byte2. متغیر char.byte1 بایت ۱ نویسه انتخاب‌شده و char.byte2 بایت ۲ نویسه انتخاب‌شده است.
metricsFormat: یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش مشخصات ابعادی نویسه به کار می‌رود. مقدار پیش‌فرض “width %d; left %d, right %d; ascent %d, descent %d (font %d, %d)” است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند مشخصات ابعادی نویسه شامل width، lbearing، rbearing، بالارفتگی نویسه، پایین‌رفتگی نویسه، بالارفتگی فونت و پایین‌رفتگی فونت هستند.
rangeFormat: یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش محدوده نویسه‌هایی که در حال حاضر نمایش داده می‌شوند به کار می‌رود. مقدار پیش‌فرض “range: 0x%02x%02x (%u,%u) thru 0x%02x%02x (%u,%u)” است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند فیلدهای زیر از ساختار XFontStruct هستند که از باز کردن فونت بازگردانده شده است: min_byte1، min_char_or_byte2، min_byte1، min_char_or_byte2، max_byte1، max_char_or_byte2، max_byte1، max_char_or_byte2.
startFormat: یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش اطلاعات درباره نویسه واقع در گوشه بالا سمت چپ شبکه فونت به کار می‌رود. مقدار پیش‌فرض “upper left: 0x%04x (%d,%d)” است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند عبارتند از: نویسه جدید، بایت بالای نویسه جدید، و بایت پایین نویسه جدید.
nocharFormat: یک رشته قالب‌بندی به سبک printf را برای نمایش در هنگامی که نویسه انتخاب‌شده وجود ندارد مشخص می‌کند. مقدار پیش‌فرض “no such character 0x%02x%02x (%u,%u) (%#o,%#o)” است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند همانند منبع selectFormat هستند.

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

X(7), xlsfonts(1), xrdb(1), xfontsel(1), fc-list(1), fonts.conf(5), X Logical Font Description Conventions

گزارش باگ‌ها (BUGS)

برنامه باید صفحاتی را که کاملاً از نویسه‌های ناموجود تشکیل شده‌اند نادیده بگیرد.

نویسندگان (AUTHORS)

Jim Fulton، کنسرسیوم MIT X؛ برنامه پیشین با همین نام توسط Mark Lillibridge، پروژه Athena دانشگاه MIT.