Charles.Forsyth20060303-partialeea662d19 years agoHistory
216 lines · 4.4 KB · Text
RawDownload
.TH WM 1.SH NAMEwm \- window manager.SH SYNOPSIS.B wm/wm[.I command[.IR arg ...]].SH DESCRIPTION.I Wmis an inferno window manager, providing the control mechanism forthe user to manage to order and position of a dynamic collectionof application windows.When started, it runs.IR command ,(by default.BR wm/toolbar ,see.IR toolbar (1))By itself,.I wmdoes not provide any means for starting new applications;that facility must be provided by an auxilliary program,.B wm/toolbarbeing one such example..SS Control Inferface.I Wmprovides a control interface to programs running inside itthrough the.B Wmcontextadt that can be obtained from via the.B Draw->Contextthat it passes to applications that it starts(see.IR draw-context (2)).Control messages it understands include:.TP.B start \fIwhat\fPStart input on.IR what ..I Whatcan be.BR ptr (pointer events),.BR kbd(keyboard events)and.BR control(window manager control events, see below)..TP.B key \fIcharval\fPSimulate a key event..I Charvalis the decimal value of the character that has beenpressed. The character will be sent exactly as if ithad been typed on the keyboard. This facilityis used by.IR keyboard (2)..TP.B !reshape \fItag\fP \fIreqid\fP \fIminx miny maxx maxy\fI \fR[\fIhow\fR]Reshape or create the window named.IR tag ..I Reqidis ignored;.I minx..maxygive the desired bounding rectangle of thenew window.If.I howis not given, or is.BR exact ,then.I wmwill attempt to satisfy the request exactly.Otherwise,.I howtells.I wmhow to determine the rectangle of the resulting image;it can be one of.B place(choose some appropriate position and size on screen),.B onscreen(modify the requested rectangle only so as to bringit on screen), or.B max(request the maximum available rectangle)..TP.B delete \fItag\fPDelete the window named by \fItag\fP..TP.B raiseRaise all windows for the current context above the others..TP.B lowerSend all windows for the current context to the bottom..TP.B !move \fItag\fP \fIreqid\fP \fIstartx\fP \fIstarty\fPDrag window.I taginteractively..I Reqidis ignored..I Startxand.I startygive the location of the pointer when the drag was initiated..TP.B !size \fItag\fP \fIreqid\fPInteractively resize window \fItag\fP..TP.B fixedoriginBy default, if a window changes position but not size,.I wmchanges the origin of the window without creating a new image.Sending.B fixedorigincaused.I wmalways to create a new image in that case..TP.B kbdfocus \fR[\fIin\fR]If the decimal integer.I inis non-zero, request the keyboard focus,otherwise lose the keyboard focus..PP.I Wmgenerates control messages to inform applications ofthings that have happened. These include:.TP.B rect \fIminx miny maxx maxy\fPThe screen rectangle has changed..I "minx..maxy"gives the new bounding box of the screen..TP.B haskbdfocus \fIin\fPInforms an application of its current keyboard focus state.This message is generated in response to pointer events,and due to.B kbdfocusrequests..TP.B exitThe window manager is closing down..SS Controlling ApplicationThe first application that starts under.I wmis given the privilege of being able to controlother applications running under the same.IR wm .If it sends a.B start controlmessage, then it will also see any control requestssent by applications that.I wmitself does not understand and information about applicationsstarting and leaving..I Wmaccepts several other control messages from itscontrolling application:.TP.B ctl \fIid\fP \fImsg\fPSend message.I msgto application.IR id ..TP.B endcontrolRelinquish controller status.The next application that starts will get control status.This is used, for instance, to segue smoothly between.IR logon (1)and.IR toolbar (1)..PPIf the controlling application has started control messages,.I wmsends it the following messages:.TP.B newclient \fIid\fPA new client has connected, identified by.IR id ..TP.B delclient \fIid\fPClient.I idhas left..TP.B request \fIid\fP \fImsg\fPClient.I idsent the request.I msgto the window manager, which it did not understand.This facility is used, for instance, by.IR toolbar (1)to implement the.B taskand.B untaskrequests..SH FILES.TP.B /chan/wmrectFile holding current screen rectangle..SH SOURCE.B /appl/wm/wm.b.SH "SEE ALSO".IR toolbar (1),.IR logon (1),.IR tkclient (2),.IR wmclient (2)