Sent: 2012-01-23 15:51:05 UTC (4 months ago)

From: Stephen Kiel

Help Documentation - Gimp Scripting

permalink

Hello,

I really appreciate the help documentation and the Gimp application in
general. I thought it would be good for me to try to give something back.
I focused on something that I struggled with, scripting with script-fu. I
found that a lot of the help didn't quite get me to where I wanted to go.
I thought about how I would improve the documentation to tell the story a
better, and I felt that for me it was easier to just start with a clean
sheet and lay it out.

I would like to offer my take on a Gimp Scripting tutorial for use as part
of the Gimp documentation. You may use all of, part of, or none of it as
you see fit. It is my hope that this can benefit others, but I have no
other forum or place to post this tutorial. You or we can make what ever
modifications to the code examples or text to make the explanation clearer
or add any copyright required for release with Gimp.

The tutorial is under my spideroak share at:
https://spideroak.com/browse/share/Stephen_Kiel_Pictures/tutorial
The "RoomKey" is tutorial

The files in this share are:

.:
GimpScriptingTutorial.docx
GimpScriptingTutorial.pdf
Images
scripts
Thumbs.db

./Images:
example2-widget-input.JPG
example2-widget-results.JPG
examples-image-type.JPG
Flow.JPG
flowzilla-menu.JPG
flowzilla-readyforStep2.JPG
flowzilla-step1.JPG
flowzilla-step2.JPG
flowzill-UI.JPG
get-named-layer.JPG
gimp-console-window-1.JPG
gimp-console-window-2.JPG
gimp-preference-scripts.JPG
gimp-preference-scripts-linux.JPG
gimp-procedure-browser.JPG
jpg-to-xcf.JPG
list-index.JPG
parasites-console.JPG
script-fu-jpg-to-xcf.JPG
start-flowzilla.JPG
strbreakup-file-glob.JPG
Thumbs.db
worfkflow-complete.JPG
workflow-first-three-steps.JPG
workflow.JPG
workflow-perspective-adjust.JPG

./scripts:
configscripts
README.txt
roys-lum-separate.scm
roys-max-local-contrast.scm
script-fu-chroma-mask.scm
script-fu-combo-baselayers.scm
script-fu-combo-contrast-separate.scm
script-fu-combo-prep.scm
script-fu-delete-dummylayer.scm
script-fu-display-asigned-parasites.scm
script-fu-examples.scm
script-fu-flowzilla.scm
script-fu-get-named-drawable.scm
script-fu-grid.scm
script-fu-grow-canvas.scm
script-fu-jpg-to-xcf.scm
script-fu-list-index-from-name.scm
script-fu-make-two-layers.scm
script-fu-mark-autoupdate.scm
script-fu-mark-noautoupdate.scm
script-fu-para-note.scm
script-fu-para-tat-layer.scm
script-fu-scale-image.scm
script-fu-tat-origlayer.scm
script-fu-update-image.scm
script-fu-wrap-local-contrast.scm
script-fu-wrap-lum-separate.scm
script-fu-xcf-to-jpg.scm

./scripts/configscripts:
sf-config-layerdef.scm
sf-config-paranote.scm

If you choose not to use any of the tutorial that I wrote, let me know at
your convenience so I can take down the share.

Thanks for putting together a great application.

Stephen Kiel

Stephen Kiel
26602 Strafford
Mission Viejo, CA 92692
Home (949) 367-2915 Mobile (949) 702-1993
Google Voice SMS (949) 354-2828
snick.kiel@gmail.com
http://stephenkiel.blogspot.com/
Skype: stephen.kiel

Sent: 2012-01-24 11:08:08 UTC (4 months ago)

From: Kolbjørn Stuestøl

Help Documentation - Gimp Scripting

permalink

I am impressed. Although I only have read the tutorials without trying
to write the scripts. The tutorials are well written. The examples will
be of good use to many GIMP users I think.

I think this tutorial should be accessible in some way to the users
taking interests in using scrips. Perhaps this tutorial is too long to
be incorporated as a part of the documentation. May be a cropped version
with links to full version would be a solution?
I assume that the script functions will be available and unchanged in
the v 2.8.
Somebody take the challenge and writes the tutorials in "GIMP
documentation style"?
Kolbjoern

