SETORIGIN - Sets a new pixel origin for an NDF

Description:

This application sets a new pixel origin  value for an NDF   data structure. The NDF is accessed in update mode and the indices of the first pixel (the NDF's lower pixel-index bounds) are set to specified integer values, which may be positive or negative. No other properties of the NDF are altered. If required, a template NDF may be supplied and the new origin values will be derived from it.

Usage:

setorigin ndf origin

Parameters:

LIKE = NDF (Read)

This parameter may be used to supply an NDF which is to be used as a template. If such a template is supplied, then its origin (its lower pixel-index bounds) will be used as the new origin value for the NDF supplied via the NDF parameter. By default, no template will be used and the new origin will be specified via the ORIGIN parameter. [!]

NDF = NDF (Read and Write)

The NDF data structure whose pixel origin is to be modified.

ORIGIN() = _INTEGER (Read)

A one-dimensional array specifying the new pixel origin values, one for each NDF dimension.

Examples:

setorigin image_2d [1,1]

Sets the indices of the first pixel in the two-dimensional image image_2d to be (1, 1). The image pixel values are unaltered.

setorigin ndf=starfield

A new pixel origin is set for the NDF structure called starfield. SETORIGIN will prompt for the new origin values, supplying the existing values as defaults.

setorigin ndf=cube origin=[-128,-128]

Sets the pixel origin values for the first two dimensions of the three-dimensional NDF called cube to be ($-$128, $-$128). A value for the third dimension is not specified, so the origin of this dimension will remain unchanged.

setorigin betapic like=alphapic

Sets the pixel origin of the NDF called betapic to be equal to that of the NDF called alphapic.

Notes:

If the number of new pixel origin values is fewer than the number of NDF dimensions, then the pixel origin of the extra dimensions will remain unchanged. If the number of values exceeds the number of NDF dimensions, then the excess values will be ignored.

Timing

Setting a new pixel origin is a quick operation whose timing does not depend on the size of the NDF.

Related Applications

KAPPA: SETBOUND.