c_putddf - Places a value into a specific field of the DDR

SYNTAX

#include "las.h"

FUNCTION c_putddf (ddr, key, value)

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

PARAMETERS

ddr (input/output, 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, integer)

A constant used to designate the field of the DDR where value will be placed. The constants are shown below.

               DDNL    -- Number of lines
               DDNS    -- Number of samples
               DDNB    -- Number of bands
               DDDTYP  -- Data type 
               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 (input, character, length(*))

Value that will be placed in the field 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_putddf() call is used to place value in the field of ddr designated by key.

RETURN VALUE

c_putddf() returns

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