Gimp/plug-ins/script-fu/libscriptfu
lloyd konneker 078e283f4b ScriptFu: fix #12150, activate apps (extension-script-fu and gimp) properly on MacOS
The gimp app and extension-script-fu (long-running)
are separate processes and "apps."
An app can be "active": in front and receiving GUI events.

As reported, on MacOS, when an extension-script-fu plugin yields,
the gimp app did not become active.
Also, on the second invocation of a plugin served by extension-script-fu,
the dialog could be hidden or require an extra click
because extension-script-fu was not active.
(Independently interpreted plugins did become active,
because it was a new process and gimpui_init activates on MacOS.)

On MacOS:
1. after the first dialog shown by extension-script-fu,
ensure subsequent calls to plugin make extension-script-fu active.
2. After a plugin yields, plugin manager ensure the Gimp app is active.

Note that this is done whenever a TEMPORARY procedure returns.
Most are calls to extension-script-fu plugins.
But some are also callbacks from Resource choosers running in the gimp app.
When they return, the gimp app remains active, and user must first click in
the plugin dialog to continue working.
Especially when the user clicks OK in a Resource Chooser, closing the chooser,
it would be nice if the plugin dialog became active.
That requires more, FUTURE development.

Special to MacOS: on Linux, "transient for foreign window" ensures this,
but that doesn't work on MacOS.

The fix is somewhat brute force and as simple as possible.
There is a more cooperative API for app activation on MacOS.
An app yields, and apps request, not force, self or other app be activated.
The fix does not use the cooperative API.
To do so would require a platform abstraction layer, in GIMP or Gtk.

The fix also sprinkles the code with #ifdefs.
That could be hidden if there were a platform abstraction layer PAL
The layer would be the greatest common denominator across platforms.
PAL methods would always be called in GIMP code,
but not do anything when the effect was accomplished another way.
For example "gimp_platform_request_app_active"
would request the app was active,
but do nothing on Linux where that is ensured by "transient for."
2024-12-17 15:18:50 +00:00
..
ftx Remove autotools 2023-05-27 00:03:52 +02:00
tinyscheme plug-ins: warning cleanup. 2024-10-27 23:44:50 +01:00
meson.build ScriptFu: fix #10698 and other issues with script progress 2024-04-08 11:27:13 -04:00
README
scheme-marshal-return.c app, libgimp*, pdb, plug-ins: rename various public API name s/float/double/. 2024-11-02 15:00:03 +01:00
scheme-marshal-return.h ScriptFu: extract function marshall_pdb_return 2023-09-12 15:02:15 +00:00
scheme-marshal.c plug-ins: support the new NULL-terminated object arrays in script-fu. 2024-10-25 23:28:42 +02:00
scheme-marshal.h ScriptFu: fix #11010 unhandled return type GimpColorArray 2024-03-06 14:48:41 -05:00
scheme-wrapper.c ScriptFu: change warning to info for lenient wrong arg count to PDB 2024-12-15 14:04:16 +00:00
scheme-wrapper.h ScriptFu: fix #10307 plugin call display not effective 2024-04-25 12:51:00 +00:00
script-fu-arg.c ScriptFu: fix #10741 tooltip and PDB description have underscore 2024-11-20 12:48:10 +00:00
script-fu-arg.h libgimp, plug-ins: make generic gimp_procedure_add_argument() private. 2024-07-06 14:44:45 +02:00
script-fu-color.c ScriptFu: fix #10978 handling of color 2024-10-17 18:45:51 +00:00
script-fu-color.h plug-ins: script-fu is now GimpRGB-free. 2024-04-20 12:06:41 +02:00
script-fu-command.c extensions, libgimp, plug-ins: remove n_drawables arg from GimpImageProcedure's… 2024-10-28 22:08:45 +01:00
script-fu-command.h extensions, libgimp, plug-ins: remove n_drawables arg from GimpImageProcedure's… 2024-10-28 22:08:45 +01:00
script-fu-compat.c ScriptFu: add compatibility scripts for third party scripts 2024-10-25 13:56:36 +00:00
script-fu-compat.h
script-fu-dialog.c ScriptFu: fix #12150, activate apps (extension-script-fu and gimp) properly on MacOS 2024-12-17 15:18:50 +00:00
script-fu-dialog.h extensions, libgimp, plug-ins: remove n_drawables arg from GimpImageProcedure's… 2024-10-28 22:08:45 +01:00
script-fu-enums.h ScriptFu: fix 8463 obsolete SF-VALUE 2024-09-27 06:41:29 -04:00
script-fu-errors.c ScriptFu: cleanup some debug statements 2024-12-15 14:04:16 +00:00
script-fu-errors.h ScriptFu: enhance error messages for range errors in calls to PDB 2024-09-20 10:58:50 +00:00
script-fu-interface.c ScriptFu: fix #12157 old-style dialog slider default 0 instead of declared value 2024-10-18 15:33:44 -04:00
script-fu-interface.h ScriptFu: fix #10698 and other issues with script progress 2024-04-08 11:27:13 -04:00
script-fu-intl.h
script-fu-lib.c ScriptFu: move init scripts to separate directory /scripts/scriptfu-init 2024-10-25 13:56:36 +00:00
script-fu-lib.h ScriptFu: move init scripts to separate directory /scripts/scriptfu-init 2024-10-25 13:56:36 +00:00
script-fu-proc-factory.c Issue #8744: refactor overdependence on gimpui.h 2022-10-15 15:17:08 +00:00
script-fu-proc-factory.h ScriptFu: Add script-fu-interpreter akin to other interpreters 2022-06-30 13:39:45 +00:00
script-fu-progress.c ScriptFu: fix #10698 and other issues with script progress 2024-04-08 11:27:13 -04:00
script-fu-progress.h ScriptFu: fix #10698 and other issues with script progress 2024-04-08 11:27:13 -04:00
script-fu-regex.c
script-fu-regex.h
script-fu-register.c ScriptFu: rename script-fu-register-regular => -procedure 2024-09-27 14:35:50 +00:00
script-fu-register.h ScriptFu: add Scheme language function script-fu-register-regular 2024-09-27 14:35:50 +00:00
script-fu-resource.c ScriptFu: fix defaults for script args of type Resource 2024-09-17 12:06:37 +00:00
script-fu-resource.h ScriptFu: fix defaults for script args of type Resource 2024-09-17 12:06:37 +00:00
script-fu-run-func.c extensions, libgimp, plug-ins: remove n_drawables arg from GimpImageProcedure's… 2024-10-28 22:08:45 +01:00
script-fu-run-func.h extensions, libgimp, plug-ins: remove n_drawables arg from GimpImageProcedure's… 2024-10-28 22:08:45 +01:00
script-fu-script.c extensions, libgimp, plug-ins: remove n_drawables arg from GimpImageProcedure's… 2024-10-28 22:08:45 +01:00
script-fu-script.h extensions, libgimp, plug-ins: remove n_drawables arg from GimpImageProcedure's… 2024-10-28 22:08:45 +01:00
script-fu-scripts.c ScriptFu: move init scripts to separate directory /scripts/scriptfu-init 2024-10-25 13:56:36 +00:00
script-fu-scripts.h ScriptFu: add Scheme language function script-fu-register-regular 2024-09-27 14:35:50 +00:00
script-fu-types.h ScriptFu: add Scheme language function script-fu-register-regular 2024-09-27 14:35:50 +00:00
script-fu-utils.c
script-fu-utils.h
script-fu-version.c plug-ins: fix include. 2024-04-11 10:47:20 +02:00
script-fu-version.h Fix #10044 more natural binding of PDB return values 2024-03-09 07:21:50 -05:00
script-fu-widgets-custom.c ScriptFu: fix #12188 new-style dialog lacks slider widget 2024-10-18 14:35:17 -04:00
script-fu-widgets-custom.h 2.99 ScriptFu: add custom widgets to GimpProcedureDialog 2024-02-03 15:27:16 +00:00
script-fu.def ScriptFu: fix #10307 plugin call display not effective 2024-04-25 12:51:00 +00:00

