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

SDgetdimscale/sfgdscale

intn SDgetdimscale(int32 dim_id, VOIDP data)
dim_id

IN:

Dimension identifier returned from SDgetdimid

data

OUT:

Buffer for the scale values for the specified dimension

Purpose

Retrieves the scale values for the specified dimension.

Return value

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

Description

It is assumed that the user has already called SDdiminfo and has thus allocated sufficient space to hold the values. SDdiminfo is used to check if a scale has been set for the target dimension. If the data type parameter value returned by SDdiminfo is 0, no scale has been set and SDgetdimscale should not be called.

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, data)

integer dim_id

<valid numeric data type> data



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

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