home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xfontsel.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  9.8 KB  |  265 lines

  1.  
  2.  
  3.  
  4. XFONTSEL(1)                          XFONTSEL(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xfontsel - point and click selection of X11 font names
  9.  
  10. SSYYNNTTAAXX
  11.        xxffoonnttsseell      [-_t_o_o_l_k_i_t_o_p_t_i_o_n   ...]    [--ppaatttteerrnn    _f_o_n_t_n_a_m_e]]
  12.        [[--pprriinntt]] [[--ssaammppllee _t_e_x_t]] [[--ssaammppllee1166 _t_e_x_t_1_6]] [[--nnoossccaalleedd]]
  13.  
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        The _x_f_o_n_t_s_e_l application provides a simple way to  display
  17.        the fonts known to your X server, examine samples of each,
  18.        and retrieve the X Logical Font Description ("XLFD")  full
  19.        name for a font.
  20.  
  21.        If  --ppaatttteerrnn is not specified, all fonts with XLFD 14-part
  22.        names will be selectable.  To work with only a  subset  of
  23.        the  fonts,  specify  --ppaatttteerrnn  followed by a partially or
  24.        fully qualified font  name;  e.g.,  ``-pattern  *medium*''
  25.        will  select that subset of fonts which contain the string
  26.        ``medium'' somewhere in their font name.     Be careful about
  27.        escaping wildcard characters in your shell.
  28.  
  29.        If  --pprriinntt  is  specified on the command line the selected
  30.        font specifier will be written to standard output when the
  31.        _q_u_i_t  button  is     activated.  Regardless of whether or not
  32.        --pprriinntt was specified, the font specifier may be    made  the
  33.        PRIMARY    (text) selection by activating the _s_e_l_e_c_t button.
  34.  
  35.        The --ssaammppllee option specifies the sample text to be used to
  36.        display the selected font if the font is linearly indexed,
  37.        overriding the default.
  38.  
  39.        The --ssaammppllee1166 option specifies the sample text to be  used
  40.        to  display  the     selected  font     if  the  font    is matrix
  41.        encoded, overriding the default.
  42.  
  43.        The --nnoossccaalleedd option disables the ability to select scaled
  44.        fonts  at  arbitrary  pixel or point sizes.  This makes it
  45.        clear which bitmap sizes are advertised by the server, and
  46.        can avoid an accidental and sometimes prolonged wait for a
  47.        font to be scaled.
  48.  
  49.  
  50. IINNTTEERRAACCTTIIOONNSS
  51.        Clicking any pointer button in one of the XLFD field names
  52.        will  pop  up  a menu of the currently-known possibilities
  53.        for that field.    If previous choices of other fields  were
  54.        made,  only  values for fonts which matched the previously
  55.        selected fields will be selectable; to make  other  values
  56.        selectable,  you     must  deselect     some  other  field(s) by
  57.        choosing the ``*'' entry in that field.    Unselectable val-
  58.        ues  may be omitted from the menu entirely as a configura-
  59.        tion option; see     the  SShhoowwUUnnsseelleeccttaabbllee    resource,  below.
  60.        Whenever     any  change  is  made to a field value, _x_f_o_n_t_s_e_l
  61.  
  62.  
  63.  
  64. X Version 11            Release 6                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XFONTSEL(1)                          XFONTSEL(1)
  71.  
  72.  
  73.        will  assert  ownership    of  the     PRIMARY_FONT  selection.
  74.        Other  applications  (see,  e.g., _x_t_e_r_m) may then retrieve
  75.        the selected font specification.
  76.  
  77.        Scalable fonts come back from the server with zero for the
  78.        pixel size, point size, and average width fields.  Select-
  79.        ing a font name with a zero in these positions results  in
  80.        an implementation-dependent size.  Any pixel or point size
  81.        can be selected to scale the font to  a    particular  size.
  82.        Any  average width can be selected to anamorphically scale
  83.        the font (although you may find this challenging given the
  84.        size of the average width menu).
  85.  
  86.        Clicking the left pointer button in the _s_e_l_e_c_t widget will
  87.        cause the currently selected font name to become the  PRI-
  88.        MARY text selection as well as the PRIMARY_FONT selection.
  89.        This then allows you to paste the string into other appli-
  90.        cations.      The sseelleecctt button remains highlighted to remind
  91.        you of this fact, and de-highlights when some other appli-
  92.        cation  takes the PRIMARY selection away.  The _s_e_l_e_c_t wid-
  93.        get is a toggle; pressing it when it is    highlighted  will
  94.        cause  _x_f_o_n_t_s_e_l to release the selection ownership and de-
  95.        highlight the widget.  Activating the _s_e_l_e_c_t widget  twice
  96.        is  the    only  way  to  cause _x_f_o_n_t_s_e_l to release the PRI-
  97.        MARY_FONT selection.
  98.  
  99.  
  100. RREESSOOUURRCCEESS
  101.        The application class is     XXFFoonnttSSeell.   Most  of  the  user-
  102.        interface  is configured in the app-defaults file; if this
  103.        file is missing a warning message will be printed to stan-
  104.        dard output and the resulting window will be nearly incom-
  105.        prehensible.
  106.  
  107.        Most of the significant parts of the widget hierarchy  are
  108.        documented    in       the      app-defaults     file    (normally
  109.        <XRoot>/lib/X11/app-defaults/XFontSel,     where      <XRoot>
  110.        refers to the root of the X11 install tree.)
  111.  
  112.        Application specific resources:
  113.  
  114.  
  115.        ccuurrssoorr ((class CCuurrssoorr))
  116.            Specifies the cursor for the application window.
  117.  
  118.        ppaatttteerrnn ((class PPaatttteerrnn))
  119.            Specifies  the  font  name pattern for selecting a
  120.            subset of  available  fonts.   Equivalent  to  the
  121.            --ppaatttteerrnn     option.   Most useful patterns will con-
  122.            tain at least one field delimiter; e.g.    ``*-m-*''
  123.            for monospaced fonts.
  124.  
  125.        ppiixxeellSSiizzeeLLiisstt ((class PPiixxeellSSiizzeeLLiisstt))
  126.            Specifies  a  list  of  pixel  sizes to add to the
  127.  
  128.  
  129.  
  130. X Version 11            Release 6                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XFONTSEL(1)                          XFONTSEL(1)
  137.  
  138.  
  139.            pixel size menu, so that     scalable  fonts  can  be
  140.            selected at those pixel sizes.  The default pixel-
  141.            SizeList contains 7, 30, 40, 50, and 60.
  142.  
  143.        ppooiinnttSSiizzeeLLiisstt ((class PPooiinnttSSiizzeeLLiisstt))
  144.            Specifies a list     of  point  sizes  (in    units  of
  145.            tenths  of  points) to add to the point size menu,
  146.            so that scalable fonts can be  selected    at  those
  147.            point  sizes.   The default pointSizeList contains
  148.            250, 300, 350, and 400.
  149.  
  150.        pprriinnttOOnnQQuuiitt ((class PPrriinnttOOnnQQuuiitt))
  151.            If  _T_r_u_e     the  currently     selected  font     name  is
  152.            printed to standard output when the quit button is
  153.            activated.  Equivalent to the --pprriinntt option.
  154.  
  155.        ssaammpplleeTTeexxtt ((class TTeexxtt))
  156.            The sample 1-byte text to use for linearly indexed
  157.            fonts.    Each  glyph  index is a single byte, with
  158.            newline separating lines.
  159.  
  160.        ssaammpplleeTTeexxtt1166 ((class TTeexxtt1166))
  161.            The sample 2-byte text to use  for  matrix-encoded
  162.            fonts.    Each  glyph  index  is    two bytes, with a
  163.            1-byte newline separating lines.
  164.  
  165.        ssccaalleeddFFoonnttss ((class SSccaalleeddFFoonnttss))
  166.            If _T_r_u_e then  selection    of  arbitrary  pixel  and
  167.            point sizes for scalable fonts is enabled.
  168.  
  169.        Widget specific resources:
  170.  
  171.  
  172.        sshhoowwUUnnsseelleeccttaabbllee ((class SShhoowwUUnnsseelleeccttaabbllee))
  173.            Specifies,  for each field menu, whether or not to
  174.            show values that     are  not  currently  selectable,
  175.            based  upon  previous field selections.    If shown,
  176.            the unselectable values are clearly identified  as
  177.            such  and  do  not  highlight  when the pointer is
  178.            moved down  the    menu.    The  full  name     of  this
  179.            resource     is ffiieellddNN..mmeennuu..ooppttiioonnss..sshhoowwUUnnsseelleeccttaabbllee,
  180.            class                     MMeennuuBBuutt--
  181.            ttoonn..SSiimmpplleeMMeennuu..OOppttiioonnss..SShhoowwUUnnsseelleeccttaabbllee;     where    N
  182.            is replaced with the field number  (starting  with
  183.            the  left-most  field numbered 0).  The default is
  184.            True for all but field 11 (average width of  char-
  185.            acters  in  font)  and False for field 11.  If you
  186.            never   want   to   see     unselectable     entries,
  187.            '*menu.options.showUnselectable:False'  is  a rea-
  188.            sonable thing to specify in a resource file.
  189.  
  190.  
  191. FFIILLEESS
  192.     $XFILESEARCHPATH/XFontSel
  193.  
  194.  
  195.  
  196. X Version 11            Release 6                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XFONTSEL(1)                          XFONTSEL(1)
  203.  
  204.  
  205. SSEEEE AALLSSOO
  206.        xrdb(1), xfd(1)
  207.  
  208.  
  209. BBUUGGSS
  210.        Sufficiently ambiguous patterns can be misinterpreted  and
  211.        lead  to     an initial selection string which may not corre-
  212.        spond to what the user intended and which  may  cause  the
  213.        initial    sample text output to fail to match the proffered
  214.        string.    Selecting any new field value  will  correct  the
  215.        sample  output,    though    possibly resulting in no matching
  216.        font.
  217.  
  218.        Should be able to return a FONT for the PRIMARY selection,
  219.        not just a STRING.
  220.  
  221.        Any  change in a field value will cause _x_f_o_n_t_s_e_l to assert
  222.        ownership of the     PRIMARY_FONT  selection.   Perhaps  this
  223.        should be parameterized.
  224.  
  225.        When  running  on  a  slow machine, it is possible for the
  226.        user to request a field menu before the    font  names  have
  227.        been  completely     parsed.   An  error message indicating a
  228.        missing menu is printed to stderr  but  otherwise  nothing
  229.        bad (or good) happens.
  230.  
  231.        The average-width menu is too large to be useful.
  232.  
  233. CCOOPPYYRRIIGGHHTT
  234.        Copyright 1989, 1991,  X Consortium
  235.        See _X_(_1_) for a full statement of rights and permissions.
  236.  
  237. AAUUTTHHOORR
  238.        Ralph  R. Swick, Digital Equipment Corporation/MIT Project
  239.        Athena
  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                4
  263.  
  264.  
  265.