Font Drawing (blf)

This module provides access to blenders text drawing functions.

blf.CLIPPING

constant value 2

blf.KERNING_DEFAULT

constant value 8

blf.ROTATION

constant value 1

blf.SHADOW

constant value 4

blf.aspect(fontid, aspect)

Set the aspect for drawing text.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • aspect (float) – The aspect ratio for text drawing to use.
blf.blur(fontid, radius)

Set the blur radius for drawing text.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • radius (int) – The radius for blurring text (in pixels).
blf.clipping(fontid, xmin, ymin, xmax, ymax)

Set the clipping, enable/disable using CLIPPING.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • xmin (float) – Clip the drawing area by these bounds.
  • ymin (float) – Clip the drawing area by these bounds.
  • xmax (float) – Clip the drawing area by these bounds.
  • ymax (float) – Clip the drawing area by these bounds.
blf.dimensions(fontid, text)

Return the width and height of the text.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • text (string) – the text to draw.
Returns:

the width and height of the text.

Return type:

tuple of 2 floats

blf.disable(fontid, option)

Disable option.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • option (int) – One of ROTATION, CLIPPING, SHADOW or KERNING_DEFAULT.
blf.draw(fontid, text)

Draw text in the current context.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • text (string) – the text to draw.
blf.enable(fontid, option)

Enable option.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • option (int) – One of ROTATION, CLIPPING, SHADOW or KERNING_DEFAULT.
blf.load(filename)

Load a new font.

Parameters:
  • filename (string) – the filename of the font.
Returns:

the new font’s fontid or -1 if there was an error.

Return type:

integer

blf.position(fontid, x, y, z)

Set the position for drawing text.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • x (float) – X axis position to draw the text.
  • y (float) – Y axis position to draw the text.
  • z (float) – Z axis position to draw the text.
blf.rotation(fontid, angle)

Set the text rotation angle, enable/disable using ROTATION.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • angle (float) – The angle for text drawing to use.
blf.shadow(fontid, level, r, g, b, a)

Shadow options, enable/disable using SHADOW .

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • level (int) – The blur level, can be 3, 5 or 0.
  • r (float) – Shadow color (red channel 0.0 - 1.0).
  • g (float) – Shadow color (green channel 0.0 - 1.0).
  • b (float) – Shadow color (blue channel 0.0 - 1.0).
  • a (float) – Shadow color (alpha channel 0.0 - 1.0).
blf.shadow_offset(fontid, x, y)

Set the offset for shadow text.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • x (float) – Vertical shadow offset value in pixels.
  • y (float) – Horizontal shadow offset value in pixels.
blf.size(fontid, size, dpi)

Set the size and dpi for drawing text.

Parameters:
  • fontid (int) – The id of the typeface as returned by blf.load(), for default font use 0.
  • size (int) – Point size of the font.
  • dpi (int) – dots per inch value to use for drawing.

Previous topic

Math Types & Utilities (mathutils)

Next topic

Audio System (aud)