.\" Generated by scdoc 1.11.0
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "fcft_clone" "3" "2020-11-07" "2.3.1" "fcft"
.P
.SH NAME
.P
fcft_clone - copy an already instantiated font
.P
.SH SYNOPSIS
.P
\fB#include <fcft/fcft.h>\fR
.P
\fBstruct fcft_font *fcft_clone(const struct fcft_font *\fR\fIfont\fR\fB);\fR
.P
.P
.SH DESCRIPTION
.P
\fBfcft_clone\fR() creates a new instance by copying \fIfont\fR. fcft
internally uses reference counting, making this operation very fast
(much faster than explicitly instantiating a new font using
\fBfcft_from_name\fR(3)).
.P
To free all resources associated with the both the original font, and
the cloned font, \fBfcft_destroy\fR(3) must be called for \fBboth\fR the
original font, \fBand\fR the clone.
.P
.SH RETURN VALUE
.P
On success, \fBfcft_clone\fR() returns a pointer to a new \fBfcft_font\fR
object. On error, NULL is returned.
.P
.SH SEE ALSO
.P
\fBfcft_from_name\fR(3), \fBfcft_destroy\fR(3)