AGL File Structure - Overview

AGL files are text files that contain special "ASCII Graphics Language" commands. These commands can be used to plot labels, symbols, lines, polygons and other graphic entities in a RockPlot2D window, either alone or on top of an existing map or diagram. They are translated from text file commands to plottable components using the Import / AGL command in the RockPlot2D File menu.

AGL files may be created using an ASCII word processor or text editor, such as Windows Notepad. 

Here is a summary of the commands that are available. Each AGL file can contain any combination of these commands. 

• CIRCLE: Plots a circle at the defined location.
• COLOR: Establishes a default color for subsequent items in the AGL file. 
• COLOR_LEGEND: Plots a color legend.
• GRID: Plots a grid of regularly-spaced lines.
• LABEL: Plots a textual label at a specified X,Y location on a diagram. 
• LINE: Plots a line between two points.
• LINESTYLE: Establishes a default line style for subsequent line items in the AGL file.
• LITH_LEGEND: Plots a legend of lithology names and patterns, from the current Lithology Type Table.
• POLYFILL: Plots a closed polygon along declared X,Y coordinate pairs, filled with defined pattern.
• POLYLINE: Plots a single line segment or multiple, connected line segments between declared X,Y coordinate pairs.
• QUADFILL: Plots a 4-sided polygon at defined coordinates, filled with pattern.
• RASTER: Plots a raster image (BMP, JPG, etc.) at defined coordinate location.
• SCALEBAR: Plots a scalebar between two points, with defined increments.
• STRAT_LEGEND: Plots a legend of stratigraphic unit names and patterns, from the current Stratigraphy Type Table.
• SYMBOL: Plots a graphic symbol at a specified X,Y location on a diagram.
• TEXT_TABLE: Plots a multi-column text box.
• TRICOLOR: Plots color-contoured triangles.
• TRIFILL: Plots a filled triangular region using the current default color.

See also 

• The ReportWorks program for a much easier method of annotating graphic files with text, shapes, and more.
• Importing AGL files into RockPlot2D

CIRCLE:

Use: Plots a circle.

Syntax:

CIRCLE: x , y , radius

Example:

COLOR: RED
CIRCLE: 450 840 35
COLOR: BLUE
CIRCLE: 470 860 25

Back to top.

COLOR:

Use: Changes the color for the items in the listing that follow.  You can list real color names (such as "black" or "red") provided that these names are defined in the default Color Names table.

Syntax:

COLOR: name

Example:

COLOR: BLACK
LABEL: 5 990 8 The "COLOR" Command
COLOR: RED
LINE: 10 970 90 980
COLOR: BLUE
LINE: 10 960 90 970
COLOR: GREEN
LINE: 10 950 90 960
COLOR: FUCHSIA
LINE: 10 940 90 950
COLOR: CYAN
LINE: 10 930 90 940
COLOR: YELLOW
LINE: 10 920 90 930
COLOR: SILVER
LINE: 10 910 90 920

Back to top.

COLOR_LEGEND:

Use: Plots a color legend.

Syntax:

COLOR_LEGEND: x_min , y_min , x_max , y_max , z_min , z_max , contour_interval , title

Example:

COLOR_LEGEND: 340 610 360 670 0 100 10 Mercury

Back to top.

GRID:

Use:  Plots a grid.

Syntax:

GRID: x_min, y_min, x_max, y_max, major_x_spacing, major_y_spacing , minor_x_spacing , minor_y_spacing

Example:

GRID: 110 910 190 980 10 10 2 2

Back to top.

LABEL:

Use: Plots a text label of one or more words.

Syntax:

LABEL: x, y, size, text

Example:

COLOR: BLACK
LABEL: 205 990 8 The "LABEL" Command
COLOR: RED
LABEL: 210 940 25 TX21b

Back to top.

LINE:

Use:  Plots a line between two endpoints.

Syntax:

LINE: x1, y1, x2, y2

Example:

LINE: 410 980 490 910

