ftp.nice.ch/NiCE/X/xv-3.00a.tar.gz#/xv-3.00a/xvgrab.c

This is xvgrab.c in view mode; [Download] [Up]

/*
 * xvgrab.c - image grabbing (from the display) functions for XV
 *
 *  Author:    John Bradley, University of Pennsylvania
 *                (bradley@cis.upenn.edu)
 *
 *  Contains:
 *     int Grab()             - handles the GRAB command
 *     int LoadGrab();        - 'loads' the pic from the last succesful Grab
 *            
 */

/* Copyright Notice
 * ================
 * Copyright 1989, 1990, 1991, 1992, 1993 by John Bradley
 * 
 * Permission to use, copy, and distribute XV in its entirety, for 
 * non-commercial purposes, is hereby granted without fee, provided that
 * this license information and copyright notice appear in all copies.
 * 
 * Note that distributing XV 'bundled' in with ANY product is considered
 * to be a 'commercial purpose'.
 *
 * Also note that any copies of XV that are distributed MUST be built
 * and/or configured to be in their 'unregistered copy' mode, so that it
 * is made obvious to the user that XV is shareware, and that they should
 * consider donating, or at least reading this License Info.
 * 
 * The software may be modified for your own purposes, but modified
 * versions may NOT be distributed without prior consent of the author.
 * 
 * This software is provided 'as-is', without any express or implied
 * warranty.  In no event will the author be held liable for any damages
 * arising from the use of this software.
 * 
 * If you would like to do something with XV that this copyright
 * prohibits (such as distributing it with a commercial product, 
 * using portions of the source in some other program, etc.), please
 * contact the author (preferably via email).  Arrangements can
 * probably be worked out.
 *
 * XV is shareware for PERSONAL USE only.  You may use XV for your own
 * amusement, and if you find it nifty, useful, generally cool, or of
 * some value to you, your non-deductable donation would be greatly
 * appreciated.  $25 is the suggested donation, though, of course,
 * larger donations are quite welcome.  Folks who donate $25 or more
 * can receive a Real Nice bound copy of the XV manual for no extra
 * charge.
 * 
 * Commercial, government, and institutional users MUST register their
 * copies of XV, for the exceedingly REASONABLE price of just $25 per
 * workstation/X terminal.  Site licenses are available for those who
 * wish to run XV on a large number of machines.  Contact the author
 * for more details.
 *
 * The author may be contacted via:
 *    US Mail:  John Bradley
 *              1053 Floyd Terrace
 *              Bryn Mawr, PA  19010
 *
 *    Phone:    (215) 898-8813
 *    EMail:    bradley@cis.upenn.edu
 */


#include "xv.h"

static byte *grabPic = (byte *) NULL;
static int  gbits;                              /* either '8' or '24' */
static byte grabmapR[256], grabmapG[256], grabmapB[256];  /* colormap */
static int  gWIDE,gHIGH;

static GC   rootGC;

/* local function definitions */
#ifdef __STDC__
static void flashrect(int, int, int, int, int);
static void startflash();
static void endflash();
static int grabImage(Window, int, int, int, int);
static void ungrabX(void);
static int convertImage(XImage *, XColor *, int, XWindowAttributes *);
static int lowbit(unsigned long);
static int getxcolors(XWindowAttributes *, XColor **);
static Window xvClientWindow(Display *, Window);
#else
static void flashrect(), startflash(), endflash(), ungrabX();
static int grabImage(), convertImage(), lowbit(), getxcolors();
static Window xvClientWindow();
#endif

#define GRAB_BUTTON

