Global Mapper Scripting Reference

DEFINE_SHAPE

The DEFINE_SHAPE command allows a multi-point shape (like a polygon) to be associated with a name. The shape name can then be used in later commands for things like cropping and feathering to polygonal boundaries.

The DEFINE_SHAPE command consists of a single command line followed by a series of lines describing the series of XY coordinate pairs that define the shape. Each line should have a single coordinate value with the X and Y coordinates separated by a comma. If you need your shape to contain multiple boundaries, insert BREAK_SHAPE on a line to stop the current sequence and start a new one.

The DEFINE_SHAPE command is terminated with a single line containing only the text END_DEFINE_SHAPE.

The following parameters are required by the DEFINE_SHAPE command.

• SHAPE_NAME - specifies the name to associate with the shape

SAMPLE

Here is an example of a DEFINE_SHAPE command used to define a feather polygon with a name of 'FEATHER_POLY'

DEFINE_SHAPE SHAPE_NAME="FEATHER_POLY"

377493.234,4323974.016

375343.359,4318676.109

381101.953,4314414.750

387014.109,4317178.875

386975.719,4322400.000

381869.766,4324588.266

377493.234,4323974.016

END_DEFINE_SHAPE

Here is an example of a DEFINE_SHAPE command used to define a feather polygon with 2 separate boundaries with a name of 'FEATHER_POLY'

DEFINE_SHAPE SHAPE_NAME="FEATHER_POLY"

377493.234,4323974.016

375343.359,4318676.109

381101.953,4314414.750

387014.109,4317178.875

377493.234,4323974.016

 BREAK_SHAPE

386975.719,4322400.000

381869.766,4324588.266

377493.234,4323974.016

386975.719,4322400.000

END_DEFINE_SHAPE