.\" Copyright 1989, 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.\"
.TH XFD 1 2023-02-11 "xfd 1.1.5" "X Version 11"
.SH "نام (NAME)"
xfd \- نمایش تمام نویسه‌ها در یک فونت X
.SH "خلاصه دستور (SYNOPSIS)"
.B xfd
[\-options ...] \fB\-fn\fP \fIfontname\fP
.PP
.B xfd
[\-options ...] \fB\-fa\fP \fIfontname\fP
.SH "توضیحات (DESCRIPTION)"
ابزار \fBxfd\fP پنجره‌ای حاوی نام فونت در حال نمایش، یک ردیف دکمه‌های فرمان، چندین سطر متن برای نمایش مشخصات ابعادی نویسه (metrics)، و شبکه‌ای شامل یک گلیف در هر خانه ایجاد می‌کند. نویسه‌ها به ترتیب افزایشی از چپ به راست، از بالا به پایین نشان داده می‌شوند. نخستین نویسه نمایش‌یافته در بالا سمت چپ، نویسه شماره 0 خواهد بود مگر اینکه گزینه \fB\-start\fP مشخص شده باشد که در این صورت از نویسه‌ای با شماره داده‌شده در گزینه \fB\-start\fP استفاده خواهد شد.
.PP
نویسه‌ها در شبکه‌ای از جعبه‌ها نمایش می‌یابند که هر یک برای نگه‌داری هر نویسه تکی در فونت به اندازه کافی بزرگ است. بسته به اینکه گزینه \fB\-fn\fP یا \fB\-fa\fP داده شده باشد، گلیف هر نویسه با استفاده از درخواست PolyText16 (مورد استفاده در روتین \fBXDrawString16\fP از \fIXlib\fP) یا روتین XftDrawString32 رسم می‌شود. اگر گزینه \fB\-box\fP ارائه شود، مستطیلی دور هر نویسه کشیده می‌شود که نشان می‌دهد درخواست ImageText16 (مورد استفاده در روتین \fBXDrawImageString16\fP از \fIXlib\fP) رنگ پس‌زمینه را در چه محدوده‌ای نمایش خواهد داد.
.PP
مبدأ هر گلیف معمولاً طوری تنظیم می‌شود که نویسه در گوشه بالا سمت چپ خانه شبکه رسم شود. با این حال، اگر گلیفی دارای تراز چپ (left bearing) منفی یا بالارفتگی (ascent)، پایین‌رفتگی (descent) یا تراز راست (right bearing) غیرعادی بزرگی باشد (همان‌طور که در مورد فونت \fIcursor\fP صادق است)، ممکن است برخی نویسه‌ها در خانه شبکه اختصاصی خود ظاهر نشوند. گزینه \fB\-center\fP می‌تواند برای مجبور ساختن تمام گلیف‌ها به قرارگیری در مرکز خانه‌های مربوطه‌شان به کار رود.
.PP
ممکن است تمام نویسه‌های فونت به طور هم‌زمان در پنجره نگنجند. برای مشاهده صفحه بعدی گلیف‌ها، دکمه \fINext\fP را در بالای پنجره فشار دهید. برای مشاهده صفحه قبلی، \fIPrev\fP را فشار دهید. برای خروج از \fBxfd\fP، دکمه \fIQuit\fP را فشار دهید.
.PP
مشخصات ابعادی تک‌تک نویسه‌ها (شناسه، عرض، ترازها، بالارفتگی و پایین‌رفتگی) با کلیک روی نویسه مورد نظر می‌تواند در بالای پنجره نمایش داده شود.
.PP
نام فونت نمایش‌یافته در بالای پنجره، نام کامل فونت بر اساس تعیین کارساز (سرور) است. برای بررسی روش‌های تهیه فهرستی از فونت‌ها و همچنین خلاصه‌ای دقیق‌تر از مشخصات ابعادی و ویژگی‌های آن‌ها، به \fBxlsfonts\fP(1) و \fBfc-list\fP(1) مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
\fBxfd\fP تمام گزینه‌های خط فرمان استاندارد toolkit را به همراه گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد:
.TP 8
.B \-fn \fIfont\fP
این گزینه فونت سمت کارسازِ اصلی X را برای نمایش مشخص می‌کند.
این مورد همچنین می‌تواند با
منبع \fBfont\fP در FontGrid تنظیم شود. مشخص کردن یک فونت الزامی است.
.TP 8
.B \-fa \fIfont\fP
این گزینه یک فونت Xft را برای نمایش مشخص می‌کند. این مورد همچنین می‌تواند با
منبع \fBface\fP در FontGrid تنظیم شود. یک الگوی فونت باید مشخص شود.
.TP 8
.B \-box
این گزینه مشخص می‌کند کادری به دور ناحیه‌ای که با رنگ پس‌زمینه توسط درخواست ImageText پر می‌شود، رسم گردد.
این مورد همچنین می‌تواند با
منبع \fBboxChars\fP در FontGrid تنظیم شود. مقدار پیش‌فرض False است.
.TP 8
.B \-center
این گزینه نشان می‌دهد که هر گلیف باید در خانه شبکه خود وسط‌چین شود.
این مورد همچنین می‌تواند با
منبع \fBcenterChars\fP در FontGrid تنظیم شود. مقدار پیش‌فرض False است.
.TP 8
.B \-start \fInumber\fP
این گزینه شناسه گلیف در گوشه بالا سمت چپ شبکه را مشخص می‌کند. این مورد برای مشاهده نویسه‌ها در مکان‌های دلخواه در فونت به کار می‌رود.
این مورد همچنین می‌تواند با
منبع \fBstartChar\fP در FontGrid تنظیم شود. مقدار پیش‌فرض 0 است.
.TP 8
.B \-bc \fIcolor\fP
این گزینه رنگ مورد استفاده در صورت رسم کادرهای ImageText را مشخص می‌کند.
این مورد همچنین می‌تواند با
منبع \fBboxColor\fP در FontGrid تنظیم شود.
.TP 8
.B \-rows \fInumrows\fP
این گزینه تعداد ردیف‌ها در شبکه را تعیین می‌کند.
این مورد همچنین می‌تواند با
منبع \fBcellRows\fP در FontGrid تنظیم شود.
.TP 8
.B \-columns \fInumcols\fP
این گزینه تعداد ستون‌ها در شبکه را تعیین می‌کند.
این مورد همچنین می‌تواند با
منبع \fBcellColumns\fP در FontGrid تنظیم شود.
.TP 8
.B \-help
این گزینه مشخص می‌کند که \fBxfd\fP باید پیام راهنمای نحوه استفاده را چاپ کرده و خارج شود.
.TP 8
.B \-version
این گزینه مشخص می‌کند که \fBxfd\fP باید اطلاعات نسخه را چاپ کرده و خارج شود.
.SH "ویجت‌ها (WIDGETS)"
برای تعیین منابع (resources)، دانستن ویجت‌هایی که \fBxfd\fR را تشکیل می‌دهند مفید است. در ساختار زیر، تورفتگی نشان‌دهنده ساختار سلسله‌مراتبی است. نام رده (class) ویجت ابتدا و به دنبال آن نام نمونه (instance) ویجت آمده است. نام رده برنامه Xfd است.
.sp
.nf
.\" default T 0.8i tab stops will work here;
.\" avoids a warning during XML conversion.
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
.fi
.SH "منابع FONTGRID (FONTGRID RESOURCES)"
ویجت FontGrid یک ویجت خاص این برنامه و زیررده‌ای از ویجت Simple در مجموعه ویجت Athena است. اثرات و نام‌های نمونه منابع این ویجت در بخش \fBگزینه‌ها (OPTIONS)\fP ارائه شده است. برای به دست آوردن نام رده متناظر، نخستین حرف از نام نمونه منبع را با حروف بزرگ بنویسید.
.SH "منابع خاص برنامه (APPLICATION SPECIFIC RESOURCES)"
نام‌های نمونه منابع خاص این برنامه در زیر آمده است. نخستین حرف از نام نمونه منبع را برای به دست آوردن نام رده متناظر به حروف بزرگ تبدیل کنید. این منابع احتمالاً کاربرد چندانی نخواهند داشت مگر اینکه در حال بومی‌سازی \fBxfd\fP برای زبان دیگری باشید.
.TP 8
.B selectFormat
یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش اطلاعات مربوط به نویسه انتخاب‌شده به کار می‌رود. مقدار پیش‌فرض \(lqcharacter 0x%02x%02x (%u,%u) (%#o,%#o)\(rq است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند عبارتند از: char.byte1، char.byte2، char.byte1، char.byte2، char.byte1، char.byte2. متغیر char.byte1 بایت ۱ نویسه انتخاب‌شده و char.byte2 بایت ۲ نویسه انتخاب‌شده است.
.TP 8
.B metricsFormat
یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش مشخصات ابعادی نویسه به کار می‌رود. مقدار پیش‌فرض \(lqwidth %d; left %d, right %d; ascent %d, descent %d (font %d, %d)\(rq است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند مشخصات ابعادی نویسه شامل width، lbearing، rbearing، بالارفتگی نویسه، پایین‌رفتگی نویسه، بالارفتگی فونت و پایین‌رفتگی فونت هستند.
.TP 8
.B rangeFormat
یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش محدوده نویسه‌هایی که در حال حاضر نمایش داده می‌شوند به کار می‌رود. مقدار پیش‌فرض \(lqrange: 0x%02x%02x (%u,%u) thru 0x%02x%02x (%u,%u)\(rq است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند فیلدهای زیر از ساختار 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.
.TP 8
.B startFormat
یک رشته قالب‌بندی به سبک printf را مشخص می‌کند که برای نمایش اطلاعات درباره نویسه واقع در گوشه بالا سمت چپ شبکه فونت به کار می‌رود. مقدار پیش‌فرض \(lqupper left: 0x%04x (%d,%d)\(rq است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند عبارتند از: نویسه جدید، بایت بالای نویسه جدید، و بایت پایین نویسه جدید.
.TP 8
.B nocharFormat
یک رشته قالب‌بندی به سبک printf را برای نمایش در هنگامی که نویسه انتخاب‌شده وجود ندارد مشخص می‌کند. مقدار پیش‌فرض \(lqno such character 0x%02x%02x (%u,%u) (%#o,%#o)\(rq است. آرگومان‌هایی که پس از رشته قالب‌بندی می‌آیند همانند منبع \fBselectFormat\fP هستند.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR xlsfonts (1),
.BR xrdb (1),
.BR xfontsel (1),
.BR fc-list (1),
.BR fonts.conf (5),
.I "X Logical Font Description Conventions"
.SH "گزارش باگ‌ها (BUGS)"
برنامه باید صفحاتی را که کاملاً از نویسه‌های ناموجود تشکیل شده‌اند نادیده بگیرد.
.SH "نویسندگان (AUTHORS)"
Jim Fulton، کنسرسیوم MIT X؛ برنامه پیشین با همین نام توسط Mark Lillibridge، پروژه Athena دانشگاه MIT.