| blob | 6d0b1188fc5a36546834212b0fc154af9eec7588 |
1 /* cairo - a vector graphics library with display and print output
2 *
3 * Copyright © 2006 Red Hat, Inc.
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it either under the terms of the GNU Lesser General Public
7 * License version 2.1 as published by the Free Software Foundation
8 * (the "LGPL") or, at your option, under the terms of the Mozilla
9 * Public License Version 1.1 (the "MPL"). If you do not alter this
10 * notice, a recipient may use your version of this file under either
11 * the MPL or the LGPL.
12 *
13 * You should have received a copy of the LGPL along with this library
14 * in the file COPYING-LGPL-2.1; if not, write to the Free Software
15 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16 * You should have received a copy of the MPL along with this library
17 * in the file COPYING-MPL-1.1
18 *
19 * The contents of this file are subject to the Mozilla Public License
20 * Version 1.1 (the "License"); you may not use this file except in
21 * compliance with the License. You may obtain a copy of the License at
22 * http://www.mozilla.org/MPL/
23 *
24 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
25 * OF ANY KIND, either express or implied. See the LGPL or the MPL for
26 * the specific language governing rights and limitations.
27 *
28 * The Original Code is the cairo graphics library.
29 *
30 * The Initial Developer of the Original Code is Red Hat, Inc.
31 *
32 * Contributor(s):
33 * Carl D. Worth <cworth@cworth.org>
34 */
36 #ifndef CAIRO_DEPRECATED_H
37 #define CAIRO_DEPRECATED_H
41 /* The %CAIRO_FORMAT_RGB16_565 value was added in cairo 1.2.0 as part
42 * of fixing cairo's xlib backend to work with X servers advertising a
43 * 16-bit, 565 visual. But as it turned out, adding this format to
44 * #cairo_format_t was not necessary, and was a mistake, (cairo's xlib
45 * backend can work fine with 16-bit visuals in the same way it works
46 * with BGR visuals without any BGR formats in
47 * #cairo_format_t).
48 *
49 * Additionally, the support for the RGB16_565 format was never
50 * completely implemented. So while this format value is currently
51 * deprecated, it may eventually acquire complete support in the future.
52 */
53 #define CAIRO_FORMAT_RGB16_565 4
55 #define CAIRO_FONT_TYPE_ATSUI CAIRO_FONT_TYPE_QUARTZ
57 /* Obsolete functions. These definitions exist to coerce the compiler
58 * into providing a little bit of guidance with its error
59 * messages. The idea is to help users port their old code without
60 * having to dig through lots of documentation.
61 *
62 * The first set of REPLACED_BY functions is for functions whose names
63 * have just been changed. So fixing these up is mechanical, (and
64 * automated by means of the cairo/util/cairo-api-update script.
65 *
66 * The second set of DEPRECATED_BY functions is for functions where
67 * the replacement is used in a different way, (ie. different
68 * arguments, multiple functions instead of one, etc). Fixing these up
69 * will require a bit more work on the user's part, (and hopefully we
70 * can get cairo-api-update to find these and print some guiding
71 * information).
72 */
73 #define cairo_current_font_extents cairo_current_font_extents_REPLACED_BY_cairo_font_extents
74 #define cairo_get_font_extents cairo_get_font_extents_REPLACED_BY_cairo_font_extents
75 #define cairo_current_operator cairo_current_operator_REPLACED_BY_cairo_get_operator
76 #define cairo_current_tolerance cairo_current_tolerance_REPLACED_BY_cairo_get_tolerance
77 #define cairo_current_point cairo_current_point_REPLACED_BY_cairo_get_current_point
78 #define cairo_current_fill_rule cairo_current_fill_rule_REPLACED_BY_cairo_get_fill_rule
79 #define cairo_current_line_width cairo_current_line_width_REPLACED_BY_cairo_get_line_width
80 #define cairo_current_line_cap cairo_current_line_cap_REPLACED_BY_cairo_get_line_cap
81 #define cairo_current_line_join cairo_current_line_join_REPLACED_BY_cairo_get_line_join
82 #define cairo_current_miter_limit cairo_current_miter_limit_REPLACED_BY_cairo_get_miter_limit
83 #define cairo_current_matrix cairo_current_matrix_REPLACED_BY_cairo_get_matrix
84 #define cairo_current_target_surface cairo_current_target_surface_REPLACED_BY_cairo_get_target
85 #define cairo_get_status cairo_get_status_REPLACED_BY_cairo_status
86 #define cairo_concat_matrix cairo_concat_matrix_REPLACED_BY_cairo_transform
87 #define cairo_scale_font cairo_scale_font_REPLACED_BY_cairo_set_font_size
88 #define cairo_select_font cairo_select_font_REPLACED_BY_cairo_select_font_face
89 #define cairo_transform_font cairo_transform_font_REPLACED_BY_cairo_set_font_matrix
90 #define cairo_transform_point cairo_transform_point_REPLACED_BY_cairo_user_to_device
91 #define cairo_transform_distance cairo_transform_distance_REPLACED_BY_cairo_user_to_device_distance
92 #define cairo_inverse_transform_point cairo_inverse_transform_point_REPLACED_BY_cairo_device_to_user
93 #define cairo_inverse_transform_distance cairo_inverse_transform_distance_REPLACED_BY_cairo_device_to_user_distance
94 #define cairo_init_clip cairo_init_clip_REPLACED_BY_cairo_reset_clip
95 #define cairo_surface_create_for_image cairo_surface_create_for_image_REPLACED_BY_cairo_image_surface_create_for_data
96 #define cairo_default_matrix cairo_default_matrix_REPLACED_BY_cairo_identity_matrix
97 #define cairo_matrix_set_affine cairo_matrix_set_affine_REPLACED_BY_cairo_matrix_init
98 #define cairo_matrix_set_identity cairo_matrix_set_identity_REPLACED_BY_cairo_matrix_init_identity
99 #define cairo_pattern_add_color_stop cairo_pattern_add_color_stop_REPLACED_BY_cairo_pattern_add_color_stop_rgba
100 #define cairo_set_rgb_color cairo_set_rgb_color_REPLACED_BY_cairo_set_source_rgb
101 #define cairo_set_pattern cairo_set_pattern_REPLACED_BY_cairo_set_source
102 #define cairo_xlib_surface_create_for_pixmap_with_visual cairo_xlib_surface_create_for_pixmap_with_visual_REPLACED_BY_cairo_xlib_surface_create
103 #define cairo_xlib_surface_create_for_window_with_visual cairo_xlib_surface_create_for_window_with_visual_REPLACED_BY_cairo_xlib_surface_create
104 #define cairo_xcb_surface_create_for_pixmap_with_visual cairo_xcb_surface_create_for_pixmap_with_visual_REPLACED_BY_cairo_xcb_surface_create
105 #define cairo_xcb_surface_create_for_window_with_visual cairo_xcb_surface_create_for_window_with_visual_REPLACED_BY_cairo_xcb_surface_create
106 #define cairo_ps_surface_set_dpi cairo_ps_surface_set_dpi_REPLACED_BY_cairo_surface_set_fallback_resolution
107 #define cairo_pdf_surface_set_dpi cairo_pdf_surface_set_dpi_REPLACED_BY_cairo_surface_set_fallback_resolution
108 #define cairo_svg_surface_set_dpi cairo_svg_surface_set_dpi_REPLACED_BY_cairo_surface_set_fallback_resolution
109 #define cairo_atsui_font_face_create_for_atsu_font_id cairo_atsui_font_face_create_for_atsu_font_id_REPLACED_BY_cairo_quartz_font_face_create_for_atsu_font_id
111 #define cairo_current_path cairo_current_path_DEPRECATED_BY_cairo_copy_path
112 #define cairo_current_path_flat cairo_current_path_flat_DEPRECATED_BY_cairo_copy_path_flat
113 #define cairo_get_path cairo_get_path_DEPRECATED_BY_cairo_copy_path
114 #define cairo_get_path_flat cairo_get_path_flat_DEPRECATED_BY_cairo_get_path_flat
115 #define cairo_set_alpha cairo_set_alpha_DEPRECATED_BY_cairo_set_source_rgba_OR_cairo_paint_with_alpha
116 #define cairo_show_surface cairo_show_surface_DEPRECATED_BY_cairo_set_source_surface_AND_cairo_paint
117 #define cairo_copy cairo_copy_DEPRECATED_BY_cairo_create_AND_MANY_INDIVIDUAL_FUNCTIONS
118 #define cairo_surface_set_repeat cairo_surface_set_repeat_DEPRECATED_BY_cairo_pattern_set_extend
119 #define cairo_surface_set_matrix cairo_surface_set_matrix_DEPRECATED_BY_cairo_pattern_set_matrix
120 #define cairo_surface_get_matrix cairo_surface_get_matrix_DEPRECATED_BY_cairo_pattern_get_matrix
121 #define cairo_surface_set_filter cairo_surface_set_filter_DEPRECATED_BY_cairo_pattern_set_filter
122 #define cairo_surface_get_filter cairo_surface_get_filter_DEPRECATED_BY_cairo_pattern_get_filter
123 #define cairo_matrix_create cairo_matrix_create_DEPRECATED_BY_cairo_matrix_t
124 #define cairo_matrix_destroy cairo_matrix_destroy_DEPRECATED_BY_cairo_matrix_t
125 #define cairo_matrix_copy cairo_matrix_copy_DEPRECATED_BY_cairo_matrix_t
126 #define cairo_matrix_get_affine cairo_matrix_get_affine_DEPRECATED_BY_cairo_matrix_t
127 #define cairo_set_target_surface cairo_set_target_surface_DEPRECATED_BY_cairo_create
128 #define cairo_set_target_glitz cairo_set_target_glitz_DEPRECATED_BY_cairo_glitz_surface_create
129 #define cairo_set_target_image cairo_set_target_image_DEPRECATED_BY_cairo_image_surface_create_for_data
130 #define cairo_set_target_pdf cairo_set_target_pdf_DEPRECATED_BY_cairo_pdf_surface_create
131 #define cairo_set_target_png cairo_set_target_png_DEPRECATED_BY_cairo_surface_write_to_png
132 #define cairo_set_target_ps cairo_set_target_ps_DEPRECATED_BY_cairo_ps_surface_create
133 #define cairo_set_target_quartz cairo_set_target_quartz_DEPRECATED_BY_cairo_quartz_surface_create
134 #define cairo_set_target_win32 cairo_set_target_win32_DEPRECATED_BY_cairo_win32_surface_create
135 #define cairo_set_target_xcb cairo_set_target_xcb_DEPRECATED_BY_cairo_xcb_surface_create
136 #define cairo_set_target_drawable cairo_set_target_drawable_DEPRECATED_BY_cairo_xlib_surface_create
137 #define cairo_get_status_string cairo_get_status_string_DEPRECATED_BY_cairo_status_AND_cairo_status_to_string
138 #define cairo_status_string cairo_status_string_DEPRECATED_BY_cairo_status_AND_cairo_status_to_string