PCTREAD

Description

Reads a pseudocolor table from a text file, then transfers the data to a pseudocolor table segment (PCT type 171 or BPCT type 173) in a database file.

Parameters

Name	Type	Length	Value range
OutputPCT: Output PCT segment	PCT or BPCT port	0 - 1
PCT Segment Name *	String	1 - 1
PCT Segment Description	String	0 - 1
PCT Text Form	String	0 - 1	ATT \| INOUT \| OUT Default: ATT
Pseudocolor Text File *	String	1 -

* Required parameter

Parameter descriptions

OutputPCT: Output PCT segment

Specifies the output segment to receive the pseudocolor table (PCT type 171 or BPCT type 173).

If this parameter is not unspecified, a new PCT segment is created.

PCT Segment Name

Specifies a name (up to 8 characters) for the output PCT segment.

This parameter is required only if a new output segment is created.

PCT Segment Description

Describes (in up to 64 characters) the contents or origins of the output PCT segment.

This parameter may be used ony if a new output segment is created.

PCT Text Form

Specifies the text format of the pseudocolor table data in the text file.

Supported options are:

ATT: attribute format (range r g b); this is the default format
INOUT: input/output format (level r g b)
OUT: output format (r g b)

Pseudocolor Text File

Specifies the name of the input text file that contains the pseudocolor table data to read.

Details

PCTREAD transfers pseudocolor table data from a specified text file (TFILE) to a pseudocolor table segment (DBPCT with PCT type 171 or BPCT type 173) in a database file (FILE), assuming a specified text file format (PCTFORM).

Three text file formats are available:

Attribute format (ATT): uses the PCI attribute data format for storing the pseudocolor table. For more information about attribute data, see Attributes in the GDB file format reference help.

The general format for a line of text is:
```
start : end ; red green blue ; comment
```
For example:
```
5 : 5 ; 255 0 255 ; magenta
```
Input/output format (INOUT): lists both an input value and three output values (red, green, and blue) for each table entry.

The general format for a line of text is:
```
input red green blue 
```
For example:
```
5 255 0 255
```
Output format (OUT): lists only the three output values (red, green, and blue) for each table entry.

The general format for a line of text is:
```
red green blue 
```
For example:
```
255 0 255
```

Note: It is not essential that all 256 entries in a pseudocolor table be specified in the text file. If a new segment is created, the output values for any missing entries default to 0. If an existing segment was specified, only the table entries that are read in are modified.

Environments	PYTHON :: EASI :: MODELER
Batch Mode	Yes
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Related

PCTREAD

Read PCT from text file

Description

Parameters

Parameter descriptions

Details