"

COPYRIGHT (c) 1989 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

DeviceWorkstation subclass:#XWorkstation

       instanceVariableNames:'screen

			      hasShapeExtension hasFaxExtension hasShmExtension

			      hasDPSExtension hasMbufExtension hasXVideoExtension

			      hasSaveUnder hasPEXExtension hasImageExtension

			      hasInputExtension ignoreBackingStore

			      blackpixel whitepixel 

			      protocolsAtom deleteWindowAtom saveYourselfAtom

			      quitAppAtom

			      primaryAtom secondaryAtom cutBuffer0Atom

			      stringAtom lengthAtom

			      listOfXFonts buttonsPressed

			      eventRootX eventRootY

			      displayName eventTrace

			      dispatchingExpose

			      rgbVisual virtualRootId rootId

			      eventBuffer'

       classVariableNames:   ''

       poolDictionaries:''

       category:'Interface-Graphics'

!

!XWorkstation class methodsFor:'documentation'!

copyright

"

COPYRIGHT (c) 1989 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

version

!

documentation

"

    this class provides the interface to X11. It redefines all required methods

    from DeviceWorkstation. Notice, that in Smalltalk/X you are not technically

    limited to one display - in theory, you can create Views on many displays

    simultanously. However, the default setup is for one display only.

    To support multiple displays, you will have to start another event dispatcher

    process for the other display(s) and create the other views with a slightly

    different protocol. However, 'normal' applications do not have to care for

    all of this ...

    See more documentation in my superclass, DeviceWorkstation.

"

! !

!XWorkstation primitiveDefinitions!

%{

/*

 * x does a typedef Time - I need Object Time ...

 */

#define Time XTime

#ifdef memset

# undef memset

#endif

#include <stdio.h>

#include <X11/Xlib.h>

#include <X11/Xutil.h>

#include <X11/Xatom.h>

#define XK_MISCELLANY

#include <X11/keysymdef.h>

/*

 * this define adds support for two-byte-strings.

 * leaving it undefined does not really save you much

 * (the define will vanish)

 */

#define TWOBYTESTRINGS

/*

 * shape support works; enabled by -DSHAPE in makefile

 * see RoundClock and RoundGlobe examples

 */

#ifdef SHAPE

# include <X11/extensions/shape.h>

#endif

/*

 * shared memory extension access is currently not supported

 * (only query is implemented)

 */

#ifdef SHM

# include <X11/extensions/XShm.h>

#endif

/*

 * multiBuffer extension access is currently not supported

 * (only query is implemented)

 */

#ifdef MBUF

# include <X11/extensions/multibuf.h>

#endif

/*

 * XVideo extension access is currently not supported

 * (only query is implemented)

 */

#ifdef XVIDEO

# include <X11/extensions/Xv.h>

#endif

/*

 * this is a non-standard fax-image decompression extension

 * (only found in megascan servers ported by myself)

 */

#ifdef FAX

# include <X11/extensions/XFAXImage.h>

#endif

/*

 * PEX extension - if available

 */

#ifdef PEX5

# include <PEX5/PEX.h>

#endif

/*

 * XImage extension - if available

 */

#ifdef XIE

# include <X11/extensions/XIE.h>

#endif

/*

 * when I have more time to check it out, I will support display-PS

 */

#ifdef DPS

# ifdef sgi

#  include <X11/extensions/XDPS.h>

#  include <X11/extensions/XDPSlib.h>

#  include <X11/extensions/dpsXclient.h>

# else

#  include <DPS/XDPS.h>

#  include <DPS/XDPSlib.h>

#  include <DPS/dpsXclient.h>

# endif

#endif

#if defined(IRIX5) || (XlibSpecificationRelease == 6)

  /*

   * accessing private data in Display ... sorry

   */

# define DISPLAYACCESS(d) ((_XPrivDisplay)d)

#else

# define DISPLAYACCESS(d) d

#endif

/*

 * some defines - tired of typing ...

 */

#define _DisplayVal(o)       (Display *)(__MKCP(o))

#define _WindowVal(o)        (Window)(__MKCP(o))

#define _PixmapVal(o)        (Pixmap)(__MKCP(o))

#define _GCVal(o)            (GC)(__MKCP(o))

#define _CursorVal(o)        (Cursor)(__MKCP(o))

#define _FontVal(o)          (XFontStruct *)(__MKCP(o))

#define _DPSContextVal(o)    (DPSContext)(__MKCP(o))

#define __MKATOMOBJ(a)       __MKSMALLINT(a)

#define _AtomVal(o)          __intVal(o)

#define __isAtomID(o)        __isSmallInteger(o)

#define myDpy                _DisplayVal(_INST(displayId))

#define ISCONNECTED          (_INST(displayId) != nil)

#ifndef THISCONTEXT_IN_REGISTER

# define BEGIN_INTERRUPTSBLOCKED /* */

# define END_INTERRUPTSBLOCKED /* */

#else

extern int __interruptsBlocked;

# define BEGIN_INTERRUPTSBLOCKED        \

    {                                   \

	int needUnblock = 0;            \

	extern OBJ __thisContext__;     \

					\

	__thisContext__ = __thisContext;\

	if (!__interruptsBlocked) {     \

	    __BLOCKINTERRUPTS();        \

	    needUnblock = 1;            \

	}

# define END_INTERRUPTSBLOCKED          \

	__thisContext = __thisContext;  \

	__thisContext__ = 0;            \

	if (needUnblock) {              \

	    __UNBLOCKINTERRUPTS();      \

	}                               \

    }

#endif

%}