About libscriptfu

libscriptfu is part of GIMP.
It is not generally useful except by GIMP.

The libscriptfu library is used by plugin executables,
and the PDB procedures they create,
all part of the "ScriptFu" machinery.

The libscriptfu library is not intended for third-party developers,
only for core GIMP developers.
Headers for libscriptfu might not be installed.

This directory contains three libraries: libscriptfu, tinyscheme, and ftx.
The tinyscheme library contains a TinyScheme interpreter.
The ftx library extends the TinyScheme interpreter,
adding file functions to the Scheme language.
The libscriptfu library contains both the tinyscheme and ftx libraries.
The libscriptfu library wraps the TinyScheme interpreter,
specializing it for GIMP.
The script-fu executable uses the libscriptfu library,
to interpret Scheme scripts that GIMP users refer to as "plug-ins."

These libraries depend on other libraries, e.g. math, libgimp, glib, etc.

Coupling between the executables and the libraries should be in one direction:
source for the inner libs should not include headers from the outer executables.
This lets you more easily update the inner libraries
(which originated elsewhere and might be maintained elsewhere),
and change the outer executables
(which are subject to change by GIMP developers.)

Example (which may change):
The script-fu executable is a plugin file that implements PDB procedures:
extension-script-fu, script-fu-console, script-fu-text-console, script-fu-eval,
and script-fu-server.
Each of those PDB procedures runs as a separate process.
Each of those processes uses libscriptfu.
The main PDB procedure is extension-script-fu, which is a long-lived process.
It is a PDB procedure of PDBProcedureType EXTENSION.
It interprets the Scheme scripts that user's call "plug-ins."

Rarely two of the PDB procedure processes run concurrently.
When they do, and libscriptfu is built as a shared library,
the read-only, code portion of the library is only loaded in memory once.