wn_multitrace_grid_pixel_c

	status.i4.v = wn_multitrace_grid_pixel_c(num_traces.i4.v,
						 coordinates.i4a.r,
						 x_limits.r4a.r,
						 y_limits.r4a.r,
						 ticks.i4a.r,
						 tick_lengths.r4a.r,
						 x_title.i1a.r,
						 x_title_size.i4.v,
						 x_title_color.i4.v,
						 y_title.i1a.r,
						 y_title_size.i4.v,
						 y_title_color.i4.v,
						 x_label_length.i4.v,
						 x_label_type.i4.v,
						 x_label_color.i4.v,
						 y_label_lengths.i4a.r,
						 y_label_types.i4a.r,
						 y_label_colors.i4a.r,
						 x_loc_major.r4a.r,
						 x_loc_minor.r4a.r,
						 y_loc_major.r4a.r,
						 y_loc_minor.r4a.r,
						 scaling.i4a.r, options.u4.v,
						 window_ids.i4a.r)

	This routine creates and draws a multitrace grid for the graphic
	window specified by "coordinates" and "limits".  It actually creates
	the graphic window(s) for you and makes the first one active.  This
	has the same effect as calling wn_view_pixel_c, wn_world(_c),
	wn_active(_c), wn_axis_label(_c), and wn_multitrace_axis_label_c.

	num_traces	number of plot traces
	coordinates	4 element array defining the window pixel
			coordinates in xmin, ymin, xmax, ymax order
	x_limits	2 element array defining the window X axis real world
			coordinates in xmin, xmax order
	y_limits	2*"num_traces" element array defining the window
			Y axis real world coordinates in ymin, ymax order
			(If WN_SAME_LIMITS is selected under options,
			 only two values should be provided which will
			 be used as the limits for all traces.)
	ticks		4 element array defining the number of major and
			minor axis tick marks in xmajor, xminor, ymajor,
			yminor order
			(If "x_loc_minor" is specified, "ticks[1]" indicates
			 the total number of minor x-axis tick marks specified.)
			(If "y_loc_minor" is specified, "ticks[3]" indicates
			 the total number of minor y-axis tick marks specified.)
	tick_lengths	2 element array containing tick mark lengths in terms
			of the real world coordinates for the opposite plane
			to the axis plane  (If a value of NULL is passed for
			this argument, a default value of 0.04 times the size
			of the plot window will be used.  If the first value
			is less than zero, its absolute value will be used
			for both planes.)
	x_title		title for x axis (must be null terminated or passed
			as a string descriptor)
			(A value of NULL may be passed if no title is desired.) 
	x_title_size	character size for x axis title
			(WN_TEXT_MIN_SIZE -> WN_TEXT_MAX_SIZE)
	x_title_color	color of x axis title (constants are in 'cnsparam')
	y_title		title for y axis (must be null terminated or passed
			as a string descriptor)
			(A value of NULL may be passed if no title is desired.) 
	y_title_size	character size for y axis title
			(WN_TEXT_MIN_SIZE -> WN_TEXT_MAX_SIZE)
	y_title_color	color of y axis title (constants are in 'cnsparam')
	x_label_length	number of characters per numeric label for the X axis
	x_label_type	type of numeric displays for tick X axis labels
			(CNV_FLOAT -> regular float format,
			 CNV_EXP -> exponential notation,
			 CNV_FLOAT_EXP -> use regular float format unless the
					  value exceeds "label_length"
					  characters in which case use
					  exponential notation)
	x_label_color	color of X axis label text
	y_label_lengths	array defining the number of characters
			per numeric label for the Y axis traces
			(If the first value is negative, all label lengths
			 will be set to the absolute value of the first
			 value.)
	y_label_types	array of types of numeric displays for tick Y axis labels
			(CNV_FLOAT -> regular float format,
			 CNV_EXP -> exponential notation,
			 CNV_FLOAT_EXP -> use regular float format unless the
					  value exceeds "label_length"
					  characters in which case use
					  exponential notation)
			(If the first value is negative, all label types
			 will be set to the absolute value of the first
			 value.)
	y_label_colors	array of colors of Y axis label text
			(If the first value is negative, all label colors
			 will be set to the absolute value of the first
			 value.)
	x_loc_major	array ("ticks[0]" + 1 elements) of real world
			coordinates defining locations for each major x-axis
			tick/grid  (Passing a value of NULL results in evenly
			spaced ticks.)
	x_loc_minor	array ("ticks[1]" + 1 elements) of real world
			coordinates defining locations for each minor x-axis
			tick mark  (Passing a value of NULL results in evenly
			spaced ticks.)
	y_loc_major	array ("ticks[2]" + 1 elements) of real world
			coordinates defining locations for each major y-axis
			tick/grid  (Passing a value of NULL results in evenly
			spaced ticks.)
	y_loc_minor	array ("ticks[3]" + 1 elements) of real world
			coordinates defining locations for each minor y-axis
			tick mark  (Passing a value of NULL results in evenly
			spaced ticks.)
	scaling		2 element array defining the scaling for each axis
			in x, y order
			(WN_SCALE_LINEAR -> linear scaling,
			 WN_SCALE_LOG10 -> base 10 log scaling,
			 WN_SCALE_NATURAL_LOG -> natural log scaling)
			(If a value of NULL is passed for this argument,
			 both axes will be set up for linear scaling.)
	options		miscellaneous setup options (Note: The following
			values should be logically OR'ed together to
			create the desired grid setup.)
			(WN_NO_GRID -> don't draw grid lines,
			 WN_MAKE_GRID -> draw grid lines on major ticks,
			 WN_NORMAL_NOTATION -> normal notation for labels,
			 WN_SCIENTIFIC_NOTATION -> scientific notation,
			 WN_SCIENTIFIC_NOTATION_X -> scientific notation for x,
			 WN_SCIENTIFIC_NOTATION_Y -> scientific notation for y,
			 WN_SQUEEZE_X_LABEL -> squeeze x axis labels,
			 WN_SQUEEZE_Y_LABEL -> squeeze y axis labels,
			 WN_INVERT_X_TICK_MARKS -> invert x-axis tick marks,
			 WN_INVERT_Y_TICK_MARKS -> invert y-axis tick marks,
			 WN_DOTTED_X_GRID -> make major x axis grid lines
					     dotted rather than solid,
			 WN_DOTTED_Y_GRID -> make major y axis grid lines
					     dotted rather than solid,
			 WN_SAME_LIMITS -> use the same Y axis limits for
					   all traces,
			 WN_X_LIMIT_LABELS_ONLY -> only label the limits of
						   the X axis,
			 WN_Y_LIMIT_LABELS_ONLY -> only label the limits of
						   the Y axis)
	window_ids	returned array of window IDs

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid coordinates specified
	CBS_MEMFAIL		failed in allocating dynamic memory

	This function requires the following include files:

	cnsparam_h, clib_h, cbslib_h, acnet_errors_h

	Related functions:

	wn_multitrace_grid_c, wn_grid(_c), wn_grid_pixel_c, wn_quick_grid,
	wn_axis_label(_c), wn_axis_grid(_c), wn_view(_c), wn_world(_c),
	wn_active(_c), wn_flush, intro_graphics_windows

	C/C++ usage:

	statics const char	x_title[] = "X Axis Title";
	statics const char	y_title[] = "Y Axis Title";
	int	status;
	int	num_traces = NUM_TRACES;
	static const int	coordinates[4] = {100, 100, 200, 200};
	static const int	ticks[4] = {4, 5, 4, 5};
	int	x_title_size = WN_TEXT_MIN_SIZE;
	int	x_title_color = CYAN;
	int	y_title_size = WN_TEXT_MIN_SIZE;
	int	y_title_color = CYAN;
	int	x_label_length = 6;
	int	x_label_type = CNV_FLOAT_EXP;
	int	x_label_color = CYAN;
	static const int	y_label_lengths[NUM_TRACES] = {6, 6};
	static const int	y_label_types[NUM_TRACES] =
				{CNV_FLOAT_EXP, CNV_FLOAT_EXP};
	static const int	y_label_colors[NUM_TRACES] = {GREEN, YELLOW};
	static const int	scaling[2] = {WN_SCALE_LINEAR, WN_SCALE_LINEAR};
	int	window_ids[NUM_TRACES];
	unsigned int	options = WN_MAKE_GRID;
	static const float	x_limits[2] = {1.0, 10.0};
	static const float	y_limits[NUM_TRACES*2] = {1.0, 10.0, 1.0, 10.0};
	float	*tick_lengths = (float *) NULL;
	float	*x_loc_major = (float *) NULL;
	float	*x_loc_minor = (float *) NULL;
	float	*y_loc_major = (float *) NULL;
	float	*y_loc_minor = (float *) NULL;

	status = wn_multitrace_grid_pixel_c(num_traces,coordinates,x_limits,
					    y_limits,ticks,tick_lengths,x_title,
					    x_title_size,x_title_color,y_title,
					    y_title_size,y_title_color,
					    x_label_length,x_label_type,
					    x_label_color,y_label_lengths,
					    y_label_types,y_label_colors,
					    x_loc_major,x_loc_minor,
					    y_loc_major,y_loc_minor,scaling,
					    options,window_ids);