{ "content": [ { "type": "text", "text": "# xfd (man)\n\n## NAME\n\nxfd - display all the characters in an X font\n\n## SYNOPSIS\n\nxfd [-options ...] -fn fontname\nxfd [-options ...] -fa fontname\n\n## DESCRIPTION\n\nThe xfd utility creates a window containing the name of the font being displayed, a row of\ncommand buttons, several lines of text for displaying character metrics, and a grid contain‐\ning one glyph per cell. The characters are shown in increasing order from left to right, top\nto bottom. The first character displayed at the top left will be character number 0 unless\nthe -start option has been supplied in which case the character with the number given in the\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (2 subsections)\n- **OPTIONS** (8 subsections)\n- **WIDGETS**\n- **FONTGRID RESOURCES**\n- **APPLICATION SPECIFIC RESOURCES** (5 subsections)\n- **SEE ALSO**\n- **BUGS**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "xfd", "section": "", "mode": "man", "summary": "xfd - display all the characters in an X font", "synopsis": "xfd [-options ...] -fn fontname\nxfd [-options ...] -fa fontname", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": null, "arg": null, "description": "This option specifies the core X server side font to be displayed. This can also be set with the FontGrid font resource. A font must be specified." }, { "flag": "", "long": null, "arg": null, "description": "This option specifies a Xft font to be displayed. This can also be set with the Font‐ Grid face resource. A font pattern must be specified." }, { "flag": "", "long": null, "arg": null, "description": "filled with background color by an ImageText request. This can also be set with the FontGrid boxChars resource. The default is False." }, { "flag": "", "long": null, "arg": null, "description": "be set with the FontGrid centerChars resource. The default is False." }, { "flag": "", "long": null, "arg": null, "description": "This option specifies the glyph index of the upper left hand corner of the grid. This is used to view characters at arbitrary locations in the font. This can also be set with the FontGrid startChar resource. The default is 0." }, { "flag": "", "long": null, "arg": null, "description": "This option specifies the color to be used if ImageText boxes are drawn. This can also be set with the FontGrid boxColor resource." }, { "flag": "", "long": null, "arg": null, "description": "This option specifies the number of rows in the grid. This can also be set with the FontGrid cellRows resource." }, { "flag": "", "long": null, "arg": null, "description": "This option specifies the number of columns in the grid. This can also be set with the FontGrid cellColumns resource." } ], "examples": [], "see_also": [ { "name": "X", "section": "7", "url": "https://www.chedong.com/phpMan.php/man/X/7/json" }, { "name": "xlsfonts", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/xlsfonts/1/json" }, { "name": "xrdb", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/xrdb/1/json" }, { "name": "xfontsel", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/xfontsel/1/json" }, { "name": "fc-list", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/fc-list/1/json" }, { "name": "fonts.conf", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/fonts.conf/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 4, "subsections": [] }, { "name": "DESCRIPTION", "lines": 5, "subsections": [ { "name": "-start", "lines": 3 }, { "name": "-fa -box", "lines": 20 } ] }, { "name": "OPTIONS", "lines": 3, "subsections": [ { "name": "-fn", "lines": 3 }, { "name": "-fa", "lines": 3 }, { "name": "-box", "lines": 3 }, { "name": "-center", "lines": 2 }, { "name": "-start", "lines": 4 }, { "name": "-bc", "lines": 3 }, { "name": "-rows", "lines": 3 }, { "name": "-columns", "lines": 3 } ] }, { "name": "WIDGETS", "lines": 18, "subsections": [] }, { "name": "FONTGRID RESOURCES", "lines": 5, "subsections": [] }, { "name": "APPLICATION SPECIFIC RESOURCES", "lines": 5, "subsections": [ { "name": "selectFormat", "lines": 6 }, { "name": "metricsFormat", "lines": 6 }, { "name": "rangeFormat", "lines": 7 }, { "name": "startFormat", "lines": 5 }, { "name": "nocharFormat", "lines": 5 } ] }, { "name": "SEE ALSO", "lines": 3, "subsections": [] }, { "name": "BUGS", "lines": 2, "subsections": [] }, { "name": "AUTHOR", "lines": 7, "subsections": [] } ], "sections": { "NAME": { "content": "xfd - display all the characters in an X font\n", "subsections": [] }, "SYNOPSIS": { "content": "xfd [-options ...] -fn fontname\n\nxfd [-options ...] -fa fontname\n", "subsections": [] }, "DESCRIPTION": { "content": "The xfd utility creates a window containing the name of the font being displayed, a row of\ncommand buttons, several lines of text for displaying character metrics, and a grid contain‐\ning one glyph per cell. The characters are shown in increasing order from left to right, top\nto bottom. The first character displayed at the top left will be character number 0 unless\nthe -start option has been supplied in which case the character with the number given in the", "subsections": [ { "name": "-start", "content": "The characters are displayed in a grid of boxes, each large enough to hold any single charac‐\nter in the font. Each character glyph is drawn using the PolyText16 request (used by the\nXlib routine XDrawString16) or the XftDrawString32 routine, depending on whether the -fn or" }, { "name": "-fa -box", "content": "character, showing where an ImageText16 request (used by the Xlib routine XDrawImageString16)\nwould cause background color to be displayed.\n\nThe origin of each glyph is normally set so that the character is drawn in the upper left\nhand corner of the grid cell. However, if a glyph has a negative left bearing or an unusu‐\nally large ascent, descent, or right bearing (as is the case with cursor font), some charac‐\nter may not appear in their own grid cells. The -center option may be used to force all\nglyphs to be centered in their respective cells.\n\nAll the characters in the font may not fit in the window at once. To see the next page of\nglyphs, press the Next button at the top of the window. To see the previous page, press\nPrev. To exit xfd, press Quit.\n\nIndividual character metrics (index, width, bearings, ascent and descent) can be displayed at\nthe top of the window by clicking on the desired character.\n\nThe font name displayed at the top of the window is the full name of the font, as determined\nby the server. See xlsfonts and fc-list for ways to generate lists of fonts, as well as more\ndetailed summaries of their metrics and properties.\n" } ] }, "OPTIONS": { "content": "xfd accepts all of the standard toolkit command line options along with the additional op‐\ntions listed below:\n", "subsections": [ { "name": "-fn", "content": "This option specifies the core X server side font to be displayed. This can also be\nset with the FontGrid font resource. A font must be specified.\n" }, { "name": "-fa", "content": "This option specifies a Xft font to be displayed. This can also be set with the Font‐\nGrid face resource. A font pattern must be specified.\n" }, { "name": "-box", "content": "filled with background color by an ImageText request. This can also be set with the\nFontGrid boxChars resource. The default is False.\n" }, { "name": "-center", "content": "be set with the FontGrid centerChars resource. The default is False.\n" }, { "name": "-start", "content": "This option specifies the glyph index of the upper left hand corner of the grid.\nThis is used to view characters at arbitrary locations in the font. This can also be\nset with the FontGrid startChar resource. The default is 0.\n" }, { "name": "-bc", "content": "This option specifies the color to be used if ImageText boxes are drawn. This can\nalso be set with the FontGrid boxColor resource.\n" }, { "name": "-rows", "content": "This option specifies the number of rows in the grid. This can also be set with the\nFontGrid cellRows resource.\n" }, { "name": "-columns", "content": "This option specifies the number of columns in the grid. This can also be set with\nthe FontGrid cellColumns resource.\n" } ] }, "WIDGETS": { "content": "In order to specify resources, it is useful to know the widgets which compose xfd. In the\nnotation below, indentation indicates hierarchical structure. The widget class name is given\nfirst, followed by the widget instance name. The application class name is Xfd.\n\nXfd xfd\nPaned pane\nLabel fontname\nBox box\nCommand quit\nCommand prev\nCommand next\nLabel select\nLabel metrics\nLabel range\nLabel start\nForm form\nFontGrid grid\n", "subsections": [] }, "FONTGRID RESOURCES": { "content": "The FontGrid widget is an application-specific widget, and a subclass of the Simple widget in\nthe Athena widget set. The effects and instance names of this widget's resources are given\nin the OPTIONS section. Capitalize the first letter of the resource instance name to get the\ncorresponding class name.\n", "subsections": [] }, "APPLICATION SPECIFIC RESOURCES": { "content": "The instance names of the application specific resources are given below. Capitalize the\nfirst letter of the resource instance name to get the corresponding class name. These re‐\nsources are unlikely to be interesting unless you are localizing xfd for a different lan‐\nguage.\n", "subsections": [ { "name": "selectFormat", "content": "Specifies a printf-style format string used to display information about the selected\ncharacter. The default is \"character 0x%02x%02x (%u,%u) (%#o,%#o)\". The arguments\nthat will come after the format string are char.byte1, char.byte2, char.byte1,\nchar.byte2, char.byte1, char.byte2. char.byte1 is byte 1 of the selected character.\nchar.byte2 is byte 2 of the selected character.\n" }, { "name": "metricsFormat", "content": "Specifies a printf-style format string used to display character metrics. The de‐\nfault is \"width %d; left %d, right %d; ascent %d, descent %d (font %d, %d)\". The ar‐\nguments that will come after the format string are the character metrics width,\nlbearing, rbearing, character ascent, character descent, font ascent, and font de‐\nscent.\n" }, { "name": "rangeFormat", "content": "Specifies a printf-style format string used to display the range of characters cur‐\nrently being displayed. The default is \"range: 0x%02x%02x (%u,%u) thru 0x%02x%02x\n(%u,%u)\". The arguments that will come after the format string are the following\nfields from the XFontStruct that is returned from opening the font: minbyte1,\nmincharorbyte2, minbyte1, mincharorbyte2, maxbyte1, maxcharorbyte2,\nmaxbyte1, maxcharorbyte2.\n" }, { "name": "startFormat", "content": "Specifies a printf-style format string used to display information about the charac‐\nter at the upper left corner of the font grid. The default is \"upper left: 0x%04x\n(%d,%d)\". The arguments that will come after the format string are the new charac‐\nter, the high byte of the new character, and the low byte of the new character.\n" }, { "name": "nocharFormat", "content": "Specifies a printf-style format string to display when the selected character does\nnot exist. The default is \"no such character 0x%02x%02x (%u,%u) (%#o,%#o)\". The ar‐\nguments that will come after the format string are the same as for the selectFormat\nresource.\n" } ] }, "SEE ALSO": { "content": "X(7), xlsfonts(1), xrdb(1), xfontsel(1), fc-list(1), fonts.conf(5), X Logical Font Descrip‐\ntion Conventions\n", "subsections": [] }, "BUGS": { "content": "The program should skip over pages full of non-existent characters.\n", "subsections": [] }, "AUTHOR": { "content": "Jim Fulton, MIT X Consortium; previous program of the same name by Mark Lillibridge, MIT\nProject Athena.\n\n\n\n\nX Version 11 xfd 1.1.3 XFD(1)", "subsections": [] } } } }