c_wvsquery - Query the World Vector Shoreline (WVS) data for a given coverage and area of interest

SYNTAX

FUNCTION c_wvsquery(path, wvs_coverage, wvs_vector, lllat, lllon, urlat, urlon)

    char		*path;
    struct WVS_COVERAGE	*wvs_coverage;
    struct WVS_VECTOR	*wvs_vector;
    double		lllat;
    double		lllon;
    double		urlat;
    double		urlon;

PARAMETERS

path (char *, input)

The host file name of the directory that contains the WVS files.

wvs_coverage (struct WVS_COVERAGE *, input)

Structure which defines the geographical limits of the data contained in each of the nine (9) WVS coverage areas.

wvs_vector (struct WVS_VECTOR *, output)

Structure which defines the resulting vector information.

lllat (double, input)

The minimum latitude bounding the area to be considered.

lllon (double, input)

The minimum longitude bounding the area to be considered.

urlat (double, input)

The maximum latitude bounding the area to be considered.

urlon (double, input)

The maximum longitude bounding the area to be considered.

DESCRIPTION

Check the area of coverage to make certain it falls within the area defined by the specified latitude and longitude range. Open the WVS data file and read the latitude, longitude limits of the first line. If these limits fall within the range defined by lllat, lllon, urlat, and urlon, read the points in this line; otherwise, skip to the next line within the file. Continue processing the WVS data file until all of the lines have been read. Close the WVS data file and return. c_wvsquery() returns a list of line segments based on an area of interest.

RETURN VALUE

c_wvsquery() returns

    E_SUCC --> Successful completion
    E_FAIL --> Operation failed