home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xwctextextents.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XmbTextExtents(3X11)      XLIB FUNCTIONS     XmbTextExtents(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XmbTextExtents, XwcTextExtents - compute text extents
  9.  
  10. SSYYNNTTAAXX
  11.        int XmbTextExtents(_f_o_n_t___s_e_t, _s_t_r_i_n_g, _n_u_m___b_y_t_e_s,
  12.        _o_v_e_r_a_l_l___r_e_t_u_r_n)
  13.          XFontSet _f_o_n_t___s_e_t;
  14.          char *_s_t_r_i_n_g;
  15.          int _n_u_m___b_y_t_e_s;
  16.          XRectangle *_o_v_e_r_a_l_l___i_n_k___r_e_t_u_r_n;
  17.          XRectangle *_o_v_e_r_a_l_l___l_o_g_i_c_a_l___r_e_t_u_r_n;
  18.  
  19.        int XwcTextExtents(_f_o_n_t___s_e_t, _s_t_r_i_n_g, _n_u_m___w_c_h_a_r_s,
  20.        _o_v_e_r_a_l_l___r_e_t_u_r_n)
  21.          XFontSet _f_o_n_t___s_e_t;
  22.          wchar_t *_s_t_r_i_n_g;
  23.          int _n_u_m___w_c_h_a_r_s;
  24.          XRectangle *_o_v_e_r_a_l_l___i_n_k___r_e_t_u_r_n;
  25.          XRectangle *_o_v_e_r_a_l_l___l_o_g_i_c_a_l___r_e_t_u_r_n;
  26.  
  27. AARRGGUUMMEENNTTSS
  28.        _f_o_n_t___s_e_t     Specifies the font set.
  29.  
  30.        _n_u_m___b_y_t_e_s Specifies the number of bytes in the string
  31.          argument.
  32.  
  33.        _n_u_m___w_c_h_a_r_s
  34.          Specifies the number of characters in the string
  35.          argument.
  36.  
  37.        _o_v_e_r_a_l_l___i_n_k___r_e_t_u_r_n
  38.          Returns the overall ink dimensions.
  39.  
  40.        _o_v_e_r_a_l_l___l_o_g_i_c_a_l___r_e_t_u_r_n
  41.          Returns the overall logical dimensions.
  42.  
  43.        _s_t_r_i_n_g     Specifies the character string.
  44.  
  45. DDEESSCCRRIIPPTTIIOONN
  46.        The _X_m_b_T_e_x_t_E_x_t_e_n_t_s and _X_w_c_T_e_x_t_E_x_t_e_n_t_s functions set the
  47.        components of the specified overall_ink_return and over-
  48.        all_logical_return arguments to the overall bounding box
  49.        of the string's image and a logical bounding box for spac-
  50.        ing purposes, respectively.  They return the value
  51.        returned by _X_m_b_T_e_x_t_E_s_c_a_p_e_m_e_n_t or _X_w_c_T_e_x_t_E_s_c_a_p_e_m_e_n_t.  These
  52.        metrics are relative to the drawing origin of the string,
  53.        using the fonts loaded for the specified font set.
  54.  
  55.        If the overall_ink_return argument is non-NULL, it is set
  56.        to the bounding box of the string's character ink.  The
  57.        overall_ink_return for a nondescending, horizontally drawn
  58.        Latin character is conventionally entirely above the base-
  59.        line; that is, overall_ink_return.height <= -over-
  60.        all_ink_return.y.  The overall_ink_return for a nonkerned
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XmbTextExtents(3X11)      XLIB FUNCTIONS     XmbTextExtents(3X11)
  71.  
  72.  
  73.        character is entirely at, and to the right of, the origin;
  74.        that is, overall_ink_return.x >= 0.  A character consist-
  75.        ing of a single pixel at the origin would set over-
  76.        all_ink_return fields y = 0, x = 0, width = 1, and height
  77.        = 1.
  78.  
  79.        If the overall_logical_return argument is non-NULL, it is
  80.        set to the bounding box that provides minimum spacing to
  81.        other graphical features for the string.     Other graphical
  82.        features, for example, a border surrounding the text,
  83.        should not intersect this rectangle.
  84.  
  85.        When the _X_F_o_n_t_S_e_t has missing charsets, metrics for each
  86.        unavailable character are taken from the default string
  87.        returned by _X_C_r_e_a_t_e_F_o_n_t_S_e_t so that the metrics represent
  88.        the text as it will actually be drawn.  The behavior for
  89.        an invalid codepoint is undefined.
  90.  
  91. SSEEEE AALLSSOO
  92.        XmbTextEscapement(3X11), XmbTextPerCharExtents(3X11) _X_l_i_b
  93.        _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.