[Top] [Prev] [Next] [Bottom]

GRcreate/mgcreat

int32 GRcreate(int32 gr_id, const char *name, int32 ncomp, int32 data_type, int32 interlace_mode, int32 dim_sizes[2])
gr_id

IN:

General raster interface identifier returned by GRstart

name

IN:

Name of the image to be created

ncomp

IN:

Number of components in each element of the image

data_type

IN:

Type of the image data

interlace_mode

IN:

Interlace mode of the image data

dim_sizes

IN:

Size of each dimension of the image

Purpose

Creates a raster image via the general raster image interface.

Return value

Returns a general raster imge identifier if successful and FAIL (or -1) otherwise.

Example

This example illustrates the use of GRcreate:

     #include "hdf.h"

     int32 gr_id, ri_id, file_id, stat;
     char *name = "Image name";
     int32 ncomp = 2;
     int32 interlace_mode = MFGR_INTERLACE_PIXEL;
     int32 data_type = DFNT_UINT16;

     file_id = Hopen("myfile", DFACC_WRITE, 0);
     gr_id = GRstart(file_id);
     ri_id = GRcreate(gr_id, name, ncomp, data_type,
          interlace_mode, dim_sizes);
       ...
     stat = GRendaccess(ri_id);
     stat = GRend(gr_id);
     Hclose(file_id);
      
FORTRAN

integer function mgcreat(gr_id, name, ncomp, data_type, interlace_mode, dim_sizes)

integer gr_id, data_type, interlace_mode, dim_sizes(2)

character* (*) name



[Top] [Prev] [Next] [Bottom]

hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.