wn_grid_pixel_c

	status.i4.v = wn_grid_pixel_c(coordinates.i4a.r, 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,
				      label_lengths.i4a.r, 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_id.i4.r)

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

	coordinates	4 element array defining the window pixel
			coordinates in xmin, ymin, xmax, ymax order
	limits		4 element array defining the window real world
			coordinates in xmin, ymin, xmax, ymax order
	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')
	label_lengths	2 element array defining the number of characters
			per numeric label in x-axis, y-axis order
			(If the first value is negative, all label lengths
			 will be set to the absolute value of the first
			 value.)
	label_colors	colors of axis label text in x-axis, y-axis order
			(If the first value is negative, both label colors
			 will be set to the absolute value of the first
			 value.)  (If a value of NULL is passed for this
			 argument, the color most recently selected by a
			 call to wn_color(_c) will be used.)
	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_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_id	returned window ID

	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_grid(_c), wn_quick_grid, wn_axis_label(_c), wn_axis_grid(_c),
	wn_view(_c), wn_world(_c), wn_active(_c), wn_multitrace_grid_c,
	wn_multitrace_grid_pixel_c, wn_multitrace_axis_label_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;
	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;
	static const int	label_lengths[2] = {6, 6};
	static const int	label_colors[2] = {CYAN, CYAN};
	static const int	scaling[2] = {WN_SCALE_LINEAR, WN_SCALE_LINEAR};
	int	window_id;
	unsigned int	options = WN_MAKE_GRID | WN_NORMAL_NOTATION;
	static const float	limits[4] = {1.0, 1.0, 10.0, 10.0};
	float	*tick_lengths = (float *) NULL;
	float	*x_loc_major = (float *) NULL;
	float	*y_loc_major = (float *) NULL;
	float	*x_loc_minor = (float *) NULL;
	float	*y_loc_minor = (float *) NULL;

	status = wn_grid_pixel_c(coordinates,limits,ticks,tick_lengths,
				 x_title,x_title_size,x_title_color,
				 y_title,y_title_size,y_title_color,
				 label_lengths,label_colors,
				 x_loc_major,x_loc_minor,y_loc_major,
				 y_loc_minor,scaling,options,&window_id);