doc/fontconfig-devel/fcconfigreference.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >FcConfigReference</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
   9 REL="HOME"
  10 HREF="t1.html"><LINK
  11 REL="UP"
  12 TITLE="FcConfig"
  13 HREF="x103.html#AEN2788"><LINK
  14 REL="PREVIOUS"
  15 TITLE="FcConfigCreate"
  16 HREF="fcconfigcreate.html"><LINK
  17 REL="NEXT"
  18 TITLE="FcConfigDestroy"
  19 HREF="fcconfigdestroy.html"></HEAD
  20 ><BODY
  21 CLASS="REFENTRY"
  22 BGCOLOR="#FFFFFF"
  23 TEXT="#000000"
  24 LINK="#0000FF"
  25 VLINK="#840084"
  26 ALINK="#0000FF"
  27 ><DIV
  28 CLASS="NAVHEADER"
  29 ><TABLE
  30 SUMMARY="Header navigation table"
  31 WIDTH="100%"
  32 BORDER="0"
  33 CELLPADDING="0"
  34 CELLSPACING="0"
  35 ><TR
  36 ><TH
  37 COLSPAN="3"
  38 ALIGN="center"
  39 ></TH
  40 ></TR
  41 ><TR
  42 ><TD
  43 WIDTH="10%"
  44 ALIGN="left"
  45 VALIGN="bottom"
  46 ><A
  47 HREF="fcconfigcreate.html"
  48 ACCESSKEY="P"
  49 >&#60;&#60;&#60; Previous</A
  50 ></TD
  51 ><TD
  52 WIDTH="80%"
  53 ALIGN="center"
  54 VALIGN="bottom"
  55 ></TD
  56 ><TD
  57 WIDTH="10%"
  58 ALIGN="right"
  59 VALIGN="bottom"
  60 ><A
  61 HREF="fcconfigdestroy.html"
  62 ACCESSKEY="N"
  63 >Next &#62;&#62;&#62;</A
  64 ></TD
  65 ></TR
  66 ></TABLE
  67 ><HR
  68 ALIGN="LEFT"
  69 WIDTH="100%"></DIV
  70 ><H1
  71 ><A
  72 NAME="FCCONFIGREFERENCE"
  73 ></A
  74 >FcConfigReference</H1
  75 ><DIV
  76 CLASS="REFNAMEDIV"
  77 ><A
  78 NAME="AEN2815"
  79 ></A
  80 ><H2
  81 >Name</H2
  82 >FcConfigReference&nbsp;--&nbsp;Increment config reference count</DIV
  83 ><DIV
  84 CLASS="REFSYNOPSISDIV"
  85 ><A
  86 NAME="AEN2818"
  87 ></A
  88 ><H2
  89 >Synopsis</H2
  90 ><DIV
  91 CLASS="FUNCSYNOPSIS"
  92 ><P
  93 ></P
  94 ><A
  95 NAME="AEN2819"
  96 ></A
  97 ><TABLE
  98 BORDER="0"
  99 BGCOLOR="#E0E0E0"
 100 WIDTH="100%"
 101 ><TR
 102 ><TD
 103 ><PRE
 104 CLASS="FUNCSYNOPSISINFO"
 105 >#include &#60;fontconfig/fontconfig.h&#62;
 106         </PRE
 107 ></TD
 108 ></TR
 109 ></TABLE
 110 ><P
 111 ><CODE
 112 ><CODE
 113 CLASS="FUNCDEF"
 114 >FcConfig * <TT
 115 CLASS="FUNCTION"
 116 >FcConfigReference</TT
 117 ></CODE
 118 >(FcConfig *<TT
 119 CLASS="PARAMETER"
 120 ><I
 121 >config</I
 122 ></TT
 123 >);</CODE
 124 ></P
 125 ><P
 126 ></P
 127 ></DIV
 128 ></DIV
 129 ><DIV
 130 CLASS="REFSECT1"
 131 ><A
 132 NAME="AEN2826"
 133 ></A
 134 ><H2
 135 >Description</H2
 136 ><P
 137 >Add another reference to <TT
 138 CLASS="PARAMETER"
 139 ><I
 140 >config</I
 141 ></TT
 142 >. Configs are freed only
 143 when the reference count reaches zero.
 144 If <TT
 145 CLASS="PARAMETER"
 146 ><I
 147 >config</I
 148 ></TT
 149 > is NULL, the current configuration is used.
 150 In that case this function will be similar to FcConfigGetCurrent() except that
 151 it increments the reference count before returning and the user is responsible
 152 for destroying the configuration when not needed anymore.
 153             </P
 154 ></DIV
 155 ><DIV
 156 CLASS="NAVFOOTER"
 157 ><HR
 158 ALIGN="LEFT"
 159 WIDTH="100%"><TABLE
 160 SUMMARY="Footer navigation table"
 161 WIDTH="100%"
 162 BORDER="0"
 163 CELLPADDING="0"
 164 CELLSPACING="0"
 165 ><TR
 166 ><TD
 167 WIDTH="33%"
 168 ALIGN="left"
 169 VALIGN="top"
 170 ><A
 171 HREF="fcconfigcreate.html"
 172 ACCESSKEY="P"
 173 >&#60;&#60;&#60; Previous</A
 174 ></TD
 175 ><TD
 176 WIDTH="34%"
 177 ALIGN="center"
 178 VALIGN="top"
 179 ><A
 180 HREF="t1.html"
 181 ACCESSKEY="H"
 182 >Home</A
 183 ></TD
 184 ><TD
 185 WIDTH="33%"
 186 ALIGN="right"
 187 VALIGN="top"
 188 ><A
 189 HREF="fcconfigdestroy.html"
 190 ACCESSKEY="N"
 191 >Next &#62;&#62;&#62;</A
 192 ></TD
 193 ></TR
 194 ><TR
 195 ><TD
 196 WIDTH="33%"
 197 ALIGN="left"
 198 VALIGN="top"
 199 >FcConfigCreate</TD
 200 ><TD
 201 WIDTH="34%"
 202 ALIGN="center"
 203 VALIGN="top"
 204 ><A
 205 HREF="x103.html#AEN2788"
 206 ACCESSKEY="U"
 207 >Up</A
 208 ></TD
 209 ><TD
 210 WIDTH="33%"
 211 ALIGN="right"
 212 VALIGN="top"
 213 >FcConfigDestroy</TD
 214 ></TR
 215 ></TABLE
 216 ></DIV
 217 ></BODY
 218 ></HTML
 219 >