/***********************************/
int Grab()
{
  /* does UI part of Grab command.  returns '1' on success */

  int          i,x,y,x1,y1,x2,y2, ix, iy, iw, ih;
  Window       rW,cW, clickWin, tmpwin;
  int          rx,ry;
  unsigned int mask;


  if (grabDelay>0) sleep(grabDelay);


  rootGC = DefaultGC(theDisp, theScreen);

  /* throw away previous 'grabbed' pic, if there is one */
  if (grabPic) {  free(grabPic);  grabPic = (byte *) NULL; }


  {
    XColor fc, bc;
    fc.flags = bc.flags = DoRed | DoGreen | DoBlue;
    fc.red = fc.green = fc.blue = 0xffff;  
    bc.red = bc.green = bc.blue = 0x0000;
    
    XRecolorCursor(theDisp, tcross, &fc, &bc);
  }


#ifdef GRAB_BUTTON
  XGrabButton(theDisp, AnyButton, 0, rootW, False, 0L, GrabModeAsync,
	      GrabModeSync, None, tcross);
#else
  i = XGrabPointer(theDisp, rootW, False, 0L, GrabModeAsync, GrabModeSync,
		   None, tcross, CurrentTime);
#endif


  XBell(theDisp, 0);    /* beep once at start of grab */
  if (DEBUG>1) fprintf(stderr,"pointer grabbed\n");


  /* wait for a button press */
  while (1) {
    if (XQueryPointer(theDisp,rootW,&rW,&cW,&rx,&ry,&x1,&y1,&mask)) {
      if (mask & (Button1Mask | Button2Mask | Button3Mask)) break;
    }
  }
  if (DEBUG>1) fprintf(stderr,"got button click\n");



  if (mask & Button3Mask || rW!=rootW) {        /* Button3: CANCEL GRAB */
    while (1) {      /* wait for button to be released */
      if (XQueryPointer(theDisp,rootW,&rW,&cW,&rx,&ry,&x1,&y1,&mask)) {
	if (!(mask & Button3Mask)) break;
      }
    }

#ifdef GRAB_BUTTON
    XUngrabButton(theDisp, AnyButton, 0, rootW);
#else
    XUngrabPointer(theDisp, CurrentTime);
#endif

    XBell(theDisp, 0);
    XBell(theDisp, 0);
  
    return 0;
  }



  if (mask & Button1Mask) {  /* Button1:  GRAB WINDOW (& FRAME, maybe)  */
    while (1) {  /* wait for button to be released */
      int rx,ry,x1,y1;  Window rW, cW;
      if (XQueryPointer(theDisp,rootW,&rW,&cW,&rx,&ry,&x1,&y1,&mask)) {
	if (!(mask & Button1Mask)) break;
      }
    }

    if (!cW || cW == rootW) clickWin = rootW;
    else {
      int xr, yr;    Window chwin;
      XTranslateCoordinates(theDisp, rW, cW, rx, ry, &xr, &yr, &chwin);
      if (chwin != None) {
	XWindowAttributes clickxwa, parentxwa;

	clickWin = xvClientWindow(theDisp, chwin);

	/* decide if we want to just grab clickWin, or cW.
	   basically, if they're different in any important way 
	   (depth, visual, colormap), grab 'clickWin' only, 
	   as it's the important part */

	if (!clickWin || 
	    (XGetWindowAttributes(theDisp, clickWin, &clickxwa)  &&
	     XGetWindowAttributes(theDisp, cW,       &parentxwa) &&
	     clickxwa.visual->class == parentxwa.visual->class   &&
	     clickxwa.colormap      == parentxwa.colormap        &&
	     clickxwa.depth         == parentxwa.depth)
	    )
	  clickWin = cW;   	  /* close enough! */
      }

      if (DEBUG) 
	fprintf(stderr, "rW = %x, cW = %x, chwin = %x, clickWin = %x\n",
		rW, cW, chwin, clickWin);
    }


    if (clickWin == rootW) {   /* grab entire screen */
      if (DEBUG) fprintf(stderr,"Grab: clicked on root window.\n");
      ix = iy = 0;  iw = dispWIDE;  ih = dispHIGH;
    }
    else {
      int x,y,bwr,dr;  Window win;

      if (XGetGeometry(theDisp,clickWin,&rW, &x, &y, &iw, &ih, &bwr, &dr)) {
	XTranslateCoordinates(theDisp, clickWin, rootW, 0, 0, &ix,&iy, &win);

	if (DEBUG) fprintf(stderr,"clickWin=0x%x: %d,%d %dx%d depth=%d\n", 
			   clickWin, ix, iy, iw, ih, dr);    
      }
      else {
	ix = iy = 0;  iw = dispWIDE;  ih = dispHIGH;  clickWin = rootW;
	if (DEBUG) fprintf(stderr,"XGetGeometry failed? (using root win)\n");
      }
    }


    /* range checking:  keep rectangle fully on-screen */
    if (ix<0) { iw += ix;  ix = 0; }
    if (iy<0) { ih += iy;  iy = 0; }
    if (ix+iw>dispWIDE) iw = dispWIDE-ix;
    if (iy+ih>dispHIGH) ih = dispHIGH-iy;


    if (DEBUG) fprintf(stderr,"using %d,%d (%dx%d)\n", ix, iy, iw, ih);

    /* flash the rectangle a bit... */
    startflash();
    for (i=0; i<5; i++) {
      flashrect(ix, iy, iw, ih, 1);
      XFlush(theDisp);  Timer(100);
      flashrect(ix, iy, iw, ih, 0);
      XFlush(theDisp);  Timer(100);
    }
    endflash();
  }


  else {  /* Button2:  TRACK A RECTANGLE */
    int    origrx, origry;
    Window origcW;

    clickWin = rootW;  origcW = cW;
    origrx = ix = x2 = rx;
    origry = iy = y2 = ry;
    iw = ih = 0;
    
    XGrabServer(theDisp);
    startflash();

    /* Wait for button release while tracking rectangle on screen */
    while (1) {
      if (XQueryPointer(theDisp,rootW,&rW,&cW,&rx,&ry,&x,&y,&mask)) {
	if (!(mask & Button2Mask)) break;
      }

      flashrect(ix, iy, iw, ih, 0);    /* turn off rect */

      if (rx!=x2 || ry!=y2) {          /* move rectangle */
	ix = (x1<rx) ? x1 : rx;
	iy = (y1<ry) ? y1 : ry;
	iw = abs(rx - x1);  ih = abs(ry - y1);
	x2 = rx;  y2 = ry;
      }
      
      if (iw>1 && ih>1)
	flashrect(ix, iy, iw, ih, 1);  /* turn on rect */
    }

    flashrect(ix, iy, iw, ih, 0);      /* turn off rect */
    endflash();

    XUngrabServer(theDisp);


    if (origcW == cW) {  /* maybe it's entirely in one window??? */
      Window stwin, enwin, stwin1, enwin1;
      if (DEBUG) fprintf(stderr,"origcW=%x cW=%x   ", origcW, cW);
      XTranslateCoordinates(theDisp,rootW,cW, origrx,origry,&x,&y,&stwin);
      XTranslateCoordinates(theDisp,rootW,cW, rx,    ry,    &x,&y,&enwin);

      if (DEBUG) fprintf(stderr,"stwin=%x enwin=%x   ", stwin, enwin);
      if (stwin == enwin && stwin != None) {
	stwin1 = xvClientWindow(theDisp, stwin);
	enwin1 = xvClientWindow(theDisp, enwin);
	if (DEBUG) fprintf(stderr,"stwin1=%x enwin1=%x   ", stwin1, enwin1);

	if (stwin1 == enwin1 && stwin1) clickWin = stwin1;
	else clickWin = stwin;
      }
    }
    if (DEBUG) fprintf(stderr,"\n");
  }


  WaitCursor();
  XGrabServer(theDisp);  /* until we've done the grabImage */

  if (DEBUG>1) 
    fprintf(stderr,"grabbing %dx%d region, at %d,%d\n", iw, ih, ix, iy);

  i = grabImage(clickWin, ix, iy, iw, ih);  /* ungrabs the server & button */

  SetCursors(-1);
  return i;
}