Den 23.01.2012 16:51, skreiv Stephen Kiel:
> Hello,
>
> I really appreciate the help documentation and the Gimp application in
> general. I thought it would be good for me to try to give something
> back. I focused on something that I struggled with, scripting with
> script-fu. I found that a lot of the help didn't quite get me to where
> I wanted to go. I thought about how I would improve the documentation
> to tell the story a better, and I felt that for me it was easier to
> just start with a clean sheet and lay it out.
>
> I would like to offer my take on a Gimp Scripting tutorial for use as
> part of the Gimp documentation. You may use all of, part of, or none
> of it as you see fit. It is my hope that this can benefit others, but
> I have no other forum or place to post this tutorial. You or we can
> make what ever modifications to the code examples or text to make the
> explanation clearer or add any copyright required for release with Gimp.
>
> The tutorial is under my spideroak share at:
> https://spideroak.com/browse/share/Stephen_Kiel_Pictures/tutorial
> The "RoomKey" is tutorial
>
> The files in this share are:

Sent: 2012-01-24 13:41:01 UTC (4 months ago)

From: Vitaly Lomov

Help Documentation - Gimp Scripting

permalink

I liked the PDF version, nice structure. Assuming the functions are the
same, etc., why can't be incorporate it? I don't understand the length
argument. It always comes down to " we are just a manual and a reference,
not a book". But then, the script-fu chapter should be two lines: a link to
Scheme language reference and "read function comments to learn what they
do". I like that the tutorial addresses the object model of GIMP -
image/drawable, etc. That's what we need. As to who will incorporate, I
don't know.

2012/1/24 Kolbjørn Stuestøl

>
> I am impressed. Although I only have read the tutorials without trying to
> write the scripts. The tutorials are well written. The examples will be of
> good use to many GIMP users I think.
>
> I think this tutorial should be accessible in some way to the users taking
> interests in using scrips. Perhaps this tutorial is too long to be
> incorporated as a part of the documentation. May be a cropped version with
> links to full version would be a solution?
> I assume that the script functions will be available and unchanged in the
> v 2.8.
> Somebody take the challenge and writes the tutorials in "GIMP
> documentation style"?
> Kolbjoern
>
>
> Den 23.01.2012 16:51, skreiv Stephen Kiel:
>
> Hello,
>>
>> I really appreciate the help documentation and the Gimp application in
>> general. I thought it would be good for me to try to give something back. I
>> focused on something that I struggled with, scripting with script-fu. I
>> found that a lot of the help didn't quite get me to where I wanted to go. I
>> thought about how I would improve the documentation to tell the story a
>> better, and I felt that for me it was easier to just start with a clean
>> sheet and lay it out.
>>
>> I would like to offer my take on a Gimp Scripting tutorial for use as
>> part of the Gimp documentation. You may use all of, part of, or none of it
>> as you see fit. It is my hope that this can benefit others, but I have no
>> other forum or place to post this tutorial. You or we can make what ever
>> modifications to the code examples or text to make the explanation clearer
>> or add any copyright required for release with Gimp.
>>
>> The tutorial is under my spideroak share at:
>> https://spideroak.com/browse/**share/Stephen_Kiel_Pictures/**tutorial
>> The "RoomKey" is tutorial
>>
>> The files in this share are:
>>
> …
> ______________________________**_________________
> gimp-docs-list mailing list
> gimp-docs-list@gnome.org
> http://mail.gnome.org/mailman/**listinfo/gimp-docs-list
>

Sent: 2012-01-24 20:49:01 UTC (4 months ago)

From: Julien Hardelin

Help Documentation - Gimp Scripting

permalink

> I liked the PDF version, nice structure. Assuming the functions are
> the same, etc., why can't be incorporate it? I don't understand the
> length argument. It always comes down to " we are just a manual and a
> reference, not a book". But then, the script-fu chapter should be two
> lines: a link to Scheme language reference and "read function comments
> to learn what they do". I like that the tutorial addresses the object
> model of GIMP - image/drawable, etc. That's what we need. As to who
> will incorporate, I don't know.
That's the main problem: who will translate this text to xml? At
gimp.org, there are two tutorials about scripts. They were created in
2003. This tutorial could be added there. And we add a link to it in the
doc.

Julien

Sent: 2012-01-25 13:41:20 UTC (4 months ago)

From: Alexandre Prokoudine

Help Documentation - Gimp Scripting

permalink

On Wed, Jan 25, 2012 at 12:49 AM, Julien Hardelin wrote:

> That's the main problem: who will translate this text to xml?

Is that really a problem? I can do it.

Alexandre Prokoudine
http://libregraphicsworld.org

Sent: 2012-01-25 18:02:04 UTC (4 months ago)

From: Julien Hardelin

Help Documentation - Gimp Scripting

permalink

>> That's the main problem: who will translate this text to xml?
> Is that really a problem? I can do it.

Good!

Will this tutorial be included at the place of the present script-fu
tutorial? It is big and I see it as an annex.

Julien Hardelin