cairo/doc/reference/doc.xml
Owen Taylor 97424a3c2a Change cairo_font_t to refer to a font scaled to a particular output device resolution.
src/cairoint.h src/cairo_font.c src/cairo_ft_font.c src/cairo_xlib_surface.c src/cairo_pdf_surface.c src/cairo_gstate.c src/cairo.c: Switch many internal methods from handling cairo_unscaled_font_t and cairo_font_scale_t pairs to handling cairo_font_t.
src/cairo-ft-private.h src/cairo_ft_fontc: Add some internal interfaces for use by the FreeType backend.
Clear the gstate's current font when the transform or target surface changes.
src/cairo.h src/cairo_ft_font.c: Rename cairo_ft_font_pattern to cairo_ft_font_get_pattern().
src/cairo.h src/cairo_ft_font.c: Make cairo_ft_font_create() and cairo_ft_font_create_for_ft_face() take a font scale; make the latter take load_flags for FT_Load_Glyph() as well. Change cairo_ft_font_face() to Xft-style cairo_ft_font_lock_face, cairo_ft_font_unlock_face.
Remove the name/slant/weight=>unscaled font cache, it didn't work with the new cairo_font_t setup. If it turns out to be needed, it can be added back in some other form.
src/cairoint.h src/cairo_font.c: Add a 'flags' field to cairo_glyph_cache_key_t, we use it for load flags with freetype backend.
Switch the caching to be from resolved fontconfig pattern => file; keep only a fixed number of FT_Face objects open at once, similar to FreeType.
src/cairo_gstate.c src/cairoint.h: Add public cairo_font_glyph_extents, use it to implement _cairo_gstate_glyph_extents().
Add refcounting for glyph cache elements; there was an bug where elements got ejected from the cache and freed before they could be used.
src/cairoint.h src/cairo_cache.c (_cairo_cache_random_entry()) New function to return a random entry in the cache matching a predicate; reuse the internals for the previous _random_live_entry().
src/cairoint.h src/cairo_cache.c (_cairo_cache_lookup()): Add an optional created_entry return value.
src/cairo_ft_font.c src/cairo_xlib_surface.c: Adapt to _cairo_cache_lookup() change.
Support max_memory == 0 to indicate an unbounded cache.
src/cairoint.h src/cairo_cache.c (_cairo_cache_remove()): Add a function to manually remove entries from the cache.
Update for changes, document cairo_matrix_t, cairo_glyph_t, etc.
src/cairo.h src/cairo-atsui.h src/cairo-ft.h src/cairo-glitz.h src/cairo-pdf.h src/cairo-png.h src/cairo-ps.h src/cairo-quartz.h src/cairo-xcb.h src/cairo-xlib.h: Add CAIRO_BEGIN/END_DECLS for extern "C", use it on all public headers. Move header guards outermost.
Fix encoding.
2005-01-21 14:33:47 +00:00

