python-cairocffi-doc 0.7.2-1 / usr / share / doc / python-cairocffi-doc / html / pixbuf.html

This file is indexed.

/usr/share/doc/python-cairocffi-doc/html/pixbuf.html is in python-cairocffi-doc 0.7.2-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Decoding images with GDK-PixBuf &mdash; cairocffi 0.7.2 documentation</title>
    
    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '0.7.2',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="top" title="cairocffi 0.7.2 documentation" href="index.html" />
    <link rel="next" title="Using XCB surfaces with xcffib" href="xcb.html" />
    <link rel="prev" title="Python API reference" href="api.html" />
   
  
  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9">

  </head>
  <body role="document">  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <span class="target" id="module-cairocffi.pixbuf"></span><div class="section" id="decoding-images-with-gdk-pixbuf">
<h1>Decoding images with GDK-PixBuf<a class="headerlink" href="#decoding-images-with-gdk-pixbuf" title="Permalink to this headline"></a></h1>
<p>The
<a class="reference internal" href="api.html#cairocffi.ImageSurface.create_from_png" title="cairocffi.ImageSurface.create_from_png"><code class="xref py py-meth docutils literal"><span class="pre">ImageSurface.create_from_png()</span></code></a>
method can decode PNG images and provide a cairo surface,
but what about other image formats?</p>
<p>The <a class="reference internal" href="#module-cairocffi.pixbuf" title="cairocffi.pixbuf"><code class="xref py py-mod docutils literal"><span class="pre">cairocffi.pixbuf</span></code></a> module uses <a class="reference external" href="https://live.gnome.org/GdkPixbuf">GDK-PixBuf</a>
to decode JPEG, GIF, and various other formats (depending on what is installed.)
If you don’t import this module,
it is possible to use the rest of cairocffi without having GDK-PixBuf installed.
GDK-PixBuf is an independent package since version 2.22,
but before that was part of <a class="reference external" href="http://www.gtk.org/">GTK+</a>.</p>
<p>This module also converts pixel data
since the internal format in GDK-PixBuf (big-endian RGBA)
is not the same as in cairo (native-endian ARGB).
For this reason, although it is a &#8220;toy&#8221; API,
<a class="reference internal" href="api.html#cairocffi.ImageSurface.create_from_png" title="cairocffi.ImageSurface.create_from_png"><code class="xref py py-meth docutils literal"><span class="pre">ImageSurface.create_from_png()</span></code></a>
can be faster than <a class="reference internal" href="#cairocffi.pixbuf.decode_to_image_surface" title="cairocffi.pixbuf.decode_to_image_surface"><code class="xref py py-func docutils literal"><span class="pre">decode_to_image_surface()</span></code></a>
if the format is known to be PNG.
The pixel conversion is done by GTK+ if available,
but a (slower) fallback method is used otherwise.</p>
<dl class="exception">
<dt id="cairocffi.pixbuf.ImageLoadingError">
<em class="property">exception </em><code class="descclassname">cairocffi.pixbuf.</code><code class="descname">ImageLoadingError</code><a class="headerlink" href="#cairocffi.pixbuf.ImageLoadingError" title="Permalink to this definition"></a></dt>
<dd><p>PixBuf returned an error when loading an image.</p>
<p>The image data is probably corrupted.</p>
</dd></dl>

<dl class="function">
<dt id="cairocffi.pixbuf.decode_to_image_surface">
<code class="descclassname">cairocffi.pixbuf.</code><code class="descname">decode_to_image_surface</code><span class="sig-paren">(</span><em>image_data</em><span class="sig-paren">)</span><a class="headerlink" href="#cairocffi.pixbuf.decode_to_image_surface" title="Permalink to this definition"></a></dt>
<dd><p>Decode an image from memory into a cairo surface.
The file format is detected automatically.</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>image_data</strong> &#8211; A byte string</td>
</tr>
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A tuple of a new <a class="reference internal" href="api.html#cairocffi.ImageSurface" title="cairocffi.ImageSurface"><code class="xref py py-class docutils literal"><span class="pre">ImageSurface</span></code></a> object
and the name of the detected image format.</td>
</tr>
<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference internal" href="#cairocffi.pixbuf.ImageLoadingError" title="cairocffi.pixbuf.ImageLoadingError"><code class="xref py py-exc docutils literal"><span class="pre">ImageLoadingError</span></code></a> if the image data is invalid
or in an unsupported format.</td>
</tr>
</tbody>
</table>
</dd></dl>

</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper"><div class="relations">
<h3>Related Topics</h3>
<ul>
  <li><a href="index.html">Documentation overview</a><ul>
      <li>Previous: <a href="api.html" title="previous chapter">Python API reference</a></li>
      <li>Next: <a href="xcb.html" title="next chapter">Using XCB surfaces with xcffib</a></li>
  </ul></li>
</ul>
</div>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/pixbuf.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="footer">
      &copy;2013, Simon Sapin.
      
      |
      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.3.3</a>
      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.6</a>
      
      |
      <a href="_sources/pixbuf.txt"
          rel="nofollow">Page source</a>
    </div>

    

    
  </body>
</html>

APT Browse - Built by Thomas Orozco.