[Back to Interface] [Prev] [Next]

SDgetdimscale/sfgdscale

intn SDgetdimscale(int32 dim_id, VOIDP scale_buf)

dim_id IN:

Dimension identifier returned by SDgetdimid

scale_buf OUT:

Buffer for the scale values

Purpose

Retrieves the scale values for a dimension.

Return value

Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.

Description

SDgetdimscale retrieves the scale values of the dimension identified by the parameter dim_id and stores the values in the buffer scale_buf.

SDdiminfo should be used to determine whether a scale has been set for the dimension, i.e., that the dimension scale data type is a valid HDF data type (not 0). Also use SDdiminfo to obtain the number of scale values for space allocation before calling SDgetdimscale.

It is not possible to read a subset of the scale values. SDgetdimscale returns all of the scale values stored with the given dimension.

FORTRAN

integer function sfgdscale(dim_id, scale_buf)

integer dim_id

<valid numeric data type> scale_buf(*)



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.