/***********************************/
static void flashrect(x,y,w,h,show)
     int x,y,w,h,show;
{
  static int isvis  = 0;
  static int maskno = 0;

  static unsigned long masks[8] = { 0x01010101,
				    0x02020203,
				    0x04040405,
				    0x08080809,
				    0x10101011,
				    0x20202021,
				    0x40404041,
				    0x80808081 };

  XSetPlaneMask(theDisp, rootGC, masks[maskno]);

  if (!show) {     /* turn off rectangle */
    if (isvis) XDrawRectangle(theDisp, rootW, rootGC, x, y, w-1, h-1);
    isvis = 0;
  }
  else {           /* show rectangle */
    if (!isvis && w>1 && h>1) {
      maskno = (maskno + 1) & 7;
      XSetPlaneMask(theDisp, rootGC, masks[maskno]);
      XDrawRectangle(theDisp, rootW, rootGC, x, y, w-1, h-1);
      isvis = 1;
    }
  }
}


/***********************************/
static void startflash()
{  
  /* set up for drawing a flashing rectangle */
  XSetFunction(theDisp, rootGC, GXinvert);
  XSetSubwindowMode(theDisp, rootGC, IncludeInferiors);
}

/***********************************/
static void endflash()
{  
  XSetFunction(theDisp, rootGC, GXcopy);
  XSetSubwindowMode(theDisp, rootGC, ClipByChildren);
  XSetPlaneMask(theDisp, rootGC, AllPlanes);
  XSync(theDisp, False);
}




