Rev 1892 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 1892 | Rev 3959 | ||
---|---|---|---|
Line 50... | Line 50... | ||
50 | * #cairo_font_face_t represents a particular font at a particular weight, |
50 | * #cairo_font_face_t represents a particular font at a particular weight, |
51 | * slant, and other characteristic but no size, transformation, or size. |
51 | * slant, and other characteristic but no size, transformation, or size. |
52 | * |
52 | * |
53 | * Font faces are created using |
53 | * Font faces are created using |
54 | * constructors, typically of the form |
54 | * constructors, typically of the form |
55 | * cairo_ |
55 | * |
56 | * using the |
56 | * or implicitly using the |
57 | * cairo_select_font_face(). The resulting face can be accessed using |
57 | * cairo_select_font_face(). The resulting face can be accessed using |
58 | * cairo_get_font_face(). |
58 | * cairo_get_font_face(). |
59 | */ |
59 | **/ |
Line 60... | Line 60... | ||
60 | 60 | ||
Line 61... | Line 61... | ||
61 | /* #cairo_font_face_t */ |
61 | /* #cairo_font_face_t */ |
62 | 62 | ||
Line 106... | Line 106... | ||
106 | * |
106 | * |
107 | * The number of references to a #cairo_font_face_t can be get using |
107 | * The number of references to a #cairo_font_face_t can be get using |
108 | * cairo_font_face_get_reference_count(). |
108 | * cairo_font_face_get_reference_count(). |
109 | * |
109 | * |
110 | * Return value: the referenced #cairo_font_face_t. |
110 | * Return value: the referenced #cairo_font_face_t. |
- | 111 | * |
|
- | 112 | * Since: 1.0 |
|
111 | **/ |
113 | **/ |
112 | cairo_font_face_t * |
114 | cairo_font_face_t * |
113 | cairo_font_face_reference (cairo_font_face_t *font_face) |
115 | cairo_font_face_reference (cairo_font_face_t *font_face) |
114 | { |
116 | { |
115 | if (font_face == NULL || |
117 | if (font_face == NULL || |
Line 131... | Line 133... | ||
131 | * @font_face: a #cairo_font_face_t |
133 | * @font_face: a #cairo_font_face_t |
132 | * |
134 | * |
133 | * Decreases the reference count on @font_face by one. If the result |
135 | * Decreases the reference count on @font_face by one. If the result |
134 | * is zero, then @font_face and all associated resources are freed. |
136 | * is zero, then @font_face and all associated resources are freed. |
135 | * See cairo_font_face_reference(). |
137 | * See cairo_font_face_reference(). |
- | 138 | * |
|
- | 139 | * Since: 1.0 |
|
136 | **/ |
140 | **/ |
137 | void |
141 | void |
138 | cairo_font_face_destroy (cairo_font_face_t *font_face) |
142 | cairo_font_face_destroy (cairo_font_face_t *font_face) |
139 | { |
143 | { |
140 | if (font_face == NULL || |
144 | if (font_face == NULL || |
Line 210... | Line 214... | ||
210 | * Checks whether an error has previously occurred for this |
214 | * Checks whether an error has previously occurred for this |
211 | * font face |
215 | * font face |
212 | * |
216 | * |
213 | * Return value: %CAIRO_STATUS_SUCCESS or another error such as |
217 | * Return value: %CAIRO_STATUS_SUCCESS or another error such as |
214 | * %CAIRO_STATUS_NO_MEMORY. |
218 | * %CAIRO_STATUS_NO_MEMORY. |
- | 219 | * |
|
- | 220 | * Since: 1.0 |
|
215 | **/ |
221 | **/ |
216 | cairo_status_t |
222 | cairo_status_t |
217 | cairo_font_face_status (cairo_font_face_t *font_face) |
223 | cairo_font_face_status (cairo_font_face_t *font_face) |
218 | { |
224 | { |
219 | return font_face->status; |
225 | return font_face->status; |
Line 228... | Line 234... | ||
228 | * Return user data previously attached to @font_face using the specified |
234 | * Return user data previously attached to @font_face using the specified |
229 | * key. If no user data has been attached with the given key this |
235 | * key. If no user data has been attached with the given key this |
230 | * function returns %NULL. |
236 | * function returns %NULL. |
231 | * |
237 | * |
232 | * Return value: the user data previously attached or %NULL. |
238 | * Return value: the user data previously attached or %NULL. |
- | 239 | * |
|
- | 240 | * Since: 1.0 |
|
233 | **/ |
241 | **/ |
234 | void * |
242 | void * |
235 | cairo_font_face_get_user_data (cairo_font_face_t *font_face, |
243 | cairo_font_face_get_user_data (cairo_font_face_t *font_face, |
236 | const cairo_user_data_key_t *key) |
244 | const cairo_user_data_key_t *key) |
237 | { |
245 | { |
Line 253... | Line 261... | ||
253 | * call this function with the key that was used to set it and %NULL |
261 | * call this function with the key that was used to set it and %NULL |
254 | * for @data. |
262 | * for @data. |
255 | * |
263 | * |
256 | * Return value: %CAIRO_STATUS_SUCCESS or %CAIRO_STATUS_NO_MEMORY if a |
264 | * Return value: %CAIRO_STATUS_SUCCESS or %CAIRO_STATUS_NO_MEMORY if a |
257 | * slot could not be allocated for the user data. |
265 | * slot could not be allocated for the user data. |
- | 266 | * |
|
- | 267 | * Since: 1.0 |
|
258 | **/ |
268 | **/ |
259 | cairo_status_t |
269 | cairo_status_t |
260 | cairo_font_face_set_user_data (cairo_font_face_t *font_face, |
270 | cairo_font_face_set_user_data (cairo_font_face_t *font_face, |
261 | const cairo_user_data_key_t *key, |
271 | const cairo_user_data_key_t *key, |
262 | void *user_data, |
272 | void *user_data, |