Just a follow up to GEGL-G’MIC discussion - do you maybe recall if there is any place one can read some more details about command effect? Like a written description in sentence or two?
Many thanks for any guide here 
activey
In GEGL all operations have at least a single sentence written in human language to give any impression on what does it do and what could be the effect of an operation.
isnt that description also in the gmic file?
I’m afraid not 
ah you have the filter names and hierarchy but no description. I see.
@David_Tschumperle that seems like something that could be directly in the gmic data files?
Hi,
if you are talking about the gui version of commands, i’m afraid most of them don’t have a description.
There is a list of commands here, with descriptions but mostly for internal commands.
From the command line you can type gmic h > file.txt to get the description of all the cli commands (warning: very long output, but that won’t include most, if not all, gui commands, unless the author provided one), or gmic h command to get info on a particular command. gmic parse_cli and gmic parse_gui will output the list of commands and gui filters.
You can also look in the std_lib or the community files.
Other than that, i’m not sure if there is a file containing only the filters descriptions. I wish i knew, too
PS: please correct me if i’m wrong on any of this.
1 Like
I confirm G’MIC-Qt filters have no descriptions. Until now, there was no real need for that.
CLI commands have one (even more than that), through the corresponding #@cli comments.
Technically speaking, adding a string description for G’MIC-Qt would be actually easy. We could just add a new comment line at the very start of the filter definition, like:
#@gui : Description = note("<b>Description:</b> Blablabla")
with the advantage this could be seen by all users of the plug-in filters, and could be also parsed for generating the GEGL filter.
I’ve gave a try using an AI assistant to generate those description automatically, and while some are rather exotic, most of the generated description are quite OK, so that could help setting this up for a first draft.
1 Like
I have a better idea. Why not a new gui parameter “description” with option for visibility, and multiple languages? Like each commas separate the language. Hmm, might be fun to dive in C++, I’ll give that a try.
1 Like
Technically, there is already an automatic way to deal with translation in multiple languages in the G’MIC-Qt, so adding another way of dealing with it is probably not a good idea (even if it’s not widely use BTW).
As for having a way to show a filter description in the GUI, well, note() is there for that kind of purposes.
I’ve started adding description strings for each filter:
More than 400+ to go, wish me luck 
Done! 
3 Likes
Whoa
I’m done with a first draft.
I was really surprised by the relevance of the descriptions generated by Gemini 3, which told me he used not only the name of the filter and the name of the corresponding command, but also the analysis of the source code of each filter as well as the content of the forums (pixls.us in particular).
For 95% of the filters, I didn’t have to change the suggested description string (it was even better than what I could have written myself, with my limited English skills). I did modify a few of them, though. In any case, for a first draft, I think it’s really not bad!
And it should be easy to parse for you, @activey !
Let me know if that helps!
(Note that I haven’t done this work for the gmic-community filters, I let the authors of these filters to add a description if they wish. Which means, some of the filters you’ll parse could have no description string).
1 Like
Splendid, thank you!
I will try to dig into it soon
1 Like
Will (and when) descriptions be available in gmic_gimp_qt?
They already are.
Just update your filters and you’ll get them (requires 3.6.2+).
1 Like
Well, you could do it on all the other ones. I’m the only active gmic-community contributor.
1 Like
I don’t know why but filters won’t update (Win10, G’MIC 3.6.4, GIMP 2.10.38 and 3.2RC1)
Is there any error message you get when you click on the Update button ?
No message.
I also checked with Windows Defender and Avast disabled.
I tried updating G’MIC 2.5.5 – without any success.
The update file for G’MIC-Qt 3.6.4 is here : https://gmic.eu/plain_update364.gmic
And it contains the recent additions that add the filter description.
Try downloading it, and replace your update364.gmic file with it.