1291 lines
331 KiB
HTML
1291 lines
331 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Coverage for pyWebLayout/concrete/text.py: 77%</title>
|
|
<link rel="icon" sizes="32x32" href="favicon_32_cb_c827f16f.png">
|
|
<link rel="stylesheet" href="style_cb_4667309f.css" type="text/css">
|
|
<script src="coverage_html_cb_dd2e7eb5.js" defer></script>
|
|
</head>
|
|
<body class="pyfile">
|
|
<header>
|
|
<div class="content">
|
|
<h1>
|
|
<span class="text">Coverage for </span><b>pyWebLayout<span class="sep">/</span>concrete<span class="sep">/</span>text.py</b>:
|
|
<span class="pc_cov">77%</span>
|
|
</h1>
|
|
<aside id="help_panel_wrapper">
|
|
<input id="help_panel_state" type="checkbox">
|
|
<label for="help_panel_state">
|
|
<img id="keyboard_icon" src="keybd_closed_cb_900cfef5.png" alt="Show/hide keyboard shortcuts">
|
|
</label>
|
|
<div id="help_panel">
|
|
<p class="legend">Shortcuts on this page</p>
|
|
<div class="keyhelp">
|
|
<p>
|
|
<kbd>r</kbd>
|
|
<kbd>m</kbd>
|
|
<kbd>x</kbd>
|
|
<kbd>p</kbd>
|
|
toggle line displays
|
|
</p>
|
|
<p>
|
|
<kbd>j</kbd>
|
|
<kbd>k</kbd>
|
|
next/prev highlighted chunk
|
|
</p>
|
|
<p>
|
|
<kbd>0</kbd> (zero) top of page
|
|
</p>
|
|
<p>
|
|
<kbd>1</kbd> (one) first highlighted chunk
|
|
</p>
|
|
<p>
|
|
<kbd>[</kbd>
|
|
<kbd>]</kbd>
|
|
prev/next file
|
|
</p>
|
|
<p>
|
|
<kbd>u</kbd> up to the index
|
|
</p>
|
|
<p>
|
|
<kbd>?</kbd> show/hide this help
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</aside>
|
|
<h2>
|
|
<span class="text">462 statements </span>
|
|
<button type="button" class="run button_toggle_run" value="run" data-shortcut="r" title="Toggle lines run">375<span class="text"> run</span></button>
|
|
<button type="button" class="mis show_mis button_toggle_mis" value="mis" data-shortcut="m" title="Toggle lines missing">87<span class="text"> missing</span></button>
|
|
<button type="button" class="exc show_exc button_toggle_exc" value="exc" data-shortcut="x" title="Toggle lines excluded">46<span class="text"> excluded</span></button>
|
|
<button type="button" class="par run show_par button_toggle_par" value="par" data-shortcut="p" title="Toggle lines partially run">13<span class="text"> partial</span></button>
|
|
</h2>
|
|
<p class="text">
|
|
<a id="prevFileLink" class="nav" href="z_7d48e1f4c6486fa2_table_py.html">« prev</a>
|
|
<a id="indexLink" class="nav" href="index.html">^ index</a>
|
|
<a id="nextFileLink" class="nav" href="z_40407af872b0cf37___init___py.html">» next</a>
|
|
|
|
<a class="nav" href="https://coverage.readthedocs.io/en/7.15.4">coverage.py v7.15.4</a>,
|
|
created at 2026-08-08 20:34 +0000
|
|
</p>
|
|
<aside class="hidden">
|
|
<button type="button" class="button_next_chunk" data-shortcut="j"></button>
|
|
<button type="button" class="button_prev_chunk" data-shortcut="k"></button>
|
|
<button type="button" class="button_top_of_page" data-shortcut="0"></button>
|
|
<button type="button" class="button_first_chunk" data-shortcut="1"></button>
|
|
<button type="button" class="button_prev_file" data-shortcut="["></button>
|
|
<button type="button" class="button_next_file" data-shortcut="]"></button>
|
|
<button type="button" class="button_to_index" data-shortcut="u"></button>
|
|
<button type="button" class="button_show_hide_help" data-shortcut="?"></button>
|
|
</aside>
|
|
</div>
|
|
</header>
|
|
<main id="source">
|
|
<p class="run"><span class="n"><a id="t1" href="#t1">1</a></span><span class="t"><span class="key">from</span> <span class="nam">__future__</span> <span class="key">import</span> <span class="nam">annotations</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t2" href="#t2">2</a></span><span class="t"><span class="key">from</span> <span class="nam">pyWebLayout</span><span class="op">.</span><span class="nam">core</span><span class="op">.</span><span class="nam">base</span> <span class="key">import</span> <span class="nam">Renderable</span><span class="op">,</span> <span class="nam">Queriable</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t3" href="#t3">3</a></span><span class="t"><span class="key">from</span> <span class="nam">pyWebLayout</span><span class="op">.</span><span class="nam">core</span><span class="op">.</span><span class="nam">query</span> <span class="key">import</span> <span class="nam">QueryResult</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t4" href="#t4">4</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">box</span> <span class="key">import</span> <span class="nam">Box</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t5" href="#t5">5</a></span><span class="t"><span class="key">from</span> <span class="nam">pyWebLayout</span><span class="op">.</span><span class="nam">style</span> <span class="key">import</span> <span class="nam">Alignment</span><span class="op">,</span> <span class="nam">Font</span><span class="op">,</span> <span class="nam">TextDecoration</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t6" href="#t6">6</a></span><span class="t"><span class="key">from</span> <span class="nam">pyWebLayout</span><span class="op">.</span><span class="nam">abstract</span> <span class="key">import</span> <span class="nam">Word</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t7" href="#t7">7</a></span><span class="t"><span class="key">from</span> <span class="nam">pyWebLayout</span><span class="op">.</span><span class="nam">abstract</span><span class="op">.</span><span class="nam">inline</span> <span class="key">import</span> <span class="nam">LinkedWord</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t8" href="#t8">8</a></span><span class="t"><span class="key">from</span> <span class="nam">pyWebLayout</span><span class="op">.</span><span class="nam">abstract</span><span class="op">.</span><span class="nam">functional</span> <span class="key">import</span> <span class="nam">Link</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t9" href="#t9">9</a></span><span class="t"><span class="key">from</span> <span class="nam">pyWebLayout</span><span class="op">.</span><span class="nam">core</span><span class="op">.</span><span class="nam">cache</span> <span class="key">import</span> <span class="nam">UsageCache</span><span class="op">,</span> <span class="nam">SizedUsageCache</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t10" href="#t10">10</a></span><span class="t"><span class="key">from</span> <span class="nam">PIL</span> <span class="key">import</span> <span class="nam">ImageDraw</span><span class="op">,</span> <span class="nam">ImageFont</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t11" href="#t11">11</a></span><span class="t"><span class="key">from</span> <span class="nam">typing</span> <span class="key">import</span> <span class="nam">Tuple</span><span class="op">,</span> <span class="nam">List</span><span class="op">,</span> <span class="nam">Optional</span><span class="op">,</span> <span class="nam">Any</span><span class="op">,</span> <span class="nam">Dict</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t12" href="#t12">12</a></span><span class="t"><span class="key">import</span> <span class="nam">logging</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t13" href="#t13">13</a></span><span class="t"><span class="key">import</span> <span class="nam">math</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t14" href="#t14">14</a></span><span class="t"><span class="key">import</span> <span class="nam">numpy</span> <span class="key">as</span> <span class="nam">np</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t15" href="#t15">15</a></span><span class="t"><span class="key">from</span> <span class="nam">abc</span> <span class="key">import</span> <span class="nam">ABC</span><span class="op">,</span> <span class="nam">abstractmethod</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t16" href="#t16">16</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t17" href="#t17">17</a></span><span class="t"><span class="nam">logger</span> <span class="op">=</span> <span class="nam">logging</span><span class="op">.</span><span class="nam">getLogger</span><span class="op">(</span><span class="nam">__name__</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t18" href="#t18">18</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t19" href="#t19">19</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t20" href="#t20">20</a></span><span class="t"><span class="com"># ---------------------------------------------------------------------------</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t21" href="#t21">21</a></span><span class="t"><span class="com"># Text rendering caches</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t22" href="#t22">22</a></span><span class="t"><span class="com">#</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t23" href="#t23">23</a></span><span class="t"><span class="com"># A page re-measures and re-rasterises the same words constantly: measured over a</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t24" href="#t24">24</a></span><span class="t"><span class="com"># novel at 1404x1872, a page issues ~2800 width measurements and ~2500 glyph</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t25" href="#t25">25</a></span><span class="t"><span class="com"># rasterisations for fewer than 1000 distinct (font, string) pairs. Caching both</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t26" href="#t26">26</a></span><span class="t"><span class="com"># turns a ~225ms page into a ~30ms page. Both caches are bounded so that a long</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t27" href="#t27">27</a></span><span class="t"><span class="com"># reading session cannot grow without limit on a memory-constrained device.</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t28" href="#t28">28</a></span><span class="t"><span class="com"># ---------------------------------------------------------------------------</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t29" href="#t29">29</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t30" href="#t30">30</a></span><span class="t"><span class="com"># Word widths are small floats; 8192 entries costs well under 1MB and comfortably</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t31" href="#t31">31</a></span><span class="t"><span class="com"># spans the working set of several chapters at a couple of font sizes.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t32" href="#t32">32</a></span><span class="t"><span class="nam">DEFAULT_WIDTH_CACHE_ENTRIES</span> <span class="op">=</span> <span class="num">8192</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t33" href="#t33">33</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t34" href="#t34">34</a></span><span class="t"><span class="com"># Glyph bitmaps are the expensive ones: ~700 bytes each on average at 1404x1872,</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t35" href="#t35">35</a></span><span class="t"><span class="com"># so an unbounded cache reaches ~12MB after 40 pages. 4MB holds several pages'</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t36" href="#t36">36</a></span><span class="t"><span class="com"># worth of distinct words while leaving headroom on a 512MB Pi Zero 2.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t37" href="#t37">37</a></span><span class="t"><span class="nam">DEFAULT_GLYPH_CACHE_BYTES</span> <span class="op">=</span> <span class="num">4</span> <span class="op">*</span> <span class="num">1024</span> <span class="op">*</span> <span class="num">1024</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t38" href="#t38">38</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t39" href="#t39">39</a></span><span class="t"><span class="com"># PIL rasterises text at sub-pixel horizontal offsets, so a cache keyed only on</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t40" href="#t40">40</a></span><span class="t"><span class="com"># (font, string) would quantise every word to a whole pixel. Bucketing the</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t41" href="#t41">41</a></span><span class="t"><span class="com"># sub-pixel phase keeps that error negligible at the cost of more entries. 2 steps</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t42" href="#t42">42</a></span><span class="t"><span class="com"># holds the mean error to ~3.6/255 -- a fifth of one step of a 16-level e-ink</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t43" href="#t43">43</a></span><span class="t"><span class="com"># panel -- while keeping the cache four times smaller than 4 steps would.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t44" href="#t44">44</a></span><span class="t"><span class="nam">DEFAULT_GLYPH_SUBPIXEL_STEPS</span> <span class="op">=</span> <span class="num">2</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t45" href="#t45">45</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t46" href="#t46">46</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t47" href="#t47">47</a></span><span class="t"><span class="key">def</span> <span class="nam">_glyph_entry_bytes</span><span class="op">(</span><span class="nam">entry</span><span class="op">:</span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">Any</span><span class="op">,</span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">]</span><span class="op">]</span><span class="op">)</span> <span class="op">-></span> <span class="nam">int</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t48" href="#t48">48</a></span><span class="t"> <span class="str">"""Approximate footprint of a cached (mask, offset) pair, in bytes."""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t49" href="#t49">49</a></span><span class="t"> <span class="nam">mask</span> <span class="op">=</span> <span class="nam">entry</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t50" href="#t50">50</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t51" href="#t51">51</a></span><span class="t"> <span class="nam">width</span><span class="op">,</span> <span class="nam">height</span> <span class="op">=</span> <span class="nam">mask</span><span class="op">.</span><span class="nam">size</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t52" href="#t52">52</a></span><span class="t"> <span class="key">except</span> <span class="op">(</span><span class="nam">AttributeError</span><span class="op">,</span> <span class="nam">TypeError</span><span class="op">,</span> <span class="nam">ValueError</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t53" href="#t53">53</a></span><span class="t"> <span class="key">return</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t54" href="#t54">54</a></span><span class="t"> <span class="key">return</span> <span class="nam">width</span> <span class="op">*</span> <span class="nam">height</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t55" href="#t55">55</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t56" href="#t56">56</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t57" href="#t57">57</a></span><span class="t"><span class="nam">_width_cache</span><span class="op">:</span> <span class="nam">UsageCache</span> <span class="op">=</span> <span class="nam">UsageCache</span><span class="op">(</span><span class="nam">DEFAULT_WIDTH_CACHE_ENTRIES</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t58" href="#t58">58</a></span><span class="t"><span class="nam">_glyph_cache</span><span class="op">:</span> <span class="nam">SizedUsageCache</span> <span class="op">=</span> <span class="nam">SizedUsageCache</span><span class="op">(</span><span class="nam">DEFAULT_GLYPH_CACHE_BYTES</span><span class="op">,</span> <span class="nam">_glyph_entry_bytes</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t59" href="#t59">59</a></span><span class="t"><span class="nam">_glyph_subpixel_steps</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="nam">DEFAULT_GLYPH_SUBPIXEL_STEPS</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t60" href="#t60">60</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t61" href="#t61">61</a></span><span class="t"><span class="com"># Every Line asks its font for the advance width of a space. That single</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t62" href="#t62">62</a></span><span class="t"><span class="com"># FreeTypeFont.getlength(" ") call costs ~18us -- two orders of magnitude more</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t63" href="#t63">63</a></span><span class="t"><span class="com"># than getmetrics() -- because PIL shapes the string from scratch each time, and</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t64" href="#t64">64</a></span><span class="t"><span class="com"># it lands once per line created, which dominates the cost of laying a line out.</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t65" href="#t65">65</a></span><span class="t"><span class="com"># There are only ever a handful of distinct fonts in play, so memoise per font</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t66" href="#t66">66</a></span><span class="t"><span class="com"># object. Values are wrapped in a 1-tuple because None is itself a legitimate</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t67" href="#t67">67</a></span><span class="t"><span class="com"># result (fonts that cannot report a length) and must not read as a cache miss.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t68" href="#t68">68</a></span><span class="t"><span class="nam">_space_advance_cache</span><span class="op">:</span> <span class="nam">Dict</span><span class="op">[</span><span class="nam">Any</span><span class="op">,</span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span><span class="op">]</span><span class="op">]</span> <span class="op">=</span> <span class="op">{</span><span class="op">}</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t69" href="#t69">69</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t70" href="#t70">70</a></span><span class="t"><span class="com"># Set to False the first time the fast rasterisation path is found to be</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t71" href="#t71">71</a></span><span class="t"><span class="com"># unavailable (e.g. a PIL build without the private ImageDraw internals it uses),</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t72" href="#t72">72</a></span><span class="t"><span class="com"># after which every Text falls back to ImageDraw.text().</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t73" href="#t73">73</a></span><span class="t"><span class="nam">_glyph_fast_path_available</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t74" href="#t74">74</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t75" href="#t75">75</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t76" href="#t76">76</a></span><span class="t"><span class="key">def</span> <span class="nam">configure_text_caches</span><span class="op">(</span><span class="nam">width_entries</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t77" href="#t77">77</a></span><span class="t"> <span class="nam">glyph_bytes</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t78" href="#t78">78</a></span><span class="t"> <span class="nam">subpixel_steps</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t79" href="#t79">79</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t80" href="#t80">80</a></span><span class="t"><span class="str"> Tune the text rendering caches.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t81" href="#t81">81</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t82" href="#t82">82</a></span><span class="t"><span class="str"> Memory-constrained targets should shrink these; a desktop rendering many font</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t83" href="#t83">83</a></span><span class="t"><span class="str"> sizes may benefit from raising them.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t84" href="#t84">84</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t85" href="#t85">85</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t86" href="#t86">86</a></span><span class="t"><span class="str"> width_entries: Maximum cached word-width measurements.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t87" href="#t87">87</a></span><span class="t"><span class="str"> glyph_bytes: Maximum total size of cached glyph bitmaps, in bytes.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t88" href="#t88">88</a></span><span class="t"><span class="str"> subpixel_steps: Sub-pixel phase buckets per axis. 1 disables sub-pixel</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t89" href="#t89">89</a></span><span class="t"><span class="str"> positioning entirely (smallest cache, slightly softer text).</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t90" href="#t90">90</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t91" href="#t91">91</a></span><span class="t"> <span class="key">global</span> <span class="nam">_glyph_subpixel_steps</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t92" href="#t92">92</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t93" href="#t93">93</a></span><span class="t"> <span class="key">if</span> <span class="nam">width_entries</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t94" href="#t94">94</a></span><span class="t"> <span class="nam">_width_cache</span><span class="op">.</span><span class="nam">resize</span><span class="op">(</span><span class="nam">width_entries</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t95" href="#t95">95</a></span><span class="t"> <span class="key">if</span> <span class="nam">glyph_bytes</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t96" href="#t96">96</a></span><span class="t"> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">resize</span><span class="op">(</span><span class="nam">glyph_bytes</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t97" href="#t97">97</a></span><span class="t"> <span class="key">if</span> <span class="nam">subpixel_steps</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t98" href="#t98">98</a></span><span class="t"> <span class="key">if</span> <span class="nam">subpixel_steps</span> <span class="op"><=</span> <span class="num">0</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t99" href="#t99">99</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="fst">f"</span><span class="fst">subpixel_steps must be positive, got </span><span class="op">{</span><span class="nam">subpixel_steps</span><span class="op">}</span><span class="fst">"</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t100" href="#t100">100</a></span><span class="t"> <span class="key">if</span> <span class="nam">subpixel_steps</span> <span class="op">!=</span> <span class="nam">_glyph_subpixel_steps</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t101" href="#t101">101</a></span><span class="t"> <span class="com"># Cached entries embed the phase bucket in their key.</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t102" href="#t102">102</a></span><span class="t"> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">clear</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t103" href="#t103">103</a></span><span class="t"> <span class="nam">_glyph_subpixel_steps</span> <span class="op">=</span> <span class="nam">subpixel_steps</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t104" href="#t104">104</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t105" href="#t105">105</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t106" href="#t106">106</a></span><span class="t"><span class="key">def</span> <span class="nam">clear_text_caches</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t107" href="#t107">107</a></span><span class="t"> <span class="str">"""Drop all cached widths and glyph bitmaps."""</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t108" href="#t108">108</a></span><span class="t"> <span class="nam">_width_cache</span><span class="op">.</span><span class="nam">clear</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t109" href="#t109">109</a></span><span class="t"> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">clear</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t110" href="#t110">110</a></span><span class="t"> <span class="nam">_space_advance_cache</span><span class="op">.</span><span class="nam">clear</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t111" href="#t111">111</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t112" href="#t112">112</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t113" href="#t113">113</a></span><span class="t"><span class="key">def</span> <span class="nam">_space_advance</span><span class="op">(</span><span class="nam">font</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t114" href="#t114">114</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t115" href="#t115">115</a></span><span class="t"><span class="str"> The font's own advance width for a space, in whole pixels.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t116" href="#t116">116</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t117" href="#t117">117</a></span><span class="t"><span class="str"> None when the font cannot report one, which is the signal for callers to fall</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t118" href="#t118">118</a></span><span class="t"><span class="str"> back to their configured spacing range.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t119" href="#t119">119</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t120" href="#t120">120</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t121" href="#t121">121</a></span><span class="t"> <span class="nam">cached</span> <span class="op">=</span> <span class="nam">_space_advance_cache</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">font</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t122" href="#t122">122</a></span><span class="t"> <span class="key">except</span> <span class="nam">TypeError</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t123" href="#t123">123</a></span><span class="t"> <span class="com"># Unhashable font object; measure without caching.</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t124" href="#t124">124</a></span><span class="t"> <span class="nam">cached</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t125" href="#t125">125</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t126" href="#t126">126</a></span><span class="t"> <span class="key">if</span> <span class="nam">cached</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t127" href="#t127">127</a></span><span class="t"> <span class="key">return</span> <span class="nam">cached</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t128" href="#t128">128</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t129" href="#t129">129</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t130" href="#t130">130</a></span><span class="t"> <span class="nam">value</span> <span class="op">=</span> <span class="nam">int</span><span class="op">(</span><span class="nam">round</span><span class="op">(</span><span class="nam">font</span><span class="op">.</span><span class="nam">getlength</span><span class="op">(</span><span class="str">" "</span><span class="op">)</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t131" href="#t131">131</a></span><span class="t"> <span class="key">except</span> <span class="op">(</span><span class="nam">AttributeError</span><span class="op">,</span> <span class="nam">TypeError</span><span class="op">,</span> <span class="nam">ValueError</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t132" href="#t132">132</a></span><span class="t"> <span class="nam">value</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t133" href="#t133">133</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t134" href="#t134">134</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t135" href="#t135">135</a></span><span class="t"> <span class="nam">_space_advance_cache</span><span class="op">[</span><span class="nam">font</span><span class="op">]</span> <span class="op">=</span> <span class="op">(</span><span class="nam">value</span><span class="op">,</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t136" href="#t136">136</a></span><span class="t"> <span class="key">except</span> <span class="nam">TypeError</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t137" href="#t137">137</a></span><span class="t"> <span class="key">pass</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t138" href="#t138">138</a></span><span class="t"> <span class="key">return</span> <span class="nam">value</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t139" href="#t139">139</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t140" href="#t140">140</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t141" href="#t141">141</a></span><span class="t"><span class="key">def</span> <span class="nam">text_cache_stats</span><span class="op">(</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t142" href="#t142">142</a></span><span class="t"> <span class="str">"""Occupancy and hit rates for both text caches, for tuning and diagnostics."""</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t143" href="#t143">143</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t144" href="#t144">144</a></span><span class="t"> <span class="str">'width'</span><span class="op">:</span> <span class="nam">_width_cache</span><span class="op">.</span><span class="nam">stats</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t145" href="#t145">145</a></span><span class="t"> <span class="str">'glyph'</span><span class="op">:</span> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">stats</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t146" href="#t146">146</a></span><span class="t"> <span class="str">'glyph_subpixel_steps'</span><span class="op">:</span> <span class="nam">_glyph_subpixel_steps</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t147" href="#t147">147</a></span><span class="t"> <span class="str">'glyph_fast_path'</span><span class="op">:</span> <span class="nam">_glyph_fast_path_available</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t148" href="#t148">148</a></span><span class="t"> <span class="op">}</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t149" href="#t149">149</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t150" href="#t150">150</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t151" href="#t151">151</a></span><span class="t"><span class="key">def</span> <span class="nam">prewarm_text_caches</span><span class="op">(</span><span class="nam">entries</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t152" href="#t152">152</a></span><span class="t"> <span class="nam">draw</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">ImageDraw</span><span class="op">.</span><span class="nam">ImageDraw</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t153" href="#t153">153</a></span><span class="t"> <span class="nam">budget_bytes</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t154" href="#t154">154</a></span><span class="t"> <span class="nam">max_words</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t155" href="#t155">155</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t156" href="#t156">156</a></span><span class="t"><span class="str"> Preload the caches with a document's most frequent words.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t157" href="#t157">157</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t158" href="#t158">158</a></span><span class="t"><span class="str"> A document states its own access distribution up front: the words it uses most</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t159" href="#t159">159</a></span><span class="t"><span class="str"> are the words every page will draw. Rasterising them once at open time moves</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t160" href="#t160">160</a></span><span class="t"><span class="str"> that work off the page-turn path, and seeding each entry with its document</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t161" href="#t161">161</a></span><span class="t"><span class="str"> frequency puts it in the right place in the eviction order immediately, rather</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t162" href="#t162">162</a></span><span class="t"><span class="str"> than after the cache has learned it.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t163" href="#t163">163</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t164" href="#t164">164</a></span><span class="t"><span class="str"> This depends on eviction ranking by use count. Under recency eviction the</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t165" href="#t165">165</a></span><span class="t"><span class="str"> preloaded entries would be discarded by the first page of unfamiliar text; under</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t166" href="#t166">166</a></span><span class="t"><span class="str"> usage ranking a word occurring 4000 times outranks anything met while scanning</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t167" href="#t167">167</a></span><span class="t"><span class="str"> and stays resident. Measured over a 50-page trace, preloading cut misses by 27%</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t168" href="#t168">168</a></span><span class="t"><span class="str"> with usage ranking against 12% with recency.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t169" href="#t169">169</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t170" href="#t170">170</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t171" href="#t171">171</a></span><span class="t"><span class="str"> entries: Iterable of ``(font, text, colour, frequency)``, where `font` is a</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t172" href="#t172">172</a></span><span class="t"><span class="str"> PIL font object, `colour` the fill the text will be drawn in, and</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t173" href="#t173">173</a></span><span class="t"><span class="str"> `frequency` the number of times the word occurs in the document.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t174" href="#t174">174</a></span><span class="t"><span class="str"> draw: An ImageDraw sharing the page's mode, used to resolve ink and font</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t175" href="#t175">175</a></span><span class="t"><span class="str"> mode. A scratch RGBA context is used if omitted.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t176" href="#t176">176</a></span><span class="t"><span class="str"> budget_bytes: Cap on bytes to preload. Defaults to half the glyph budget so</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t177" href="#t177">177</a></span><span class="t"><span class="str"> that live rendering keeps room to cache what preloading missed.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t178" href="#t178">178</a></span><span class="t"><span class="str"> max_words: Cap on distinct words to preload, before sub-pixel variants.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t179" href="#t179">179</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t180" href="#t180">180</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t181" href="#t181">181</a></span><span class="t"><span class="str"> Tuple of (words preloaded, bytes preloaded).</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t182" href="#t182">182</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t183" href="#t183">183</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">_glyph_fast_path_available</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t184" href="#t184">184</a></span><span class="t"> <span class="key">return</span> <span class="num">0</span><span class="op">,</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t185" href="#t185">185</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t186" href="#t186">186</a></span><span class="t"> <span class="key">if</span> <span class="nam">draw</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t187" href="#t187">187</a></span><span class="t"> <span class="key">from</span> <span class="nam">PIL</span> <span class="key">import</span> <span class="nam">Image</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t188" href="#t188">188</a></span><span class="t"> <span class="nam">draw</span> <span class="op">=</span> <span class="nam">ImageDraw</span><span class="op">.</span><span class="nam">Draw</span><span class="op">(</span><span class="nam">Image</span><span class="op">.</span><span class="nam">new</span><span class="op">(</span><span class="str">'RGBA'</span><span class="op">,</span> <span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="num">1</span><span class="op">)</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t189" href="#t189">189</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t190" href="#t190">190</a></span><span class="t"> <span class="key">if</span> <span class="nam">budget_bytes</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t191" href="#t191">191</a></span><span class="t"> <span class="nam">budget_bytes</span> <span class="op">=</span> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">max_bytes</span> <span class="op">//</span> <span class="num">2</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t192" href="#t192">192</a></span><span class="t"> <span class="nam">budget_bytes</span> <span class="op">=</span> <span class="nam">min</span><span class="op">(</span><span class="nam">budget_bytes</span><span class="op">,</span> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">max_bytes</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t193" href="#t193">193</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t194" href="#t194">194</a></span><span class="t"> <span class="nam">ranked</span> <span class="op">=</span> <span class="nam">sorted</span><span class="op">(</span><span class="nam">entries</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">lambda</span> <span class="nam">e</span><span class="op">:</span> <span class="op">-</span><span class="nam">e</span><span class="op">[</span><span class="num">3</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t195" href="#t195">195</a></span><span class="t"> <span class="key">if</span> <span class="nam">max_words</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t196" href="#t196">196</a></span><span class="t"> <span class="nam">ranked</span> <span class="op">=</span> <span class="nam">ranked</span><span class="op">[</span><span class="op">:</span><span class="nam">max_words</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t197" href="#t197">197</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t198" href="#t198">198</a></span><span class="t"> <span class="nam">steps</span> <span class="op">=</span> <span class="nam">_glyph_subpixel_steps</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t199" href="#t199">199</a></span><span class="t"> <span class="nam">mode</span> <span class="op">=</span> <span class="nam">draw</span><span class="op">.</span><span class="nam">fontmode</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t200" href="#t200">200</a></span><span class="t"> <span class="nam">draw_mode</span> <span class="op">=</span> <span class="nam">draw</span><span class="op">.</span><span class="nam">mode</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t201" href="#t201">201</a></span><span class="t"> <span class="nam">ink_cache</span><span class="op">:</span> <span class="nam">Dict</span><span class="op">[</span><span class="nam">Any</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span> <span class="op">=</span> <span class="op">{</span><span class="op">}</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t202" href="#t202">202</a></span><span class="t"> <span class="nam">words</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t203" href="#t203">203</a></span><span class="t"> <span class="nam">used</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t204" href="#t204">204</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t205" href="#t205">205</a></span><span class="t"> <span class="key">for</span> <span class="nam">font</span><span class="op">,</span> <span class="nam">text</span><span class="op">,</span> <span class="nam">colour</span><span class="op">,</span> <span class="nam">frequency</span> <span class="key">in</span> <span class="nam">ranked</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t206" href="#t206">206</a></span><span class="t"> <span class="key">if</span> <span class="nam">frequency</span> <span class="op"><=</span> <span class="num">1</span> <span class="key">or</span> <span class="nam">used</span> <span class="op">>=</span> <span class="nam">budget_bytes</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t207" href="#t207">207</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t208" href="#t208">208</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">font</span><span class="op">,</span> <span class="nam">ImageFont</span><span class="op">.</span><span class="nam">FreeTypeFont</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t209" href="#t209">209</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t210" href="#t210">210</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t211" href="#t211">211</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t212" href="#t212">212</a></span><span class="t"> <span class="nam">ink</span> <span class="op">=</span> <span class="nam">ink_cache</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">colour</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t213" href="#t213">213</a></span><span class="t"> <span class="key">if</span> <span class="nam">ink</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t214" href="#t214">214</a></span><span class="t"> <span class="nam">ink</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">draw</span><span class="op">.</span><span class="nam">_getink</span><span class="op">(</span><span class="nam">colour</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t215" href="#t215">215</a></span><span class="t"> <span class="key">if</span> <span class="nam">ink</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t216" href="#t216">216</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t217" href="#t217">217</a></span><span class="t"> <span class="nam">ink_cache</span><span class="op">[</span><span class="nam">colour</span><span class="op">]</span> <span class="op">=</span> <span class="nam">ink</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t218" href="#t218">218</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t219" href="#t219">219</a></span><span class="t"> <span class="com"># Measuring is cheap and every layout pass needs it.</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t220" href="#t220">220</a></span><span class="t"> <span class="nam">_width_cache</span><span class="op">.</span><span class="nam">put</span><span class="op">(</span><span class="op">(</span><span class="nam">font</span><span class="op">,</span> <span class="nam">text</span><span class="op">,</span> <span class="nam">draw_mode</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t221" href="#t221">221</a></span><span class="t"> <span class="nam">draw</span><span class="op">.</span><span class="nam">textlength</span><span class="op">(</span><span class="nam">text</span><span class="op">,</span> <span class="nam">font</span><span class="op">=</span><span class="nam">font</span><span class="op">)</span><span class="op">,</span> <span class="nam">count</span><span class="op">=</span><span class="nam">frequency</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t222" href="#t222">222</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t223" href="#t223">223</a></span><span class="t"> <span class="com"># Words land on arbitrary sub-pixel offsets, so cover every horizontal</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t224" href="#t224">224</a></span><span class="t"> <span class="com"># phase. Baselines are whole pixels, so only phase 0 is needed</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t225" href="#t225">225</a></span><span class="t"> <span class="com"># vertically.</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t226" href="#t226">226</a></span><span class="t"> <span class="key">for</span> <span class="nam">x_bucket</span> <span class="key">in</span> <span class="nam">range</span><span class="op">(</span><span class="nam">steps</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t227" href="#t227">227</a></span><span class="t"> <span class="nam">entry</span> <span class="op">=</span> <span class="nam">font</span><span class="op">.</span><span class="nam">getmask2</span><span class="op">(</span><span class="nam">text</span><span class="op">,</span> <span class="nam">mode</span><span class="op">,</span> <span class="nam">anchor</span><span class="op">=</span><span class="str">"ls"</span><span class="op">,</span> <span class="nam">ink</span><span class="op">=</span><span class="nam">ink</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t228" href="#t228">228</a></span><span class="t"> <span class="nam">start</span><span class="op">=</span><span class="op">(</span><span class="nam">x_bucket</span> <span class="op">/</span> <span class="nam">steps</span><span class="op">,</span> <span class="num">0.0</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t229" href="#t229">229</a></span><span class="t"> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">put</span><span class="op">(</span><span class="op">(</span><span class="nam">font</span><span class="op">,</span> <span class="nam">text</span><span class="op">,</span> <span class="nam">mode</span><span class="op">,</span> <span class="nam">ink</span><span class="op">,</span> <span class="nam">x_bucket</span><span class="op">,</span> <span class="num">0</span><span class="op">)</span><span class="op">,</span> <span class="nam">entry</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t230" href="#t230">230</a></span><span class="t"> <span class="nam">count</span><span class="op">=</span><span class="nam">frequency</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t231" href="#t231">231</a></span><span class="t"> <span class="nam">used</span> <span class="op">+=</span> <span class="nam">_glyph_entry_bytes</span><span class="op">(</span><span class="nam">entry</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t232" href="#t232">232</a></span><span class="t"> <span class="nam">words</span> <span class="op">+=</span> <span class="num">1</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t233" href="#t233">233</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t234" href="#t234">234</a></span><span class="t"> <span class="key">except</span> <span class="nam">AttributeError</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t235" href="#t235">235</a></span><span class="t"> <span class="nam">logger</span><span class="op">.</span><span class="nam">warning</span><span class="op">(</span><span class="str">"Glyph cache unavailable for this Pillow build; "</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t236" href="#t236">236</a></span><span class="t"> <span class="str">"skipping prewarm."</span><span class="op">,</span> <span class="nam">exc_info</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t237" href="#t237">237</a></span><span class="t"> <span class="key">return</span> <span class="nam">words</span><span class="op">,</span> <span class="nam">used</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t238" href="#t238">238</a></span><span class="t"> <span class="key">except</span> <span class="op">(</span><span class="nam">TypeError</span><span class="op">,</span> <span class="nam">ValueError</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t239" href="#t239">239</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t240" href="#t240">240</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t241" href="#t241">241</a></span><span class="t"> <span class="nam">logger</span><span class="op">.</span><span class="nam">debug</span><span class="op">(</span><span class="str">"Prewarmed %d words (%.2fMB) into the text caches"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t242" href="#t242">242</a></span><span class="t"> <span class="nam">words</span><span class="op">,</span> <span class="nam">used</span> <span class="op">/</span> <span class="num">1e6</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t243" href="#t243">243</a></span><span class="t"> <span class="key">return</span> <span class="nam">words</span><span class="op">,</span> <span class="nam">used</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t244" href="#t244">244</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t245" href="#t245">245</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t246" href="#t246">246</a></span><span class="t"><span class="key">class</span> <span class="nam">AlignmentHandler</span><span class="op">(</span><span class="nam">ABC</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t247" href="#t247">247</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t248" href="#t248">248</a></span><span class="t"><span class="str"> Abstract base class for text alignment handlers.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t249" href="#t249">249</a></span><span class="t"><span class="str"> Each handler implements a specific alignment strategy.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t250" href="#t250">250</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t251" href="#t251">251</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t252" href="#t252">252</a></span><span class="t"> <span class="op">@</span><span class="nam">abstractmethod</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t253" href="#t253">253</a></span><span class="t"> <span class="key">def</span> <span class="nam">calculate_spacing_and_position</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">text_objects</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t254" href="#t254">254</a></span><span class="t"> <span class="nam">available_width</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">min_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t255" href="#t255">255</a></span><span class="t"> <span class="nam">max_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t256" href="#t256">256</a></span><span class="t"> <span class="nam">natural_spacing</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t257" href="#t257">257</a></span><span class="t"> <span class="nam">total_width</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">float</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t258" href="#t258">258</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">bool</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t259" href="#t259">259</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t260" href="#t260">260</a></span><span class="t"><span class="str"> Calculate the spacing between words and starting position for the line.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t261" href="#t261">261</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t262" href="#t262">262</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t263" href="#t263">263</a></span><span class="t"><span class="str"> text_objects: List of Text objects in the line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t264" href="#t264">264</a></span><span class="t"><span class="str"> available_width: Total width available for the line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t265" href="#t265">265</a></span><span class="t"><span class="str"> min_spacing: Minimum spacing between words</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t266" href="#t266">266</a></span><span class="t"><span class="str"> max_spacing: Maximum spacing between words</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t267" href="#t267">267</a></span><span class="t"><span class="str"> natural_spacing: The font's own space width. Ragged alignments use it</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t268" href="#t268">268</a></span><span class="t"><span class="str"> as a constant gap; justification ignores it. Defaults to</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t269" href="#t269">269</a></span><span class="t"><span class="str"> min_spacing when not supplied.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t270" href="#t270">270</a></span><span class="t"><span class="str"> total_width: The summed width of `text_objects`, when the caller</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t271" href="#t271">271</a></span><span class="t"><span class="str"> already knows it. Purely an optimisation: a line asks its handler</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t272" href="#t272">272</a></span><span class="t"><span class="str"> to re-measure once per candidate word, and summing the whole line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t273" href="#t273">273</a></span><span class="t"><span class="str"> each time makes filling a line quadratic in its word count. Omit</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t274" href="#t274">274</a></span><span class="t"><span class="str"> it and the sum is taken here as before.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t275" href="#t275">275</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t276" href="#t276">276</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t277" href="#t277">277</a></span><span class="t"><span class="str"> Tuple of (spacing_between_words, starting_x_position, overflow)</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t278" href="#t278">278</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t279" href="#t279">279</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t280" href="#t280">280</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t281" href="#t281">281</a></span><span class="t"><span class="key">class</span> <span class="nam">LeftAlignmentHandler</span><span class="op">(</span><span class="nam">AlignmentHandler</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t282" href="#t282">282</a></span><span class="t"> <span class="str">"""Handler for left-aligned text."""</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t283" href="#t283">283</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t284" href="#t284">284</a></span><span class="t"> <span class="key">def</span> <span class="nam">calculate_spacing_and_position</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t285" href="#t285">285</a></span><span class="t"> <span class="nam">text_objects</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t286" href="#t286">286</a></span><span class="t"> <span class="nam">available_width</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t287" href="#t287">287</a></span><span class="t"> <span class="nam">min_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t288" href="#t288">288</a></span><span class="t"> <span class="nam">max_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t289" href="#t289">289</a></span><span class="t"> <span class="nam">natural_spacing</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t290" href="#t290">290</a></span><span class="t"> <span class="nam">total_width</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">float</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t291" href="#t291">291</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">bool</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t292" href="#t292">292</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t293" href="#t293">293</a></span><span class="t"><span class="str"> Calculate spacing and position for left-aligned text objects.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t294" href="#t294">294</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t295" href="#t295">295</a></span><span class="t"><span class="str"> Left-aligned text uses a constant word space and leaves whatever is left</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t296" href="#t296">296</a></span><span class="t"><span class="str"> over as a ragged right edge. It must not spread the residual space across</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t297" href="#t297">297</a></span><span class="t"><span class="str"> the gaps: that stretches each line by a different amount, which reads as</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t298" href="#t298">298</a></span><span class="t"><span class="str"> badly-set justified text rather than as ragged-right.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t299" href="#t299">299</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t300" href="#t300">300</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t301" href="#t301">301</a></span><span class="t"><span class="str"> text_objects (List[Text]): A list of text objects to be laid out.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t302" href="#t302">302</a></span><span class="t"><span class="str"> available_width (int): The total width available for layout.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t303" href="#t303">303</a></span><span class="t"><span class="str"> min_spacing (int): Minimum spacing between text objects.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t304" href="#t304">304</a></span><span class="t"><span class="str"> max_spacing (int): Maximum spacing between text objects.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t305" href="#t305">305</a></span><span class="t"><span class="str"> natural_spacing (Optional[int]): The font's own space width.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t306" href="#t306">306</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t307" href="#t307">307</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t308" href="#t308">308</a></span><span class="t"><span class="str"> Tuple[int, int, bool]: Spacing, start position, and overflow flag.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t309" href="#t309">309</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t310" href="#t310">310</a></span><span class="t"> <span class="com"># Handle single word case</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t311" href="#t311">311</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">text_objects</span><span class="op">)</span> <span class="op"><=</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t312" href="#t312">312</a></span><span class="t"> <span class="key">return</span> <span class="num">0</span><span class="op">,</span> <span class="num">0</span><span class="op">,</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t313" href="#t313">313</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t314" href="#t314">314</a></span><span class="t"> <span class="nam">spacing</span> <span class="op">=</span> <span class="nam">min_spacing</span> <span class="key">if</span> <span class="nam">natural_spacing</span> <span class="key">is</span> <span class="key">None</span> <span class="key">else</span> <span class="nam">natural_spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t315" href="#t315">315</a></span><span class="t"> <span class="nam">spacing</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">min_spacing</span><span class="op">,</span> <span class="nam">min</span><span class="op">(</span><span class="nam">max_spacing</span><span class="op">,</span> <span class="nam">int</span><span class="op">(</span><span class="nam">spacing</span><span class="op">)</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t316" href="#t316">316</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t317" href="#t317">317</a></span><span class="t"> <span class="nam">text_length</span> <span class="op">=</span> <span class="op">(</span><span class="nam">sum</span><span class="op">(</span><span class="op">[</span><span class="nam">text</span><span class="op">.</span><span class="nam">width</span> <span class="key">for</span> <span class="nam">text</span> <span class="key">in</span> <span class="nam">text_objects</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t318" href="#t318">318</a></span><span class="t"> <span class="key">if</span> <span class="nam">total_width</span> <span class="key">is</span> <span class="key">None</span> <span class="key">else</span> <span class="nam">total_width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t319" href="#t319">319</a></span><span class="t"> <span class="nam">num_gaps</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">text_objects</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t320" href="#t320">320</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t321" href="#t321">321</a></span><span class="t"> <span class="com"># The spacing is constant whether or not the content fits: tightening a</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t322" href="#t322">322</a></span><span class="t"> <span class="com"># full line here would make it differ from its neighbours, which is the</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t323" href="#t323">323</a></span><span class="t"> <span class="com"># variation this alignment is supposed to avoid. Report the overflow and</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t324" href="#t324">324</a></span><span class="t"> <span class="com"># let line breaking move the offending word instead.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t325" href="#t325">325</a></span><span class="t"> <span class="nam">overflow</span> <span class="op">=</span> <span class="nam">text_length</span> <span class="op">+</span> <span class="op">(</span><span class="nam">spacing</span> <span class="op">*</span> <span class="nam">num_gaps</span><span class="op">)</span> <span class="op">></span> <span class="nam">available_width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t326" href="#t326">326</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t327" href="#t327">327</a></span><span class="t"> <span class="key">return</span> <span class="nam">spacing</span><span class="op">,</span> <span class="num">0</span><span class="op">,</span> <span class="nam">overflow</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t328" href="#t328">328</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t329" href="#t329">329</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t330" href="#t330">330</a></span><span class="t"><span class="key">class</span> <span class="nam">CenterRightAlignmentHandler</span><span class="op">(</span><span class="nam">AlignmentHandler</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t331" href="#t331">331</a></span><span class="t"> <span class="str">"""Handler for center and right-aligned text."""</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t332" href="#t332">332</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t333" href="#t333">333</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">alignment</span><span class="op">:</span> <span class="nam">Alignment</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t334" href="#t334">334</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_alignment</span> <span class="op">=</span> <span class="nam">alignment</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t335" href="#t335">335</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t336" href="#t336">336</a></span><span class="t"> <span class="key">def</span> <span class="nam">calculate_spacing_and_position</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">text_objects</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t337" href="#t337">337</a></span><span class="t"> <span class="nam">available_width</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">min_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t338" href="#t338">338</a></span><span class="t"> <span class="nam">max_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t339" href="#t339">339</a></span><span class="t"> <span class="nam">natural_spacing</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t340" href="#t340">340</a></span><span class="t"> <span class="nam">total_width</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">float</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t341" href="#t341">341</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">bool</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t342" href="#t342">342</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t343" href="#t343">343</a></span><span class="t"><span class="str"> Centre/right alignment: constant word space, line shifted as a block.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t344" href="#t344">344</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t345" href="#t345">345</a></span><span class="t"><span class="str"> Like left alignment, the residual space must not be spread across the</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t346" href="#t346">346</a></span><span class="t"><span class="str"> gaps - it belongs in the margin. The start position is then derived from</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t347" href="#t347">347</a></span><span class="t"><span class="str"> the same spacing that will actually be used, so the line lands where it</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t348" href="#t348">348</a></span><span class="t"><span class="str"> was measured to land.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t349" href="#t349">349</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t350" href="#t350">350</a></span><span class="t"> <span class="nam">word_length</span> <span class="op">=</span> <span class="op">(</span><span class="nam">sum</span><span class="op">(</span><span class="op">[</span><span class="nam">word</span><span class="op">.</span><span class="nam">width</span> <span class="key">for</span> <span class="nam">word</span> <span class="key">in</span> <span class="nam">text_objects</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t351" href="#t351">351</a></span><span class="t"> <span class="key">if</span> <span class="nam">total_width</span> <span class="key">is</span> <span class="key">None</span> <span class="key">else</span> <span class="nam">total_width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t352" href="#t352">352</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t353" href="#t353">353</a></span><span class="t"> <span class="com"># Handle single word case</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t354" href="#t354">354</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">text_objects</span><span class="op">)</span> <span class="op"><=</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t355" href="#t355">355</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_alignment</span> <span class="op">==</span> <span class="nam">Alignment</span><span class="op">.</span><span class="nam">CENTER</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t356" href="#t356">356</a></span><span class="t"> <span class="nam">start_position</span> <span class="op">=</span> <span class="op">(</span><span class="nam">available_width</span> <span class="op">-</span> <span class="nam">word_length</span><span class="op">)</span> <span class="op">//</span> <span class="num">2</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t357" href="#t357">357</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> <span class="com"># RIGHT</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t358" href="#t358">358</a></span><span class="t"> <span class="nam">start_position</span> <span class="op">=</span> <span class="nam">available_width</span> <span class="op">-</span> <span class="nam">word_length</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t359" href="#t359">359</a></span><span class="t"> <span class="key">return</span> <span class="num">0</span><span class="op">,</span> <span class="nam">max</span><span class="op">(</span><span class="num">0</span><span class="op">,</span> <span class="nam">int</span><span class="op">(</span><span class="nam">start_position</span><span class="op">)</span><span class="op">)</span><span class="op">,</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t360" href="#t360">360</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t361" href="#t361">361</a></span><span class="t"> <span class="nam">spacing</span> <span class="op">=</span> <span class="nam">min_spacing</span> <span class="key">if</span> <span class="nam">natural_spacing</span> <span class="key">is</span> <span class="key">None</span> <span class="key">else</span> <span class="nam">natural_spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t362" href="#t362">362</a></span><span class="t"> <span class="nam">spacing</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">min_spacing</span><span class="op">,</span> <span class="nam">min</span><span class="op">(</span><span class="nam">max_spacing</span><span class="op">,</span> <span class="nam">int</span><span class="op">(</span><span class="nam">spacing</span><span class="op">)</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t363" href="#t363">363</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t364" href="#t364">364</a></span><span class="t"> <span class="nam">num_gaps</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">text_objects</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t365" href="#t365">365</a></span><span class="t"> <span class="nam">overflow</span> <span class="op">=</span> <span class="nam">word_length</span> <span class="op">+</span> <span class="op">(</span><span class="nam">spacing</span> <span class="op">*</span> <span class="nam">num_gaps</span><span class="op">)</span> <span class="op">></span> <span class="nam">available_width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t366" href="#t366">366</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t367" href="#t367">367</a></span><span class="t"> <span class="nam">content_length</span> <span class="op">=</span> <span class="nam">word_length</span> <span class="op">+</span> <span class="nam">num_gaps</span> <span class="op">*</span> <span class="nam">spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t368" href="#t368">368</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_alignment</span> <span class="op">==</span> <span class="nam">Alignment</span><span class="op">.</span><span class="nam">CENTER</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t369" href="#t369">369</a></span><span class="t"> <span class="nam">start_position</span> <span class="op">=</span> <span class="op">(</span><span class="nam">available_width</span> <span class="op">-</span> <span class="nam">content_length</span><span class="op">)</span> <span class="op">//</span> <span class="num">2</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t370" href="#t370">370</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t371" href="#t371">371</a></span><span class="t"> <span class="nam">start_position</span> <span class="op">=</span> <span class="nam">available_width</span> <span class="op">-</span> <span class="nam">content_length</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t372" href="#t372">372</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t373" href="#t373">373</a></span><span class="t"> <span class="key">return</span> <span class="nam">spacing</span><span class="op">,</span> <span class="nam">max</span><span class="op">(</span><span class="num">0</span><span class="op">,</span> <span class="nam">int</span><span class="op">(</span><span class="nam">start_position</span><span class="op">)</span><span class="op">)</span><span class="op">,</span> <span class="nam">overflow</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t374" href="#t374">374</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t375" href="#t375">375</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t376" href="#t376">376</a></span><span class="t"><span class="key">class</span> <span class="nam">JustifyAlignmentHandler</span><span class="op">(</span><span class="nam">AlignmentHandler</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t377" href="#t377">377</a></span><span class="t"> <span class="str">"""Handler for justified text with full justification."""</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t378" href="#t378">378</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t379" href="#t379">379</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t380" href="#t380">380</a></span><span class="t"> <span class="com"># The per-gap spacings are described by a plan rather than stored outright,</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t381" href="#t381">381</a></span><span class="t"> <span class="com"># and materialised on demand by the _gap_spacings property below. Fitting a</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t382" href="#t382">382</a></span><span class="t"> <span class="com"># line calls this handler once per candidate word and only ever looks at the</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t383" href="#t383">383</a></span><span class="t"> <span class="com"># first gap; building the whole list on each of those probes made adding n</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t384" href="#t384">384</a></span><span class="t"> <span class="com"># words to a line O(n^2). Only render() reads the full list.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t385" href="#t385">385</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_uniform</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t386" href="#t386">386</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_residual</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t387" href="#t387">387</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_count</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t388" href="#t388">388</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_cache</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">List</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t389" href="#t389">389</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t390" href="#t390">390</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t391" href="#t391">391</a></span><span class="t"> <span class="key">def</span> <span class="nam">_gap_spacings</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">List</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t392" href="#t392">392</a></span><span class="t"> <span class="str">"""The spacing to apply at each gap, left to right."""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t393" href="#t393">393</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_cache</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t394" href="#t394">394</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_uniform</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">394 ↛ 395</span><span class="annotate long">line 394 didn't jump to line 395 because the condition on line 394 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t395" href="#t395">395</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_cache</span> <span class="op">=</span> <span class="op">[</span><span class="nam">self</span><span class="op">.</span><span class="nam">_gap_uniform</span><span class="op">]</span> <span class="op">*</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_count</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t396" href="#t396">396</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t397" href="#t397">397</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_cache</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_distribute</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_gap_residual</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_count</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t398" href="#t398">398</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_cache</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t399" href="#t399">399</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t400" href="#t400">400</a></span><span class="t"> <span class="op">@</span><span class="nam">staticmethod</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t401" href="#t401">401</a></span><span class="t"> <span class="key">def</span> <span class="nam">_distribute</span><span class="op">(</span><span class="nam">total</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">num_gaps</span><span class="op">:</span> <span class="nam">int</span><span class="op">)</span> <span class="op">-></span> <span class="nam">List</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t402" href="#t402">402</a></span><span class="t"> <span class="str">"""Split `total` pixels across `num_gaps` gaps by cumulative rounding."""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t403" href="#t403">403</a></span><span class="t"> <span class="nam">gaps</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t404" href="#t404">404</a></span><span class="t"> <span class="nam">placed</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t405" href="#t405">405</a></span><span class="t"> <span class="key">for</span> <span class="nam">i</span> <span class="key">in</span> <span class="nam">range</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">num_gaps</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t406" href="#t406">406</a></span><span class="t"> <span class="nam">cumulative</span> <span class="op">=</span> <span class="nam">int</span><span class="op">(</span><span class="nam">round</span><span class="op">(</span><span class="nam">total</span> <span class="op">*</span> <span class="nam">i</span> <span class="op">/</span> <span class="nam">num_gaps</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t407" href="#t407">407</a></span><span class="t"> <span class="nam">gaps</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">cumulative</span> <span class="op">-</span> <span class="nam">placed</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t408" href="#t408">408</a></span><span class="t"> <span class="nam">placed</span> <span class="op">=</span> <span class="nam">cumulative</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t409" href="#t409">409</a></span><span class="t"> <span class="key">return</span> <span class="nam">gaps</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t410" href="#t410">410</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t411" href="#t411">411</a></span><span class="t"> <span class="key">def</span> <span class="nam">calculate_spacing_and_position</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">text_objects</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t412" href="#t412">412</a></span><span class="t"> <span class="nam">available_width</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">min_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t413" href="#t413">413</a></span><span class="t"> <span class="nam">max_spacing</span><span class="op">:</span> <span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t414" href="#t414">414</a></span><span class="t"> <span class="nam">natural_spacing</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t415" href="#t415">415</a></span><span class="t"> <span class="nam">total_width</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">float</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t416" href="#t416">416</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">bool</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t417" href="#t417">417</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t418" href="#t418">418</a></span><span class="t"><span class="str"> Justified alignment distributes space to fill the entire line width.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t419" href="#t419">419</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t420" href="#t420">420</a></span><span class="t"><span class="str"> natural_spacing is ignored: filling the measure is the whole point.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t421" href="#t421">421</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t422" href="#t422">422</a></span><span class="t"><span class="str"> For justified text, we ALWAYS try to fill the entire width by distributing</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t423" href="#t423">423</a></span><span class="t"><span class="str"> space between words, regardless of max_spacing constraints. The only limit</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t424" href="#t424">424</a></span><span class="t"><span class="str"> is min_spacing to ensure readability.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t425" href="#t425">425</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t426" href="#t426">426</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t427" href="#t427">427</a></span><span class="t"> <span class="nam">word_length</span> <span class="op">=</span> <span class="op">(</span><span class="nam">sum</span><span class="op">(</span><span class="op">[</span><span class="nam">word</span><span class="op">.</span><span class="nam">width</span> <span class="key">for</span> <span class="nam">word</span> <span class="key">in</span> <span class="nam">text_objects</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t428" href="#t428">428</a></span><span class="t"> <span class="key">if</span> <span class="nam">total_width</span> <span class="key">is</span> <span class="key">None</span> <span class="key">else</span> <span class="nam">total_width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t429" href="#t429">429</a></span><span class="t"> <span class="nam">residual_space</span> <span class="op">=</span> <span class="nam">available_width</span> <span class="op">-</span> <span class="nam">word_length</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t430" href="#t430">430</a></span><span class="t"> <span class="nam">num_gaps</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">text_objects</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t431" href="#t431">431</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t432" href="#t432">432</a></span><span class="t"> <span class="com"># Check if we have enough space for minimum spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t433" href="#t433">433</a></span><span class="t"> <span class="key">if</span> <span class="nam">residual_space</span> <span class="op">//</span> <span class="nam">num_gaps</span> <span class="op"><</span> <span class="nam">min_spacing</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t434" href="#t434">434</a></span><span class="t"> <span class="com"># Not enough space - this is overflow</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t435" href="#t435">435</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_uniform</span> <span class="op">=</span> <span class="nam">min_spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t436" href="#t436">436</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_count</span> <span class="op">=</span> <span class="nam">num_gaps</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t437" href="#t437">437</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t438" href="#t438">438</a></span><span class="t"> <span class="key">return</span> <span class="nam">min_spacing</span><span class="op">,</span> <span class="num">0</span><span class="op">,</span> <span class="key">True</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t439" href="#t439">439</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t440" href="#t440">440</a></span><span class="t"> <span class="com"># Distribute the residual by cumulative rounding rather than by taking a</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t441" href="#t441">441</a></span><span class="t"> <span class="com"># floor per gap and scattering the remainder. Word widths are fractional,</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t442" href="#t442">442</a></span><span class="t"> <span class="com"># so flooring each gap loses part of a pixel and truncating the remainder</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t443" href="#t443">443</a></span><span class="t"> <span class="com"># loses up to another - the line then stops one or two pixels short of the</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t444" href="#t444">444</a></span><span class="t"> <span class="com"># margin, and by a different amount on each line, which is visible as a</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t445" href="#t445">445</a></span><span class="t"> <span class="com"># ragged right edge on otherwise justified text. Rounding the running</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t446" href="#t446">446</a></span><span class="t"> <span class="com"># total makes the gaps sum to the residual exactly.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t447" href="#t447">447</a></span><span class="t"> <span class="nam">total</span> <span class="op">=</span> <span class="nam">int</span><span class="op">(</span><span class="nam">round</span><span class="op">(</span><span class="nam">residual_space</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t448" href="#t448">448</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_uniform</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t449" href="#t449">449</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_residual</span> <span class="op">=</span> <span class="nam">total</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t450" href="#t450">450</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_count</span> <span class="op">=</span> <span class="nam">num_gaps</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t451" href="#t451">451</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_gap_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t452" href="#t452">452</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t453" href="#t453">453</a></span><span class="t"> <span class="com"># The first gap is the whole of the plan that fitting needs, and it falls</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t454" href="#t454">454</a></span><span class="t"> <span class="com"># out of the same cumulative rounding as _distribute would give it.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t455" href="#t455">455</a></span><span class="t"> <span class="key">return</span> <span class="nam">int</span><span class="op">(</span><span class="nam">round</span><span class="op">(</span><span class="nam">total</span> <span class="op">/</span> <span class="nam">num_gaps</span><span class="op">)</span><span class="op">)</span><span class="op">,</span> <span class="num">0</span><span class="op">,</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t456" href="#t456">456</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t457" href="#t457">457</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t458" href="#t458">458</a></span><span class="t"><span class="key">class</span> <span class="nam">Text</span><span class="op">(</span><span class="nam">Renderable</span><span class="op">,</span> <span class="nam">Queriable</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t459" href="#t459">459</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t460" href="#t460">460</a></span><span class="t"><span class="str"> Concrete implementation for rendering text.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t461" href="#t461">461</a></span><span class="t"><span class="str"> This class handles the visual representation of text fragments.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t462" href="#t462">462</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t463" href="#t463">463</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t464" href="#t464">464</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t465" href="#t465">465</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t466" href="#t466">466</a></span><span class="t"> <span class="nam">text</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t467" href="#t467">467</a></span><span class="t"> <span class="nam">style</span><span class="op">:</span> <span class="nam">Font</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t468" href="#t468">468</a></span><span class="t"> <span class="nam">draw</span><span class="op">:</span> <span class="nam">ImageDraw</span><span class="op">.</span><span class="nam">Draw</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t469" href="#t469">469</a></span><span class="t"> <span class="nam">source</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Word</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t470" href="#t470">470</a></span><span class="t"> <span class="nam">line</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Line</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t471" href="#t471">471</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t472" href="#t472">472</a></span><span class="t"><span class="str"> Initialize a Text object.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t473" href="#t473">473</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t474" href="#t474">474</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t475" href="#t475">475</a></span><span class="t"><span class="str"> text: The text content to render</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t476" href="#t476">476</a></span><span class="t"><span class="str"> style: The font style to use for rendering</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t477" href="#t477">477</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t478" href="#t478">478</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t479" href="#t479">479</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text</span> <span class="op">=</span> <span class="nam">text</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t480" href="#t480">480</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span> <span class="op">=</span> <span class="nam">style</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t481" href="#t481">481</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_line</span> <span class="op">=</span> <span class="nam">line</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t482" href="#t482">482</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_source</span> <span class="op">=</span> <span class="nam">source</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t483" href="#t483">483</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">array</span><span class="op">(</span><span class="op">[</span><span class="num">0</span><span class="op">,</span> <span class="num">0</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t484" href="#t484">484</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span> <span class="op">=</span> <span class="nam">draw</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t485" href="#t485">485</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t486" href="#t486">486</a></span><span class="t"> <span class="com"># Calculate dimensions</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t487" href="#t487">487</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_calculate_dimensions</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t488" href="#t488">488</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t489" href="#t489">489</a></span><span class="t"> <span class="key">def</span> <span class="nam">_calculate_dimensions</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t490" href="#t490">490</a></span><span class="t"> <span class="str">"""Calculate the width and height of the text based on the font metrics"""</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t491" href="#t491">491</a></span><span class="t"> <span class="com"># Measuring a word costs a FreeType shaping pass, and the same words recur</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t492" href="#t492">492</a></span><span class="t"> <span class="com"># constantly within a document, so results are cached per (font, string).</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t493" href="#t493">493</a></span><span class="t"> <span class="com"># The draw's image mode is part of the key because PIL derives advance</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t494" href="#t494">494</a></span><span class="t"> <span class="com"># widths differently for bilevel ("1") targets.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t495" href="#t495">495</a></span><span class="t"> <span class="nam">font</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">font</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t496" href="#t496">496</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="op">(</span><span class="nam">font</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">.</span><span class="nam">mode</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t497" href="#t497">497</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t498" href="#t498">498</a></span><span class="t"> <span class="nam">width</span> <span class="op">=</span> <span class="nam">_width_cache</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t499" href="#t499">499</a></span><span class="t"> <span class="key">if</span> <span class="nam">width</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t500" href="#t500">500</a></span><span class="t"> <span class="nam">width</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">.</span><span class="nam">textlength</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_text</span><span class="op">,</span> <span class="nam">font</span><span class="op">=</span><span class="nam">font</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t501" href="#t501">501</a></span><span class="t"> <span class="nam">_width_cache</span><span class="op">.</span><span class="nam">put</span><span class="op">(</span><span class="nam">key</span><span class="op">,</span> <span class="nam">width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t502" href="#t502">502</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_width</span> <span class="op">=</span> <span class="nam">width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t503" href="#t503">503</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t504" href="#t504">504</a></span><span class="t"> <span class="nam">ascent</span><span class="op">,</span> <span class="nam">descent</span> <span class="op">=</span> <span class="nam">font</span><span class="op">.</span><span class="nam">getmetrics</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t505" href="#t505">505</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_ascent</span> <span class="op">=</span> <span class="nam">ascent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t506" href="#t506">506</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_middle_y</span> <span class="op">=</span> <span class="nam">ascent</span> <span class="op">-</span> <span class="nam">descent</span> <span class="op">/</span> <span class="num">2</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t507" href="#t507">507</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t508" href="#t508">508</a></span><span class="t"> <span class="op">@</span><span class="nam">classmethod</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t509" href="#t509">509</a></span><span class="t"> <span class="key">def</span> <span class="nam">from_word</span><span class="op">(</span><span class="nam">cls</span><span class="op">,</span> <span class="nam">word</span><span class="op">:</span> <span class="nam">Word</span><span class="op">,</span> <span class="nam">draw</span><span class="op">:</span> <span class="nam">ImageDraw</span><span class="op">.</span><span class="nam">Draw</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t510" href="#t510">510</a></span><span class="t"> <span class="key">return</span> <span class="nam">cls</span><span class="op">(</span><span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">,</span> <span class="nam">word</span><span class="op">.</span><span class="nam">style</span><span class="op">,</span> <span class="nam">draw</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t511" href="#t511">511</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t512" href="#t512">512</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t513" href="#t513">513</a></span><span class="t"> <span class="key">def</span> <span class="nam">text</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t514" href="#t514">514</a></span><span class="t"> <span class="str">"""Get the text content"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t515" href="#t515">515</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t516" href="#t516">516</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t517" href="#t517">517</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t518" href="#t518">518</a></span><span class="t"> <span class="key">def</span> <span class="nam">style</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Font</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t519" href="#t519">519</a></span><span class="t"> <span class="str">"""Get the text style"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t520" href="#t520">520</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t521" href="#t521">521</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t522" href="#t522">522</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t523" href="#t523">523</a></span><span class="t"> <span class="key">def</span> <span class="nam">origin</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t524" href="#t524">524</a></span><span class="t"> <span class="str">"""Get the origin of the text"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t525" href="#t525">525</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t526" href="#t526">526</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t527" href="#t527">527</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t528" href="#t528">528</a></span><span class="t"> <span class="key">def</span> <span class="nam">line</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Line</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t529" href="#t529">529</a></span><span class="t"> <span class="str">"""Get the line containing this text"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t530" href="#t530">530</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_line</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t531" href="#t531">531</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t532" href="#t532">532</a></span><span class="t"> <span class="op">@</span><span class="nam">line</span><span class="op">.</span><span class="nam">setter</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t533" href="#t533">533</a></span><span class="t"> <span class="key">def</span> <span class="nam">line</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">line</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t534" href="#t534">534</a></span><span class="t"> <span class="str">"""Set the line containing this text"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t535" href="#t535">535</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_line</span> <span class="op">=</span> <span class="nam">line</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t536" href="#t536">536</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t537" href="#t537">537</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t538" href="#t538">538</a></span><span class="t"> <span class="key">def</span> <span class="nam">width</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">int</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t539" href="#t539">539</a></span><span class="t"> <span class="str">"""Get the width of the text"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t540" href="#t540">540</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t541" href="#t541">541</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t542" href="#t542">542</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t543" href="#t543">543</a></span><span class="t"> <span class="key">def</span> <span class="nam">size</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">int</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t544" href="#t544">544</a></span><span class="t"> <span class="str">"""Get the width and height of the text"""</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t545" href="#t545">545</a></span><span class="t"> <span class="com"># Return actual rendered height (ascent + descent) not just font_size</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t546" href="#t546">546</a></span><span class="t"> <span class="nam">ascent</span><span class="op">,</span> <span class="nam">descent</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">font</span><span class="op">.</span><span class="nam">getmetrics</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t547" href="#t547">547</a></span><span class="t"> <span class="nam">actual_height</span> <span class="op">=</span> <span class="nam">ascent</span> <span class="op">+</span> <span class="nam">descent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t548" href="#t548">548</a></span><span class="t"> <span class="key">return</span> <span class="nam">np</span><span class="op">.</span><span class="nam">array</span><span class="op">(</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_width</span><span class="op">,</span> <span class="nam">actual_height</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t549" href="#t549">549</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t550" href="#t550">550</a></span><span class="t"> <span class="key">def</span> <span class="nam">set_origin</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">origin</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">generic</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t551" href="#t551">551</a></span><span class="t"> <span class="str">"""Set the origin (left baseline ("ls")) of this text element"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t552" href="#t552">552</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span> <span class="op">=</span> <span class="nam">origin</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t553" href="#t553">553</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t554" href="#t554">554</a></span><span class="t"> <span class="key">def</span> <span class="nam">add_line</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">line</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t555" href="#t555">555</a></span><span class="t"> <span class="str">"""Add this text to a line"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t556" href="#t556">556</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_line</span> <span class="op">=</span> <span class="nam">line</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t557" href="#t557">557</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t558" href="#t558">558</a></span><span class="t"> <span class="key">def</span> <span class="nam">in_object</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">point</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">generic</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t559" href="#t559">559</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t560" href="#t560">560</a></span><span class="t"><span class="str"> Check if a point is in the text object.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t561" href="#t561">561</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t562" href="#t562">562</a></span><span class="t"><span class="str"> Override Queriable.in_object() because Text uses baseline-anchored positioning.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t563" href="#t563">563</a></span><span class="t"><span class="str"> The origin is at the baseline (anchor="ls"), not the top-left corner.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t564" href="#t564">564</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t565" href="#t565">565</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t566" href="#t566">566</a></span><span class="t"><span class="str"> point: The coordinates to check</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t567" href="#t567">567</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t568" href="#t568">568</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t569" href="#t569">569</a></span><span class="t"><span class="str"> True if the point is within the text bounds</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t570" href="#t570">570</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t571" href="#t571">571</a></span><span class="t"> <span class="nam">point_array</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">array</span><span class="op">(</span><span class="nam">point</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t572" href="#t572">572</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t573" href="#t573">573</a></span><span class="t"> <span class="com"># Text origin is at baseline, so visual top is origin[1] - ascent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t574" href="#t574">574</a></span><span class="t"> <span class="nam">visual_top</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">-</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_ascent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t575" href="#t575">575</a></span><span class="t"> <span class="nam">visual_bottom</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">+</span> <span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">size</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">-</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_ascent</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t576" href="#t576">576</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t577" href="#t577">577</a></span><span class="t"> <span class="com"># Check if point is within bounds</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t578" href="#t578">578</a></span><span class="t"> <span class="com"># X: origin[0] to origin[0] + width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t579" href="#t579">579</a></span><span class="t"> <span class="com"># Y: visual_top to visual_bottom</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t580" href="#t580">580</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op"><=</span> <span class="nam">point_array</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op"><</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">+</span> <span class="nam">self</span><span class="op">.</span><span class="nam">size</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="key">and</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t581" href="#t581">581</a></span><span class="t"> <span class="nam">visual_top</span> <span class="op"><=</span> <span class="nam">point_array</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op"><</span> <span class="nam">visual_bottom</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t582" href="#t582">582</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t583" href="#t583">583</a></span><span class="t"> <span class="key">def</span> <span class="nam">_apply_decoration</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">next_text</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> <span class="nam">spacing</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">0</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t584" href="#t584">584</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t585" href="#t585">585</a></span><span class="t"><span class="str"> Apply text decoration (underline or strikethrough).</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t586" href="#t586">586</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t587" href="#t587">587</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t588" href="#t588">588</a></span><span class="t"><span class="str"> next_text: The next Text object in the line (if any)</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t589" href="#t589">589</a></span><span class="t"><span class="str"> spacing: The spacing to the next text object</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t590" href="#t590">590</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t591" href="#t591">591</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">decoration</span> <span class="op">==</span> <span class="nam">TextDecoration</span><span class="op">.</span><span class="nam">UNDERLINE</span><span class="op">:</span> </span><span class="r"><span class="annotate short">591 ↛ 609</span><span class="annotate long">line 591 didn't jump to line 609 because the condition on line 591 was always true</span></span></p>
|
|
<p class="pln"><span class="n"><a id="t592" href="#t592">592</a></span><span class="t"> <span class="com"># Draw underline at about 90% of the height</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t593" href="#t593">593</a></span><span class="t"> <span class="nam">y_position</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">-</span> <span class="num">0.1</span> <span class="op">*</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">font_size</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t594" href="#t594">594</a></span><span class="t"> <span class="nam">line_width</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">int</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">font_size</span> <span class="op">/</span> <span class="num">15</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t595" href="#t595">595</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t596" href="#t596">596</a></span><span class="t"> <span class="com"># Determine end x-coordinate</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t597" href="#t597">597</a></span><span class="t"> <span class="nam">end_x</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">+</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t598" href="#t598">598</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t599" href="#t599">599</a></span><span class="t"> <span class="com"># If next text also has underline decoration, extend to connect them</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t600" href="#t600">600</a></span><span class="t"> <span class="key">if</span> <span class="op">(</span><span class="nam">next_text</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t601" href="#t601">601</a></span><span class="t"> <span class="nam">next_text</span><span class="op">.</span><span class="nam">style</span><span class="op">.</span><span class="nam">decoration</span> <span class="op">==</span> <span class="nam">TextDecoration</span><span class="op">.</span><span class="nam">UNDERLINE</span> <span class="key">and</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t602" href="#t602">602</a></span><span class="t"> <span class="nam">next_text</span><span class="op">.</span><span class="nam">style</span><span class="op">.</span><span class="nam">colour</span> <span class="op">==</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">colour</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t603" href="#t603">603</a></span><span class="t"> <span class="com"># Extend the underline through the spacing to connect with next word</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t604" href="#t604">604</a></span><span class="t"> <span class="nam">end_x</span> <span class="op">+=</span> <span class="nam">spacing</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t605" href="#t605">605</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t606" href="#t606">606</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">.</span><span class="nam">line</span><span class="op">(</span><span class="op">[</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> <span class="nam">y_position</span><span class="op">)</span><span class="op">,</span> <span class="op">(</span><span class="nam">end_x</span><span class="op">,</span> <span class="nam">y_position</span><span class="op">)</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t607" href="#t607">607</a></span><span class="t"> <span class="nam">fill</span><span class="op">=</span><span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">colour</span><span class="op">,</span> <span class="nam">width</span><span class="op">=</span><span class="nam">line_width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t608" href="#t608">608</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t609" href="#t609">609</a></span><span class="t"> <span class="key">elif</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">decoration</span> <span class="op">==</span> <span class="nam">TextDecoration</span><span class="op">.</span><span class="nam">STRIKETHROUGH</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t610" href="#t610">610</a></span><span class="t"> <span class="com"># Draw strikethrough at about 50% of the height</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t611" href="#t611">611</a></span><span class="t"> <span class="nam">y_position</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">+</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_middle_y</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t612" href="#t612">612</a></span><span class="t"> <span class="nam">line_width</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">int</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">font_size</span> <span class="op">/</span> <span class="num">15</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t613" href="#t613">613</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t614" href="#t614">614</a></span><span class="t"> <span class="com"># Determine end x-coordinate</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t615" href="#t615">615</a></span><span class="t"> <span class="nam">end_x</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">+</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t616" href="#t616">616</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t617" href="#t617">617</a></span><span class="t"> <span class="com"># If next text also has strikethrough decoration, extend to connect them</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t618" href="#t618">618</a></span><span class="t"> <span class="key">if</span> <span class="op">(</span><span class="nam">next_text</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t619" href="#t619">619</a></span><span class="t"> <span class="nam">next_text</span><span class="op">.</span><span class="nam">style</span><span class="op">.</span><span class="nam">decoration</span> <span class="op">==</span> <span class="nam">TextDecoration</span><span class="op">.</span><span class="nam">STRIKETHROUGH</span> <span class="key">and</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t620" href="#t620">620</a></span><span class="t"> <span class="nam">next_text</span><span class="op">.</span><span class="nam">style</span><span class="op">.</span><span class="nam">colour</span> <span class="op">==</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">colour</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t621" href="#t621">621</a></span><span class="t"> <span class="com"># Extend the strikethrough through the spacing to connect with next word</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t622" href="#t622">622</a></span><span class="t"> <span class="nam">end_x</span> <span class="op">+=</span> <span class="nam">spacing</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t623" href="#t623">623</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t624" href="#t624">624</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">.</span><span class="nam">line</span><span class="op">(</span><span class="op">[</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> <span class="nam">y_position</span><span class="op">)</span><span class="op">,</span> <span class="op">(</span><span class="nam">end_x</span><span class="op">,</span> <span class="nam">y_position</span><span class="op">)</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t625" href="#t625">625</a></span><span class="t"> <span class="nam">fill</span><span class="op">=</span><span class="nam">self</span><span class="op">.</span><span class="nam">_style</span><span class="op">.</span><span class="nam">colour</span><span class="op">,</span> <span class="nam">width</span><span class="op">=</span><span class="nam">line_width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t626" href="#t626">626</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t627" href="#t627">627</a></span><span class="t"> <span class="key">def</span> <span class="nam">render</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">next_text</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> <span class="nam">spacing</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">0</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t628" href="#t628">628</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t629" href="#t629">629</a></span><span class="t"><span class="str"> Render the text to an image.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t630" href="#t630">630</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t631" href="#t631">631</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t632" href="#t632">632</a></span><span class="t"><span class="str"> next_text: The next Text object in the line (if any)</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t633" href="#t633">633</a></span><span class="t"><span class="str"> spacing: The spacing to the next text object</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t634" href="#t634">634</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t635" href="#t635">635</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t636" href="#t636">636</a></span><span class="t"><span class="str"> A PIL Image containing the rendered text</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t637" href="#t637">637</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t638" href="#t638">638</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t639" href="#t639">639</a></span><span class="t"> <span class="nam">style</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_style</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t640" href="#t640">640</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t641" href="#t641">641</a></span><span class="t"> <span class="com"># Draw the text background if specified</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t642" href="#t642">642</a></span><span class="t"> <span class="key">if</span> <span class="nam">style</span><span class="op">.</span><span class="nam">background</span> <span class="key">and</span> <span class="nam">style</span><span class="op">.</span><span class="nam">background</span><span class="op">[</span><span class="num">3</span><span class="op">]</span> <span class="op">></span> <span class="num">0</span><span class="op">:</span> <span class="com"># If alpha > 0</span> </span><span class="r"><span class="annotate short">642 ↛ 643</span><span class="annotate long">line 642 didn't jump to line 643 because the condition on line 642 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t643" href="#t643">643</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">.</span><span class="nam">rectangle</span><span class="op">(</span><span class="op">[</span><span class="nam">tuple</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">)</span><span class="op">,</span> <span class="nam">tuple</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span> <span class="op">+</span> <span class="nam">self</span><span class="op">.</span><span class="nam">size</span><span class="op">)</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t644" href="#t644">644</a></span><span class="t"> <span class="nam">fill</span><span class="op">=</span><span class="nam">style</span><span class="op">.</span><span class="nam">background</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t645" href="#t645">645</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t646" href="#t646">646</a></span><span class="t"> <span class="com"># Draw the text using baseline as anchor point ("ls" = left-baseline)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t647" href="#t647">647</a></span><span class="t"> <span class="com"># This ensures the origin represents the baseline, not the top-left</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t648" href="#t648">648</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_render_from_glyph_cache</span><span class="op">(</span><span class="nam">style</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">648 ↛ 649</span><span class="annotate long">line 648 didn't jump to line 649 because the condition on line 648 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t649" href="#t649">649</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">.</span><span class="nam">text</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t650" href="#t650">650</a></span><span class="t"> <span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t651" href="#t651">651</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t652" href="#t652">652</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t653" href="#t653">653</a></span><span class="t"> <span class="nam">font</span><span class="op">=</span><span class="nam">style</span><span class="op">.</span><span class="nam">font</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t654" href="#t654">654</a></span><span class="t"> <span class="nam">fill</span><span class="op">=</span><span class="nam">style</span><span class="op">.</span><span class="nam">colour</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t655" href="#t655">655</a></span><span class="t"> <span class="nam">anchor</span><span class="op">=</span><span class="str">"ls"</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t656" href="#t656">656</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t657" href="#t657">657</a></span><span class="t"> <span class="com"># Apply any text decorations with knowledge of next text</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t658" href="#t658">658</a></span><span class="t"> <span class="key">if</span> <span class="nam">style</span><span class="op">.</span><span class="nam">decoration</span> <span class="op">!=</span> <span class="nam">TextDecoration</span><span class="op">.</span><span class="nam">NONE</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t659" href="#t659">659</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_apply_decoration</span><span class="op">(</span><span class="nam">next_text</span><span class="op">,</span> <span class="nam">spacing</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t660" href="#t660">660</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t661" href="#t661">661</a></span><span class="t"> <span class="key">def</span> <span class="nam">_render_from_glyph_cache</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">style</span><span class="op">)</span> <span class="op">-></span> <span class="nam">bool</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t662" href="#t662">662</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t663" href="#t663">663</a></span><span class="t"><span class="str"> Blit this word from the cached glyph bitmap.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t664" href="#t664">664</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t665" href="#t665">665</a></span><span class="t"><span class="str"> Rasterising a word is the single most expensive step in drawing a page, and</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t666" href="#t666">666</a></span><span class="t"><span class="str"> the same words recur constantly, so the bitmap PIL would produce is cached</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t667" href="#t667">667</a></span><span class="t"><span class="str"> and blitted directly. This reproduces what ImageDraw.text() does internally</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t668" href="#t668">668</a></span><span class="t"><span class="str"> (getmask2 followed by draw_bitmap) minus the per-call setup.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t669" href="#t669">669</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t670" href="#t670">670</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t671" href="#t671">671</a></span><span class="t"><span class="str"> True if the word was drawn. False means the caller must fall back to</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t672" href="#t672">672</a></span><span class="t"><span class="str"> ImageDraw.text().</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t673" href="#t673">673</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t674" href="#t674">674</a></span><span class="t"> <span class="key">global</span> <span class="nam">_glyph_fast_path_available</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t675" href="#t675">675</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t676" href="#t676">676</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">_glyph_fast_path_available</span><span class="op">:</span> </span><span class="r"><span class="annotate short">676 ↛ 677</span><span class="annotate long">line 676 didn't jump to line 677 because the condition on line 676 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t677" href="#t677">677</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t678" href="#t678">678</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t679" href="#t679">679</a></span><span class="t"> <span class="nam">draw</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t680" href="#t680">680</a></span><span class="t"> <span class="nam">font</span> <span class="op">=</span> <span class="nam">style</span><span class="op">.</span><span class="nam">font</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t681" href="#t681">681</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t682" href="#t682">682</a></span><span class="t"> <span class="com"># Bitmap and other non-FreeType fonts do not expose getmask2's anchor and</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t683" href="#t683">683</a></span><span class="t"> <span class="com"># sub-pixel arguments; let PIL handle them.</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t684" href="#t684">684</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">font</span><span class="op">,</span> <span class="nam">ImageFont</span><span class="op">.</span><span class="nam">FreeTypeFont</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">684 ↛ 685</span><span class="annotate long">line 684 didn't jump to line 685 because the condition on line 684 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t685" href="#t685">685</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t686" href="#t686">686</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t687" href="#t687">687</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t688" href="#t688">688</a></span><span class="t"> <span class="nam">ink</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">draw</span><span class="op">.</span><span class="nam">_getink</span><span class="op">(</span><span class="nam">style</span><span class="op">.</span><span class="nam">colour</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t689" href="#t689">689</a></span><span class="t"> <span class="key">if</span> <span class="nam">ink</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">689 ↛ 690</span><span class="annotate long">line 689 didn't jump to line 690 because the condition on line 689 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t690" href="#t690">690</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t691" href="#t691">691</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t692" href="#t692">692</a></span><span class="t"> <span class="com"># floor() rather than modf() so the fraction is always in [0, 1),</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t693" href="#t693">693</a></span><span class="t"> <span class="com"># keeping bucket indices non-negative for negative coordinates.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t694" href="#t694">694</a></span><span class="t"> <span class="nam">x</span> <span class="op">=</span> <span class="nam">float</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t695" href="#t695">695</a></span><span class="t"> <span class="nam">y</span> <span class="op">=</span> <span class="nam">float</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t696" href="#t696">696</a></span><span class="t"> <span class="nam">x_whole</span> <span class="op">=</span> <span class="nam">math</span><span class="op">.</span><span class="nam">floor</span><span class="op">(</span><span class="nam">x</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t697" href="#t697">697</a></span><span class="t"> <span class="nam">y_whole</span> <span class="op">=</span> <span class="nam">math</span><span class="op">.</span><span class="nam">floor</span><span class="op">(</span><span class="nam">y</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t698" href="#t698">698</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t699" href="#t699">699</a></span><span class="t"> <span class="nam">steps</span> <span class="op">=</span> <span class="nam">_glyph_subpixel_steps</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t700" href="#t700">700</a></span><span class="t"> <span class="nam">x_bucket</span> <span class="op">=</span> <span class="nam">int</span><span class="op">(</span><span class="op">(</span><span class="nam">x</span> <span class="op">-</span> <span class="nam">x_whole</span><span class="op">)</span> <span class="op">*</span> <span class="nam">steps</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t701" href="#t701">701</a></span><span class="t"> <span class="nam">y_bucket</span> <span class="op">=</span> <span class="nam">int</span><span class="op">(</span><span class="op">(</span><span class="nam">y</span> <span class="op">-</span> <span class="nam">y_whole</span><span class="op">)</span> <span class="op">*</span> <span class="nam">steps</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t702" href="#t702">702</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t703" href="#t703">703</a></span><span class="t"> <span class="nam">mode</span> <span class="op">=</span> <span class="nam">draw</span><span class="op">.</span><span class="nam">fontmode</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t704" href="#t704">704</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="op">(</span><span class="nam">font</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text</span><span class="op">,</span> <span class="nam">mode</span><span class="op">,</span> <span class="nam">ink</span><span class="op">,</span> <span class="nam">x_bucket</span><span class="op">,</span> <span class="nam">y_bucket</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t705" href="#t705">705</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t706" href="#t706">706</a></span><span class="t"> <span class="nam">entry</span> <span class="op">=</span> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t707" href="#t707">707</a></span><span class="t"> <span class="key">if</span> <span class="nam">entry</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t708" href="#t708">708</a></span><span class="t"> <span class="nam">entry</span> <span class="op">=</span> <span class="nam">font</span><span class="op">.</span><span class="nam">getmask2</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t709" href="#t709">709</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text</span><span class="op">,</span> <span class="nam">mode</span><span class="op">,</span> <span class="nam">anchor</span><span class="op">=</span><span class="str">"ls"</span><span class="op">,</span> <span class="nam">ink</span><span class="op">=</span><span class="nam">ink</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t710" href="#t710">710</a></span><span class="t"> <span class="nam">start</span><span class="op">=</span><span class="op">(</span><span class="nam">x_bucket</span> <span class="op">/</span> <span class="nam">steps</span><span class="op">,</span> <span class="nam">y_bucket</span> <span class="op">/</span> <span class="nam">steps</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t711" href="#t711">711</a></span><span class="t"> <span class="nam">_glyph_cache</span><span class="op">.</span><span class="nam">put</span><span class="op">(</span><span class="nam">key</span><span class="op">,</span> <span class="nam">entry</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t712" href="#t712">712</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t713" href="#t713">713</a></span><span class="t"> <span class="nam">mask</span><span class="op">,</span> <span class="nam">offset</span> <span class="op">=</span> <span class="nam">entry</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t714" href="#t714">714</a></span><span class="t"> <span class="nam">draw</span><span class="op">.</span><span class="nam">draw</span><span class="op">.</span><span class="nam">draw_bitmap</span><span class="op">(</span><span class="op">(</span><span class="nam">x_whole</span> <span class="op">+</span> <span class="nam">offset</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> <span class="nam">y_whole</span> <span class="op">+</span> <span class="nam">offset</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">)</span><span class="op">,</span> <span class="nam">mask</span><span class="op">,</span> <span class="nam">ink</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t715" href="#t715">715</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t716" href="#t716">716</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t717" href="#t717">717</a></span><span class="t"> <span class="key">except</span> <span class="nam">AttributeError</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t718" href="#t718">718</a></span><span class="t"> <span class="com"># A PIL build without the internals this path relies on. Stop trying.</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t719" href="#t719">719</a></span><span class="t"> <span class="nam">logger</span><span class="op">.</span><span class="nam">warning</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t720" href="#t720">720</a></span><span class="t"> <span class="str">"Glyph cache unavailable for this Pillow build; falling back to "</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t721" href="#t721">721</a></span><span class="t"> <span class="str">"ImageDraw.text() for all text rendering."</span><span class="op">,</span> <span class="nam">exc_info</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t722" href="#t722">722</a></span><span class="t"> <span class="nam">_glyph_fast_path_available</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t723" href="#t723">723</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t724" href="#t724">724</a></span><span class="t"> <span class="key">except</span> <span class="op">(</span><span class="nam">TypeError</span><span class="op">,</span> <span class="nam">ValueError</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t725" href="#t725">725</a></span><span class="t"> <span class="com"># This particular colour/mode combination is not supported by the fast</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t726" href="#t726">726</a></span><span class="t"> <span class="com"># path (e.g. an ink PIL cannot resolve). Others may still be.</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t727" href="#t727">727</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t728" href="#t728">728</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t729" href="#t729">729</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t730" href="#t730">730</a></span><span class="t"><span class="key">class</span> <span class="nam">Line</span><span class="op">(</span><span class="nam">Box</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t731" href="#t731">731</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t732" href="#t732">732</a></span><span class="t"><span class="str"> A line of text consisting of Text objects with consistent spacing.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t733" href="#t733">733</a></span><span class="t"><span class="str"> Each Text represents a word or word fragment that can be rendered.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t734" href="#t734">734</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t735" href="#t735">735</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t736" href="#t736">736</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t737" href="#t737">737</a></span><span class="t"> <span class="nam">spacing</span><span class="op">:</span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t738" href="#t738">738</a></span><span class="t"> <span class="nam">int</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t739" href="#t739">739</a></span><span class="t"> <span class="nam">origin</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t740" href="#t740">740</a></span><span class="t"> <span class="nam">size</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t741" href="#t741">741</a></span><span class="t"> <span class="nam">draw</span><span class="op">:</span> <span class="nam">ImageDraw</span><span class="op">.</span><span class="nam">Draw</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t742" href="#t742">742</a></span><span class="t"> <span class="nam">font</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Font</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t743" href="#t743">743</a></span><span class="t"> <span class="nam">callback</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t744" href="#t744">744</a></span><span class="t"> <span class="nam">sheet</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t745" href="#t745">745</a></span><span class="t"> <span class="nam">mode</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t746" href="#t746">746</a></span><span class="t"> <span class="nam">halign</span><span class="op">=</span><span class="nam">Alignment</span><span class="op">.</span><span class="nam">CENTER</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t747" href="#t747">747</a></span><span class="t"> <span class="nam">valign</span><span class="op">=</span><span class="nam">Alignment</span><span class="op">.</span><span class="nam">CENTER</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t748" href="#t748">748</a></span><span class="t"> <span class="nam">previous</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t749" href="#t749">749</a></span><span class="t"> <span class="nam">min_word_length_for_brute_force</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">8</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t750" href="#t750">750</a></span><span class="t"> <span class="nam">min_chars_before_hyphen</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">2</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t751" href="#t751">751</a></span><span class="t"> <span class="nam">min_chars_after_hyphen</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">2</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t752" href="#t752">752</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t753" href="#t753">753</a></span><span class="t"><span class="str"> Initialize a new line.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t754" href="#t754">754</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t755" href="#t755">755</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t756" href="#t756">756</a></span><span class="t"><span class="str"> spacing: A tuple of (min_spacing, max_spacing) between words</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t757" href="#t757">757</a></span><span class="t"><span class="str"> origin: The top-left position of the line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t758" href="#t758">758</a></span><span class="t"><span class="str"> size: The width and height of the line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t759" href="#t759">759</a></span><span class="t"><span class="str"> font: The default font to use for text in this line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t760" href="#t760">760</a></span><span class="t"><span class="str"> callback: Optional callback function</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t761" href="#t761">761</a></span><span class="t"><span class="str"> sheet: Optional image sheet</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t762" href="#t762">762</a></span><span class="t"><span class="str"> mode: Optional image mode</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t763" href="#t763">763</a></span><span class="t"><span class="str"> halign: Horizontal alignment of text within the line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t764" href="#t764">764</a></span><span class="t"><span class="str"> valign: Vertical alignment of text within the line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t765" href="#t765">765</a></span><span class="t"><span class="str"> previous: Reference to the previous line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t766" href="#t766">766</a></span><span class="t"><span class="str"> min_word_length_for_brute_force: Minimum word length to attempt brute force hyphenation (default: 8)</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t767" href="#t767">767</a></span><span class="t"><span class="str"> min_chars_before_hyphen: Minimum characters before hyphen in any split (default: 2)</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t768" href="#t768">768</a></span><span class="t"><span class="str"> min_chars_after_hyphen: Minimum characters after hyphen in any split (default: 2)</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t769" href="#t769">769</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t770" href="#t770">770</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="nam">origin</span><span class="op">,</span> <span class="nam">size</span><span class="op">,</span> <span class="nam">callback</span><span class="op">,</span> <span class="nam">sheet</span><span class="op">,</span> <span class="nam">mode</span><span class="op">,</span> <span class="nam">halign</span><span class="op">,</span> <span class="nam">valign</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t771" href="#t771">771</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> <span class="com"># Store Text objects directly</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t772" href="#t772">772</a></span><span class="t"> <span class="com"># Prefix sums of the widths in _text_objects, kept in step by _push_text /</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t773" href="#t773">773</a></span><span class="t"> <span class="com"># _pop_text. Element 0 is the empty sum. See _push_text for the rationale.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t774" href="#t774">774</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_width_prefix</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="nam">float</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="num">0.0</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t775" href="#t775">775</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing</span> <span class="op">=</span> <span class="nam">spacing</span> <span class="com"># (min_spacing, max_spacing)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t776" href="#t776">776</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_font</span> <span class="op">=</span> <span class="nam">font</span> <span class="key">if</span> <span class="nam">font</span> <span class="key">else</span> <span class="nam">Font</span><span class="op">(</span><span class="op">)</span> <span class="com"># Use default font if none provided</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t777" href="#t777">777</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_current_width</span> <span class="op">=</span> <span class="num">0</span> <span class="com"># Track the current width used</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t778" href="#t778">778</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_words</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="str">'Word'</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t779" href="#t779">779</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_previous</span> <span class="op">=</span> <span class="nam">previous</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t780" href="#t780">780</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_next</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t781" href="#t781">781</a></span><span class="t"> <span class="nam">ascent</span><span class="op">,</span> <span class="nam">descent</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_font</span><span class="op">.</span><span class="nam">font</span><span class="op">.</span><span class="nam">getmetrics</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t782" href="#t782">782</a></span><span class="t"> <span class="com"># Store baseline as offset from line origin (top), not absolute position</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t783" href="#t783">783</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_baseline</span> <span class="op">=</span> <span class="nam">ascent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t784" href="#t784">784</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span> <span class="op">=</span> <span class="nam">draw</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t785" href="#t785">785</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing_render</span> <span class="op">=</span> <span class="op">(</span><span class="nam">spacing</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">+</span> <span class="nam">spacing</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">)</span> <span class="op">//</span> <span class="num">2</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t786" href="#t786">786</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_position_render</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t787" href="#t787">787</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t788" href="#t788">788</a></span><span class="t"> <span class="com"># The font's own space advance. Ragged alignments use this as their</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t789" href="#t789">789</a></span><span class="t"> <span class="com"># constant word gap rather than stretching to fill the measure.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t790" href="#t790">790</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_natural_spacing</span> <span class="op">=</span> <span class="nam">_space_advance</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_font</span><span class="op">.</span><span class="nam">font</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t791" href="#t791">791</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t792" href="#t792">792</a></span><span class="t"> <span class="com"># Hyphenation configuration parameters</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t793" href="#t793">793</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_word_length_for_brute_force</span> <span class="op">=</span> <span class="nam">min_word_length_for_brute_force</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t794" href="#t794">794</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_before_hyphen</span> <span class="op">=</span> <span class="nam">min_chars_before_hyphen</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t795" href="#t795">795</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_after_hyphen</span> <span class="op">=</span> <span class="nam">min_chars_after_hyphen</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t796" href="#t796">796</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t797" href="#t797">797</a></span><span class="t"> <span class="com"># Create the appropriate alignment handler</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t798" href="#t798">798</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_alignment_handler</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_create_alignment_handler</span><span class="op">(</span><span class="nam">halign</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t799" href="#t799">799</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t800" href="#t800">800</a></span><span class="t"> <span class="com"># Set on the final line of a paragraph. Justification stretches a line to</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t801" href="#t801">801</a></span><span class="t"> <span class="com"># fill the column, which is wrong for the last line - a three-word tail</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t802" href="#t802">802</a></span><span class="t"> <span class="com"># would be spread across the full measure. The last line takes its</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t803" href="#t803">803</a></span><span class="t"> <span class="com"># natural width instead, as in every other typesetting system.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t804" href="#t804">804</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_is_paragraph_end</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t805" href="#t805">805</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t806" href="#t806">806</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t807" href="#t807">807</a></span><span class="t"> <span class="key">def</span> <span class="nam">is_paragraph_end</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">bool</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t808" href="#t808">808</a></span><span class="t"> <span class="str">"""Whether this is the final line of its paragraph"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t809" href="#t809">809</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_is_paragraph_end</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t810" href="#t810">810</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t811" href="#t811">811</a></span><span class="t"> <span class="op">@</span><span class="nam">is_paragraph_end</span><span class="op">.</span><span class="nam">setter</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t812" href="#t812">812</a></span><span class="t"> <span class="key">def</span> <span class="nam">is_paragraph_end</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">value</span><span class="op">:</span> <span class="nam">bool</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t813" href="#t813">813</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_is_paragraph_end</span> <span class="op">=</span> <span class="nam">value</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t814" href="#t814">814</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t815" href="#t815">815</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t816" href="#t816">816</a></span><span class="t"> <span class="key">def</span> <span class="nam">render_alignment_handler</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">AlignmentHandler</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t817" href="#t817">817</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t818" href="#t818">818</a></span><span class="t"><span class="str"> The handler used to position text when rendering.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t819" href="#t819">819</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t820" href="#t820">820</a></span><span class="t"><span class="str"> This differs from the fitting handler only for the last line of a</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t821" href="#t821">821</a></span><span class="t"><span class="str"> justified paragraph, which is rendered flush left.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t822" href="#t822">822</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t823" href="#t823">823</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_is_paragraph_end</span> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t824" href="#t824">824</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_alignment_handler</span><span class="op">,</span> <span class="nam">JustifyAlignmentHandler</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t825" href="#t825">825</a></span><span class="t"> <span class="key">return</span> <span class="nam">LeftAlignmentHandler</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t826" href="#t826">826</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_alignment_handler</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t827" href="#t827">827</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t828" href="#t828">828</a></span><span class="t"> <span class="key">def</span> <span class="nam">_create_alignment_handler</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">alignment</span><span class="op">:</span> <span class="nam">Alignment</span><span class="op">)</span> <span class="op">-></span> <span class="nam">AlignmentHandler</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t829" href="#t829">829</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t830" href="#t830">830</a></span><span class="t"><span class="str"> Create the appropriate alignment handler based on the alignment type.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t831" href="#t831">831</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t832" href="#t832">832</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t833" href="#t833">833</a></span><span class="t"><span class="str"> alignment: The alignment type</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t834" href="#t834">834</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t835" href="#t835">835</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t836" href="#t836">836</a></span><span class="t"><span class="str"> The appropriate alignment handler instance</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t837" href="#t837">837</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t838" href="#t838">838</a></span><span class="t"> <span class="key">if</span> <span class="nam">alignment</span> <span class="op">==</span> <span class="nam">Alignment</span><span class="op">.</span><span class="nam">LEFT</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t839" href="#t839">839</a></span><span class="t"> <span class="key">return</span> <span class="nam">LeftAlignmentHandler</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t840" href="#t840">840</a></span><span class="t"> <span class="key">elif</span> <span class="nam">alignment</span> <span class="op">==</span> <span class="nam">Alignment</span><span class="op">.</span><span class="nam">JUSTIFY</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t841" href="#t841">841</a></span><span class="t"> <span class="key">return</span> <span class="nam">JustifyAlignmentHandler</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t842" href="#t842">842</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> <span class="com"># CENTER or RIGHT</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t843" href="#t843">843</a></span><span class="t"> <span class="key">return</span> <span class="nam">CenterRightAlignmentHandler</span><span class="op">(</span><span class="nam">alignment</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t844" href="#t844">844</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t845" href="#t845">845</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t846" href="#t846">846</a></span><span class="t"> <span class="key">def</span> <span class="nam">text_objects</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">List</span><span class="op">[</span><span class="nam">Text</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t847" href="#t847">847</a></span><span class="t"> <span class="str">"""Get the list of Text objects in this line"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t848" href="#t848">848</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t849" href="#t849">849</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t850" href="#t850">850</a></span><span class="t"> <span class="key">def</span> <span class="nam">set_next</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">line</span><span class="op">:</span> <span class="nam">Line</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t851" href="#t851">851</a></span><span class="t"> <span class="str">"""Set the next line in sequence"""</span> </span><span class="r"></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t852" href="#t852">852</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_next</span> <span class="op">=</span> <span class="nam">line</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t853" href="#t853">853</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t854" href="#t854">854</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t855" href="#t855">855</a></span><span class="t"> <span class="key">def</span> <span class="nam">_content_width</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">float</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t856" href="#t856">856</a></span><span class="t"> <span class="str">"""Summed width of the line's current contents."""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t857" href="#t857">857</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_width_prefix</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t858" href="#t858">858</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t859" href="#t859">859</a></span><span class="t"> <span class="key">def</span> <span class="nam">_push_text</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">text</span><span class="op">:</span> <span class="str">'Text'</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t860" href="#t860">860</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t861" href="#t861">861</a></span><span class="t"><span class="str"> Append a Text to the line, keeping the running width sum in step.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t862" href="#t862">862</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t863" href="#t863">863</a></span><span class="t"><span class="str"> Fitting a word is a trial: the candidate is pushed, measured, and popped</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t864" href="#t864">864</a></span><span class="t"><span class="str"> again if it did not fit, so the line's contents churn far more often than</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t865" href="#t865">865</a></span><span class="t"><span class="str"> they grow. Tracking the sum here rather than re-adding every width on each</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t866" href="#t866">866</a></span><span class="t"><span class="str"> measurement is what keeps filling a line linear in its word count.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t867" href="#t867">867</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t868" href="#t868">868</a></span><span class="t"><span class="str"> The sum is kept as a prefix list rather than as one accumulator that is</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t869" href="#t869">869</a></span><span class="t"><span class="str"> added to and subtracted from. Widths are floats, so `(total + w) - w` need</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t870" href="#t870">870</a></span><span class="t"><span class="str"> not give back `total` exactly, and a drift of one ulp is enough to flip an</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t871" href="#t871">871</a></span><span class="t"><span class="str"> overflow decision on a line that ends flush. Truncating a prefix list</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t872" href="#t872">872</a></span><span class="t"><span class="str"> restores the earlier total bit for bit, and each entry is built by the same</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t873" href="#t873">873</a></span><span class="t"><span class="str"> left-to-right addition sum() would perform.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t874" href="#t874">874</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t875" href="#t875">875</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">text</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t876" href="#t876">876</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_width_prefix</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_width_prefix</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span> <span class="op">+</span> <span class="nam">text</span><span class="op">.</span><span class="nam">width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t877" href="#t877">877</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t878" href="#t878">878</a></span><span class="t"> <span class="key">def</span> <span class="nam">_pop_text</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="str">'Text'</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t879" href="#t879">879</a></span><span class="t"> <span class="str">"""Remove the last Text from the line, keeping the width sum in step."""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t880" href="#t880">880</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span><span class="op">.</span><span class="nam">pop</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t881" href="#t881">881</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_width_prefix</span><span class="op">.</span><span class="nam">pop</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t882" href="#t882">882</a></span><span class="t"> <span class="key">return</span> <span class="nam">text</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t883" href="#t883">883</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t884" href="#t884">884</a></span><span class="t"> <span class="key">def</span> <span class="nam">_measure</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">handler</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">AlignmentHandler</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t885" href="#t885">885</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">bool</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t886" href="#t886">886</a></span><span class="t"> <span class="str">"""Ask an alignment handler to place the line's current contents."""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t887" href="#t887">887</a></span><span class="t"> <span class="key">if</span> <span class="nam">handler</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t888" href="#t888">888</a></span><span class="t"> <span class="nam">handler</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_alignment_handler</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t889" href="#t889">889</a></span><span class="t"> <span class="key">return</span> <span class="nam">handler</span><span class="op">.</span><span class="nam">calculate_spacing_and_position</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t890" href="#t890">890</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_size</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t891" href="#t891">891</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_natural_spacing</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_content_width</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t892" href="#t892">892</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t893" href="#t893">893</a></span><span class="t"> <span class="key">def</span> <span class="nam">add_word</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t894" href="#t894">894</a></span><span class="t"> <span class="nam">word</span><span class="op">:</span> <span class="str">'Word'</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t895" href="#t895">895</a></span><span class="t"> <span class="nam">part</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Text</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t896" href="#t896">896</a></span><span class="t"> <span class="nam">Optional</span><span class="op">[</span><span class="str">'Text'</span><span class="op">]</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t897" href="#t897">897</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t898" href="#t898">898</a></span><span class="t"><span class="str"> Add a word to this line using intelligent word fitting strategies.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t899" href="#t899">899</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t900" href="#t900">900</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t901" href="#t901">901</a></span><span class="t"><span class="str"> word: The word to add to the line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t902" href="#t902">902</a></span><span class="t"><span class="str"> part: Optional pretext from a previous hyphenated word</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t903" href="#t903">903</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t904" href="#t904">904</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t905" href="#t905">905</a></span><span class="t"><span class="str"> Tuple of (success, overflow_text):</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t906" href="#t906">906</a></span><span class="t"><span class="str"> - success: True if word/part was added, False if it couldn't fit</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t907" href="#t907">907</a></span><span class="t"><span class="str"> - overflow_text: Remaining text if word was hyphenated, None otherwise</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t908" href="#t908">908</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t909" href="#t909">909</a></span><span class="t"> <span class="com"># First, add any pretext from previous hyphenation</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t910" href="#t910">910</a></span><span class="t"> <span class="key">if</span> <span class="nam">part</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t911" href="#t911">911</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_push_text</span><span class="op">(</span><span class="nam">part</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t912" href="#t912">912</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_words</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t913" href="#t913">913</a></span><span class="t"> <span class="nam">part</span><span class="op">.</span><span class="nam">add_line</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t914" href="#t914">914</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t915" href="#t915">915</a></span><span class="t"> <span class="com"># Try to add the full word - create LinkText for LinkedWord, regular Text</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t916" href="#t916">916</a></span><span class="t"> <span class="com"># otherwise</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t917" href="#t917">917</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">word</span><span class="op">,</span> <span class="nam">LinkedWord</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t918" href="#t918">918</a></span><span class="t"> <span class="com"># Import here to avoid circular dependency</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t919" href="#t919">919</a></span><span class="t"> <span class="key">from</span> <span class="op">.</span><span class="nam">functional</span> <span class="key">import</span> <span class="nam">LinkText</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t920" href="#t920">920</a></span><span class="t"> <span class="com"># Create a LinkText which includes the link functionality</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t921" href="#t921">921</a></span><span class="t"> <span class="com"># LinkText constructor needs: (link, text, font, draw, source, line)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t922" href="#t922">922</a></span><span class="t"> <span class="com"># But LinkedWord itself contains the link properties</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t923" href="#t923">923</a></span><span class="t"> <span class="com"># We'll create a Link object from the LinkedWord properties</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t924" href="#t924">924</a></span><span class="t"> <span class="nam">link</span> <span class="op">=</span> <span class="nam">Link</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t925" href="#t925">925</a></span><span class="t"> <span class="nam">location</span><span class="op">=</span><span class="nam">word</span><span class="op">.</span><span class="nam">location</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t926" href="#t926">926</a></span><span class="t"> <span class="nam">link_type</span><span class="op">=</span><span class="nam">word</span><span class="op">.</span><span class="nam">link_type</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t927" href="#t927">927</a></span><span class="t"> <span class="nam">callback</span><span class="op">=</span><span class="nam">word</span><span class="op">.</span><span class="nam">link_callback</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t928" href="#t928">928</a></span><span class="t"> <span class="nam">params</span><span class="op">=</span><span class="nam">word</span><span class="op">.</span><span class="nam">params</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t929" href="#t929">929</a></span><span class="t"> <span class="nam">title</span><span class="op">=</span><span class="nam">word</span><span class="op">.</span><span class="nam">link_title</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t930" href="#t930">930</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t931" href="#t931">931</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="nam">LinkText</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t932" href="#t932">932</a></span><span class="t"> <span class="nam">link</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t933" href="#t933">933</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t934" href="#t934">934</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">style</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t935" href="#t935">935</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t936" href="#t936">936</a></span><span class="t"> <span class="nam">source</span><span class="op">=</span><span class="nam">word</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t937" href="#t937">937</a></span><span class="t"> <span class="nam">line</span><span class="op">=</span><span class="nam">self</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t938" href="#t938">938</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t939" href="#t939">939</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="nam">Text</span><span class="op">.</span><span class="nam">from_word</span><span class="op">(</span><span class="nam">word</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t940" href="#t940">940</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_push_text</span><span class="op">(</span><span class="nam">text</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t941" href="#t941">941</a></span><span class="t"> <span class="nam">spacing</span><span class="op">,</span> <span class="nam">position</span><span class="op">,</span> <span class="nam">overflow</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_measure</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t942" href="#t942">942</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t943" href="#t943">943</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">overflow</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t944" href="#t944">944</a></span><span class="t"> <span class="com"># Word fits! Add it completely</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t945" href="#t945">945</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_words</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t946" href="#t946">946</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">add_concete</span><span class="op">(</span><span class="nam">text</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t947" href="#t947">947</a></span><span class="t"> <span class="nam">text</span><span class="op">.</span><span class="nam">add_line</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t948" href="#t948">948</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_position_render</span> <span class="op">=</span> <span class="nam">position</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t949" href="#t949">949</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing_render</span> <span class="op">=</span> <span class="nam">spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t950" href="#t950">950</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span><span class="op">,</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t951" href="#t951">951</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t952" href="#t952">952</a></span><span class="t"> <span class="com"># Word doesn't fit, remove it and try hyphenation</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t953" href="#t953">953</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_pop_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t954" href="#t954">954</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t955" href="#t955">955</a></span><span class="t"> <span class="com"># Step 1: Try pyphen hyphenation</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t956" href="#t956">956</a></span><span class="t"> <span class="nam">pyphen_splits</span> <span class="op">=</span> <span class="nam">word</span><span class="op">.</span><span class="nam">possible_hyphenation</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t957" href="#t957">957</a></span><span class="t"> <span class="nam">valid_splits</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t958" href="#t958">958</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t959" href="#t959">959</a></span><span class="t"> <span class="key">if</span> <span class="nam">pyphen_splits</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t960" href="#t960">960</a></span><span class="t"> <span class="com"># Create Text objects for each possible split and check if they fit</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t961" href="#t961">961</a></span><span class="t"> <span class="key">for</span> <span class="nam">pair</span> <span class="key">in</span> <span class="nam">pyphen_splits</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t962" href="#t962">962</a></span><span class="t"> <span class="nam">first_part_text</span> <span class="op">=</span> <span class="nam">pair</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">+</span> <span class="str">"-"</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t963" href="#t963">963</a></span><span class="t"> <span class="nam">second_part_text</span> <span class="op">=</span> <span class="nam">pair</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t964" href="#t964">964</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t965" href="#t965">965</a></span><span class="t"> <span class="com"># Validate minimum character requirements</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t966" href="#t966">966</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">pair</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">)</span> <span class="op"><</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_before_hyphen</span><span class="op">:</span> </span><span class="r"><span class="annotate short">966 ↛ 967</span><span class="annotate long">line 966 didn't jump to line 967 because the condition on line 966 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t967" href="#t967">967</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t968" href="#t968">968</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">pair</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">)</span> <span class="op"><</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_after_hyphen</span><span class="op">:</span> </span><span class="r"><span class="annotate short">968 ↛ 969</span><span class="annotate long">line 968 didn't jump to line 969 because the condition on line 968 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t969" href="#t969">969</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t970" href="#t970">970</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t971" href="#t971">971</a></span><span class="t"> <span class="com"># Create Text objects</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t972" href="#t972">972</a></span><span class="t"> <span class="nam">first_text</span> <span class="op">=</span> <span class="nam">Text</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t973" href="#t973">973</a></span><span class="t"> <span class="nam">first_part_text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t974" href="#t974">974</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">style</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t975" href="#t975">975</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t976" href="#t976">976</a></span><span class="t"> <span class="nam">line</span><span class="op">=</span><span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t977" href="#t977">977</a></span><span class="t"> <span class="nam">source</span><span class="op">=</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t978" href="#t978">978</a></span><span class="t"> <span class="nam">second_text</span> <span class="op">=</span> <span class="nam">Text</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t979" href="#t979">979</a></span><span class="t"> <span class="nam">second_part_text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t980" href="#t980">980</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">style</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t981" href="#t981">981</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t982" href="#t982">982</a></span><span class="t"> <span class="nam">line</span><span class="op">=</span><span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t983" href="#t983">983</a></span><span class="t"> <span class="nam">source</span><span class="op">=</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t984" href="#t984">984</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t985" href="#t985">985</a></span><span class="t"> <span class="com"># Check if first part fits</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t986" href="#t986">986</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_push_text</span><span class="op">(</span><span class="nam">first_text</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t987" href="#t987">987</a></span><span class="t"> <span class="nam">spacing</span><span class="op">,</span> <span class="nam">position</span><span class="op">,</span> <span class="nam">overflow</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_measure</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t988" href="#t988">988</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_pop_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t989" href="#t989">989</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t990" href="#t990">990</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">overflow</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t991" href="#t991">991</a></span><span class="t"> <span class="com"># This split fits! Add it to valid options</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t992" href="#t992">992</a></span><span class="t"> <span class="nam">valid_splits</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="op">(</span><span class="nam">first_text</span><span class="op">,</span> <span class="nam">second_text</span><span class="op">,</span> <span class="nam">spacing</span><span class="op">,</span> <span class="nam">position</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t993" href="#t993">993</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t994" href="#t994">994</a></span><span class="t"> <span class="com"># Step 2: If we have valid pyphen splits, choose the best one</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t995" href="#t995">995</a></span><span class="t"> <span class="key">if</span> <span class="nam">valid_splits</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t996" href="#t996">996</a></span><span class="t"> <span class="com"># Select the split with the best (minimum) spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t997" href="#t997">997</a></span><span class="t"> <span class="nam">best_split</span> <span class="op">=</span> <span class="nam">min</span><span class="op">(</span><span class="nam">valid_splits</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">lambda</span> <span class="nam">x</span><span class="op">:</span> <span class="nam">x</span><span class="op">[</span><span class="num">2</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t998" href="#t998">998</a></span><span class="t"> <span class="nam">first_text</span><span class="op">,</span> <span class="nam">second_text</span><span class="op">,</span> <span class="nam">spacing</span><span class="op">,</span> <span class="nam">position</span> <span class="op">=</span> <span class="nam">best_split</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t999" href="#t999">999</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1000" href="#t1000">1000</a></span><span class="t"> <span class="com"># Apply the split</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1001" href="#t1001">1001</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_push_text</span><span class="op">(</span><span class="nam">first_text</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1002" href="#t1002">1002</a></span><span class="t"> <span class="nam">first_text</span><span class="op">.</span><span class="nam">line</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1003" href="#t1003">1003</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">add_concete</span><span class="op">(</span><span class="op">(</span><span class="nam">first_text</span><span class="op">,</span> <span class="nam">second_text</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1004" href="#t1004">1004</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing_render</span> <span class="op">=</span> <span class="nam">spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1005" href="#t1005">1005</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_position_render</span> <span class="op">=</span> <span class="nam">position</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1006" href="#t1006">1006</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_words</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1007" href="#t1007">1007</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span><span class="op">,</span> <span class="nam">second_text</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1008" href="#t1008">1008</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1009" href="#t1009">1009</a></span><span class="t"> <span class="com"># Step 3: Try brute force hyphenation (only for long words)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1010" href="#t1010">1010</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">)</span> <span class="op">>=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_word_length_for_brute_force</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1011" href="#t1011">1011</a></span><span class="t"> <span class="com"># Calculate available space for the word</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1012" href="#t1012">1012</a></span><span class="t"> <span class="nam">word_length</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_content_width</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1013" href="#t1013">1013</a></span><span class="t"> <span class="nam">spacing_length</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">*</span> <span class="nam">max</span><span class="op">(</span><span class="num">0</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1014" href="#t1014">1014</a></span><span class="t"> <span class="nam">remaining</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_size</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">-</span> <span class="nam">word_length</span> <span class="op">-</span> <span class="nam">spacing_length</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1015" href="#t1015">1015</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t1016" href="#t1016">1016</a></span><span class="t"> <span class="key">if</span> <span class="nam">remaining</span> <span class="op">></span> <span class="num">0</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1016 ↛ 1073</span><span class="annotate long">line 1016 didn't jump to line 1073 because the condition on line 1016 was always true</span></span></p>
|
|
<p class="pln"><span class="n"><a id="t1017" href="#t1017">1017</a></span><span class="t"> <span class="com"># Create a hyphenated version to measure</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1018" href="#t1018">1018</a></span><span class="t"> <span class="nam">test_text</span> <span class="op">=</span> <span class="nam">Text</span><span class="op">(</span><span class="nam">word</span><span class="op">.</span><span class="nam">text</span> <span class="op">+</span> <span class="str">"-"</span><span class="op">,</span> <span class="nam">word</span><span class="op">.</span><span class="nam">style</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1019" href="#t1019">1019</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t1020" href="#t1020">1020</a></span><span class="t"> <span class="key">if</span> <span class="nam">test_text</span><span class="op">.</span><span class="nam">width</span> <span class="op">></span> <span class="num">0</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1020 ↛ 1073</span><span class="annotate long">line 1020 didn't jump to line 1073 because the condition on line 1020 was always true</span></span></p>
|
|
<p class="pln"><span class="n"><a id="t1021" href="#t1021">1021</a></span><span class="t"> <span class="com"># Calculate what fraction of the hyphenated word fits</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1022" href="#t1022">1022</a></span><span class="t"> <span class="nam">fraction</span> <span class="op">=</span> <span class="nam">remaining</span> <span class="op">/</span> <span class="nam">test_text</span><span class="op">.</span><span class="nam">width</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1023" href="#t1023">1023</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1024" href="#t1024">1024</a></span><span class="t"> <span class="com"># Convert fraction to character position</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1025" href="#t1025">1025</a></span><span class="t"> <span class="com"># We need at least min_chars_before_hyphen and leave at least</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1026" href="#t1026">1026</a></span><span class="t"> <span class="com"># min_chars_after_hyphen</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1027" href="#t1027">1027</a></span><span class="t"> <span class="nam">max_split_pos</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">)</span> <span class="op">-</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_after_hyphen</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1028" href="#t1028">1028</a></span><span class="t"> <span class="nam">min_split_pos</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_before_hyphen</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1029" href="#t1029">1029</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1030" href="#t1030">1030</a></span><span class="t"> <span class="com"># Calculate ideal split position based on available space</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1031" href="#t1031">1031</a></span><span class="t"> <span class="nam">ideal_split</span> <span class="op">=</span> <span class="nam">int</span><span class="op">(</span><span class="nam">fraction</span> <span class="op">*</span> <span class="nam">len</span><span class="op">(</span><span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1032" href="#t1032">1032</a></span><span class="t"> <span class="nam">split_pos</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">min_split_pos</span><span class="op">,</span> <span class="nam">min</span><span class="op">(</span><span class="nam">ideal_split</span><span class="op">,</span> <span class="nam">max_split_pos</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1033" href="#t1033">1033</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1034" href="#t1034">1034</a></span><span class="t"> <span class="com"># Ensure we meet minimum requirements</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t1035" href="#t1035">1035</a></span><span class="t"> <span class="key">if</span> <span class="op">(</span><span class="nam">split_pos</span> <span class="op">>=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_before_hyphen</span> <span class="key">and</span> </span><span class="r"><span class="annotate short">1035 ↛ 1073</span><span class="annotate long">line 1035 didn't jump to line 1073 because the condition on line 1035 was always true</span></span></p>
|
|
<p class="par par2 ru2 show_par"><span class="n"><a id="t1036" href="#t1036">1036</a></span><span class="t"> <span class="nam">len</span><span class="op">(</span><span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">)</span> <span class="op">-</span> <span class="nam">split_pos</span> <span class="op">>=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_chars_after_hyphen</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1037" href="#t1037">1037</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1038" href="#t1038">1038</a></span><span class="t"> <span class="com"># Create the split</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1039" href="#t1039">1039</a></span><span class="t"> <span class="nam">first_part_text</span> <span class="op">=</span> <span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">[</span><span class="op">:</span><span class="nam">split_pos</span><span class="op">]</span> <span class="op">+</span> <span class="str">"-"</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1040" href="#t1040">1040</a></span><span class="t"> <span class="nam">second_part_text</span> <span class="op">=</span> <span class="nam">word</span><span class="op">.</span><span class="nam">text</span><span class="op">[</span><span class="nam">split_pos</span><span class="op">:</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1041" href="#t1041">1041</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1042" href="#t1042">1042</a></span><span class="t"> <span class="nam">first_text</span> <span class="op">=</span> <span class="nam">Text</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1043" href="#t1043">1043</a></span><span class="t"> <span class="nam">first_part_text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1044" href="#t1044">1044</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">style</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1045" href="#t1045">1045</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1046" href="#t1046">1046</a></span><span class="t"> <span class="nam">line</span><span class="op">=</span><span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1047" href="#t1047">1047</a></span><span class="t"> <span class="nam">source</span><span class="op">=</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1048" href="#t1048">1048</a></span><span class="t"> <span class="nam">second_text</span> <span class="op">=</span> <span class="nam">Text</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1049" href="#t1049">1049</a></span><span class="t"> <span class="nam">second_part_text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1050" href="#t1050">1050</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">style</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1051" href="#t1051">1051</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1052" href="#t1052">1052</a></span><span class="t"> <span class="nam">line</span><span class="op">=</span><span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1053" href="#t1053">1053</a></span><span class="t"> <span class="nam">source</span><span class="op">=</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1054" href="#t1054">1054</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1055" href="#t1055">1055</a></span><span class="t"> <span class="com"># Verify the first part actually fits</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1056" href="#t1056">1056</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_push_text</span><span class="op">(</span><span class="nam">first_text</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1057" href="#t1057">1057</a></span><span class="t"> <span class="nam">spacing</span><span class="op">,</span> <span class="nam">position</span><span class="op">,</span> <span class="nam">overflow</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_measure</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1058" href="#t1058">1058</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1059" href="#t1059">1059</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">overflow</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1060" href="#t1060">1060</a></span><span class="t"> <span class="com"># Brute force split works!</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1061" href="#t1061">1061</a></span><span class="t"> <span class="nam">first_text</span><span class="op">.</span><span class="nam">line</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1062" href="#t1062">1062</a></span><span class="t"> <span class="nam">second_text</span><span class="op">.</span><span class="nam">line</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1063" href="#t1063">1063</a></span><span class="t"> <span class="nam">word</span><span class="op">.</span><span class="nam">add_concete</span><span class="op">(</span><span class="op">(</span><span class="nam">first_text</span><span class="op">,</span> <span class="nam">second_text</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1064" href="#t1064">1064</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing_render</span> <span class="op">=</span> <span class="nam">spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1065" href="#t1065">1065</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_position_render</span> <span class="op">=</span> <span class="nam">position</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1066" href="#t1066">1066</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_words</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">word</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1067" href="#t1067">1067</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span><span class="op">,</span> <span class="nam">second_text</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1068" href="#t1068">1068</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1069" href="#t1069">1069</a></span><span class="t"> <span class="com"># Doesn't fit, remove it</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1070" href="#t1070">1070</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_pop_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1071" href="#t1071">1071</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1072" href="#t1072">1072</a></span><span class="t"> <span class="com"># Step 4: Word cannot be hyphenated or split, move to next line</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1073" href="#t1073">1073</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span><span class="op">,</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1074" href="#t1074">1074</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1075" href="#t1075">1075</a></span><span class="t"> <span class="key">def</span> <span class="nam">render</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t1076" href="#t1076">1076</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1077" href="#t1077">1077</a></span><span class="t"><span class="str"> Render the line with all its text objects using the alignment handler system.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1078" href="#t1078">1078</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1079" href="#t1079">1079</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1080" href="#t1080">1080</a></span><span class="t"><span class="str"> A PIL Image containing the rendered line</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1081" href="#t1081">1081</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1082" href="#t1082">1082</a></span><span class="t"> <span class="com"># Recalculate spacing and position for current text objects to ensure</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1083" href="#t1083">1083</a></span><span class="t"> <span class="com"># accuracy. Word fitting used the paragraph's alignment; rendering uses</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1084" href="#t1084">1084</a></span><span class="t"> <span class="com"># render_alignment_handler, which differs only for the last line of a</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1085" href="#t1085">1085</a></span><span class="t"> <span class="com"># justified paragraph.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1086" href="#t1086">1086</a></span><span class="t"> <span class="nam">handler</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">render_alignment_handler</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1087" href="#t1087">1087</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span><span class="op">)</span> <span class="op">></span> <span class="num">0</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1088" href="#t1088">1088</a></span><span class="t"> <span class="nam">spacing</span><span class="op">,</span> <span class="nam">position</span><span class="op">,</span> <span class="nam">overflow</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_measure</span><span class="op">(</span><span class="nam">handler</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1089" href="#t1089">1089</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing_render</span> <span class="op">=</span> <span class="nam">spacing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1090" href="#t1090">1090</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_position_render</span> <span class="op">=</span> <span class="nam">position</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1091" href="#t1091">1091</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1092" href="#t1092">1092</a></span><span class="t"> <span class="nam">y_cursor</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">+</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_baseline</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1093" href="#t1093">1093</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1094" href="#t1094">1094</a></span><span class="t"> <span class="com"># Start x_cursor at line origin plus any alignment offset</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1095" href="#t1095">1095</a></span><span class="t"> <span class="nam">x_cursor</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="op">+</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_position_render</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1096" href="#t1096">1096</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1097" href="#t1097">1097</a></span><span class="t"> <span class="com"># Everything the loop needs that does not vary per word is resolved once.</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1098" href="#t1098">1098</a></span><span class="t"> <span class="com"># Only justified lines carry per-gap spacings; every other alignment uses</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1099" href="#t1099">1099</a></span><span class="t"> <span class="com"># the single spacing figured above.</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1100" href="#t1100">1100</a></span><span class="t"> <span class="nam">texts</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1101" href="#t1101">1101</a></span><span class="t"> <span class="nam">last</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">texts</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1102" href="#t1102">1102</a></span><span class="t"> <span class="nam">draw</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_draw</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1103" href="#t1103">1103</a></span><span class="t"> <span class="nam">default_spacing</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_spacing_render</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1104" href="#t1104">1104</a></span><span class="t"> <span class="nam">gaps</span> <span class="op">=</span> <span class="nam">handler</span><span class="op">.</span><span class="nam">_gap_spacings</span> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">handler</span><span class="op">,</span> <span class="nam">JustifyAlignmentHandler</span><span class="op">)</span> <span class="key">else</span> <span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1105" href="#t1105">1105</a></span><span class="t"> <span class="nam">gap_count</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">gaps</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1106" href="#t1106">1106</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1107" href="#t1107">1107</a></span><span class="t"> <span class="key">for</span> <span class="nam">i</span><span class="op">,</span> <span class="nam">text</span> <span class="key">in</span> <span class="nam">enumerate</span><span class="op">(</span><span class="nam">texts</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1108" href="#t1108">1108</a></span><span class="t"> <span class="com"># Update text draw context to current draw context</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1109" href="#t1109">1109</a></span><span class="t"> <span class="nam">text</span><span class="op">.</span><span class="nam">_draw</span> <span class="op">=</span> <span class="nam">draw</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1110" href="#t1110">1110</a></span><span class="t"> <span class="nam">text</span><span class="op">.</span><span class="nam">set_origin</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">array</span><span class="op">(</span><span class="op">[</span><span class="nam">x_cursor</span><span class="op">,</span> <span class="nam">y_cursor</span><span class="op">]</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1111" href="#t1111">1111</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1112" href="#t1112">1112</a></span><span class="t"> <span class="com"># Determine next text object for continuous decoration</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1113" href="#t1113">1113</a></span><span class="t"> <span class="nam">next_text</span> <span class="op">=</span> <span class="nam">texts</span><span class="op">[</span><span class="nam">i</span> <span class="op">+</span> <span class="num">1</span><span class="op">]</span> <span class="key">if</span> <span class="nam">i</span> <span class="op"><</span> <span class="nam">last</span> <span class="key">else</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1114" href="#t1114">1114</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1115" href="#t1115">1115</a></span><span class="t"> <span class="com"># Get the spacing for this specific gap (variable for justified text)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1116" href="#t1116">1116</a></span><span class="t"> <span class="nam">current_spacing</span> <span class="op">=</span> <span class="nam">gaps</span><span class="op">[</span><span class="nam">i</span><span class="op">]</span> <span class="key">if</span> <span class="nam">i</span> <span class="op"><</span> <span class="nam">gap_count</span> <span class="key">else</span> <span class="nam">default_spacing</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1117" href="#t1117">1117</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1118" href="#t1118">1118</a></span><span class="t"> <span class="com"># Render with next text information for continuous underline/strikethrough</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1119" href="#t1119">1119</a></span><span class="t"> <span class="nam">text</span><span class="op">.</span><span class="nam">render</span><span class="op">(</span><span class="nam">next_text</span><span class="op">,</span> <span class="nam">current_spacing</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1120" href="#t1120">1120</a></span><span class="t"> <span class="com"># Add text width, then spacing only if there are more words</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1121" href="#t1121">1121</a></span><span class="t"> <span class="nam">x_cursor</span> <span class="op">+=</span> <span class="nam">text</span><span class="op">.</span><span class="nam">width</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1122" href="#t1122">1122</a></span><span class="t"> <span class="key">if</span> <span class="nam">i</span> <span class="op"><</span> <span class="nam">last</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1123" href="#t1123">1123</a></span><span class="t"> <span class="nam">x_cursor</span> <span class="op">+=</span> <span class="nam">current_spacing</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1124" href="#t1124">1124</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1125" href="#t1125">1125</a></span><span class="t"> <span class="key">def</span> <span class="nam">query_point</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">point</span><span class="op">:</span> <span class="nam">Tuple</span><span class="op">[</span><span class="nam">int</span><span class="op">,</span> <span class="nam">int</span><span class="op">]</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Optional</span><span class="op">[</span><span class="str">'QueryResult'</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="exc show_exc"><span class="n"><a id="t1126" href="#t1126">1126</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1127" href="#t1127">1127</a></span><span class="t"><span class="str"> Find which Text object contains the given point.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1128" href="#t1128">1128</a></span><span class="t"><span class="str"> Uses Queriable.in_object() mixin for hit-testing.</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1129" href="#t1129">1129</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1130" href="#t1130">1130</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1131" href="#t1131">1131</a></span><span class="t"><span class="str"> point: (x, y) coordinates to query</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1132" href="#t1132">1132</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1133" href="#t1133">1133</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1134" href="#t1134">1134</a></span><span class="t"><span class="str"> QueryResult from the text object at that point, or None</span> </span><span class="r"></span></p>
|
|
<p class="exc exc2 show_exc"><span class="n"><a id="t1135" href="#t1135">1135</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1136" href="#t1136">1136</a></span><span class="t"> <span class="nam">point_array</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">array</span><span class="op">(</span><span class="nam">point</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1137" href="#t1137">1137</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1138" href="#t1138">1138</a></span><span class="t"> <span class="com"># Check each text object in this line</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1139" href="#t1139">1139</a></span><span class="t"> <span class="key">for</span> <span class="nam">text_obj</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_objects</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1140" href="#t1140">1140</a></span><span class="t"> <span class="com"># Use Queriable mixin's in_object() for hit-testing</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1141" href="#t1141">1141</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">text_obj</span><span class="op">,</span> <span class="nam">Queriable</span><span class="op">)</span> <span class="key">and</span> <span class="nam">text_obj</span><span class="op">.</span><span class="nam">in_object</span><span class="op">(</span><span class="nam">point_array</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1142" href="#t1142">1142</a></span><span class="t"> <span class="com"># Extract metadata based on text type</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1143" href="#t1143">1143</a></span><span class="t"> <span class="nam">origin</span> <span class="op">=</span> <span class="nam">text_obj</span><span class="op">.</span><span class="nam">_origin</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1144" href="#t1144">1144</a></span><span class="t"> <span class="nam">size</span> <span class="op">=</span> <span class="nam">text_obj</span><span class="op">.</span><span class="nam">size</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1145" href="#t1145">1145</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1146" href="#t1146">1146</a></span><span class="t"> <span class="com"># Text origin is at baseline (anchor="ls"), so visual top is origin[1] - ascent</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1147" href="#t1147">1147</a></span><span class="t"> <span class="com"># Bounds should be (x, visual_top, width, height) for proper</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1148" href="#t1148">1148</a></span><span class="t"> <span class="com"># highlighting</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1149" href="#t1149">1149</a></span><span class="t"> <span class="nam">visual_top</span> <span class="op">=</span> <span class="nam">int</span><span class="op">(</span><span class="nam">origin</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">-</span> <span class="nam">text_obj</span><span class="op">.</span><span class="nam">_ascent</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1150" href="#t1150">1150</a></span><span class="t"> <span class="nam">bounds</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1151" href="#t1151">1151</a></span><span class="t"> <span class="nam">int</span><span class="op">(</span><span class="nam">origin</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1152" href="#t1152">1152</a></span><span class="t"> <span class="nam">visual_top</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1153" href="#t1153">1153</a></span><span class="t"> <span class="nam">int</span><span class="op">(</span><span class="nam">size</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">)</span> <span class="key">if</span> <span class="nam">hasattr</span><span class="op">(</span><span class="nam">size</span><span class="op">,</span> <span class="str">'__getitem__'</span><span class="op">)</span> <span class="key">else</span> <span class="num">0</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1154" href="#t1154">1154</a></span><span class="t"> <span class="nam">int</span><span class="op">(</span><span class="nam">size</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">)</span> <span class="key">if</span> <span class="nam">hasattr</span><span class="op">(</span><span class="nam">size</span><span class="op">,</span> <span class="str">'__getitem__'</span><span class="op">)</span> <span class="key">else</span> <span class="num">0</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1155" href="#t1155">1155</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1156" href="#t1156">1156</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1157" href="#t1157">1157</a></span><span class="t"> <span class="com"># Import here to avoid circular dependency</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1158" href="#t1158">1158</a></span><span class="t"> <span class="key">from</span> <span class="op">.</span><span class="nam">functional</span> <span class="key">import</span> <span class="nam">LinkText</span><span class="op">,</span> <span class="nam">ButtonText</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1159" href="#t1159">1159</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1160" href="#t1160">1160</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">text_obj</span><span class="op">,</span> <span class="nam">LinkText</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1161" href="#t1161">1161</a></span><span class="t"> <span class="nam">result</span> <span class="op">=</span> <span class="nam">QueryResult</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1162" href="#t1162">1162</a></span><span class="t"> <span class="nam">object</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1163" href="#t1163">1163</a></span><span class="t"> <span class="nam">object_type</span><span class="op">=</span><span class="str">"link"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1164" href="#t1164">1164</a></span><span class="t"> <span class="nam">bounds</span><span class="op">=</span><span class="nam">bounds</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1165" href="#t1165">1165</a></span><span class="t"> <span class="nam">text</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">.</span><span class="nam">_text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1166" href="#t1166">1166</a></span><span class="t"> <span class="nam">is_interactive</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1167" href="#t1167">1167</a></span><span class="t"> <span class="nam">link_target</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">.</span><span class="nam">_link</span><span class="op">.</span><span class="nam">location</span> <span class="key">if</span> <span class="nam">hasattr</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1168" href="#t1168">1168</a></span><span class="t"> <span class="nam">text_obj</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1169" href="#t1169">1169</a></span><span class="t"> <span class="str">'_link'</span><span class="op">)</span> <span class="key">else</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t1170" href="#t1170">1170</a></span><span class="t"> <span class="key">elif</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">text_obj</span><span class="op">,</span> <span class="nam">ButtonText</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1170 ↛ 1171</span><span class="annotate long">line 1170 didn't jump to line 1171 because the condition on line 1170 was never true</span></span></p>
|
|
<p class="mis show_mis"><span class="n"><a id="t1171" href="#t1171">1171</a></span><span class="t"> <span class="nam">result</span> <span class="op">=</span> <span class="nam">QueryResult</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1172" href="#t1172">1172</a></span><span class="t"> <span class="nam">object</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1173" href="#t1173">1173</a></span><span class="t"> <span class="nam">object_type</span><span class="op">=</span><span class="str">"button"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1174" href="#t1174">1174</a></span><span class="t"> <span class="nam">bounds</span><span class="op">=</span><span class="nam">bounds</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1175" href="#t1175">1175</a></span><span class="t"> <span class="nam">text</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">.</span><span class="nam">_text</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1176" href="#t1176">1176</a></span><span class="t"> <span class="nam">is_interactive</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1177" href="#t1177">1177</a></span><span class="t"> <span class="nam">callback</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">.</span><span class="nam">_callback</span> <span class="key">if</span> <span class="nam">hasattr</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1178" href="#t1178">1178</a></span><span class="t"> <span class="nam">text_obj</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="mis mis2 show_mis"><span class="n"><a id="t1179" href="#t1179">1179</a></span><span class="t"> <span class="str">'_callback'</span><span class="op">)</span> <span class="key">else</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1180" href="#t1180">1180</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1181" href="#t1181">1181</a></span><span class="t"> <span class="nam">result</span> <span class="op">=</span> <span class="nam">QueryResult</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1182" href="#t1182">1182</a></span><span class="t"> <span class="nam">object</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1183" href="#t1183">1183</a></span><span class="t"> <span class="nam">object_type</span><span class="op">=</span><span class="str">"text"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1184" href="#t1184">1184</a></span><span class="t"> <span class="nam">bounds</span><span class="op">=</span><span class="nam">bounds</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1185" href="#t1185">1185</a></span><span class="t"> <span class="nam">text</span><span class="op">=</span><span class="nam">text_obj</span><span class="op">.</span><span class="nam">_text</span> <span class="key">if</span> <span class="nam">hasattr</span><span class="op">(</span><span class="nam">text_obj</span><span class="op">,</span> <span class="str">'_text'</span><span class="op">)</span> <span class="key">else</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t1186" href="#t1186">1186</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1187" href="#t1187">1187</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1188" href="#t1188">1188</a></span><span class="t"> <span class="nam">result</span><span class="op">.</span><span class="nam">parent_line</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1189" href="#t1189">1189</a></span><span class="t"> <span class="key">return</span> <span class="nam">result</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t1190" href="#t1190">1190</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t1191" href="#t1191">1191</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
</main>
|
|
<footer>
|
|
<div class="content">
|
|
<p>
|
|
<a class="nav" href="z_7d48e1f4c6486fa2_table_py.html">« prev</a>
|
|
<a class="nav" href="index.html">^ index</a>
|
|
<a class="nav" href="z_40407af872b0cf37___init___py.html">» next</a>
|
|
|
|
<a class="nav" href="https://coverage.readthedocs.io/en/7.15.4">coverage.py v7.15.4</a>,
|
|
created at 2026-08-08 20:34 +0000
|
|
</p>
|
|
</div>
|
|
</footer>
|
|
</body>
|
|
</html>
|