Re: [SIP-devel] SIP to-do list

[Ricardo F. <rf...@if...>]

On Sun, 31 Aug 2003, DRUEL Jocelyn wrote:

> Hi,
> Back from holliday in Australia,

Don't need to tell it was fun!

> I see you've been active during summer.
> Great.

I've been quite busy lately with many exams for applying to graduate
study in Brazil and abroad. It's a pain in the ..., but it should be
worth the hassle.

> I see there are things to do for SIP developpers !

We need more developers like you :)

>
> I'm trying to write some documentation (an introductory user manual) for SIP
> as I believe that the best documentation is not the one written by the main
> developper (ie Ricardo) but the one written by users.
>
> I send you my work, which is very incomplete but a good step (I hope) to
> start with SIP.
> I'd like to explain some notions about image treatment in it.
>
>

It's a very nice start!!!!!!!! Great!

I've been writing a paper about SIP and Scilab for a linux journal,
but its too big. I must split it in two. I'll send it directly to you
because it has some nice image processing examples and other stuff
that may help with the manual.

In the future we should place documentation in CVS so everybody can
make improvements directly and easily.

In the meantime.. Let's do it the hard way.
I'm sending some suggestions to the manual's draft.

- home page address is:  http://siptoolbox.sourceforge.net
- demo is now exec(SIPDEMO)
- should say to put stacksize(3e8) in users ~/.scilab
- reading/viewing/writing images
	- should explain briefly the different image formats and
	that it is necessary to rescale an image to 65535 to write it.
	(this is really a cumbersome characteristic of SIP, but we
	have to rescale the image until integer formats be used)
	See the paper on SIP that I wrote. It has a brief explanation
	that should help you with the manual.

	You do explain about this in sec 2.7 but shouldn't it
	come before sec. 2.4?

- in sec. 2.8, the command normal(dmat,255,0) should be easily
rewritten to normal(dmat,255)
- in Chap 3, the final version of the manual should ideally show the
result of the operations on sample images.
- par 3.3 typo (addition or subStraction..); it should be subtraction


That's all,
I hope you get the time to continue with the manual.
However, an advantage of free software development is that any work
you do is never lost. If you can't finish it, others will (someday), because
they are free to do it.

thanks again!
best,
Ricardo.