Sophie

Sophie

distrib > Mageia > 7 > aarch64 > by-pkgid > e5936adde9b1ea7ed6dc23c107bda8ab > files > 23

python3-pillow-doc-5.4.1-1.1.mga7.noarch.rpm



<!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>PIL.IcnsImagePlugin &mdash; 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" /> 
</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>
<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"><a class="reference internal" href="../../releasenotes/index.html">Release Notes</a></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> &raquo;</li>
        
          <li><a href="../index.html">Module code</a> &raquo;</li>
        
      <li>PIL.IcnsImagePlugin</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
      </li>
    
  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <h1>Source code for PIL.IcnsImagePlugin</h1><div class="highlight"><pre>
<span></span><span class="c1">#</span>
<span class="c1"># The Python Imaging Library.</span>
<span class="c1"># $Id$</span>
<span class="c1">#</span>
<span class="c1"># macOS icns file decoder, based on icns.py by Bob Ippolito.</span>
<span class="c1">#</span>
<span class="c1"># history:</span>
<span class="c1"># 2004-10-09 fl   Turned into a PIL plugin; removed 2.3 dependencies.</span>
<span class="c1">#</span>
<span class="c1"># Copyright (c) 2004 by Bob Ippolito.</span>
<span class="c1"># Copyright (c) 2004 by Secret Labs.</span>
<span class="c1"># Copyright (c) 2004 by Fredrik Lundh.</span>
<span class="c1"># Copyright (c) 2014 by Alastair Houghton.</span>
<span class="c1">#</span>
<span class="c1"># See the README file for information on usage and redistribution.</span>
<span class="c1">#</span>

<span class="kn">from</span> <span class="nn">PIL</span> <span class="k">import</span> <span class="n">Image</span><span class="p">,</span> <span class="n">ImageFile</span><span class="p">,</span> <span class="n">PngImagePlugin</span>
<span class="kn">from</span> <span class="nn">PIL._binary</span> <span class="k">import</span> <span class="n">i8</span>
<span class="kn">import</span> <span class="nn">io</span>
<span class="kn">import</span> <span class="nn">os</span>
<span class="kn">import</span> <span class="nn">shutil</span>
<span class="kn">import</span> <span class="nn">struct</span>
<span class="kn">import</span> <span class="nn">sys</span>
<span class="kn">import</span> <span class="nn">tempfile</span>

<span class="n">enable_jpeg2k</span> <span class="o">=</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">Image</span><span class="o">.</span><span class="n">core</span><span class="p">,</span> <span class="s1">&#39;jp2klib_version&#39;</span><span class="p">)</span>
<span class="k">if</span> <span class="n">enable_jpeg2k</span><span class="p">:</span>
    <span class="kn">from</span> <span class="nn">PIL</span> <span class="k">import</span> <span class="n">Jpeg2KImagePlugin</span>

<span class="n">HEADERSIZE</span> <span class="o">=</span> <span class="mi">8</span>


