WMLIB(2)                                                 WMLIB(2)

     NAME
          wmlib - low level access to window manager

     SYNOPSIS
          include "sys.m";
          include "draw.m";
          include "wmlib.m";
          wmlib := load Wmlib Wmlib->PATH;

          init:       fn();
          connect:  fn(ctxt: ref Draw->Context): ref Draw->Wmcontext;
          startinput:    fn(w: ref Draw->Wmcontext, devs: list of string): string;
          wmctl:    fn(w: ref Draw->Wmcontext, request: string): (string, ref Draw->Image, string);
          snarfput: fn(buf: string);
          snarfget: fn(): string;

     DESCRIPTION
          Wmlib provides basic routines to access the window manager,
          It is used by higher level modules such as tkclient(2) and
          wmclient(2) to provide window manager access to applica-
          tions.

          Init should be called once to initialise the internal state
          of Wmlib.  Connect makes a connection to the window manager
          through ctxt (see draw-context(2)). Startinput tells the
          window manager to start queuing events on the input streams
          named in devs (e.g.  ptr, kbd) so that they can be received
          by the application.

          Wmctl sends request to the window manager.  It returns a
          tuple, say (name, img, err).  If a request fails, then name
          and img will be nil and the non-empty err gives the reason.
          If the request has resized or created an image, name gives
          the tag name of the image and img holds the new image.
          Wmlib interprets the exit request itself, by killing all
          processes in the current process group, and exiting.

          Snarfget and snarfput retrieve and replace the contents of
          the window manager's snarf buffer.

     FILES
          /chan/snarf  snarf buffer maintained by wm(1)
          /chan/wm     channel for interaction with wm(1)

     SOURCE
          /appl/lib/wmclient.b

     SEE ALSO
          wm(1), wmclient(2), tkclient(2), tk(2)

     Page 1                       Plan 9             (printed 3/29/24)