LEGEND {ascii_file} {graphics_file} Plots a geological legend based on information recorded in an ascii file. Arguments {ascii_file} - name of the ascii file to be read containing information about the geological legend. The default file name legend.asc will be used if no file name is entered or if it is skipped using the pound sign (#). The ascii file must have an .asc extension. {graphics_file} - prefix name of graphics file to create. If a graphics file name is entered for this argument the geological legend will be plotted to a series of 8½" x 11" pages. The graphics file name will be appended with the page number, depending on the number of pages required to plot the entire geological legend (i.e.: legend1.gra, legend2.gra, legend3.gra, etc...). If any of these graphic files exist they will be over written. When using WIMP, checking the box "Save to page (letter size)" will default the graphics file name to legend. Notes The ascii file contains descriptive text of the geological legend plus legend commands to plot graphic elements such as brackets, boxes, ellipses within boxes, pattern fills, etc... These legend commands pertain only to the LEGEND command and are not available at any ARC/INFO prompt. Syntax rules for these legend commands are the same as ARC/INFO commands. A complete list of these legend commands follows the examples. Entering a name for the second argument, is a quick method of obtaining a plot of the geological legend on 8½" x 11" paper, by creating a series of graphic files. Use the POSTSCRIPT or SEPARATOR commands to convert the graphic files to PostScript files. Since the entire geological legend will be plotted on several pages, brackets will therefore not be plotted using this option. If a map composition is currently open it will be closed and re-opened after the graphic files have been created. If the LEGEND command encounters an error in the ascii file, it will display the line causing the error along with the line number in the command tool window and continue plotting the remainder of the geological legend. The LEGEND command is accessible from the ARCPLOT prompt or directly from the GSC pulldown menu from the Main ARCPLOT Menu when using WIMP. Do not attempt to execute the LEGEND command from the ARCPLOT prompt when using the keyboard from WIMP. Page units can only be either inches or centimeters. Page size must be set before executing the LEGEND command. The ORIGIN command must appear on the first line in the ascii file. Comment lines are allowed in the ascii file, following the same rules as in AMLs using /*. Any unrecognized commands will be ignored and plotting of the geological legend will continue. Line spaces are required to terminate plotting of descriptive notes used with the DESC and NOTE commands, as well as for separating legend boxes used with the BOX command. In all other cases, line spaces are ignored. Only one bracket at a time can be plotted. Since the legend is plotted from top to bottom, all downward measurements for line spacing and offsets for symbol coordinates should be given as positive values. Examples The following examples cover what is possible with the LEGEND command. Each legend is followed by the ascii file used to create it. These ascii files are stored in gsc70/examples/legend folder. Examples are PostScript files and can not be reproduced in this document. Example 1 This example displays the use of different headings for legend boxes, justification of descriptive notes within the column width, use of ARCPLOT typesetting commands, and how they are positioned relative to the legend box based on the number of lines. ORIGIN 1 10 /* Change default settings SET box_font GSCSpecial-Regular HEADING L CARBONIFEROUS HEADING I 'LOWER AND UPPER CARBONIFEROUS' BOX 1 7Bf DESC BORUP FIORD FORMATION: sandstone, conglomerate (mostly redbeds) HEADING L SILURIAN HEADING D 'TOPSAILS INTRUSIVE SUITE (!FNT110001;^a-^q!FNT110002;)' BOX 1 ^q DESC Quartz-feldspar porphyry, rhyolite, minor basalt; !FNT110001;^qa !FNT110003;, orange to green quartz-K-feldspar porphyry, in large part peralkaline; !FNT110001;^qb!FNT110003;, orange to red quartz-K-feldspar porphyritic rhyolite and minor amygdaloidal basalt flows, felsic volcanics in large part subalkaline, rhyolite-basalt dyke HEADING L ORDOVICIAN HEADING I 'UPPER ORDOVICIAN' HEADING D 'KULUTINGWAK FORMATION' BOX 1 _Ka DESC Member A; tuffaceous phyllite and sandstone, volcanic flows and tuff (including andesite, dacite, basalt, alkali basalt); minor marble END Example 2 This example displays additional text plotted with the NOTE command and the use of indenting and line spacing descriptive text. ORIGIN 1 10 COLUMN 3 0.5 HEADING D 'TECTONITES IN SHEAR ZONES' BOX 116 18 DESC Deformed intrusive rocks 0 a) diorite, tonalite NOTE Note: the Opal Member replaces the Marston Member and possibly parts of the lower and middle Carnarvon Member in most of the areas HEADING D 'DYKE INTRUSIVE COMPLEXES' BOX 10 25 DESC Diabase dyke complex; multi-phase diabase dyke complex, diabasic pegmatite, screens of pillowed basalt 0 a) 0.0 0.9 sheeted heterogeneous complex 0 0.9 including diabase, tonlaite 0 b) 0.0 0.9 plagioclasse-pyroxene porphyry 0 c) 0.0 0.9 quartz-feldspar porphyry END Example 3 This example shows how boxes are stacked, spaced and how to create a variety of boxes within boxes. ORIGIN 1 10 /* Change default settinfs SET box_font GSCSpecial-Regular HEADING D 'MOOSE RIVER MEMBER' BOX 9 |Mr DESC Interlayered rhyolilte, mafic tuff and flows, slate BOX 25 |Mg DESC Black and green mudstone, greywacke BOX 116 |Ka # 1 DESC FRASER BROOK FORMATION: !FNT110001;|Ka!FNT110003;, rhyolite, minor andesite, basalt, red siltstone, slate; !FNT110001;|Kb!FNT110003;, andesite, minor rhyolite, basalt, red siltstone; !FNT110001;|Kc!FNT110003;, basalt, minor andesite, rhyolite, slate, minor volcanics BOXSIZE 4.5 10 SUBBOX 9 0 117 b SUBBOX 13.5 0 119 c BOXSIZE 18 16 BOX 123 |Lc 15 DESC 9 LIVINGSTONE COVE FORMATION: green conglomerate, black mudstone greywacke BOXSIZE 10 4 SUBBOX 8 8 149 u DESC undivided SUBBOX 8 12 161 l DESC lower END Example 4 This example displays the possible uses of brackets as well as miscellaneous text and titles. ORIGIN 1 10 /* Change default settings SET box_font GSCSpecial-Regular COLUMN 3 0.5 BRACKET TOP HEADING L QUATERNARY BOX 7 /Mr DESC Glacial deposits; gravel and sand BRACKET BOTTOM CENOZOIC DOWN BRACKET TOP TEXT 'INTERMEDIATE STRUCTURAL SLICES' CENTER BOX 16 `_Lt DESC Massive to foliated grey and pink quartz diorite BOX 49 `_OM DESC OLD MANS COVE FORMATION: greenschist, minor marble BOX 130 `_Bs DESC Greenschist, amphibolite, minor quartz-mica of metamorphic sole BRACKET OVERLAP PALEOZOIC TEXT 'VOLCANIC AND INTRUSIVE ROCKS' DASH BOX 2 HHL DESC Bimodal metavolcanic rocks and granite BOX 4 HIH DESC Feldspar gneiss, foliated to massive granite, granodiorite BRACKET BOTTOM PROTEROZOIC END Example 5 This example describes plotting additional features in legend boxes such as lines, text, ellipses, marker symbol and irregular shapes using SUB commands as well as using the AP command. ORIGIN 1 10 /* Change default settings SET box_font GSCSpecial-Regular BOX 1 AP 'LINESET GSC; LINESYMBOL 121; LINECOLOR RED' SUBLINE '3 8 12 2' SUBTEXT 9 8 {d 510 10 DESC Diabase dyke BOX 110 |Kf # 1.8 SUBMARKER 11 6 39 # 1.5 SUBTEXT 12 5 om 620 6 DESC Biotite !FNT94021;!PAT1706;!FNT110003; hornblende granite; infiltrated with Orthopyroxene monzonite SET box_font Triumvirate BOX 5 SUBELLIPSE 3 Mh DESC !FNT93710;Hummocky moraine:!FNT110003; silty loam till some 15 to 30 m thick underlying hummocks and depressions BOX 123 Mr # 2.2 DESC !FNT93710;Ridged moraine:!FNT110003; silty loam till interlaced with bedrock consisting of hummocks and subparallel ridges; !FNT93709;Mr!FNT110003;, relief 10 to 30 m, !FNT93709;Mrn!FNT110003;, relief 5 to 10 m SUBSHAPE '6 10 18 10 18 0 12 0' 149 Mrn # 5 END Example 6 This last example displays legend boxes with pattern fills, irregular and complex shapes and plotting a cover features within a box. ORIGIN 1 10 /* Change default settings SET box_font GSCSpecial-Regular AP 'SHADESET GSC; MARKERSET GSC2; LINESET GSC' BOX SUBMARKER 4.5 5 265 BOXSIZE 9 10 SUBBOX 9 0 7 AP 'SHADESET GSC_PTRN' PATTERNFILL 120 # # ON 9c DESC alkalic rock, carbonatites of the 0 SPANISH RIVER COMPLEX AP 'SHADESET GSC' BOXSIZE DEFAULT BOX 14 SUBELLIPSE 17 AP 'SHADESET GSC_PTRN' PATTERNFILL 15 WHITE 1 OFF >k DESC KEPPOCH FORMATION: undivided volcanics AP 'SHADESET GSC' BOX 156 _^B 25 10 DESC BEARS BROOK FORMATION: !FNT110001;_^B!FNT110003;, red arkosic sandstone conglomerate. !FNT110001;_^Bv!FNT110003;,rhyolite, minor basalt SUBSHAPE '0 0 0 8 15 4' 129 _^Bv # 1 BOX # Q 15 2 AP 'SHADESET GSC_PTRN' SUBCOVER LEG1 POLYGONS 120 AP 'LINEDELETE ALL; LINESET GSC; LINESYMBOL 23; LINECOLOR RED' SUBCOVER LEG1 ARCS SUBBOX 0 0 DESC Quaternary AP 'SHADESET GSC' BOXSIZE 18 21 BOX BOXSIZE 18 7 SUBBOX 0 7 111 `Wq # 9 DESC Webb Creek quartz megacrystic tonalite SUBBOX 0 14 114 `Wa # 9 DESC Webb Creek agmatite (the following two lines are entered as one line in the ascii file) SUBSHAPE '0,0 0,21 8,21 4.5 19.25 8,17.5 4.5,15.75 8,14 4.5,12.25 8,10.5 4.5,8.75 8,7 18,7 18,0' 111 `W 14 DESC 14 Quartz diorite, tonalite, granodiorite, quartz diorite intrusion breccia END LIST OF COMMANDS -------------------------------------------------------------------------------- AP Executes an ARCPLOT command. Arguments - any ARCPLOT command, enclosed in single quotes. Notes Control returns to the legend routine after the command has been completed. The command can also execute an AML directive or function. The AP command is useful in changing symbolsets within your legend ascii file. Subsequent use of symbols would be referenced to the specified symbolset. Example: AP 'SHADESET GSC_PTRN' To execute an ARCPLOT command using the values of legend routine variables or to execute an AML which passes the values of legend routine variables as arguments, use the quote and value functions in place of single quotes. Example: AP [quote &run my_aml [value .leg$x]] would pass the value of the variable .leg$x (X coordinate, left side of legend column) to the AML my_aml as the first argument. -------------------------------------------------------------------------------- BOX {shade_symbol | colour} {text} {line_spacing} {indent} Plots a legend box with or without a colour fill and/or a text string. Arguments {shade_symbol | colour} - specifies the colour to be plotted inside the legend box. No colour is plotted if this argument is skipped. If an invalid shade symbol or colour are entered only the box outline will be plotted. shade_symbol - a shade symbol number from the current shadeset. colour - any ARC/INFO supported colour name or colour model, enclosed in single quotes if spaces exist. {text} - text plotted inside the box, enclosed in single quotes if spaces exist. {line_spacing} - distance from top of legend box to baseline of text, measured in points unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered vertically within the dimensions of the box. {indent} - distance from left of legend box to starting position of text string, measured in millimeters unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered horizontally within the dimensions of the box. Notes Size of the box defaults to 10 x 18 millimeters, and can be changed using the BOXSIZE command. Text plotted within the box defaults to 10 point Triumvirate, plotted in black (CMYK -1 -1 -1 100) and the box outline is plotted as a 0.010" black line (CMYK -1 -1 -1 100). These default settings can be changed using the SET command. -------------------------------------------------------------------------------- BOXSIZE {MM | INCHES | POINTS} BOXSIZE DEFAULT Sets the size of legend boxes plotted using the BOX and SUBBOX commands. Arguments - distance representing the width of the legend box. - distance representing the height of the legend box. {MM | INCHES | POINTS} - optional keyword stating the unit of measurement for above distances. Millimeters is the default. DEFAULT - keyword specifying that the size of the legend boxes is defaulted to 18 x 10 millimeters. Notes Both width and height arguments are required when explicitly setting a distance. Millimeters is used if an unknown unit of measurement is entered. -------------------------------------------------------------------------------- BRACKET TOP {LEFT | RIGHT} {offset} BRACKET {UP | DOWN | HORIZONTAL} {shift} Plots a bracket and text alongside bracket. Arguments TOP - keyword that establishes starting point of a new bracket. {LEFT | RIGHT} - keywords specifying which type of bracket will be plotted at the left margin of the legend column. LEFT - left bracket will be plotted (point of bracket points left). This is the default. RIGHT - right bracket will be plotted (point of bracket points right). {offset} - distance between ends of bracket and left margin of legend column, measured in millimeters, unless stated otherwise with the SET command. Default distance is 0 if no offset distance is entered. - keywords to plot the bracket and the text string. BOTTOM - establishes the bottom of the bracket. OVERLAP - end of the bracket is plotted in three dashes so as to continue with the next bracket. - text to be plotted at the point of the bracket, enclosed in single quotes if spaces exist. No bracket will be plotted if this argument is blank. {UP | DOWN | HORIZONTAL} - keywords stating the direction of the text string. UP - the text is read upwards. This is the default. DOWN - the text is read downwards. HORIZONTAL - the text is placed horizontally next to the point of the bracket. {shift} - distance from point of bracket, measured in millimeters unless stated otherwise with the SET command. A positive distance will shift the point of the bracket up and a negative distance will shift the point of the bracket down. Default distance is 0. Notes Only one bracket can be plotted at a time. The text string can only be one line of text. Multiple lines of text are not permitted. By default, the text string is plotted as 10 point Triumvirate Light in black (CMYK -1 -1 -1 100), the bracket is plotted as a 0.007" thick line in black (CMYK -1 -1 -1 100), and the width of the bracket is 3mm (horizontal distance from the end of the bracket to the stem of the bracket and from the stem to the point of the bracket). These default settings can be changed using the SET command. -------------------------------------------------------------------------------- COLUMN COLUMN {INCHES | MM | PICAS} Starts a new legend column or to set the width of legend columns and the gap between legend columns. Arguments - keyword to start a new legend column to the right of the current legend column. - distance used to specify width of legend columns. - distance used to specify gap between legend columns. {INCHES | MM | PICAS} - optional keyword stating the unit of measurement for width and gap distances. Inches is the default. Notes At the start of the legend routine, the column width and gap is preset to 5 inches and ½ inch respectively. When starting a new legend column, the left margin is positioned to the right based on the distances of both the column width and column gap. The value of the column width establishes the right margin of the legend column. The right margin is used in the DESC and NOTE commands to prevent any words from extending past the right margin. The column width is not meant to fully left-right justify any lines of text. -------------------------------------------------------------------------------- DESC Plots subsequent lines of text to the right of a legend box and not exceeding the right margin of the legend column, until a blank line is encountered. Notes (To aid in deciphering the information below, lines of text or line of text refers to each line of text in the ascii file and text string refers to each line of text that is plotted next to the legend boxes.) Subsequent lines of text are not required to be enclosed in single quotes, allowing for ease of cutting and pasting lines of text from different document sources. However, each line of text requires a "hard return" at the end. Any words that exceed the right margin of the legend column will be appended to following lines of text, until a blank line in the ascii file is encountered. Upper and lower extremes of legend boxes (plotted with BOX and SUBBOX command) and shapes (plotted with SUBSHAPE command) are used to set limits and position the text strings. If the first word in each line of text is numeric, it is interpreted as a value for line spacing, measured only in points for this procedure. If no line spacing value is specified on the first line of text, the text strings will be centered vertically to the height of the legend box or shape not exceeding the top of the box or shape. If a line spacing value is specified on the first line of text, the first text string will be positioned that value from the top of the box or shape. If a line spacing value is specified in subsequent lines of text, the text that follows will be plotted as a separate text string (a value of 0 will use the default line spacing of 125% of the point size of the text, whereas a value of 0.0 will use a line spacing value of 0 points). If no line spacing value is specified the line spacing will default to 125% of the point size of the text string. If the second word in each line of text is numeric it is interpreted as a value for indenting, measured only in picas for this procedure from the left margin for descriptive text. A numeric value for line spacing must be entered if a value for indenting is required. The pound sign (#) can not be used. By default, the text string is plotted as 8 point Triumvirate Light Italic in black (CMYK -1 -1 -1 100). These defaults can be changed using the SET command. -------------------------------------------------------------------------------- END Terminates plotting of the legend. Notes Can be placed anywhere in the legend ASCII file to terminate plotting of the legend. -------------------------------------------------------------------------------- HEADING {line_spacing} {indent} Plots rock ages or group text strings as headings to geological units. Arguments - keyword specifying the placement of the left-justified text string, as well as font and point size. No text is plotted if any other character is used. L - the text string will be aligned to the left margin of the column. By default the text string will be plotted in 9 point Triumvirate Light. I - the text string will be indented from the left margin of the column half the distance between the left margin of the column and the left margin for descriptive text (normally 2.5 picas). By default the text string will be plotted in 8 point Triumvirate Light. B - the text string will be indented the current legend box width from the left margin of the column. By default the text string will be plotted in 8 point Triumvirate Light. D - the text string will be aligned with the left margin for descriptive text. By default the text string will be plotted in 8 point Triumvirate Light Italic. - text string to be plotted, enclosed in single quotes if spaces exist. No text is plotted if this argument is blank. {line_spacing} - distance from previous plotted legend element to baseline of text string, measured in points, unless stated otherwise using the SET command. Default distances from previously plotted legend elements are used when this argument is skipped or an incorrect value is entered. Default distances are as follows: Bottom of legend box, descriptive text, and other text strings - 20 points Heading - 10 points Top or bottom of legend bracket - 5 points {indent}- distance from left margin of the column to the left-justified text string, measured in picas, unless stated otherwise using the SET command. If no distance is given, the text string will be indented based on the first argument. Notes By default, the text string is plotted in black (CMYK -1 -1 -1 100). These defaults, including point size and font, can be changed using the SET command. -------------------------------------------------------------------------------- NOTE Plots subsequent lines of text aligned with the left margin for descriptive text and not exceeding the right margin of the legend column, until a blank line is encountered. Notes (To aid in deciphering the information below, lines of text or line of text refers to each line of text in the ascii file and text string refers to each line of text that is plotted next to the legend boxes.) Subsequent lines of text are not required to be enclosed in single quotes, allowing for ease of cutting and pasting lines of text from different document sources. However, each line of text requires a "hard return" at the end. Any words that exceed the right margin of the legend column will be appended to following lines of text, until a blank line in the ascii file is encountered. If the first word in each line of text is numeric, it is interpreted as a value for line spacing, measured only in points for this procedure. If no line spacing value is specified on the first line of text, default line spacing distances from previously plotted legend elements listed below are used. Bottom of legend box, descriptive text and other lines of text - 20 points Heading text string - 15 points Top or bottom of legend bracket - 5 points If a line spacing value is specified on the first line of text, the first text string will be positioned that distance in points from a previous plotted legend element. If a line spacing value is specified in subsequent lines of text, the text that follows will be plotted as a separate text string (a value of 0 will use the default line spacing of 125% of the point size of the text, whereas a value of 0.0 will use a line spacing value of 0 points). If no line spacing value is specified the line spacing will default to 125% of the point size of the text string. If the second word in each line of text is numeric it is interpreted as a value for indenting, measured only in picas for this procedure from the left margin for descriptive text. A numeric value for line spacing must be entered if a value for indenting is required. The pound sign (#) can not be used. By default, the text string is plotted as 8 point Triumvirate Light Italic in black (CMYK -1 -1 -1 100). These defaults can be changed using the SET command. -------------------------------------------------------------------------------- ORIGIN {PAGE} ORIGIN Position the legend on the page. Arguments - X-coordinate value on page where the left margin of the first column is positioned. - Y-coordinate value on page where the top of the legend is position. {PAGE} - optional keyword argument stating that above coordinates are based on page coordinates. - X-coordinate value from current map extent where the left margin of the first column is positioned. - Y-coordinate value from current map extent where the top of the legend is position. - required keyword when above coordinates are based on the current map extent. Notes The ORIGIN command must appear on the first line in the ASCII file to position the legend on the page. Positioning the legend using map coordinates from the current map extent can be beneficial if you need the legend to move with the map whenever the position of the map changes. -------------------------------------------------------------------------------- PATTERNFILL {shade_symbol} {shade_colour} {shade_scale} {ON | OFF} {text} {line_spacing} {indent} Plots a pattern/shade symbol inside a plotted box, ellipse, or shape. Arguments {shade_symbol} - specifies the shade symbol from the current shadeset to plot. If no shade symbol is entered or the argument is skipped, the current shade symbol settings from a previous plotted legend element or shade symbol settings from the AP command are used. No pattern/shade symbol is plotted if the shade symbol does not exist. {shade_colour} - specifies the colour of the shade symbol. Any ARC/INFO supported colour name or colour model can be used, enclosed in single quotes if spaces exist. No default colour is applied to the shade symbol if this argument is skipped. {shade_scale} - specifies the scale factor of the shade symbol. No default scale is applied to the shade symbol if this argument is skipped. {ON | OFF} - keyword specifying whether or not the shade symbol is masked when plotting text. ON - shade symbol will be masked. OFF - shade symbol will not be masked. {text} - text plotted inside the box, ellipse or shape, enclosed in single quotes if spaces exist. {line_spacing} - distance from top of legend box or shape to baseline of text, measured in points unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered vertically within the dimensions of the box or the vertical extremes of the shape. {indent} - distance from left edge of legend box or shape to starting position of text string, measured in millimeters unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered horizontally within the dimensions of the box or the horizontal extremes of the shape. Notes Text plotted within the box or shape defaults to 10 point Triumvirate, plotted in black (CMYK -1 -1 -1 100). The box, ellipse or shape outline is plotted as a 0.010" black line (CMYK -1 -1 -1 100). Text masking uses the RECTANGLE option with a width of 0.03". These default settings can be changed using the SET command. With ARC/INFO Rev. 7.0.3, text masking using the HALO option does not reproduce on hardcopy. -------------------------------------------------------------------------------- SET Change default values of legend elements. Arguments - name of the variable used in the legend AML to store default values. - value assigned to variable. Notes Listed in the chart below are the default values of the variables when the legend AML starts. The variable name and the value are not case sensitive. For numeric values the unit of measurement is enclosed in brackets under the description column. You must enclose the font names in single quotes if they contain any spaces (i.e.: 'Triumvirate Light Italic'). * If units are in: points, value should be 72; mm (millimeters), value should be 25.4; cm (centimeters), value should be 2.54; picas, value should be 6; inches, value should be 1. Variable Default Value Description -------- ------------- ----------- bkt_colour CMYK -1 -1 -1 100 Colour of text plotted with BRACKET command bkt_font 'Triumvirate Light' Font style of text plotted with BRACKET command bkt_line_size 0.007 Line thickness of brackets (inches) bkt_line_colour CMYK -1 -1 -1 100 Line colour of brackets bkt_size 10 Size of text plotted with BRACKET command (points) bkt_text_offset 1 Distance from point of bracket to text position (mm) bkt_units 25.4 Unit of measurement for offset and shift distances used with BRACKET command * bkt_width 3 Width of bracket; horizontal distance from main stem to end and main stem to point (mm) box_colour CMYK -1 -1 -1 100 Colour of text plotted inside box used with BOX, SUBBOX, SUBELLIPSE, SUBSHAPE and PATTERNFILL commands box_font Triumvirate Font style of text ploted inside box used with BOX, SUBBOX, SUBELLIPSE, SUBSHAPE and PATTERNFILL commands box_height 10 Height of legend box (mm) box_indent 25.4 Unit of measurement for text indenting distance used with BOX, SUBBOX, SUBELLIPSE, SUBSHAPE and PATTERNFILL commands * box_line_spacing 72 Unit of measurement for text line spacing distance used with BOX, SUBBOX, SUBELLIPSE, SUBSHAPE and PATTERNFILL commands * box_size 10 Size of text plotted inside box used with BOX, SUBBOX, SUBELLIPSE, SUBSHAPE and PATTERNFILL commands (points) box_width 18 Width of legend box (mm) column_width 4.5 Width of legend columns (inches) column_gap 0.5 Width between legend columns (inches) desc_colour CMYK -1 -1 -1 100 Colour of text plotted with DESC command desc_font 'Triumvirate Light Font style of text plotted with DESC Italic' command desc_indent 5 Distance from left margin of legend column to left margin of desrcriptive text (picas) desc_size 8 Size of text plotted with DESC command (points) headingb_colour CMYK -1 -1 -1 100 Colour of text plotted with HEADING command using position B headingb_font 'Triumvirate Light' Font style of text plotted with HEADING command using position B headingb_size 8 Size of text plotted with HEADING command using position B (points) headingd_colour CMYK -1 -1 -1 100 Colour of text plotted with HEADING command using position D headingd_font 'Triumvirate Light Font style of text plotted with HEADING Italic' command using position D headingd_size 8 Size of text plotted with HEADING command using position D (points) headingi_colour CMYK-1 -1 -1 100 Colour of text plotted with HEADING command using position I headingi_font 'Triumvirate Light' Font style of text plotted with HEADING command using position I headingi_size 8 Size of text plotted with HEADING command using position I (points) headingl_colour CMYK-1 -1 -1 100 Colour of text plotted with HEADING command using position L headingl_font 'Triumvirate Light' Font style of text plotted with HEADING command using position L headingl_size 9 Size of text plotted with HEADING command using position L (points) indent 6 Unit of measurement for text indent distances used with HEADING, TEXT and TITLE commands * line_size 0.010 Thickness of outline for legend boxes, shapes and ellipses (inches) line_colour CMYK -1 -1 -1 100 Colour of outline for legend boxes, shapes and ellipses line_spacing 72 Unit of measurement for text line spacing distance used with HEADING, TEXT and TITLE commands * note_colour CMYK -1 -1 -1 100 Colour of text plotted with NOTE command note_font 'Triumvirate Light Font style of text plotted with NOTE Italic' command note_size 8 Size of text plotted with NOTE command (points) space 14 Spacing between legend boxes (points) sub_units 25.4 Unit of measurement for X and Y distances used with SUBBOX, SUBLINE, SUBMARKER, SUBSHAPE and SUBTEXT commands * subcover_units 25.4 Unit of measurement for cover units used with SUBCOVER command * text_colour CMYK -1 -1 -1 100 Colour of text plotted with TEXT command text_font 'Triumvirate Light Font style of text plotted with TEXT Italic' command text_size 8 Size of text plotted with TEXT command (points) textmask_shape RECTANGLE Shape of mask around text, used in PATTERNFILL and TEXT command. Choices for value are HALO, POLYGON and RECTANGLE textmask_size 0.03 Thickness of mask around text, used in PATTERNFILL and TEXT commands (inches) title_colour CMYK -1 -1 -1 100 Colour of text for legend title title_font 'Triumvirate Light' Font style of text for legend title title_size 10 Size of text for legend title (points) -------------------------------------------------------------------------------- SKIP Skips and ignores subsequent lines in ascii file until another SKIP is encountered. Notes Ideal for skipping sections of a legend when creating one. The command END takes precedence over the SKIP command and if encountered the legend will stop plotting. -------------------------------------------------------------------------------- SUBBOX {shade_symbol | colour} {text} {line_spacing} {indent} Plots a legend box with or without a colour fill and/or text, in relationship to a legend box plotted with the BOX command. Arguments - X and Y distance measured in millimeters, unless stated otherwise with the SET command, from the upper-left corner of the legend box plotted with BOX command to the upper-left corner of the subbox. {shade_symbol | colour} - specifies the colour to be plotted inside the subbox. No colour is plotted if this argument is skipped or an incorrect value is entered. shade_symbol - a shade symbol number from the current shadeset. colour - any ARC/INFO supported colour name or colour model, enclosed in single quotes if spaces exist. {text} - text to be plotted within the box, enclosed in single quotes if spaces exist. No text is plotted if this argument is skipped. {line_spacing} - distance from top of subbox to baseline of text, measured in points, unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered vertically within the dimensions of the subbox. {indent} - distance from left of subbox to starting position of text string, measured in millimeters, unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered horizontally within the dimensions of the subbox. Notes Text plotted within the box defaults to 10 point Triumvirate, plotted in black (CMYK -1 -1 -1 100). The subbox is plotted as a 0.010" black line (CMYK -1 -1 -1 100). These default settings can be changed using the SET command. Use the BOXSIZE command prior to the SUBBOX command to change the size of the subbox. -------------------------------------------------------------------------------- SUBCOVER {symbol_item | symbol} Plots features from a cover within a legend box plotted with the BOX command. Arguments - name of cover to plot within legend box. Cover can be pathed to any workspace. Nothing will be plotted if the cover does not exist. - keyword specifying the type of feature to plot from the cover. ARCS - arcs from the cover are plotted as lines. POINTS - label points from the cover are plotted as markers. POLYGONS - polygons from the cover are plotted as shades. {symbol_item | symbol} - defines how specified features are plotted. If nothing is entered for this argument, the current symbol settings for the specified feature as set with the AP command will be used. symbol_item - an item from the specified feature's attribute table whose value will be used as the symbol number from the corresponding symbolset. symbol - a symbol number from the corresponding symbolset. Notes The cover is not checked prior to plotting for the existence of the specified features, feature attribute table nor if the symbol item exists. The cover's (0,0) coordinate is positioned at the lower left corner of the legend box. By default the map units of the cover will be interpreted as millimeters, however this can be changed using the SET command. Use the Geogrid Menu in WIMP to create an outline that will represent the legend box. Example: for a legend box with default dimensions, enter 0 0 0 for southern latitude and western longitude, 10 0 0 for northern latitude and 18 0 0 for eastern longitude. Features can then be added in ARCEDIT, snapping arcs to the outline and even deleting the outline afterwards if not needed. If required, build the corresponding feature attribute table and code features using the symbol item. -------------------------------------------------------------------------------- SUBELLIPSE {shade_symbol | colour} {text} {line_spacing} {indent} Plots an ellipse inside a legend box plotted with either the BOX or SUBBOX command, with or without a colour fill and/or text. Arguments {shade_symbol | colour} - specifies the colour to be plotted inside the ellipse. No ellipse is plotted if this argument is skipped. shade_symbol - a shade symbol number from the current shadeset. colour - any ARC/INFO supported colour name or colour model, enclosed in single quotes if spaces exist. {text} - text plotted within ellipse, enclosed in single quotes if spaces exist. No text is plotted if nothing is entered for this argument. {line_spacing} - distance from top of box ellipse is plotted in to baseline of text, measured in points, unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered vertically within the dimensions of the ellipse. {indent} - distance from left of box ellipse is plotted in to starting position of text string, measured in millimeters, unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered horizontally within the ellipse. Notes By default, text plotted within the box defaults to 10 point Triumvirate, plotted in black (CMYK -1 -1 -1 100) and the outline of the ellipse is plotted as a 0.010" black line (CMYK -1 -1 -1 100). These default settings can be changed using the SET command. Shape of the ellipse can not be altered, however the size of the ellipse is scaled automatically to fit inside the dimensions of any size legend box plotted with either the BOX or SUBBOX command. The ellipse is a cover that must exist in the workspace gsc70/covers, and the &atool path must be set to gsc70/amls. -------------------------------------------------------------------------------- SUBLINE {line_symbol} {OFF | ON} Plots a line in a legend box. Arguments - a series of X,Y coordinate pairs enclosed in single quotes where each coordinate pair represents the X and Y distance measured in millimeters, unless stated otherwise using the SET command, from the upper-left corner of the legend box to a point/vertex on the line. A minimum of two coordinate pairs must be entered to define a line. {line_symbol} - specifies the line symbol from the current lineset to plot. If no line symbol is entered or the argument is skipped, the current line symbol settings from a previous plotted legend element or line symbol settings set with the AP command are used. No line is plotted if the line symbol does not exist. {OFF | ON} - optional keyword specifying whether or not to spline the line. OFF - the line is not splined. This is the default. ON - the line is splined. Notes Splining of the line uses the ARCPLOT command SPLINE. -------------------------------------------------------------------------------- SUBMARKER {marker_symbol} {angle} {scale} Plots a marker symbol in a legend box. Arguments - X and Y distance measured in millimeters, unless stated otherwise using the SET command, from the upper-left corner of the legend box to the location of the marker symbol. {marker_symbol} - specifies the marker symbol from the current markerset to plot. If no marker symbol is entered or the argument is skipped, the current marker symbol settings from a previous plotted legend element or marker symbol settings set with the AP command are used. No marker is plotted if the marker symbol does not exist. {angle} - optional value specifying the angle of the marker symbol. {scale} - optional value specifying the scaling factor of the marker symbol. -------------------------------------------------------------------------------- SUBSHAPE {shade_symbol | colour} {text} {line_spacing} {indent} Plots a shape inside a legend box plotted with either the BOX or SUBBOX command, with or without a colour fill and/or text. Arguments - a series of X,Y coordinate pairs enclosed in single quotes where each coordinate pair represents the X and Y distance measured in millimeters, unless stated otherwise using the SET command, from the upper-left corner of the legend box to a point/vertex on the line that defines the shape. A minimum of three coordinate pairs must be entered to define a shape. {shade_symbol | colour} - specifies the colour to be plotted inside the shape. No colour is plotted if this argument is skipped, or if an invalid shade symbol or colour are entered. shade_symbol - a shade symbol number from the current shadeset. colour - any ARC/INFO supported colour name or colour model, enclosed in single quotes if spaces exist. {text} - text plotted inside the shape, enclosed in single quotes if spaces exist. {line_spacing} - distance from upper most coordinate of the shape to baseline of text, measured in points unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered vertically within the dimensions of the shape. {indent} - distance from left most coordinate of legend box to starting position of text string, measured in millimeters unless stated otherwise using the SET command. If no distance is given, or the argument is skipped, the text string is centered horizontally within the dimensions of the shape. Notes Text plotted within the shape defaults to 10 point Triumvirate, plotted in black (CMYK -1 -1 -1 100) and the outline of the shape is plotted as a 0.010" black line (CMYK -1 -1 -1 100). These default settings can be changed using the SET command. -------------------------------------------------------------------------------- SUBTEXT {text_symbol} {point_size} Plots additional text in a legend box. Arguments - X and Y distance measured in millimeters, unless stated otherwise using the SET command, from the upper-left corner of the legend box to the lower-left justification position of the text string. - text string to plot in legend box, enclosed in single quotes if spaces exist. {text_symbol} - specifies the text symbol from the current textset to plot. If no text symbol is entered or the argument is skipped, the current text symbol settings from a previous plotted legend element or text symbol settings set with the AP command are used. No text is plotted if the text symbol does not exist. {point_size} - optional value specifying the point size of the text string. -------------------------------------------------------------------------------- TEXT {line_spacing} {indent} TEXT
{line_spacing} Plots a single line of text for titles and/or for other uses. Arguments - text string to plot, enclosed in single quotes if spaces exist. No text is plotted if this argument is blank.
- keyword to center the text string in the legend column with or without a dashed line on either side. CENTER - text string will be center justified in column. DASH - text string will be center justified in column as well as a dash line plotted on either side. {line_spacing} - distance from previous plotted legend element to baseline of text string, measured in points unless stated otherwise with SET command. Default distances from previously plotted legend elements are used when this argument is skipped or an incorrect value is entered. Default distances are as follows: Bottom of legend box, descriptive text and other lines of text - 20 points Heading - 15 points Top or bottom of legend bracket - 5 points {indent} - distance from left edge of the column to the text string, measured in picas unless stated otherwise with SET command. If a negative distance is entered, the text string will be plotted to the left of the column. Notes By default, the text string is plotted as 8 point Triumvirate Light Italic in black (CMYK -1 -1 -1 100), and the dashed line is plotted as a 0.010" thick line in black (CMYK -1 -1 -1 100) with a dash and gap of 0.040". These defaults can be changed using the SET command. -------------------------------------------------------------------------------- TITLE {text_string} {line_spacing} {indent} Plots a title for the legend. Arguments {text_string} - the text string to be plotted, enclosed in single quotes if spaces exist. The default text string is 'L E G E N D' if nothing is entered. {line_spacing} - distance above origin coordinates of legend to baseline of text string, measured in points. Default distance is 180% the point size of the text string. {indent} - distance from origin coordinates of legend to the text string, measured in picas. If no distance is given, the text string will be centered above all columns. Notes The command TITLE can appear anywhere in the ascii file, usually at the end however. The title will be plotted when the end of the ascii file or the END command in the ascii file is encountered. By default, the text string is plotted as 10 point Triumvirate Light in black (CMYK -1 -1 -1 100). The text string defaults can be changed using the SET command.