Loads all point objects from a Spatial+ object file into the radial search tree.
Syntax
intl pipRadLoadPoints ( pipRadial rad_h, pipObjectFile obj_h );
Arguments
rad_h The handle returned by pipRadInit for the current radial analysis. Input.
obj_h The handle of the object file containing the point features to load into the radial search tree. Input.
Return Value
PIP_OK PIP_ERROR
Prerequisites
pipObjectFileOpen and pipRadInit.
Alternates
None.
Notes
This function can be used to quickly add all points from a Spatial+ object file into a radial search tree. Its most common use is when you have a number of points that you will be performing radial analyses of over time.
This function is also useful when your points are stored in MapInfo or Atlas GIS, as an object file can easily be created from an Atlas GIS BNA, SHP, TAB, or MapInfo MIF/MID file. See pipImportInit for information on converting these files.
This function requires that you have initialized the obj_h parameter by calling
pipObjectFileOpen.
Example
// load points into a search tree
pipRadial rad_h; pipObjectFile obj_h;
char FileName[_MAX_PATH];
if ( pipObjectFileOpen( h, "C:\x\x.gsb", flg, &obj_h )!=PIP_OK ) Abort();
pipRadInit( &rad_h ); pipRadLoadPoints( rad_h, obj_h );