.\" 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_precompose" "3" "2020-11-07" "2.3.1" "fcft"
.P
.SH NAME
.P
fcft_precompose - pre-compose two wide characters into one
.P
.SH SYNOPSIS
.P
\fB#include <fcft/fcft.h>\fR
.P
\fBbool fcft_precompose(\fR
.RS 4
\fBconst struct fcft_font *\fR\fIfont\fR\fB,\fR
\fBwchar_t \fR\fIbase\fR\fB, wchar_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
.P
.RE
.SH DESCRIPTION
.P
\fBfcft_precompose\fR() composes the \fIbase\fR and \fIcomb\fR wide characters
into a single wide character. For example, \fBL'a'\fR + \fBL'\\u0301'\fR can be
combined to \fBL'á'\fR.
.P
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_glyph_rasterize\fR(3)
will pick the glyph from one of the fallback fonts.
.P
.SH RETURN VALUE
.P
On success, \fBfcft_precompose\fR() returns a composed wide character. On
error, \fB(wchar_t)-1\fR is returned.
.P
.SH SEE ALSO
.P
\fBfcft_glyph_rasterize\fR(3), \fBfcft_kerning\fR(3)