<div dir="ltr">On Fri, Apr 19, 2013 at 8:34 AM, David Doria <span dir="ltr"><<a href="mailto:daviddoria@gmail.com" target="_blank">daviddoria@gmail.com</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote">
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class="im">> On a related topic, I wonder if some of the VTK class documentation would<br>
> benefit from diagrams to help explain the geometry concepts? If so, I'd be<br>
> happy to put something together for vtkCamera. What would be the preferred<br>
> format? .dia from which the Doxygen build system generates .png images?<br>
<br>
</div>That would be excellent! We started doing this with ITK class<br>
documentation a while back (e.g.<br>
<a href="http://www.itk.org/Doxygen/html/structitk_1_1NeighborhoodAlgorithm_1_1ImageBoundaryFacesCalculator.html" target="_blank">http://www.itk.org/Doxygen/html/structitk_1_1NeighborhoodAlgorithm_1_1ImageBoundaryFacesCalculator.html</a>)<br>
and I completely agree that diagrams are extremely beneficial.<br>
However, I believe it took some effort to setup the system that keeps<br>
the diagrams reversion controlled and inserts them into the Doxygen<br>
automatically. The good news is that it can be done and by looking at<br>
how it is done in ITK it should be straightforward to copy if anyone<br>
has the time to do it.<br></blockquote><div><br></div><div style>Looks like there are a couple other VTK classes that already have figures in their documentation. When I get a chance, I'll match those classes by using IPE to create ./Rendering/Core/vtkCameraFigure.ipe and export .eps and .png versions for the Doxygen documentation.</div>
<div style><br></div><div style>Taylor</div></div></div></div>