mirror
/
pyTermTk
mirror of https://github.com/ceccopierangiolieugenio/pyTermTk.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
48 Commits
8 Branches
107 Tags
36 MiB
 
 
 
 
 
Tree: a652dee9cf
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'a652dee9cf'
${ noResults }
pyTermTk/_modules/TermTk/TTkCore/ttk.html

393 lines
50 KiB
Raw Blame History

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>TermTk.TTkCore.ttk &mdash; pyTermTk 0.2.0a documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/theme_overrides.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/ttk.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
<script src="../../../_static/jquery.js"></script>
<script src="../../../_static/underscore.js"></script>
<script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
<script src="../../../_static/doctools.js"></script>
<script src="../../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../../genindex.html" />
<link rel="search" title="Search" href="../../../search.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../../../index.html" class="icon icon-home"> pyTermTk
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">Tutorials</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/001-helloworld.html">pyTermTk - Hello World</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/002-layout.html">pyTermTk - Layouts</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/003-signalslots.html">pyTermTk - Signal &amp; Slots</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/004-logging.html">pyTermTk - Logging</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/005-calculator.html">pyTermTk - Your first Calculator</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">API Reference</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkAbstract.html">TermTk.TTkAbstract</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkCore.html">TermTk.TTkCore</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkCore.TTkTerm.html">TermTk.TTkCore.TTkTerm</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkGui.html">TermTk.TTkGui</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkLayouts.html">TermTk.TTkLayouts</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTemplates.html">TermTk.TTkTemplates</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTestWidgets.html">TermTk.TTkTestWidgets</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTheme.html">TermTk.TTkTheme</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTypes.html">TermTk.TTkTypes</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkWidgets.html">TermTk.TTkWidgets</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkWidgets.TTkModelView.html">TermTk.TTkWidgets.TTkModelView</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkWidgets.TTkPickers.html">TermTk.TTkWidgets.TTkPickers</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../../index.html">pyTermTk</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../../index.html" class="icon icon-home"></a> &raquo;</li>
<li><a href="../../index.html">Module code</a> &raquo;</li>
<li>TermTk.TTkCore.ttk</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<h1>Source code for TermTk.TTkCore.ttk</h1><div class="highlight"><pre>
<span></span><span class="ch">#!/usr/bin/env python3</span>
<span class="c1"># MIT License</span>
<span class="c1">#</span>
<span class="c1"># Copyright (c) 2021 Eugenio Parodi &lt;ceccopierangiolieugenio AT googlemail DOT com&gt;</span>
<span class="c1">#</span>
<span class="c1"># Permission is hereby granted, free of charge, to any person obtaining a copy</span>
<span class="c1"># of this software and associated documentation files (the &quot;Software&quot;), to deal</span>
<span class="c1"># in the Software without restriction, including without limitation the rights</span>
<span class="c1"># to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
<span class="c1"># copies of the Software, and to permit persons to whom the Software is</span>
<span class="c1"># furnished to do so, subject to the following conditions:</span>
<span class="c1">#</span>
<span class="c1"># The above copyright notice and this permission notice shall be included in all</span>
<span class="c1"># copies or substantial portions of the Software.</span>
<span class="c1">#</span>
<span class="c1"># THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
<span class="c1"># IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
<span class="c1"># FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
<span class="c1"># AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
<span class="c1"># LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
<span class="c1"># OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE</span>
<span class="c1"># SOFTWARE.</span>
<span class="kn">import</span> <span class="nn">os</span>
<span class="kn">import</span> <span class="nn">signal</span>
<span class="kn">import</span> <span class="nn">time</span>
<span class="kn">import</span> <span class="nn">queue</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.TTkTerm.input</span> <span class="kn">import</span> <span class="n">TTkInput</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.TTkTerm.inputkey</span> <span class="kn">import</span> <span class="n">TTkKeyEvent</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.TTkTerm.inputmouse</span> <span class="kn">import</span> <span class="n">TTkMouseEvent</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.TTkTerm.term</span> <span class="kn">import</span> <span class="n">TTkTerm</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.signal</span> <span class="kn">import</span> <span class="n">pyTTkSignal</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.constant</span> <span class="kn">import</span> <span class="n">TTkK</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.log</span> <span class="kn">import</span> <span class="n">TTkLog</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.cfg</span> <span class="kn">import</span> <span class="o">*</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.timer</span> <span class="kn">import</span> <span class="o">*</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkTheme.theme</span> <span class="kn">import</span> <span class="n">TTkTheme</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkWidgets.widget</span> <span class="kn">import</span> <span class="o">*</span>
<div class="viewcode-block" id="TTk"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkCore.ttk.html#TermTk.TTkCore.ttk.TTk">[docs]</a><span class="k">class</span> <span class="nc">TTk</span><span class="p">(</span><span class="n">TTkWidget</span><span class="p">):</span>
<span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
<span class="s1">&#39;_name&#39;</span><span class="p">,</span> <span class="s1">&#39;_running&#39;</span><span class="p">,</span> <span class="s1">&#39;_input&#39;</span><span class="p">,</span>
<span class="s1">&#39;_events&#39;</span><span class="p">,</span> <span class="s1">&#39;_key_events&#39;</span><span class="p">,</span> <span class="s1">&#39;_mouse_events&#39;</span><span class="p">,</span> <span class="s1">&#39;_screen_events&#39;</span><span class="p">,</span>
<span class="s1">&#39;_title&#39;</span><span class="p">,</span>
<span class="s1">&#39;_sigmask&#39;</span><span class="p">,</span>
<span class="s1">&#39;_lastMultiTap&#39;</span><span class="p">,</span>
<span class="c1">#Signals</span>
<span class="s1">&#39;eventKeyPress&#39;</span><span class="p">,</span> <span class="s1">&#39;eventMouse&#39;</span> <span class="p">)</span>
<span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
<span class="n">TTkWidget</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_name</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;name&#39;</span> <span class="p">,</span> <span class="s1">&#39;TTk&#39;</span> <span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">eventKeyPress</span> <span class="o">=</span> <span class="n">pyTTkSignal</span><span class="p">(</span><span class="n">TTkKeyEvent</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">eventMouse</span> <span class="o">=</span> <span class="n">pyTTkSignal</span><span class="p">(</span><span class="n">TTkMouseEvent</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_running</span> <span class="o">=</span> <span class="kc">False</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_input</span> <span class="o">=</span> <span class="kc">None</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_events</span> <span class="o">=</span> <span class="n">queue</span><span class="o">.</span><span class="n">Queue</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_key_events</span> <span class="o">=</span> <span class="n">queue</span><span class="o">.</span><span class="n">Queue</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_mouse_events</span> <span class="o">=</span> <span class="n">queue</span><span class="o">.</span><span class="n">Queue</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_screen_events</span> <span class="o">=</span> <span class="n">queue</span><span class="o">.</span><span class="n">Queue</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_title</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;title&#39;</span><span class="p">,</span><span class="s1">&#39;TermTk&#39;</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_sigmask</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;sigmask&#39;</span><span class="p">,</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">NONE</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">setFocusPolicy</span><span class="p">(</span><span class="n">TTkK</span><span class="o">.</span><span class="n">ClickFocus</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">hide</span><span class="p">()</span>
<span class="k">try</span><span class="p">:</span>
<span class="n">size</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">get_terminal_size</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">setGeometry</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="n">size</span><span class="o">.</span><span class="n">columns</span><span class="p">,</span><span class="n">size</span><span class="o">.</span><span class="n">lines</span><span class="p">)</span>
<span class="k">except</span> <span class="ne">OSError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;ERROR: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
<span class="n">TTkCfg</span><span class="o">.</span><span class="n">theme</span> <span class="o">=</span> <span class="n">TTkTheme</span><span class="p">()</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">registerRootWidget</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
<span class="n">frame</span> <span class="o">=</span> <span class="mi">0</span>
<span class="n">time</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">_fps</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="n">curtime</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">frame</span><span class="o">+=</span><span class="mi">1</span>
<span class="n">delta</span> <span class="o">=</span> <span class="n">curtime</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">time</span>
<span class="k">if</span> <span class="n">delta</span> <span class="o">&gt;</span> <span class="mi">5</span><span class="p">:</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;fps: </span><span class="si">{</span><span class="nb">int</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">frame</span><span class="o">/</span><span class="n">delta</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">frame</span> <span class="o">=</span> <span class="mi">0</span>
<span class="bp">self</span><span class="o">.</span><span class="n">time</span> <span class="o">=</span> <span class="n">curtime</span>
<span class="k">def</span> <span class="nf">mainloop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">try</span><span class="p">:</span>
<span class="sd">&#39;&#39;&#39;Enters the main event loop and waits until :meth:`~quit` is called or the main widget is destroyed.&#39;&#39;&#39;</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot;&quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot; ████████╗ ████████╗ &quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot; ╚══██╔══╝ ╚══██╔══╝ &quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot; ██║ ▄▄ ▄ ▄▄ ▄▄▖▄▖ ██║ █ ▗▖ &quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot; ▞▀▚ ▖▗ ██║ █▄▄█ █▀▘ █ █ █ ██║ █▟▘ &quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot; ▙▄▞▐▄▟ ██║ ▀▄▄▖ █ █ ▝ █ ██║ █ ▀▄ &quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot; ▌ ▐ ╚═╝ ╚═╝ &quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot; ▚▄▄▘ &quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot;&quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot; Version: </span><span class="si">{</span><span class="n">TTkCfg</span><span class="o">.</span><span class="n">version</span><span class="si">}</span><span class="s2">&quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot;&quot;</span> <span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> <span class="s2">&quot;Starting Main Loop...&quot;</span> <span class="p">)</span>
<span class="c1"># Register events</span>
<span class="n">signal</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="n">signal</span><span class="o">.</span><span class="n">SIGTSTP</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_SIGSTOP</span><span class="p">)</span> <span class="c1"># Ctrl-Z</span>
<span class="n">signal</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="n">signal</span><span class="o">.</span><span class="n">SIGCONT</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_SIGCONT</span><span class="p">)</span> <span class="c1"># Resume</span>
<span class="n">signal</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="n">signal</span><span class="o">.</span><span class="n">SIGINT</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_SIGINT</span><span class="p">)</span> <span class="c1"># Ctrl-C</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Signal Event Registered&quot;</span><span class="p">)</span>
<span class="n">TTkTerm</span><span class="o">.</span><span class="n">registerResizeCb</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_win_resize_cb</span><span class="p">)</span>
<span class="n">threading</span><span class="o">.</span><span class="n">Thread</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_input_thread</span><span class="p">,</span> <span class="n">daemon</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_timer</span> <span class="o">=</span> <span class="n">TTkTimer</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_timer</span><span class="o">.</span><span class="n">timeout</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_time_event</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_timer</span><span class="o">.</span><span class="n">start</span><span class="p">(</span><span class="mf">0.1</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_running</span> <span class="o">=</span> <span class="kc">True</span>
<span class="c1"># Keep track of the multiTap to avoid the extra key release</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_lastMultiTap</span> <span class="o">=</span> <span class="kc">False</span>
<span class="n">TTkTerm</span><span class="o">.</span><span class="n">init</span><span class="p">(</span><span class="n">title</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_title</span><span class="p">,</span> <span class="n">sigmask</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_sigmask</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_mainloop</span><span class="p">()</span>
<span class="c1">#except Exception as e:</span>
<span class="c1"># TTkLog.error(f&quot;{e}&quot;)</span>
<span class="k">finally</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">quit</span><span class="p">()</span>
<span class="n">TTkTerm</span><span class="o">.</span><span class="n">exit</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">_mainloop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">while</span> <span class="bp">self</span><span class="o">.</span><span class="n">_running</span><span class="p">:</span>
<span class="c1"># Main Loop</span>
<span class="n">evt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_events</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
<span class="k">if</span> <span class="n">evt</span> <span class="ow">is</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">MOUSE_EVENT</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_mouse_event</span><span class="p">()</span>
<span class="k">elif</span> <span class="n">evt</span> <span class="ow">is</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">KEY_EVENT</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_key_event</span><span class="p">()</span>
<span class="k">elif</span> <span class="n">evt</span> <span class="ow">is</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">TIME_EVENT</span><span class="p">:</span>
<span class="n">size</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">get_terminal_size</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">setGeometry</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="n">size</span><span class="o">.</span><span class="n">columns</span><span class="p">,</span><span class="n">size</span><span class="o">.</span><span class="n">lines</span><span class="p">)</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">paintAll</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_timer</span><span class="o">.</span><span class="n">start</span><span class="p">(</span><span class="mi">1</span><span class="o">/</span><span class="n">TTkCfg</span><span class="o">.</span><span class="n">maxFps</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_fps</span><span class="p">()</span>
<span class="k">pass</span>
<span class="k">elif</span> <span class="n">evt</span> <span class="ow">is</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">SCREEN_EVENT</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">setGeometry</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="n">TTkGlbl</span><span class="o">.</span><span class="n">term_w</span><span class="p">,</span><span class="n">TTkGlbl</span><span class="o">.</span><span class="n">term_h</span><span class="p">)</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Resize: w:</span><span class="si">{</span><span class="n">TTkGlbl</span><span class="o">.</span><span class="n">term_w</span><span class="si">}</span><span class="s2">, h:</span><span class="si">{</span><span class="n">TTkGlbl</span><span class="o">.</span><span class="n">term_h</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
<span class="k">elif</span> <span class="n">evt</span> <span class="ow">is</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">QUIT_EVENT</span><span class="p">:</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Quit.&quot;</span><span class="p">)</span>
<span class="k">break</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Unhandled Event </span><span class="si">{</span><span class="n">evt</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
<span class="k">break</span>
<span class="k">def</span> <span class="nf">_mouse_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="n">mevt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_mouse_events</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">eventMouse</span><span class="o">.</span><span class="n">emit</span><span class="p">(</span><span class="n">mevt</span><span class="p">)</span>
<span class="c1"># Upload the global mouse position</span>
<span class="c1"># Mainly used by the drag pixmap display</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">setMousePos</span><span class="p">((</span><span class="n">mevt</span><span class="o">.</span><span class="n">x</span><span class="p">,</span><span class="n">mevt</span><span class="o">.</span><span class="n">y</span><span class="p">))</span>
<span class="c1"># Avoid to broadcast a key release after a multitap event</span>
<span class="k">if</span> <span class="n">mevt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Release</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lastMultiTap</span><span class="p">:</span> <span class="k">return</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_lastMultiTap</span> <span class="o">=</span> <span class="n">mevt</span><span class="o">.</span><span class="n">tap</span> <span class="o">&gt;</span> <span class="mi">1</span>
<span class="k">if</span> <span class="p">(</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">isDnD</span><span class="p">()</span> <span class="ow">and</span>
<span class="n">mevt</span><span class="o">.</span><span class="n">evt</span> <span class="o">!=</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Drag</span> <span class="ow">and</span>
<span class="n">mevt</span><span class="o">.</span><span class="n">evt</span> <span class="o">!=</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Release</span> <span class="p">):</span>
<span class="c1"># Clean Drag Drop status for any event that is not</span>
<span class="c1"># Mouse Drag, Key Release</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndEnd</span><span class="p">()</span>
<span class="c1"># Mouse Events forwarded straight to the Focus widget:</span>
<span class="c1"># - Drag</span>
<span class="c1"># - Move</span>
<span class="c1"># - Release</span>
<span class="n">focusWidget</span> <span class="o">=</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">getFocus</span><span class="p">()</span>
<span class="k">if</span> <span class="p">(</span> <span class="n">focusWidget</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span>
<span class="n">mevt</span><span class="o">.</span><span class="n">evt</span> <span class="o">!=</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Press</span> <span class="ow">and</span>
<span class="n">mevt</span><span class="o">.</span><span class="n">key</span> <span class="o">!=</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Wheel</span> <span class="ow">and</span>
<span class="ow">not</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">isDnD</span><span class="p">()</span> <span class="p">)</span> <span class="p">:</span>
<span class="n">x</span><span class="p">,</span><span class="n">y</span> <span class="o">=</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">absPos</span><span class="p">(</span><span class="n">focusWidget</span><span class="p">)</span>
<span class="n">nmevt</span> <span class="o">=</span> <span class="n">mevt</span><span class="o">.</span><span class="n">clone</span><span class="p">(</span><span class="n">pos</span><span class="o">=</span><span class="p">(</span><span class="n">mevt</span><span class="o">.</span><span class="n">x</span><span class="o">-</span><span class="n">x</span><span class="p">,</span> <span class="n">mevt</span><span class="o">.</span><span class="n">y</span><span class="o">-</span><span class="n">y</span><span class="p">))</span>
<span class="n">focusWidget</span><span class="o">.</span><span class="n">mouseEvent</span><span class="p">(</span><span class="n">nmevt</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="c1"># Sometimes the release event is not retrieved</span>
<span class="k">if</span> <span class="p">(</span> <span class="n">focusWidget</span> <span class="ow">and</span>
<span class="n">focusWidget</span><span class="o">.</span><span class="n">_pendingMouseRelease</span> <span class="ow">and</span>
<span class="ow">not</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">isDnD</span><span class="p">()</span> <span class="p">):</span>
<span class="n">focusWidget</span><span class="o">.</span><span class="n">mouseEvent</span><span class="p">(</span><span class="n">mevt</span><span class="o">.</span><span class="n">clone</span><span class="p">(</span><span class="n">evt</span><span class="o">=</span><span class="n">TTkK</span><span class="o">.</span><span class="n">Release</span><span class="p">))</span>
<span class="n">focusWidget</span><span class="o">.</span><span class="n">_pendingMouseRelease</span> <span class="o">=</span> <span class="kc">False</span>
<span class="c1"># Adding this Crappy logic to handle a corner case in the drop routine</span>
<span class="c1"># where the mouse is leaving any widget able to handle the drop event</span>
<span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">mouseEvent</span><span class="p">(</span><span class="n">mevt</span><span class="p">):</span>
<span class="k">if</span> <span class="n">dndw</span> <span class="o">:=</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndWidget</span><span class="p">():</span>
<span class="n">dndw</span><span class="o">.</span><span class="n">dragLeaveEvent</span><span class="p">(</span><span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndGetDrag</span><span class="p">()</span><span class="o">.</span><span class="n">getDragLeaveEvent</span><span class="p">(</span><span class="n">mevt</span><span class="p">))</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndEnter</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
<span class="k">if</span> <span class="n">mevt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Press</span> <span class="ow">and</span> <span class="n">focusWidget</span><span class="p">:</span>
<span class="n">focusWidget</span><span class="o">.</span><span class="n">clearFocus</span><span class="p">()</span>
<span class="c1"># Clean the Drag and Drop in case of mouse release</span>
<span class="k">if</span> <span class="n">mevt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Release</span><span class="p">:</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndEnd</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">_key_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="n">kevt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_key_events</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">eventKeyPress</span><span class="o">.</span><span class="n">emit</span><span class="p">(</span><span class="n">kevt</span><span class="p">)</span>
<span class="n">keyHandled</span> <span class="o">=</span> <span class="kc">False</span>
<span class="c1"># TTkLog.debug(f&quot;Key: {kevt}&quot;)</span>
<span class="n">focusWidget</span> <span class="o">=</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">getFocus</span><span class="p">()</span>
<span class="c1"># TTkLog.debug(f&quot;{focusWidget}&quot;)</span>
<span class="k">if</span> <span class="n">focusWidget</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">execShortcut</span><span class="p">(</span><span class="n">kevt</span><span class="o">.</span><span class="n">key</span><span class="p">,</span><span class="n">focusWidget</span><span class="p">)</span>
<span class="n">keyHandled</span> <span class="o">=</span> <span class="n">focusWidget</span><span class="o">.</span><span class="n">keyEvent</span><span class="p">(</span><span class="n">kevt</span><span class="p">)</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">execShortcut</span><span class="p">(</span><span class="n">kevt</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
<span class="c1"># Handle Next Focus Key Binding</span>
<span class="k">if</span> <span class="ow">not</span> <span class="n">keyHandled</span> <span class="ow">and</span> \
<span class="p">((</span><span class="n">kevt</span><span class="o">.</span><span class="n">key</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Key_Tab</span> <span class="ow">and</span> <span class="n">kevt</span><span class="o">.</span><span class="n">mod</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">NoModifier</span><span class="p">)</span> <span class="ow">or</span>
<span class="p">(</span> <span class="n">kevt</span><span class="o">.</span><span class="n">key</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Key_Right</span> <span class="ow">or</span> <span class="n">kevt</span><span class="o">.</span><span class="n">key</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Key_Down</span><span class="p">)):</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">nextFocus</span><span class="p">(</span><span class="n">focusWidget</span> <span class="k">if</span> <span class="n">focusWidget</span> <span class="k">else</span> <span class="bp">self</span><span class="p">)</span>
<span class="c1"># Handle Prev Focus Key Binding</span>
<span class="k">if</span> <span class="ow">not</span> <span class="n">keyHandled</span> <span class="ow">and</span> \
<span class="p">((</span><span class="n">kevt</span><span class="o">.</span><span class="n">key</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Key_Tab</span> <span class="ow">and</span> <span class="n">kevt</span><span class="o">.</span><span class="n">mod</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">ShiftModifier</span><span class="p">)</span> <span class="ow">or</span>
<span class="p">(</span> <span class="n">kevt</span><span class="o">.</span><span class="n">key</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Key_Left</span> <span class="ow">or</span> <span class="n">kevt</span><span class="o">.</span><span class="n">key</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Key_Up</span><span class="p">)):</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">prevFocus</span><span class="p">(</span><span class="n">focusWidget</span> <span class="k">if</span> <span class="n">focusWidget</span> <span class="k">else</span> <span class="bp">self</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">_time_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_events</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">TTkK</span><span class="o">.</span><span class="n">TIME_EVENT</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">_win_resize_cb</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">width</span><span class="p">,</span> <span class="n">height</span><span class="p">):</span>
<span class="n">TTkGlbl</span><span class="o">.</span><span class="n">term_w</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">width</span><span class="p">)</span>
<span class="n">TTkGlbl</span><span class="o">.</span><span class="n">term_h</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">height</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_events</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">TTkK</span><span class="o">.</span><span class="n">SCREEN_EVENT</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">_input_thread</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">def</span> <span class="nf">_inputCallback</span><span class="p">(</span><span class="n">kevt</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">mevt</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
<span class="k">if</span> <span class="n">kevt</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_key_events</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">kevt</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_events</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">TTkK</span><span class="o">.</span><span class="n">KEY_EVENT</span><span class="p">)</span>
<span class="k">if</span> <span class="n">mevt</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_mouse_events</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">mevt</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_events</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">TTkK</span><span class="o">.</span><span class="n">MOUSE_EVENT</span><span class="p">)</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_running</span>
<span class="c1"># Start input key loop</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_input</span> <span class="o">=</span> <span class="n">TTkInput</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_input</span><span class="o">.</span><span class="n">get_key</span><span class="p">(</span><span class="n">_inputCallback</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_input</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
<div class="viewcode-block" id="TTk.quit"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkCore.ttk.html#TermTk.TTkCore.ttk.TTk.quit">[docs]</a> <span class="k">def</span> <span class="nf">quit</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39;Tells the application to exit with a return code.&#39;&#39;&#39;</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_events</span><span class="o">.</span><span class="n">put</span><span class="p">(</span><span class="n">TTkK</span><span class="o">.</span><span class="n">QUIT_EVENT</span><span class="p">)</span>
<span class="n">TTkTimer</span><span class="o">.</span><span class="n">quitAll</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_running</span> <span class="o">=</span> <span class="kc">False</span></div>
<span class="k">def</span> <span class="nf">_SIGSTOP</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">signum</span><span class="p">,</span> <span class="n">frame</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;Reset terminal settings and stop background input read before putting to sleep&quot;&quot;&quot;</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Captured SIGSTOP &lt;CTRL-z&gt;&quot;</span><span class="p">)</span>
<span class="n">TTkTerm</span><span class="o">.</span><span class="n">stop</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_input</span><span class="o">.</span><span class="n">stop</span><span class="p">()</span>
<span class="c1"># TODO: stop the threads</span>
<span class="n">os</span><span class="o">.</span><span class="n">kill</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">getpid</span><span class="p">(),</span> <span class="n">signal</span><span class="o">.</span><span class="n">SIGSTOP</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">_SIGCONT</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">signum</span><span class="p">,</span> <span class="n">frame</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;Set terminal settings and restart background input read&quot;&quot;&quot;</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Captured SIGCONT &#39;fg/bg&#39;&quot;</span><span class="p">)</span>
<span class="n">TTkTerm</span><span class="o">.</span><span class="n">cont</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_input</span><span class="o">.</span><span class="n">cont</span><span class="p">()</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">rePaintAll</span><span class="p">()</span>
<span class="c1"># TODO: Restart threads</span>
<span class="c1"># TODO: Redraw the screen</span>
<span class="k">def</span> <span class="nf">_SIGINT</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">signum</span><span class="p">,</span> <span class="n">frame</span><span class="p">):</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Captured SIGINT &lt;CTRL-C&gt;&quot;</span><span class="p">)</span>
<span class="c1"># Deregister the handler</span>
<span class="c1"># so CTRL-C can be redirected to the default handler if the app does not exit</span>
<span class="n">signal</span><span class="o">.</span><span class="n">signal</span><span class="p">(</span><span class="n">signal</span><span class="o">.</span><span class="n">SIGINT</span><span class="p">,</span> <span class="n">signal</span><span class="o">.</span><span class="n">SIG_DFL</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">quit</span><span class="p">()</span></div>
</pre></div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2021, Eugenio Parodi.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>