.\" Generated by scdoc 1.11.2
.\" 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" "2024-02-01" "3.1.7" "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()).\&
.P
To free all resources associated with the both the original font, and
the cloned font, \fBfcft_destroy\fR() 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(), \fBfcft_destroy\fR()