home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xdrawimagestring.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XDrawImageString(3X11)      XLIB FUNCTIONS   XDrawImageString(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XDrawImageString, XDrawImageString16 - draw image text
  9.  
  10. SSYYNNTTAAXX
  11.        XDrawImageString(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _s_t_r_i_n_g, _l_e_n_g_t_h)
  12.          Display *_d_i_s_p_l_a_y;
  13.          Drawable _d;
  14.          GC _g_c;
  15.          int _x, _y;
  16.          char *_s_t_r_i_n_g;
  17.          int _l_e_n_g_t_h;
  18.  
  19.        XDrawImageString16(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _s_t_r_i_n_g, _l_e_n_g_t_h)
  20.          Display *_d_i_s_p_l_a_y;
  21.          Drawable _d;
  22.          GC _g_c;
  23.          int _x, _y;
  24.          XChar2b *_s_t_r_i_n_g;
  25.          int _l_e_n_g_t_h;
  26.  
  27. AARRGGUUMMEENNTTSS
  28.        _d     Specifies the drawable.
  29.  
  30.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  31.  
  32.        _g_c     Specifies the GC.
  33.  
  34.        _l_e_n_g_t_h     Specifies the number of characters in the string
  35.          argument.
  36.  
  37.        _s_t_r_i_n_g     Specifies the character string.
  38.  
  39.        _x
  40.        _y     Specify the x and y coordinates, which are rela-
  41.          tive to the origin of the specified drawable and
  42.          define the origin of the first character.
  43.  
  44. DDEESSCCRRIIPPTTIIOONN
  45.        The _X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g_1_6 function is similar to _X_D_r_a_w_I_m_-
  46.        _a_g_e_S_t_r_i_n_g except that it uses 2-byte or 16-bit characters.
  47.        Both functions also use both the foreground and background
  48.        pixels of the GC in the destination.
  49.  
  50.        The effect is first to fill a destination rectangle with
  51.        the background pixel defined in the GC and then to paint
  52.        the text with the foreground pixel.  The upper-left corner
  53.        of the filled rectangle is at:
  54.  
  55.        [x, y - font-ascent]
  56.  
  57.        The width is:
  58.  
  59.        overall-width
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XDrawImageString(3X11)      XLIB FUNCTIONS   XDrawImageString(3X11)
  71.  
  72.  
  73.        The height is:
  74.  
  75.        font-ascent + font-descent
  76.  
  77.        The overall-width, font-ascent, and font-descent are as
  78.        would be returned by _X_Q_u_e_r_y_T_e_x_t_E_x_t_e_n_t_s using gc and
  79.        string.    The function and fill-style defined in the GC are
  80.        ignored for these functions.  The effective function is
  81.        _G_X_c_o_p_y, and the effective fill-style is _F_i_l_l_S_o_l_i_d.
  82.  
  83.        For fonts defined with 2-byte matrix indexing and used
  84.        with _X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g, each byte is used as a byte2 with a
  85.        byte1 of zero.
  86.  
  87.        Both functions use these GC components: plane-mask, fore-
  88.        ground, background, font, subwindow-mode, clip-x-origin,
  89.        clip-y-origin, and clip-mask.
  90.  
  91.        _X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g and _X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g_1_6 can generate
  92.        _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C, and _B_a_d_M_a_t_c_h errors.
  93.  
  94. DDIIAAGGNNOOSSTTIICCSS
  95.        _B_a_d_D_r_a_w_a_b_l_e
  96.          A value for a Drawable argument does not name a
  97.          defined Window or Pixmap.
  98.  
  99.        _B_a_d_G_C     A value for a GContext argument does not name a
  100.          defined GContext.
  101.  
  102.        _B_a_d_M_a_t_c_h     An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  103.  
  104.        _B_a_d_M_a_t_c_h     Some argument or pair of arguments has the cor-
  105.          rect type and range but fails to match in some
  106.          other way required by the request.
  107.  
  108. SSEEEE AALLSSOO
  109.        XDrawString(3X11), XDrawText(3X11), XLoadFont(3X11), XTex-
  110.        tExtents(3X11)
  111.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.