forked from GNOME/gimp
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathNEWS
2526 lines (2358 loc) · 129 KB
/
NEWS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
------------------------------
GNU Image Manipulation Program
Development Branch
------------------------------
This is the unstable branch of GIMP.
Overview of Changes from GIMP 2.99.16 to GIMP 2.99.18
=====================================================
Core:
- New snapping options:
* "Snap to Bounding Boxes": allows on-canvas snapping to either layer
borders or center.
* "Snap to Equidistance": allows to snap a layer to be at the same distance
from a second one that this second one is to a third one, either
horizontally or vertically.
- GIMP is now able to use fonts with custom styles, which Pango is unable to
work with.
- Font names are not unique anymore, which means that GIMP doesn't rename
identically named fonts with #1 or #2, etc. as it used to do. These fonts
with same name are now properly working despite the name clash.
- GimpData now have a concept of collection, which is either a controlled name
for internal data, or a string constructed from the local file path for
external data. This will be used to serialize data objects hence easily
retrieve the proper data even when some data may have duplicate names.
- New palette import support: SwatchBooker.
- Artifically set PANGOCAIRO_BACKEND=fc when running on Windows to use the
fontconfig backend, which enables anti-aliasing on Windows, unlike the
default pangocairo backend.
- XCF:
* Font information are more accurately stored (not only the font name, but
also storing various other attributes and even a file hash in the ideal
case where the exact same font file is available), allowing to find the
right font (if installed) on load with less errors.
* As a consequence of the previous point, new files with text layers will be
saved as a bumped XCF 19 version.
* Older XCF versions with text layers can still be saved using older XCF
versions as long as the text layers are untouched in an edit session.
- "view-zoom-*" actions are not radio actions anymore.
- Improve thumbnail loading algorithm:
1. If there is a GimpThumbnailProcedure, it is run first.
2. Otherwise we check if a thumbnail is in the metadata.
3. As last resort, we just load the full image.
- Generic inter-process transient window reimplemented using opaque GBytes
window identifiers instead of guint32. The goal is to have windows created
by plug-ins be transient to the calling core image window, but also the
other way around: some core dialogs are generated through PDB calls (in
particular resource and drawable chooser dialogs created by gimp_*_popup()
functions) and should be transient to plug-in dialogs.
This works on X11 and Wayland (the Wayland implementation is new, previous
code was X11-only). It should work on Windows too (code exists) but this was
left disabled as it leads to core process hanging (as described in
https://bugzilla.gnome.org/show_bug.cgi?id=359538) and is pending debugging.
There is no macOS implementation yet, and it seems to be missing from GDK as
well.
- Indexed images' colormap:
* Now possible to delete colors if unused.
- Updates for floating data's actions:
* New actions "edit-paste-float" and "edit-paste-float-in-place" for pasting
the contents of the clipboard as floating data with default positionning
algorithm or in-place respectively;
* renames "select-float" to "select-cut-float" which does a cut and paste as
float in one action;
* adds "select-copy-float" which does a copy and paste as float in one
action;
* reorganize a bit the `Edit > Paste as` submenu with sections for the
floating data variants;
* add a "Float" submenu in "Select" root menu, containing the 2 variant
actions "select-cut-float" and "select-copy-float".
Graphical User Interface:
- "Merge menu and title bar" option is not shown on macOS as it is not usable
there (the main menu is anyway out of the window from the start).
- Top menu has been special-cased for macOS (some items are removed with
"hidden-when" attribute set to "macos-menubar" value) for items which are
also available in the application menu.
- Menu section can now be named with the "section-name" attribute in
GtkBuilder ".ui" files. This can be used as a replacement of the former
"Placeholder" concept which we used to have (and has now been completely
removed).
Plug-ins or GEGL operations which want to make use of sections can use the
"[Section]" syntax. For instance installing a plug-in in the menu path
"<Image>/File/[Open]" will install the menu item at the end of the Open
section (i.e. after the various other open-file actions at the top of the
File menu).
- Some string or naming consistencies were fixed in source strings.
- GimpContainerEntry don't have inline completion anymore. Instead the result
pop-up always appear, even for one result. This is because a limitation of
GtkEntryCompletion: we cannot remove the case sensitivity search (see
gtk#275) which was very bad usage experience because when we reached a
single result, suddenly nothing happened anymore (no popup, no completion)
if case was different on any letter. It's just better to always have popup
with case insensitivity.
This widget is used for instance for on-canvas font selection.
- Some icons were modified with an added light border to make them better
visible on dark themes: gimp-tool-text icons in Color and Legacy icon themes
and gimp-tool-dodge in Color theme.
- Help menu rearranged to be better organized and also to move "About GIMP" as
the last item, which is its more conventional position.
- Many fixes to the default themes (including several cases of CSS rules
leaking from system themes).
- New settings in Preferences to set the interface base font size (this won't
work as well, or at all, for themes which would set absolute font sizes).
- "gimp-wilber-eek" icon is now reused as generic "image-missing" icon too.
- In dockables' grid view, the hovered icon is now highlighted with a
contrasted border.
- GimpPdbDialog (e.g. resource chooser dialogs) are now set to system defaults
for whether or not they use a header bar.
- Shift+Number-row default shortcuts are now transformed into the actual key
in the currently used layout (reciprocally, if numbers are direct access
key, their counterpart shortcuts are similarly updated).
- Colormap dockable:
* New "Delete" button available and sensitive only when selecting an unused
color in the palette.
- Windows: title bar will be switched to light or dark mode based on the
current theme.
- The quit dialog now adjusts its size relatively to monitor height.
- The heuristic to set a cursor when single or multi-selecting items in a tree
view got reviewed in order to avoid unecessary scroll. As a general rule,
the cursor is always set to one of the selected element, ideally the last
clicked element unless it is not selected (e.g. removed with Ctrl-click),
then a closest selected element is chosen to avoid unecessarily scroll of
the item list.
- Pad buttons can now be configured in the "Input Devices" configuration dialog
to run any actions directly (without mapping shortcut key combinations as
intermediate). This only works on Wayland for the time being (yet may work on
more platforms in the future, depending on GTK evolution).
Tools:
- Text tool:
* improve markup creation logic when replacing selected text in
order not to create useless styling markup interfering with other
features.
* Alignment for RTL languages is now more consistent with how it works in
other software (such as LibreOffice or Scribus).
- Paint tools: all painting tools now have an "Expand Layers" option
allowing to auto-expand layers when painting across layer
boundaries. A few additional sub-options customize how this
expansion happens (by how many pixels, filling with transparency,
color, pattern).
Expansion does not grow over canvas boundaries, unless "Show All" is
checked too.
Plug-ins:
- Farbfeld: new image format import/export support.
- OpenEXR:
* Files with single channels are always treated as grayscale, even when
they use non-conventional channel names. A notice message is also
presented to the user in a dialog for information.
- Metadata Editor:
* Various code cleanups and improvements;
* GUI improvements;
* Xmp.plus.ImageSupplierName can now only have one value;
* Improved Creation date handling;
* Synchronization (both for reading and writing) added between some Exif,
Xmp and Iptc equivalent tags. On reading, when equivalent tags have
different values at load, a terminal warning is now outputted.
- Script-fu:
* Generated dialog's titles are not prefixed with "Script-Fu: " anymore.
* Several scripts were removed and moved to gimp-data-extras: erase-rows,
grid-system, select-to-brush, select-to-image, select-to-pattern.
* script-fu-copy-visible was removed (and not moved to gimp-data-extras).
* New test scripts.
- New gimp-help-main script to link to the "Table of Contents" of the manual,
added to the "Help > User Manual" submenu.
- PSP:
* added support to load PSP ICC Profile data.
* fixed vulnerabilities: ZDI-CAN-22096, ZDI-CAN-22097.
* load active selection from PSP file.
* Load guides and grid info.
- Image Map: two new fields to the HTML Link tab and one new field to the
Javascript tab for area properties:
* accesskey: The same as the mnemonic key shortcuts in GTK, to activate an
area of the image map. Depending on the OS, you either hold ALT or
ALT+SHIFT and this key.
* tabindex: What order to select the area when the user presses Tab.
* onClick: Run a Javascript function when the user clicks on the area.
- Esm Software PIX: new import support.
- All plug-ins were ported to the new Gimp*Procedure API using
GimpProcedureConfig instead of GimpValueArray arguments.
- Add Border (script-fu): add a 'Allow resizing' toggle.
- Plug-ins ported to GimpProcedureDialog: van-gogh-lic, dds-write, flame,
histogram-export, lighting, fractal-explorer, map-object, sample-colorize,
compose, curve-bend, depth-merge, selection-to-path, pagecurl, file-cel,
file-svg, file-wmf, smooth-palette, small-tile, film, gradient-flare, tile,
web-page, screenshot.
- JPEG-XL:
* Load metadata via libjxl exclusively.
* Disable GIMP EXIF orientation support, using orientation stored in
codestream instead.
- HEIF:
* Load metadata via libheif exclusively.
* Disable GIMP EXIF orientation support.
- PDF:
* "Layers as Pages" works now for a single layer group with multiple
sub-layers.
- DDS:
* Add support for loading DDS 16- and 32-bit per channel RGBA. Loading is
supported for 16-bit half float, 32-bit float, 16 and 32-bit unsigned and
signed int.
This supports both the DX10 formats and the D3D FOURCC versions.
16- and 32-bit per channel images with less than 4 channels are not yet
supported.
* Add DDS support for loading R8G8, R16 and R16G16 formats.
GIMP can load DXGI variants as well as the older D3DF versions, including
handling of the signed versions.
We also set signed when the pixelformat flag DDPF_BUMPDUDV is set.
* New option to vertically flip dds image on import. This is needed by some
game engines.
* All mipmap generation is done at 32-bit floating-point precision.
* A new cubic filter has also been added (Catmull-Rom) which
rounds-out the existing lineup of cubic filters.
* Better handling of DX10+ files in ddsread.
* Always interpret BC1 cutout pixels as black pixels with 0 alpha,
per the official format specification.
* Import code was rewritten and improved for maintainability and
readability. Importer now supports nearly all non-video
uncompressed formats.
- GIF:
* Remember when a file was stored as a GIF animation to be reused when
overwriting.
- PNG:
* Import/export safe-to-copy PNG chunks.
- HEJ2: new import support. HEJ2 is JPEG 2000 image coded images in HEIF
containers.
- PSD: better wording of the export warning for the path of less surprise.
- Python Console uses theme colors for font colors instead of hardcoded
colors which don't work well on darker themes.
Data:
- Clarified our capitalization rule for data titles: part of titles
inside parentheses also follow title casing.
- "(Hardedge)" generated gradients got renamed "(Hard Edge)".
Translations:
- Many non-translatable strings were made translatable. Various other
localization bugs were handled.
- New Belarusian translation in the Windows installer.
API:
- Changes in libgimpconfig:
* GimpConfig serialization doesn't break anymore if one property
serialization fails. GIMP will now continue to serialize the rest. In
particular, it will allow to retrieve as many arguments as possible
between plug-in runs.
* GBytes (de)serialization support added. It supports gracefully a NULL
GBytes value.
- Changes in libgimp:
* GimpResource can now be (de)serialized using the data name and collection
so that we are now able to retrieve a used resource quite reliably between
runs.
* For GimpProcedure with no run-mode parameter, the run-mode is considered
non-interactive (e.g. for decision algorithm about whether to reuse
previous settings or not).
* Arguments of type GimpResource and its subtypes are now supported and
GimpProcedureDialog will generate appropriate chooser widgets.
* Arguments of type GimpLayer and GimpChannel will have a proper widget
generated (GimpDrawableChooser) by GimpProcedureDialog, limited to only
the proper drawable subtype.
* All GimpProcedure and its subtypes now have a run() method using a
GimpConfig instead of a GimpValueArray. In particular, the type of the run
argument changed in gimp_procedure_new(), gimp_batch_procedure_new(),
gimp_image_procedure_new(), gimp_load_procedure_new(),
gimp_save_procedure_new() and gimp_thumbnail_procedure_new().
The following 2 run function types had further evolutions:
+ GimpRunLoadFunc: by default, a GimpLoadProcedure will try and load
metadata from a file (if Exiv2 knows the format). The run() function
will be allowed to edit the GimpMetadata object but also the load flags
before it is actually attached to the image, allowing plug-ins to have
custom metadata handling code when needed.
+ GimpRunSaveFunc: metadata handling is integrated in this new version of
the API, since the run() function will pass a prepared metadata object,
which can be modified by plug-in code (if needed). This GimpMetadata
object will be stored automatically by the GimpSaveProcedure
infrastructure if the mimetype argument is set in
gimp_save_procedure_new().
* On plug-in exit, we do not display memory reference hold warnings for Lua,
Javascript and Python plug-ins anymore. The GObject-Introspection bindings
for these languages seem to hold references of their own in some
conditions and anyway plug-in developers don't have any memory management
capabilities available in the chosen languages. It's not like they can do
anything.
* New functions:
+ gimp_procedure_dialog_set_sensitive_if_in()
+ gimp_procedure_dialog_set_ok_label()
+ gimp_procedure_dialog_fill_notebook()
+ gimp_procedure_dialog_fill_notebook_list()
+ gimp_procedure_dialog_fill_paned()
+ gimp_procedure_config_get_choice_id()
+ gimp_prop_brush_chooser_new()
+ gimp_prop_font_chooser_new()
+ gimp_prop_gradient_chooser_new()
+ gimp_prop_palette_chooser_new()
+ gimp_prop_pattern_chooser_new()
+ gimp_resource_select_button_get_label()
+ gimp_pattern_get_buffer()
+ gimp_drawables_close_popup()
+ gimp_drawables_popup()
+ gimp_drawables_set_popup()
+ gimp_prop_drawable_chooser_new()
+ gimp_font_get_pango_font_description()
+ gimp_fonts_get_by_name()
+ gimp_image_get_palette()
+ gimp_procedure_run_config()
+ gimp_procedure_run_valist()
* Removed functions:
+ gimp_procedure_config_begin_run()
+ gimp_procedure_config_end_run()
+ gimp_procedure_config_begin_export()
+ gimp_procedure_config_end_export()
+ gimp_procedure_config_get_values()
+ gimp_procedure_config_set_values()
+ gimp_pdb_run_procedure_argv()
+ gimp_pdb_run_procedure()
+ gimp_pdb_run_procedure_valist()
+ gimp_pdb_run_procedure_array()
+ gimp_pdb_run_procedure_config()
+ gimp_procedure_new_arguments()
+ gimp_pdb_set_data() a.k.a. gimp_set_data()
+ gimp_pdb_get_data() a.k.a. gimp_get_data()
+ gimp_pdb_get_data_size() a.k.a. gimp_get_data_size()
* Modified functions:
+ gimp_procedure_dialog_get_label():
1. Added `is_markup` and `with_mnemonic` boolean arguments.
2. `label_id` argument can be a string property to sync to, or a new
widget ID to create, using `text` as initialization contents.
+ gimp_label_spin_set_increments(): made more generic and robust to handle
integer spin or modifyable min/max.
+ gimp_param_spec_get_desc():
- Also handles new GimpChoice arguments by listing all valid string
values for a given argument.
- Returned string is now pango-markup formatted.
+ gimp_display_get_window_handle() and gimp_progress_get_window_handle():
the return value is now an opaque GBytes which is to be interpreted
differently depending on the running platform.
+ All gimp_*_popup() functions now have a `parent_window` argument which
is the opaque window handle of the calling plug-in dialog, such as can
be returned by gimp_dialog_get_native_handle().
+ gimp_brush_get_pixels() replaced by gimp_brush_get_buffer() and
gimp_brush_get_mask().
+ gimp_text_layer_set_font() now uses a GimpFont.
+ gimp_text_layer_get_font() now returns a GimpFont.
+ gimp_text_layer_new() now uses a GimpFont.
+ gimp_text_fontname() renamed gimp_text_font().
+ gimp_text_get_extents_fontname() renamed gimp_text_get_extents_font().
+ gimp_ui_init() now implies a gegl_init().
+ gimp_procedure_run() now uses a variable argument list of (name, value)
pairs.
* New classes:
+ GimpPickableSelect
+ GimpDrawableChooser
* Modified classes or structure:
+ GimpProgress:
- GimpProgressVtableGetWindowFunc function type now returns GBytes.
- get_window() abstract method is renamed get_window_handle().
+ GimpResourceSelectButton:
- Class made abstract.
- It now has a label which is used in the size group in
GimpProcedureDialog.
+ GimpBrushSelectButton: big UX improvements.
+ GimpPatternSelectButton: big UX improvements.
+ All Gimp*SelectButton widgets were renamed to Gimp*Chooser.
* New GimpProcedure argument types:
+ GimpChoice: this will replace cases when we used to use int arguments to
represent custom enum types, which was particularly non-usable when the
list of valid choices was long and the string docs was not kept
up-to-date.
It comes with GIMP_PROC_ARG_CHOICE(), GIMP_PROC_AUX_ARG_CHOICE(),
GIMP_PROC_VAL_CHOICE(), GIMP_VALUES_GET_CHOICE() and
GIMP_VALUES_SET_CHOICE() macros.
The advantages of this new type:
- No need to keep the list of valid choices up-to-date anymore within
the docs string.
- Since the docs string doesn't contain long list of arguments, we don't
have long opaque and non-understandable tooltips assigned to graphical
interface widgets.
- Calling a PDB procedure with a human-readable string is much more
understandable than with an opaque int.
- This type handles invalid input for generic error handling.
- We can easily generate a list of the valid string values. E.g. this is
now used in the Procedure Browser through gimp_param_spec_get_desc().
- Choices can be made insensitive if needed.
- A proper widget (GimpStringComboBox) will be generated by
GimpProcedureDialog by default.
* PDB: the big change in the PDB is that we decided not to warrant argument
orders anymore. In particular, it means that the libgimp functions to run
PDB procedures are not based on an ordered array of arguments anymore but
on named arguments only.
+ The first consequence is that it will be possible to add arguments, and
even order them however we want in the list of arguments. For
backward-compatibility, what will matter is only that the procedure
using the default values for the new arguments will behave the same way
it did when it used not to have said arguments. Then scripts won't break
as we add new arguments and we won't have to create alternative v2 or v3
PDB procedures each time we wish to add a new feature.
+ The second consequence is that calling PDB procedures is now much more
semantic. Firstly we can ignore arguments for which we keep the default
values; secondly every argument will be accompanied by a name instead of
being a long list of int or boolean values.
Typically while we used to call a PDB like this:
```C
gimp_pdb_run_procedure (gimp_get_pdb (),
"file-png-save",
GIMP_TYPE_RUN_MODE, GIMP_RUN_NONINTERACTIVE,
GIMP_TYPE_IMAGE, image,
G_TYPE_INT, 1,
GIMP_TYPE_OBJECT_ARRAY, args,
G_TYPE_FILE, file,
G_TYPE_BOOLEAN, FALSE,
G_TYPE_INT, 9,
G_TYPE_BOOLEAN, FALSE,
G_TYPE_BOOLEAN, FALSE,
G_TYPE_BOOLEAN, FALSE,
G_TYPE_BOOLEAN, FALSE,
G_TYPE_BOOLEAN, FALSE,
G_TYPE_BOOLEAN, FALSE,
G_TYPE_NONE);
```
We can now call it like this (with a shorter list of arguments, ignoring
all the ones which we keep default, not bothering about arg order and
tagging each arg with a semantic name):
```C
gimp_procedure_run (gimp_pdb_lookup_procedure (gimp_get_pdb (),
"file-png-save"),
"run-mode", GIMP_RUN_NONINTERACTIVE,
"image", image,
"num-drawables", 1,
"drawables", drawables,
"file", file,
"bkgd", FALSE,
"phys", FALSE,
"time", FALSE,
NULL);
```
+ The few libgimp functions of the form `gimp_pdb_run_procedure*()` were
removed and moved directly to `gimp_procedure_run*()` variant. The
presence of both interfaces was making it confusing.
+ For bindings not able to replicate variable arguments functions, the
bindable function will be gimp_procedure_run_config() only, which will
be renamed to gimp_procedure_run() in bindings.
+ Note that internally the argument order is still relevant for any system
which interfaces directly with the PDB instead of libgimp. In other
words, it is still relevant for script-fu which generates functions out
of PDB procedures directly (not libgimp).
+ GimpObjectArray arguments now allow NULL through the pipe as meaning an
empty array.
- Changes in libgimpbase:
* New classes:
+ GimpChoice: meant to represent a list of allowed strings values.
* GimpRotationType values were changed by prepending "DEGREES" without
hyphen before the numeric value (e.g.: GIMP_ROTATE_90 becomes
GIMP_ROTATE_DEGREES90), because the older naming breaks introspection for
some languages, such as Python where Gimp.RotationType.90 syntax would be
forbidden.
- Changes in libgimpwidgets:
* New functions:
+ gimp_widget_set_native_handle()
+ gimp_dialog_get_native_handle()
+ gimp_preview_area_reset()
* New classes:
+ GimpLabelStringWidget: makes any widget with a "value" string property
into a GimpLabeled.
* Modified classes:
+ GimpStringComboBox:
- add a "value" string property to GimpStringComboBox (which makes it
usable by GimpLabelStringWidget).
- New method gimp_string_combo_box_set_sensitivity()
- Changes in libgimpui:
* Modified functions:
+ gimp_window_set_transient_for_display() and gimp_window_set_transient()
now use an internal implementation similar to core
gimp_window_set_transient_for(), with the same improvements (works even
at construction when the window is not visible yet + works for Wayland
too).
* Removed functions:
- gimp_ui_get_progress_window()
- gimp_ui_get_display_window()
Build:
- Windows 10 becomes the new minimal support for the 3.0 stable series on
Windows. This bump happens because of end-of-support by Microsoft itself,
and also by MSYS2 project which is our base for the official installers.
- CI now generates babl and GEGL API reference HTML as artifact tarballs.
- New meson options -Dfits and -Dopenmp to enable/disable respectively FITS or
OpenMP support more explicitly (allowing to bypass auto-detection).
- Pango 1.50 or higher is now required as a result of using
pango_attribute_as_font_desc(). Also pango, pangocairo and pangoft2 now use
the same minimum version requirement.
- New Aarch64/Windows build jobs in CI.
- The universal Windows installer generated by the CI now detects and installs
a native Aarch64 build on ARM 64-bit architecture.
- Meson: alternatively to luajit, we now search also lua5.1, then 5.2 and 5.3
(5.1 first, because apart luajit, it is the only one with lua-lgi support in
MSYS2 right now).
- CI: unify jobs naming and order.
- Windows builds: various cleanups, code factorization and more.
- Windows installer: the desktop shortcut option is now checked by default
because of the fact too many people could not find GIMP after installation.
Overview of Changes from GIMP 2.99.14 to GIMP 2.99.16
=====================================================
Core:
- "Anchor" tooltip changing depending on whether we are floating over a layer
or layer mask.
- GIMP_TIMER_START|END are no-op on release builds.
- Ctrl-F overridden in our item dockables to trigger our item search popover
(multi-item selection, ability to use regexp or glob search by enabling these
in Preferences, etc.) rather than the default GTK selection popup for tree
views.
- All code is now multi-item aware (even though it might mean specifically
forbidding using some features on multiple items).
- Better support of non-ASCII characters in paths on Windows and other fixes
for Windows: API un-deprecation, unicode variants of functions…
- Copy|Cut-Paste code reworked further.
- Action "Crop to Selection" renamed to "Resize Layers to Selection".
- Action "Crop to Content" renamed to "Crop Layers to Content".
- If any opened image (with a display) is dirty, then GIMP will now inhibit the
log-out event on OSes which support it.
- Port from GtkAction/GtkUIManager to GAction/GMenu finished.
- The action search now shows the top menu path for actions when available.
- Actions can now be attributed multiple shortcuts. The duplicate actions
ending in `-accel` were removed in favor of multiple shortcuts and a few
secondary (semantic) shortcuts were added such as `Copy`/`Cut`/`Paste`
buttons for relevant actions, or `ZoomIn`/`ZoomOut` for canvas zoom,
`Forward`/`Back` to navigate through image tabs, but also some numpad
shortcuts like the `/` divide from the numpad for the action search
(additionally to the base keyboard `/` key).
It is not possible to attribute several shortcuts from GUI yet.
- An action is automatically generated for all GEGL operations which would
normally appear in the GEGL Operation tool. This includes in particular
third-party GEGL operations which might be user-installed. It makes these
filters also searchable in the action search, usable in menus and shortcuts
can be assigned as well.
- If present, the GEGL key "gimp:menu-label" will be used to set the short
label of the generated action (short labels are typically used in menus since
the menu path can serve as context). Otherwise the "title" with appended
"..." is used.
- GimpAction now have a concept of short vs. long labels, which can be used in
different places. In particular, in action search, we usually want the long
label, whereas in menus, we usually want the short label as we have context
(though the latter can be tweaked by a custom "label-variant" attribute in
.ui files).
- New "Middle Gray (CIELAB)" fill option (new image or new layer).
- Stroke Selection: "Line" and "Paint tool" styles are now in a stack
switcher instead of radio buttons. More advanced options are not "hidden"
anymore in a foldable widget.
- New grayscale color picking mode.
- .aco palettes are now imported with babl. As a result, it is now possible to
import CIE Lab palettes (colorspace 7)
- Action search now displays a "help" icon which can be clicked to show the
currently selected action's manual page (or the action search manual page if
no actions are selected). Alternatively the F1 shortcut will do the same.
- Basic matrix operations code was optimized.
- Fill/Stroke Path/Selection split the "Solid color" option into a "Foreground
color" and "Background color".
- Standardize to "X-bit" wording (e.g. "32-bit floating point" rather "32 bit
floating point").
Tools:
- GEGL Operation: auto-activate when enabled.
- Transform tools and GEGL operation don't auto-activate when opening a new
image or changing the active image.
- Align tool: "use extents of layer contents" also applies to the alignment
reference (not only the target objects).
- Color picker: pick in the image's RGB space.
- Text tool: new tool option "Show on-canvas editor" to toggle the visibility
of the on-canvas dialog.
- Unified Transform tool: the transform matrix is now selectable in the
on-canvas dialog (for instance to be easily re-usable in other software).
Graphical User Interface:
- Default, Compact and Gray themes now display a three-dot handle to paned
separators to improve accessibility and discoverability of the drag ability.
- The paned separator width is also increased a bit for accessibility (though
the Compact theme keeps a smaller separator width).
- Consistently use "Soft-proofing" wording instead of "Softproofing" or "Soft
proofing"
- The "GEGL Operation…" item was moved out of the "Filters > Generic" menu and
into the "Tools" menu.
- If present, the GEGL key "gimp:menu-path" will now be used by GIMP to create
a menu item for an operation in a given menu path.
- Default theme is less dark and the previous Default theme is renamed
"Darker".
- "Default" theme does not use smaller font size (than system theme) anymore;
but the "Compact" theme now does.
- New option "Merge menu and title bar" in Preferences > Image Windows: this
is basically an option to switch to Client Side Decoration for the image
windows (menu will be inside the title bar). It is OFF by default.
Actions:
- "tools-rotate-arbitrary" and "tools-rotate-image-arbitrary" are now disabled
when no image is opened.
Plug-ins:
- JPEG-XL:
* Initial support for CMYK/A JPEGXL export: Key and Alpha data is saved in
extra channels, and the simulation profile is saved as well.
Per the specification developers, the format does not support 'naive' CMYK
conversion, so a profile is required for export. The option will be
disabled if not set.
* Support libjxl 0.9: some API were removed which would have broken
the plug-in build. Now it should work both with old and new
version.
- Script-fu:
* Byte support: add a new type 'byte' to be able to handle binary data while
still retaining the utf8 char and string behavior.
* Enum values are now generated from GIR.
- Script-fu console: command history now persists across GIMP sessions.
- PSD:
* PSD clipping paths: import and export support.
* Unsupported features are now listed in a dialog on import.
* Add compatibility notice on export: some people have noted that legacy
layer modes have better compatibility when exporting PSDs and reopening
them in Photoshop.
* New "file-psd-load-metadata" procedure to be used by other plug-ins in
order to load Photoshop-format metadata. Some formats in particular allow
PSD style metadata (e.g. see TIFF and JPEG).
- TIFF:
* PSD metadata (both in image or layer level) can now be loaded by calling
the new "file-psd-load-metadata" PDB procedure.
* IBM PC Formatted TIFF layers are now supported on import.
- JPEG:
* PSD metadata (image level only, e.g. paths) can now be loaded by calling
the new "file-psd-load-metadata" PDB procedure.
* Clipping path import added.
* Option "4:2:2 horizontal (chroma halved)" renamed to "4:2:2 (chroma halved
horizontally)" and "4:2:2 vertical (chroma halved)" renamed to "4:4:0
(chroma halved vertically)". Research indicates it to be the most usual
notation for these options.
- DDS:
* OpenMP support enabled when available on the build machine.
- All Python 3 plug-ins whose Python 2 variants used to have a GUI now also
have one.
- Script "Predator" removed.
- PAM: import and export (formats: GRAYSCALE, GRAYSCALE_ALPHA, RGB, RGB_ALPHA)
support added. PAM files are essentially PPM files with a different header
format and alpha/16 bit support.
- GIF:
* Load error message handling improved.
* Keep GIF's full palette on import (sometimes needed for consistency when
used in a specific pipeline, e.g. a videogame engine with fixed palette).
- PCX:
* new radio option "override-palette" to override PCX 1 bit palette.
* 8bpp with 4 planes in PCX/DC import support added (we were only supporting
3 planes).
- QOI: new format support (import and export).
- Amiga IFF/ILBM: initial support for importing indexed ILBM, Amiga PBM, and
ACBM images.
- DCX: new import support (DCX files are containers that store up to 1023 PCX
files).
- Plug-ins ported to GAction: animation-play, colormap-remap, ifs-compose,
gfig, ImageMap.
- Plug-ins ported to GimpProcedureConfig and GimpProcedureDialog:
align-layers, hot, wavelet-decompose, file-sunras, file-heif, file-tga,
file-pat, file-xpm, file-csource, file-jp2-load, file-dds (import),
file-sgi, file-fli, file-pnm, file-gbr, file-psp, file-aa, bmp-save,
despeckle, blinds, contrast-retinex, jigsaw, nl-filter, destripe, file-mng,
file-html-table, file-xbm, file-pdf-load, file-gif-save, file-ps,
border-average, mail, checkerboard.
- metadata-viewer and metadata-editor: graphical interfaces are not built from
GtkBuilder .ui files anymore. These were the last instances of using this
format (except for our new menus!) for creating full GUIs as we don't want
to go this way anymore!
- FITS:
* Ported to cfitsio library for loading/exporting. This allows us to
import compressed FITS files (GZIP, HCOMP, PLIO, RICE) in 8/16/32
bit and float/double precision.
* As a result of the port, this plug-in is now optional.
- ILBM: "Hold and Modify" (HAM) mode use control bits to increase the
palette beyond what's stored in the CMAP chunk. We now check if HAM
mode is set and then interprets the plane bits accordingly.
API:
- Changes in libgimpwidgets:
* New functions:
+ gimp_int_store_new_array(): variant of gimp_int_store_new() which will
work in bindings.
+ gimp_spin_scale_get_mnemonic_keyval()
* Improved annotations or usage:
+ gimp_procedure_dialog_get_spin_scale(): factor must be 1.0 for integer
properties.
- Changes in libgimp:
* New classes:
+ GimpResource: with unique int ID, instead of data name. Actual data will
be one of the following subclasses:
+ GimpBrush
+ GimpFont
+ GimpGradient
+ GimpPalette
+ GimpPattern
* New functions:
+ gimp_procedure_dialog_fill_scrolled_window()
+ gimp_procedure_dialog_get_size_entry()
* Improved annotations or usage:
+ set_i18n() method of GimpPlugIn expects a UTF-8 catalog directory.
+ clarify gimp_image_set_file() usage (only for XCF files).
+ gimp_image_add_sample_point()
+ gimp_image_get_sample_point_position()
- Changes in libgimpbase:
* New functions:
+ gimp_bind_text_domain()
+ gimp_value_array_copy()
* Improved annotations or usage:
+ gimp_locale_directory() returns a string in the OS encoding for all but
Windows (UTF-8), i.e. GLib "filename" encoding.
+ Metadata "Exif.Image.ImageResources" and "Exif.Image.0x935c" are not
exported anymore. These are specific to Photoshop, and while we cannot
modify them, they can contain sensitive information (e.g. a thumbnail).
+ Exif.Photo.PixelXDimension and Exif.Photo.PixelYDimension metadata tags
will now be updated (if they already exist in the image) when resizing
and exporting.
- Changes in libgimpconfig:
GStrv config properties are now properly serialized and deserialized for use
as plug-ins arguments.
* New functions:
+ gimp_config_serialize_strv()
+ gimp_config_deserialize_strv()
- PDB:
* Remove GimpUint8Array in favor of GBytes.
Build:
- MacPorts support for macOS added (this is even now the official support as we
build our new packages with MacPorts).
- meson: make sure libgimp does not depend on GTK+.
- GLib requirement bumped to version 2.70 as minimum.
- Improved C99 compatibility of IPC_RMID check.
- Windows: port fileicon.ico from gimp-2-10 with additional sizes for clearer
icons on different resolutions and displays.
- Improve our build scripts to better handle sanitizer tools.
- Fix some broken unit tests in the meson build.
- Meson build options 'lua', 'javascript' and 'python' are now features, and
not boolean. I.e. use option values 'enabled'/'disabled' (defaulting to
'auto') instead of true/false.
- Meson build 'vala-plugins' option was renamed to simply 'vala'.
- Added dependency to Exiv2 0.27.4.
- JUnit reports from Meson for the CI build.
- autotools was fully dropped!
- Debian 12 bookworm is now our base platform for CI, but also for deciding
whether we can bump a dependency minimum required version or not. This is a
consequence of approaching GIMP 3.0 release so we don't want to bump minimum
versions too high.
- GEGL requirement bumped to GEGL 0.4.46.
- Windows installer's welcome image is now generated in several sizes
from our splash screen image, avoiding discrepancies as well as
unnecessarily filling our repository with a history of duplicate
images.
- Add some logic to common/ and python/ plug-ins to facilitate running
GIMP from the build directory (without being installed) while still
able to load all plug-ins.
- gtk-mac-integration was dropped as a dependency on macOS. It made problems
and is apparently less needed with GTK+3.
- Supported macOS version was bumped from macOS 10.12 to macOS 10.13.
Debugging:
- New --runtime option to `flatpak-releases` debugging script (a dev tool
allowing for instance to bisect issues through flatpak builds). This option
allows to list the runtime builds (additionally to the main GIMP flatpaks).
Documentation:
- More developer docs is being moved to the new developer website.
- Better clarify licensing of files under data/.
- Improve flatpak maintenance doc (build/flatpak/README.md).
Translations:
- 25 translations were updated: Basque, Bulgarian, Catalan, Chinese (China),
Chinese (Taiwan), Danish, Esperanto, French, Georgian, German, Greek,
Hungarian, Icelandic, Italian, Lithuanian, Persian, Polish, Portuguese,
Romanian, Russian, Slovenian, Spanish, Swedish, Turkish, Ukrainian.
Overview of Changes from GIMP 2.99.12 to GIMP 2.99.14
=====================================================
Core:
- The download button in About dialog when a new version is available
will now show the development download page when running unstable
branch code.
- The update check on macOS now uses native HTTPS-able API, so that we
don't have to wait for GIO to have HTTPS modules for macOS.
- The main process is now run as a GimpApp which is a new class derived from
GtkApplication. The main process of `gimp-console` on the other hand is a
`GimpConsoleApp` which is derived from GApplication. Both new classes share
a same GimpCoreApp interface. This is a main step for the GTK+3 port.
- Various improvements on awareness of multi-item selection across core
features. A notable fix is the preview when transforming multiple layers at
once (with various transform tools). Various actions are now multi-drawable
aware as well.
- New "Vectors Structure" in the XCF format: XCF files (format bumped to
version 18) can now store and load all the usual and common properties of
other items. In other words, it makes XCF now able to store locks, color
tags and several selected paths.
- XCF saving with RLE and zlib encoding are now multi-threaded and therefore
much faster in most cases.
- Pasting an image now creates a new layer by default (not a Floating Layer
anymore). The only 3 cases where we still have floating items are:
* when pasting into a layer mask;
* when doing quick copy/cut paste on-canvas with the Alt modifiers;
* when floating layers explicitly with the "Float" action.
- Copy-paste code was deeply reviewed and re-specified in the light of
multi-item selection; it's still a WIP:
* When pasting several drawables, we currently paste them over the top
selected layer (visually in Layers dockable).
* Pasted data position was rewritten, based on existing logic, but taking
into account the multiple selected items.
* Pasting a selected area from multiple layers still creates multiple
layers, not merged pixel contents as a single layer.
* New layers created when copying from a selection are consistently the
offset and dimensions of the bounding box of the dimension.
* When a layer and one of its group layer parent are selected, it is
equivalent to have only the child layer selected.
- 2 new actions were added: "Paste as Single Layer" and "Paste as Single Layer
in Place" under the "Paste as" submenu of Edit menu. These paste the copied
layers as a single merged layer, instead of as several layers (as "Paste"
and "Paste in Place" do).
Graphical User Interface:
- New "Gray" theme based on a 18.42% luminance middle-gray background, which
should be a good neutral environment for color work.
- The foreground/background editor in the toolbox will now take into account
the toolbox icon size and resize itself accordingly (live, as you change
theme). This allows to have really narrow toolbox when you use small icons.
- Theme-override icon size selection in Preferences > Themes: this allows to
override theme-set icon sizes, with a global concept of small, medium, large
and huge. The following widgets are so far modified: toolbox icons, fg/bg
editor in toolbox, fg/bg editor in Colors dockable, dockables tab icons,
bottom buttons (in the button box) of dockables, header eye and lock icons
above item trees, and eye and lock icon switches in item tree cells.
- Symmetry dockable contents is now shown, yet deactivated, when no images are
opened, improving discoverability.
- Reworked the "Convert to * Working Space?" dialog into a "Keep the Embedded
Working Space?" one. Keeping an image working space is now the recommended
and default action. "Convert" became an explicit action requiring to click
(neither mapped to Enter nor Escape keys).
- "Floating Selection" renamed to "Floating Layer" or "Floating Mask"
depending on the type of item it applies to.
- "Floating Masks" are now drawn above the layer mask in the Layers dockable,
making the fact that they would anchor to the below layer mask (not the
layer) much more obvious.
- "Paste into Selection" and "Paste into Selection in Place" were moved under
the "Paste as" submenu of Edit menu.
Tools:
- Text tool: new "Outlined" and "Outlined and filled" options, with various
sub-options to choose the outline style, color, pattern, width, cap and join
styles, miter limit, anti-aliasing and dash pattern.
- Align tool:
* now multi-item aware, it is much more usable than it used to be when we
had to click on canvas to select items.
* On-canvas clicks are now only needed to select guides (Alt or Alt-Shift
click and selected guide colors change) or for the reference object
(normal click).
* Also the reference object gets on-canvas handles and the name is written
in the dockable, making it obvious if you selected the right reference or
not.
* Moreover the selected reference will now loop when layers are stacked on
each other, which allow to select a bottom layer, even if there are layers
above it everywhere.
* New option "Use extents of layer contents" to Align tool: this is similar
to first run "Crop to Content" on every layer to align or distribute
(without actually cropping the layers).
* Fine-grained align/distribute button sensitivity to make it more obvious
when an action would not make any change anyway.
* New anchor point setting (pivot widget) to choose which part of the target
items will be aligned or distributed.
* Get rid of various broken distribution actions.
* Distribution actions don't move the 2 extreme (top/bottom or left/right
depending on distribution direction) targets, but distribute all other
targets within their range. It is more consistent with how it works in
other software.
* Adding 2 "Distribute with evenly (horizontal|vertical) gaps" actions,
which distribute by keeping a common gap between objects instead of
between anchor points.
* Offset settings have been removed.
- Transform tools are now auto-activated on selection (and when switching
images or item selection).
Plug-ins:
- PDF:
* Export code was ported to GimpProcedureDialog.
* New "root-layers-only" argument to "file-pdf-save", which comes
with a checkbox in the export dialog to allow exporting as pages
the root layers only. The main usage is to organize your pages'
contents in layer groups.
- AVIF:
* RGB AVIF compatibility with Safari on iOS 16.0: Some AVIF images are
rendered differently in Apple's implementation compared to implementations
of Google and Mozilla. See: https://github.com/AOMediaCodec/av1-avif/issues/195
This changes requires libheif 1.10.0 though the plug-in can still build
with older libheif.
- PSD:
* export of CMYK(A) files added, with 8 or 16-bit precision per channel,
using a CMYK soft-proof profile for conversion.
* Paths are now exported with PSD files.
- JPEG-XL:
* Metadata import/export now supported (requires libjxl 0.7.0).
- Python-Console:
* sys.stdout.flush() implemented as a no-op inside the console, to be able
to easily copy-paste code, or using libraries which flush the output.
- ICNS:
* Initial support for loading and exporting.
- TIFF:
* New toggle to optionally load reduced pages. We keep a heuristic to try
and guess whether these are thumbnails (single reduced image in the second
position), but it's only used to decide whether the option is checked by
default or not. It is now up to anyone to decide or not whether they want
to load these reduced images.
API:
- Changes in libgimp:
* Abstract method get_window() of GimpProgressVtable had its signature
changed. The window ID is now a guint64.
* New functions:
+ gimp_text_layer_set_markup()
+ gimp_image_get_selected_channels()
+ gimp_image_get_selected_vectors()
+ gimp_image_list_selected_channels()
+ gimp_image_list_selected_vectors()
+ gimp_image_set_selected_channels()
+ gimp_image_set_selected_vectors()
+ gimp_image_take_selected_channels()
+ gimp_image_take_selected_vectors()
+ gimp_image_list_selected_drawables()
* Updated functions:
+ gimp_vectors_stroke_translate() now uses offsets in double type.
* New classes:
+ GimpTextLayer: child class of GimpLayer.
- Changes in libgimpwidgets:
* Updated widgets:
+ GimpPickButton now has a specific implementation for Windows. In
particular it improves color picking with multi-monitor and scales
different than 100%.
Build:
- meson requirement bump to meson 0.56.0.
- Many fixes to the meson build scripts, making it closer to be our
official build for GIMP 3.0.
- The CI now generates a tarball containing the GIMP references,
generated by gi-docgen and g-ir-doc.
- Improved Clang 15.0.0 support.
- "win*-nightly" jobs were added back and are now more efficient with the
--output-dll-list option.
- babl requirement bumped to babl 0.1.98.
- GEGL requirement bumped to GEGL 0.4.40.
- GIMP macOS builds (gimp-macos-build repository) was moved to using MacPorts
in order to take advantage of a bigger community to maintain our
dependencies.
- GIMP now has an Apple Silicon build.
Overview of Changes from GIMP 2.99.10 to GIMP 2.99.12
=====================================================
Core:
- Added concept of "hidden item" to a GimpImage. This would allow to
process non attached items for internal processing more easily.
- Do not show a crosshair anymore when "Show brush outline" is
checked and "Show pointer for paint tools" is unchecked, if the
brush outline cannot be drawn (in which case a fallback 4-arcs
generic outline showing the size is displayed), for instance because
using a dynamic changing the size.
- When both "Show brush outline" and "Show pointer for paint tools"
are unchecked, show a minimal visual feedback of a few pixels only,
as inconspicuous as possible, instead of a crosshair.
- Move and reorganize pointer-related settings in Preferences from
"Image Windows" to "Input Devices" tabs.
- On macOS, delay opening new images dropped on the application icon
in the dock to after GIMP is fully initialized.
- Some code reorganization and factorization of image colormap and
palette handling.
- Language changes will trigger plug-in query() call at next GIMP
restart. This allows to have strings in query() and stored in GIMP