Krita Scripting and Plugin Wrapper Library: libkis

There's a mention about importing krita, and it importing two built-ins, Application and Scripter, of which both lack any further explanation. The following sentence is even more obscure: "This is an alias for Krita.instance(), which is the first place from which to access the running Krita instance." This? What is this? Furthermore, what is Scripter? I understand that Application is Krita.instance(), but only from the context. Scripter remains a mystery to me, because it doesn't show up anywhere even with the search. Many of the tutorials advice me to do this: app = Krita.instance(), but when I look at the plugins/python/... stuff many of the plugins there just use Application, which in return is confusing because without reading the confusing libkis page I would have no idea that Application is being imported somewhere.

I'll repeat this: There is no documentation about Scripter.

Don't get me wrong, the link above is very informative overall, but some minor overhaul would do wonders.

What does this mean: "Note: internally, Krita distinguishes between images and documents." ? What other documents are we talking about than images?

Edit: Oh, I notice that the explanation is provided in the next paragraph instead of in context. Unstructured text like this is confusing.

If you think you can do better, provide better text?

boudewijn wrote:If you think you can do better, provide better text?

To be able to decently do that I would have to know what is "Scripter".

Maybe read the introduction to python scripting? https://docs.krita.org/en/user_manual/p ... pting.html

TheraHedwig wrote:Maybe read the introduction to python scripting? https://docs.krita.org/en/user_manual/p ... pting.html

So you're saying when I do:

Code: Select all

import krita

I get access to Application as in Krita.instance() and Scripter as in the Scripter Krita Plugin? That makes no sense. Isn't Scripter something that I access pykrita with instead of accessing Scripter from pykrita? I've read the introduction.

What is the difference between Scripter and Application?

Code: Select all

print(dir(Scripter))
print(dir(Application))


both return pretty identical list.

Then that's the 'Scripter()' synonym, which much like Application() means the same thing as Krita.instance()