gimp-text-fontname

Martin Edlman & Sven Neumann

Description

Add text at the specified location as a floating selection or a new layer.

Help

This tool requires a fontname matching an installed PangoFT2 font. You can specify the fontsize in units of pixels or points, and the appropriate metric is specified using the size_type argument. The x and y parameters together control the placement of the new text by specifying the upper left corner of the text bounding box. If the specified drawable parameter is valid, the text will be created as a floating selection attached to the drawable. If the drawable parameter is not valid (-1), the text will appear as a new layer. Finally, a border can be specified around the final rendered text. The border is measured in pixels. Parameter size-type is not used and is currently ignored. If you need to display a font in points, divide the size in points by 72.0 and multiply it by the image's vertical resolution.


Type

unknown

Parameters

Type Name Description
PF_IMAGE image The image
PF_DRAWABLE drawable The affected drawable: (-1 for a new text layer)
PF_FLOAT x The x coordinate for the left of the text bounding box
PF_FLOAT y The y coordinate for the top of the text bounding box
PF_VALUE text The text to generate (in UTF-8 encoding)
PF_INT border The size of the border (border >= -1)
PF_INT antialias Antialiasing (TRUE or FALSE)
PF_FLOAT size The size of text in either pixels or points (size >= 0)
PF_INT size-type The units of specified size { PIXELS (0), POINTS (1) }
PF_VALUE fontname The name of the font

Return

Type Name Description
PF_LAYER text-layer The new text layer or -1 if no layer was created.