123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834 |
- <?xml version="1.0"?>
- <!-- This file was automatically generated from C sources - DO NOT EDIT!
- To affect the contents of this file, edit the original C definitions,
- and/or use gtk-doc annotations. -->
- <repository version="1.2"
- xmlns="http://www.gtk.org/introspection/core/1.0"
- xmlns:c="http://www.gtk.org/introspection/c/1.0"
- xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
- <include name="GObject" version="2.0"/>
- <include name="Pango" version="1.0"/>
- <include name="PangoFT2" version="1.0"/>
- <include name="cairo" version="1.0"/>
- <package name="pangocairo"/>
- <c:include name="pango/pangocairo.h"/>
- <namespace name="PangoCairo"
- version="1.0"
- shared-library="libpango-1.0.so.0,libpangocairo-1.0.so.0,libpango-1.0.so.0,libpangoft2-1.0.so.0"
- c:identifier-prefixes="PangoCairo"
- c:symbol-prefixes="pango_cairo">
- <class name="FcFontMap"
- c:symbol-prefix="fc_font_map"
- c:type="PangoCairoFcFontMap"
- parent="Pango.FontMap"
- glib:type-name="PangoCairoFcFontMap"
- glib:get-type="pango_cairo_fc_font_map_get_type">
- <implements name="FontMap"/>
- <field name="parent_instance" introspectable="0">
- <type c:type="PangoFcFontMap"/>
- </field>
- <field name="serial">
- <type name="guint" c:type="guint"/>
- </field>
- <field name="dpi">
- <type name="gdouble" c:type="double"/>
- </field>
- <field name="library">
- <type name="freetype2.Library" c:type="FT_Library"/>
- </field>
- </class>
- <interface name="Font"
- c:symbol-prefix="font"
- c:type="PangoCairoFont"
- version="1.18"
- glib:type-name="PangoCairoFont"
- glib:get-type="pango_cairo_font_get_type">
- <doc xml:space="preserve">#PangoCairoFont is an interface exported by fonts for
- use with Cairo. The actual type of the font will depend
- on the particular font technology Cairo was compiled to use.</doc>
- <prerequisite name="Pango.Font"/>
- <method name="get_scaled_font"
- c:identifier="pango_cairo_font_get_scaled_font"
- version="1.18">
- <doc xml:space="preserve">Gets the #cairo_scaled_font_t used by @font.
- The scaled font can be referenced and kept using
- cairo_scaled_font_reference().</doc>
- <return-value transfer-ownership="full" nullable="1">
- <doc xml:space="preserve">the #cairo_scaled_font_t used by @font,
- or %NULL if @font is %NULL.</doc>
- <type name="cairo.ScaledFont" c:type="cairo_scaled_font_t*"/>
- </return-value>
- <parameters>
- <instance-parameter name="font" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoFont from a #PangoCairoFontMap</doc>
- <type name="Font" c:type="PangoCairoFont*"/>
- </instance-parameter>
- </parameters>
- </method>
- </interface>
- <interface name="FontMap"
- c:symbol-prefix="font_map"
- c:type="PangoCairoFontMap"
- version="1.10"
- glib:type-name="PangoCairoFontMap"
- glib:get-type="pango_cairo_font_map_get_type">
- <doc xml:space="preserve">#PangoCairoFontMap is an interface exported by font maps for
- use with Cairo. The actual type of the font map will depend
- on the particular font technology Cairo was compiled to use.</doc>
- <prerequisite name="Pango.FontMap"/>
- <function name="get_default"
- c:identifier="pango_cairo_font_map_get_default"
- version="1.10">
- <doc xml:space="preserve">Gets a default #PangoCairoFontMap to use with Cairo.
- Note that the type of the returned object will depend
- on the particular font backend Cairo was compiled to use;
- You generally should only use the #PangoFontMap and
- #PangoCairoFontMap interfaces on the returned object.
- The default Cairo fontmap can be changed by using
- pango_cairo_font_map_set_default(). This can be used to
- change the Cairo font backend that the default fontmap
- uses for example.
- Note that since Pango 1.32.6, the default fontmap is per-thread.
- Each thread gets its own default fontmap. In this way,
- PangoCairo can be used safely from multiple threads.</doc>
- <return-value transfer-ownership="none">
- <doc xml:space="preserve">the default PangoCairo fontmap
- for the current thread. This object is owned by Pango and must not be freed.</doc>
- <type name="Pango.FontMap" c:type="PangoFontMap*"/>
- </return-value>
- </function>
- <function name="new"
- c:identifier="pango_cairo_font_map_new"
- version="1.10">
- <doc xml:space="preserve">Creates a new #PangoCairoFontMap object; a fontmap is used
- to cache information about available fonts, and holds
- certain global parameters such as the resolution.
- In most cases, you can use pango_cairo_font_map_get_default()
- instead.
- Note that the type of the returned object will depend
- on the particular font backend Cairo was compiled to use;
- You generally should only use the #PangoFontMap and
- #PangoCairoFontMap interfaces on the returned object.
- You can override the type of backend returned by using an
- environment variable %PANGOCAIRO_BACKEND. Supported types,
- based on your build, are fc (fontconfig), win32, and coretext.
- If requested type is not available, NULL is returned. Ie.
- this is only useful for testing, when at least two backends
- are compiled in.</doc>
- <return-value transfer-ownership="full">
- <doc xml:space="preserve">the newly allocated #PangoFontMap,
- which should be freed with g_object_unref().</doc>
- <type name="Pango.FontMap" c:type="PangoFontMap*"/>
- </return-value>
- </function>
- <function name="new_for_font_type"
- c:identifier="pango_cairo_font_map_new_for_font_type"
- version="1.18">
- <doc xml:space="preserve">Creates a new #PangoCairoFontMap object of the type suitable
- to be used with cairo font backend of type @fonttype.
- In most cases one should simply use @pango_cairo_font_map_new(),
- or in fact in most of those cases, just use
- @pango_cairo_font_map_get_default().</doc>
- <return-value transfer-ownership="full" nullable="1">
- <doc xml:space="preserve">the newly allocated
- #PangoFontMap of suitable type which should be freed
- with g_object_unref(), or %NULL if the requested
- cairo font backend is not supported / compiled in.</doc>
- <type name="Pango.FontMap" c:type="PangoFontMap*"/>
- </return-value>
- <parameters>
- <parameter name="fonttype" transfer-ownership="none">
- <doc xml:space="preserve">desired #cairo_font_type_t</doc>
- <type name="cairo.FontType" c:type="cairo_font_type_t"/>
- </parameter>
- </parameters>
- </function>
- <method name="create_context"
- c:identifier="pango_cairo_font_map_create_context"
- version="1.10"
- introspectable="0"
- deprecated="1"
- deprecated-version="1.22">
- <doc xml:space="preserve">Create a #PangoContext for the given fontmap.</doc>
- <doc-deprecated xml:space="preserve">Use pango_font_map_create_context() instead.</doc-deprecated>
- <return-value>
- <doc xml:space="preserve">the newly created context; free with g_object_unref().</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </return-value>
- <parameters>
- <instance-parameter name="fontmap" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoCairoFontMap</doc>
- <type name="FontMap" c:type="PangoCairoFontMap*"/>
- </instance-parameter>
- </parameters>
- </method>
- <method name="get_font_type"
- c:identifier="pango_cairo_font_map_get_font_type"
- version="1.18">
- <doc xml:space="preserve">Gets the type of Cairo font backend that @fontmap uses.</doc>
- <return-value transfer-ownership="full">
- <doc xml:space="preserve">the #cairo_font_type_t cairo font backend type</doc>
- <type name="cairo.FontType" c:type="cairo_font_type_t"/>
- </return-value>
- <parameters>
- <instance-parameter name="fontmap" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoCairoFontMap</doc>
- <type name="FontMap" c:type="PangoCairoFontMap*"/>
- </instance-parameter>
- </parameters>
- </method>
- <method name="get_resolution"
- c:identifier="pango_cairo_font_map_get_resolution"
- version="1.10">
- <doc xml:space="preserve">Gets the resolution for the fontmap. See pango_cairo_font_map_set_resolution()</doc>
- <return-value transfer-ownership="none">
- <doc xml:space="preserve">the resolution in "dots per inch"</doc>
- <type name="gdouble" c:type="double"/>
- </return-value>
- <parameters>
- <instance-parameter name="fontmap" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoCairoFontMap</doc>
- <type name="FontMap" c:type="PangoCairoFontMap*"/>
- </instance-parameter>
- </parameters>
- </method>
- <method name="set_default"
- c:identifier="pango_cairo_font_map_set_default"
- version="1.22">
- <doc xml:space="preserve">Sets a default #PangoCairoFontMap to use with Cairo.
- This can be used to change the Cairo font backend that the
- default fontmap uses for example. The old default font map
- is unreffed and the new font map referenced.
- Note that since Pango 1.32.6, the default fontmap is per-thread.
- This function only changes the default fontmap for
- the current thread. Default fontmaps of exisiting threads
- are not changed. Default fontmaps of any new threads will
- still be created using pango_cairo_font_map_new().
- A value of %NULL for @fontmap will cause the current default
- font map to be released and a new default font
- map to be created on demand, using pango_cairo_font_map_new().</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <instance-parameter name="fontmap"
- transfer-ownership="none"
- nullable="1"
- allow-none="1">
- <doc xml:space="preserve">The new default font map, or %NULL</doc>
- <type name="FontMap" c:type="PangoCairoFontMap*"/>
- </instance-parameter>
- </parameters>
- </method>
- <method name="set_resolution"
- c:identifier="pango_cairo_font_map_set_resolution"
- version="1.10">
- <doc xml:space="preserve">Sets the resolution for the fontmap. This is a scale factor between
- points specified in a #PangoFontDescription and Cairo units. The
- default value is 96, meaning that a 10 point font will be 13
- units high. (10 * 96. / 72. = 13.3).</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <instance-parameter name="fontmap" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoCairoFontMap</doc>
- <type name="FontMap" c:type="PangoCairoFontMap*"/>
- </instance-parameter>
- <parameter name="dpi" transfer-ownership="none">
- <doc xml:space="preserve">the resolution in "dots per inch". (Physical inches aren't actually
- involved; the terminology is conventional.)</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- </parameters>
- </method>
- </interface>
- <callback name="ShapeRendererFunc" c:type="PangoCairoShapeRendererFunc">
- <doc xml:space="preserve">Function type for rendering attributes of type %PANGO_ATTR_SHAPE
- with Pango's Cairo renderer.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context with current point set to where the shape should
- be rendered</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="attr" transfer-ownership="none">
- <doc xml:space="preserve">the %PANGO_ATTR_SHAPE to render</doc>
- <type name="Pango.AttrShape" c:type="PangoAttrShape*"/>
- </parameter>
- <parameter name="do_path" transfer-ownership="none">
- <doc xml:space="preserve">whether only the shape path should be appended to current
- path of @cr and no filling/stroking done. This will be set
- to %TRUE when called from pango_cairo_layout_path() and
- pango_cairo_layout_line_path() rendering functions.</doc>
- <type name="gboolean" c:type="gboolean"/>
- </parameter>
- <parameter name="data"
- transfer-ownership="none"
- nullable="1"
- allow-none="1">
- <doc xml:space="preserve">user data passed to pango_cairo_context_set_shape_renderer()</doc>
- <type name="gpointer" c:type="gpointer"/>
- </parameter>
- </parameters>
- </callback>
- <function name="context_get_font_options"
- c:identifier="pango_cairo_context_get_font_options"
- version="1.10">
- <doc xml:space="preserve">Retrieves any font rendering options previously set with
- pango_cairo_context_set_font_options(). This function does not report options
- that are derived from the target surface by pango_cairo_update_context()</doc>
- <return-value transfer-ownership="none" nullable="1">
- <doc xml:space="preserve">the font options previously set on the
- context, or %NULL if no options have been set. This value is
- owned by the context and must not be modified or freed.</doc>
- <type name="cairo.FontOptions" c:type="const cairo_font_options_t*"/>
- </return-value>
- <parameters>
- <parameter name="context" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoContext, from a pangocairo font map</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </parameter>
- </parameters>
- </function>
- <function name="context_get_resolution"
- c:identifier="pango_cairo_context_get_resolution"
- version="1.10">
- <doc xml:space="preserve">Gets the resolution for the context. See pango_cairo_context_set_resolution()</doc>
- <return-value transfer-ownership="none">
- <doc xml:space="preserve">the resolution in "dots per inch". A negative value will
- be returned if no resolution has previously been set.</doc>
- <type name="gdouble" c:type="double"/>
- </return-value>
- <parameters>
- <parameter name="context" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoContext, from a pangocairo font map</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </parameter>
- </parameters>
- </function>
- <function name="context_get_shape_renderer"
- c:identifier="pango_cairo_context_get_shape_renderer"
- version="1.18"
- introspectable="0">
- <doc xml:space="preserve">Sets callback function for context to use for rendering attributes
- of type %PANGO_ATTR_SHAPE. See #PangoCairoShapeRendererFunc for
- details.
- Retrieves callback function and associated user data for rendering
- attributes of type %PANGO_ATTR_SHAPE as set by
- pango_cairo_context_set_shape_renderer(), if any.</doc>
- <return-value nullable="1">
- <doc xml:space="preserve">the shape rendering callback previously
- set on the context, or %NULL if no shape rendering callback have
- been set.</doc>
- <type name="ShapeRendererFunc" c:type="PangoCairoShapeRendererFunc"/>
- </return-value>
- <parameters>
- <parameter name="context" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoContext, from a pangocairo font map</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </parameter>
- <parameter name="data"
- transfer-ownership="none"
- nullable="1"
- allow-none="1">
- <doc xml:space="preserve">Pointer to #gpointer to return user data</doc>
- <type name="gpointer" c:type="gpointer*"/>
- </parameter>
- </parameters>
- </function>
- <function name="context_set_font_options"
- c:identifier="pango_cairo_context_set_font_options"
- version="1.10">
- <doc xml:space="preserve">Sets the font options used when rendering text with this context.
- These options override any options that pango_cairo_update_context()
- derives from the target surface.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="context" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoContext, from a pangocairo font map</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </parameter>
- <parameter name="options"
- transfer-ownership="none"
- nullable="1"
- allow-none="1">
- <doc xml:space="preserve">a #cairo_font_options_t, or %NULL to unset
- any previously set options. A copy is made.</doc>
- <type name="cairo.FontOptions" c:type="const cairo_font_options_t*"/>
- </parameter>
- </parameters>
- </function>
- <function name="context_set_resolution"
- c:identifier="pango_cairo_context_set_resolution"
- version="1.10">
- <doc xml:space="preserve">Sets the resolution for the context. This is a scale factor between
- points specified in a #PangoFontDescription and Cairo units. The
- default value is 96, meaning that a 10 point font will be 13
- units high. (10 * 96. / 72. = 13.3).</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="context" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoContext, from a pangocairo font map</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </parameter>
- <parameter name="dpi" transfer-ownership="none">
- <doc xml:space="preserve">the resolution in "dots per inch". (Physical inches aren't actually
- involved; the terminology is conventional.) A 0 or negative value
- means to use the resolution from the font map.</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- </parameters>
- </function>
- <function name="context_set_shape_renderer"
- c:identifier="pango_cairo_context_set_shape_renderer"
- version="1.18">
- <doc xml:space="preserve">Sets callback function for context to use for rendering attributes
- of type %PANGO_ATTR_SHAPE. See #PangoCairoShapeRendererFunc for
- details.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="context" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoContext, from a pangocairo font map</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </parameter>
- <parameter name="func"
- transfer-ownership="none"
- nullable="1"
- allow-none="1"
- scope="notified"
- closure="2"
- destroy="3">
- <doc xml:space="preserve">Callback function for rendering attributes of
- type %PANGO_ATTR_SHAPE, or %NULL to disable shape rendering.</doc>
- <type name="ShapeRendererFunc" c:type="PangoCairoShapeRendererFunc"/>
- </parameter>
- <parameter name="data"
- transfer-ownership="none"
- nullable="1"
- allow-none="1">
- <doc xml:space="preserve">User data that will be passed to @func.</doc>
- <type name="gpointer" c:type="gpointer"/>
- </parameter>
- <parameter name="dnotify" transfer-ownership="none" scope="async">
- <doc xml:space="preserve">Callback that will be called when the
- context is freed to release @data, or %NULL.</doc>
- <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
- </parameter>
- </parameters>
- </function>
- <function name="create_context"
- c:identifier="pango_cairo_create_context"
- version="1.22">
- <doc xml:space="preserve">Creates a context object set up to match the current transformation
- and target surface of the Cairo context. This context can then be
- used to create a layout using pango_layout_new().
- This function is a convenience function that creates a context using
- the default font map, then updates it to @cr. If you just need to
- create a layout for use with @cr and do not need to access #PangoContext
- directly, you can use pango_cairo_create_layout() instead.</doc>
- <return-value transfer-ownership="full">
- <doc xml:space="preserve">the newly created #PangoContext. Free with
- g_object_unref().</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- </parameters>
- </function>
- <function name="create_layout"
- c:identifier="pango_cairo_create_layout"
- version="1.10">
- <doc xml:space="preserve">Creates a layout object set up to match the current transformation
- and target surface of the Cairo context. This layout can then be
- used for text measurement with functions like
- pango_layout_get_size() or drawing with functions like
- pango_cairo_show_layout(). If you change the transformation
- or target surface for @cr, you need to call pango_cairo_update_layout()
- This function is the most convenient way to use Cairo with Pango,
- however it is slightly inefficient since it creates a separate
- #PangoContext object for each layout. This might matter in an
- application that was laying out large amounts of text.</doc>
- <return-value transfer-ownership="full">
- <doc xml:space="preserve">the newly created #PangoLayout. Free with
- g_object_unref().</doc>
- <type name="Pango.Layout" c:type="PangoLayout*"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- </parameters>
- </function>
- <function name="error_underline_path"
- c:identifier="pango_cairo_error_underline_path"
- version="1.14">
- <doc xml:space="preserve">Add a squiggly line to the current path in the specified cairo context that
- approximately covers the given rectangle in the style of an underline used
- to indicate a spelling error. (The width of the underline is rounded to an
- integer number of up/down segments and the resulting rectangle is centered
- in the original rectangle)</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="x" transfer-ownership="none">
- <doc xml:space="preserve">The X coordinate of one corner of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- <parameter name="y" transfer-ownership="none">
- <doc xml:space="preserve">The Y coordinate of one corner of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- <parameter name="width" transfer-ownership="none">
- <doc xml:space="preserve">Non-negative width of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- <parameter name="height" transfer-ownership="none">
- <doc xml:space="preserve">Non-negative height of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- </parameters>
- </function>
- <function name="font_map_get_default"
- c:identifier="pango_cairo_font_map_get_default"
- moved-to="FontMap.get_default"
- version="1.10">
- <doc xml:space="preserve">Gets a default #PangoCairoFontMap to use with Cairo.
- Note that the type of the returned object will depend
- on the particular font backend Cairo was compiled to use;
- You generally should only use the #PangoFontMap and
- #PangoCairoFontMap interfaces on the returned object.
- The default Cairo fontmap can be changed by using
- pango_cairo_font_map_set_default(). This can be used to
- change the Cairo font backend that the default fontmap
- uses for example.
- Note that since Pango 1.32.6, the default fontmap is per-thread.
- Each thread gets its own default fontmap. In this way,
- PangoCairo can be used safely from multiple threads.</doc>
- <return-value transfer-ownership="none">
- <doc xml:space="preserve">the default PangoCairo fontmap
- for the current thread. This object is owned by Pango and must not be freed.</doc>
- <type name="Pango.FontMap" c:type="PangoFontMap*"/>
- </return-value>
- </function>
- <function name="font_map_new"
- c:identifier="pango_cairo_font_map_new"
- moved-to="FontMap.new"
- version="1.10">
- <doc xml:space="preserve">Creates a new #PangoCairoFontMap object; a fontmap is used
- to cache information about available fonts, and holds
- certain global parameters such as the resolution.
- In most cases, you can use pango_cairo_font_map_get_default()
- instead.
- Note that the type of the returned object will depend
- on the particular font backend Cairo was compiled to use;
- You generally should only use the #PangoFontMap and
- #PangoCairoFontMap interfaces on the returned object.
- You can override the type of backend returned by using an
- environment variable %PANGOCAIRO_BACKEND. Supported types,
- based on your build, are fc (fontconfig), win32, and coretext.
- If requested type is not available, NULL is returned. Ie.
- this is only useful for testing, when at least two backends
- are compiled in.</doc>
- <return-value transfer-ownership="full">
- <doc xml:space="preserve">the newly allocated #PangoFontMap,
- which should be freed with g_object_unref().</doc>
- <type name="Pango.FontMap" c:type="PangoFontMap*"/>
- </return-value>
- </function>
- <function name="font_map_new_for_font_type"
- c:identifier="pango_cairo_font_map_new_for_font_type"
- moved-to="FontMap.new_for_font_type"
- version="1.18">
- <doc xml:space="preserve">Creates a new #PangoCairoFontMap object of the type suitable
- to be used with cairo font backend of type @fonttype.
- In most cases one should simply use @pango_cairo_font_map_new(),
- or in fact in most of those cases, just use
- @pango_cairo_font_map_get_default().</doc>
- <return-value transfer-ownership="full" nullable="1">
- <doc xml:space="preserve">the newly allocated
- #PangoFontMap of suitable type which should be freed
- with g_object_unref(), or %NULL if the requested
- cairo font backend is not supported / compiled in.</doc>
- <type name="Pango.FontMap" c:type="PangoFontMap*"/>
- </return-value>
- <parameters>
- <parameter name="fonttype" transfer-ownership="none">
- <doc xml:space="preserve">desired #cairo_font_type_t</doc>
- <type name="cairo.FontType" c:type="cairo_font_type_t"/>
- </parameter>
- </parameters>
- </function>
- <function name="glyph_string_path"
- c:identifier="pango_cairo_glyph_string_path"
- version="1.10">
- <doc xml:space="preserve">Adds the glyphs in @glyphs to the current path in the specified
- cairo context. The origin of the glyphs (the left edge of the baseline)
- will be at the current point of the cairo context.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="font" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoFont from a #PangoCairoFontMap</doc>
- <type name="Pango.Font" c:type="PangoFont*"/>
- </parameter>
- <parameter name="glyphs" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoGlyphString</doc>
- <type name="Pango.GlyphString" c:type="PangoGlyphString*"/>
- </parameter>
- </parameters>
- </function>
- <function name="layout_line_path"
- c:identifier="pango_cairo_layout_line_path"
- version="1.10">
- <doc xml:space="preserve">Adds the text in #PangoLayoutLine to the current path in the
- specified cairo context. The origin of the glyphs (the left edge
- of the line) will be at the current point of the cairo context.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="line" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoLayoutLine</doc>
- <type name="Pango.LayoutLine" c:type="PangoLayoutLine*"/>
- </parameter>
- </parameters>
- </function>
- <function name="layout_path"
- c:identifier="pango_cairo_layout_path"
- version="1.10">
- <doc xml:space="preserve">Adds the text in a #PangoLayout to the current path in the
- specified cairo context. The top-left corner of the #PangoLayout
- will be at the current point of the cairo context.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="layout" transfer-ownership="none">
- <doc xml:space="preserve">a Pango layout</doc>
- <type name="Pango.Layout" c:type="PangoLayout*"/>
- </parameter>
- </parameters>
- </function>
- <function name="show_error_underline"
- c:identifier="pango_cairo_show_error_underline"
- version="1.14">
- <doc xml:space="preserve">Draw a squiggly line in the specified cairo context that approximately
- covers the given rectangle in the style of an underline used to indicate a
- spelling error. (The width of the underline is rounded to an integer
- number of up/down segments and the resulting rectangle is centered in the
- original rectangle)</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="x" transfer-ownership="none">
- <doc xml:space="preserve">The X coordinate of one corner of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- <parameter name="y" transfer-ownership="none">
- <doc xml:space="preserve">The Y coordinate of one corner of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- <parameter name="width" transfer-ownership="none">
- <doc xml:space="preserve">Non-negative width of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- <parameter name="height" transfer-ownership="none">
- <doc xml:space="preserve">Non-negative height of the rectangle</doc>
- <type name="gdouble" c:type="double"/>
- </parameter>
- </parameters>
- </function>
- <function name="show_glyph_item"
- c:identifier="pango_cairo_show_glyph_item"
- version="1.22">
- <doc xml:space="preserve">Draws the glyphs in @glyph_item in the specified cairo context,
- embedding the text associated with the glyphs in the output if the
- output format supports it (PDF for example), otherwise it acts
- similar to pango_cairo_show_glyph_string().
- The origin of the glyphs (the left edge of the baseline) will
- be drawn at the current point of the cairo context.
- Note that @text is the start of the text for layout, which is then
- indexed by <literal>@glyph_item->item->offset</literal>.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="text" transfer-ownership="none">
- <doc xml:space="preserve">the UTF-8 text that @glyph_item refers to</doc>
- <type name="utf8" c:type="const char*"/>
- </parameter>
- <parameter name="glyph_item" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoGlyphItem</doc>
- <type name="Pango.GlyphItem" c:type="PangoGlyphItem*"/>
- </parameter>
- </parameters>
- </function>
- <function name="show_glyph_string"
- c:identifier="pango_cairo_show_glyph_string"
- version="1.10">
- <doc xml:space="preserve">Draws the glyphs in @glyphs in the specified cairo context.
- The origin of the glyphs (the left edge of the baseline) will
- be drawn at the current point of the cairo context.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="font" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoFont from a #PangoCairoFontMap</doc>
- <type name="Pango.Font" c:type="PangoFont*"/>
- </parameter>
- <parameter name="glyphs" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoGlyphString</doc>
- <type name="Pango.GlyphString" c:type="PangoGlyphString*"/>
- </parameter>
- </parameters>
- </function>
- <function name="show_layout"
- c:identifier="pango_cairo_show_layout"
- version="1.10">
- <doc xml:space="preserve">Draws a #PangoLayout in the specified cairo context.
- The top-left corner of the #PangoLayout will be drawn
- at the current point of the cairo context.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="layout" transfer-ownership="none">
- <doc xml:space="preserve">a Pango layout</doc>
- <type name="Pango.Layout" c:type="PangoLayout*"/>
- </parameter>
- </parameters>
- </function>
- <function name="show_layout_line"
- c:identifier="pango_cairo_show_layout_line"
- version="1.10">
- <doc xml:space="preserve">Draws a #PangoLayoutLine in the specified cairo context.
- The origin of the glyphs (the left edge of the line) will
- be drawn at the current point of the cairo context.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="line" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoLayoutLine</doc>
- <type name="Pango.LayoutLine" c:type="PangoLayoutLine*"/>
- </parameter>
- </parameters>
- </function>
- <function name="update_context"
- c:identifier="pango_cairo_update_context"
- version="1.10">
- <doc xml:space="preserve">Updates a #PangoContext previously created for use with Cairo to
- match the current transformation and target surface of a Cairo
- context. If any layouts have been created for the context,
- it's necessary to call pango_layout_context_changed() on those
- layouts.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="context" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoContext, from a pangocairo font map</doc>
- <type name="Pango.Context" c:type="PangoContext*"/>
- </parameter>
- </parameters>
- </function>
- <function name="update_layout"
- c:identifier="pango_cairo_update_layout"
- version="1.10">
- <doc xml:space="preserve">Updates the private #PangoContext of a #PangoLayout created with
- pango_cairo_create_layout() to match the current transformation
- and target surface of a Cairo context.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- <parameters>
- <parameter name="cr" transfer-ownership="none">
- <doc xml:space="preserve">a Cairo context</doc>
- <type name="cairo.Context" c:type="cairo_t*"/>
- </parameter>
- <parameter name="layout" transfer-ownership="none">
- <doc xml:space="preserve">a #PangoLayout, from pango_cairo_create_layout()</doc>
- <type name="Pango.Layout" c:type="PangoLayout*"/>
- </parameter>
- </parameters>
- </function>
- </namespace>
- </repository>
|