Function

Gimptext_layer_new

Declaration [src]

GimpLayer*
gimp_text_layer_new (
  GimpImage* image,
  const gchar* text,
  const gchar* fontname,
  gdouble size,
  GimpUnit unit
)

Description [src]

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().

Available since:2.6

Parameters

image GimpImage
 

The image.

 The data is owned by the caller of the function.
text const gchar*
 

The text to generate (in UTF-8 encoding).

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
fontname const gchar*
 

The name of the font.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
size gdouble
 

The size of text in either pixels or points.

unit GimpUnit
 

The units of specified size.

Return value

Returns: GimpLayer
 

The new text layer.

 The data is owned by the called function.