aboutsummaryrefslogtreecommitdiffstats
path: root/docs/levels.html
blob: 1cbbac4816b3cf03fac64e791a1ecb5893882ceb (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
<!DOCTYPE html>  <html> <head>   <title>levels.coffee</title>   <meta http-equiv="content-type" content="text/html; charset=UTF-8">   <link rel="stylesheet" media="all" href="docco.css" /> </head> <body>   <div id="container">     <div id="background"></div>            <div id="jump_to">         Jump To &hellip;         <div id="jump_wrapper">           <div id="jump_page">                                           <a class="source" href="brightnesscontrast.html">                 brightnesscontrast.coffee               </a>                                           <a class="source" href="colorbalance.html">                 colorbalance.coffee               </a>                                           <a class="source" href="curves.html">                 curves.coffee               </a>                                           <a class="source" href="huesaturation.html">                 huesaturation.coffee               </a>                                           <a class="source" href="invert.html">                 invert.coffee               </a>                                           <a class="source" href="layereffect.html">                 layereffect.coffee               </a>                                           <a class="source" href="levels.html">                 levels.coffee               </a>                                           <a class="source" href="posterize.html">                 posterize.coffee               </a>                                           <a class="source" href="selectivecolor.html">                 selectivecolor.coffee               </a>                                           <a class="source" href="threshold.html">                 threshold.coffee               </a>                                           <a class="source" href="typetool.html">                 typetool.coffee               </a>                                           <a class="source" href="log.html">                 log.coffee               </a>                                           <a class="source" href="psd.html">                 psd.coffee               </a>                                           <a class="source" href="psdassert.html">                 psdassert.coffee               </a>                                           <a class="source" href="psdchannelimage.html">                 psdchannelimage.coffee               </a>                                           <a class="source" href="psdcolor.html">                 psdcolor.coffee               </a>                                           <a class="source" href="psddescriptor.html">                 psddescriptor.coffee               </a>                                           <a class="source" href="psdfile.html">                 psdfile.coffee               </a>                                           <a class="source" href="psdheader.html">                 psdheader.coffee               </a>                                           <a class="source" href="psdimage.html">                 psdimage.coffee               </a>                                           <a class="source" href="psdlayer.html">                 psdlayer.coffee               </a>                                           <a class="source" href="psdlayermask.html">                 psdlayermask.coffee               </a>                                           <a class="source" href="psdresource.html">                 psdresource.coffee               </a>                                           <a class="source" href="util.html">                 util.coffee               </a>                        </div>         </div>       </div>          <table cellpadding="0" cellspacing="0">       <thead>         <tr>           <th class="docs">             <h1>               levels.coffee             </h1>           </th>           <th class="code">           </th>         </tr>       </thead>       <tbody>                               <tr id="section-1">             <td class="docs">               <div class="pilwrap">                 <a class="pilcrow" href="#section-1">&#182;</a>               </div>                            </td>             <td class="code">               <div class="highlight"><pre><span class="k">class</span> <span class="nx">PSDLevels</span>
  <span class="nv">constructor: </span><span class="nf">(@layer, @length) -&gt;</span>
    <span class="vi">@file = </span><span class="nx">@layer</span><span class="p">.</span><span class="nx">file</span>
    <span class="vi">@data =</span>
      <span class="nv">records: </span><span class="p">[]</span>

  <span class="nv">parse: </span><span class="o">-&gt;</span>
    <span class="nv">start = </span><span class="nx">@file</span><span class="p">.</span><span class="nx">tell</span><span class="p">()</span>

    <span class="nv">version = </span><span class="nx">@file</span><span class="p">.</span><span class="nx">readShortInt</span><span class="p">()</span>
    <span class="nx">assert</span> <span class="nx">version</span> <span class="o">is</span> <span class="mi">1</span>

    <span class="nx">@parseLevelRecords</span><span class="p">()</span></pre></div>             </td>           </tr>                               <tr id="section-2">             <td class="docs">               <div class="pilwrap">                 <a class="pilcrow" href="#section-2">&#182;</a>               </div>               <p>PS CS (8.0) additional information</p>             </td>             <td class="code">               <div class="highlight"><pre>    <span class="k">if</span> <span class="nx">@file</span><span class="p">.</span><span class="nx">tell</span><span class="p">()</span> <span class="o">-</span> <span class="nx">start</span> <span class="o">&lt;</span> <span class="nx">@length</span> <span class="o">-</span> <span class="mi">4</span>
      <span class="nv">tag = </span><span class="nx">@file</span><span class="p">.</span><span class="nx">readf</span> <span class="s2">&quot;&gt;4s&quot;</span>
      <span class="nx">assert</span><span class="p">.</span><span class="nx">equal</span> <span class="nx">tag</span><span class="p">,</span> <span class="s2">&quot;Lvls&quot;</span>

      <span class="nv">version = </span><span class="nx">@file</span><span class="p">.</span><span class="nx">readShortInt</span><span class="p">()</span>
      <span class="nx">assert</span><span class="p">.</span><span class="nx">equal</span> <span class="nx">version</span><span class="p">,</span> <span class="mi">3</span></pre></div>             </td>           </tr>                               <tr id="section-3">             <td class="docs">               <div class="pilwrap">                 <a class="pilcrow" href="#section-3">&#182;</a>               </div>               <p>Figure out the total number of level record structures
Subtract the legacy number of level record structures (29)
to determine how many are remaining in the file for reading.</p>             </td>             <td class="code">               <div class="highlight"><pre>      <span class="vi">@data.levelCount = </span><span class="nx">@file</span><span class="p">.</span><span class="nx">readShortInt</span><span class="p">()</span> <span class="o">-</span> <span class="mi">29</span>
      <span class="nx">assert</span> <span class="nx">levelCount</span> <span class="o">&gt;=</span> <span class="mi">0</span>
      <span class="nx">@parseLevelRecords</span><span class="p">(</span><span class="nx">levelCount</span><span class="p">)</span></pre></div>             </td>           </tr>                               <tr id="section-4">             <td class="docs">               <div class="pilwrap">                 <a class="pilcrow" href="#section-4">&#182;</a>               </div>               <p>Only return the important data. Don't need to hold on to this
entire class.</p>             </td>             <td class="code">               <div class="highlight"><pre>      <span class="k">return</span> <span class="nx">@data</span>


  <span class="nv">parseLevelRecords: </span><span class="nf">(count = 29) -&gt;</span></pre></div>             </td>           </tr>                               <tr id="section-5">             <td class="docs">               <div class="pilwrap">                 <a class="pilcrow" href="#section-5">&#182;</a>               </div>               <p>29 sets of level records. each level has 5 short ints</p>             </td>             <td class="code">               <div class="highlight"><pre>    <span class="k">for</span> <span class="nx">i</span> <span class="k">in</span> <span class="p">[</span><span class="mi">0</span><span class="p">...</span><span class="nx">count</span><span class="p">]</span>
      <span class="nv">record = </span><span class="p">{}</span>
      <span class="p">[</span>
        <span class="nx">record</span><span class="p">.</span><span class="nx">inputFloor</span><span class="p">,</span>     <span class="c1"># (0...253)</span>
        <span class="nx">record</span><span class="p">.</span><span class="nx">inputCeiling</span><span class="p">,</span>   <span class="c1"># (2...255)</span>
        <span class="nx">record</span><span class="p">.</span><span class="nx">outputFloor</span><span class="p">,</span>    <span class="c1"># (0...255)</span>
        <span class="nx">record</span><span class="p">.</span><span class="nx">outputCeiling</span><span class="p">,</span>  <span class="c1"># (0...255)</span>
        <span class="nx">record</span><span class="p">.</span><span class="nx">gamma</span>           <span class="c1"># (10...999)</span>
      <span class="p">]</span> <span class="o">=</span> <span class="nx">@file</span><span class="p">.</span><span class="nx">readf</span> <span class="s2">&quot;&gt;hhhhh&quot;</span>

      <span class="nx">record</span><span class="p">.</span><span class="nx">gamma</span> <span class="err">/= 100</span></pre></div>             </td>           </tr>                               <tr id="section-6">             <td class="docs">               <div class="pilwrap">                 <a class="pilcrow" href="#section-6">&#182;</a>               </div>               <p>Sets 28 and 29 are reserved</p>             </td>             <td class="code">               <div class="highlight"><pre>      <span class="k">if</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="mi">27</span>
        <span class="nx">assert</span> <span class="nx">record</span><span class="p">.</span><span class="nx">inputFloor</span> <span class="o">&gt;=</span> <span class="mi">0</span> <span class="o">and</span> <span class="nx">record</span><span class="p">.</span><span class="nx">inputFloor</span> <span class="o">&lt;=</span> <span class="mi">255</span>
        <span class="nx">assert</span> <span class="nx">record</span><span class="p">.</span><span class="nx">inputCeiling</span> <span class="o">&gt;=</span> <span class="mi">2</span> <span class="o">and</span> <span class="nx">record</span><span class="p">.</span><span class="nx">inputCeiling</span> <span class="o">&lt;=</span> <span class="mi">255</span>
        <span class="nx">assert</span> <span class="nx">record</span><span class="p">.</span><span class="nx">outputFloor</span> <span class="o">&gt;=</span> <span class="mi">0</span> <span class="o">and</span> <span class="nx">record</span><span class="p">.</span><span class="nx">outputFloor</span> <span class="o">&lt;=</span> <span class="mi">255</span>
        <span class="nx">assert</span> <span class="nx">record</span><span class="p">.</span><span class="nx">outputCeiling</span> <span class="o">&gt;=</span> <span class="mi">0</span> <span class="o">and</span> <span class="nx">record</span><span class="p">.</span><span class="nx">outputCeiling</span> <span class="o">&lt;=</span> <span class="mi">255</span>
        <span class="nx">assert</span> <span class="nx">record</span><span class="p">.</span><span class="nx">gamma</span> <span class="o">&gt;=</span> <span class="mf">0.1</span> <span class="o">and</span> <span class="nx">record</span><span class="p">.</span><span class="nx">gamma</span> <span class="o">&lt;=</span> <span class="mf">9.99</span>

      <span class="nx">@data</span><span class="p">.</span><span class="nx">records</span><span class="p">.</span><span class="nx">push</span> <span class="nx">record</span>

</pre></div>             </td>           </tr>                </tbody>     </table>   </div> </body> </html>