home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xfd.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  8.8 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XFD(1)                               XFD(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xfd - display all the characters in an X font
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxffdd [-options ...] --ffnn _f_o_n_t_n_a_m_e
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        The  _x_f_d     utility  creates a window containing the name of
  15.        the font being displayed, a row of command  buttons,  sev-
  16.        eral lines of text for displaying character metrics, and a
  17.        grid containing one glyph per cell.   The  characters  are
  18.        shown  in increasing order from left to right, top to bot-
  19.        tom.  The first character displayed at the top  left  will
  20.        be  character  number  0 unless the --ssttaarrtt option has been
  21.        supplied in which case the character with the number given
  22.        in the --ssttaarrtt option will be used.
  23.  
  24.        The  characters    are  displayed    in  a grid of boxes, each
  25.        large enough to hold any single    character  in  the  font.
  26.        Each character glyph is drawn using the PolyText16 request
  27.        (used by the _X_l_i_b routine  XXDDrraawwSSttrriinngg1166).   If    the  --bbooxx
  28.        option  is  given,  a  rectangle will be drawn around each
  29.        character, showing where an ImageText16 request    (used  by
  30.        the  _X_l_i_b  routine  XXDDrraawwIImmaaggeeSSttrriinngg1166)    would cause back-
  31.        ground color to be displayed.
  32.  
  33.        The origin of each glyph is normally set so that the char-
  34.        acter  is  drawn in the upper left hand corner of the grid
  35.        cell.  However, if a glyph has a negative left bearing  or
  36.        an  unusually  large ascent, descent, or right bearing (as
  37.        is the case with _c_u_r_s_o_r    font),    some  character     may  not
  38.        appear in their own grid cells.    The --cceenntteerr option may be
  39.        used to force all glyphs to be centered in  their  respec-
  40.        tive cells.
  41.  
  42.        All  the     characters in the font may not fit in the window
  43.        at once.     To see the next page of glyphs, press    the  _N_e_x_t
  44.        button  at  the    top  of     the window.  To see the previous
  45.        page, press _P_r_e_v.  To exit _x_f_d, press _Q_u_i_t.
  46.  
  47.        Individual  character  metrics  (index,    width,    bearings,
  48.        ascent  and  descent)  can  be displayed at the top of the
  49.        window by clicking on the desired character.
  50.  
  51.        The font name displayed at the top of the  window  is  the
  52.        full  name  of the font, as determined by the server.  See
  53.        _x_l_s_f_o_n_t_s for ways to generate lists of fonts, as     well  as
  54.        more detailed summaries of their metrics and properties.
  55.  
  56. OOPPTTIIOONNSS
  57.        _x_f_d  accepts  all  of  the  standard  toolkit command line
  58.        options along with the additional options listed below:
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XFD(1)                               XFD(1)
  71.  
  72.  
  73.        --ffnn _f_o_n_t
  74.            This option specifies the font  to  be  displayed.
  75.            This  can  also    be  set     with  the  FontGrid ffoonntt
  76.            resource.  A font must be specified.
  77.  
  78.        --bbooxx    This option indicates that a box     should     be  dis-
  79.            played  outlining  the  area  that would be filled
  80.            with background color  by  an  ImageText     request.
  81.            This  can  also    be set with the FontGrid bbooxxCChhaarrss
  82.            resource.  The default is False.
  83.  
  84.        --cceenntteerr This option indicates that each    glyph  should  be
  85.            centered     in  its grid.    This can also be set with
  86.            the FontGrid cceenntteerrCChhaarrss resource.  The default is
  87.            False.
  88.  
  89.        --ssttaarrtt _n_u_m_b_e_r
  90.            This option specifies the glyph index of the upper
  91.            left hand corner of the grid.   This  is     used  to
  92.            view  characters     at  arbitrary    locations  in the
  93.            font.  This can also  be     set  with  the     FontGrid
  94.            ssttaarrttCChhaarr resource.  The default is 0.
  95.  
  96.        --bbcc _c_o_l_o_r
  97.            This  option  specifies    the  color  to be used if
  98.            ImageText boxes are drawn.  This can also  be  set
  99.            with the FontGrid bbooxxCCoolloorr resource.
  100.  
  101.        --rroowwss _n_u_m_r_o_w_s
  102.            This  option  specifies    the number of rows in the
  103.            grid.  This can also  be     set  with  the     FontGrid
  104.            cceellllRRoowwss resource.
  105.  
  106.        --ccoolluummnnss _n_u_m_c_o_l_s
  107.            This option specifies the number of columns in the
  108.            grid.  This can also  be     set  with  the     FontGrid
  109.            cceellllCCoolluummnnss resource.
  110.  
  111. WWIIDDGGEETTSS
  112.        In  order  to  specify resources, it is useful to know the
  113.        widgets which compose _x_f_d.  In the notation below,  inden-
  114.        tation indicates hierarchical structure.     The widget class
  115.        name is given first, followed by the widget instance name.
  116.        The application class name is Xfd.
  117.  
  118.        Xfd  xfd
  119.         Paned  pane
  120.          Label    fontname
  121.          Box  box
  122.               Command  quit
  123.               Command  prev
  124.               Command  next
  125.          Label    select
  126.          Label    metrics
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XFD(1)                               XFD(1)
  137.  
  138.  
  139.          Label    range
  140.          Label    start
  141.          Form  form
  142.               FontGrid    grid
  143.  
  144. FFOONNTTGGRRIIDD RREESSOOUURRCCEESS
  145.        The FontGrid widget is an application-specific widget, and
  146.        a subclass of the Simple widget in the Athena widget  set.
  147.        The  effects and instance names of this widget's resources
  148.        are given in the OOPPTTIIOONNSS section.   Capitalize  the  first
  149.        letter  of  the    resource  instance name to get the corre-
  150.        sponding class name.
  151.  
  152. AAPPPPLLIICCAATTIIOONN SSPPEECCIIFFIICC RREESSOOUURRCCEESS
  153.        The instance names of the application  specific    resources
  154.        are  given  below.   Capitalize    the  first  letter of the
  155.        resource instance name  to  get    the  corresponding  class
  156.        name.   These  resources     are  unlikely    to be interesting
  157.        unless you are localizing xfd for a different language.
  158.  
  159.        sseelleeccttFFoorrmmaatt
  160.            Specifies a printf-style     format     string     used  to
  161.            display    information about the selected character.
  162.            The  default  is     "character  0x%02x%02x      (%u,%u)
  163.            (%#o,%#o)".   The  arguments  that will come after
  164.            the  format  string  are     char.byte1,  char.byte2,
  165.            char.byte1,  char.byte2,     char.byte1,  char.byte2.
  166.            char.byte1 is byte 1 of    the  selected  character.
  167.            char.byte2 is byte 2 of the selected character.
  168.  
  169.        mmeettrriiccssFFoorrmmaatt
  170.            Specifies  a  printf-style  format  string used to
  171.            display character metrics.  The default is  "width
  172.            %d; left %d, right %d; ascent %d, descent %d (font
  173.            %d, %d)".  The arguments that will come after  the
  174.            format  string  are  the     character metrics width,
  175.            lbearing, rbearing,  character  ascent,    character
  176.            descent, font ascent, and font descent.
  177.  
  178.        rraannggeeFFoorrmmaatt
  179.            Specifies  a  printf-style  format  string used to
  180.            display the range of  characters     currently  being
  181.            displayed.   The     default  is  "range:  0x%02x%02x
  182.            (%u,%u) thru 0x%02x%02x (%u,%u)".   The    arguments
  183.            that  will  come     after    the format string are the
  184.            following fields     from  the  XFontStruct     that  is
  185.            returned      from     opening   the    font:  min_byte1,
  186.            min_char_or_byte2,  min_byte1,  min_char_or_byte2,
  187.            max_byte1,      max_char_or_byte2,      max_byte1,
  188.            max_char_or_byte2.
  189.  
  190.        ssttaarrttFFoorrmmaatt
  191.            Specifies a printf-style     format     string     used  to
  192.            display    information  about  the     character at the
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XFD(1)                               XFD(1)
  203.  
  204.  
  205.            upper left corner of the font grid.   The  default
  206.            is  "upper  left:  0x%04x (%d,%d)".  The arguments
  207.            that will come after the format string are the new
  208.            character, the high byte of the new character, and
  209.            the low byte of the new character.
  210.  
  211.        nnoocchhaarrFFoorrmmaatt
  212.            Specifies a printf-style format string to  display
  213.            when  the  selected character does not exist.  The
  214.            default is "no such character  0x%02x%02x  (%u,%u)
  215.            (%#o,%#o)".   The  arguments  that will come after
  216.            the format string are the same as for the  sseelleecctt--
  217.            FFoorrmmaatt resource.
  218.  
  219. SSEEEE AALLSSOO
  220.        X(1),  xlsfonts(1),  xrdb(1),  xfontsel(1), _X _L_o_g_i_c_a_l _F_o_n_t
  221.        _D_e_s_c_r_i_p_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s
  222.  
  223. BBUUGGSS
  224.        The program should skip over pages  full     of  non-existent
  225.        characters.
  226.  
  227. AAUUTTHHOORR
  228.        Jim Fulton, MIT X Consortium; previous program of the same
  229.        name by Mark Lillibridge, MIT Project Athena.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.