! !

!XWorkstation primitiveVariables!

%{

/*

 * remembered info from private error handler

 */

static char lastErrorMsg[80] = "";

static unsigned lastRequestCode = 0;

static unsigned lastMinorCode = 0;

static unsigned lastResource = 0;

static int __debug__ = 0;

#define DPRINTF(x)      if (__debug__) { printf x; }

%}

! !

!XWorkstation primitiveFunctions!

%{

/*

 * catch X-errors and forward as errorInterrupt:#DisplayError,

 * (which itself invokes my handler and optionally raises an exceptionSignal)

 * the implementation below is somewhat wrong: it will

 * report all errors for Display, even though there could be

 * more than one display connection. (being fixed, new errorInterrupt mechanism

 * allows passing an additional argument, which is the displayID ...)

 */

static

__XErrorHandler__(dpy, event)

    Display *dpy;

    XErrorEvent *event;

{

#ifdef _AIX

printf("XError\n"); fflush(stdout);

#endif

    XGetErrorText(dpy, event->error_code, lastErrorMsg, 80);

    if (lastErrorMsg[0] == '\0') {

	sprintf(lastErrorMsg, "code: %d", event->error_code);

    }

    lastRequestCode = event->request_code;

    lastMinorCode = event->minor_code;

    lastResource = event->resourceid;

    if (@global(DeviceWorkstation_ErrorPrinting) == true) {

    }

    __errorInterruptWithIDAndParameter__(@symbol(DisplayError), __MKOBJ(dpy));

    return 0;

}

#ifdef VIRTUAL_ROOT

/*

 * added since RootWindow-macro is not suficient

 * when virtual root-windows are involved (i.e. tvtwm)

 */

static Window

getRootWindow(dpy, screen)

    Display *dpy;

{

    Window root;

    Atom vRootAtom = None;

    int i;

    Window rootReturn, parentReturn;

    Window* children;

    unsigned int numChildren;

    root = RootWindow(dpy, screen);

    /*

     * on IRIS, this creates a badwindow error - why ?

     * children contains a funny window (000034)

     */

# if !defined(IRIS) || defined(IRIX5)

    if (XQueryTree(dpy, root, &rootReturn, &parentReturn, &children, &numChildren)) {

	vRootAtom = XInternAtom(dpy, "__SWM_VROOT", True );

	if (vRootAtom != None) {

	    for (i=0; i < numChildren; i++) {

		Atom actual_type;

		int actual_format;

		unsigned long nitems, bytesafter;

		Window* newRoot = (Window*) 0;

		if (children[i]) {

		    if (XGetWindowProperty(dpy, children[i], vRootAtom,

					   0L, 1L, False, XA_WINDOW,

					   &actual_type, &actual_format, &nitems, &bytesafter,

					   (unsigned char**) &newRoot) == Success && newRoot) {

			root = *newRoot;

			break;

		    }

		}

	    }

	    if (children) XFree( children );

	}

    }

# endif

    return root;

}

#endif

%}

! !

!XWorkstation class methodsFor:'error handling'!

debug:aBoolean