Back to top.

LINESTYLE:

Use: Defines the line style for LINE items that follow in the listing.

Syntax:

LINESTYLE: number

Example:

LINESTYLE: 0
LINE: 310 960 390 960
LINESTYLE: -1
LINE: 310 950 390 950
LINESTYLE: -2
LINE: 310 940 390 940
LINESTYLE: -3
LINE: 310 930 390 930
LINESTYLE: -4
LINE: 310 920 390 920

Back to top.

LITH_LEGEND:

Use: Plots a lithology legend using the current project's Lithology Type Table

Syntax:

LITH_LEGEND: x_min , y_min , x_max , y_max

Example:

LITH_LEGEND: 430 710 470 770

Back to top.

POLYFILL:

Use:  Plots and fills a polygon with a designated pattern.

Syntax:

POLYFILL: pattern , density ,
x1 , y1
x2 , y2
x3 , y3
etc ...

Example:

POLYFILL: 7 3.0
50 720
10 750
75 775
90 730
50 710

Back to top.

POLYLINE:

Use: Plots a multi-segmented line between x,y coordinate pairs.

Syntax:

POLYLINE:
x1 , y1
x2 , y2
x3 , y3
x4 , y4
(etc.)

Example:

COLOR: LIME
POLYLINE:
110 850
175 875
190 830
150 810

 

Back to top.

QUADFILL:

Use: Plots and fills a four-sized polygon with the current default color.

Syntax:

QUADFILL: x1 , y1 , x2 , y2 , x3 , y3 , x4 , y4

Example:

QUADFILL: 310 710 330 770 390 770 370 710

Back to top.

RASTER:

Use: Plots a raster bitmap (e.g. TIFF, JPG, BMP, etc) within a diagram.

Syntax:

RASTER: x_min , y_min , x_max , y_max , file_name

Example:

RASTER: 310 810 390 880 Tank Farm Airphoto.bmp

Back to top.

SCALEBAR:

Use: Plots a coordinate scalebar.

Syntax:

SCALEBAR: x1 , y1 , x2 , y2 , min , max , increment , caption

Example:

SCALEBAR: 105 720 185 780 0 10 1 SCALEBAR

Back to top.

STRAT_LEGEND:

Use: Used to plot a stratigraphy legend.

Syntax:

STRAT_LEGEND: x_min , y_min , x_max , y_max

Example:

STRAT_LEGEND: 30 610 70 670

Back to top.

SYMBOL:

Use: Plots a symbol from the RockWorks symbol library.

Syntax:

SYMBOL: x , y , size , symbol number

Example:

COLOR: AQUA
SYMBOL: 250 840 50 17

Back to top.

TEXT_TABLE:

Use: Used to plot a text box.

Syntax:

TEXT_TABLE: x_min , y_min , x_max , y_max , title ,
caption_1 ,
caption_2 ,
caption_3 ,
etc ...

Example:

TEXT_TABLE: 110 610 190 670 Statistical Results
Mean 4859.45
Mode 48394
Standard-Deviation 483.43
Kurtosis 54.3
Skewness 23.1

Back to top.

TRICOLOR:

Use: Used to plot color-contoured triangles.

Syntax::

TRICOLOR: z_min , z_max , contour_interval
x1 , y1 , z1 , x2 , y2 , z2 , x3 , y3 , z3 ,
x1 , y1 , z1 , x2 , y2 , z2 , x3 , y3 , z3 ,
x1 , y1 , z1 , x2 , y2 , z2 , x3 , y3 , z3 ,
etc ...

Example:

TRICOLOR: 100 400 10
210 610 100 210 670 200 290 670 300
210 610 100 290 670 300 290 610 400

Back to top.

TRIFILL:

Use: Used to fill a triangular region with the current default color.

Syntax:

TRIFILL: x1 , y1 , x2 , y2 , x3 , y3

Example:

TRIFILL: 210 710 250 770 290 710

Back to top.

RockWare home page