dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/libgimpwidgets/gimpwidgetsutils.h

83 lines
3.9 KiB
C
Raw Normal View History

libgimpwidgets: add gimpwidgetsutils.[ch] Move some functions from libgimpwidgets/gimpwidgets.[ch] and from app/widgets/gimpwidgets-utils.[ch]. Newly add gimp_widget_get_color_profile() which is extracted from modules/display-filter-lcms.c.
2015-05-07 04:15:30 +08:00
/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
*
* gimpwidgetsutils.h
*
* This library is free software: you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see
Change the license URL from http://www.gnu.org/licenses/ to https://
2018-07-12 05:27:07 +08:00
* <https://www.gnu.org/licenses/>.
libgimpwidgets: add gimpwidgetsutils.[ch] Move some functions from libgimpwidgets/gimpwidgets.[ch] and from app/widgets/gimpwidgets-utils.[ch]. Newly add gimp_widget_get_color_profile() which is extracted from modules/display-filter-lcms.c.
2015-05-07 04:15:30 +08:00
*/
#if !defined (__GIMP_WIDGETS_H_INSIDE__) && !defined (GIMP_WIDGETS_COMPILATION)
#error "Only <libgimpwidgets/gimpwidgets.h> can be included directly."
#endif
#ifndef __GIMP_WIDGETS_UTILS_H__
#define __GIMP_WIDGETS_UTILS_H__
G_BEGIN_DECLS
/* For information look into the C source or the html documentation */
app, libgimpwidgets: new gimp_event_triggers_context_menu() and use it… … for the container tree view contextual menu. A very annoying point of contextual menus is that they happen on button press whereas menu item selection happens on button release. When the menu corner is positionned on the click position, nothing bad happens; yet when place is missing on screen, the menu might get positionned over the pointer position. And worse, the mouse position might be just over an activatable menu item. So we end up in this weird situation where a click implies: press, menu opens, release, random item (whatever is below the pointer) is selected and menu closes. To get rid of this weird case, let's have our contextual menu happen on button release. In reality, I don't think anyone cares that it happens on press or release, you just "click". But what you certainly don't want is to click random menu items!
2021-06-19 06:31:40 +08:00
gboolean gimp_event_triggers_context_menu (const GdkEvent *event,
gboolean on_release);
libgimpwidgets: add gimp_grid_attach_aligned()
2018-04-29 08:15:48 +08:00
GtkWidget * gimp_grid_attach_aligned (GtkGrid *grid,
gint left,
gint top,
const gchar *label_text,
libgimpwidgets: improve parameter names of gimp_grid_attach_aligned()
2023-05-24 21:59:34 +08:00
gfloat label_xalign,
gfloat label_yalign,
libgimpwidgets: add gimp_grid_attach_aligned()
2018-04-29 08:15:48 +08:00
GtkWidget *widget,
libgimpwidgets: improve parameter names of gimp_grid_attach_aligned()
2023-05-24 21:59:34 +08:00
gint widget_columns);
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
void gimp_label_set_attributes (GtkLabel *label,
...);
Port a lot of stuff from GdkScreen/monitor_number to GdkMonitor including some fixes for getting pointer coords, and needed API changes in libgimpwidgets.
2018-04-29 23:27:47 +08:00
GdkMonitor * gimp_widget_get_monitor (GtkWidget *widget);
GdkMonitor * gimp_get_monitor_at_pointer (void);
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
app: add gimp_widget_track_monitor() Which installs a callback that behaves as if GtkWidget had a "monitor-changed" signal. Additionally, moving widgets around between windows is handled automatically.
2016-06-02 02:39:03 +08:00
void gimp_widget_track_monitor (GtkWidget *widget,
GCallback monitor_changed_callback,
libgimpwidgets: add GDestroyNotify to gimp_widget_track_monitor()
2019-08-08 05:44:18 +08:00
gpointer user_data,
GDestroyNotify user_data_destroy);
app: add gimp_widget_track_monitor() Which installs a callback that behaves as if GtkWidget had a "monitor-changed" signal. Additionally, moving widgets around between windows is handled automatically.
2016-06-02 02:39:03 +08:00
Port a lot of stuff from GdkScreen/monitor_number to GdkMonitor including some fixes for getting pointer coords, and needed API changes in libgimpwidgets.
2018-04-29 23:27:47 +08:00
GimpColorProfile * gimp_monitor_get_color_profile (GdkMonitor *monitor);
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorProfile * gimp_widget_get_color_profile (GtkWidget *widget);
libgimpcolor: add new object GimpColorTransform which encapsulates a cmsHTRANSFORM and does all the pixel format conversion magic. It has API to create transforms and proofing transforms, and to convert pixels arrays and GeglBuffers. Before, each place which has a transform had to keep around the transform and its input and output Babl formats, and had to implement lots of stuff itself. Now all that lives in GimpColorTransform, removing lots of logic from many places, and pretty much removing lcms from the public API entirely. This removes including <lcms2.h>, LCMS_LIBS and LCMS_CFLAGS from almost all directories and potentially allows to replace lcms by something else.
2016-05-26 03:35:54 +08:00
GimpColorTransform * gimp_widget_get_color_transform (GtkWidget *widget,
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorConfig *config,
libgimpwidgets: change parameters of gimp_widget_get_color_transform() Change GimpColorManaged to GimpColorProfile.
2015-09-02 05:40:57 +08:00
GimpColorProfile *src_profile,
libgimpcolor: add new object GimpColorTransform which encapsulates a cmsHTRANSFORM and does all the pixel format conversion magic. It has API to create transforms and proofing transforms, and to convert pixels arrays and GeglBuffers. Before, each place which has a transform had to keep around the transform and its input and output Babl formats, and had to implement lots of stuff itself. Now all that lives in GimpColorTransform, removing lots of logic from many places, and pretty much removing lcms from the public API entirely. This removes including <lcms2.h>, LCMS_LIBS and LCMS_CFLAGS from almost all directories and potentially allows to replace lcms by something else.
2016-05-26 03:35:54 +08:00
const Babl *src_format,
core: Add softproof profile to GimpImage Adds a simulation_profile to GimpImage to allow plug-ins to access it for CMYK import/export. Two pdb functions were added to enable this access: image_get_simulation_profile () and image_set_simulation_profile() Next, it updates menu options and code to support GimpImage's internal simulation profile. Menu items are moved from View to Image's Color Management section. New 'simulation-profile-changed' signal is emitted via GimpColorManagedInterface so that relevant tools (such as the CYMK color picker, GimpColorFrame, and future dockable dialogue) are aware of these changes.
2022-06-01 04:59:31 +08:00
const Babl *dest_format,
core: Add simulation intent and BPC to GimpImage Adds a simulation_bpc and simulation_intent to GimpImage to allow plug-ins to access it for CMYK import/export. Four pdb functions were added to enable this access: image_get_simulation_bpc (), image_set_simulation_bpc (), image_get_simulation_intent (), and image_set_simulation_intent (). Next, it updates menu options and code to support GimpImage's internal simulation intent and bpc. New 'simulation-intent-changed' and 'simulation-bpc-changed signal are emitted via GimpColorManagedInterface so that relevant tools (such as the CYMK color picker, GimpColorFrame, and future pop-overs) are aware of these changes.
2022-08-10 23:01:15 +08:00
GimpColorProfile *softproof_profile,
GimpColorRenderingIntent proof_intent,
gboolean proof_bpc);
libgimpwidgets: add gimpwidgetsutils.[ch] Move some functions from libgimpwidgets/gimpwidgets.[ch] and from app/widgets/gimpwidgets-utils.[ch]. Newly add gimp_widget_get_color_profile() which is extracted from modules/display-filter-lcms.c.
2015-05-07 04:15:30 +08:00
app, libgimp*, pdb, plug-ins: reimplement generic inter-process transient window. Having windows ID as guint32 is a mistake. Different systems have different protocols. In Wayland in particular, Windows handles are exchanged as strings. What this commit does is the following: In core: - get_window_id() virtual function in core GimpProgress is changed to return a GBytes, as a generic "data" to represent a window differently on different systems. - All implementations of get_window_id() in various classes implementing this interface are updated accordingly: * GimpSubProgress * GimpDisplay returns the handle of its shell. * GimpDisplayShell now creates its window handle at construction with libgimpwidget's gimp_widget_set_native_handle() and simply return this handle every time it's requested. * GimpFileDialog also creates its window handle at construction with gimp_widget_set_native_handle(). - gimp_window_set_transient_for() in core is changed to take a GimpProgress as argument (instead of a guint32 ID), requests and process the ID itself, according to the running platform. In particular, the following were improved: * Unlike old code, it will work even if the window is not visible yet. In such a case, the function simply adds a signal handler to set transient at mapping. It makes it easier to use it at construction in a reliable way. * It now works for Wayland too, additionally to X11. - GimpPdbProgress now exchanges a GBytes too with the command GIMP_PROGRESS_COMMAND_GET_WINDOW. - display_get_window_id() in gimp-gui.h also returns a GBytes now. PDB/libgimp: - gimp_display_get_window_handle() and gimp_progress_get_window_handle() now return a GBytes to represent a window handle in an opaque way (depending on the running platform). In libgimp: - GimpProgress's get_window() virtual function changed to return a GBytes and renamed get_window_handle(). - In particular GimpProgressBar is the only implementation of get_window_handle(). It creates its handle at object construction with libgimpwidget's gimp_widget_set_native_handle() and the virtual method's implementation simply returns the GBytes. In libgimpUi: - gimp_ui_get_display_window() and gimp_ui_get_progress_window() were removed. We should not assume anymore that it is possible to create a GdkWindow to be used. For instance this is not possible with Wayland which has its own way to set a window transient with a string handle. - 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). In libgimpwidgets: - New gimp_widget_set_native_handle() is a helper function used both in core and libgimp* libraries for widgets which we want to be usable as possible parents. It takes care of getting the relevant window handle (depending on the running platform) and stores it in a given pointer, either immediately or after a callback once the widget is mapped. So it can be used at construction. Also it sets a handle for X11 or Wayland. In plug-ins: - Screenshot uses the new gimp_progress_get_window_handle() directly now in its X11 code path and creates out of it a GdkWindows itself with gdk_x11_window_foreign_new_for_display(). Our inter-process transient implementation only worked for X11, and with this commit, it works for Wayland too. There is code for Windows but it is currently disabled as it apparently hangs (there is a comment in-code which links to this old report: https://bugzilla.gnome.org/show_bug.cgi?id=359538). NikcDC tested yesterday with re-enabling the code and said they experienced a freeze. ;-( Finally there is no infrastructure yet to make this work on macOS and apparently there is no implementation of window handle in GDK for macOS that I could find. I'm not sure if macOS doesn't have this concept of setting transient on another processus's window or GDK is simply lacking the implementation.
2023-08-14 20:23:06 +08:00
void gimp_widget_set_native_handle (GtkWidget *widget,
GBytes **handle);
libgimpwidgets: add gimpwidgetsutils.[ch] Move some functions from libgimpwidgets/gimpwidgets.[ch] and from app/widgets/gimpwidgets-utils.[ch]. Newly add gimp_widget_get_color_profile() which is extracted from modules/display-filter-lcms.c.
2015-05-07 04:15:30 +08:00
app, libgimp*: more GeglColor's space invasion. - New function gimp_cairo_set_source_color() which is meant to replace gimp_cairo_set_source_rgb(a?)() eventually. This new function sets the Cairo source color, using the target monitor's profile of the widget where the Cairo surface is meant to be drawn on. It also uses the color management settings (such as whether a custom profile was set, instead of using system profile, or also simply whether color management was disabled at all). It doesn't soft-proof the color yet. - Padding and out-of-gamut colors drawing now use the new gimp_cairo_set_source_color(). These don't need any soft-proofing anyway. - Out-of-gamut color property in GimpColorConfig is now a GeglColor property.
2023-11-23 06:38:25 +08:00
/* Internal use */
G_GNUC_INTERNAL void _gimp_widget_get_profiles (GtkWidget *widget,
GimpColorConfig *config,
GimpColorProfile **proof_profile,
GimpColorProfile **dest_profile);
libgimpwidgets: add gimpwidgetsutils.[ch] Move some functions from libgimpwidgets/gimpwidgets.[ch] and from app/widgets/gimpwidgets-utils.[ch]. Newly add gimp_widget_get_color_profile() which is extracted from modules/display-filter-lcms.c.
2015-05-07 04:15:30 +08:00
G_END_DECLS
#endif /* __GIMP_WIDGETS_UTILS_H__ */