class X11::Display

Defined in:

lib/x11/src/x11/display.cr
minyaty/taskbar_window.cr
minyaty/x.cr

Instance Method Summary

Instance Method Detail

def error_text(code : Int32) : String #

Returns a string describing the specified error code.

###Arguments

  • code Specifies the error code for which you want to obtain a description.

###Description The #error_text function returns a string describing the specified error code. The returned text is in the encoding of the current locale. It is recommended that you use this function to obtain an error description because extensions to Xlib may define their own error codes and error strings.

###See also name, error_database_text, new, set_error_handler, set_io_error_handler, synchronize.


[View source]
def fill_rectangle(d : X11::C::Drawable, gc : X11::C::X::GC, x : Int32, y : Int32, width : UInt32, height : UInt32) : Int32 #

Fills the specified rectangle.

###Arguments

  • d Specifies the drawable.
  • gc Specifies the GC.
  • x, y Specify the x and y coordinates, which are relative to the origin of the drawable and specify the upper-left corner of the rectangle.
  • width, height Specify the width and height, which are the dimensions of the rectangle to be filled.

###Description The #fill_rectangle function fills the specified rectangle as if a four-point FillPolygon protocol request were specified for each rectangle:

[x,y] [x+width,y] [x+width,y+height] [x,y+height]

The function uses the x and y coordinates, width and height dimensions, and GC you specify.

For any given rectangle, #fill_rectangle does not draw a pixel more than once. If rectangles intersect, the intersecting pixels are drawn multiple times.

The function uses these GC components: function, plane-mask, fill-style, subwindow-mode, clip-x-origin, clip-y-origin, and clip-mask. They also use these GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, and tile-stipple-y-origin.

#fill_rectangle can generate BadDrawable, BadGC, and BadMatch errors.

###Diagnostics

  • BadDrawable A value for a Drawable argument does not name a defined Window or Pixmap.
  • BadGC A value for a GContext argument does not name a defined GContext.
  • BadMatch An InputOnly window is used as a Drawable.
  • BadMatch Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request.

###See also draw_arc, draw_point, draw_rectangle, fill_arc, fill_arcs, fill_polygon, fill_rectangles.


[View source]