<!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.WalImageFile — 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> »</li>
<li><a href="../index.html">Module code</a> »</li>
<li>PIL.WalImageFile</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.WalImageFile</h1><div class="highlight"><pre>
<span></span><span class="c1"># encoding: utf-8</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"># WAL file handling</span>
<span class="c1">#</span>
<span class="c1"># History:</span>
<span class="c1"># 2003-04-23 fl created</span>
<span class="c1">#</span>
<span class="c1"># Copyright (c) 2003 by Fredrik Lundh.</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="c1"># NOTE: This format cannot be automatically recognized, so the reader</span>
<span class="c1"># is not registered for use with Image.open(). To open a WAL file, use</span>
<span class="c1"># the WalImageFile.open() function instead.</span>
<span class="c1"># This reader is based on the specification available from:</span>
<span class="c1"># https://www.flipcode.com/archives/Quake_2_BSP_File_Format.shtml</span>
<span class="c1"># and has been tested with a few sample files found using google.</span>
<span class="kn">from</span> <span class="nn">.</span> <span class="k">import</span> <span class="n">Image</span>
<span class="kn">from</span> <span class="nn">._binary</span> <span class="k">import</span> <span class="n">i32le</span> <span class="k">as</span> <span class="n">i32</span>
<span class="k">try</span><span class="p">:</span>
<span class="kn">import</span> <span class="nn">builtins</span>
<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
<span class="kn">import</span> <span class="nn">__builtin__</span>
<span class="n">builtins</span> <span class="o">=</span> <span class="n">__builtin__</span>
<div class="viewcode-block" id="open"><a class="viewcode-back" href="../../PIL.html#PIL.WalImageFile.open">[docs]</a><span class="k">def</span> <span class="nf">open</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
<span class="sd">"""</span>
<span class="sd"> Load texture from a Quake2 WAL texture file.</span>
<span class="sd"> By default, a Quake2 standard palette is attached to the texture.</span>
<span class="sd"> To override the palette, use the <b>putpalette</b> method.</span>
<span class="sd"> :param filename: WAL file name, or an opened file handle.</span>
<span class="sd"> :returns: An image instance.</span>
<span class="sd"> """</span>
<span class="c1"># FIXME: modify to return a WalImageFile instance instead of</span>
<span class="c1"># plain Image object ?</span>
<span class="k">def</span> <span class="nf">imopen</span><span class="p">(</span><span class="n">fp</span><span class="p">):</span>
<span class="c1"># read header fields</span>
<span class="n">header</span> <span class="o">=</span> <span class="n">fp</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">32</span><span class="o">+</span><span class="mi">24</span><span class="o">+</span><span class="mi">32</span><span class="o">+</span><span class="mi">12</span><span class="p">)</span>
<span class="n">size</span> <span class="o">=</span> <span class="n">i32</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="mi">32</span><span class="p">),</span> <span class="n">i32</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="mi">36</span><span class="p">)</span>
<span class="n">offset</span> <span class="o">=</span> <span class="n">i32</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="mi">40</span><span class="p">)</span>
<span class="c1"># load pixel data</span>
<span class="n">fp</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
<span class="n">Image</span><span class="o">.</span><span class="n">_decompression_bomb_check</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">Image</span><span class="o">.</span><span class="n">frombytes</span><span class="p">(</span><span class="s2">"P"</span><span class="p">,</span> <span class="n">size</span><span class="p">,</span> <span class="n">fp</span><span class="o">.</span><span class="n">read</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">1</span><span class="p">]))</span>
<span class="n">im</span><span class="o">.</span><span class="n">putpalette</span><span class="p">(</span><span class="n">quake2palette</span><span class="p">)</span>
<span class="n">im</span><span class="o">.</span><span class="n">format</span> <span class="o">=</span> <span class="s2">"WAL"</span>
<span class="n">im</span><span class="o">.</span><span class="n">format_description</span> <span class="o">=</span> <span class="s2">"Quake2 Texture"</span>
<span class="c1"># strings are null-terminated</span>
<span class="n">im</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s2">"name"</span><span class="p">]</span> <span class="o">=</span> <span class="n">header</span><span class="p">[:</span><span class="mi">32</span><span class="p">]</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="sa">b</span><span class="s2">"</span><span class="se">\0</span><span class="s2">"</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
<span class="n">next_name</span> <span class="o">=</span> <span class="n">header</span><span class="p">[</span><span class="mi">56</span><span class="p">:</span><span class="mi">56</span><span class="o">+</span><span class="mi">32</span><span class="p">]</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="sa">b</span><span class="s2">"</span><span class="se">\0</span><span class="s2">"</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
<span class="k">if</span> <span class="n">next_name</span><span class="p">:</span>
<span class="n">im</span><span class="o">.</span><span class="n">info</span><span class="p">[</span><span class="s2">"next_name"</span><span class="p">]</span> <span class="o">=</span> <span class="n">next_name</span>
<span class="k">return</span> <span class="n">im</span>
<span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="s2">"read"</span><span class="p">):</span>
<span class="k">return</span> <span class="n">imopen</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">with</span> <span class="n">builtins</span><span class="o">.</span><span class="n">open</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="s2">"rb"</span><span class="p">)</span> <span class="k">as</span> <span class="n">fp</span><span class="p">:</span>
<span class="k">return</span> <span class="n">imopen</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span></div>
<span class="n">quake2palette</span> <span class="o">=</span> <span class="p">(</span>
<span class="c1"># default palette taken from piffo 0.93 by Hans Häggström</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x01\x01\x01\x0b\x0b\x0b\x12\x12\x12\x17\x17\x17\x1b\x1b\x1b\x1e</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x1e\x1e\x22\x22\x22\x26\x26\x26\x29\x29\x29\x2c\x2c\x2c\x2f\x2f</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2f\x32\x32\x32\x35\x35\x35\x37\x37\x37\x3a\x3a\x3a\x3c\x3c\x3c</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x24\x1e\x13\x22\x1c\x12\x20\x1b\x12\x1f\x1a\x10\x1d\x19\x10\x1b</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x17\x0f\x1a\x16\x0f\x18\x14\x0d\x17\x13\x0d\x16\x12\x0d\x14\x10</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x0b\x13\x0f\x0b\x10\x0d\x0a\x0f\x0b\x0a\x0d\x0b\x07\x0b\x0a\x07</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x23\x23\x26\x22\x22\x25\x22\x20\x23\x21\x1f\x22\x20\x1e\x20\x1f</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x1d\x1e\x1d\x1b\x1c\x1b\x1a\x1a\x1a\x19\x19\x18\x17\x17\x17\x16</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x16\x14\x14\x14\x13\x13\x13\x10\x10\x10\x0f\x0f\x0f\x0d\x0d\x0d</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2d\x28\x20\x29\x24\x1c\x27\x22\x1a\x25\x1f\x17\x38\x2e\x1e\x31</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x29\x1a\x2c\x25\x17\x26\x20\x14\x3c\x30\x14\x37\x2c\x13\x33\x28</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x12\x2d\x24\x10\x28\x1f\x0f\x22\x1a\x0b\x1b\x14\x0a\x13\x0f\x07</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x31\x1a\x16\x30\x17\x13\x2e\x16\x10\x2c\x14\x0d\x2a\x12\x0b\x27</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x0f\x0a\x25\x0f\x07\x21\x0d\x01\x1e\x0b\x01\x1c\x0b\x01\x1a\x0b</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x01\x18\x0a\x01\x16\x0a\x01\x13\x0a\x01\x10\x07\x01\x0d\x07\x01</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x29\x23\x1e\x27\x21\x1c\x26\x20\x1b\x25\x1f\x1a\x23\x1d\x19\x21</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x1c\x18\x20\x1b\x17\x1e\x19\x16\x1c\x18\x14\x1b\x17\x13\x19\x14</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x10\x17\x13\x0f\x14\x10\x0d\x12\x0f\x0b\x0f\x0b\x0a\x0b\x0a\x07</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x26\x1a\x0f\x23\x19\x0f\x20\x17\x0f\x1c\x16\x0f\x19\x13\x0d\x14</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x10\x0b\x10\x0d\x0a\x0b\x0a\x07\x33\x22\x1f\x35\x29\x26\x37\x2f</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2d\x39\x35\x34\x37\x39\x3a\x33\x37\x39\x30\x34\x36\x2b\x31\x34</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x27\x2e\x31\x22\x2b\x2f\x1d\x28\x2c\x17\x25\x2a\x0f\x20\x26\x0d</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x1e\x25\x0b\x1c\x22\x0a\x1b\x20\x07\x19\x1e\x07\x17\x1b\x07\x14</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x18\x01\x12\x16\x01\x0f\x12\x01\x0b\x0d\x01\x07\x0a\x01\x01\x01</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2c\x21\x21\x2a\x1f\x1f\x29\x1d\x1d\x27\x1c\x1c\x26\x1a\x1a\x24</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x18\x18\x22\x17\x17\x21\x16\x16\x1e\x13\x13\x1b\x12\x12\x18\x10</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x10\x16\x0d\x0d\x12\x0b\x0b\x0d\x0a\x0a\x0a\x07\x07\x01\x01\x01</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2e\x30\x29\x2d\x2e\x27\x2b\x2c\x26\x2a\x2a\x24\x28\x29\x23\x27</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x27\x21\x26\x26\x1f\x24\x24\x1d\x22\x22\x1c\x1f\x1f\x1a\x1c\x1c</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x18\x19\x19\x16\x17\x17\x13\x13\x13\x10\x0f\x0f\x0d\x0b\x0b\x0a</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x30\x1e\x1b\x2d\x1c\x19\x2c\x1a\x17\x2a\x19\x14\x28\x17\x13\x26</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x16\x10\x24\x13\x0f\x21\x12\x0d\x1f\x10\x0b\x1c\x0f\x0a\x19\x0d</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x0a\x16\x0b\x07\x12\x0a\x07\x0f\x07\x01\x0a\x01\x01\x01\x01\x01</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x28\x29\x38\x26\x27\x36\x25\x26\x34\x24\x24\x31\x22\x22\x2f\x20</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x21\x2d\x1e\x1f\x2a\x1d\x1d\x27\x1b\x1b\x25\x19\x19\x21\x17\x17</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x1e\x14\x14\x1b\x13\x12\x17\x10\x0f\x13\x0d\x0b\x0f\x0a\x07\x07</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2f\x32\x29\x2d\x30\x26\x2b\x2e\x24\x29\x2c\x21\x27\x2a\x1e\x25</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x28\x1c\x23\x26\x1a\x21\x25\x18\x1e\x22\x14\x1b\x1f\x10\x19\x1c</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x0d\x17\x1a\x0a\x13\x17\x07\x10\x13\x01\x0d\x0f\x01\x0a\x0b\x01</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x01\x3f\x01\x13\x3c\x0b\x1b\x39\x10\x20\x35\x14\x23\x31\x17\x23</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2d\x18\x23\x29\x18\x3f\x3f\x3f\x3f\x3f\x39\x3f\x3f\x31\x3f\x3f</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x2a\x3f\x3f\x20\x3f\x3f\x14\x3f\x3c\x12\x3f\x39\x0f\x3f\x35\x0b</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x3f\x32\x07\x3f\x2d\x01\x3d\x2a\x01\x3b\x26\x01\x39\x21\x01\x37</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x1d\x01\x34\x1a\x01\x32\x16\x01\x2f\x12\x01\x2d\x0f\x01\x2a\x0b</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x01\x27\x07\x01\x23\x01\x01\x1d\x01\x01\x17\x01\x01\x10\x01\x01</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x3d\x01\x01\x19\x19\x3f\x3f\x01\x01\x01\x01\x3f\x16\x16\x13\x10</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x10\x0f\x0d\x0d\x0b\x3c\x2e\x2a\x36\x27\x20\x30\x21\x18\x29\x1b</span><span class="s2">"</span>
<span class="sa">b</span><span class="s2">"</span><span class="se">\x10\x3c\x39\x37\x37\x32\x2f\x31\x2c\x28\x2b\x26\x21\x30\x22\x20</span><span class="s2">"</span>
<span class="p">)</span>
</pre></div>
</div>
</div>
<footer>
<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>
