[ggt-devel] another potential usability issue from naming

[Ben S. <bs...@vr...>]

Soon makeTrans will be overloaded to support 2 functions with different 
semantics. The first,

Matrix makeTrans<Matrix>(Vec)

will create a new matrix containing the translation transformation 
described by the given Vec. The second,

Vec makeTrans<Vec>(Matrix)

will create a new vector describing the translation transformation 
embedded in the given Matrix.

To me, functions with the same name but having different semantics goes 
against the grain for standard object oriented training and experience and 
will make usability much more difficult. Especially thinking of the 
upcoming transition of VRAC personnel to using VRJuggler 1.1 and GMTL, I 
believe issues like this will cause the greatest problems.

Kevin, I know you might feel like I'm rehashing our discussion earlier, 
but this particular situation is different than our discussions about the 
difference between getTrans and makeTrans.

I would love to hear your thoughts on my comments.

cheers,
-----
Ben Scott
Research Assistant VRAC
bs...@ia...