/***********************************/
static int grabImage(clickWin, x, y, w, h)
     Window clickWin;
     int    x, y, w, h;
{
  /* attempts to grab the specified rectangle of the root window
     returns '1' on success.  clickWin is used to figure out the depth
     and colormap to use */

  XImage *image;
  XWindowAttributes xwa;
  XColor *colors;
  int ncolors, i, ix, iy;
  char str[256];
  Window win;


  /* range checking */
  if (x<0) { w += x;  x = 0; }
  if (y<0) { h += y;  y = 0; }
  if (x+w>dispWIDE) w = dispWIDE-x;
  if (y+h>dispHIGH) h = dispHIGH-y;

  if (w==0 || h==0) {  /* selected nothing */
    ungrabX();
    return 0;
  }

  if (!XGetWindowAttributes(theDisp, clickWin, &xwa)) {
    sprintf(str,"Unable to get window attributes for clicked-on window\n");
    ungrabX();
    ErrPopUp(str, "\nThat Sucks!");
    return 0;
  }


  XTranslateCoordinates(theDisp, rootW, clickWin, x, y, &ix, &iy, &win);

  image = XGetImage(theDisp, clickWin, ix, iy, w, h, AllPlanes, ZPixmap);
  if (!image || !image->data) {
    sprintf(str, "Unable to get image (%d,%d %dx%d) from display", ix,iy,w,h);
    ungrabX();
    ErrPopUp(str, "\nThat Sucks!");
    return 0;
  }

  ncolors = getxcolors(&xwa, &colors);

  ungrabX();

  if (ncolors && DEBUG) {
    fprintf(stderr, "Colormap:\n");
    for (i=0; i<ncolors; i++)
      fprintf(stderr,"%02x%02x%02x  ",colors[i].red>>8, colors[i].green>>8,
	      colors[i].blue>>8);
    fprintf(stderr,"\n");
  }


  XBell(theDisp, 0);    /* beep twice at end of grab */
  XBell(theDisp, 0);

  i = convertImage(image, colors, ncolors, &xwa);

  xvDestroyImage(image);
  free((char *) colors);

  return i;
}


static void ungrabX()
{
  XUngrabServer(theDisp);

#ifdef GRAB_BUTTON
    XUngrabButton(theDisp, AnyButton, 0, rootW);
#else
    XUngrabPointer(theDisp, CurrentTime);
#endif
}





union swapun {
  CARD32 l;
  CARD16 s;
  CARD8  b[sizeof(CARD32)];
};


