gimp_text_get_extents (1998)

NAME

gimp_text_get_extents - Get extents of the bounding box for the specified text.

SYNOPSIS

(width,height,ascent,descent) = gimp_text_get_extents (text,size,size_type,foundry,family,weight,slant,set_width,spacing,registry,encoding)

DESCRIPTION

This tool returns the width and height of a bounding box for the specified text string with the specified font information. Ascent and descent for the specified font are returned as well.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
STRING	text	The text to generate
FLOAT	size	The size of text in either pixels or points
INT32	size_type	The units of specified size: PIXELS (0) or POINTS (1)
STRING	foundry	The font foundry, "*" for any
STRING	family	The font family, "*" for any
STRING	weight	The font weight, "*" for any
STRING	slant	The font slant, "*" for any
STRING	set_width	The font set-width, "*" for any
STRING	spacing	The font spacing, "*" for any
STRING	registry	The font registry, "*" for any
STRING	encoding	The font encoding, "*" for any

RETURN VALUES

TYPE	NAME	DESCRIPTION
INT32	width	The width of the specified font
INT32	height	The height of the specified font
INT32	ascent	The ascent of the specified font
INT32	descent	The descent of the specified font

SOME SYNTAX ALTERNATIVES

(width,height,ascent,descent) = Gimp->text_get_extents (text,size,size_type,foundry,family,weight,slant,set_width,spacing,registry,encoding)
(width,height,ascent,descent) = text_get_extents Layer (text,size,size_type,foundry,family,weight,slant,set_width,spacing,registry,encoding)
(width,height,ascent,descent) = text_get_extents Image (text,size,size_type,foundry,family,weight,slant,set_width,spacing,registry,encoding)
(width,height,ascent,descent) = text_get_extents Channel (text,size,size_type,foundry,family,weight,slant,set_width,spacing,registry,encoding)
(width,height,ascent,descent) = text_get_extents Display (text,size,size_type,foundry,family,weight,slant,set_width,spacing,registry,encoding)
(width,height,ascent,descent) = text_get_extents Drawable (text,size,size_type,foundry,family,weight,slant,set_width,spacing,registry,encoding)

AUTHOR

Martin Edlman
(c)1998 Spencer Kimball & Peter Mattis