[mapserver-dev] possible incomplet mapscript documentation ?

Alan Boudreault aboudreault at mapgears.com
Mon Apr 26 09:36:31 EDT 2010


Absolutely! We'll be glad to add a note about that in the documentation.

Alan

On April 26, 2010 09:29:39 am Oliver Christen wrote:
> Thank you Alan,
> 
> that confirms what I presumed
> 
> is it ok if I open a documentation bug for this ?
> 
> regards
> Oliver
> 
> > Hi Olivier,
> >
> > IIRC, MS_DONE simply means that the layer do not apply to the current
> > query
> > executed. ie. A queryByRect when the rect does not overlap the bounds of
> > the
> > layer. Also, if the layer is set to ignore missing data, it may returns
> > MS_DONE.
> >
> > Alan
> >
> > On April 26, 2010 04:10:50 am Oliver Christen wrote:
> >> Hello
> >>
> >> With php mapscript and swig mapscript, I noticed the whichShapes
> >> function returns sometime a code "2", which is not documented.
> >>
> >> I looked at Mapserver and Mapscript source code (I dont know C so I just
> >> followed the logical calls)
> >>
> >> whichShapes calls for msLayerWhichShapes or return MS_FAILURE
> >> *msLayerWhichShapes calls for msInitializeVirtualTable and
> >> LayerWhichShapes
> >> **msInitializeVirtualTable calls for destroyVirtualTable,
> >> createVirtualTable, and (in my case)
> >> msShapeFileLayerInitializeVirtualTable
> >> or returns MS_FAILURE
> >> ***destroyVirtualTable returns MS_SUCCESS
> >> ***createVirtualTable calls for populateVirtualTable or returns
> >> MS_FAILURE
> >> ****populateVirtualTable return only MS_SUCCESS
> >> ***msShapeFileLayerInitializeVirtualTable return only MS_SUCCESS
> >> **LayerWhichShapes is msShapeFileLayerWhichShapes in my case
> >> ***msShapeFileLayerWhichShapes calls for msShapefileWhichShapes or
> >> returns
> >> MS_FAILURE
> >> ****msShapefileWhichShapes returns MS_DONE, MS_FAILURE or MS_SUCCESS
> >>
> >> if I do :
> >> print mapscript.MS_DONE
> >> (with python swig mapscript)
> >> I get 2 so here is my culprit
> >>
> >> so,
> >> 1) it seems the documentation in incomplet, mapscript whichshapes can
> >>  return MS_SUCCESS, MS_FAILURE or MS_DONE (and not only MS_SUCCESS or
> >>  MS_FAILURE )
> >>
> >> 2) what means exactly MS_DONE ?
> >>
> >> the code is in mapshape.c in function msShapefileWhichShapes :
> >>
> >>   /* rect and shapefile DON'T overlap... */
> >>   if(msRectOverlap(&shpfile->bounds, &rect) != MS_TRUE)
> >>     return(MS_DONE);
> >>
> >> does that means the requested rect is completly outside of the shapefile
> >> bbox ?
> >>
> >> anyone can confirm that ?
> >>
> >> thanks in advance
> >> Oliver
> >>
> >> _______________________________________________
> >> mapserver-dev mailing list
> >> mapserver-dev at lists.osgeo.org
> >> http://lists.osgeo.org/mailman/listinfo/mapserver-dev
> 

-- 
Alan Boudreault
Mapgears
http://www.mapgears.com


More information about the mapserver-dev mailing list