~ubuntu-branches/ubuntu/jaunty/goffice/jaunty-updates

« back to all changes in this revision

Viewing changes to docs/reference/xml/go-pixbuf.xml

  • Committer: Bazaar Package Importer
  • Author(s): Gauvain Pocentek
  • Date: 2008-11-09 18:10:54 UTC
  • mfrom: (1.1.17 upstream)
  • Revision ID: james.westby@ubuntu.com-20081109181054-uazweo6uci8h7bc5
Tags: 0.6.5-1ubuntu1
* Merge from debian unstable, remaining changes:
  - call intltool-update -p in debian/rules
  - libgoffice-gtk-0-6 is a transitional package
  - libgoffice-0-6 conflicts with libgoffice-gtk-0-6 (<< 0.6.3-1ubuntu2)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0"?>
 
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
 
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
 
4
<!ENTITY version SYSTEM "version.xml">
 
5
]
 
6
>
 
7
<refentry id="goffice-06-go-pixbuf">
 
8
<refmeta>
 
9
<refentrytitle role="top_of_page" id="goffice-06-go-pixbuf.top_of_page">go-pixbuf</refentrytitle>
 
10
<manvolnum>3</manvolnum>
 
11
<refmiscinfo>GOFFICE-0.6 Library</refmiscinfo>
 
12
</refmeta>
 
13
 
 
14
<refnamediv>
 
15
<refname>go-pixbuf</refname>
 
16
<refpurpose></refpurpose>
 
17
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
 
18
</refnamediv>
 
19
 
 
20
<refsynopsisdiv id="goffice-06-go-pixbuf.synopsis" role="synopsis">
 
21
<title role="synopsis.title">Synopsis</title>
 
22
 
 
23
<synopsis>
 
24
<link linkend="GdkPixbuf">GdkPixbuf</link> *         <link linkend="go-pixbuf-intelligent-scale">go_pixbuf_intelligent_scale</link>         (<link linkend="GdkPixbuf">GdkPixbuf</link> *buf,
 
25
                                                         <link linkend="guint">guint</link> width,
 
26
                                                         <link linkend="guint">guint</link> height);
 
27
<link linkend="GdkPixbuf">GdkPixbuf</link> *         <link linkend="go-pixbuf-new-from-file">go_pixbuf_new_from_file</link>             (<link linkend="char">char</link> const *filename);
 
28
<link linkend="GdkPixbuf">GdkPixbuf</link> *         <link linkend="go-pixbuf-get-from-cache">go_pixbuf_get_from_cache</link>            (<link linkend="char">char</link> const *filename);
 
29
<link linkend="GdkPixbuf">GdkPixbuf</link> *         <link linkend="go-pixbuf-tile">go_pixbuf_tile</link>                      (<link linkend="GdkPixbuf">GdkPixbuf</link> const *src,
 
30
                                                         <link linkend="guint">guint</link> w,
 
31
                                                         <link linkend="guint">guint</link> h);
 
32
</synopsis>
 
33
</refsynopsisdiv>
 
34
 
 
35
 
 
36
 
 
37
 
 
38
 
 
39
 
 
40
 
 
41
 
 
42
 
 
43
<refsect1 id="goffice-06-go-pixbuf.description" role="desc">
 
44
<title role="desc.title">Description</title>
 
45
<para>
 
46
 
 
47
</para>
 
48
</refsect1>
 
49
 
 
50
<refsect1 id="goffice-06-go-pixbuf.details" role="details">
 
51
<title role="details.title">Details</title>
 
52
<refsect2 id="go-pixbuf-intelligent-scale" role="function">
 
53
<title>go_pixbuf_intelligent_scale ()</title>
 
54
<indexterm zone="go-pixbuf-intelligent-scale"><primary>go_pixbuf_intelligent_scale</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link> *         go_pixbuf_intelligent_scale         (<link linkend="GdkPixbuf">GdkPixbuf</link> *buf,
 
55
                                                         <link linkend="guint">guint</link> width,
 
56
                                                         <link linkend="guint">guint</link> height);</programlisting>
 
57
<para>
 
58
Intelligent pixbuf scaling.</para>
 
59
<para>
 
60
 
 
61
</para><variablelist role="params">
 
