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:
GimpImageThe 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:
GimpFontThe font to write the text with.
The data is owned by the caller of the function. size-
Type:
gdoubleThe size of text in either pixels or points.
unit-
Type:
GimpUnitThe 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. |