<!--
(C) Copyright 1996-2016 ECMWF.
This software is licensed under the terms of the Apache Licence Version 2.0
which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
In applying this licence, ECMWF does not waive the privileges and immunities
granted to it by virtue of its status as an intergovernmental organisation nor
does it submit to any jurisdiction.
-->
<magics>
	<class xmltag="text"
		name="TextVisitor"
		xml_data="text_lines"
		directory="basic"
		prefix="text"
		xml_doc_inherits="XmlBasicNode"
		action="ptext">
		<documentation></documentation>
		<parameter from="string"
			name="text_html"
			default="on"
			metview="no"
			member="html"
			to="bool">
			<release>2.0</release>
			<release_info>Change the default value from off to on in Magics2.12</release_info>
			<documentation>enable use of HTML convention</documentation>
		</parameter>
		<parameter member="count"
			to="int"
			default="1"
			from="int"
			name="text_line_count">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>The number of lines of text to be plotted</documentation>
			<set name="text_line_1" value="1/2/3/4/5/6/7/8/9/10"></set>
			<set name="text_line_2" value="2/3/4/5/6/7/8/9/10"></set>
			<set name="text_line_3" value="3/4/5/6/7/8/9/10"></set>
			<set name="text_line_4" value="4/5/6/7/8/9/10"></set>
			<set name="text_line_5" value="5/6/7/8/9/10"></set>
			<set name="text_line_6" value="6/7/8/9/10"></set>
			<set name="text_line_7" value="7/8/9/10"></set>
			<set name="text_line_8" value="8/9/10"></set>
			<set name="text_line_9" value="9/10"></set>
			<set name="text_line_10" value="10"></set>
		</parameter>
		<parameter member="line1"
			to="string"
			default="&lt;magics_title/&gt;"
			from="string"
			name="text_line_1">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line2"
			to="string"
			default=""
			from="string"
			name="text_line_2">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line3"
			to="string"
			default=""
			from="string"
			name="text_line_3">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line4"
			to="string"
			default=""
			from="string"
			name="text_line_4">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line5"
			to="string"
			default=""
			from="string"
			name="text_line_5">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line6"
			to="string"
			default=""
			from="string"
			name="text_line_6">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line7"
			to="string"
			default=""
			from="string"
			name="text_line_7">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line8"
			to="string"
			default=""
			from="string"
			name="text_line_8">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line9"
			to="string"
			default=""
			from="string"
			name="text_line_9">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter member="line10"
			to="string"
			default=""
			from="string"
			name="text_line_10">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>Character string for holding lines of text (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_first_line"
			default="1"
			metview="no"
			member="first"
			to="int">
			<release>0.1</release>
			<release_info>deprecated parameter : see text_lines</release_info>
			<documentation>The first line in the text block to be plotted</documentation>
		</parameter>
		<parameter from="string"
			name="text_colour"
			default="navy"
			member="font_colour"
			to="Colour"
			metview_default="navy">
			<documentation>Colour of text in text block (Full choice of colours)</documentation>
			<release>1.0</release>
		</parameter>
		<parameter xml="font"
			from="string"
			name="text_font"
			default="helvetica"
			member="font"
			to="string">
			<documentation>Font name - please make sure this font is installed!</documentation>
			<release>1.0</release>
			<release_info>Much improved in version 1.3.</release_info>
		</parameter>
		<parameter member="font_style"
			to="string"
			default="normal"
			from="string"
			name="text_font_style">
			<documentation>Font style. Set this to an empty string in order to remove all styling.</documentation>
		</parameter>
		<parameter from="string"
			name="text_font_size"
			default="0.5"
			member="font_dimension"
			to="string"
			metview_default="0.3">
			<documentation>Font size, specified in cm.</documentation>
		</parameter>
		<parameter member="justification"
			to="Justification"
			default="centre"
			from="string"
			name="text_justification">
			<release>Magisc++0.3</release>
			<documentation>How text is to be positioned in each line (LEFT/CENTRE/RIGHT)</documentation>
		</parameter>
		<parameter from="string"
			name="text_orientation"
			default="horizontal"
			member="orientation"
			to="string"
			values="horizontal/top_bottom/bottom_top">
			<documentation>Orientation of the text</documentation>
		</parameter>
		<parameter from="string"
			name="text_automatic"
			visible="no"
			default="on"
			member="automatic"
			to="bool">
			<release>Magisc++2.1</release>
			<documentation>How text is to be positioned in each line (LEFT/CENTRE/RIGHT)</documentation>
		</parameter>
		<parameter member="lines"
			to="stringarray"
			default="stringarray()"
			from="stringarray"
			name="text_lines">
			<documentation>text block to be plotted</documentation>
			<migration>New Magics: Parameter text sent to new Magics[TextAction].</migration>
		</parameter>
		<parameter from="string"
			name="text_mode"
			default="title"
			member="mode"
			to="string"
			values="title/positional">
			<documentation>Whether text is to be a title or user positioned (TITLE/POSITIONAL)</documentation>
			<set name="text_box_x_position" value="positional"></set>
			<set name="text_box_y_position" value="positional"></set>
			<set name="text_box_x_length" value="positional"></set>
			<set name="text_box_y_length" value="positional"></set>
			<release>1.0</release>
		</parameter>
		<parameter member="x"
			to="float"
			default="-1"
			from="float"
			name="text_box_x_position">
			<release>0.1</release>
			<documentation>X coordinate of lower left corner of text box (Relative to PAGE_X_POSITION)</documentation>
		</parameter>
		<parameter member="y"
			to="float"
			default="-1"
			from="float"
			name="text_box_y_position">
			<release>0.1</release>
			<documentation>Y coordinate of lower left corner of text box (Relative to PAGE_Y_POSITION)</documentation>
		</parameter>
		<parameter member="width"
			to="float"
			default="-1"
			from="float"
			name="text_box_x_length">
			<release>0.1</release>
			<documentation>Length of text box in X direction</documentation>
		</parameter>
		<parameter xml="height"
			from="float"
			name="text_box_y_length"
			default="-1"
			member="height"
			to="float">
			<release>0.1</release>
			<migration>New Magics: Parameter text_box_y_length sent to new Magics[TextBox].</migration>
		</parameter>
		<parameter member="blanking"
			to="bool"
			default="off"
			from="string"
			name="text_box_blanking">
			<release>0.1</release>
			<release_info>Paremeter defined but not implemeted : expected for 0.6</release_info>
			<documentation>All plotting in the text box previous to PTEXT call will be blanked out. Plotting after PTEXT call will not be affected. (ON/OFF)</documentation>
		</parameter>
		<parameter member="border"
			to="bool"
			default="off"
			from="string"
			name="text_border">
			<release>0.5</release>
			<documentation>Plot border around text box (ON/OFF)</documentation>
			<migration>New Magics: Parameter text_border sent to new Magics[TextBox].</migration>
			<set name="text_border_line_style" value="on"></set>
			<set name="text_border_colour" value="on"></set>
			<set name="text_border_thickness" value="on"></set>
		</parameter>
		<parameter member="border_line_style"
			to="LineStyle"
			default="solid"
			from="string"
			name="text_border_line_style">
			<release>0.5</release>
			<documentation>Line style of border around text box (SOLID/DASH/DOT/CHAIN_DASH/CHAIN_DOT)</documentation>
		</parameter>
		<parameter member="border_colour"
			to="Colour"
			default="blue"
			from="string"
			name="text_border_colour">
			<release>0.5</release>
			<documentation>Colour of border around text box (Full choice of colours)</documentation>
		</parameter>
		<parameter member="border_thickness"
			to="int"
			default="1"
			from="int"
			name="text_border_thickness">
			<release>0.5</release>
			<documentation>Thickness of text box border</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_1"
			default=""
			metview="no"
			member="character1"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_2"
			default=""
			metview="no"
			member="character2"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_3"
			default=""
			metview="no"
			member="character3"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_4"
			default=""
			metview="no"
			member="character4"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_5"
			default=""
			metview="no"
			member="character5"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_6"
			default=""
			metview="no"
			member="character6"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_7"
			default=""
			metview="no"
			member="character7"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_8"
			default=""
			metview="no"
			member="character8"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_9"
			default=""
			metview="no"
			member="character9"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="string"
			name="text_character_10"
			default=""
			metview="no"
			member="character10"
			to="string">
			<documentation>10 Magics parameters enabling users to store CHARACTER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_1"
			default="0"
			metview="no"
			member="integer1"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_2"
			default="0"
			metview="no"
			member="integer2"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_3"
			default="0"
			metview="no"
			member="integer3"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_4"
			default="0"
			metview="no"
			member="integer4"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_5"
			default="0"
			metview="no"
			member="integer5"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_6"
			default="0"
			metview="no"
			member="integer6"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_7"
			default="0"
			metview="no"
			member="integer7"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_8"
			default="0"
			metview="no"
			member="integer8"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_9"
			default="0"
			metview="no"
			member="integer9"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="int"
			name="text_integer_10"
			default="0"
			metview="no"
			member="integer10"
			to="int">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store INTEGER info for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_1"
			default="0"
			metview="no"
			member="real1"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_2"
			default="0"
			metview="no"
			member="real2"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_3"
			default="0"
			metview="no"
			member="real3"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_4"
			default="0"
			metview="no"
			member="real4"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_5"
			default="0"
			metview="no"
			member="real5"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_6"
			default="0"
			metview="no"
			member="real6"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_7"
			default="0"
			metview="no"
			member="real7"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_8"
			default="0"
			metview="no"
			member="real8"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_9"
			default="0"
			metview="no"
			member="real9"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_real_10"
			default="0"
			metview="no"
			member="real10"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>10 Magics parameters enabling users to store REAL information for plotting in text lines (n=1,10)</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_1"
			default="1"
			metview="no"
			member="height_ratio_1"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_2"
			default="1"
			metview="no"
			member="height_ratio_2"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_3"
			default="1"
			metview="no"
			member="height_ratio_3"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_4"
			default="1"
			metview="no"
			member="height_ratio_4"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_5"
			default="1"
			metview="no"
			member="height_ratio_5"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_6"
			default="1"
			metview="no"
			member="height_ratio_6"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_7"
			default="1"
			metview="no"
			member="height_ratio_7"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_8"
			default="1"
			metview="no"
			member="height_ratio_8"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_9"
			default="1"
			metview="no"
			member="height_ratio_9"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="float"
			name="text_line_height_ratio_10"
			default="1"
			metview="no"
			member="height_ratio_10"
			to="float">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter from="string"
			name="text_instruction_shift_character"
			default="\"
			metview="no"
			member="text_instruction_shift_character"
			to="string"
			implemented="no">
			<documentation>Symbol or character for indicating that an Instruction String follows</documentation>
		</parameter>
		<parameter from="string"
			name="text_escape_character"
			default="#"
			member="text_escape_character"
			to="string"
			implemented="no">
			<documentation>Symbol or character followed by 3 octal numbers</documentation>
		</parameter>
		<parameter from="string"
			name="text_parameter_escape_character"
			default="@"
			metview="no"
			member="parameter_escape"
			to="string">
			<documentation>Symbol or character for indicating that a Magics parameter follows. The Magics parameter is also terminated by the same symbol or character.</documentation>
		</parameter>
		<parameter xml="line_height_ratios"
			from="floatarray"
			name="text_line_height_ratios"
			default="floatarray()"
			metview="no"
			member="height_ratios"
			to="floatarray">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of height of text lines to text reference character height (n=1,10). See main text</documentation>
		</parameter>
		<parameter priory="0"
			from="float"
			name="text_line_space_ratio"
			default="1.5"
			member="text_line_space_ratio"
			to="float"
			implemented="no">
			<release_info>Needs user input to see the possible evolution of this parameter</release_info>
			<documentation>Ratio of space above and below each line to text reference character height. See main text</documentation>
		</parameter>
	</class>
</magics>