/**************************************/
static int convertImage(image, colors, ncolors, xwap)
     XImage *image;
     XColor *colors;
     int     ncolors;
     XWindowAttributes *xwap;
{
  /* attempts to conver the image from whatever weird-ass format it might
     be in into something E-Z to deal with (either an 8-bit colormapped
     image, or a 24-bit image).  Returns '1' on success. */

  /* this code owes a lot to 'xwdtopnm.c', part of the pbmplus package,
     written by Jef Poskanzer */

  int             i, j;
  CARD8          *bptr, tmpbyte;
  CARD16         *sptr, sval;
  CARD32         *lptr, lval;
  CARD8          *pptr, *lineptr;
  int            bits_used, bits_per_item, bit_shift, bit_order;
  int            bits_per_pixel, byte_order;
  CARD32         pixvalue, pixmask, rmask, gmask, bmask;
  int            rshift, gshift, bshift, r8shift, g8shift, b8shift;
  CARD32         rval, gval, bval;
  union swapun   sw;
  int            isLsbMachine, flipBytes;
  Visual         *visual;

  char errstr[256];
  static char *foo[] = { "\nThat Sucks!" };

  /* determine byte order of the machine we're running on */
  sw.l = 1;
  isLsbMachine = (sw.b[0]) ? 1 : 0;

  if (xwap && xwap->visual) visual = xwap->visual;
                       else visual = theVisual;

  if (DEBUG) {
    fprintf(stderr,"convertImage:\n");
    fprintf(stderr,"  %dx%d (offset %d), %s\n",
	    image->width, image->height, image->xoffset, 
	    (image->format == XYBitmap || image->format == XYPixmap) 
	    ? "XYPixmap" : "ZPixmap");

    fprintf(stderr,"byte_order = %s, bitmap_bit_order = %s, unit=%d, pad=%d\n",
	    (image->byte_order == LSBFirst) ? "LSBFirst" : "MSBFirst",
	    (image->bitmap_bit_order == LSBFirst) ? "LSBFirst" : "MSBFirst",
	    image->bitmap_unit, image->bitmap_pad);

    fprintf(stderr,"depth = %d, bperline = %d, bits_per_pixel = %d\n",
	    image->depth, image->bytes_per_line, image->bits_per_pixel);

    fprintf(stderr,"masks:  red %lx  green %lx  blue %lx\n",
	    image->red_mask, image->green_mask, image->blue_mask);

    if (isLsbMachine) fprintf(stderr,"This looks like an lsbfirst machine\n");
                 else fprintf(stderr,"This looks like an msbfirst machine\n");
  }


  if (image->bitmap_unit != 8 && image->bitmap_unit != 16 &&
      image->bitmap_unit != 32) {
    sprintf(errstr, "%s\nReturned image bitmap_unit (%d) non-standard.",
	    "Can't deal with this display.", image->bitmap_unit);
    ErrPopUp(errstr, "\nThat Sucks!");
    return 0;
  }

  if (!ncolors && visual->class != TrueColor) {
    sprintf(errstr, "%s\nOnly TrueColor displays can have no colormap.",
	    "Can't deal with this display.");
    ErrPopUp(errstr, "\nThat Sucks!");
    return 0;
  }


  /* build the 'global' grabPic stuff */
  gWIDE = image->width;  gHIGH = image->height;

  if (visual->class == TrueColor || visual->class == DirectColor ||
      ncolors > 256) {
    grabPic = (byte *) malloc(gWIDE * gHIGH * 3);
    gbits = 24;
  }
  else {
    grabPic = (byte *) malloc(gWIDE * gHIGH);
    gbits = 8;

    /* load up the colormap */
    for (i=0; i<ncolors; i++) {
      grabmapR[i] = colors[i].red   >> 8;
      grabmapG[i] = colors[i].green >> 8;
      grabmapB[i] = colors[i].blue  >> 8;
    }
  }
  
  if (!grabPic) FatalError("unable to malloc grabPic in convertImage()");
  pptr = grabPic;


  if (visual->class == TrueColor || visual->class == DirectColor) {
    unsigned int tmp;

    /* compute various shifty constants we'll need */
    rmask = image->red_mask;
    gmask = image->green_mask;
    bmask = image->blue_mask;

    rshift = lowbit(rmask);
    gshift = lowbit(gmask);
    bshift = lowbit(bmask);

    r8shift = 0;  tmp = rmask >> rshift;
    while (tmp >= 256) { tmp >>= 1;  r8shift -= 1; }
    while (tmp < 128)  { tmp <<= 1;  r8shift += 1; }

    g8shift = 0;  tmp = gmask >> gshift;
    while (tmp >= 256) { tmp >>= 1;  g8shift -= 1; }
    while (tmp < 128)  { tmp <<= 1;  g8shift += 1; }

    b8shift = 0;  tmp = bmask >> bshift;
    while (tmp >= 256) { tmp >>= 1;  b8shift -= 1; }
    while (tmp < 128)  { tmp <<= 1;  b8shift += 1; }

    if (DEBUG)
      fprintf(stderr,"True/DirectColor: shifts=%d,%d,%d  8shifts=%d,%d,%d\n",
	      rshift, gshift, bshift, r8shift, g8shift, b8shift);
  }


  bits_per_item = image->bitmap_unit;
  bits_used = bits_per_item;
  bits_per_pixel = image->bits_per_pixel;

  if (bits_per_pixel == 32) pixmask = 0xffffffff;
  else pixmask = (((CARD32) 1) << bits_per_pixel) - 1;

  bit_order = image->bitmap_bit_order;
  byte_order = image->byte_order;

  /* if we're on an lsbfirst machine, or the image came from an lsbfirst
     machine, we should flip the bytes around.  NOTE:  if we're on an
     lsbfirst machine *and* the image came from an lsbfirst machine, 
     *don't* flip bytes, as it should work out */

  /* pity we don't have a logical exclusive-or */
  flipBytes = ( isLsbMachine && byte_order != LSBFirst) ||
              (!isLsbMachine && byte_order == LSBFirst);

  for (i=0; i<image->height; i++) {
    lineptr = (byte *) image->data + (i * image->bytes_per_line);
    bptr = ((CARD8  *) lineptr) - 1;
    sptr = ((CARD16 *) lineptr) - 1;
    lptr = ((CARD32 *) lineptr) - 1;
    bits_used = bits_per_item;

    for (j=0; j<image->width; j++) {
      
      /* get the next pixel value from the image data */

      if (bits_used == bits_per_item) {  /* time to move on to next b/s/l */
	switch (bits_per_item) {
	case 8:  bptr++;  break;
	case 16: sptr++;  sval = *sptr;
	         if (flipBytes) {   /* swap CARD16 */
		   sw.s = sval;
		   tmpbyte = sw.b[0];
		   sw.b[0] = sw.b[1];
		   sw.b[1] = tmpbyte;
		   sval = sw.s;
		 }
	         break;
	case 32: lptr++;  lval = *lptr;
	         if (flipBytes) {   /* swap CARD32 */
		   sw.l = lval;
		   tmpbyte = sw.b[0];
		   sw.b[0] = sw.b[3];
		   sw.b[3] = tmpbyte;
		   tmpbyte = sw.b[1];
		   sw.b[1] = sw.b[2];
		   sw.b[2] = tmpbyte;
		   lval = sw.l;
		 }
	         break;
	}
		   
	bits_used = 0;
	if (bit_order == MSBFirst) bit_shift = bits_per_item - bits_per_pixel;
	                      else bit_shift = 0;
      }

      switch (bits_per_item) {
      case 8:  pixvalue = (*bptr >> bit_shift) & pixmask;  break;
      case 16: pixvalue = ( sval >> bit_shift) & pixmask;  break;
      case 32: pixvalue = ( lval >> bit_shift) & pixmask;  break;
      }

      if (bit_order == MSBFirst) bit_shift -= bits_per_pixel;
                            else bit_shift += bits_per_pixel;
      bits_used += bits_per_pixel;

      
      /* okay, we've got the next pixel value in 'pixvalue' */
      
      if (visual->class == TrueColor || visual->class == DirectColor) {
	/* in either case, we have to take the pixvalue and 
	   break it out into individual r,g,b components */
	rval = (pixvalue & rmask) >> rshift;
	gval = (pixvalue & gmask) >> gshift;
	bval = (pixvalue & bmask) >> bshift;

	if (visual->class == DirectColor) {
	  /* use rval, gval, bval as indicies into colors array */

	  *pptr++ = (rval < ncolors) ? (colors[rval].red   >> 8) : 0;
	  *pptr++ = (gval < ncolors) ? (colors[gval].green >> 8) : 0;
	  *pptr++ = (bval < ncolors) ? (colors[bval].blue  >> 8) : 0;
	}

	else {   /* TrueColor */
	  /* have to map rval,gval,bval into 0-255 range */
	  *pptr++ = (r8shift >= 0) ? (rval << r8shift) : (rval >> (-r8shift));
	  *pptr++ = (g8shift >= 0) ? (gval << g8shift) : (gval >> (-g8shift));
	  *pptr++ = (b8shift >= 0) ? (bval << b8shift) : (bval >> (-b8shift));
	}
      }

      else { /* all others: StaticGray, StaticColor, GrayScale, PseudoColor */
	/* use pixel value as an index into colors array */

	if (pixvalue >= ncolors) {
	  FatalError("convertImage(): pixvalue >= ncolors");
	}

	if (gbits == 24) {   /* too many colors for 8-bit colormap */
	  *pptr++ = (colors[pixvalue].red)   >> 8;
	  *pptr++ = (colors[pixvalue].green) >> 8;
	  *pptr++ = (colors[pixvalue].blue)  >> 8;
	}
	else *pptr++ = pixvalue & 0xff;

      }
    }
  }

  return 1;
}



