e992ca3e51
One of the big improvement in this commit is that text layers are now much better at space accuracy. They were already space-aware, yet rendered as sRGB u8 only before being converted to the image's space. It means that text layers had the following limitations: * Any color out of sRGB gamut were trimmed. * Precision was always 8-bit (even if the image was high-bit depth). Now GimpTextLayout keeps track of its source space (for RGB and CMYK only, this won't be as easy when we will support more backend, since Cairo has only RGB support for image data) and the image TRC (in case it bypasses the color space's TRB) and it draws within this gamut and space. It means first that we are not limited to sRGB colors; we will draw text main color in the full image gamut, with still 2 remaining limitations: * Unbounded colors are impossible because Pango format (to color text) uses hexadecimal (so even with half/float images, you can't draw out-of-gamut text unfortunately). * Main color precision is still 8-bit, yet a tiny bit better than before as we at least follow TRC (so we avoid some of the precision loss when converting, even though the bit-depth is still the biggest loss). The outline color on the other hand is drawn through Cairo API entirely, in float. This means that the outline color will now be without any precision loss. Note that this depends on CAIRO_FORMAT_RGBA128F which is only available since Cairo 1.17.2 which is not in Debian bookworm (our current baseline for GIMP 3.0). It means that the old precision will still happen with older Cairo version, as determined by #if code at compilation.
86 lines
4.3 KiB
C
86 lines
4.3 KiB
C
/* GIMP - The GNU Image Manipulation Program
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
*
|
|
* GimpText
|
|
* Copyright (C) 2002-2003 Sven Neumann <sven@gimp.org>
|
|
*
|
|
* 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_TEXT_LAYOUT_H__
|
|
#define __GIMP_TEXT_LAYOUT_H__
|
|
|
|
|
|
#define GIMP_TYPE_TEXT_LAYOUT (gimp_text_layout_get_type ())
|
|
#define GIMP_TEXT_LAYOUT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GIMP_TYPE_TEXT_LAYOUT, GimpTextLayout))
|
|
#define GIMP_IS_TEXT_LAYOUT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GIMP_TYPE_TEXT_LAYOUT))
|
|
|
|
|
|
typedef struct _GimpTextLayoutClass GimpTextLayoutClass;
|
|
|
|
struct _GimpTextLayoutClass
|
|
{
|
|
GObjectClass parent_class;
|
|
};
|
|
|
|
|
|
GType gimp_text_layout_get_type (void) G_GNUC_CONST;
|
|
|
|
GimpTextLayout * gimp_text_layout_new (GimpText *text,
|
|
GimpImage *target_image,
|
|
gdouble xres,
|
|
gdouble yres,
|
|
GError **error);
|
|
|
|
const Babl * gimp_text_layout_get_space (GimpTextLayout *layout);
|
|
const GimpTRCType gimp_text_layout_get_trc (GimpTextLayout *layout);
|
|
const Babl * gimp_text_layout_get_format (GimpTextLayout *layout,
|
|
const gchar *babl_type);
|
|
|
|
gboolean gimp_text_layout_get_size (GimpTextLayout *layout,
|
|
gint *width,
|
|
gint *height);
|
|
void gimp_text_layout_get_offsets (GimpTextLayout *layout,
|
|
gint *x,
|
|
gint *y);
|
|
void gimp_text_layout_get_resolution (GimpTextLayout *layout,
|
|
gdouble *xres,
|
|
gdouble *yres);
|
|
|
|
GimpText * gimp_text_layout_get_text (GimpTextLayout *layout);
|
|
PangoLayout * gimp_text_layout_get_pango_layout (GimpTextLayout *layout);
|
|
|
|
void gimp_text_layout_get_transform (GimpTextLayout *layout,
|
|
cairo_matrix_t *matrix);
|
|
|
|
void gimp_text_layout_transform_rect (GimpTextLayout *layout,
|
|
PangoRectangle *rect);
|
|
void gimp_text_layout_transform_point (GimpTextLayout *layout,
|
|
gdouble *x,
|
|
gdouble *y);
|
|
void gimp_text_layout_transform_distance (GimpTextLayout *layout,
|
|
gdouble *x,
|
|
gdouble *y);
|
|
|
|
void gimp_text_layout_untransform_rect (GimpTextLayout *layout,
|
|
PangoRectangle *rect);
|
|
void gimp_text_layout_untransform_point (GimpTextLayout *layout,
|
|
gdouble *x,
|
|
gdouble *y);
|
|
void gimp_text_layout_untransform_distance (GimpTextLayout *layout,
|
|
gdouble *x,
|
|
gdouble *y);
|
|
|
|
|
|
#endif /* __GIMP_TEXT_LAYOUT_H__ */
|