c_getddf - Retrieves a specific field from the DDR

SYNTAX

#include "las.h"

FUNCTION c_getddf (ddr, key, value)

     struct DDR         *ddr;
     long               *key;
     unsigned char      *value;

PARAMETERS

ddr (input, DDR)

A DDR structure or a FORTRAN integer array dimensioned to DDRLEN. It contains the fields of the band record of the DDR.

key (input, long)

A constant used to designate the field of the DDR that will be returned in the argument value. The constants are shown below.

            DDNL    -- Number of lines
            DDNS    -- Number of samples
            DDNB    -- Number of bands
            DDDTYP  -- Data 
            DDML    -- Master line
            DDMS    -- Master sample 
            DDVFLG  -- Validity flag array 
            DDPCOD  -- Projection code
            DDZCOD  -- Zone code 
            DDDCOD  -- Datum code 
            DDSYS   -- System 
            DDUNIT  -- Projection Unit 
            DDLDAT  -- Last use dated  
            DDLTIM  -- Last used time
            DDPCF   -- Projection coefficients 
            DDUL    -- Upper left 
            DDLL    -- Lower left 
            DDUR    -- Upper right 
            DDLR    -- Lower right 
            DDPDY   -- Projection distance-y 
            DDPDX   -- Projection distance-x 
            DDLINC  -- Line increment 
            DDSINC  -- Sample increment

value (output, character, length(*))

Value of ddr that corresponds to key. It should consist of the same data type and length as the field of ddr that is needed.

DESCRIPTION

The c_getddf() call is used to return the key field of the band-independent record ddr.

RETURN VALUE

c_getddf() returns

     E_SUCC (0)  --> successful completion
     E_FAIL (-1) --> operation failed