/**************************************/
static int lowbit(ul)
unsigned long ul;
{
  /* returns position of lowest set bit in 'ul' as an integer (0-31),
   or -1 if none */

  int i;
  for (i=0; ((ul&1) == 0) && i<32;  i++, ul>>=1);
  if (i==32) i = -1;
  return i;
}



/**************************************/
/* following code snarfed from 'xwd.c' */
/**************************************/

#define lowbit(x) ((x) & (~(x) + 1))


static int getxcolors(win_info, colors)
     XWindowAttributes *win_info;
     XColor **colors;
{
  int i, ncolors;
  Colormap cmap;

  if (win_info->visual->class == TrueColor) {
    if (DEBUG) fprintf(stderr,"TrueColor visual:  no colormap needed\n");
    return 0;
  }

  else if (!win_info->colormap) {
    if (DEBUG) fprintf(stderr,"no colormap associated with window\n");
    return 0;
  }

  ncolors = win_info->visual->map_entries;
  if (DEBUG) fprintf(stderr,"%d entries in colormap\n", ncolors);

  if (!(*colors = (XColor *) malloc (sizeof(XColor) * ncolors)))
    FatalError("malloc failed in getxcolors()");


  if (win_info->visual->class == DirectColor) {
    Pixel red, green, blue, red1, green1, blue1;

    if (DEBUG) fprintf(stderr,"DirectColor visual\n");

    red = green = blue = 0;
    red1   = lowbit(win_info->visual->red_mask);
    green1 = lowbit(win_info->visual->green_mask);
    blue1  = lowbit(win_info->visual->blue_mask);
    for (i=0; i<ncolors; i++) {
      (*colors)[i].pixel = red|green|blue;
      (*colors)[i].pad = 0;
      red += red1;
      if (red > win_info->visual->red_mask)     red = 0;
      green += green1;
      if (green > win_info->visual->green_mask) green = 0;
      blue += blue1;
      if (blue > win_info->visual->blue_mask)   blue = 0;
    }
  }
  else {
    for (i=0; i<ncolors; i++) {
      (*colors)[i].pixel = i;
      (*colors)[i].pad = 0;
    }
  }

  XQueryColors(theDisp, win_info->colormap, *colors, ncolors);

  return(ncolors);
}
    




