NCL Home > Documentation > Graphics > Graphical Interfaces


Draws text strings on the given workstation.


load "$NCARG_ROOT/lib/ncarg/nclscripts/csm/gsn_code.ncl"  ; This library is automatically loaded
                                                          ; from NCL V6.2.0 onward.
                                                          ; No need for user to explicitly load.

	procedure gsn_text_ndc (
		wks [1] : graphic,  
		text    : string,   
		x       : numeric,  
		y       : numeric,  
		res [1] : logical   



A Workstation identifier. The identifier is one returned either from calling gsn_open_wks or calling create to create a Workstation object.


An array of text strings to draw on the workstation.


Arrays of the same size as text containing the X and Y coordinates of the text strings, which must be normalized device coordinates (NDC).


A variable containing an optional list of text resources, attached as attributes. Set to True if you want the attached attributes to be applied, and False if you either don't have any resources to set, or you don't want the resources applied.


If a missing value is encountered in the text strings or x/y values, then no text string will be drawn at that pair. A bug was fixed in NCL V6.5.0 in which missing text strings were showing up in the plot as the missing string.

There are many fonts available, and you can use the txFont resource to change the font.

See Also

gsn_text, gsn_add_text, gsn_polygon, gsn_polymarker_ndc, gsn_polyline, gsn_polygon_ndc, gsn_polymarker_ndc, gsn_polyline_ndc, gsn_add_polygon, gsn_add_polymarker, gsn_add_polyline, drawNDCGrid


For an application example, see:

Also, see the suite of text examples.