AGGR (place an aggregate image on the map)

This command, which is part of the MAPPLOT GX, can be used to construct an aggregate and place it on the map. An aggregate is an image on the map that is made up of one or more image components.

Command Syntax

AGGR refp,x1,y1,x2,y2,aspect

agg_name

image,zone,method,contour

(*repeated any number of times)

Only first-level commands can begin in the first column; all arguments/sub-command parameters need to be indented with spaces. See the Example section below.

Command Parameters:

refp	Place the aggregate relative to this reference point. This will normally be reference point 0 for data images, or one of the map reference points for logos and bitmaps.
x1,y1,x2,y2	Optional rectangular area within which to place the aggregate. If not specified, the aggregate location will be placed based on location defined in the image headers.
aspect	If a placement area is defined, this parameter controls the X and Y scaling relative to the defined area:
	0	Fit the aggregate to fit the area exactly.
	1	Preserve the aspect ratio of the aggregate.

Sub-Command Parameters Line 1:

agg_name

The aggregate name in the map. By convention, Geosoft normally used the prefix "AGG_" on aggregate names.

Sub-Command Parameters Line 2:

image	The name of an image file. If the image is not a default grid file, the image type may be specified using name qualifiers as described in DAT_XGD.DOC. For example, a bitmap named MYLOGO.BMP can be specified as "MYLOGO.BMP(IMG)".
zone	The name of a colouring file for colouring images that do not contain native colour. This may be a TBL, ZON, AGG, LUT or ITR file. If not specified, the zone file defined by "MONTAJ.DEFAULT_COLOUR" in the Advanced Settings (Edit\|Settings\|Advanced) is used.
method	For TBL and LUT files, this is the method to use for assigning image ranges to the table colours:
	0	Default for image type (default)
	1	Linear
	2	Normal
	3	Equal area
	4	Shade
	5	Log-linear
contour	The contour interval to use for colour breaks when colouring images. If not specified, colour breaks can be at any value based on the number of colours.

Example

MGRP Mag,0,1
AGGR 0
    AGG_mag
    mag.grd,colour.tbl,3
AGGR 0
    AGG_shaded_mag
    mag.grd,colour.tbl
    mag.grd,grey.tbl,4
AGGR 0
    AGG_ternary
    k.grd,cyan.tbl
    u.grd,yellow.tbl
    th.grd,magenta.tbl

MGRP Logo,0,0
AGGR 3,-3,3,-1,5,1
AGG_logo
mylogo.bmp(img)

MGRP IndexMap,0,0
AGGR 3,-10,7,36,15,1
AGG_indexmap
indexmap.jpg(IMG;t=jpg)

The MGRP command enables you to make a new group on the map.