command line doc for conformal map filter


(Günter Bachelier) #1

Hello,
I am searching documentation for the arguments for the conformal map filter. I have an example code line

$ gmic -sp lena,3000 -v - -tic -fx_conformal_maps 0,1,0,"((1.1 + i*z/6)/(1.04 - i*z/6))^6.2",0,0,0,0,0,2,0,0,1024,1024 -v + -toc

but no further info about the many arguments that are used within. Thanks!


(David Tschumperlé) #2

My the latest version of G’MIC (2.0.2), if I choose the conformal maps filter in the GIMP plug-in, I have this :

And if I set Output messages -> Verbose, then I get this command printed on the shell:

-fx_conformal_maps_preview 8,1,0,"((1.1 + i*z/6)/(1.04 - i*z/6))^6.2",0,0,0,0,0,3,0,0,"1024","1024"

You can see that each item in the argument list (separated by commas) corresponds exactly to one parameter in the plug-in (in the order they are displayed), so you can find the meaning of each argument like this.

Now, if you want to invoke this command from a shell like bash , you’ll need to also backslash the given quotes and parentheses, since those characters have already a meaning for bash, so you can write something like this:

$ gmic -sp lena -fx_conformal_maps_preview 8,1,0,\"\(\(1.1 + i*z/6\)/\(1.04 - i*z/6\)\)^6.2\",0,0,0,0,0,3,0,0,\"1024\",\"1024\"

(Günter Bachelier) #3

testing with Ubuntu 16.04 and Gimp 2.8 (German GUI) in VirtualBox
setting “Ausgabe der Meldungen” -> Ausführlich (Konsole) or (Log-Datei)
Where is the output in the Konsole case? I see nothing in the terminal.
Where would a log file be saved in Log-Datei case?


(Günter Bachelier) #4

here are my interpretation to the arguments of this output:

-fx_conformal_maps_preview 8,1,0,"((1.1 + iz/6)/(1.04 - iz/6))^6.2",0,0,0,0,0,3,0,0,“1024”,“1024”

nr formula: 8 (= dipole = 1/(4z^2-1)); from {0,…,9}; custom formula = 0
exponent (real): 1; from [-16, 16]
exponent (imaginary): 0; from [-16, 16]
custom formula: ((1.1 + i
z/6)/(1.04 - i*z/6))^6.2 (only used if nr formula = 0)
Zoom: 0; from [-4, 4]
Angle: 0; from [-180, 180]
Aspect ratio: 0; from [-1, 1]
x shift: 0; from [-5, 5]
y shift: 0; from [-5, 5]
Boundary: 3 (= Mirror); from {Transparent,Nearest,Periodic,Mirror}
Antialiasing: 0; from {0,1,2,3}
specify different output size: 0; from {0=false, 1=true}
output width: 1024; (only used if specify different output size = 1)
output height: 1024; (only used if specify different output size = 1)


(David Tschumperlé) #5

The log in the console is displayed when gimp has been run from that console only.
Open a bash console, try $ gimp then the plug-in messages should be displayed there (along with the GIMP messages).
In case of using a log-file, then it is probably located in $HOME/.config/gmic/gimp_log or something similar.


(Günter Bachelier) #6

Thanks. Its working now in the terminal. Also usefull for identifying arguments for other filters when I am writing batch scripts (Perl) to call a gmic filter over the command line.