Skip to main content

JAI documentation...

2 replies [Last post]
nyholku
Offline
Joined: 2005-03-15
Points: 0

Just posted a question about JAI popularity and this posting is sort of related. The JAI documentation that I've managed to find leaves a lot to be desired. I do not know if the subject is inherently too complex or what but it sure is not easy to get anything done.

I've got and read pretty thoroughly 'Building Imaging Applications with Java by Rodriques' and I'm not impressed with the book. Leaves a lot of questions unanswered, the index is full of omissions and besides it is not up to date.

I for one would wellcome discussion on this subject and would appreciate pointers to realy good stuff.

I've been through and through "Programming in Javaâ„¢
Advanced Imaging by JavaSoft" which is full of obvious bugs and omissions, the writing does not explain much and again it is about 1.0.1 not of what we have today.

I've read the jai-interest archives and there you can find some information.

From the web it is not easy to find good and usefull JAI information.

Programming in JAI has not been the kind of joyfull experience I've come used to in Java. Rather, every line I write needs half anhour research and debugging to get it to work. I managed to do what I want but it has not been easy.

Now mind you, I'm not exactly newbie to computers and computer graphics so most of the concepts and practices are old stuff. So it makes me wonder how intimidating the JAI package is to newcomers.

So I guess I'm whining that we all could do with some deacent, good quality, documentation and tutorial stuff on JAI. The kind I'm used to in other Java related stuff. Easier said than done.

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
rarenz
Offline
Joined: 2005-04-25
Points: 0

I regret to concur, and moreso. I am a Java imaging newbie, so right off the bat the learning curve is greater/ more torturous.
From my current standpoint, one of the greatest omissions in the JAI literature/ tutorials/ etc. is a good example showing how to incorporate (and deal with) an arbitrary image format into the JAI / Java Image I/O framework. e.g. huge "blob" files consisting of complex numbers (as in square root of -1 complex) with separate metadata file input. Oh, the FAQs will say "Complex numbers are represented using two bands, one for the real and one imaginary portion of each sample ...", but I've yet to find an example of actual use.
Another great omission IMHO: it has been just plain tough to find the JAI sections, tutorial downloads, and info. from within the Sun site. It has "felt" tucked away in some rather obscure corners of linkage, and even many of those have "felt" dated ... e.g. the JAI programming guide being dated Release 1.0.1, November 1999

bpb
Offline
Joined: 2004-06-23
Points: 0

> I regret to concur, and moreso. I am a Java imaging
> newbie, so right off the bat the learning curve is
> greater/ more torturous.
> From my current standpoint, one of the greatest
> omissions in the JAI literature/ tutorials/ etc. is a
> good example showing how to incorporate (and deal
> with) an arbitrary image format into the JAI / Java
> Image I/O framework. e.g. huge "blob" files
> consisting of complex numbers (as in square root of
> -1 complex) with separate metadata file input. Oh,
> the FAQs will say "Complex numbers are represented
> using two bands, one for the real and one imaginary
> portion of each sample ...", but I've yet to find an
> example of actual use.

So this documentation is insufficent?

http://java.sun.com/j2se/1.5.0/docs/guide/imageio/spec/extending.fm1.html

Examples of actual use may also be seen in the jai-imageio-core project on java.net.

> Another great omission IMHO: it has been just plain
> tough to find the JAI sections, tutorial downloads,
> and info. from within the Sun site. It has "felt"
> tucked away in some rather obscure corners of
> linkage, and even many of those have "felt" dated ...
> e.g. the JAI programming guide being dated Release
> 1.0.1, November 1999

We are aware that the documentation could be better and would like to do something about it. The combination of issues to be resolved and resources available simply have not allowed us to improve matters, unfortunately.