<div class="viewcode-block" id="nextheader"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.nextheader">[docs]</a><span class="k">def</span> <span class="nf">nextheader</span><span class="p">(</span><span class="n">fobj</span><span class="p">):</span>
    <span class="k">return</span> <span class="n">struct</span><span class="o">.</span><span class="n">unpack</span><span class="p">(</span><span class="s1">&#39;&gt;4sI&#39;</span><span class="p">,</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">HEADERSIZE</span><span class="p">))</span></div>


<div class="viewcode-block" id="read_32t"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.read_32t">[docs]</a><span class="k">def</span> <span class="nf">read_32t</span><span class="p">(</span><span class="n">fobj</span><span class="p">,</span> <span class="n">start_length</span><span class="p">,</span> <span class="n">size</span><span class="p">):</span>
    <span class="c1"># The 128x128 icon seems to have an extra header for some reason.</span>
    <span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">length</span><span class="p">)</span> <span class="o">=</span> <span class="n">start_length</span>
    <span class="n">fobj</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">start</span><span class="p">)</span>
    <span class="n">sig</span> <span class="o">=</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>
    <span class="k">if</span> <span class="n">sig</span> <span class="o">!=</span> <span class="sa">b</span><span class="s1">&#39;</span><span class="se">\x00\x00\x00\x00</span><span class="s1">&#39;</span><span class="p">:</span>
        <span class="k">raise</span> <span class="ne">SyntaxError</span><span class="p">(</span><span class="s1">&#39;Unknown signature, expecting 0x00000000&#39;</span><span class="p">)</span>
    <span class="k">return</span> <span class="n">read_32</span><span class="p">(</span><span class="n">fobj</span><span class="p">,</span> <span class="p">(</span><span class="n">start</span> <span class="o">+</span> <span class="mi">4</span><span class="p">,</span> <span class="n">length</span> <span class="o">-</span> <span class="mi">4</span><span class="p">),</span> <span class="n">size</span><span class="p">)</span></div>


<div class="viewcode-block" id="read_32"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.read_32">[docs]</a><span class="k">def</span> <span class="nf">read_32</span><span class="p">(</span><span class="n">fobj</span><span class="p">,</span> <span class="n">start_length</span><span class="p">,</span> <span class="n">size</span><span class="p">):</span>
    <span class="sd">&quot;&quot;&quot;</span>
<span class="sd">    Read a 32bit RGB icon resource.  Seems to be either uncompressed or</span>
<span class="sd">    an RLE packbits-like scheme.</span>
<span class="sd">    &quot;&quot;&quot;</span>
    <span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">length</span><span class="p">)</span> <span class="o">=</span> <span class="n">start_length</span>
    <span class="n">fobj</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">start</span><span class="p">)</span>
    <span class="n">pixel_size</span> <span class="o">=</span> <span class="p">(</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">size</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="n">size</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
    <span class="n">sizesq</span> <span class="o">=</span> <span class="n">pixel_size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">pixel_size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
    <span class="k">if</span> <span class="n">length</span> <span class="o">==</span> <span class="n">sizesq</span> <span class="o">*</span> <span class="mi">3</span><span class="p">:</span>
        <span class="c1"># uncompressed (&quot;RGBRGBGB&quot;)</span>
        <span class="n">indata</span> <span class="o">=</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">length</span><span class="p">)</span>
        <span class="n">im</span> <span class="o">=</span> <span class="n">Image</span><span class="o">.</span><span class="n">frombuffer</span><span class="p">(</span><span class="s2">&quot;RGB&quot;</span><span class="p">,</span> <span class="n">pixel_size</span><span class="p">,</span> <span class="n">indata</span><span class="p">,</span> <span class="s2">&quot;raw&quot;</span><span class="p">,</span> <span class="s2">&quot;RGB&quot;</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
    <span class="k">else</span><span class="p">:</span>
        <span class="c1"># decode image</span>
        <span class="n">im</span> <span class="o">=</span> <span class="n">Image</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="s2">&quot;RGB&quot;</span><span class="p">,</span> <span class="n">pixel_size</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
        <span class="k">for</span> <span class="n">band_ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">3</span><span class="p">):</span>
            <span class="n">data</span> <span class="o">=</span> <span class="p">[]</span>
            <span class="n">bytesleft</span> <span class="o">=</span> <span class="n">sizesq</span>
            <span class="k">while</span> <span class="n">bytesleft</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
                <span class="n">byte</span> <span class="o">=</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
                <span class="k">if</span> <span class="ow">not</span> <span class="n">byte</span><span class="p">:</span>
                    <span class="k">break</span>
                <span class="n">byte</span> <span class="o">=</span> <span class="n">i8</span><span class="p">(</span><span class="n">byte</span><span class="p">)</span>
                <span class="k">if</span> <span class="n">byte</span> <span class="o">&amp;</span> <span class="mh">0x80</span><span class="p">:</span>
                    <span class="n">blocksize</span> <span class="o">=</span> <span class="n">byte</span> <span class="o">-</span> <span class="mi">125</span>
                    <span class="n">byte</span> <span class="o">=</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
                    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">blocksize</span><span class="p">):</span>
                        <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">byte</span><span class="p">)</span>
                <span class="k">else</span><span class="p">:</span>
                    <span class="n">blocksize</span> <span class="o">=</span> <span class="n">byte</span> <span class="o">+</span> <span class="mi">1</span>
                    <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">blocksize</span><span class="p">))</span>
                <span class="n">bytesleft</span> <span class="o">-=</span> <span class="n">blocksize</span>
                <span class="k">if</span> <span class="n">bytesleft</span> <span class="o">&lt;=</span> <span class="mi">0</span><span class="p">:</span>
                    <span class="k">break</span>
            <span class="k">if</span> <span class="n">bytesleft</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span>
                <span class="k">raise</span> <span class="ne">SyntaxError</span><span class="p">(</span>
                    <span class="s2">&quot;Error reading channel [</span><span class="si">%r</span><span class="s2"> left]&quot;</span> <span class="o">%</span> <span class="n">bytesleft</span>
                    <span class="p">)</span>
            <span class="n">band</span> <span class="o">=</span> <span class="n">Image</span><span class="o">.</span><span class="n">frombuffer</span><span class="p">(</span>
                <span class="s2">&quot;L&quot;</span><span class="p">,</span> <span class="n">pixel_size</span><span class="p">,</span> <span class="sa">b</span><span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">data</span><span class="p">),</span> <span class="s2">&quot;raw&quot;</span><span class="p">,</span> <span class="s2">&quot;L&quot;</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span>
                <span class="p">)</span>
            <span class="n">im</span><span class="o">.</span><span class="n">im</span><span class="o">.</span><span class="n">putband</span><span class="p">(</span><span class="n">band</span><span class="o">.</span><span class="n">im</span><span class="p">,</span> <span class="n">band_ix</span><span class="p">)</span>
    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;RGB&quot;</span><span class="p">:</span> <span class="n">im</span><span class="p">}</span></div>


<div class="viewcode-block" id="read_mk"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.read_mk">[docs]</a><span class="k">def</span> <span class="nf">read_mk</span><span class="p">(</span><span class="n">fobj</span><span class="p">,</span> <span class="n">start_length</span><span class="p">,</span> <span class="n">size</span><span class="p">):</span>
    <span class="c1"># Alpha masks seem to be uncompressed</span>
    <span class="n">start</span> <span class="o">=</span> <span class="n">start_length</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
    <span class="n">fobj</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">start</span><span class="p">)</span>
    <span class="n">pixel_size</span> <span class="o">=</span> <span class="p">(</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">size</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="n">size</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
    <span class="n">sizesq</span> <span class="o">=</span> <span class="n">pixel_size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">pixel_size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
    <span class="n">band</span> <span class="o">=</span> <span class="n">Image</span><span class="o">.</span><span class="n">frombuffer</span><span class="p">(</span>
        <span class="s2">&quot;L&quot;</span><span class="p">,</span> <span class="n">pixel_size</span><span class="p">,</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">sizesq</span><span class="p">),</span> <span class="s2">&quot;raw&quot;</span><span class="p">,</span> <span class="s2">&quot;L&quot;</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span>
        <span class="p">)</span>
    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;A&quot;</span><span class="p">:</span> <span class="n">band</span><span class="p">}</span></div>


<div class="viewcode-block" id="read_png_or_jpeg2000"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.read_png_or_jpeg2000">[docs]</a><span class="k">def</span> <span class="nf">read_png_or_jpeg2000</span><span class="p">(</span><span class="n">fobj</span><span class="p">,</span> <span class="n">start_length</span><span class="p">,</span> <span class="n">size</span><span class="p">):</span>
    <span class="p">(</span><span class="n">start</span><span class="p">,</span> <span class="n">length</span><span class="p">)</span> <span class="o">=</span> <span class="n">start_length</span>
    <span class="n">fobj</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">start</span><span class="p">)</span>
    <span class="n">sig</span> <span class="o">=</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">12</span><span class="p">)</span>
    <span class="k">if</span> <span class="n">sig</span><span class="p">[:</span><span class="mi">8</span><span class="p">]</span> <span class="o">==</span> <span class="sa">b</span><span class="s1">&#39;</span><span class="se">\x89</span><span class="s1">PNG</span><span class="se">\x0d\x0a\x1a\x0a</span><span class="s1">&#39;</span><span class="p">:</span>
        <span class="n">fobj</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">start</span><span class="p">)</span>
        <span class="n">im</span> <span class="o">=</span> <span class="n">PngImagePlugin</span><span class="o">.</span><span class="n">PngImageFile</span><span class="p">(</span><span class="n">fobj</span><span class="p">)</span>
        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;RGBA&quot;</span><span class="p">:</span> <span class="n">im</span><span class="p">}</span>
    <span class="k">elif</span> <span class="n">sig</span><span class="p">[:</span><span class="mi">4</span><span class="p">]</span> <span class="o">==</span> <span class="sa">b</span><span class="s1">&#39;</span><span class="se">\xff\x4f\xff\x51</span><span class="s1">&#39;</span> \
            <span class="ow">or</span> <span class="n">sig</span><span class="p">[:</span><span class="mi">4</span><span class="p">]</span> <span class="o">==</span> <span class="sa">b</span><span class="s1">&#39;</span><span class="se">\x0d\x0a\x87\x0a</span><span class="s1">&#39;</span> \
            <span class="ow">or</span> <span class="n">sig</span> <span class="o">==</span> <span class="sa">b</span><span class="s1">&#39;</span><span class="se">\x00\x00\x00\x0c</span><span class="s1">jP  </span><span class="se">\x0d\x0a\x87\x0a</span><span class="s1">&#39;</span><span class="p">:</span>
        <span class="k">if</span> <span class="ow">not</span> <span class="n">enable_jpeg2k</span><span class="p">:</span>
            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;Unsupported icon subimage format (rebuild PIL &#39;</span>
                             <span class="s1">&#39;with JPEG 2000 support to fix this)&#39;</span><span class="p">)</span>
        <span class="c1"># j2k, jpc or j2c</span>
        <span class="n">fobj</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">start</span><span class="p">)</span>
        <span class="n">jp2kstream</span> <span class="o">=</span> <span class="n">fobj</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">length</span><span class="p">)</span>
        <span class="n">f</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">(</span><span class="n">jp2kstream</span><span class="p">)</span>
        <span class="n">im</span> <span class="o">=</span> <span class="n">Jpeg2KImagePlugin</span><span class="o">.</span><span class="n">Jpeg2KImageFile</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
        <span class="k">if</span> <span class="n">im</span><span class="o">.</span><span class="n">mode</span> <span class="o">!=</span> <span class="s1">&#39;RGBA&#39;</span><span class="p">:</span>
            <span class="n">im</span> <span class="o">=</span> <span class="n">im</span><span class="o">.</span><span class="n">convert</span><span class="p">(</span><span class="s1">&#39;RGBA&#39;</span><span class="p">)</span>
        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;RGBA&quot;</span><span class="p">:</span> <span class="n">im</span><span class="p">}</span>
    <span class="k">else</span><span class="p">:</span>
        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s1">&#39;Unsupported icon subimage format&#39;</span><span class="p">)</span></div>


<div class="viewcode-block" id="IcnsFile"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.IcnsFile">[docs]</a><span class="k">class</span> <span class="nc">IcnsFile</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>

    <span class="n">SIZES</span> <span class="o">=</span> <span class="p">{</span>
        <span class="p">(</span><span class="mi">512</span><span class="p">,</span> <span class="mi">512</span><span class="p">,</span> <span class="mi">2</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic10&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">512</span><span class="p">,</span> <span class="mi">512</span><span class="p">,</span> <span class="mi">1</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic09&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">256</span><span class="p">,</span> <span class="mi">256</span><span class="p">,</span> <span class="mi">2</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic14&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">256</span><span class="p">,</span> <span class="mi">256</span><span class="p">,</span> <span class="mi">1</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic08&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">128</span><span class="p">,</span> <span class="mi">128</span><span class="p">,</span> <span class="mi">2</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic13&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">128</span><span class="p">,</span> <span class="mi">128</span><span class="p">,</span> <span class="mi">1</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic07&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;it32&#39;</span><span class="p">,</span> <span class="n">read_32t</span><span class="p">),</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;t8mk&#39;</span><span class="p">,</span> <span class="n">read_mk</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">64</span><span class="p">,</span> <span class="mi">64</span><span class="p">,</span> <span class="mi">1</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;icp6&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">32</span><span class="p">,</span> <span class="mi">32</span><span class="p">,</span> <span class="mi">2</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic12&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">48</span><span class="p">,</span> <span class="mi">48</span><span class="p">,</span> <span class="mi">1</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ih32&#39;</span><span class="p">,</span> <span class="n">read_32</span><span class="p">),</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;h8mk&#39;</span><span class="p">,</span> <span class="n">read_mk</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">32</span><span class="p">,</span> <span class="mi">32</span><span class="p">,</span> <span class="mi">1</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;icp5&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;il32&#39;</span><span class="p">,</span> <span class="n">read_32</span><span class="p">),</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;l8mk&#39;</span><span class="p">,</span> <span class="n">read_mk</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">16</span><span class="p">,</span> <span class="mi">16</span><span class="p">,</span> <span class="mi">2</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;ic11&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
        <span class="p">],</span>
        <span class="p">(</span><span class="mi">16</span><span class="p">,</span> <span class="mi">16</span><span class="p">,</span> <span class="mi">1</span><span class="p">):</span> <span class="p">[</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;icp4&#39;</span><span class="p">,</span> <span class="n">read_png_or_jpeg2000</span><span class="p">),</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;is32&#39;</span><span class="p">,</span> <span class="n">read_32</span><span class="p">),</span>
            <span class="p">(</span><span class="sa">b</span><span class="s1">&#39;s8mk&#39;</span><span class="p">,</span> <span class="n">read_mk</span><span class="p">),</span>
        <span class="p">],</span>
    <span class="p">}</span>

    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fobj</span><span class="p">):</span>
        <span class="sd">&quot;&quot;&quot;</span>
<span class="sd">        fobj is a file-like object as an icns resource</span>
<span class="sd">        &quot;&quot;&quot;</span>
        <span class="c1"># signature : (start, length)</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">dct</span> <span class="o">=</span> <span class="n">dct</span> <span class="o">=</span> <span class="p">{}</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">fobj</span> <span class="o">=</span> <span class="n">fobj</span>
        <span class="n">sig</span><span class="p">,</span> <span class="n">filesize</span> <span class="o">=</span> <span class="n">nextheader</span><span class="p">(</span><span class="n">fobj</span><span class="p">)</span>
        <span class="k">if</span> <span class="n">sig</span> <span class="o">!=</span> <span class="sa">b</span><span class="s1">&#39;icns&#39;</span><span class="p">:</span>
            <span class="k">raise</span> <span class="ne">SyntaxError</span><span class="p">(</span><span class="s1">&#39;not an icns file&#39;</span><span class="p">)</span>
        <span class="n">i</span> <span class="o">=</span> <span class="n">HEADERSIZE</span>
        <span class="k">while</span> <span class="n">i</span> <span class="o">&lt;</span> <span class="n">filesize</span><span class="p">:</span>
            <span class="n">sig</span><span class="p">,</span> <span class="n">blocksize</span> <span class="o">=</span> <span class="n">nextheader</span><span class="p">(</span><span class="n">fobj</span><span class="p">)</span>
            <span class="k">if</span> <span class="n">blocksize</span> <span class="o">&lt;=</span> <span class="mi">0</span><span class="p">:</span>
                <span class="k">raise</span> <span class="ne">SyntaxError</span><span class="p">(</span><span class="s1">&#39;invalid block header&#39;</span><span class="p">)</span>
            <span class="n">i</span> <span class="o">+=</span> <span class="n">HEADERSIZE</span>
            <span class="n">blocksize</span> <span class="o">-=</span> <span class="n">HEADERSIZE</span>
            <span class="n">dct</span><span class="p">[</span><span class="n">sig</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">blocksize</span><span class="p">)</span>
            <span class="n">fobj</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">blocksize</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
            <span class="n">i</span> <span class="o">+=</span> <span class="n">blocksize</span>

<div class="viewcode-block" id="IcnsFile.itersizes"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.IcnsFile.itersizes">[docs]</a>    <span class="k">def</span> <span class="nf">itersizes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
        <span class="n">sizes</span> <span class="o">=</span> <span class="p">[]</span>
        <span class="k">for</span> <span class="n">size</span><span class="p">,</span> <span class="n">fmts</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">SIZES</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
            <span class="k">for</span> <span class="p">(</span><span class="n">fmt</span><span class="p">,</span> <span class="n">reader</span><span class="p">)</span> <span class="ow">in</span> <span class="n">fmts</span><span class="p">:</span>
                <span class="k">if</span> <span class="n">fmt</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">dct</span><span class="p">:</span>
                    <span class="n">sizes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">size</span><span class="p">)</span>
                    <span class="k">break</span>
        <span class="k">return</span> <span class="n">sizes</span></div>

<div class="viewcode-block" id="IcnsFile.bestsize"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.IcnsFile.bestsize">[docs]</a>    <span class="k">def</span> <span class="nf">bestsize</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
        <span class="n">sizes</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">itersizes</span><span class="p">()</span>
        <span class="k">if</span> <span class="ow">not</span> <span class="n">sizes</span><span class="p">:</span>
            <span class="k">raise</span> <span class="ne">SyntaxError</span><span class="p">(</span><span class="s2">&quot;No 32bit icon resources found&quot;</span><span class="p">)</span>
        <span class="k">return</span> <span class="nb">max</span><span class="p">(</span><span class="n">sizes</span><span class="p">)</span></div>

<div class="viewcode-block" id="IcnsFile.dataforsize"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.IcnsFile.dataforsize">[docs]</a>    <span class="k">def</span> <span class="nf">dataforsize</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">size</span><span class="p">):</span>
        <span class="sd">&quot;&quot;&quot;</span>
<span class="sd">        Get an icon resource as {channel: array}.  Note that</span>
<span class="sd">        the arrays are bottom-up like windows bitmaps and will likely</span>
<span class="sd">        need to be flipped or transposed in some way.</span>
<span class="sd">        &quot;&quot;&quot;</span>
        <span class="n">dct</span> <span class="o">=</span> <span class="p">{}</span>
        <span class="k">for</span> <span class="n">code</span><span class="p">,</span> <span class="n">reader</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">SIZES</span><span class="p">[</span><span class="n">size</span><span class="p">]:</span>
            <span class="n">desc</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">dct</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">code</span><span class="p">)</span>
            <span class="k">if</span> <span class="n">desc</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
                <span class="n">dct</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">reader</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fobj</span><span class="p">,</span> <span class="n">desc</span><span class="p">,</span> <span class="n">size</span><span class="p">))</span>
        <span class="k">return</span> <span class="n">dct</span></div>

<div class="viewcode-block" id="IcnsFile.getimage"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.IcnsFile.getimage">[docs]</a>    <span class="k">def</span> <span class="nf">getimage</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
        <span class="k">if</span> <span class="n">size</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
            <span class="n">size</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">bestsize</span><span class="p">()</span>
        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">size</span><span class="p">)</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
            <span class="n">size</span> <span class="o">=</span> <span class="p">(</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">size</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="mi">1</span><span class="p">)</span>
        <span class="n">channels</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">dataforsize</span><span class="p">(</span><span class="n">size</span><span class="p">)</span>

        <span class="n">im</span> <span class="o">=</span> <span class="n">channels</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;RGBA&#39;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
        <span class="k">if</span> <span class="n">im</span><span class="p">:</span>
            <span class="k">return</span> <span class="n">im</span>

        <span class="n">im</span> <span class="o">=</span> <span class="n">channels</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;RGB&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
        <span class="k">try</span><span class="p">:</span>
            <span class="n">im</span><span class="o">.</span><span class="n">putalpha</span><span class="p">(</span><span class="n">channels</span><span class="p">[</span><span class="s2">&quot;A&quot;</span><span class="p">])</span>
        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
            <span class="k">pass</span>
        <span class="k">return</span> <span class="n">im</span></div></div>


<span class="c1">##</span>
<span class="c1"># Image plugin for Mac OS icons.</span>

<div class="viewcode-block" id="IcnsImageFile"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.IcnsImageFile">[docs]</a><span class="k">class</span> <span class="nc">IcnsImageFile</span><span class="p">(</span><span class="n">ImageFile</span><span class="o">.</span><span class="n">ImageFile</span><span class="p">):</span>
    <span class="sd">&quot;&quot;&quot;</span>
<span class="sd">    PIL image support for Mac OS .icns files.</span>
<span class="sd">    Chooses the best resolution, but will possibly load</span>
<span class="sd">    a different size image if you mutate the size attribute</span>
<span class="sd">    before calling &#39;load&#39;.</span>

<span class="sd">    The info dictionary has a key &#39;sizes&#39; that is a list</span>
<span class="sd">    of sizes that the icns file has.</span>
<span class="sd">    &quot;&quot;&quot;</span>

    <span class="nb">format</span> <span class="o">=</span> <span class="s2">&quot;ICNS&quot;</span>
    <span class="n">format_description</span> <span class="o">=</span> <span class="s2">&quot;Mac OS icns resource&quot;</span>

    <span class="k">def</span> <span class="nf">_open</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">icns</span> <span class="o">=</span> <span class="n">IcnsFile</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fp</span><span class="p">)</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">mode</span> <span class="o">=</span> <span class="s1">&#39;RGBA&#39;</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s1">&#39;sizes&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">icns</span><span class="o">.</span><span class="n">itersizes</span><span class="p">()</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">icns</span><span class="o">.</span><span class="n">bestsize</span><span class="p">()</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">size</span> <span class="o">=</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span>
                     <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
        <span class="c1"># Just use this to see if it&#39;s loaded or not yet.</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">tile</span> <span class="o">=</span> <span class="p">(</span><span class="s1">&#39;&#39;</span><span class="p">,)</span>

    <span class="nd">@property</span>
    <span class="k">def</span> <span class="nf">size</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_size</span>

    <span class="nd">@size</span><span class="o">.</span><span class="n">setter</span>
    <span class="k">def</span> <span class="nf">size</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
        <span class="n">info_size</span> <span class="o">=</span> <span class="n">value</span>
        <span class="k">if</span> <span class="n">info_size</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s1">&#39;sizes&#39;</span><span class="p">]</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">info_size</span><span class="p">)</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
            <span class="n">info_size</span> <span class="o">=</span> <span class="p">(</span><span class="n">info_size</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">info_size</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="mi">1</span><span class="p">)</span>
        <span class="k">if</span> <span class="n">info_size</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s1">&#39;sizes&#39;</span><span class="p">]</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">info_size</span><span class="p">)</span> <span class="o">==</span> <span class="mi">3</span> <span class="ow">and</span> \
           <span class="n">info_size</span><span class="p">[</span><span class="mi">2</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
            <span class="n">simple_sizes</span> <span class="o">=</span> <span class="p">[(</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">size</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="n">size</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
                            <span class="k">for</span> <span class="n">size</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s1">&#39;sizes&#39;</span><span class="p">]]</span>
            <span class="k">if</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">simple_sizes</span><span class="p">:</span>
                <span class="n">info_size</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s1">&#39;sizes&#39;</span><span class="p">][</span><span class="n">simple_sizes</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="n">value</span><span class="p">)]</span>
        <span class="k">if</span> <span class="n">info_size</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s1">&#39;sizes&#39;</span><span class="p">]:</span>
            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
                <span class="s2">&quot;This is not one of the allowed sizes of this image&quot;</span><span class="p">)</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">_size</span> <span class="o">=</span> <span class="n">value</span>

<div class="viewcode-block" id="IcnsImageFile.load"><a class="viewcode-back" href="../../reference/plugins.html#PIL.IcnsImagePlugin.IcnsImageFile.load">[docs]</a>    <span class="k">def</span> <span class="nf">load</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">size</span><span class="p">)</span> <span class="o">==</span> <span class="mi">3</span><span class="p">:</span>
            <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">size</span>
            <span class="bp">self</span><span class="o">.</span><span class="n">size</span> <span class="o">=</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span>
                         <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>

        <span class="n">Image</span><span class="o">.</span><span class="n">Image</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">tile</span><span class="p">:</span>
            <span class="k">return</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">load_prepare</span><span class="p">()</span>
        <span class="c1"># This is likely NOT the best way to do it, but whatever.</span>
        <span class="n">im</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">icns</span><span class="o">.</span><span class="n">getimage</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">best_size</span><span class="p">)</span>

        <span class="c1"># If this is a PNG or JPEG 2000, it won&#39;t be loaded yet</span>
        <span class="n">im</span><span class="o">.</span><span class="n">load</span><span class="p">()</span>

        <span class="bp">self</span><span class="o">.</span><span class="n">im</span> <span class="o">=</span> <span class="n">im</span><span class="o">.</span><span class="n">im</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">mode</span> <span class="o">=</span> <span class="n">im</span><span class="o">.</span><span class="n">mode</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">size</span> <span class="o">=</span> <span class="n">im</span><span class="o">.</span><span class="n">size</span>
        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_exclusive_fp</span><span class="p">:</span>
            <span class="bp">self</span><span class="o">.</span><span class="n">fp</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">fp</span> <span class="o">=</span> <span class="kc">None</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">icns</span> <span class="o">=</span> <span class="kc">None</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">tile</span> <span class="o">=</span> <span class="p">()</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">load_end</span><span class="p">()</span></div></div>


<span class="k">def</span> <span class="nf">_save</span><span class="p">(</span><span class="n">im</span><span class="p">,</span> <span class="n">fp</span><span class="p">,</span> <span class="n">filename</span><span class="p">):</span>
    <span class="sd">&quot;&quot;&quot;</span>
<span class="sd">    Saves the image as a series of PNG files,</span>
<span class="sd">    that are then converted to a .icns file</span>
<span class="sd">    using the macOS command line utility &#39;iconutil&#39;.</span>

<span class="sd">    macOS only.</span>
<span class="sd">    &quot;&quot;&quot;</span>
    <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span> <span class="s2">&quot;flush&quot;</span><span class="p">):</span>
        <span class="n">fp</span><span class="o">.</span><span class="n">flush</span><span class="p">()</span>

    <span class="c1"># create the temporary set of pngs</span>
    <span class="n">iconset</span> <span class="o">=</span> <span class="n">tempfile</span><span class="o">.</span><span class="n">mkdtemp</span><span class="p">(</span><span class="s1">&#39;.iconset&#39;</span><span class="p">)</span>
    <span class="n">provided_images</span> <span class="o">=</span> <span class="p">{</span><span class="n">im</span><span class="o">.</span><span class="n">width</span><span class="p">:</span> <span class="n">im</span>
                       <span class="k">for</span> <span class="n">im</span> <span class="ow">in</span> <span class="n">im</span><span class="o">.</span><span class="n">encoderinfo</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;append_images&quot;</span><span class="p">,</span> <span class="p">[])}</span>
    <span class="n">last_w</span> <span class="o">=</span> <span class="kc">None</span>
    <span class="n">second_path</span> <span class="o">=</span> <span class="kc">None</span>
    <span class="k">for</span> <span class="n">w</span> <span class="ow">in</span> <span class="p">[</span><span class="mi">16</span><span class="p">,</span> <span class="mi">32</span><span class="p">,</span> <span class="mi">128</span><span class="p">,</span> <span class="mi">256</span><span class="p">,</span> <span class="mi">512</span><span class="p">]:</span>
        <span class="n">prefix</span> <span class="o">=</span> <span class="s1">&#39;icon_</span><span class="si">{}</span><span class="s1">x</span><span class="si">{}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">w</span><span class="p">,</span> <span class="n">w</span><span class="p">)</span>

        <span class="n">first_path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">iconset</span><span class="p">,</span> <span class="n">prefix</span><span class="o">+</span><span class="s1">&#39;.png&#39;</span><span class="p">)</span>
        <span class="k">if</span> <span class="n">last_w</span> <span class="o">==</span> <span class="n">w</span><span class="p">:</span>
            <span class="n">shutil</span><span class="o">.</span><span class="n">copyfile</span><span class="p">(</span><span class="n">second_path</span><span class="p">,</span> <span class="n">first_path</span><span class="p">)</span>
        <span class="k">else</span><span class="p">:</span>
            <span class="n">im_w</span> <span class="o">=</span> <span class="n">provided_images</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">w</span><span class="p">,</span> <span class="n">im</span><span class="o">.</span><span class="n">resize</span><span class="p">((</span><span class="n">w</span><span class="p">,</span> <span class="n">w</span><span class="p">),</span> <span class="n">Image</span><span class="o">.</span><span class="n">LANCZOS</span><span class="p">))</span>
            <span class="n">im_w</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="n">first_path</span><span class="p">)</span>

        <span class="n">second_path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">iconset</span><span class="p">,</span> <span class="n">prefix</span><span class="o">+</span><span class="s1">&#39;@2x.png&#39;</span><span class="p">)</span>
        <span class="n">im_w2</span> <span class="o">=</span> <span class="n">provided_images</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">w</span><span class="o">*</span><span class="mi">2</span><span class="p">,</span> <span class="n">im</span><span class="o">.</span><span class="n">resize</span><span class="p">((</span><span class="n">w</span><span class="o">*</span><span class="mi">2</span><span class="p">,</span> <span class="n">w</span><span class="o">*</span><span class="mi">2</span><span class="p">),</span> <span class="n">Image</span><span class="o">.</span><span class="n">LANCZOS</span><span class="p">))</span>
        <span class="n">im_w2</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="n">second_path</span><span class="p">)</span>
        <span class="n">last_w</span> <span class="o">=</span> <span class="n">w</span><span class="o">*</span><span class="mi">2</span>

    <span class="c1"># iconutil -c icns -o {} {}</span>
    <span class="kn">from</span> <span class="nn">subprocess</span> <span class="k">import</span> <span class="n">Popen</span><span class="p">,</span> <span class="n">PIPE</span><span class="p">,</span> <span class="n">CalledProcessError</span>

    <span class="n">convert_cmd</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;iconutil&quot;</span><span class="p">,</span> <span class="s2">&quot;-c&quot;</span><span class="p">,</span> <span class="s2">&quot;icns&quot;</span><span class="p">,</span> <span class="s2">&quot;-o&quot;</span><span class="p">,</span> <span class="n">filename</span><span class="p">,</span> <span class="n">iconset</span><span class="p">]</span>
    <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">devnull</span><span class="p">,</span> <span class="s1">&#39;wb&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">devnull</span><span class="p">:</span>
        <span class="n">convert_proc</span> <span class="o">=</span> <span class="n">Popen</span><span class="p">(</span><span class="n">convert_cmd</span><span class="p">,</span> <span class="n">stdout</span><span class="o">=</span><span class="n">PIPE</span><span class="p">,</span> <span class="n">stderr</span><span class="o">=</span><span class="n">devnull</span><span class="p">)</span>

    <span class="n">convert_proc</span><span class="o">.</span><span class="n">stdout</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>

    <span class="n">retcode</span> <span class="o">=</span> <span class="n">convert_proc</span><span class="o">.</span><span class="n">wait</span><span class="p">()</span>

    <span class="c1"># remove the temporary files</span>
    <span class="n">shutil</span><span class="o">.</span><span class="n">rmtree</span><span class="p">(</span><span class="n">iconset</span><span class="p">)</span>

    <span class="k">if</span> <span class="n">retcode</span><span class="p">:</span>
        <span class="k">raise</span> <span class="n">CalledProcessError</span><span class="p">(</span><span class="n">retcode</span><span class="p">,</span> <span class="n">convert_cmd</span><span class="p">)</span>


<span class="n">Image</span><span class="o">.</span><span class="n">register_open</span><span class="p">(</span><span class="n">IcnsImageFile</span><span class="o">.</span><span class="n">format</span><span class="p">,</span> <span class="n">IcnsImageFile</span><span class="p">,</span>
                    <span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="p">[:</span><span class="mi">4</span><span class="p">]</span> <span class="o">==</span> <span class="sa">b</span><span class="s1">&#39;icns&#39;</span><span class="p">)</span>
<span class="n">Image</span><span class="o">.</span><span class="n">register_extension</span><span class="p">(</span><span class="n">IcnsImageFile</span><span class="o">.</span><span class="n">format</span><span class="p">,</span> <span class="s1">&#39;.icns&#39;</span><span class="p">)</span>

<span class="k">if</span> <span class="n">sys</span><span class="o">.</span><span class="n">platform</span> <span class="o">==</span> <span class="s1">&#39;darwin&#39;</span><span class="p">:</span>
    <span class="n">Image</span><span class="o">.</span><span class="n">register_save</span><span class="p">(</span><span class="n">IcnsImageFile</span><span class="o">.</span><span class="n">format</span><span class="p">,</span> <span class="n">_save</span><span class="p">)</span>

    <span class="n">Image</span><span class="o">.</span><span class="n">register_mime</span><span class="p">(</span><span class="n">IcnsImageFile</span><span class="o">.</span><span class="n">format</span><span class="p">,</span> <span class="s2">&quot;image/icns&quot;</span><span class="p">)</span>


<span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s1">&#39;__main__&#39;</span><span class="p">:</span>

    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">)</span> <span class="o">&lt;</span> <span class="mi">2</span><span class="p">:</span>
        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Syntax: python IcnsImagePlugin.py [file]&quot;</span><span class="p">)</span>
        <span class="n">sys</span><span class="o">.</span><span class="n">exit</span><span class="p">()</span>

    <span class="n">imf</span> <span class="o">=</span> <span class="n">IcnsImageFile</span><span class="p">(</span><span class="nb">open</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="s1">&#39;rb&#39;</span><span class="p">))</span>
    <span class="k">for</span> <span class="n">size</span> <span class="ow">in</span> <span class="n">imf</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s1">&#39;sizes&#39;</span><span class="p">]:</span>
        <span class="n">imf</span><span class="o">.</span><span class="n">size</span> <span class="o">=</span> <span class="n">size</span>
        <span class="n">imf</span><span class="o">.</span><span class="n">load</span><span class="p">()</span>
        <span class="n">im</span> <span class="o">=</span> <span class="n">imf</span><span class="o">.</span><span class="n">im</span>
        <span class="n">im</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="s1">&#39;out-</span><span class="si">%s</span><span class="s1">-</span><span class="si">%s</span><span class="s1">-</span><span class="si">%s</span><span class="s1">.png&#39;</span> <span class="o">%</span> <span class="n">size</span><span class="p">)</span>
    <span class="n">im</span> <span class="o">=</span> <span class="n">Image</span><span class="o">.</span><span class="n">open</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
    <span class="n">im</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="s2">&quot;out.png&quot;</span><span class="p">)</span>
    <span class="k">if</span> <span class="n">sys</span><span class="o">.</span><span class="n">platform</span> <span class="o">==</span> <span class="s1">&#39;windows&#39;</span><span class="p">:</span>
        <span class="n">os</span><span class="o">.</span><span class="n">startfile</span><span class="p">(</span><span class="s2">&quot;out.png&quot;</span><span class="p">)</span>
</pre></div>

           </div>
           
          </div>
          <footer>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; 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>