dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/libgimp/gimptextlayer_pdb.c

1122 lines
30 KiB
C
Raw Blame History

/* 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
* <http://www.gnu.org/licenses/>.
*/
/* NOTE: This file is auto-generated by pdbgen.pl */
#include "config.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_ID: 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: The new text layer.
*
* Since: GIMP 2.6
**/
gint32
gimp_text_layer_new (gint32 image_ID,
const gchar *text,
const gchar *fontname,
gdouble size,
GimpUnit unit)
{
GimpParam *return_vals;
gint nreturn_vals;
gint32 layer_ID = -1;
return_vals = gimp_run_procedure ("gimp-text-layer-new",
&nreturn_vals,
GIMP_PDB_IMAGE, image_ID,
GIMP_PDB_STRING, text,
GIMP_PDB_STRING, fontname,
GIMP_PDB_FLOAT, size,
GIMP_PDB_INT32, unit,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
layer_ID = return_vals[1].data.d_layer;
gimp_destroy_params (return_vals, nreturn_vals);
return layer_ID;
}
/**
* gimp_text_layer_get_text:
* @layer_ID: 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: The text from the specified text layer.
*
* Since: GIMP 2.6
**/
gchar *
gimp_text_layer_get_text (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gchar *text = NULL;
return_vals = gimp_run_procedure ("gimp-text-layer-get-text",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
text = g_strdup (return_vals[1].data.d_string);
gimp_destroy_params (return_vals, nreturn_vals);
return text;
}
/**
* gimp_text_layer_set_text:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_text (gint32 layer_ID,
const gchar *text)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-text",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_STRING, text,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_markup:
* @layer_ID: 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
* http://www.pango.org/ for more information about Pango and its
* markup. Note: Setting the markup of a text layer using Pango's
* markup is not supported for now.
*
* Returns: The markup which represents the style of the specified text
* layer.
*
* Since: GIMP 2.8
**/
gchar *
gimp_text_layer_get_markup (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gchar *markup = NULL;
return_vals = gimp_run_procedure ("gimp-text-layer-get-markup",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
markup = g_strdup (return_vals[1].data.d_string);
gimp_destroy_params (return_vals, nreturn_vals);
return markup;
}
/**
* gimp_text_layer_get_font:
* @layer_ID: 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: The font which is used in the specified text layer.
*
* Since: GIMP 2.6
**/
gchar *
gimp_text_layer_get_font (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gchar *font = NULL;
return_vals = gimp_run_procedure ("gimp-text-layer-get-font",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
font = g_strdup (return_vals[1].data.d_string);
gimp_destroy_params (return_vals, nreturn_vals);
return font;
}
/**
* gimp_text_layer_set_font:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_font (gint32 layer_ID,
const gchar *font)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-font",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_STRING, font,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_font_size:
* @layer_ID: The text layer.
* @unit: 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: GIMP 2.6
**/
gdouble
gimp_text_layer_get_font_size (gint32 layer_ID,
GimpUnit *unit)
{
GimpParam *return_vals;
gint nreturn_vals;
gdouble font_size = 0.0;
return_vals = gimp_run_procedure ("gimp-text-layer-get-font-size",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
{
font_size = return_vals[1].data.d_float;
*unit = return_vals[2].data.d_unit;
}
gimp_destroy_params (return_vals, nreturn_vals);
return font_size;
}
/**
* gimp_text_layer_set_font_size:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_font_size (gint32 layer_ID,
gdouble font_size,
GimpUnit unit)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-font-size",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_FLOAT, font_size,
GIMP_PDB_INT32, unit,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_antialias:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_get_antialias (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean antialias = FALSE;
return_vals = gimp_run_procedure ("gimp-text-layer-get-antialias",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
antialias = return_vals[1].data.d_int32;
gimp_destroy_params (return_vals, nreturn_vals);
return antialias;
}
/**
* gimp_text_layer_set_antialias:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_antialias (gint32 layer_ID,
gboolean antialias)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-antialias",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_INT32, antialias,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_hint_style:
* @layer_ID: 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: GIMP 2.8
**/
GimpTextHintStyle
gimp_text_layer_get_hint_style (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
GimpTextHintStyle style = 0;
return_vals = gimp_run_procedure ("gimp-text-layer-get-hint-style",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
style = return_vals[1].data.d_int32;
gimp_destroy_params (return_vals, nreturn_vals);
return style;
}
/**
* gimp_text_layer_set_hint_style:
* @layer_ID: 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: GIMP 2.8
**/
gboolean
gimp_text_layer_set_hint_style (gint32 layer_ID,
GimpTextHintStyle style)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-hint-style",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_INT32, style,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_kerning:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_get_kerning (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean kerning = FALSE;
return_vals = gimp_run_procedure ("gimp-text-layer-get-kerning",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
kerning = return_vals[1].data.d_int32;
gimp_destroy_params (return_vals, nreturn_vals);
return kerning;
}
/**
* gimp_text_layer_set_kerning:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_kerning (gint32 layer_ID,
gboolean kerning)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-kerning",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_INT32, kerning,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_language:
* @layer_ID: 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: The language used in the text layer.
*
* Since: GIMP 2.6
**/
gchar *
gimp_text_layer_get_language (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gchar *language = NULL;
return_vals = gimp_run_procedure ("gimp-text-layer-get-language",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
language = g_strdup (return_vals[1].data.d_string);
gimp_destroy_params (return_vals, nreturn_vals);
return language;
}
/**
* gimp_text_layer_set_language:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_language (gint32 layer_ID,
const gchar *language)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-language",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_STRING, language,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_base_direction:
* @layer_ID: 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: GIMP 2.6
**/
GimpTextDirection
gimp_text_layer_get_base_direction (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
GimpTextDirection direction = 0;
return_vals = gimp_run_procedure ("gimp-text-layer-get-base-direction",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
direction = return_vals[1].data.d_int32;
gimp_destroy_params (return_vals, nreturn_vals);
return direction;
}
/**
* gimp_text_layer_set_base_direction:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_base_direction (gint32 layer_ID,
GimpTextDirection direction)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-base-direction",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_INT32, direction,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_justification:
* @layer_ID: 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: GIMP 2.6
**/
GimpTextJustification
gimp_text_layer_get_justification (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
GimpTextJustification justify = 0;
return_vals = gimp_run_procedure ("gimp-text-layer-get-justification",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
justify = return_vals[1].data.d_int32;
gimp_destroy_params (return_vals, nreturn_vals);
return justify;
}
/**
* gimp_text_layer_set_justification:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_justification (gint32 layer_ID,
GimpTextJustification justify)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-justification",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_INT32, justify,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_color:
* @layer_ID: The text layer.
* @color: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_get_color (gint32 layer_ID,
GimpRGB *color)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-get-color",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
if (success)
*color = return_vals[1].data.d_color;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_set_color:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_color (gint32 layer_ID,
const GimpRGB *color)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-color",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_COLOR, color,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_indent:
* @layer_ID: 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: GIMP 2.6
**/
gdouble
gimp_text_layer_get_indent (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gdouble indent = 0.0;
return_vals = gimp_run_procedure ("gimp-text-layer-get-indent",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
indent = return_vals[1].data.d_float;
gimp_destroy_params (return_vals, nreturn_vals);
return indent;
}
/**
* gimp_text_layer_set_indent:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_indent (gint32 layer_ID,
gdouble indent)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-indent",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_FLOAT, indent,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_line_spacing:
* @layer_ID: 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: GIMP 2.6
**/
gdouble
gimp_text_layer_get_line_spacing (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gdouble line_spacing = 0.0;
return_vals = gimp_run_procedure ("gimp-text-layer-get-line-spacing",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
line_spacing = return_vals[1].data.d_float;
gimp_destroy_params (return_vals, nreturn_vals);
return line_spacing;
}
/**
* gimp_text_layer_set_line_spacing:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_line_spacing (gint32 layer_ID,
gdouble line_spacing)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-line-spacing",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_FLOAT, line_spacing,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_letter_spacing:
* @layer_ID: The text layer.
*
* Get the letter spacing used in a text layer.
*
* This procedure returns the additional spacing between the single
* glyps in a text layer.
*
* Returns: The letter-spacing value.
*
* Since: GIMP 2.6
**/
gdouble
gimp_text_layer_get_letter_spacing (gint32 layer_ID)
{
GimpParam *return_vals;
gint nreturn_vals;
gdouble letter_spacing = 0.0;
return_vals = gimp_run_procedure ("gimp-text-layer-get-letter-spacing",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
letter_spacing = return_vals[1].data.d_float;
gimp_destroy_params (return_vals, nreturn_vals);
return letter_spacing;
}
/**
* gimp_text_layer_set_letter_spacing:
* @layer_ID: 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: GIMP 2.6
**/
gboolean
gimp_text_layer_set_letter_spacing (gint32 layer_ID,
gdouble letter_spacing)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-letter-spacing",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_FLOAT, letter_spacing,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_resize:
* @layer_ID: 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: GIMP 2.8
**/
gboolean
gimp_text_layer_resize (gint32 layer_ID,
gdouble width,
gdouble height)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-resize",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_FLOAT, width,
GIMP_PDB_FLOAT, height,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
/**
* gimp_text_layer_get_hinting:
* @layer_ID: The text layer.
* @autohint: A flag which is true if the text layer is forced to use the autohinter from FreeType.
*
* Deprecated: Use gimp_text_layer_get_hint_style() instead.
*
* Returns: A flag which is true if hinting is used on the font.
**/
gboolean
gimp_text_layer_get_hinting (gint32 layer_ID,
gboolean *autohint)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean hinting = FALSE;
return_vals = gimp_run_procedure ("gimp-text-layer-get-hinting",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_END);
if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
{
hinting = return_vals[1].data.d_int32;
*autohint = return_vals[2].data.d_int32;
}
gimp_destroy_params (return_vals, nreturn_vals);
return hinting;
}
/**
* gimp_text_layer_set_hinting:
* @layer_ID: The text layer.
* @hinting: Enable/disable the use of hinting on the text.
* @autohint: Force the use of the autohinter provided through FreeType.
*
* Deprecated: Use gimp_text_layer_set_hint_style() instead.
*
* Returns: TRUE on success.
*
* Since: GIMP 2.6
**/
gboolean
gimp_text_layer_set_hinting (gint32 layer_ID,
gboolean hinting,
gboolean autohint)
{
GimpParam *return_vals;
gint nreturn_vals;
gboolean success = TRUE;
return_vals = gimp_run_procedure ("gimp-text-layer-set-hinting",
&nreturn_vals,
GIMP_PDB_LAYER, layer_ID,
GIMP_PDB_INT32, hinting,
GIMP_PDB_INT32, autohint,
GIMP_PDB_END);
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
gimp_destroy_params (return_vals, nreturn_vals);
return success;
}
Reference in New Issue View Git Blame Copy Permalink