Constructor

GimpTextLayernew

since: 2.6

Declaration [src]

GimpTextLayer*
gimp_text_layer_new (
  GimpImage* image,
  const gchar* text,
  GimpFont* font,
  gdouble size,
  GimpUnit* unit
)

Description [src]

Creates a new text layer.

This procedure creates a new text layer displaying the specified text. By default the width and height of the layer will be determined by the text contents, the font, size and unit.

The new layer still needs to be added to the image as this is not automatic. Add the new layer with the gimp_image_insert_layer() method.

The arguments are kept as simple as necessary for the basic case. All text attributes, however, can be modified with the appropriate gimp_text_layer_set_*() procedures.

Available since: 2.6

Parameters

image

Type: GimpImage

The image.

The data is owned by the caller of the function.
text

Type: 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.
font

Type: GimpFont

The font to write the text with.

The data is owned by the caller of the function.
size

Type: gdouble

The size of text in either pixels or points.

unit

Type: GimpUnit

The units of specified size.

The data is owned by the caller of the function.

Return value

Type: GimpTextLayer

     The new text layer. The object belongs to libgimp and you should not free it.

The data is owned by the called function.