Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


  >  Docs Center  >  IDL Reference  >  I/O - Network  >  IDLnetJPIP Properties

IDLnetJPIP Properties

IDLnetJPIP Properties

IDLnetJPIP objects have the following properties.

Note: For a discussion of the property description tables shown below, see About Object Property Descriptions.

BIT_DEPTH

Read Only. Contains the bit depth for each image component. Call the Open method before accessing this property or IDL will throw an error.

Type

Integer vector

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

CACHE_DIRECTORY

This property sets a local cache directory and defaults to a null string. A cache directory is not used unless this property is set by the user during the OBJ_NEW call. This cache directory will hold wavelets for the portions of images that have been streamed in from the remote server. If the user goes back to the same portion of the image, the wavelet cache will be used instead requesting the same wavelets from the remote server. An application can obtain a path to a temporary directory by using the FILEPATH function. If CACHE_DIRECTORY is set, we recommend that all of the files the cache directory be deleted periodically (such as each time the application is started) to avoid filling up the disk with cache files. You can only set this property during the OBJ_NEW call.

Type

String

Default null string

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

COLOR_SPACE

Read Only. This property has the following values:

sLUM

A luminance (monochrome) space.

sRGB

The sRGB space is a reasonably good model for color imagery which has been corrected to look good on a monitor.

sYCC

A three-component color space derived by applying the standard YCbCr color transform to sRGB data.

iccLUM

 

iccRGB

 

unKnown

 

Call the Open method before accessing this property or IDL will throw an error.

Type

String

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

DIMENSIONS

Read Only. A two element array giving the dimensions [width, height] of the entire image.

Call the Open method before accessing this property or IDL will throw an error.

Type

Long

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

FILENAME

Read Only. A string containing the path and name of the file associated with the image being streamed from the remote server. The path is relative to the root directory used by the server. IDL sets this property when the ::Open method is called.

Call the Open method before accessing this property or IDL will throw an error.

Type

String

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

GML

Read Only. A string vector in which each string contains the contents of a single ASOC/GML box. A JPEG2000 file can contain 0 to n number of ASOC/GML boxes. If the JPEG2000 file does not have any ASOC/GML boxes, this property returns a null string.

Call the Open method before accessing this property or IDL will throw an error.

The XML box under ASOC box with a label of “gml.root-instance” is returned.

asoc
  |----lbl  = gml.data
  |----asoc
     |----lbl = gml.root-instance
     |----xml = “gml_data_string”    <----------- this gml string is returned

Type

String

Default See description above

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

IS_ALIVE

Read Only. Use IS_ALIVE to determine if a connection to a JPIP server has timed out. Prior to calling the Open method, this property will always return 0. After calling Open, this property will return 1 while the connection to the JPIP server is alive and will return 0 when the connection to the JPIP server has timed out.

If this property returns 0 then it necessary to call the Open method again to reestablish the connection to the server.

Type

Long

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

N_COMPONENTS

Read Only. The number of components (or bands or channels) in the image.

Call the Open method before accessing this property or IDL will throw an error.

Type

Long

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

N_LAYERS

Read Only. Indicates the number of quality layers used to build each image. When an image has more than one layer, the previous layers are used to build the image at the requested layer value. If the REVERSIBLE property is "true" then the last layer, in conjunction with the previous layers (if there are any), will produce a lossless image.

Call the Open method before accessing this property or IDL will throw an error.

Type

Long

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

N_LEVELS

Read Only. Represents the number of wavelet decomposition levels or stages.

Call the Open method before accessing this property or IDL will throw an error.

Type

Long

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

N_TILES

Read Only. Indicates the number of tiles in a component.

Call the Open method before accessing this property or IDL will throw an error.

Type

Long

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

PROGRESSION

A read-only string defining the progression order. When reading a file, this property indicates the progression order used when the file was created.

For example, "LRCP" means that the image was encoded in the following order, with quality being the outermost loop:

L - a series of one or more quality layers, each contributing a quality increment for the entire image at full resolution. The quality layers may be interpreted as sub-bitplanes containing the image data at a specified, possibly fractional, bit-rate.

R - each resolution level of a image, which corresponds to the N_LEVELS keyword used in encoding, and can be considered to contain the image data at a given size or resolution. Each level adds another level of detail to the previous levels.

C - each image component of the above.

P - each position (tile) within the image component.

In this example, if an image consists of 2 quality layers, 5 resolution levels, 3 components, and 16 positions or tiles, the image would be encoded in a series of packets as follows:

P0C0R0L0, P1C0R0L0, P2C0R0L0, ..., P15C0R0L0
P0C1R0L0, P1C1R0L0, P2C1R0L0, ..., P15C1R0L0
P0C2R0L0, P1C2R0L0, P2C2R0L0, ..., P15C2R0L0
P0C0R1L0, P1C0R1L0, P2C0R1L0, ..., P15C0R1L0
P0C1R1L0, P1C1R1L0, P2C1R1L0, ..., P15C1R1L0
P0C2R1L0, P1C2R1L0, P2C2R1L0, ..., P15C2R1L0
... ... ...
... ... ...
... ... ...
P0C2R4L0, P1C2R4L0, P2C2R4L0, ..., P15C2R4L0
 
P0C0R0L1, P1C0R0L1, P2C0R0L1, ..., P15C0R0L1
P0C1R0L1, P1C1R0L1, P2C1R0L1, ..., P15C1R0L1
P0C2R0L1, P1C2R0L1, P2C2R0L1, ..., P15C2R0L1

