1229 lines
50 KiB
Plaintext
1229 lines
50 KiB
Plaintext
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternCreate">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternCreate</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternCreate</refname>
|
|
<refpurpose>Create a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcPattern * <function>FcPatternCreate</function></funcdef>
|
|
<paramdef>void<parameter></parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Creates a pattern with no properties; used to build patterns from scratch.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternDuplicate">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternDuplicate</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternDuplicate</refname>
|
|
<refpurpose>Copy a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcPattern * <function>FcPatternDuplicate</function></funcdef>
|
|
<paramdef>const FcPattern *<parameter>p</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Copy a pattern, returning a new pattern that matches
|
|
<parameter>p</parameter>. Each pattern may be modified without affecting the
|
|
other.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternReference">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternReference</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternReference</refname>
|
|
<refpurpose>Increment pattern reference count</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>void <function>FcPatternReference</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Add another reference to <parameter>p</parameter>. Patterns are freed only
|
|
when the reference count reaches zero.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternDestroy">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternDestroy</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternDestroy</refname>
|
|
<refpurpose>Destroy a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>void <function>FcPatternDestroy</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Decrement the pattern reference count. If all references are gone, destroys
|
|
the pattern, in the process destroying all related values.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternEqual">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternEqual</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternEqual</refname>
|
|
<refpurpose>Compare patterns</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternEqual</function></funcdef>
|
|
<paramdef>const FcPattern *<parameter>pa</parameter></paramdef>
|
|
<paramdef>const FcPattern *<parameter>pb</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Returns whether <parameter>pa</parameter> and <parameter>pb</parameter> are exactly alike.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternEqualSubset">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternEqualSubset</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternEqualSubset</refname>
|
|
<refpurpose>Compare portions of patterns</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternEqualSubset</function></funcdef>
|
|
<paramdef>const FcPattern *<parameter>pa</parameter></paramdef>
|
|
<paramdef>const FcPattern *<parameter>pb</parameter></paramdef>
|
|
<paramdef>const FcObjectSet *<parameter>os</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Returns whether <parameter>pa</parameter> and <parameter>pb</parameter> have exactly the same values for all of the
|
|
objects in <parameter>os</parameter>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternFilter">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternFilter</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternFilter</refname>
|
|
<refpurpose>Filter the objects of pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcPattern * <function>FcPatternFilter</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const FcObjectSet *<parameter></parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Returns a new pattern that only has those objects from
|
|
<parameter>p</parameter> that are in <parameter>os</parameter>.
|
|
If <parameter>os</parameter> is NULL, a duplicate of
|
|
<parameter>p</parameter> is returned.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternHash">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternHash</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternHash</refname>
|
|
<refpurpose>Compute a pattern hash value</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcChar32 <function>FcPatternHash</function></funcdef>
|
|
<paramdef>const FcPattern *<parameter>p</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Returns a 32-bit number which is the same for any two patterns which are
|
|
equal.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternAdd">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternAdd</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternAdd</refname>
|
|
<refpurpose>Add a value to a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAdd</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>FcValue <parameter>value</parameter></paramdef>
|
|
<paramdef>FcBool <parameter>append</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Adds a single value to the list of values associated with the property named
|
|
`object<parameter>. If `append</parameter> is FcTrue, the value is added at the end of any
|
|
existing list, otherwise it is inserted at the beginning. `value' is saved
|
|
(with FcValueSave) when inserted into the pattern so that the library
|
|
retains no reference to any application-supplied data structure.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternAddWeak">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternAddWeak</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternAddWeak</refname>
|
|
<refpurpose>Add a value to a pattern with weak binding</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddWeak</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>FcValue <parameter>value</parameter></paramdef>
|
|
<paramdef>FcBool <parameter>append</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
FcPatternAddWeak is essentially the same as FcPatternAdd except that any
|
|
values added to the list have binding <parameter>weak</parameter> instead of <parameter>strong</parameter>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternAdd-Type">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternAdd-Type</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternAddInteger</refname>
|
|
<refname>FcPatternAddDouble</refname>
|
|
<refname>FcPatternAddString</refname>
|
|
<refname>FcPatternAddMatrix</refname>
|
|
<refname>FcPatternAddCharSet</refname>
|
|
<refname>FcPatternAddBool</refname>
|
|
<refname>FcPatternAddFTFace</refname>
|
|
<refname>FcPatternAddLangSet</refname>
|
|
<refname>FcPatternAddRange</refname>
|
|
<refpurpose>Add a typed value to a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddInteger</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>i</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddDouble</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>double <parameter>d</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddString</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>const FcChar8 *<parameter>s</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddMatrix</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>const FcMatrix *<parameter>m</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddCharSet</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>const FcCharSet *<parameter>c</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddBool</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>FcBool <parameter>b</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddFTFace</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>const FT_Face<parameter>f</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddLangSet</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>const FcLangSet *<parameter>l</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternAddRange</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>const FcRange *<parameter>r</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
These are all convenience functions that insert objects of the specified
|
|
type into the pattern. Use these in preference to FcPatternAdd as they
|
|
will provide compile-time typechecking. These all append values to
|
|
any existing list of values.
|
|
|
|
<function>FcPatternAddRange</function> are available since 2.11.91.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternGet">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternGet</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternGet</refname>
|
|
<refpurpose>Return a value from a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGet</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>id</parameter></paramdef>
|
|
<paramdef>FcValue *<parameter>v</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Returns in <parameter>v</parameter> the <parameter>id</parameter>'th value
|
|
associated with the property <parameter>object</parameter>.
|
|
The value returned is not a copy, but rather refers to the data stored
|
|
within the pattern directly. Applications must not free this value.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternGet-Type">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternGet-Type</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternGetInteger</refname>
|
|
<refname>FcPatternGetDouble</refname>
|
|
<refname>FcPatternGetString</refname>
|
|
<refname>FcPatternGetMatrix</refname>
|
|
<refname>FcPatternGetCharSet</refname>
|
|
<refname>FcPatternGetBool</refname>
|
|
<refname>FcPatternGetFTFace</refname>
|
|
<refname>FcPatternGetLangSet</refname>
|
|
<refname>FcPatternGetRange</refname>
|
|
<refpurpose>Return a typed value from a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetInteger</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>int *<parameter>i</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetDouble</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>double *<parameter>d</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetString</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>FcChar8 **<parameter>s</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetMatrix</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>FcMatrix **<parameter>s</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetCharSet</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>FcCharSet **<parameter>c</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetBool</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>FcBool *<parameter>b</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetFTFace</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>FT_Face *<parameter>f</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetLangSet</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>FcLangSet **<parameter>l</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcResult <function>FcPatternGetRange</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>n</parameter></paramdef>
|
|
<paramdef>FcRange **<parameter>r</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
These are convenience functions that call FcPatternGet and verify that the
|
|
returned data is of the expected type. They return FcResultTypeMismatch if
|
|
this is not the case. Note that these (like FcPatternGet) do not make a
|
|
copy of any data structure referenced by the return value. Use these
|
|
in preference to FcPatternGet to provide compile-time typechecking.
|
|
|
|
<function>FcPatternGetRange</function> are available since 2.11.91.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternBuild">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternBuild</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternBuild</refname>
|
|
<refname>FcPatternVaBuild</refname>
|
|
<refname>FcPatternVapBuild</refname>
|
|
<refpurpose>Create patterns from arguments</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcPattern * <function>FcPatternBuild</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>pattern</parameter></paramdef>
|
|
<paramdef>...<parameter></parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>FcPattern * <function>FcPatternVaBuild</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>pattern</parameter></paramdef>
|
|
<paramdef>va_list <parameter>va</parameter></paramdef>
|
|
</funcprototype>
|
|
<funcprototype>
|
|
<funcdef>void <function>FcPatternVapBuild</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>result</parameter></paramdef>
|
|
<paramdef>FcPattern *<parameter>pattern</parameter></paramdef>
|
|
<paramdef>va_list <parameter>va</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Builds a pattern using a list of objects, types and values. Each
|
|
value to be entered in the pattern is specified with three arguments:
|
|
</para>
|
|
<orderedlist>
|
|
<listitem><para>
|
|
Object name, a string describing the property to be added.
|
|
</para></listitem><listitem><para>
|
|
Object type, one of the FcType enumerated values
|
|
</para></listitem><listitem><para>
|
|
Value, not an FcValue, but the raw type as passed to any of the
|
|
FcPatternAdd<type> functions. Must match the type of the second
|
|
argument.
|
|
</para></listitem>
|
|
</orderedlist>
|
|
<para>
|
|
The argument list is terminated by a null object name, no object type nor
|
|
value need be passed for this. The values are added to `pattern', if
|
|
`pattern' is null, a new pattern is created. In either case, the pattern is
|
|
returned. Example
|
|
</para>
|
|
<programlisting>
|
|
pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
|
|
</programlisting>
|
|
<para>
|
|
FcPatternVaBuild is used when the arguments are already in the form of a
|
|
varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild
|
|
which returns its result directly in the <parameter>result</parameter>
|
|
variable.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternDel">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternDel</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternDel</refname>
|
|
<refpurpose>Delete a property from a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternDel</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Deletes all values associated with the property `object', returning
|
|
whether the property existed or not.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternRemove">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternRemove</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternRemove</refname>
|
|
<refpurpose>Remove one object of the specified type from the pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcBool <function>FcPatternRemove</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>p</parameter></paramdef>
|
|
<paramdef>const char *<parameter>object</parameter></paramdef>
|
|
<paramdef>int <parameter>id</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Removes the value associated with the property `object' at position `id', returning
|
|
whether the property existed and had a value at that position or not.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcPatternPrint">
|
|
<refmeta>
|
|
<refentrytitle>FcPatternPrint</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcPatternPrint</refname>
|
|
<refpurpose>Print a pattern for debugging</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>void <function>FcPatternPrint</function></funcdef>
|
|
<paramdef>const FcPattern *<parameter>p</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Prints an easily readable version of the pattern to stdout. There is
|
|
no provision for reparsing data in this format, it's just for diagnostics
|
|
and debugging.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcDefaultSubstitute">
|
|
<refmeta>
|
|
<refentrytitle>FcDefaultSubstitute</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcDefaultSubstitute</refname>
|
|
<refpurpose>Perform default substitutions in a pattern</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>void <function>FcDefaultSubstitute</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>pattern</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Supplies default values for underspecified font patterns:
|
|
<itemizedlist>
|
|
<listitem><para>
|
|
Patterns without a specified style or weight are set to Medium
|
|
</para></listitem>
|
|
<listitem><para>
|
|
Patterns without a specified style or slant are set to Roman
|
|
</para></listitem>
|
|
<listitem><para>
|
|
Patterns without a specified pixel size are given one computed from any
|
|
specified point size (default 12), dpi (default 75) and scale (default 1).
|
|
</para></listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcNameParse">
|
|
<refmeta>
|
|
<refentrytitle>FcNameParse</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcNameParse</refname>
|
|
<refpurpose>Parse a pattern string</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcPattern * <function>FcNameParse</function></funcdef>
|
|
<paramdef>const FcChar8 *<parameter>name</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Converts <parameter>name</parameter> from the standard text format described above into a pattern.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--
|
|
fontconfig/doc/func.sgml
|
|
|
|
Copyright © 2003 Keith Packard
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation, and that the name of the author(s) not be used in
|
|
advertising or publicity pertaining to distribution of the software without
|
|
specific, written prior permission. The authors make no
|
|
representations about the suitability of this software for any purpose. It
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
-->
|
|
<refentry id="FcNameUnparse">
|
|
<refmeta>
|
|
<refentrytitle>FcNameUnparse</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>FcNameUnparse</refname>
|
|
<refpurpose>Convert a pattern back into a string that can be parsed</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>
|
|
#include <fontconfig/fontconfig.h>
|
|
</funcsynopsisinfo>
|
|
<funcprototype>
|
|
<funcdef>FcChar8 * <function>FcNameUnparse</function></funcdef>
|
|
<paramdef>FcPattern *<parameter>pat</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
Converts the given pattern into the standard text format described above.
|
|
The return value is not static, but instead refers to newly allocated memory
|
|
which should be freed by the caller using free().
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|