81b569cb8c
Plug-in localization was always partially plug-in side, especially for things like custom GUI. But labels or blurb in GIMP (such as in menus or action search) were localizing GIMP side. It had many drawbacks: - To get menu localization, a plug-in had to set up gettext, even though they might want to use something else for their GUI (after all, giving facilities for gettext is a good idea, but there is no reason to force using this system). - There was a complex internal system passing the localization domain name, as well as the catalog file system path to core, then through various classes which we can now get rid of. - There could be domain name clashes, if 2 plug-ins were to use the same i18n domain name. This was handled in now removed functions gimp_plug_in_manager_get_locale_domains() by simply keeping a unique one (and gimp_plug_in_manager_bind_text_domains() would just bind the domain to the kept directory). In other words, one of the duplicate plug-ins would use the wrong catalog. We could try to make the whole thing more complicated or try to forbid plug-ins to use any random name (in particular made easier with the new extension wrapper). But anyway this whole issue doesn't happen anymore if localization is fully made plug-in side, so why bother? I tried to evaluate the advantages of the core-side localization of plug-in labels/blurbs and could only find one theoretical: if we wanted to keep access to the original English text. This could be useful (theoretically) if we wanted to search (e.g. in the action search) in both localized and English text; or if we wanted to be able to swap easily en/l10n text in a UI without reload. But even if we were to ever do this, it would only be possible for plug-ins (GEGL operations in particular are localized GEGL-side), so it lacks consistency. And it's unsure why special-casing English should really make sense for other language natives who want text in their lang, and search in their lang. They don't necessarily care about original. So in the end, I decided to simplify the whole thing, make localization of plug-ins a plug-in side thing. Core will only receive translated text and that's it. It cuts a lot of code out of the core, simplify runtime processing and make plug-in creation simpler to understand. The only think I still want to look at is how exactly menu paths are translated right now. Note that it still works, but it's possible that some things may be worth improving/simplifying on this side too.
122 lines
4.8 KiB
C
122 lines
4.8 KiB
C
/* GIMP - The GNU Image Manipulation Program
|
|
* Copyright (C) 1995-1997 Spencer Kimball and Peter Mattis
|
|
*
|
|
* gimppluginmanager.h
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __GIMP_PLUG_IN_MANAGER_H__
|
|
#define __GIMP_PLUG_IN_MANAGER_H__
|
|
|
|
|
|
#include "core/gimpobject.h"
|
|
|
|
|
|
#define GIMP_TYPE_PLUG_IN_MANAGER (gimp_plug_in_manager_get_type ())
|
|
#define GIMP_PLUG_IN_MANAGER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GIMP_TYPE_PLUG_IN_MANAGER, GimpPlugInManager))
|
|
#define GIMP_PLUG_IN_MANAGER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GIMP_TYPE_PLUG_IN_MANAGER, GimpPlugInManagerClass))
|
|
#define GIMP_IS_PLUG_IN_MANAGER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GIMP_TYPE_PLUG_IN_MANAGER))
|
|
#define GIMP_IS_PLUG_IN_MANAGER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_PLUG_IN_MANAGER))
|
|
|
|
|
|
typedef struct _GimpPlugInManagerClass GimpPlugInManagerClass;
|
|
|
|
struct _GimpPlugInManager
|
|
{
|
|
GimpObject parent_instance;
|
|
|
|
Gimp *gimp;
|
|
|
|
GSList *plug_in_defs;
|
|
gboolean write_pluginrc;
|
|
|
|
GSList *plug_in_procedures;
|
|
|
|
GSList *load_procs;
|
|
GSList *save_procs;
|
|
GSList *export_procs;
|
|
GSList *raw_load_procs;
|
|
GSList *batch_procs;
|
|
|
|
GSList *display_load_procs;
|
|
GSList *display_save_procs;
|
|
GSList *display_export_procs;
|
|
GSList *display_raw_load_procs;
|
|
|
|
GSList *menu_branches;
|
|
GSList *help_domains;
|
|
|
|
GimpPlugIn *current_plug_in;
|
|
GSList *open_plug_ins;
|
|
GSList *plug_in_stack;
|
|
|
|
GimpPlugInShm *shm;
|
|
GimpInterpreterDB *interpreter_db;
|
|
GimpEnvironTable *environ_table;
|
|
GimpPlugInDebug *debug;
|
|
GList *data_list;
|
|
};
|
|
|
|
struct _GimpPlugInManagerClass
|
|
{
|
|
GimpObjectClass parent_class;
|
|
|
|
void (* plug_in_opened) (GimpPlugInManager *manager,
|
|
GimpPlugIn *plug_in);
|
|
void (* plug_in_closed) (GimpPlugInManager *manager,
|
|
GimpPlugIn *plug_in);
|
|
|
|
void (* menu_branch_added) (GimpPlugInManager *manager,
|
|
GFile *file,
|
|
const gchar *menu_path,
|
|
const gchar *menu_label);
|
|
};
|
|
|
|
|
|
GType gimp_plug_in_manager_get_type (void) G_GNUC_CONST;
|
|
|
|
GimpPlugInManager * gimp_plug_in_manager_new (Gimp *gimp);
|
|
|
|
void gimp_plug_in_manager_initialize (GimpPlugInManager *manager,
|
|
GimpInitStatusFunc status_callback);
|
|
void gimp_plug_in_manager_exit (GimpPlugInManager *manager);
|
|
|
|
/* Register a plug-in. This function is public for file load-save
|
|
* handlers, which are organized around the plug-in data structure.
|
|
* This could all be done a little better, but oh well. -josh
|
|
*/
|
|
void gimp_plug_in_manager_add_procedure (GimpPlugInManager *manager,
|
|
GimpPlugInProcedure *procedure);
|
|
|
|
void gimp_plug_in_manager_add_batch_procedure (GimpPlugInManager *manager,
|
|
GimpPlugInProcedure *proc);
|
|
GSList * gimp_plug_in_manager_get_batch_procedures (GimpPlugInManager *manager);
|
|
|
|
void gimp_plug_in_manager_add_temp_proc (GimpPlugInManager *manager,
|
|
GimpTemporaryProcedure *procedure);
|
|
void gimp_plug_in_manager_remove_temp_proc (GimpPlugInManager *manager,
|
|
GimpTemporaryProcedure *procedure);
|
|
|
|
void gimp_plug_in_manager_add_open_plug_in (GimpPlugInManager *manager,
|
|
GimpPlugIn *plug_in);
|
|
void gimp_plug_in_manager_remove_open_plug_in (GimpPlugInManager *manager,
|
|
GimpPlugIn *plug_in);
|
|
|
|
void gimp_plug_in_manager_plug_in_push (GimpPlugInManager *manager,
|
|
GimpPlugIn *plug_in);
|
|
void gimp_plug_in_manager_plug_in_pop (GimpPlugInManager *manager);
|
|
|
|
|
|
#endif /* __GIMP_PLUG_IN_MANAGER_H__ */
|