WebSVN – Kolibri OS – Diff – /programs/develop/libraries/cairo/src/cairo-font-options.c

+ *
  * The font options specify how fonts should be rendered.  Most of the
  * time the font options implied by a surface are just right and do not
  * need any changes, but for pixel-based targets tweaking font options
  * may result in superior output on a particular display.
- */
+ **/
 static const cairo_font_options_t _cairo_font_options_nil = {
     CAIRO_ANTIALIAS_DEFAULT,
     CAIRO_SUBPIXEL_ORDER_DEFAULT,
     CAIRO_LCD_FILTER_DEFAULT,
     CAIRO_HINT_STYLE_DEFAULT,
+    CAIRO_HINT_METRICS_DEFAULT,
-    CAIRO_HINT_METRICS_DEFAULT
+    CAIRO_ROUND_GLYPH_POS_DEFAULT
 };
 /**
     options->antialias = CAIRO_ANTIALIAS_DEFAULT;
     options->subpixel_order = CAIRO_SUBPIXEL_ORDER_DEFAULT;
     options->lcd_filter = CAIRO_LCD_FILTER_DEFAULT;
     options->hint_style = CAIRO_HINT_STYLE_DEFAULT;
     options->hint_metrics = CAIRO_HINT_METRICS_DEFAULT;
+    options->round_glyph_positions = CAIRO_ROUND_GLYPH_POS_DEFAULT;
+}
 void
 _cairo_font_options_init_copy (cairo_font_options_t		*options,
     options->antialias = other->antialias;
     options->subpixel_order = other->subpixel_order;
     options->lcd_filter = other->lcd_filter;
     options->hint_style = other->hint_style;
     options->hint_metrics = other->hint_metrics;
+    options->round_glyph_positions = other->round_glyph_positions;
+}
 /**
  * cairo_font_options_create:
  * Return value: a newly allocated #cairo_font_options_t. Free with
  *   cairo_font_options_destroy(). This function always returns a
  *   valid pointer; if memory cannot be allocated, then a special
  *   error object is returned where all operations on the object do nothing.
  *   You can check for this with cairo_font_options_status().
+ *
+ * Since: 1.0
  **/
 cairo_font_options_t *
 cairo_font_options_create (void)
