<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>3.1.0 — Pillow (PIL Fork) 5.4.1 documentation</title>
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></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>
<script type="text/javascript" src="../_static/language_data.js"></script>
<script type="text/javascript" src="../_static/js/script.js"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="author" title="About these documents" href="../about.html" />
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="3.0.0" href="3.0.0.html" />
<link rel="prev" title="3.1.1" href="3.1.1.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../index.html" class="icon icon-home"> Pillow (PIL Fork)
</a>
<div class="version">
5.4.1
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../installation.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../handbook/index.html">Handbook</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../porting.html">Porting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../about.html">About</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Release Notes</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="5.4.1.html">5.4.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="5.4.0.html">5.4.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="5.3.0.html">5.3.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="5.2.0.html">5.2.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="5.1.0.html">5.1.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="5.0.0.html">5.0.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="4.3.0.html">4.3.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="4.2.1.html">4.2.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="4.2.0.html">4.2.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="4.1.1.html">4.1.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="4.1.0.html">4.1.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="4.0.0.html">4.0.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="3.4.0.html">3.4.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="3.3.2.html">3.3.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="3.3.0.html">3.3.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="3.2.0.html">3.2.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="3.1.2.html">3.1.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="3.1.1.html">3.1.1</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">3.1.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#imagedraw-arc-chord-and-pieslice-can-now-use-floats">ImageDraw arc, chord and pieslice can now use floats</a></li>
<li class="toctree-l3"><a class="reference internal" href="#consistent-multiline-text-spacing">Consistent multiline text spacing</a></li>
<li class="toctree-l3"><a class="reference internal" href="#exif-jpeg-and-tiff-metadata">Exif, Jpeg and Tiff Metadata</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#tiffimageplugin-ifdrational">TiffImagePlugin.IFDRational</a></li>
<li class="toctree-l4"><a class="reference internal" href="#jpegimageplugin-getexif">JpegImagePlugin._getexif</a></li>
<li class="toctree-l4"><a class="reference internal" href="#out-of-spec-metadata">Out of Spec Metadata</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="3.0.0.html">3.0.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="2.8.0.html">2.8.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="2.7.0.html">2.7.0</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../deprecations.html">Deprecations and removals</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../index.html">Pillow (PIL Fork)</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../index.html">Docs</a> »</li>
<li><a href="index.html">Release Notes</a> »</li>
<li>3.1.0</li>
<li class="wy-breadcrumbs-aside">
<a href="../_sources/releasenotes/3.1.0.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="id1">
<h1>3.1.0<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
<div class="section" id="imagedraw-arc-chord-and-pieslice-can-now-use-floats">
<h2>ImageDraw arc, chord and pieslice can now use floats<a class="headerlink" href="#imagedraw-arc-chord-and-pieslice-can-now-use-floats" title="Permalink to this headline">¶</a></h2>
<p>There is no longer a need to ensure that the start and end arguments for <cite>arc</cite>,
<cite>chord</cite> and <cite>pieslice</cite> are integers.</p>
<p>Note that these numbers are not simply rounded internally, but are actually
utilised in the drawing process.</p>
</div>
<div class="section" id="consistent-multiline-text-spacing">
<h2>Consistent multiline text spacing<a class="headerlink" href="#consistent-multiline-text-spacing" title="Permalink to this headline">¶</a></h2>
<p>When using the <code class="docutils literal notranslate"><span class="pre">ImageDraw</span></code> multiline methods, the spacing between
lines was inconsistent, based on the combination on ascenders and
descenders.</p>
<p>This has now been fixed, so that lines are offset by their baselines,
not the absolute height of each line.</p>
<p>There is also now a default spacing of 4px between lines.</p>
</div>
<div class="section" id="exif-jpeg-and-tiff-metadata">
<h2>Exif, Jpeg and Tiff Metadata<a class="headerlink" href="#exif-jpeg-and-tiff-metadata" title="Permalink to this headline">¶</a></h2>
<p>There were major changes in the TIFF ImageFileDirectory support in
Pillow 3.0 that led to a number of regressions. Some of them have been
fixed in Pillow 3.1, and some of them have been extended to have
different behavior.</p>
<div class="section" id="tiffimageplugin-ifdrational">
<h3>TiffImagePlugin.IFDRational<a class="headerlink" href="#tiffimageplugin-ifdrational" title="Permalink to this headline">¶</a></h3>
<p>Pillow 3.0 changed rational metadata to use a float. In Pillow 3.1,
this has changed to allow the expression of 0/0 as a valid piece of
rational metadata to reflect usage in the wild.</p>
<p>Rational metadata is now encapsulated in an <code class="docutils literal notranslate"><span class="pre">IFDRational</span></code>
instance. This class extends the Rational class to allow a denominator
of 0. It compares as a float or a number, but does allow access to the
raw numerator and denominator values through attributes.</p>
<p>When used in a <code class="docutils literal notranslate"><span class="pre">ImageFileDirectory_v1</span></code>, a 2 item tuple is returned
of the numerator and denominator, as was done previously.</p>
<p>This class should be used when adding a rational value to an
ImageFileDirectory for saving to image metadata.</p>
</div>
<div class="section" id="jpegimageplugin-getexif">
<h3>JpegImagePlugin._getexif<a class="headerlink" href="#jpegimageplugin-getexif" title="Permalink to this headline">¶</a></h3>
<p>In Pillow 3.0, the dictionary returned from the private, experimental,
but generally widely used <code class="docutils literal notranslate"><span class="pre">_getexif</span></code> function changed to reflect the
ImageFileDirectory_v2 format, without a fallback to the previous format.</p>
<p>In Pillow 3.1, <code class="docutils literal notranslate"><span class="pre">_getexif</span></code> now returns a dictionary compatible with
Pillow 2.9 and earlier, built with
<code class="docutils literal notranslate"><span class="pre">ImageFileDirectory_v1</span></code> instances. Additionally, any
single item tuples have been unwrapped and return a bare element.</p>
<p>The format returned by Pillow 3.0 has been abandoned. A more fully
featured interface for EXIF is anticipated in a future release.</p>
</div>
<div class="section" id="out-of-spec-metadata">
<h3>Out of Spec Metadata<a class="headerlink" href="#out-of-spec-metadata" title="Permalink to this headline">¶</a></h3>
<p>In Pillow 3.0 and 3.1, images that contain metadata that is internally
consistent, but not in agreement with the TIFF spec, may cause an
exception when reading the metadata. This can happen when a tag that
is specified to have a single value is stored with an array of values.</p>
<p>It is anticipated that this behavior will change in future releases.</p>
</div>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="3.0.0.html" class="btn btn-neutral float-right" title="3.0.0" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="3.1.1.html" class="btn btn-neutral float-left" title="3.1.1" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 1995-2011 Fredrik Lundh, 2010-2018 Alex Clark and Contributors
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>
