ICurve.QueryTangent having problems with DistanceAlongCurve = 0.0

Question

We have encountered a strange behaviour using ICurve.QueryTangent (on straight lines, not tested with other types). If you supply a value of exactly 0.0 (zero) for the DistanceAlongCurve argument, the resulting tangent is/has an empty geometry. Changing the value to something very close to 0.0 (zero), for example 5.0e-324, QueryTangent works as expected. The wrong behaviour doesn't seem to be dependant on the other values supplied to QueryTangent (extension method, length of the resulting tangent etc.)

This is our workaround which corrects the problem for us, however it's kind of an unpleasent hack. Can someone else confirm this behaviour? Could you coders at Esri look at this too, to see if the QueryTangent method can not handle zero values correctly (and if so, update the documentation accordingly or correct the problem)?

Thank you!

NeilClemmons_GISinc · Answer

Have you tried a simplified test?  I've tested it in several scenarios with a value of 0 and have not run into any problems.

AndryJoos · Answer

Neil, thanks for the reply! It's great to discuss.

What you describe is of course the intended behaviour of the function. Let me explain: QueryPointAndDistance is used to find the distance of pPoint on pCurve. We want to find get the tangent of pCurve at that point. There are cases where pPoint exactly matches the from point, resulting in rDistOnLine being exactly zero (0.0). In that case, QueryTangent fails, unless I change rDistOnLine from exactly zero to 5.0e-324 (which is almost, but not quite exactly zero). Resulting in the very same tangent as I would expect it from calling QueryTangent with 0.0 (exactly zero). However, when calling QueryTangent with DistOnCurve = 0.0, the resulting geometry is empty, which it is not when calling with DistOnCurve = 5.0e-324.

Ok, I'm having a hard time to explain what the method does. Hope I have been able to clarify things a bit? Actually, it doesn't matter which method changes or sets rDistOnLine. Whenever it is exactly zero, QueryTangent generates an emtpy geometry.

NeilClemmons_GISinc · Answer

You are calling QueryPointAndDistance prior to calling QueryTangent.  rDistOnLine is being passed into that call.  QueryPointAndDistance updates that parameter (it's passed by reference) to the distance along the line of the point you pass in.  If the point you pass into QueryPointAndDistance does not match the FromPoint of the curve (x, y coords must match exactly - all the way out to however many decimal places it has) then rDistOnLine will no longer have a value of 0 when the call returns.