mirror of
https://gitlab.gnome.org/GNOME/gimp.git
synced 2025-07-04 01:43:24 +00:00

First of all: sorry to all translators who started working on these new strings! We use CamelCase for our titles, and in particular "Plug-In" is capitalized with 'I'. Furthermore, let's use understandable titles like "Plug-In Example in C" and not just "In C", because while the short title works OK in the menu, it makes for very broken action names in non-contextual parts of the software, such as the action search. Note that we in fact have a concept of short label for actions since commit89772351c9
. I added support for it to GEGL actions (cf. commit6dc5f6792e
), and to a few core actions (e.g. commitea1205f094
). Unfortunately I don't think I added an API yet for short label in plug-ins. Maybe I'll add it soon. But for now, if we have to have a single label, it should be long, so that it works in every situation. P.S.: not sure if it's useful to keep documentation strings just repeating the title, but for now, let's leave them.
189 lines
6.8 KiB
JavaScript
Executable file
189 lines
6.8 KiB
JavaScript
Executable file
#!/usr/bin/env gjs
|
|
|
|
/* GIMP - The GNU Image Manipulation Program
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
*
|
|
* hello-world.js
|
|
* Copyright (C) Jehan
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
const System = imports.system
|
|
|
|
imports.gi.versions.Gimp = '3.0';
|
|
const Gimp = imports.gi.Gimp;
|
|
imports.gi.versions.GimpUi = '3.0';
|
|
const GimpUi = imports.gi.GimpUi;
|
|
imports.gi.versions.Gegl = '0.4';
|
|
const Gegl = imports.gi.Gegl;
|
|
imports.gi.versions.Gtk = '3.0';
|
|
const Gtk = imports.gi.Gtk;
|
|
imports.gi.versions.Gdk = '3.0';
|
|
const Gdk = imports.gi.Gdk;
|
|
|
|
const GLib = imports.gi.GLib;
|
|
const GObject = imports.gi.GObject;
|
|
const Gio = imports.gi.Gio;
|
|
|
|
/* gjs's ARGV is not C-style. We must add the program name as first
|
|
* value.
|
|
*/
|
|
ARGV.unshift(System.programInvocationName);
|
|
|
|
let url = "https://gitlab.gnome.org/GNOME/gimp/blob/master/extensions/goat-exercises/goat-exercise-gjs.js";
|
|
|
|
function _(message) { return GLib.dgettext(null, message); }
|
|
|
|
var Goat = GObject.registerClass({
|
|
GTypeName: 'Goat',
|
|
}, class Goat extends Gimp.PlugIn {
|
|
|
|
vfunc_query_procedures() {
|
|
return ["plug-in-goat-exercise-gjs"];
|
|
}
|
|
|
|
vfunc_create_procedure(name) {
|
|
let procedure = Gimp.ImageProcedure.new(this, name, Gimp.PDBProcType.PLUGIN, this.run);
|
|
|
|
procedure.set_image_types("*");
|
|
procedure.set_sensitivity_mask(Gimp.ProcedureSensitivityMask.DRAWABLE);
|
|
|
|
procedure.set_menu_label(_("Plug-In Example in _JavaScript"));
|
|
procedure.set_icon_name(GimpUi.ICON_GEGL);
|
|
procedure.add_menu_path ('<Image>/Filters/Development/Plug-In Examples/');
|
|
|
|
procedure.set_documentation(_("Plug-in example in JavaScript (GJS)"),
|
|
_("Plug-in example in JavaScript (GJS)"),
|
|
name);
|
|
procedure.set_attribution("Jehan", "Jehan", "2019");
|
|
|
|
return procedure;
|
|
}
|
|
|
|
run(procedure, run_mode, image, drawables, config, run_data) {
|
|
/* TODO: localization. */
|
|
|
|
if (drawables.length != 1) {
|
|
let msg = `Procedure '${procedure.get_name()}' only works with one drawable.`;
|
|
let error = GLib.Error.new_literal(Gimp.PlugIn.error_quark(), 0, msg);
|
|
return procedure.new_return_values(Gimp.PDBStatusType.CALLING_ERROR, error)
|
|
}
|
|
|
|
let drawable = drawables[0];
|
|
|
|
if (run_mode == Gimp.RunMode.INTERACTIVE) {
|
|
GimpUi.init("goat-exercise-gjs");
|
|
/* TODO: help function and ID. */
|
|
let dialog = new GimpUi.Dialog({
|
|
title: _("Plug-In Example in JavaScript (GJS)"),
|
|
role: "goat-exercise-JavaScript",
|
|
use_header_bar: true,
|
|
});
|
|
dialog.add_button(_("_Cancel"), Gtk.ResponseType.CANCEL);
|
|
dialog.add_button(_("_Source"), Gtk.ResponseType.APPLY);
|
|
dialog.add_button(_("_OK"), Gtk.ResponseType.OK);
|
|
|
|
let geometry = new Gdk.Geometry();
|
|
geometry.min_aspect = 0.5;
|
|
geometry.max_aspect = 1.0;
|
|
dialog.set_geometry_hints (null, geometry, Gdk.WindowHints.ASPECT);
|
|
|
|
let box = new Gtk.Box({
|
|
orientation: Gtk.Orientation.VERTICAL,
|
|
spacing: 2
|
|
});
|
|
dialog.get_content_area().add(box);
|
|
box.show();
|
|
|
|
let lang = "JavaScript (GJS)";
|
|
/* XXX Can't we have nicer-looking multiline strings and
|
|
* also in printf format like in C for sharing the same
|
|
* string in localization?
|
|
*/
|
|
let head_text = `This plug-in is an exercise in '${lang}' to demo plug-in creation.\n` +
|
|
`Check out the last version of the source code online by clicking the \"Source\" button.`;
|
|
|
|
let label = new Gtk.Label({label:head_text});
|
|
box.pack_start(label, false, false, 1);
|
|
label.show();
|
|
|
|
let contents = imports.byteArray.toString(GLib.file_get_contents(System.programInvocationName)[1]);
|
|
if (contents) {
|
|
let scrolled = new Gtk.ScrolledWindow();
|
|
scrolled.set_vexpand (true);
|
|
box.pack_start(scrolled, true, true, 1);
|
|
scrolled.show();
|
|
|
|
let view = new Gtk.TextView();
|
|
view.set_wrap_mode(Gtk.WrapMode.WORD);
|
|
view.set_editable(false);
|
|
let buffer = view.get_buffer();
|
|
buffer.set_text(contents, -1);
|
|
scrolled.add(view);
|
|
view.show();
|
|
}
|
|
|
|
while (true) {
|
|
let response = dialog.run();
|
|
|
|
if (response == Gtk.ResponseType.OK) {
|
|
dialog.destroy();
|
|
break;
|
|
}
|
|
else if (response == Gtk.ResponseType.APPLY) {
|
|
Gio.app_info_launch_default_for_uri(url, null);
|
|
continue;
|
|
}
|
|
else { /* CANCEL, CLOSE, DELETE_EVENT */
|
|
dialog.destroy();
|
|
return procedure.new_return_values(Gimp.PDBStatusType.CANCEL, null)
|
|
}
|
|
}
|
|
}
|
|
|
|
let [ intersect, x, y, width, height ] = drawable.mask_intersect();
|
|
if (intersect) {
|
|
Gegl.init(null);
|
|
|
|
let buffer = drawable.get_buffer();
|
|
let shadow_buffer = drawable.get_shadow_buffer();
|
|
|
|
let graph = new Gegl.Node();
|
|
let input = graph.create_child("gegl:buffer-source");
|
|
input.set_property("buffer", buffer);
|
|
let invert = graph.create_child("gegl:invert");
|
|
let output = graph.create_child("gegl:write-buffer");
|
|
output.set_property("buffer", shadow_buffer);
|
|
input.link(invert);
|
|
invert.link(output);
|
|
output.process();
|
|
|
|
/* This is extremely important in bindings, since we don't
|
|
* unref buffers. If we don't explicitly flush a buffer, we
|
|
* may left hanging forever. This step is usually done
|
|
* during an unref().
|
|
*/
|
|
shadow_buffer.flush();
|
|
|
|
drawable.merge_shadow(true);
|
|
drawable.update(x, y, width, height);
|
|
Gimp.displays_flush();
|
|
}
|
|
|
|
return procedure.new_return_values(Gimp.PDBStatusType.SUCCESS, null);
|
|
}
|
|
});
|
|
|
|
Gimp.main(Goat.$gtype, ARGV);
|