MAP_XYOUTS Procedure

PV-WAVE Foundation > Reference Guide > Procedure and Function Reference: M–N > MAP_XYOUTS Procedure

Draws text on the currently selected graphics device starting at the designated map coordinate.

Usage

MAP_XYOUTS, x, y, string

Input Parameters

x—Parameter x is the longitude at which the output string should start.

y—Parameter y is the latitude at which the output string should start.

string—The scalar string containing the text that is to be output to the display surface. If this parameter is not of string type, it is converted prior to use.

Standard Plotting Keywords

The following standard plotting keywords are used with MAP_XYOUTS. See Chapter 21: Graphics and Plotting Keywords for more information.

Charsize	Charthick	Color	Alignment
Font	Orientation	Width

Discussion

MAP_XYOUTS is machine-dependent when you are using hardware fonts. This means that on two different machines, the same commands may produce text that does not appear the same. To guarantee similar appearance, use software fonts.

note

You may notice that under the X Window System the size of the software fonts varies from device to device. When you start PV-WAVE, the PV-WAVE hardware font is set to the current hardware font of the X server. Not all X servers will have the same default font size because users can reconfigure the default font and the default font can differ between X servers. Therefore, you may discover that the hardware font size, and therefore the software font size, may vary across different workstations. You can avoid this by explicitly setting the X font using the DEVICE procedure. For example:

DEVICE, font='-adobe-courier-medium-r-normal--14-*'

Example

TEK_COLOR ; set up a predefined color table called tek_color

; Plot a map given the specified range.

MAP, RANGE = [-150, 30, 30, 70]

; Label the city of Boulder, Colorado.

MAP_XYOUTS, -105.3, 40.0, 'Boulder', Color=5, $

   Charsize = 1.5, Charthick = 2