---
name: "tickit_renderbuffer_vtextf_at"
section: "3"
platform: "linux"
package: "libtickit-dev"
version: "0.4.3-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tickit_renderbuffer_vtextf_at"
---

# tickit\_renderbuffer\_vtextf\_at(3)

create text regions

## NAME

tickit\_renderbuffer\_text, tickit\_renderbuffer\_text\_at - create text regions

## SYNOPSIS

```
#include <tickit.h>

int tickit_renderbuffer_text(TickitRenderBuffer *rb,
        const char *text);
int tickit_renderbuffer_textn(TickitRenderBuffer *rb,
        const char *text, size_t len);
int tickit_renderbuffer_textf(TickitRenderBuffer *rb,
        const char *fmt, ...);
int tickit_renderbuffer_vtextf(TickitRenderBuffer *rb,
        const char *fmt, va_list args);

int tickit_renderbuffer_text_at(TickitRenderBuffer *rb,
        int line, int col, const char *text);
int tickit_renderbuffer_textn_at(TickitRenderBuffer *rb,
        int line, int col, const char *text, size_t len);
int tickit_renderbuffer_textf_at(TickitRenderBuffer *rb,
        int line, int col, const char *fmt, ...);
int tickit_renderbuffer_vtextf_at(TickitRenderBuffer *rb,
        int line, int col, const char *fmt, va_list args);
```

Link with *-ltickit*.

## DESCRIPTION

**tickit\_renderbuffer\_text**() creates a text region that starts at the current virtual cursor position, containing the given text string and set to the current pen. **tickit\_renderbuffer\_textn**() creates a text region of at most *len* bytes. It returns the number of columns that the text string occupies.  **tickit\_renderbuffer\_textf**() and **tickit\_renderbuffer\_vtextf**() take a format string in the style of [**sprintf**(3)](/sprintf/3.md) to create formatted text from either a list of arguments or a *va\_list*. These functions will update the virtual cursor position.

**tickit\_renderbuffer\_text\_at**(), **tickit\_renderbuffer\_textn\_at**(), **tickit\_renderbuffer\_textf\_at**() and **tickit\_renderbuffer\_vtextf\_at**() create a text region at the given position, and otherwise operate analogously to their non-**\_at** counterpart. These functions do not use or update the virtual cursor position.

Calls to any of these functions allocate storage owned by the *TickitRenderBuffer* instance itself to store the strings. This storage is released again by [**tickit\_renderbuffer\_reset**(3)](/tickit_renderbuffer_reset/3.md), the implicit reset that happens at the end of [**tickit\_renderbuffer\_flush\_to\_term**(3)](/tickit_renderbuffer_flush_to_term/3.md), or when every cell that was originally part of the region has been overwritten with other content.

## RETURN VALUE

These functions return an integer giving the number of columns the new region occupies.

## SEE ALSO

[**tickit\_renderbuffer\_new**(3)](/tickit_renderbuffer_new/3.md), [**tickit\_renderbuffer\_blit**(3)](/tickit_renderbuffer_blit/3.md), [**tickit\_renderbuffer\_flush\_to\_term**(3)](/tickit_renderbuffer_flush_to_term/3.md), [**tickit\_renderbuffer**(7)](/tickit_renderbuffer/7.md), [**tickit**(7)](/tickit/7.md)