wn_external_display_value_c

	status.i4.v = wn_external_display_value_c(x.r4.v, y.r4.v, value.g.v,
						  data_type.i4.v,
						  num_chars.i4.v,
						  base_flag.i4.v,
						  world_base.r4.v
						  [,fill_char.i1.v]
						  [,justify.i4.v])

	This routine converts a numeric value into its ASCII representation
	and displays it outside of the currently active graphics window at
	the relative character coordinates specified by "x" and "y".  The
	color of the text is determined by the most recent call to
	wn_color(_c).

	x, y		character coordinates relative to the active window
			(A negative x coordinate will put the initial
			 character to the left of the active window while
			 a negative y coordinate will put the initial
			 character below the active window.  A value of
			 WN_CENTER_IT for either coordinate will center
			 the text relative to the active window for that
			 plane.  A value of WN_JUSTIFY_MIN or WN_JUSTIFY_MAX
			 will align the text to the minimum or maximum
			 respectively of the corresponding axis.)
	value		value to be converted
	data_type	data type of "value"
			(CNV_BYTE -> one byte decimal integer,
			 CNV_SHORT -> two byte decimal integer,
			 CNV_LONG -> four byte decimal integer,
			 CNV_UBYTE -> one byte unsigned decimal integer,
			 CNV_USHORT -> two byte unsigned decimal integer,
			 CNV_ULONG -> four byte unsigned decimal integer,
			 CNV_BYTE_HEX -> one byte hexadecimal integer,
			 CNV_SHORT_HEX -> two byte hexadecimal integer,
			 CNV_LONG_HEX -> four byte hexadecimal integer,
			 CNV_SHORT_OCTAL -> two byte octal integer,
			 CNV_BINARY -> "num_chars" / 8 binary byte array
				       (little endian),
			 CNV_HEX_STRING -> "num_chars" / 2 hexadecimal
					   byte array,
			 CNV_HEX_BIG_ENDIAN -> "num_chars" / 2 hexadecimal
					       byte array,
			 CNV_FLOAT -> single precision floating point value,
			 CNV_EXP -> floating point value in scientific
				    notation,
			 CNV_FLOAT_EXP -> single precision floating point value
					  converted to best format,
			 CNV_DOUBLE -> double precision floating point value,
			 CNV_DOUBLE_EXP -> double precision floating point
					   value converted to best format,
			 CNV_LOGICAL -> four byte integer containing values
					of TRUE or FALSE,
			 CNV_ENUMERATED -> four byte integer from most recent
					   call to set_enumerated_strings_c,
			 >= CNV_ENUMERATED_BASE -> four byte integer from a
						   prior call to
						   set_enumerated_strings_c,
			 CNV_BIT_MASK -> four byte integer from most recent
					 call to set_bit_mask_strings_c,
			 >= CNV_BIT_MASK_BASE -> four byte integer from a
						 prior call to
						 set_bit_mask_strings_c,
			 CNV_NODE -> two byte integer containing an ACNET
				     node value,
			 CNV_NODE_OPERATIONAL -> two byte integer containing
						 an operationally significant
						 ACNET node value,
			 CNV_NODE_CONSOLE -> two byte integer containing an
					     ACNET console node value,
			 CNV_NODE_FRONTEND -> two byte integer containing a
					      CAMAC front end node value,
			 CNV_NODE_FRONTEND_ALL -> two byte integer containing
						  a front end node value,
			 CNV_NODE_CENTRALVAX -> two byte integer containing
						a central VAX node value,
			 CNV_DEVICE -> four byte integer containing an ACNET
				       device index,
			 CNV_LONG_DEVICE -> ARRAY_DEVICE_DATA structure
					    containing an array device
					    specification,
			 CNV_DEVICE_CLASS -> four byte integer containing a
					     device class value,
			 CNV_DEVICE_TYPE -> four byte integer containing a
					    device type value,
			 CNV_DEVICE_TYPE_LONG -> four byte integer containing
						 a device type value,
			 CNV_DBPROP -> two byte integer containing an
				       ACNET database property,
			 CNV_FTD -> two byte integer containing data
				    acquisition rate (FTD),
			 CNV_READING_FTD -> two byte integer containing
					    reading data acquisition rate (FTD),
			 CNV_COLOR -> four byte integer containg color value,
			 CNV_PAGE -> PAGE_NAME_LEN character string containing
				     an application index page name,
			 CNV_WINDOW -> four byte console window value,
			 CNV_TV_WINDOW -> four byte console TV window value,
			 CNV_GRAPHIC_WINDOW -> four byte console graphic
					       window value,
			 CNV_ERROR -> ACNET_ERR structure containing ACNET
				      error code,
			 CNV_SHORT_ERROR -> ACNET_ERR structure containing
					    ACNET error code (short format),
			 CNV_SYSTEM_ERROR -> four byte system error value,
			 CNV_RTL_ERROR -> four byte RTL error value,
			 CNV_CLINKS -> four byte time in clinks,
			 CNV_CLINKS_DATEONLY -> four byte time in clinks
						(date only),
			 CNV_CLINKS_TIMEONLY -> four byte time in clinks
						(time only),
			 CNV_HHMMSS -> four byte time in hh:mm:ss format,
			 CNV_CTIME -> four byte time in seconds since
				      January 1, 1970,
			 CNV_CTIME_DATEONLY -> four byte time in seconds since
					       January 1, 1970 (date only),
			 CNV_CTIME_TIMEONLY -> four byte time in seconds since
					       January 1, 1970 (time only),
			 CNV_RAD50 -> four byte radix 50 value,
			 CNV_XCHAR -> XCHAR format string,
			 CNV_USERNAME -> USER_NAME_LEN character string
					 containing a user name,
			 CNV_SR_SYSTEM -> four byte integer containing a
					  Save/Restore system value,
			 CNV_SR_FILE -> four byte integer containing a
					Save/Restore file number,
			 CNV_SAVE_LIST -> four byte integer containing a
					  Save/Restore list value,
			 CNV_SDA_CASE -> four byte integer containing an
					 SDA case value,
			 CNV_SDA_USAGE -> four byte integer containing an
					  SDA usage value,
			 CNV_SDA_FILE -> SDA_FILE_VALUE structure
					 containing an SDA file value
					 specification,
			 CNV_SDA_DIR -> four byte integer containing an
					SDA directory value,
			 CNV_EXT_SDA_CASE -> SDA_CASE_VALUE structure
					     containing an SDA case value
					     specification,
			 CNV_EXT_SDA_SUBCASE -> SDA_CASE_VALUE structure
						containing an SDA subcase value
						specification,
			 CNV_SSDN -> LEN_SSDN byte SSDN value,
			 CNV_DEVICE_DESCRIPTION -> four byte integer
						   containing an ACNET
						   device index,
			 CNV_READING_UNITS_TEXT -> four byte integer
						   containing an ACNET
						   device index,
			 CNV_SETTING_UNITS_TEXT -> four byte integer
						   containing an ACNET
						   device index,
			 CNV_CONSOLE_NUMBER -> four byte integer containing
					       a console number value,
			 CNV_CONSOLE_SLOT -> four byte integer containing a
					     console slot value,
			 CNV_CONSOLE_PA_SLOT -> four byte integer containing a
						console PA slot value,
			 CNV_CONSOLE_SA_SLOT -> four byte integer containing a
						console SA slot value,
			 CNV_SHARED_LOG_FILE -> LOG_NAMLEN character string
						containing a shared log file
						name,
			 CNV_LEX_DRAW_FILE -> CNV_LEX_DRAW_FILE_LEN character
					      string containing a Lex Draw
					      file name,
			 CNV_LEX_PROG_FILE -> CNV_LEX_PROG_FILE_LEN character
					      string containing a Lex Prog
					      file name,
			 CNV_LJ_NODE -> two byte integer containing a
					Lumberjack node value,
			 CNV_LJ_NODE_ID -> four byte integer containing a
					   Lumberjack node ID value,
			 CNV_MACHINE -> four byte integer containing an
					accelerator machine value,
			 CNV_CNV_TYPE -> four byte integer containing a
					 conversion type value,
			 CNV_INP_TYPE -> four byte integer containing an
					 input type value,
			 CNV_SIMPLE_CLOCK_EVENT -> four byte integer containing
						   a clock event value,
			 CNV_CLOCK_EVENT -> four byte integer containing a
					    clock event value,
			 CNV_CLOCK_EVENT_LONG -> four byte integer containing a
						 clock event value,
			 CNV_SIMPLE_MDAT_FRAME -> four byte integer containing
						  an MDAT frame value,
			 CNV_MDAT_FRAME -> four byte integer containing an
					   MDAT frame value,
			 CNV_MDAT_FRAME_LONG -> four byte integer containing an
						MDAT frame value,
			 CNV_NOTIFY_CATEGORY -> four byte integer containing a
						notify category value,
			 CNV_NOTIFY_PRIORITY -> four byte integer containing a
						notify priority value,
			 CNV_NOTIFY_DATA_TYPE -> four byte integer containing a
						 notify data type value,
			 CNV_PRIMARY_TRANSFORM -> four byte integer containing
						  a primary transform value,
			 CNV_PRIMARY_TRANSFORM_LONG -> four byte integer
						       containing a primary
						       transform value,
			 CNV_COMMON_TRANSFORM -> four byte integer containing
						 a common transform value,
			 CNV_COMMON_TRANSFORM_LONG -> four byte integer
						      containing a common
						      transform value,
			 CNV_STATE_DEVICE -> four byte integer containing a
					     state device index,
			 CNV_STATE_VALUE -> STATE_VALUE structure containing a
					    state value specification,
			 CNV_DATA_EVENT -> DATA_EVENT_DATA structure containing
					   a data event specification,
			 CNV_STATE_EVENT -> DATA_EVENT_DATA structure containing
					    a state data event specification,
			 CNV_TCLK_EVENT -> DATA_EVENT_DATA structure containing
					   a TCLK data event specification,
			 CNV_CHAR -> simple character array,
			 CNV_XCHAR -> array of XCHAR structures containing
				      color encoded text,
			 CNV_TRIMMED_STRING -> null terminated ASCII string to
					       have any leading or trailing
					       spaces removed,
			 user data type ID -> user data type defined by an
					      earlier call to
					      create_user_data_type_c)
	num_chars	number of characters to display
			minimum number of characters for certain types:
			(CNV_NODE -> CNV_NODE_LEN characters,
			 CNV_NODE_OPERATIONAL -> CNV_NODE_LEN characters,
			 CNV_NODE_CONSOLE -> CNV_NODE_LEN characters,
			 CNV_NODE_FRONTEND -> CNV_NODE_LEN characters,
			 CNV_NODE_FRONTEND_ALL -> CNV_NODE_LEN characters,
			 CNV_NODE_CENTRALVAX -> CNV_NODE_LEN characters,
			 CNV_DEVICE -> DEVICE_NAME_LEN characters,
			 CNV_LONG_DEVICE -> LONG_DEVICE_NAME_LEN characters,
			 CNV_DEVICE_CLASS -> DIO_CLASS_TEXT_LEN characters,
			 CNV_DEVICE_TYPE -> DIO_SHORT_DEVICE_TEXT_LEN
					    characters,
			 CNV_DEVICE_TYPE_LONG -> DIO_LONG_DEVICE_TEXT_LEN
						 characters,
			 CNV_DBPROP -> CNV_DBPROP_LEN characters,
			 CNV_FTD -> CNV_FTD_LEN characters,
			 CNV_READING_FTD -> CNV_FTD_LEN characters,
			 CNV_COLOR -> CNV_COLOR_LEN characters,
			 CNV_PAGE -> PAGE_NAME_LEN characters,
			 CNV_WINDOW -> CNV_WINDOW_LEN characters,
			 CNV_TV_WINDOW -> CNV_WINDOW_LEN characters,
			 CNV_GRAPHIC_WINDOW -> CNV_WINDOW_LEN characters,
			 CNV_ERROR -> ACNET_ERROR_TEXT_LEN characters,
			 CNV_SHORT_ERROR -> SHORT_ACNET_ERROR_LEN characters,
			 CNV_CLINKS -> DATESTRING_LEN characters,
			 CNV_CLINKS_DATEONLY -> CNV_CLINKS_DATEONLY_LEN
						characters,
			 CNV_CLINKS_TIMEONLY -> CNV_TIMEONLY_LEN characters,
			 CNV_HHMMSS -> CNV_TIMEONLY_LEN characters,
			 CNV_CTIME -> ASCTIME_LEN characters,
			 CNV_CTIME_DATEONLY -> CNV_CTIME_DATEONLY_LEN
					       characters,
			 CNV_CTIME_TIMEONLY -> CNV_TIMEONLY_LEN characters,
			 CNV_RAD50 -> RAD50_LEN characters,
			 CNV_USERNAME -> USER_NAME_LEN characters,
			 CNV_SR_SYSTEM -> CNV_SR_SYSTEM_LEN characters,
			 CNV_SAVE_LIST -> CNV_SAVE_LIST_LEN characters,
			 CNV_SDA_CASE -> CNV_SDA_CASE_LEN characters,
			 CNV_SDA_DIR -> CNV_SDA_DIR_LEN characters,
			 CNV_SSDN -> CNV_SSDN_LEN characters,
			 CNV_DEVICE_DESCRIPTION -> LEN_DEV_DESCR_TEXT
						   characters,
			 CNV_READING_UNITS_TEXT -> LEN_DEV_UNITS characters,
			 CNV_SETTING_UNITS_TEXT -> LEN_DEV_UNITS characters,
			 CNV_CONSOLE_NUMBER -> CNV_CONSOLE_NUMBER_LEN
					       characters,
			 CNV_CONSOLE_SLOT -> CNV_CONSOLE_SLOT_LEN characters,
			 CNV_CONSOLE_PA_SLOT -> CNV_CONSOLE_SLOT_LEN characters,
			 CNV_CONSOLE_SA_SLOT -> CNV_CONSOLE_SLOT_LEN characters,
			 CNV_SHARED_LOG_FILE -> LOG_NAMLEN characters,
			 CNV_LEX_DRAW_FILE -> CNV_LEX_DRAW_FILE_LEN characters,
			 CNV_LEX_PROG_FILE -> CNV_LEX_PROG_FILE_LEN characters,
			 CNV_LJ_NODE -> CNV_LJ_NAME_LEN characters,
			 CNV_LJ_NODE_ID -> CNV_LJ_NAME_LEN characters,
			 CNV_PRIMARY_TRANSFORM_LONG -> DIO_SCALING_TEXT_LEN
						       characters,
			 CNV_COMMON_TRANSFORM_LONG -> DIO_SCALING_TEXT_LEN
						      characters,
			 CNV_STATE_DEVICE -> DEVICE_NAME_LEN characters,
			 CNV_STATE_VALUE -> CNV_STATE_TEXT_LEN characters)
	base_flag	indicates if one of the coordinates has a base
			position relative to the real world coordinates
			of the window
			(WN_NO_WORLD_BASE -> no world coordinate base,
			 WN_WORLD_BASE_X -> x coordinate has a world
					    coordinate base,
			 WN_WORLD_BASE_Y -> y coordinate has a world
					    coordinate base,
			 WN_UNITARY_BASE_X -> x coordinate has a unitary
					      (0.0 - 1.0) coordinate base,
			 WN_UNITARY_BASE_Y -> y coordinate has a unitary
					      (0.0 - 1.0) coordinate base)
			(If WN_WORLD_BASE_X is chosen, the argument "x"
			 will be interpreted as a delta x in character
			 coordinates from the value of "world_base".
			 If WN_WORLD_BASE_Y is chosen, the argument "y"
			 will be interpreted as a delta y in character
			 coordinates from the value of "world_base".)
	world_base	base world coordinate for axis indicated by
			"base_flag" argument.  If it has a value of
			WN_NO_WORLD_BASE, this argument is ignored.
	[fill_char]	character to use for filling out the field
			(default is BLANK)
	[justify]	optional justification parameter which has no
			effect on types CNV_CHAR and CNV_XCHAR
			(CNV_LEFT_JUSTIFY -> left justify,
			 CNV_LEFT_JUSTIFY_NO_PSIGN -> left justify, but don't
						      leave a space for sign,
			 CNV_RIGHT_JUSTIFY -> right justify,
			 CNV_CENTER_JUSTIFY -> center it,
			 CNV_NO_JUSTIFY -> no justification (default))

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid number of characters or conversion type
	CBS_NOSETUP		an active window has not been established

	This function requires the following include files:

	cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	wn_display_value(_c), wn_external_text(_c), wn_external_colored_text_c,
	wn_colored_text_c, numeric_to_ascii(_c), wn_flush,
	set_enumerated_strings_c, modify_enumerated_strings_c,
	get_enumerated_strings, create_user_data_type_c, set_logical_strings,
	get_logical_strings, set_bit_mask_strings_c, get_bit_mask_strings_c,
	intro_graphics_windows

	C/C++ usage:

	char	fill_char = BLANK;
	int	status;
	int	value = 42;
	int	data_type = CNV_LONG;
	int	num_chars = 4;
	int	base_flag = WN_WORLD_BASE_Y;
	int	justify = CNV_NO_JUSTIFY;
	float	x = -5.0;
	float	y = -0.5;
	float	world_base = 1.0;

	status = wn_external_display_value_c(x,y,(void *) &value,data_type,
					     num_chars,base_flag,
					     world_base,fill_char,
					     justify);