FEXPORT -- Export to Foreign File

Transfers all the requested image, and auxiliary information from a source file to an output file. Only some supported GDB formats may be exported to.

PARAMETERS

FEXPORT is controlled by the following global parameters:

Name     Prompt                                  Count     Type
FILI     Database Input File Name                1-64      Char
FILO     Database Output File Name               1-64      Char
DBIW     Database Input Window                   0-4       Int
DBIC     Database Input Channel List             0-1024    Int
DBIB     Database Input Bitmap                   0-1024    Int
DBVS     Database Vector Segment                 0-1024    Int
DBLUT    Database Lookup Table Segment           0-1024    Int
DBPCT    Database Pseudocolour Segment           0-1024    Int
FTYPE    Output File Type                        1-3       Char
FOPTIONS Output File Options                     0-64      Char

FILI

Specifies the name of the PCIDSK database containing the data to be exported.

 EASI>FILI="file_spec"

FILO

Specifies the name of the output file to be created. FILO will be created automatically. Please specify a filename.

 EASI>FILO="file_spec"

DBIW

Specifies the image window to be read from the input channels.

 EASI>DBIW=Xoffset,Yoffset,Xsize,Ysize
 EASI>DBIW=                     | defaults to entire image

DBIC

Specifies the list of input channels to be read from FILI.

 EASI>DBIC = i,j,k, ...

Up to 1024 channels can be handled
Up to 16 integer values can be specified
Ranges of channels can be specified by using negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}

DBIB

Specifies the database bitmap segments to be transferred.

 EASI>DBIB=i,j,...,p

Ranges of segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}.
Up to 1024 segments can be specified.
Duplicate segments are NOT allowed.

DBVS

Specifies the database vector segments to be transferred.

 EASI>DBVS=i,j,...,p

Ranges of segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}.
Up to 1024 segments can be specified.
Duplicate segments are NOT allowed.

DBLUT

Specifies database lookup table segments to be transferred.

 EASI>DBLUT=i,...j,k

Ranges of channels/segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}.
Up to 1024 segments can be specified.
Duplicate segments are allowed.

DBPCT

Specifies database pseudocolour table segments to be transferred.

 EASI>DBPCT=i,...j,k

Ranges of channels/segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}.
Up to 1024 segments can be specified.
Duplicate segments are allowed.

FTYPE

Specifies the file format type of the output file. This is the abbreviated code for the file format. Some supported file format codes are:

 EASI>FTYPE="TIF"               | Tagged Image File Format
 EASI>FTYPE="XWD"               | X Window Dump

FOPTIONS

File creation options. These are specific to the file format, and in each case the default of no options is legal. The FOPTIONS may be used to specify the compression schemes, file format subtype or other information.

 EASI>FTYPE="TIF"       | TIFF
 EASI>FOPTIONS="LZW"    | Lempel-Ziv Welch compression.

DETAILS

FEXPORT is used to export an window of selected data layers in a PCIDSK file to a foreign file format. Image channels, bitmaps, vectors, LUTs and PCTs may be exported, though most formats do not support all of these data types.

The user must explicitly list the channels (DBIC), bitmaps (DBIB), vectors (DBVS), LUTs (DBLUT) and PCTs (DBPCT) to be exported. As well the user may optionally provide a subwindow (DBIW) on the source database to export.

For formats that support it, georeferencing information will also be written to the output file. It will be computed based on the contents of the georeferencing if the input file, and the window requested in DBIW.

The FTYPE parameter is used to control the type of the output database. The full list of support output database types are listed in the FORMATS topic. Some formats require additional information to control the nature of the created output file, and these are supplied in the FOPTIONS parameter.

Note that most formats have limitations on the data types, and number of layers, that can be stored. The user is responsible for only providing legal data combinations in DBIC, DBIB, DBVS, DBLUT and DBPCT. Illegal combinations will cause FEXPORT to terminate, or the generation of improper output files.

EXAMPLE

The user wishes to export bitmap segment 9 from irvine.pix to a CCITT Fax 3 compressed TIFF file.

 EASI>FILI="/pci/demo/irvine.pix"
 EASI>FILO="lake.tif"
 EASI>DBIB=9
 EASI>FTYPE="TIF"
 EASI>FOPTIONS="FAX3"
 EASI>RUN FEXPORT

About PCI Help Gateway