%{  /* NOCONTEXT */

    __debug__ = (aBoolean == true) ? 1 : 0;

%}

!

requestCodeOfLastError

%{  /* NOCONTEXT */

    RETURN ( _MKSMALLINT(lastRequestCode) );

%}

!

minorCodeOfLastError

%{  /* NOCONTEXT */

    RETURN ( _MKSMALLINT(lastMinorCode) );

%}

!

resourceIdOfLastError

%{  /* NOCONTEXT */

    RETURN ( __MKOBJ(lastResource) );

%}

!

errorStringOfLastError

%{

    RETURN ( __MKSTRING(lastErrorMsg COMMA_CON) );

%}

!

lastErrorString

    "return the last X-error string - 

     when buffering is on, this may be

     an error for a long-ago operation"

    |string requestCode s match line|

    string := self errorStringOfLastError.

    requestCode := self requestCodeOfLastError.

    "

     X specific: search the requestCode in '/usr/lib/X11/XErrorDB',

     and append the name of the corresponding X-request

    "

    s := '/usr/lib/X11/XErrorDB' asFilename readStream.

    s notNil ifTrue:[

	match := 'XRequest.' , requestCode printString.

	line := s peekForLineStartingWith:match.

	line notNil ifTrue:[

	    string := string , ' in ' , (line copyFrom:(line indexOf:$:)+1)

	].

	s close.

    ].

    ^ string

! !

!XWorkstation methodsFor:'initialize / release'!

initializeFor:aDisplayName

    "initialize the receiver for a connection to an X-Server;

     the argument, aDisplayName may be nil (for the default server from

     DISPLAY-variable or command line argument) or the name of the server 

     as hostname:number"

    |dpyName index|

    dpyName := aDisplayName.

    dpyName isNil ifTrue:[

	"look for a '-display xxx' argument"

	Arguments notNil ifTrue:[

	    index := Arguments indexOf:'-display'.

	    (index between:1 and:(Arguments size - 1)) ifTrue:[

		dpyName := Arguments at:index+1

	    ]

	]

    ].

%{

    int scr;

    Display *dpy;

    Visual *visual;

    XVisualInfo viproto;

    XVisualInfo *vip;                   /* retured info */

    int maxRGBDepth;

    int rgbRedMask, rgbGreenMask, rgbBlueMask;

    int rgbVisualID;

    int nvi, i;

    int shapeEventBase, shapeErrorBase;

    int shmEventBase, shmErrorBase;

    int faxEventBase, faxErrorBase;

    char *type, *nm;

    int dummy;

    OBJ dpyID;

    if (_INST(displayId) != nil) {

	/*

	 * already connected - you bad guy try to

	 * trick me manually ?

	 */

	RETURN ( self );

    }

    BEGIN_INTERRUPTSBLOCKED

    if (__isString(dpyName))

	nm = (char *)_stringVal(dpyName);

    else {

	dpyName = __MKSTRING((char *)getenv("DISPLAY") COMMA_CON);

	nm = NULL;

    }

    dpy = XOpenDisplay(nm);

    if (dpy) {

	_INST(displayId) = dpyID = __MKOBJ(dpy); __STORE(self, dpyID);

#ifdef SUPERDEBUG

	XSynchronize(dpy, 1);

#endif

	XSetErrorHandler(__XErrorHandler__);

    }

    END_INTERRUPTSBLOCKED

%}.

    displayId isNil ifTrue:[

	'XWORKSTATION: cannot connect to Display.' errorPrintNL.

	^ nil

    ].

    self initializeScreenProperties.

    dispatching := false.

    dispatchingExpose := false.

    isSlow := false.

    shiftDown := false.

    ctrlDown := false.

    metaDown := false.

    altDown := false.

    motionEventCompression := true.

    buttonsPressed := 0.

    displayName := dpyName.

    protocolsAtom := nil.

    deleteWindowAtom := nil.

    saveYourselfAtom := nil.

    quitAppAtom := nil.

    self initializeDefaultValues.

    self initializeEventBuffer.

    self initializeSpecialFlags.

    self initializeKeyboardMap.

    ObjectMemory registerErrorInterruptHandler:self class forID:#DisplayError.

!

initializeDefaultValues

    buttonTranslation := ButtonTranslation.

    multiClickTimeDelta := MultiClickTimeDelta.

!

initializeEventBuffer

    |sz|