This encodes all components over the entire image at a given quality level, before sending the next quality refinement.

Call the Open method before accessing this property or IDL will throw an error.

Type

String

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

PROGRESSIVE_CALLBACK_DATA

This property contains data to pass to the caller when a progressive callback is made. The caller sets and defines the data contained in this variable. The variable is passed, unmodified, directly to the caller as a parameter in the callback function.

If this property is not set the GetData method will pass an IDL variable of the Int type set to zero.

Type

Any IDL variable

Default Integer set to 0

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

PROGRESSIVE_CALLBACK_FUNCTION

Set to the name of the PRO code function to be called when the ::GetData method is retrieving image data from the remote server. The callback can be used to provide progressive image updates to the user, and to provide a way to cancel an operation underway.

If this property is not set, the GetData method will not make a progressive callback to the PRO code caller.

Type

String

Default '' (null string)

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

PROGRESSIVE_UPDATES_COMPLETE

Read only. Use in a Progressive Callback Function to determine if all the progressive callbacks have completed. This property is only valid when the GetData method has been called in the asynchronous mode. When this property is 1 during a GetData call, then all of the progressive updates have been completed. When this property is 0 during a GetData call, then more progressive updates will be issued before the GetData call completes.

Type

String

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init: No

Registered: No

PROXY_NAME

Set to the hostname or IP address of the proxy server, if one is used.

Type

String

Default '' (null string)

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

PROXY_PORT

Set to the port number to be used on the proxy server (if used).

Type

Long

Default 8088

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

REVERSIBLE

Read Only. When reading a file and this property is 0, the images are irreversible (lossy). When reading a file and this property is 1, the images are reversible (lossless).

Call the Open method before accessing this property or IDL will throw an error.

Type

Boolean

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

SERVER_NAME

Set to the hostname or IP address of the JPIP server. You must set SERVER_NAME prior to calling the Open method or IDL throws an error.

Type

String

Default ''

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

SERVER_PORT

Set to the port number used by the remote JPIP server. This property defaults to 80.

Type

Long

Default 80

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

SERVER_SCHEME

Set to: http, http-tcp, or none, and defaults to http. This property is the protocol used by the remote JPIP server when communicating with a client.

Type

STRING

Default http

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

SIGNED

Read Only. An n-element boolean vector where n is the number of components. A value of 1 indicates pixels in that component are interpreted as signed numbers, otherwise the pixels are interpreted as unsigned numbers.

Call the Open method before accessing this property or IDL will throw an error.

Type

Boolean

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

STATUS_CALLBACK_DATA

Contains data that to pass to the caller when a status callback is made. The caller defines and sets the data contained in this variable. The variable is passed, unmodified, directly to the caller as a parameter in the callback function. If this property is not set, the GetData method will pass an IDL variable of the Int type set to zero.

Type

Any IDL variable

Default Integer set to 0

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

STATUS_CALLBACK_FUNCTION

The name of the PRO code function to call when the GetData method retrieves image data from the remote server. Use the callbacks to provide feedback to the user about the operation underway,and to cancel an operation underway. If this property is not set, the GetData method will not make a callback to the PRO code caller.

Type

String

Default '' (null string)

Name String

not displayed

Get: Yes

Set: Yes

Init: Yes

Registered: No

TILE_DIMENSIONS

Read Only. A 2-element vector defining the width and height of each tile.

Call the Open method before accessing this property or IDL will throw an error.

Type

Long Vector

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

TILE_RANGE

Read Only. A two-element integer vector giving the number of tiles in the X and Y directions.

Call the Open method before accessing this property or IDL will throw an error.

Type

Long Vector

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

UUIDS

Read Only. Provides a mechanism to retrieve the UUIDs (Universally Unique Identifiers) for the UUID boxes in the JPEG2000 file. Call the Open method before accessing this property or IDL will throw an error.

A JPEG2000 file can contain 0 to n number of UUID boxes. A UUID is a 16 byte value. Each UUID box is made up of a UUID field and a user data field. A UUID box allows the user to store application-specific data inside a JPEG2000 file using a universally unique identifier.

The property returns one of the following:

  • a scalar value of 0 when the file does not contain any UUID boxes.
  • a vector of byte arrays. Each array contains a 16 byte UUID. A UUID box that exists in the file but does not have any data (the data field is empty) is not included in the returned vector of UUIDs.

For example if the file contains 10 UUID boxes then this property returns a vector with 10 UUIDs. Each UUID is a 16 byte array.

Type

Byte Array Vector

Default See description above

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

XML

Read Only. A string vector in which each string contains the contents of a single XML box. A JPEG2000 file can contain 0 to n number of XML boxes. If the JPEG2000 file does not have any XML boxes, this property returns a null string.

Call the Open method before accessing this property or IDL will throw an error.

Type

An array of strings

Default See description above

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

YCC

Read Only. YCC refers to RGB to Luminance-Chrominance conversion. This property indicates whether the data was originally converted from the RGB color space to the YCC color space during compression. If YCC=1, GetData will automatically transform the YCC data back to RGB while decompressing it.

Call the Open method before accessing this property or IDL will throw an error.

Type

Boolean

Default N/A

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

Version History


8.3

Introduced



© 2018 Harris Geospatial Solutions, Inc. |  Privacy Policy
My Account    |    Store    |    Contact Us