W_GETBLOCK(3)			WLIB-CALLS		W_GETBLOCK(3)

NAME

	w_getblock()

SYPNOSIS

	#include <Wlib.h>

	BITMAP *w_getblock(short handle, short x0, short y0, short width,
			 short height);

	where BITMAP is declared as:

	typedef struct {
		short	width;
		short	height;
		short	wpl;
		short	planes;
		ushort	*data;
	} BITMAP;

DESCRIPTION

	 w_getblock() allows you to read the contents of a window into a
	buffer. you will be returned a pointer to a bitmap structure containing
	all the necessary data, or null if any kind of error occured. note
	that you're resposable for freeing the memory later if you don't need
	the data any more. in this case simply free() the pointer.

	 for the moment, free() is always automatically substituted by Mfree()
	by Wlib.h, as the MiNTLib has the `feature' of never giving memory
	back to MiNT.

RETURNS

	- a pointer to a BITMAP struct if everything is ok

	- zeor otherwise

SEE ALSO

	wsetblock(2)

LAST CHANGED

	12/94 by TeSche, itschere@techfak.uni-bielefeld.de
