xv_capture

	status.i4.v = xv_capture(console_number.i4.v, screen.i4.v,
				 save_directory.i1a.r, save_file.i1a.r,
				 options.i4.v [,wait_for_copy.i4.v])

	This routine sends a request for capture of a screen into a
	GIF-format file. These files are suitable for display using
	xv_display.

   	console_number	console number of image (0 -> use local console)
	screen		screen id (e.g. LX2_MAIN_TV_A)
			(constants are in 'cnsparam')
	save_directory	null terminated save directory string
	save_file	null terminated save file string
	options		save options which can be ORed together
			(constants are in 'utilnet')
			(NO_GIF_OPTIONS -> no options selected for GIF save,
			 GIF_DATE -> append date to save_file name,
			 GIF_INVERT_COLORS -> invert colors when saving image)
	[wait_for_copy]	if present and FALSE the reply is sent before the
   			copy is made; otherwise the reply is after the copy

	This function returns ACNET status values as follows:

	OK			success
	CBS_GENERR		failed in allocating event flag
	ACNET_UTIME		reply timed out
	ACNET_xxx		request failed

	This function requires the following include files:

	cnsparam_h, cbslib_h, utilnet_h, acnet_errors_h

	Related functions:

	xv_display

	C/C++ usage:

	static const char	save_directory[] = "/scratch/userb/pic/capture/";
	static const char	save_file[] = "my_image";
	int	status;
	int	console_number = 0;
	int	screen = LX2_MAIN_TV_A;
	int	options = GIF_DATE;
	int	wait_for_copy = TRUE;
	
	status = xv_capture(console_number,screen,save_directory,
			    save_file,options,wait_for_copy);