GCPEXPORT

Description

GCPEXPORT exports ground control points (GCPs) from an image in a CATALYST Professional OrthoEngine project file to a GCP segment.

Parameters

Name	Type	Caption	Length	Value range
OEPROJI *	String	Input OrthoEngine project file	1 - 192
IMAGE_ID *	String	Image ID	1 - 192
FILO	String	Output file name	0 - 192
DBGC	Integer	Output GCP segment number	0 - 1
DBSN	String	Output GCP segment name	0 - 8
DBSD	String	Output GCP segment description	0 - 64

* Required parameter

Parameter descriptions

OEPROJI

Specifies the path and file name of the input OrthoEngine project file.

IMAGE_ID

Specifies the image identification name in the project file to which the GCPs are exported.

The following formats are acceptable:

• S129
• S129.pix
• C:\Projects\Demo Data\S129.pix

FILO

Specifies the output PCIDSK file that will contain the exported GCP segment for IMAGE_ID (Image ID). If this parameter is not specified, the GCP segment is exported to the file that is referenced in the project file and that is associated with IMAGE_ID. If this is not a PCIDSK file, a linked PCIDSK file with an identical base name is created to accept the GCP segment.

DBGC

Specifies the number of the GCP segment in the output file to receive the GCP information. Existing GCP information in the specified GCP segment is overwritten. If the GCP segment does not exist, an error is reported. If this parameter is not specified, a new GCP segment is created in FILO.

DBSN

Specifies a name (up to 8 characters) for the output GCP segment. If a name has not been specified, the default name "GCP" is assigned.

DBSD

Describes (in up to 64 characters) the contents or origins of the output data. If a description is not provided, this parameter is assigned an empty string.

Details

This is equivalent to the OrthoEngine functionality accessed through: Options > Export > GCPs. Fore more information, refer to Exporting ground control points.

Example

Export the GCPs from the S129 image file in the OrthoEngine project file "air_photo.prj" to a new GCP segment in the S129 file. The new segment is given a name and a description of the GCPs.

EASI>OEPROJI="airphoto.prj"
EASI>IMAGE_ID="s129"
EASI>FILO="s129.pix" 
EASI>dbgc=
EASI>DBSN="GCPs"
EASI>DBSD="GCPs for image s129"
EASI>r gcpexport