---
name: "tickit_renderbuffer_new"
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_new"
---

# tickit\_renderbuffer\_new(3)

create a new render buffer instance

## NAME

tickit\_renderbuffer\_new - create a new render buffer instance

## SYNOPSIS

```
#include <tickit.h>

TickitRenderBuffer *tickit_renderbuffer_new(int lines, int cols);
```

Link with *-ltickit*.

## DESCRIPTION

**tickit\_renderbuffer\_new**() creates a new **TickitRenderBuffer** instance of the given size. Once constructed, the size is fixed. Initially it has a clipping region covering the entire area, a zero translation offset, no applied masks, no stored pen and no virtual cursor position. It can be reset back to this state at any time by calling [**tickit\_renderbuffer\_reset**(3)](/tickit_renderbuffer_reset/3.md).

The reference count of a newly-constructed render buffer instance will be one. This can be incremented or decremented using [**tickit\_renderbuffer\_ref**(3)](/tickit_renderbuffer_ref/3.md) and [**tickit\_renderbuffer\_unref**(3)](/tickit_renderbuffer_unref/3.md). When its reference count reaches zero it is destroyed.

## RETURN VALUE

If successful, **tickit\_renderbuffer\_new**() returns a pointer to the new instance.

## SEE ALSO

[**tickit\_renderbuffer\_text**(3)](/tickit_renderbuffer_text/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)