62
<varlistentry><term><parameter>buf</parameter>&nbsp;:</term>
 
63
<listitem><simpara> a <link linkend="GdkPixbuf"><type>GdkPixbuf</type></link>
 
64
</simpara></listitem></varlistentry>
 
65
<varlistentry><term><parameter>width</parameter>&nbsp;:</term>
 
66
<listitem><simpara> new width
 
67
</simpara></listitem></varlistentry>
 
68
<varlistentry><term><parameter>height</parameter>&nbsp;:</term>
 
69
<listitem><simpara> new height
 
70
</simpara></listitem></varlistentry>
 
71
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new GdkPixbuf reference.
 
72
</simpara></listitem></varlistentry>
 
73
</variablelist></refsect2>
 
74
<refsect2 id="go-pixbuf-new-from-file" role="function">
 
75
<title>go_pixbuf_new_from_file ()</title>
 
76
<indexterm zone="go-pixbuf-new-from-file"><primary>go_pixbuf_new_from_file</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link> *         go_pixbuf_new_from_file             (<link linkend="char">char</link> const *filename);</programlisting>
 
77
<para>
 
78
Utility routine to create pixbufs from file <parameter>name</parameter> in the goffice_icon_dir.</para>
 
79
<para>
 
80
 
 
81
</para><variablelist role="params">
 
82
<varlistentry><term><parameter>filename</parameter>&nbsp;:</term>
 
83
<listitem><simpara> pixbuf filename
 
84
</simpara></listitem></varlistentry>
 
85
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a GdkPixbuf that the caller is responsible for.
 
86
</simpara></listitem></varlistentry>
 
87
</variablelist></refsect2>
 
88
<refsect2 id="go-pixbuf-get-from-cache" role="function">
 
89
<title>go_pixbuf_get_from_cache ()</title>
 
90
<indexterm zone="go-pixbuf-get-from-cache"><primary>go_pixbuf_get_from_cache</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link> *         go_pixbuf_get_from_cache            (<link linkend="char">char</link> const *filename);</programlisting>
 
91
<para>
 
92
Retrieves a pixbuf from the image cache, loading it from the file 
 
93
<parameter>filename</parameter> located in goffice_icon_dir if not cached yet.</para>
 
94
<para>
 
95
 
 
96
</para><variablelist role="params">
 
97
<varlistentry><term><parameter>filename</parameter>&nbsp;:</term>
 
98
<listitem><simpara> pixbuf filename
 
99
</simpara></listitem></varlistentry>
 
100
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a GdkPixbuf, NULL on error.
 
101
</simpara></listitem></varlistentry>
 
102
</variablelist></refsect2>
 
103
<refsect2 id="go-pixbuf-tile" role="function">
 
104
<title>go_pixbuf_tile ()</title>
 
105
<indexterm zone="go-pixbuf-tile"><primary>go_pixbuf_tile</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link> *         go_pixbuf_tile                      (<link linkend="GdkPixbuf">GdkPixbuf</link> const *src,
 
106
                                                         <link linkend="guint">guint</link> w,
 
107
                                                         <link linkend="guint">guint</link> h);</programlisting>
 
108
<para>
 
109
</para>
 
110
<para>
 
111
 
 
112
</para><variablelist role="params">
 
113
<varlistentry><term><parameter>src</parameter>&nbsp;:</term>
 
114
<listitem><simpara> source pixbuf
 
115
</simpara></listitem></varlistentry>
 
116
<varlistentry><term><parameter>w</parameter>&nbsp;:</term>
 
117
<listitem><simpara> desired width
 
118
</simpara></listitem></varlistentry>
 
119
<varlistentry><term><parameter>h</parameter>&nbsp;:</term>
 
120
<listitem><simpara> desired height
 
121
</simpara></listitem></varlistentry>
 
122
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new pixbuf consisting of the source pixbuf tiled
 
123
enough times to fill out the space needed.
 
124
 
 
125
The fractional tiles are spead evenly left-right and top-bottom.
 
126
</simpara></listitem></varlistentry>
 
127
</variablelist></refsect2>
 
128
 
 
129
</refsect1>
 
130
 
 
131
 
 
132
 
 
133
 
 
134
</refentry>