223 lines
9.1 KiB
XML

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY cairo_create SYSTEM "xml/cairo_create.xml">
<!ENTITY cairo_reference SYSTEM "xml/cairo_reference.xml">
<!ENTITY cairo_destroy SYSTEM "xml/cairo_destroy.xml">
<!ENTITY cairo_save SYSTEM "xml/cairo_save.xml">
<!ENTITY cairo_restore SYSTEM "xml/cairo_restore.xml">
<!ENTITY cairo_copy SYSTEM "xml/cairo_copy.xml">
<!ENTITY cairo_push_group SYSTEM "xml/cairo_push_group.xml">
<!ENTITY cairo_pop_group SYSTEM "xml/cairo_pop_group.xml">
<!ENTITY cairo_set_target_surface SYSTEM "xml/cairo_set_target_surface.xml">
<!ENTITY cairo_set_target_image SYSTEM "xml/cairo_set_target_image.xml">
<!ENTITY cairo_set_target_ps SYSTEM "xml/cairo_set_target_ps.xml">
<!ENTITY cairo_set_target_drawable SYSTEM "xml/cairo_set_target_drawable.xml">
<!ENTITY cairo_set_target_xcb SYSTEM "xml/cairo_set_target_xcb.xml">
<!ENTITY cairo_set_target_png SYSTEM "xml/cairo_set_target_png.xml">
<!ENTITY cairo_set_operator SYSTEM "xml/cairo_set_operator.xml">
<!ENTITY cairo_set_rgb_color SYSTEM "xml/cairo_set_rgb_color.xml">
<!ENTITY cairo_set_alpha SYSTEM "xml/cairo_set_alpha.xml">
<!ENTITY cairo_set_pattern SYSTEM "xml/cairo_set_pattern.xml">
<!ENTITY cairo_set_tolerance SYSTEM "xml/cairo_set_tolerance.xml">
<!ENTITY cairo_set_fill_rule SYSTEM "xml/cairo_set_fill_rule.xml">
<!ENTITY cairo_set_line_width SYSTEM "xml/cairo_set_line_width.xml">
<!ENTITY cairo_set_line_cap SYSTEM "xml/cairo_set_line_cap.xml">
<!ENTITY cairo_set_line_join SYSTEM "xml/cairo_set_line_join.xml">
<!ENTITY cairo_set_dash SYSTEM "xml/cairo_set_dash.xml">
<!ENTITY cairo_set_miter_limit SYSTEM "xml/cairo_set_miter_limit.xml">
<!ENTITY cairo_translate SYSTEM "xml/cairo_translate.xml">
<!ENTITY cairo_scale SYSTEM "xml/cairo_scale.xml">
<!ENTITY cairo_rotate SYSTEM "xml/cairo_rotate.xml">
<!ENTITY cairo_default_matrix SYSTEM "xml/cairo_default_matrix.xml">
<!ENTITY cairo_identity_matrix SYSTEM "xml/cairo_identity_matrix.xml">
<!ENTITY cairo_transform_point SYSTEM "xml/cairo_transform_point.xml">
<!ENTITY cairo_transform_distance SYSTEM "xml/cairo_transform_distance.xml">
<!ENTITY cairo_inverse_transform_point SYSTEM "xml/cairo_inverse_transform_point.xml">
<!ENTITY cairo_inverse_transform_distance SYSTEM "xml/cairo_inverse_transform_distance.xml">
<!ENTITY cairo_new_path SYSTEM "xml/cairo_new_path.xml">
<!ENTITY cairo_move_to SYSTEM "xml/cairo_move_to.xml">
<!ENTITY cairo_line_to SYSTEM "xml/cairo_line_to.xml">
<!ENTITY cairo_arc SYSTEM "xml/cairo_arc.xml">
<!ENTITY cairo_arc_negative SYSTEM "xml/cairo_arc_negative.xml">
<!ENTITY cairo_rel_move_to SYSTEM "xml/cairo_rel_move_to.xml">
<!ENTITY cairo_rel_line_to SYSTEM "xml/cairo_rel_line_to.xml">
<!ENTITY cairo_rectangle SYSTEM "xml/cairo_rectangle.xml">
<!ENTITY cairo_curve_to SYSTEM "xml/cairo_curve_to.xml">
<!ENTITY cairo_stroke_path SYSTEM "xml/cairo_stroke_path.xml">
<!ENTITY cairo_close_path SYSTEM "xml/cairo_close_path.xml">
<!ENTITY cairo_stroke SYSTEM "xml/cairo_stroke.xml">
<!ENTITY cairo_fill SYSTEM "xml/cairo_fill.xml">
<!ENTITY cairo_clip SYSTEM "xml/cairo_clip.xml">
<!ENTITY cairo_select_font SYSTEM "xml/cairo_select_font.xml">
<!ENTITY cairo_scale_font SYSTEM "xml/cairo_scale_font.xml">
<!ENTITY cairo_set_font SYSTEM "xml/cairo_set_font.xml">
<!ENTITY cairo_show_text SYSTEM "xml/cairo_show_text.xml">
<!ENTITY cairo_text_extents SYSTEM "xml/cairo_text_extents.xml">
<!ENTITY cairo_current_operator SYSTEM "xml/cairo_current_operator.xml">
<!ENTITY cairo_current_rgb_color SYSTEM "xml/cairo_current_rgb_color.xml">
<!ENTITY cairo_current_alpha SYSTEM "xml/cairo_current_alpha.xml">
<!ENTITY cairo_current_tolerance SYSTEM "xml/cairo_current_tolerance.xml">
<!ENTITY cairo_current_point SYSTEM "xml/cairo_current_point.xml">
<!ENTITY cairo_current_fill_rule SYSTEM "xml/cairo_current_fill_rule.xml">
<!ENTITY cairo_current_line_width SYSTEM "xml/cairo_current_line_width.xml">
<!ENTITY cairo_current_line_cap SYSTEM "xml/cairo_current_line_cap.xml">
<!ENTITY cairo_current_line_join SYSTEM "xml/cairo_current_line_join.xml">
<!ENTITY cairo_current_miter_limit SYSTEM "xml/cairo_current_miter_limit.xml">
<!ENTITY cairo_current_matrix SYSTEM "xml/cairo_current_matrix.xml">
<!ENTITY cairo_current_target_surface SYSTEM "xml/cairo_current_target_surface.xml">
<!ENTITY cairo_status SYSTEM "xml/cairo_status.xml">
<!ENTITY cairo_status_string SYSTEM "xml/cairo_status_string.xml">
<!ENTITY cairo_surface_reference SYSTEM "xml/cairo_surface_reference.xml">
<!ENTITY cairo_surface_destroy SYSTEM "xml/cairo_surface_destroy.xml">
<!ENTITY cairo_surface_clip_restore SYSTEM "xml/cairo_surface_clip_restore.xml">
<!ENTITY cairo_surface_set_repeat SYSTEM "xml/cairo_surface_set_repeat.xml">
<!ENTITY cairo_surface_set_matrix SYSTEM "xml/cairo_surface_set_matrix.xml">
<!ENTITY cairo_surface_get_matrix SYSTEM "xml/cairo_surface_get_matrix.xml">
<!ENTITY cairo_surface_set_filter SYSTEM "xml/cairo_surface_set_filter.xml">
<!ENTITY cairo_matrix_create SYSTEM "xml/cairo_matrix_create.xml">
<!ENTITY cairo_matrix_destroy SYSTEM "xml/cairo_matrix_destroy.xml">
<!ENTITY cairo_matrix_copy SYSTEM "xml/cairo_matrix_copy.xml">
<!ENTITY cairo_matrix_set_identity SYSTEM "xml/cairo_matrix_set_identity.xml">
<!ENTITY cairo_matrix_translate SYSTEM "xml/cairo_matrix_translate.xml">
<!ENTITY cairo_matrix_scale SYSTEM "xml/cairo_matrix_scale.xml">
<!ENTITY cairo_matrix_rotate SYSTEM "xml/cairo_matrix_rotate.xml">
<!ENTITY cairo_matrix_invert SYSTEM "xml/cairo_matrix_invert.xml">
<!ENTITY cairo_matrix_multiply SYSTEM "xml/cairo_matrix_multiply.xml">
<!ENTITY cairo_matrix_transform_distance SYSTEM "xml/cairo_matrix_transform_distance.xml">
<!ENTITY cairo_matrix_transform_point SYSTEM "xml/cairo_matrix_transform_point.xml">
<!ENTITY cairo_font_glyph_extents SYSTEM "xml/cairo_font_glyph_extents.xml">
<!ENTITY cairo_ft_font_create SYSTEM "xml/cairo_ft_font_create.xml">
<!ENTITY cairo_ft_font_create_for_ft_face SYSTEM "xml/cairo_ft_font_create_for_ft_face.xml">
<!ENTITY cairo_ft_font_lock_face SYSTEM "xml/cairo_ft_font_lock_face.xml">
<!ENTITY cairo_ft_font_unlock_face SYSTEM "xml/cairo_ft_font_unlock_face.xml">
<!ENTITY cairo_ft_font_get_pattern SYSTEM "xml/cairo_ft_font_get_pattern.xml">
<!ENTITY cairo_t SYSTEM "xml/cairo_t.xml">
<!ENTITY cairo_font_t SYSTEM "xml/cairo_font_t.xml">
<!ENTITY cairo_glyph_t SYSTEM "xml/cairo_glyph_t.xml">
<!ENTITY cairo_matrix_t SYSTEM "xml/cairo_matrix_t.xml">
<!ENTITY cairo_surface_t SYSTEM "xml/cairo_surface_t.xml">
<!ENTITY cairo_format_t SYSTEM "xml/cairo_format_t.xml">
<!ENTITY cairo_operator_t SYSTEM "xml/cairo_operator_t.xml">
<!ENTITY cairo_fill_rule_t SYSTEM "xml/cairo_fill_rule_t.xml">
<!ENTITY cairo_line_cap_t SYSTEM "xml/cairo_line_cap_t.xml">
<!ENTITY cairo_matrix_t SYSTEM "xml/cairo_matrix_t.xml">
<!ENTITY cairo_text_extents_t SYSTEM "xml/cairo_text_extents_t.xml">
]>
<book lang="en">
<title>Cairo: A Vector Graphics Library</title>
<reference>
<title>functions</title>
&cairo_create;
&cairo_reference;
&cairo_destroy;
&cairo_save;
&cairo_restore;
&cairo_copy;
&cairo_push_group;
&cairo_pop_group;
&cairo_set_target_surface;
&cairo_set_target_image;
&cairo_set_target_ps;
&cairo_set_target_png;
&cairo_set_target_drawable;
&cairo_set_target_xcb;
&cairo_set_operator;
&cairo_set_rgb_color;
&cairo_set_alpha;
&cairo_set_pattern;
&cairo_set_tolerance;
&cairo_set_fill_rule;
&cairo_set_line_width;
&cairo_set_line_cap;
&cairo_set_line_join;
&cairo_set_dash;
&cairo_set_miter_limit;
&cairo_translate;
&cairo_scale;
&cairo_rotate;
&cairo_default_matrix;
&cairo_identity_matrix;
&cairo_transform_point;
&cairo_transform_distance;
&cairo_inverse_transform_point;
&cairo_inverse_transform_distance;
&cairo_new_path;
&cairo_move_to;
&cairo_line_to;
&cairo_arc;
&cairo_arc_negative;
&cairo_rel_move_to;
&cairo_rel_line_to;
&cairo_rectangle;
&cairo_curve_to;
&cairo_stroke_path;
&cairo_close_path;
&cairo_stroke;
&cairo_fill;
&cairo_clip;
&cairo_select_font;
&cairo_scale_font;
&cairo_set_font;
&cairo_show_text;
&cairo_text_extents;
&cairo_current_operator;
&cairo_current_rgb_color;
&cairo_current_alpha;
&cairo_current_tolerance;
&cairo_current_point;
&cairo_current_fill_rule;
&cairo_current_line_width;
&cairo_current_line_cap;
&cairo_current_line_join;
&cairo_current_miter_limit;
&cairo_current_matrix;
&cairo_current_target_surface;
&cairo_status;
&cairo_status_string;
&cairo_surface_reference;
&cairo_surface_destroy;
&cairo_surface_clip_restore;
&cairo_surface_set_repeat;
&cairo_surface_set_matrix;
&cairo_surface_get_matrix;
&cairo_surface_set_filter;
&cairo_matrix_create;
&cairo_matrix_destroy;
&cairo_matrix_copy;
&cairo_matrix_set_identity;
&cairo_matrix_translate;
&cairo_matrix_scale;
&cairo_matrix_rotate;
&cairo_matrix_invert;
&cairo_matrix_multiply;
&cairo_matrix_transform_distance;
&cairo_matrix_transform_point;
&cairo_font_glyph_extents;
&cairo_ft_font_create;
&cairo_ft_font_create_for_ft_face;
&cairo_ft_font_lock_face;
&cairo_ft_font_unlock_face;
&cairo_ft_font_get_pattern;
</reference>
<reference>
<title>types and enums</title>
&cairo_t;
&cairo_font_t;
&cairo_glyph_t;
&cairo_surface_t;
&cairo_format_t;
&cairo_operator_t;
&cairo_fill_rule_t;
&cairo_line_cap_t;
&cairo_matrix_t;
&cairo_text_extents_t;
</reference>
</book>