user: Describe Drawing Text to an Image from the Blender manual or Python API, including usage steps and snippets.

assistant: Example showing how text can be draw into an image.
This can be done by binding an image buffer ([`imbuf`](imbuf.html#module-imbuf "imbuf")) to the font’s ID.

```
import blf
import imbuf

image_size = 512, 512
font_size = 20

ibuf = imbuf.new(image_size)

font_id = blf.load("/path/to/font.ttf")

blf.color(font_id, 1.0, 1.0, 1.0, 1.0)
blf.size(font_id, font_size)
blf.position(font_id, 0, image_size[0] - font_size, 0)

blf.enable(font_id, blf.WORD_WRAP)
blf.word_wrap(font_id, image_size[0])

with blf.bind_imbuf(font_id, ibuf, display_name="sRGB"):
    blf.draw_buffer(font_id, "Lots of wrapped text. " * 50)

imbuf.write(ibuf, filepath="/path/to/image.png")
```

blf.aspect(*fontid*, *aspect*)
:   Set the aspect for drawing text.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "blf.load"), for default font use 0.
        - **aspect** (*float*) – The aspect ratio for text drawing to use.

blf.bind_imbuf(*fontid*, *image*)
:   Context manager to draw text into an image buffer instead of the GPU’s context.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "blf.load"), for default font use 0.
        - **imbuf** (`imbuf.types.ImBuf`) – The image to draw into.

    Returns:
    :   The BLF ImBuf context manager.

    Return type:
    :   BLFImBufContext

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()`](#blf.load "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.color(*fontid*, *r*, *g*, *b*, *a*)
:   Set the color for drawing text.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "blf.load"), for default font use 0.
        - **r** (*float*) – red channel 0.0 - 1.0.
        - **g** (*float*) – green channel 0.0 - 1.0.
        - **b** (*float*) – blue channel 0.0 - 1.0.
        - **a** (*float*) – alpha channel 0.0 - 1.0.

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()`](#blf.load "blf.load"), for default font use 0.
        - **text** (*str*) – the text to draw.

    Returns:
    :   the width and height of the text.

    Return type:
    :   tuple[float, float]

blf.disable(*fontid*, *option*)
:   Disable option.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "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()`](#blf.load "blf.load"), for default font use 0.
        - **text** (*str*) – the text to draw.

blf.draw_buffer(*fontid*, *text*)
:   Draw text into the buffer bound to the fontid.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "blf.load"), for default font use 0.
        - **text** (*str*) – the text to draw.

blf.enable(*fontid*, *option*)
:   Enable option.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "blf.load"), for default font use 0.
        - **option** (*int*) – One of ROTATION, CLIPPING, SHADOW or KERNING_DEFAULT.

blf.load(*filepath*)
:   Load a new font.

    Parameters:
    :   **filepath** (*str* *|* *bytes*) – the filepath of the font.

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

    Return type:
    :   int

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()`](#blf.load "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()`](#blf.load "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()`](#blf.load "blf.load"), for default font use 0.
        - **level** (*int*) – The blur level (0, 3, 5) or outline (6).
        - **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()`](#blf.load "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*)
:   Set the size for drawing text.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "blf.load"), for default font use 0.
        - **size** (*float*) – Point size of the font.

blf.unload(*filepath*)
:   Unload an existing font.

    Parameters:
    :   **filepath** (*str* *|* *bytes*) – the filepath of the font.

blf.word_wrap(*fontid*, *wrap_width*)
:   Set the wrap width, enable/disable using WORD_WRAP.

    Parameters:
    :   - **fontid** (*int*) – The id of the typeface as returned by [`blf.load()`](#blf.load "blf.load"), for default font use 0.
        - **wrap_width** (*int*) – The width (in pixels) to wrap words at.

blf.CLIPPING
:   Constant value 2

blf.MONOCHROME
:   Constant value 128

blf.ROTATION
:   Constant value 1

blf.SHADOW
:   Constant value 4

blf.WORD_WRAP
:   Constant value 64