+{
     cairo_font_options_t *options;
  * Return value: a newly allocated #cairo_font_options_t. Free with
  *   cairo_font_options_destroy(). This function always returns a
  *   valid pointer; if memory cannot be allocated, then a special
  *   error object is returned where all operations on the object do nothing.
  *   You can check for this with cairo_font_options_status().
+ *
+ * Since: 1.0
  **/
 cairo_font_options_t *
 cairo_font_options_copy (const cairo_font_options_t *original)
+{
     cairo_font_options_t *options;
  * cairo_font_options_destroy:
  * @options: a #cairo_font_options_t
+ *
  * Destroys a #cairo_font_options_t object created with
  * cairo_font_options_create() or cairo_font_options_copy().
+ *
+ * Since: 1.0
  **/
 void
 cairo_font_options_destroy (cairo_font_options_t *options)
+{
     if (cairo_font_options_status (options))
+ *
  * Checks whether an error has previously occurred for this
  * font options object
+ *
  * Return value: %CAIRO_STATUS_SUCCESS or %CAIRO_STATUS_NO_MEMORY
+ *
+ * Since: 1.0
  **/
 cairo_status_t
 cairo_font_options_status (cairo_font_options_t *options)
+{
     if (options == NULL)
  * @other: another #cairo_font_options_t
+ *
  * Merges non-default options from @other into @options, replacing
  * existing values. This operation can be thought of as somewhat
  * similar to compositing @other onto @options with the operation
- * of %CAIRO_OPERATION_OVER.
+ * of %CAIRO_OPERATOR_OVER.
+ *
+ * Since: 1.0
  **/
 void
 cairo_font_options_merge (cairo_font_options_t       *options,
 			  const cairo_font_options_t *other)
+{
 	options->lcd_filter = other->lcd_filter;
     if (other->hint_style != CAIRO_HINT_STYLE_DEFAULT)
 	options->hint_style = other->hint_style;
     if (other->hint_metrics != CAIRO_HINT_METRICS_DEFAULT)
 	options->hint_metrics = other->hint_metrics;
+    if (other->round_glyph_positions != CAIRO_ROUND_GLYPH_POS_DEFAULT)
+	options->round_glyph_positions = other->round_glyph_positions;
+}
 slim_hidden_def (cairo_font_options_merge);
 /**
  * Compares two font options objects for equality.
+ *
  * Return value: %TRUE if all fields of the two font options objects match.
  *	Note that this function will return %FALSE if either object is in
  *	error.
+ *
+ * Since: 1.0
  **/
 cairo_bool_t
 cairo_font_options_equal (const cairo_font_options_t *options,
 			  const cairo_font_options_t *other)
+{
     return (options->antialias == other->antialias &&
 	    options->subpixel_order == other->subpixel_order &&
 	    options->lcd_filter == other->lcd_filter &&
 	    options->hint_style == other->hint_style &&
+	    options->hint_metrics == other->hint_metrics &&
-	    options->hint_metrics == other->hint_metrics);
+	    options->round_glyph_positions == other->round_glyph_positions);
+}
 slim_hidden_def (cairo_font_options_equal);
  * in a hash table.
+ *
  * Return value: the hash value for the font options object.
  *   The return value can be cast to a 32-bit type if a
  *   32-bit hash value is needed.
+ *
+ * Since: 1.0
  **/
 unsigned long
 cairo_font_options_hash (const cairo_font_options_t *options)
+{
     if (cairo_font_options_status ((cairo_font_options_t *) options))
  * @options: a #cairo_font_options_t
  * @antialias: the new antialiasing mode
+ *
  * Sets the antialiasing mode for the font options object. This
  * specifies the type of antialiasing to do when rendering text.
+ *
+ * Since: 1.0
  **/
 void
 cairo_font_options_set_antialias (cairo_font_options_t *options,
 				  cairo_antialias_t     antialias)
+{
  * @options: a #cairo_font_options_t
+ *
  * Gets the antialiasing mode for the font options object.
+ *
  * Return value: the antialiasing mode
+ *
+ * Since: 1.0
  **/
 cairo_antialias_t
 cairo_font_options_get_antialias (const cairo_font_options_t *options)
+{
     if (cairo_font_options_status ((cairo_font_options_t *) options))
  * Sets the subpixel order for the font options object. The subpixel
  * order specifies the order of color elements within each pixel on
  * the display device when rendering with an antialiasing mode of
  * %CAIRO_ANTIALIAS_SUBPIXEL. See the documentation for
  * #cairo_subpixel_order_t for full details.
+ *
+ * Since: 1.0
  **/
 void
 cairo_font_options_set_subpixel_order (cairo_font_options_t   *options,
 				       cairo_subpixel_order_t  subpixel_order)
+{
+ *
  * Gets the subpixel order for the font options object.
  * See the documentation for #cairo_subpixel_order_t for full details.
+ *
  * Return value: the subpixel order for the font options object
+ *
+ * Since: 1.0
  **/
 cairo_subpixel_order_t
 cairo_font_options_get_subpixel_order (const cairo_font_options_t *options)
+{
     if (cairo_font_options_status ((cairo_font_options_t *) options))
+ *
  * Sets the LCD filter for the font options object. The LCD filter
  * specifies how pixels are filtered when rendered with an antialiasing
  * mode of %CAIRO_ANTIALIAS_SUBPIXEL. See the documentation for
  * #cairo_lcd_filter_t for full details.
- *
- * Since: 1.8
  **/
 void
 _cairo_font_options_set_lcd_filter (cairo_font_options_t *options,
 				    cairo_lcd_filter_t    lcd_filter)
+{
+ *
  * Gets the LCD filter for the font options object.
  * See the documentation for #cairo_lcd_filter_t for full details.
+ *
  * Return value: the LCD filter for the font options object
- *
- * Since: 1.8
  **/
 cairo_lcd_filter_t
 _cairo_font_options_get_lcd_filter (const cairo_font_options_t *options)
+{
     if (cairo_font_options_status ((cairo_font_options_t *) options))
     return options->lcd_filter;
+}
+/**
+ * _cairo_font_options_set_round_glyph_positions:
+ * @options: a #cairo_font_options_t
+ * @round: the new rounding value
+ *
+ * Sets the rounding options for the font options object. If rounding is set, a
+ * glyph's position will be rounded to integer values.
+ **/
+void
+_cairo_font_options_set_round_glyph_positions (cairo_font_options_t *options,
+					       cairo_round_glyph_positions_t  round)
+{
+    if (cairo_font_options_status (options))
+	return;
+    options->round_glyph_positions = round;
+}
+/**
+ * _cairo_font_options_get_round_glyph_positions:
+ * @options: a #cairo_font_options_t
+ *
+ * Gets the glyph position rounding option for the font options object.
+ *
+ * Return value: The round glyph posistions flag for the font options object.
+ **/
+cairo_round_glyph_positions_t
+_cairo_font_options_get_round_glyph_positions (const cairo_font_options_t *options)
+{
+    if (cairo_font_options_status ((cairo_font_options_t *) options))
+	return CAIRO_ROUND_GLYPH_POS_DEFAULT;
+    return options->round_glyph_positions;
+}
 /**
  * cairo_font_options_set_hint_style:
  * @options: a #cairo_font_options_t
  * @hint_style: the new hint style
+ *
  * Sets the hint style for font outlines for the font options object.
  * This controls whether to fit font outlines to the pixel grid,
+ * and if so, whether to optimize for fidelity or contrast.
+ * See the documentation for #cairo_hint_style_t for full details.
  * and if so, whether to optimize for fidelity or contrast.
- * See the documentation for #cairo_hint_style_t for full details.
+ * Since: 1.0
  **/
 void
 cairo_font_options_set_hint_style (cairo_font_options_t *options,
+ *
  * Gets the hint style for font outlines for the font options object.
  * See the documentation for #cairo_hint_style_t for full details.
+ *
  * Return value: the hint style for the font options object
+ *
+ * Since: 1.0
  **/
 cairo_hint_style_t
 cairo_font_options_get_hint_style (const cairo_font_options_t *options)
+{
     if (cairo_font_options_status ((cairo_font_options_t *) options))
+ *
  * Sets the metrics hinting mode for the font options object. This
  * controls whether metrics are quantized to integer values in
  * device units.
  * See the documentation for #cairo_hint_metrics_t for full details.
+ *
+ * Since: 1.0
  **/
 void
 cairo_font_options_set_hint_metrics (cairo_font_options_t *options,
 				     cairo_hint_metrics_t  hint_metrics)
+{
+ *
  * Gets the metrics hinting mode for the font options object.
  * See the documentation for #cairo_hint_metrics_t for full details.
+ *
  * Return value: the metrics hinting mode for the font options object
+ *
+ * Since: 1.0
  **/
 cairo_hint_metrics_t
 cairo_font_options_get_hint_metrics (const cairo_font_options_t *options)
+{
     if (cairo_font_options_status ((cairo_font_options_t *) options))

Subversion Repositories Kolibri OS

(root)/programs/develop/libraries/cairo/src/cairo-font-options.c – Rev 1892 → 3959