Function x11rb::protocol::xproto::poly_segment

source ·
pub fn poly_segment<'c, 'input, Conn>(
    conn: &'c Conn,
    drawable: Drawable,
    gc: Gcontext,
    segments: &'input [Segment]
) -> Result<VoidCookie<'c, Conn>, ConnectionError>
where Conn: RequestConnection + ?Sized,
Expand description

draw lines.

Draws multiple, unconnected lines. For each segment, a line is drawn between (x1, y1) and (x2, y2). The lines are drawn in the order listed in the array of xcb_segment_t structures and does not perform joining at coincident endpoints. For any given line, a pixel is not drawn more than once. If lines intersect, the intersecting pixels are drawn multiple times.

TODO: include the xcb_segment_t data structure

TODO: an example

§Fields

  • drawable - A drawable (Window or Pixmap) to draw on.
  • gc - The graphics context to use.

TODO: document which attributes of a gc are used

  • segments_len - The number of xcb_segment_t structures in segments.
  • segments - An array of xcb_segment_t structures.

§Errors

  • Drawable - The specified drawable does not exist.
  • GContext - The specified gc does not exist.
  • Match - TODO: reasons?