diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 03:13:10 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 03:13:10 +0000 |
commit | 3c57dd931145d43f2b0aef96c4d178135956bf91 (patch) | |
tree | 3de698981e9f0cc2c4f9569b19a5f3595e741f6b /libgimp/gimptexttool_pdb.c | |
parent | Initial commit. (diff) | |
download | gimp-3c57dd931145d43f2b0aef96c4d178135956bf91.tar.xz gimp-3c57dd931145d43f2b0aef96c4d178135956bf91.zip |
Adding upstream version 2.10.36.upstream/2.10.36
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'libgimp/gimptexttool_pdb.c')
-rw-r--r-- | libgimp/gimptexttool_pdb.c | 324 |
1 files changed, 324 insertions, 0 deletions
diff --git a/libgimp/gimptexttool_pdb.c b/libgimp/gimptexttool_pdb.c new file mode 100644 index 0000000..12fd893 --- /dev/null +++ b/libgimp/gimptexttool_pdb.c @@ -0,0 +1,324 @@ +/* LIBGIMP - The GIMP Library + * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball + * + * gimptexttool_pdb.c + * + * 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 + * <https://www.gnu.org/licenses/>. + */ + +/* NOTE: This file is auto-generated by pdbgen.pl */ + +#include "config.h" + +#include "gimp.h" + + +/** + * SECTION: gimptexttool + * @title: gimptexttool + * @short_description: Functions for controlling the text tool. + * + * Functions for controlling the text tool. + **/ + + +/** + * gimp_text_fontname: + * @image_ID: The image. + * @drawable_ID: The affected drawable: (-1 for a new text layer). + * @x: The x coordinate for the left of the text bounding box. + * @y: The y coordinate for the top of the text bounding box. + * @text: The text to generate (in UTF-8 encoding). + * @border: The size of the border. + * @antialias: Antialiasing. + * @size: The size of text in either pixels or points. + * @size_type: The units of specified size. + * @fontname: The name of the font. + * + * Add text at the specified location as a floating selection or a new + * layer. + * + * This tool requires a fontname matching an installed PangoFT2 font. + * You can specify the fontsize in units of pixels or points, and the + * appropriate metric is specified using the size_type argument. The x + * and y parameters together control the placement of the new text by + * specifying the upper left corner of the text bounding box. If the + * specified drawable parameter is valid, the text will be created as a + * floating selection attached to the drawable. If the drawable + * parameter is not valid (-1), the text will appear as a new layer. + * Finally, a border can be specified around the final rendered text. + * The border is measured in pixels. Parameter size-type is not used + * and is currently ignored. If you need to display a font in points, + * divide the size in points by 72.0 and multiply it by the image's + * vertical resolution. + * + * Returns: The new text layer or -1 if no layer was created. + **/ +gint32 +gimp_text_fontname (gint32 image_ID, + gint32 drawable_ID, + gdouble x, + gdouble y, + const gchar *text, + gint border, + gboolean antialias, + gdouble size, + GimpSizeType size_type, + const gchar *fontname) +{ + GimpParam *return_vals; + gint nreturn_vals; + gint32 text_layer_ID = -1; + + return_vals = gimp_run_procedure ("gimp-text-fontname", + &nreturn_vals, + GIMP_PDB_IMAGE, image_ID, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, x, + GIMP_PDB_FLOAT, y, + GIMP_PDB_STRING, text, + GIMP_PDB_INT32, border, + GIMP_PDB_INT32, antialias, + GIMP_PDB_FLOAT, size, + GIMP_PDB_INT32, size_type, + GIMP_PDB_STRING, fontname, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + text_layer_ID = return_vals[1].data.d_layer; + + gimp_destroy_params (return_vals, nreturn_vals); + + return text_layer_ID; +} + +/** + * gimp_text_get_extents_fontname: + * @text: The text to generate (in UTF-8 encoding). + * @size: The size of text in either pixels or points. + * @size_type: The units of specified size. + * @fontname: The name of the font. + * @width: The width of the specified font. + * @height: The height of the specified font. + * @ascent: The ascent of the specified font. + * @descent: The descent of the specified font. + * + * Get extents of the bounding box for the specified text. + * + * This tool returns the width and height of a bounding box for the + * specified text string with the specified font information. Ascent + * and descent for the specified font are returned as well. Parameter + * size-type is not used and is currently ignored. If you need to + * display a font in points, divide the size in points by 72.0 and + * multiply it by the vertical resolution of the image you are taking + * into account. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_text_get_extents_fontname (const gchar *text, + gdouble size, + GimpSizeType size_type, + const gchar *fontname, + gint *width, + gint *height, + gint *ascent, + gint *descent) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-text-get-extents-fontname", + &nreturn_vals, + GIMP_PDB_STRING, text, + GIMP_PDB_FLOAT, size, + GIMP_PDB_INT32, size_type, + GIMP_PDB_STRING, fontname, + GIMP_PDB_END); + + *width = 0; + *height = 0; + *ascent = 0; + *descent = 0; + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + { + *width = return_vals[1].data.d_int32; + *height = return_vals[2].data.d_int32; + *ascent = return_vals[3].data.d_int32; + *descent = return_vals[4].data.d_int32; + } + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_text: + * @image_ID: The image. + * @drawable_ID: The affected drawable: (-1 for a new text layer). + * @x: The x coordinate for the left of the text bounding box. + * @y: The y coordinate for the top of the text bounding box. + * @text: The text to generate (in UTF-8 encoding). + * @border: The size of the border. + * @antialias: Antialiasing. + * @size: The size of text in either pixels or points. + * @size_type: The units of specified size. + * @foundry: The font foundry. + * @family: The font family. + * @weight: The font weight. + * @slant: The font slant. + * @set_width: The font set-width. + * @spacing: The font spacing. + * @registry: The font registry. + * @encoding: The font encoding. + * + * Deprecated: Use gimp_text_fontname() instead. + * + * Returns: The new text layer or -1 if no layer was created. + **/ +gint32 +gimp_text (gint32 image_ID, + gint32 drawable_ID, + gdouble x, + gdouble y, + const gchar *text, + gint border, + gboolean antialias, + gdouble size, + GimpSizeType size_type, + const gchar *foundry, + const gchar *family, + const gchar *weight, + const gchar *slant, + const gchar *set_width, + const gchar *spacing, + const gchar *registry, + const gchar *encoding) +{ + GimpParam *return_vals; + gint nreturn_vals; + gint32 text_layer_ID = -1; + + return_vals = gimp_run_procedure ("gimp-text", + &nreturn_vals, + GIMP_PDB_IMAGE, image_ID, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, x, + GIMP_PDB_FLOAT, y, + GIMP_PDB_STRING, text, + GIMP_PDB_INT32, border, + GIMP_PDB_INT32, antialias, + GIMP_PDB_FLOAT, size, + GIMP_PDB_INT32, size_type, + GIMP_PDB_STRING, foundry, + GIMP_PDB_STRING, family, + GIMP_PDB_STRING, weight, + GIMP_PDB_STRING, slant, + GIMP_PDB_STRING, set_width, + GIMP_PDB_STRING, spacing, + GIMP_PDB_STRING, registry, + GIMP_PDB_STRING, encoding, + GIMP_PDB_END); + + if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) + text_layer_ID = return_vals[1].data.d_layer; + + gimp_destroy_params (return_vals, nreturn_vals); + + return text_layer_ID; +} + +/** + * gimp_text_get_extents: + * @text: The text to generate (in UTF-8 encoding). + * @size: The size of text in either pixels or points. + * @size_type: The units of specified size. + * @foundry: The font foundry. + * @family: The font family. + * @weight: The font weight. + * @slant: The font slant. + * @set_width: The font set-width. + * @spacing: The font spacing. + * @registry: The font registry. + * @encoding: The font encoding. + * @width: The width of the specified font. + * @height: The height of the specified font. + * @ascent: The ascent of the specified font. + * @descent: The descent of the specified font. + * + * Deprecated: Use gimp_text_get_extents_fontname() instead. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_text_get_extents (const gchar *text, + gdouble size, + GimpSizeType size_type, + const gchar *foundry, + const gchar *family, + const gchar *weight, + const gchar *slant, + const gchar *set_width, + const gchar *spacing, + const gchar *registry, + const gchar *encoding, + gint *width, + gint *height, + gint *ascent, + gint *descent) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-text-get-extents", + &nreturn_vals, + GIMP_PDB_STRING, text, + GIMP_PDB_FLOAT, size, + GIMP_PDB_INT32, size_type, + GIMP_PDB_STRING, foundry, + GIMP_PDB_STRING, family, + GIMP_PDB_STRING, weight, + GIMP_PDB_STRING, slant, + GIMP_PDB_STRING, set_width, + GIMP_PDB_STRING, spacing, + GIMP_PDB_STRING, registry, + GIMP_PDB_STRING, encoding, + GIMP_PDB_END); + + *width = 0; + *height = 0; + *ascent = 0; + *descent = 0; + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + if (success) + { + *width = return_vals[1].data.d_int32; + *height = return_vals[2].data.d_int32; + *ascent = return_vals[3].data.d_int32; + *descent = return_vals[4].data.d_int32; + } + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} |