mastersect - Determine subsection of pass that intersects master

SYNOPSIS

#include <terrno.h>
#include <etx.h>
#include <gp.h>
#include <subsect.h>

int mastersect(path, xfm, pnl, pns, sl, ss, nl, ns)
char *path;
ETXFORM xfm;
int pnl, pns;
int *sl, *ss;
int *nl, *ns;

DESCRIPTION

mastersect determines for the satellite pass specified by the earth transform structure xfm, the subsection of the pass that intersects the master specified by the filename path. pnl and pns specify the number of pass lines and samples. The start line and sample of the subsection are returned in sl and ss. These are in 1-relative coordinates. The number of lines and samples in the subsection are returned in nl and ns.

RETURN VALUES

Returns 0 if successful, otherwise -1 is returned, and terrno is set to the appropriate error code. If the return value is 0, and if nl = ns = 0, then the satellite pass and the master do not intersect.

FILES

include/etx.h, include/subsect.h, include/terrno.h, include/gp.h, lib/libapp.a

SEE ALSO

etready, etxll, etcoords, etnav, etx


Last Update: $Date: 1999/05/10 20:56:53 $