David Janszen wrote:
> A Sun tech writer suggested I use this listserver as the forum for my
> criticisms of some of the 2D API terminology, indicating that this is how
> to get the message to the appropriate engineers at Kodak and Sun, but
after
> reading a few days worth of postings, I am beginning to doubt this is the
> right place. Does anyone know how to register my thoughts with the right
> people?
This is probably as good a place as any, given that the people responsible
for the Java2D API certainly read this list (though possibly not as
attentively as usual during JavaOne week....) I think what you're up against
is the fact that the names you have problems with are embedded in the API
(i.e. as part of method names), and bad as some of them are, it's
phenomenally unlikely they're going to be changed at this point. I tend to
agree that 'sample' is pretty poor - I think it was an attempt to use
something other than 'component', which is used in the color model realm.
And 'band' should probably have been 'plane' or something. Certainly from
reading *just* the JavaDocs for the API, you could get incredibly confused,
but luckily there are other sources of info that clarify the terminology.
Then it's just a question of building your internal map from what you're
familiar with to Java2D.
There was a period, I think, when these terms could have been improved, but
unfortunately it was about twelve months ago. It's a shame that with a
relatively complex API like Java2D, most people only have the time to dive
in to the depth where these things become an issue after it's too late.
Still as problems go, it's not exactly in the same league as, say, world
hunger, is it?
Cheers,
Pete
