.\" Generated by scdoc 1.11.3
.\" 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_precompose" "3" "2025-01-02" "3.1.10" "fcft"
.PP
.SH NAME
.PP
fcft_precompose - pre-compose two wide characters into one
.PP
.SH SYNOPSIS
.PP
\fB#include <fcft/fcft.\&h>\fR
.PP
\fBbool fcft_precompose(\fR
.RS 4
\fBconst struct fcft_font *\fR\fIfont\fR\fB,\fR
\fBuint32_t \fR\fIbase\fR\fB, uint32_t \fR\fIcomb\fR\fB,\fR
\fBbool *\fR\fIbase_is_from_primary\fR\fB,\fR
\fBbool *\fR\fIcomb_is_from_primary\fR\fB,\fR
\fBbool *\fR\fIcomposed_is_from_primary\fR\fB);\fR
.PP
.RE
.SH DESCRIPTION
.PP
\fBfcft_precompose\fR() composes the \fIbase\fR and \fIcomb\fR wide characters
into a single wide character.\& For example, \fBL'\&a'\&\fR + \fBL'\&\eu0301'\&\fR can
be combined to \fBL'\&á'\&\fR.\&
.PP
If \fI*_is_from_primary\fR are non-NULL, they will be \fBtrue\fR if the
corresponding wide character exists in the primary font.\& If \fBfalse\fR,
it does not exist in the primary font and \fBfcft_codepoint_rasterize\fR()
will pick the glyph from one of the fallback fonts.\&
.PP
.SH RETURN VALUE
.PP
On success, \fBfcft_precompose\fR() returns a composed wide character.\& On
error, \fB(uint32_t)-1\fR is returned.\&
.PP
.SH SEE ALSO
.PP
\fBfcft_codepoint_rasterize\fR(), \fBfcft_kerning\fR()