/***********************************/
int LoadGrab(pinfo)
     PICINFO *pinfo;
{
  /* loads up (into XV structures) last image successfully grabbed.
     returns '0' on failure, '1' on success */

  int   i;

  if (!grabPic) return 0;   /* no image to use */

  if (gbits == 24) pinfo->type = PIC24;
  else {
    pinfo->type = PIC8;

    for (i=0; i<256; i++) {
      pinfo->r[i] = grabmapR[i];
      pinfo->g[i] = grabmapG[i];
      pinfo->b[i] = grabmapB[i];
    }
  }

  pinfo->pic = grabPic;
  pinfo->w   = gWIDE;
  pinfo->h   = gHIGH;
  pinfo->frmType = -1;
  pinfo->colType = -1;

  sprintf(pinfo->fullInfo,"<internal>");
  sprintf(pinfo->shrtInfo,"%dx%d internal image.",gWIDE, gHIGH);
  pinfo->comment = (char *) NULL;

  grabPic = (byte *) NULL;

  return 1;
}





#include <X11/Xlib.h>
#include <X11/Xatom.h>

static Window TryChildren();

/* Find a window with WM_STATE, else return '0' */

static Window xvClientWindow (dpy, win)
    Display *dpy;
    Window win;
{
    Atom WM_STATE;
    Atom type = None;
    int format;
    unsigned long nitems, after;
    unsigned char *data;
    Window inf;

    WM_STATE = XInternAtom(dpy, "WM_STATE", True);
    if (!WM_STATE) return win;

    XGetWindowProperty(dpy, win, WM_STATE, 0, 0, False, AnyPropertyType,
		       &type, &format, &nitems, &after, &data);
    if (type) return win;

    inf = TryChildren(dpy, win, WM_STATE);

    return inf;
}

static Window TryChildren (dpy, win, WM_STATE)
    Display *dpy;
    Window win;
    Atom WM_STATE;
{
    Window root, parent;
    Window *children;
    unsigned int nchildren;
    unsigned int i;
    Atom type = None;
    int format;
    unsigned long nitems, after;
    unsigned char *data;
    Window inf = 0;

    if (!XQueryTree(dpy, win, &root, &parent, &children, &nchildren))
	return 0;

    for (i = 0; !inf && (i < nchildren); i++) {
	XGetWindowProperty(dpy, children[i], WM_STATE, 0, 0, False,
			   AnyPropertyType, &type, &format, &nitems,
			   &after, &data);
	if (type)
	  inf = children[i];
    }

    for (i = 0; !inf && (i < nchildren); i++)
      inf = TryChildren(dpy, children[i], WM_STATE);

    if (children) XFree((char *)children);
    return inf;
}

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.