[Insight-users] WrapITK and Java Bindings

[Gaëtan Lehmann]

Le 24 nov. 09 à 18:04, Julien Michel a écrit :

> Gaëtan Lehmann a écrit :
>
>> Hi Julien,
>>> Just to let you know, I managed to update the itk_doxy2swig.py  
>>> script so as to get the doxygen information imported into javadoc  
>>> comments in the java proxy classes. I am only missing a few things :
>>> - gccxml (ot pygccxml) seems to strip newlines so the imported doc  
>>> is a little compact (hard to read)
>> gccxml, pygccxml and igenerator.py are fully reconstructing the  
>> classes definitions. They are not manipulating the documentation at  
>> all.
>> The problem is more likely in itk_doxy2swig.py or in swig.
>
> Well, itk_doxy2swig.py is parsing xml documentation file to build  
> python docstrings (and now javadoc). I was assuming that these xml  
> doc files were produced by gccxml or pygccxml (but I might be wrong).

they are produced by doxygen. If the line breaks are already removed  
at this stage, it will be hard to fix this problem.

>
>>> - Something more annoying : sometimes the proxy classes does not  
>>> inherit from its real superclass but rather from  
>>> myClass_Superclass, which has no documentation. Therefore, the  
>>> inheritance scheme in javadoc is broken.
>> We should have the doc for those class as well - it looks like a  
>> bug in the doc translation process.
>> I'll try to have a look.
>
> Well, it sounds more like a bug (or a feature ? ;)) from swig to me.
>
> For instance :
>
> itkAtanImageFilterIIF2_IIF2 is inheriting from  
> itkAtanImageFilterIIF2_IIF2_Superclass, which should rather be  
> itkUnaryFunctorImageFilterIIF2_IIF2_Tan or something like this.
>
> Maybe it is just a problem of mangling ...


The name itkAtanImageFilterIF2IF2_Superclass is a feature of wrapitk :-)
The wrapper for those classes - both itkAtanImageFilterIF2IF2 and  
itkAtanImageFilterIF2IF2_Superclass is simply

   WRAP_CLASS("itk::TanImageFilter" POINTER_WITH_SUPERCLASS)
     WRAP_IMAGE_FILTER_REAL(2)
   END_WRAP_CLASS()

It makes the creation of the wrapper quite easy for this kind of  
class, where the superclass is not supposed to be used directly.
It also makes quite difficult to find the name of the the super class  
only with the informations there.

That's probably why those classes don't have there doc, but I have to  
have a closer look.

Gaëtan




-- 
Gaëtan Lehmann
Biologie du Développement et de la Reproduction
INRA de Jouy-en-Josas (France)
tel: +33 1 34 65 29 66    fax: 01 34 65 29 09
http://voxel.jouy.inra.fr  http://www.itk.org
http://www.mandriva.org  http://www.bepo.fr

-------------- next part --------------
A non-text attachment was scrubbed...
Name: PGP.sig
Type: application/pgp-signature
Size: 203 bytes
Desc: Ceci est une signature ?lectronique PGP
URL: <http://www.itk.org/pipermail/insight-users/attachments/20091124/a4b3829f/attachment.pgp>