Re: Error in API documentation.

Bob Friesenhahn <[email protected]> Mon, 8 Aug 2011 10:31:06 -0500 (CDT)
Newsgroups gmane.comp.video.graphicsmagick.apis
Message-ID <[email protected]>
On Mon, 8 Aug 2011, [email protected] wrote:
> Related to APIs: how did it come that some of the APIs take doubles for
> their params, (say, motion blur, w/ radius, sigma, direction) and others
> take a string that's parsed internally (eg: modulate)? The "modulate"
> class functions also operate directly on the image (versus returning
> a new one) and don't use the Exception struct. Am curious about the
> history or reason for the differences.

The software has an extremely long history dating back to 1990 or so. 
The software originated from command-line utilities which primarily 
pass strings from the user.  I don't like the string arguments much 
either but "fixing" the API causes stability problems for the user.

Bob
-- 
Bob Friesenhahn
[email protected], http://www.simplesystems.org/users/bfriesen/
GraphicsMagick Maintainer,    http://www.GraphicsMagick.org/

------------------------------------------------------------------------------
BlackBerry&reg; DevCon Americas, Oct. 18-20, San Francisco, CA
The must-attend event for mobile developers. Connect with experts. 
Get tools for creating Super Apps. See the latest technologies.
Sessions, hands-on labs, demos & much more. Register early & save!
http://p.sf.net/sfu/rim-blackberry-1