mirror of https://github.com/GNOME/gimp.git
1218 lines
35 KiB
C
1218 lines
35 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimptextlayer_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 "stamp-pdbgen.h"
|
|
|
|
#include "gimp.h"
|
|
|
|
|
|
/**
|
|
* SECTION: gimptextlayer
|
|
* @title: gimptextlayer
|
|
* @short_description: Functions for querying and manipulating text layers.
|
|
*
|
|
* Functions for querying and manipulating text layers.
|
|
**/
|
|
|
|
|
|
/**
|
|
* _gimp_text_layer_new:
|
|
* @image: The image.
|
|
* @text: The text to generate (in UTF-8 encoding).
|
|
* @fontname: The name of the font.
|
|
* @size: The size of text in either pixels or points.
|
|
* @unit: The units of specified size.
|
|
*
|
|
* Creates a new text layer.
|
|
*
|
|
* This procedure creates a new text layer. The arguments are kept as
|
|
* simple as necessary for the normal case. All text attributes,
|
|
* however, can be modified with the appropriate
|
|
* gimp_text_layer_set_*() procedures. The new layer still needs to be
|
|
* added to the image, as this is not automatic. Add the new layer
|
|
* using gimp_image_insert_layer().
|
|
*
|
|
* Returns: (transfer none): The new text layer.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
GimpTextLayer *
|
|
_gimp_text_layer_new (GimpImage *image,
|
|
const gchar *text,
|
|
const gchar *fontname,
|
|
gdouble size,
|
|
GimpUnit unit)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpTextLayer *layer = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_IMAGE, image,
|
|
G_TYPE_STRING, text,
|
|
G_TYPE_STRING, fontname,
|
|
G_TYPE_DOUBLE, size,
|
|
GIMP_TYPE_UNIT, unit,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-new",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
layer = GIMP_VALUES_GET_TEXT_LAYER (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return layer;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_text:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the text from a text layer as string.
|
|
*
|
|
* This procedure returns the text from a text layer as a string.
|
|
*
|
|
* Returns: (transfer full): The text from the specified text layer.
|
|
* The returned value must be freed with g_free().
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gchar *
|
|
gimp_text_layer_get_text (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gchar *text = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-text",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
text = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return text;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_text:
|
|
* @layer: The text layer.
|
|
* @text: The new text to set.
|
|
*
|
|
* Set the text of a text layer.
|
|
*
|
|
* This procedure changes the text of a text layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_text (GimpTextLayer *layer,
|
|
const gchar *text)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_STRING, text,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-text",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_markup:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the markup from a text layer as string.
|
|
*
|
|
* This procedure returns the markup of the styles from a text layer.
|
|
* The markup will be in the form of Pango's markup - See
|
|
* https://www.pango.org/ for more information about Pango and its
|
|
* markup.
|
|
*
|
|
* Returns: (transfer full):
|
|
* The markup which represents the style of the specified text layer.
|
|
* The returned value must be freed with g_free().
|
|
*
|
|
* Since: 2.8
|
|
**/
|
|
gchar *
|
|
gimp_text_layer_get_markup (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gchar *markup = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-markup",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
markup = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return markup;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_markup:
|
|
* @layer: The text layer.
|
|
* @markup: The new markup to set.
|
|
*
|
|
* Set the markup for a text layer from a string.
|
|
*
|
|
* This procedure sets the markup of the styles for a text layer. The
|
|
* markup should be in the form of Pango's markup - See
|
|
* https://docs.gtk.org/Pango/pango_markup.html for a reference.
|
|
* Note that GIMP's text tool does not support all of Pango markup. Any
|
|
* unsupported markup will still be applied to your text layer, yet
|
|
* would be dropped as soon as you edit text with the tool.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 3.0
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_markup (GimpTextLayer *layer,
|
|
const gchar *markup)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_STRING, markup,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-markup",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_font:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the font from a text layer as string.
|
|
*
|
|
* This procedure returns the name of the font from a text layer.
|
|
*
|
|
* Returns: (transfer full):
|
|
* The font which is used in the specified text layer.
|
|
* The returned value must be freed with g_free().
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gchar *
|
|
gimp_text_layer_get_font (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gchar *font = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-font",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
font = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return font;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_font:
|
|
* @layer: The text layer.
|
|
* @font: The new font to use.
|
|
*
|
|
* Set the font of a text layer.
|
|
*
|
|
* This procedure modifies the font used in the specified text layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_font (GimpTextLayer *layer,
|
|
const gchar *font)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_STRING, font,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-font",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_font_size:
|
|
* @layer: The text layer.
|
|
* @unit: (out) (transfer none): The unit used for the font size.
|
|
*
|
|
* Get the font size from a text layer.
|
|
*
|
|
* This procedure returns the size of the font which is used in a text
|
|
* layer. You will receive the size as a float 'font-size' in 'unit'
|
|
* units.
|
|
*
|
|
* Returns: The font size.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gdouble
|
|
gimp_text_layer_get_font_size (GimpTextLayer *layer,
|
|
GimpUnit *unit)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gdouble font_size = 0.0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-font-size",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
{
|
|
font_size = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
*unit = GIMP_VALUES_GET_INT (return_vals, 2);
|
|
}
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return font_size;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_font_size:
|
|
* @layer: The text layer.
|
|
* @font_size: The font size.
|
|
* @unit: The unit to use for the font size.
|
|
*
|
|
* Set the font size.
|
|
*
|
|
* This procedure changes the font size of a text layer. The size of
|
|
* your font will be a double 'font-size' of 'unit' units.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_font_size (GimpTextLayer *layer,
|
|
gdouble font_size,
|
|
GimpUnit unit)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_DOUBLE, font_size,
|
|
GIMP_TYPE_UNIT, unit,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-font-size",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_antialias:
|
|
* @layer: The text layer.
|
|
*
|
|
* Check if antialiasing is used in the text layer.
|
|
*
|
|
* This procedure checks if antialiasing is enabled in the specified
|
|
* text layer.
|
|
*
|
|
* Returns: A flag which is true if antialiasing is used for rendering the font in the text layer.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_get_antialias (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean antialias = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-antialias",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
antialias = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return antialias;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_antialias:
|
|
* @layer: The text layer.
|
|
* @antialias: Enable/disable antialiasing of the text.
|
|
*
|
|
* Enable/disable anti-aliasing in a text layer.
|
|
*
|
|
* This procedure enables or disables anti-aliasing of the text in a
|
|
* text layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_antialias (GimpTextLayer *layer,
|
|
gboolean antialias)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_BOOLEAN, antialias,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-antialias",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_hint_style:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get information about hinting in the specified text layer.
|
|
*
|
|
* This procedure provides information about the hinting that is being
|
|
* used in a text layer. Hinting can be optimized for fidelity or
|
|
* contrast or it can be turned entirely off.
|
|
*
|
|
* Returns: The hint style used for font outlines.
|
|
*
|
|
* Since: 2.8
|
|
**/
|
|
GimpTextHintStyle
|
|
gimp_text_layer_get_hint_style (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpTextHintStyle style = 0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-hint-style",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
style = GIMP_VALUES_GET_ENUM (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return style;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_hint_style:
|
|
* @layer: The text layer.
|
|
* @style: The new hint style.
|
|
*
|
|
* Control how font outlines are hinted in a text layer.
|
|
*
|
|
* This procedure sets the hint style for font outlines in a text
|
|
* layer. This controls whether to fit font outlines to the pixel grid,
|
|
* and if so, whether to optimize for fidelity or contrast.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.8
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_hint_style (GimpTextLayer *layer,
|
|
GimpTextHintStyle style)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
GIMP_TYPE_TEXT_HINT_STYLE, style,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-hint-style",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_kerning:
|
|
* @layer: The text layer.
|
|
*
|
|
* Check if kerning is used in the text layer.
|
|
*
|
|
* This procedure checks if kerning is enabled in the specified text
|
|
* layer.
|
|
*
|
|
* Returns: A flag which is true if kerning is used in the text layer.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_get_kerning (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean kerning = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-kerning",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
kerning = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return kerning;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_kerning:
|
|
* @layer: The text layer.
|
|
* @kerning: Enable/disable kerning in the text.
|
|
*
|
|
* Enable/disable kerning in a text layer.
|
|
*
|
|
* This procedure enables or disables kerning in a text layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_kerning (GimpTextLayer *layer,
|
|
gboolean kerning)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_BOOLEAN, kerning,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-kerning",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_language:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the language used in the text layer.
|
|
*
|
|
* This procedure returns the language string which is set for the text
|
|
* in the text layer.
|
|
*
|
|
* Returns: (transfer full): The language used in the text layer.
|
|
* The returned value must be freed with g_free().
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gchar *
|
|
gimp_text_layer_get_language (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gchar *language = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-language",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
language = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return language;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_language:
|
|
* @layer: The text layer.
|
|
* @language: The new language to use for the text layer.
|
|
*
|
|
* Set the language of the text layer.
|
|
*
|
|
* This procedure sets the language of the text in text layer. For some
|
|
* scripts the language has an influence of how the text is rendered.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_language (GimpTextLayer *layer,
|
|
const gchar *language)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_STRING, language,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-language",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_base_direction:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the base direction used for rendering the text layer.
|
|
*
|
|
* This procedure returns the base direction used for rendering the
|
|
* text in the text layer
|
|
*
|
|
* Returns: The based direction used for the text layer.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
GimpTextDirection
|
|
gimp_text_layer_get_base_direction (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpTextDirection direction = 0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-base-direction",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
direction = GIMP_VALUES_GET_ENUM (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return direction;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_base_direction:
|
|
* @layer: The text layer.
|
|
* @direction: The base direction of the text.
|
|
*
|
|
* Set the base direction in the text layer.
|
|
*
|
|
* This procedure sets the base direction used in applying the Unicode
|
|
* bidirectional algorithm when rendering the text.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_base_direction (GimpTextLayer *layer,
|
|
GimpTextDirection direction)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
GIMP_TYPE_TEXT_DIRECTION, direction,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-base-direction",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_justification:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the text justification information of the text layer.
|
|
*
|
|
* This procedure returns the alignment of the lines in the text layer
|
|
* relative to each other.
|
|
*
|
|
* Returns: The justification used in the text layer.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
GimpTextJustification
|
|
gimp_text_layer_get_justification (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpTextJustification justify = 0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-justification",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
justify = GIMP_VALUES_GET_ENUM (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return justify;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_justification:
|
|
* @layer: The text layer.
|
|
* @justify: The justification for your text.
|
|
*
|
|
* Set the justification of the text in a text layer.
|
|
*
|
|
* This procedure sets the alignment of the lines in the text layer
|
|
* relative to each other.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_justification (GimpTextLayer *layer,
|
|
GimpTextJustification justify)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
GIMP_TYPE_TEXT_JUSTIFICATION, justify,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-justification",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_color:
|
|
* @layer: The text layer.
|
|
* @color: (out caller-allocates): The color of the text.
|
|
*
|
|
* Get the color of the text in a text layer.
|
|
*
|
|
* This procedure returns the color of the text in a text layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_get_color (GimpTextLayer *layer,
|
|
GimpRGB *color)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-color",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
GIMP_VALUES_GET_RGB (return_vals, 1, &*color);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_color:
|
|
* @layer: The text layer.
|
|
* @color: The color to use for the text.
|
|
*
|
|
* Set the color of the text in the text layer.
|
|
*
|
|
* This procedure sets the text color in the text layer 'layer'.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_color (GimpTextLayer *layer,
|
|
const GimpRGB *color)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
GIMP_TYPE_RGB, color,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-color",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_indent:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the line indentation of text layer.
|
|
*
|
|
* This procedure returns the indentation of the first line in a text
|
|
* layer.
|
|
*
|
|
* Returns: The indentation value of the first line.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gdouble
|
|
gimp_text_layer_get_indent (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gdouble indent = 0.0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-indent",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
indent = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return indent;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_indent:
|
|
* @layer: The text layer.
|
|
* @indent: The indentation for the first line.
|
|
*
|
|
* Set the indentation of the first line in a text layer.
|
|
*
|
|
* This procedure sets the indentation of the first line in the text
|
|
* layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_indent (GimpTextLayer *layer,
|
|
gdouble indent)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_DOUBLE, indent,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-indent",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_line_spacing:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the spacing between lines of text.
|
|
*
|
|
* This procedure returns the line-spacing between lines of text in a
|
|
* text layer.
|
|
*
|
|
* Returns: The line-spacing value.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gdouble
|
|
gimp_text_layer_get_line_spacing (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gdouble line_spacing = 0.0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-line-spacing",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
line_spacing = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return line_spacing;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_line_spacing:
|
|
* @layer: The text layer.
|
|
* @line_spacing: The additional line spacing to use.
|
|
*
|
|
* Adjust the line spacing in a text layer.
|
|
*
|
|
* This procedure sets the additional spacing used between lines a text
|
|
* layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_line_spacing (GimpTextLayer *layer,
|
|
gdouble line_spacing)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_DOUBLE, line_spacing,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-line-spacing",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_get_letter_spacing:
|
|
* @layer: The text layer.
|
|
*
|
|
* Get the letter spacing used in a text layer.
|
|
*
|
|
* This procedure returns the additional spacing between the single
|
|
* glyphs in a text layer.
|
|
*
|
|
* Returns: The letter-spacing value.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gdouble
|
|
gimp_text_layer_get_letter_spacing (GimpTextLayer *layer)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gdouble letter_spacing = 0.0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-get-letter-spacing",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
letter_spacing = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return letter_spacing;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_set_letter_spacing:
|
|
* @layer: The text layer.
|
|
* @letter_spacing: The additional letter spacing to use.
|
|
*
|
|
* Adjust the letter spacing in a text layer.
|
|
*
|
|
* This procedure sets the additional spacing between the single glyphs
|
|
* in a text layer.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_set_letter_spacing (GimpTextLayer *layer,
|
|
gdouble letter_spacing)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_DOUBLE, letter_spacing,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-set-letter-spacing",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_text_layer_resize:
|
|
* @layer: The text layer.
|
|
* @width: The new box width in pixels.
|
|
* @height: The new box height in pixels.
|
|
*
|
|
* Resize the box of a text layer.
|
|
*
|
|
* This procedure changes the width and height of a text layer while
|
|
* keeping it as a text layer and not converting it to a bitmap like
|
|
* gimp_layer_resize() would do.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.8
|
|
**/
|
|
gboolean
|
|
gimp_text_layer_resize (GimpTextLayer *layer,
|
|
gdouble width,
|
|
gdouble height)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_TEXT_LAYER, layer,
|
|
G_TYPE_DOUBLE, width,
|
|
G_TYPE_DOUBLE, height,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-text-layer-resize",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|