shotlog_insert_window_image_c

	status.i4.v = shotlog_insert_window_image_c(num_images.i4.v,
						    consoles.i4a.r,
						    select_type.i4.v,
						    screens.g.v, comment.i1a.r,
						    options.u4.v,
						    error_string.i1a.r
						    [,entry_id.i4.v]
						    [,visibility.i4.v])

	This routine will submit one or more images for insertion
	into the shot log.

	num_images	number of images
	consoles	array of console numbers
			(use a value of LOCAL_CONSOLE to specify the
			 console that the program is running on)
	select_type	window select type
			(SL_SELECT_WINDOW_BY_NUMBER -> use console window
						       constants,
			 SL_SELECT_WINDOW_BY_TITLE -> select console window
						      by title)
	screens		array of window specification values
			(If "select_type" has a value of
			 SL_SELECT_WINDOW_BY_NUMBER, this should be an array
			 of long integers containing console window constants.
			 These constants can be found in 'cnsparam'.
			 If "select_type" has a value of
			 SL_SELECT_WINDOW_BY_TITLE, this should be an array
			 of null terminated title strings.  Allow
			 SL_SCREEN_TITLE_LEN characters per entry.)
	comment		ASCII comment string (only used for single images)
	options		unused
	error_string	returned error string
			(allow SL_ERROR_STRING_LEN + 1 characters)
	[entry_id]	desired entry ID for appending to an existing entry
			(SL_ENTRY_ID_NONE -> make a new entry (default),
			 SL_ENTRY_ID_LAST -> append to the last entry made,
			 otherwise -> entry ID to append to)
	[visibility]	desired visibility
			(SL_VISIBILITY_NORMAL -> normal visibility (default),
			 SL_VISIBILITY_IMPORTANT -> highlighted entry)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid number of images or window
				selection type
	CLIB_NOINIT		all parameters have not been specified
	CLIB_GENERR		error manipulating image files or
				sending image request to the server

	This function requires the following include files:

	shotloglib_h, cnsparam_h, acnet_errors_h

	Related functions:

	shotlog_set_log_c, shotlog_set_source_c, shotlog_set_author,
	shotlog_insert_comment_c, shotlog_insert_chapter_c,
	shotlog_insert_url_c, shotlog_get_log, shotlog_request_job_status,
	shotlog_translate_log_name_c

	C/C++ usage:

	static const char	comment[] = "a comment";
	char	error_string[SL_ERROR_STRING_LEN+1];
	int	status;
	int	num_images = NUM_IMAGES;
	int	consoles[NUM_IMAGES] = {LOCAL_CONSOLE};
	int	select_type = SL_SELECT_WINDOW_BY_NUMBER;
	int	screens[NUM_IMAGES] = {LX2_MAIN_GX_1A};
	int	entry_id = SL_ENTRY_ID_NONE;
	int	visibility = SL_VISIBILITY_NORMAL;
	unsigned int	options = 0;

	status = shotlog_insert_window_image_c(num_images,consoles,select_type,
					       screens,comment,options,
					       error_string,entry_id,
					       visibility);