<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>README.md - fork/oculante @ 0.8.20</title>
<meta name="description" content="README.md in fork/oculante at 0.8.20.">
<meta property="og:title" content="README.md - fork/oculante @ 0.8.20">
<meta property="og:description" content="README.md in fork/oculante at 0.8.20.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="0.8.20" data-tip="bdda00f0f7ab1a367963874b054469c333cc737d">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/oculante</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/oculante</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Johann Woelper</span><span class="commit-message" data-commit="ee0564f54e92ad7b92f05e1032fe4bfc39874284">update readme</span><span class="snapshot-sha sha" data-commit="ee0564f54e92ad7b92f05e1032fe4bfc39874284">ee0564f</span><time datetime="2024-03-29T17:02:56+01:00" title="2024-03-29 17:02:56 +0100">2024-03-29</time></p>
<header class="topbar"><details class="switcher"><summary>0.8.20</summary><div class="menu"><strong>branches</strong><a href="/fork/oculante/ref/master/">master</a><strong>tags</strong><a href="/fork/oculante/ref/0.8.19/">0.8.19</a><a class="current" href="/fork/oculante/ref/0.8.20/">0.8.20</a><a href="/fork/oculante/ref/0.8.21/">0.8.21</a><a href="/fork/oculante/ref/0.8.22/">0.8.22</a><a href="/fork/oculante/ref/0.8.23/">0.8.23</a><a href="/fork/oculante/ref/0.9.0/">0.9.0</a><a href="/fork/oculante/ref/0.9.1/">0.9.1</a><a href="/fork/oculante/ref/0.9.2/">0.9.2</a><a class="all" href="/fork/oculante/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/oculante/">oculante</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>9.3 KiB</span><span>254 lines</span></span><span class="actions"><a class="raw" href="/fork/oculante/raw/f428ede222008fddaf9ab18072c12a8595ac7fc8/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered">&lt;h1 align="center"&gt;
    &lt;img alt="banner" src="res/banner.png"&gt;
&lt;/h1&gt;
<p><em>A no-nonsense hardware-accelerated image viewer</em></p>
<p><a href="https://github.com/woelper/oculante/releases/latest">&lt;img src="https://img.shields.io/badge/Download-blue" height="40"&gt;</a></p>
<p>Oculante's vision is to be a fast, unobtrusive, portable image viewer with wide image format support, offering image analysis and basic editing tools.</p>
<ul>
<li>Free of charge, bloat-free, ad-free, privacy-respecting open source application</li>
<li>Fast opening of images, fast startup</li>
<li>Available for Win, Mac, Linux and NetBSD</li>
<li>Supports a wide range of images and SVG</li>
<li>Caches images for faster reloading</li>
<li>Can display unassociated channels correctly (If your image uses alpha and color channels to encode data in a special way)</li>
<li>Lets you pick pixels, display location and color values</li>
<li>Offers basic nondestructive editing: Crop, resize, paint, contrast, HSV, rotate, blur, noise, ...</li>
<li>SIMD-accelerated image editing</li>
</ul>
<hr />
<h2><a href="https://github.com/woelper/oculante/actions/workflows/check_osx.yml"><img src="https://github.com/woelper/oculante/actions/workflows/check_osx.yml/badge.svg" alt="OSX" /></a>
<a href="https://github.com/woelper/oculante/actions/workflows/check_netbsd_minimal.yml"><img src="https://github.com/woelper/oculante/actions/workflows/check_netbsd_minimal.yml/badge.svg" alt="NetBSD" /></a>
<a href="https://github.com/woelper/oculante/actions/workflows/check_ubuntu_no_default_features.yml"><img src="https://github.com/woelper/oculante/actions/workflows/check_ubuntu_no_default_features.yml/badge.svg" alt="Ubuntu" /></a>
<a href="https://github.com/woelper/oculante/actions/workflows/check_windows.yml"><img src="https://github.com/woelper/oculante/actions/workflows/check_windows.yml/badge.svg" alt="Check Windows" /></a>
<a href="https://github.com/woelper/oculante/actions/workflows/check_arm7.yml"><img src="https://github.com/woelper/oculante/actions/workflows/check_arm7.yml/badge.svg" alt="ARM" /></a></h2>
<p><img src="https://img.shields.io/github/downloads/woelper/oculante/total?label=release%20downloads" alt="GitHub all releases" />
<img src="https://img.shields.io/crates/d/oculante?label=crates.io%20downloads" alt="Crates.io" /></p>
<p><img src="/fork/oculante/raw/7650ae47ca1881877d4e2c4d115157b87f87f248/res/screenshot_1.png" alt="Screenshot" title="Screenshot" /></p>
<h2>Flipbook</h2>
<p>With configurable caching, Oculante can quickly step through image sequences:
<img src="/fork/oculante/raw/c6cd782c4fe9e996e86a5ea3fbf09cccb2bf33fd/res/flipbook.gif" alt="Screenshot" title="Screenshot" /></p>
<h2>Inspection</h2>
<p>Get info about pixel values and position, with precise picking:
<img src="/fork/oculante/raw/b97e8c5733f743cff4e5dca80cb4db6191464c4a/res/picker.gif" alt="Screenshot" title="Screenshot" /></p>
<h2>Network</h2>
<p>Raw image data can be sent to Oculante and will be loaded if possible, regardless of format. Streams of images will be played as a video. You can send images from cameras or headless systems such as a Raspberry Pi for example.
<img src="/fork/oculante/raw/3656b7bfcb9ae172d6d63a5a55f59e9f030f728a/res/net.gif" alt="Screenshot" title="Screenshot" /></p>
<h2>Correct color channel display:</h2>
<p>Images may contain color information that is masked by the alpha channel. Although it is present you will not see it since usually RGB values are multiplied with the A channel when displayed. Oculante allows you to inspect all channels individually and see color data without transparency applied.
<img src="/fork/oculante/raw/2b2cc0f948fb5d6870663c30886979d2d6c9415d/res/premult.png" alt="Screenshot" title="Screenshot" /></p>
<h2>Installation</h2>
<p>Oculante needs no installation, as it is just one executable. Just download it for your system from the releases tab (https://github.com/woelper/oculante/releases). In order to open images you can configure your system to open your desired image formats with oculante, drag them onto the executable or into the window. Right now the executables are roughly 20MB, as the default is to statically link dependencies. Minimal versions with less image formats are provided for older computers/tiny systems. Packages for Arm linux are also built. Please open an issue if you want your operating system of choice supported.</p>
<p>On NetBSD, a pre-compiled binary is available through the native package manager.
To install it, simply run</p>
<pre class="language-bash"><a-f>pkgin</a-f> install oculante</pre>
<h2>Features</h2>
<h3>Image format support:</h3>
<ul>
<li>bmp</li>
<li>gif (animation support and correct timing)</li>
<li>hdr, tonemapped</li>
<li>ico</li>
<li>jpeg</li>
<li>png</li>
<li>pnm</li>
<li>tga</li>
<li>jxl (JPEG XL, via <code>jxl-oxide</code>)</li>
<li>avif</li>
<li>tiff (via <code>tiff</code> with additional float/half support)</li>
<li>webp (via <code>libwebp-sys</code> - <code>image</code> had <em>very</em> limited format support)</li>
<li>farbfeld</li>
<li>DDS (DXT1-5, via <code>dds-rs</code>)</li>
<li>psd (via <code>psd</code>)</li>
<li>svg (via <code>resvg</code>)</li>
<li>exr (via <code>exr-rs</code>), tonemapped</li>
<li>RAW (via <code>quickraw</code> - nef, cr2, dng, mos, erf, raf, arw, 3fr, ari, srf, sr2, braw, r3d, nrw, raw). Since raw is a complex field without true standards, not all camera models are supported.</li>
<li>ppm</li>
<li>HEIC/HEIF (via <code>libheif-rs</code>). Enabled on Windows builds, but optional dependency on MacOS and Linux - available behind <code>heif</code> flag.</li>
<li>qoi</li>
</ul>
<h3>Platform support:</h3>
<ul>
<li>Linux</li>
<li>Mac</li>
<li>Windows</li>
<li>NetBSD</li>
</ul>
<h3>Misc features</h3>
<ul>
<li>Image info (&lt;kbd&gt;i&lt;/kbd&gt;) (pixel position, color info)</li>
<li>Threaded image loading</li>
<li>Fit image to view</li>
<li>Window can be configured to be always on top - helpful to keep image as reference</li>
<li>Low cpu usage</li>
<li>Non-destructive painting and operator stack - edit very large images interactively by scaling them down first, then deleting the downscale operator once you want to export.</li>
<li>Metafile support: Edit stack can be saved into a metafile which will be auto-loaded and applied when loading the original.</li>
<li>Pretty fast startup / loading time</li>
<li>Configurable image caching (Select how many images to keep in memory)</li>
<li>Display unassociated / unpremultiplied alpha (&lt;kbd&gt;u&lt;/kbd&gt;)</li>
<li>Lossless JPEG editing: Crop, rotate, mirror without recompressing data</li>
<li>Light/Dark theme and follow system theme mode</li>
<li>Network listen mode: Start with <code>oculante -l port</code> and oculante will switch to receive mode. You can then pipe raw image data to that port, for example using <code>nc localhost 8888 &lt; image.jpg</code>. Image types will be auto-detected. If you pipe image sequences, these will be played at about 30 fps so you can pipe videos to it. This can be useful to visualize images from a headless system.</li>
<li>EXIF support: Load metadata if present</li>
<li>Load files from stdin: pipe your data with <code>cat image | oculante -s</code></li>
</ul>
<h3>Misc examples:</h3>
<p>EXIF display</p>
<p><img src="/fork/oculante/raw/3c62a71b61a92737f7a67abdc77f9cdc7d642a24/res/screenshot_exif.png" alt="Screenshot" title="Screenshot" /></p>
<p>Extract a signature</p>
<p><img src="/fork/oculante/raw/6486d3921b8b56af774af7c10a7c77c418593269/res/ex-signature.gif" alt="signature example" title="Extracting a signature" /></p>
<h2>Roadmap:</h2>
<ul>
<li><del>Image loading time is still worse than feh or xv</del> This is now very close, in particular after switching to <code>turbojpeg</code></li>
<li>Tests and benchmarks</li>
<li>Image rotation (and read EXIF for that)</li>
<li>Investigate PVR / ETC support</li>
<li>Brighness/gamma adjust for HDR</li>
<li><del>SVG support</del></li>
<li><del>Custom display for images with unassociated channels</del></li>
<li><del>EXR support</del></li>
<li><del>Read next image(s) in dir and advance to them</del></li>
</ul>
<h3>Privacy pledge</h3>
<p>Oculante does in no way collect or send anonymous or non-anonynmous user data or statistics.
Oculante is and will remain free and open source.
There will never be ads.
There are only two instances where oculante interacts with the network, and both never happen without being triggered by the user:</p>
<ul>
<li>Updating the application (must be triggered manually from settings)</li>
<li>Listening for incoming images on a custom port (must be set on command line)</li>
</ul>
<p>In addition, oculante saves some settings locally, for example:</p>
<ul>
<li>UI accent color</li>
<li>Keybindings</li>
<li>Vsync preferences</li>
<li>Keep view offset/scale</li>
<li>Whether the directory index bar is displayed</li>
<li>Recent files</li>
</ul>
<h2>Attribution</h2>
<p>Test / benchmark pictures:</p>
<p>https://unsplash.com/@mohsen_karimi</p>
<p>https://unsplash.com/@frstvisuals</p>
<h2>License</h2>
<p>This project is MIT licensed.
This project contains GPL-licensed code, such as the LUTs in res/LUT. As a result, the source code of this project is publically available to comply with the GPL. Authors who wish to use this project without publishing source code are responsible of removing any code and its references that require source code access.</p>
<h2>Building</h2>
<p>Linux:</p>
<p><code>sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev libgtk-3-dev libasound2-dev nasm cmake</code></p>
<p>Win:
Install Nasm from https://www.nasm.us/pub/nasm/releasebuilds/2.15.05/win64/</p>
<p>Mac
<code>brew install nasm</code></p>
<h3>Cargo Features</h3>
<p>If you disable <code>turbo</code> (on by default), the turbojpeg library will not be used to open jpeg images. You won't need Nasm to be installed.
The feature <code>file_open</code> will enable/disable a file open dialog. This pulls in additional dependencies and is enabled by default.</p>
<h3>Shortcuts:</h3>
<p><code>mouse wheel</code> = zoom</p>
<p><code>left mouse</code>,<code>middle mouse</code> = pan</p>
<p><code>ctrl + mouse wheel</code> = prev/next image in folder</p>
<p><code>Right mouse</code> pick color from image (in paint mode)</p>
<p>&lt;kbd&gt;T&lt;/kbd&gt; = AlwaysOnTop</p>
<p>&lt;kbd&gt;F&lt;/kbd&gt; = Fullscreen</p>
<p>&lt;kbd&gt;I&lt;/kbd&gt; = InfoMode</p>
<p>&lt;kbd&gt;E&lt;/kbd&gt; = EditMode</p>
<p>&lt;kbd&gt;Right&lt;/kbd&gt; = NextImage</p>
<p>&lt;kbd&gt;Home&lt;/kbd&gt; = FirstImage</p>
<p>&lt;kbd&gt;End&lt;/kbd&gt; = LastImage</p>
<p>&lt;kbd&gt;Left&lt;/kbd&gt; = PreviousImage</p>
<p>&lt;kbd&gt;R&lt;/kbd&gt; = RedChannel</p>
<p>&lt;kbd&gt;G&lt;/kbd&gt; = GreenChannel</p>
<p>&lt;kbd&gt;B&lt;/kbd&gt; = BlueChannel</p>
<p>&lt;kbd&gt;A&lt;/kbd&gt; = AlphaChannel</p>
<p>&lt;kbd&gt;U&lt;/kbd&gt; = RGBChannel</p>
<p>&lt;kbd&gt;C&lt;/kbd&gt; = RGBAChannel</p>
<p>&lt;kbd&gt;V&lt;/kbd&gt; = ResetView</p>
<p>&lt;kbd&gt;Minus&lt;/kbd&gt; = ZoomOut</p>
<p>&lt;kbd&gt;Equals&lt;/kbd&gt; = ZoomIn</p>
<p>&lt;kbd&gt;Key1&lt;/kbd&gt; = ZoomActualSize</p>
<p>&lt;kbd&gt;Key2&lt;/kbd&gt; = ZoomDouble</p>
<p>&lt;kbd&gt;Key3&lt;/kbd&gt; = ZoomThree</p>
<p>&lt;kbd&gt;Key4&lt;/kbd&gt; = ZoomFour</p>
<p>&lt;kbd&gt;Key5&lt;/kbd&gt; = ZoomFive</p>
<p>&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;C&lt;/kbd&gt; = CompareNext</p>
<p>&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Left&lt;/kbd&gt; = PanLeft</p>
<p>&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Right&lt;/kbd&gt; = PanRight</p>
<p>&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Up&lt;/kbd&gt; = PanUp</p>
<p>&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Down&lt;/kbd&gt; = PanDown</p>
<p>&lt;kbd&gt;Delete&lt;/kbd&gt; = DeleteFile</p>
<p>&lt;kbd&gt;RBracket&lt;/kbd&gt; = LosslessRotateRight</p>
<p>&lt;kbd&gt;LBracket&lt;/kbd&gt; = LosslessRotateLeft</p>
<p>&lt;kbd&gt;LControl&lt;/kbd&gt; + &lt;kbd&gt;C&lt;/kbd&gt; = Copy</p>
<p>&lt;kbd&gt;LControl&lt;/kbd&gt; + &lt;kbd&gt;V&lt;/kbd&gt; = Paste</p>
<p>&lt;kbd&gt;LControl&lt;/kbd&gt; + &lt;kbd&gt;O&lt;/kbd&gt; = Browse</p>
<p>&lt;kbd&gt;Q&lt;/kbd&gt; = Quit</p>
<p>&lt;kbd&gt;Z&lt;/kbd&gt; = ZenMode</p>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"><a-p>&lt;</a-p><a-tg>h1</a-tg> <a-at>align</a-at>=&quot;<a-s>center</a-s>&quot;<a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>alt</a-at><a-p>=&quot;</a-p><a-s>banner</a-s><a-p>&quot; </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>res/banner.png</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>h1</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"><a-p> _A no-nonsense hardware-accelerated image viewer_</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>[&lt;img src=&quot;https://img.shields.io/badge/Download-blue&quot; height=&quot;40&quot;&gt;](https://github.com/woelper/oculante/releases/latest)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>Oculante&#39;s vision is to be a fast, unobtrusive, portable image viewer with wide image format support, offering image analysis and basic editing tools.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-p>- Free of charge, bloat-free, ad-free, privacy-respecting open source application</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>- Fast opening of images, fast startup</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>- Available for Win, Mac, Linux and NetBSD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>- Supports a wide range of images and SVG</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>- Caches images for faster reloading</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>- Can display unassociated channels correctly (If your image uses alpha and color channels to encode data in a special way)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"><a-p>- Lets you pick pixels, display location and color values</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>- Offers basic nondestructive editing: Crop, resize, paint, contrast, HSV, rotate, blur, noise, ...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>- SIMD-accelerated image editing</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>---</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-tt>[![OSX](https://github.com/woelper/oculante/actions/workflows/check_osx.yml/badge.svg)](https://github.com/woelper/oculante/actions/workflows/check_osx.yml)</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-tt>[![NetBSD](https://github.com/woelper/oculante/actions/workflows/check_netbsd_minimal.yml/badge.svg)](https://github.com/woelper/oculante/actions/workflows/check_netbsd_minimal.yml)</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-tt>[![Ubuntu](https://github.com/woelper/oculante/actions/workflows/check_ubuntu_no_default_features.yml/badge.svg)](https://github.com/woelper/oculante/actions/workflows/check_ubuntu_no_default_features.yml)</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-tt>[![Check Windows](https://github.com/woelper/oculante/actions/workflows/check_windows.yml/badge.svg)](https://github.com/woelper/oculante/actions/workflows/check_windows.yml)</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-tt>[![ARM](https://github.com/woelper/oculante/actions/workflows/check_arm7.yml/badge.svg)](https://github.com/woelper/oculante/actions/workflows/check_arm7.yml)</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>---</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-p>![GitHub all releases](https://img.shields.io/github/downloads/woelper/oculante/total?label=release%20downloads)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>![Crates.io](https://img.shields.io/crates/d/oculante?label=crates.io%20downloads)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>![Screenshot](res/screenshot_1.png &quot;Screenshot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>## </a-p><a-tt>Flipbook</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>With configurable caching, Oculante can quickly step through image sequences:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>![Screenshot](res/flipbook.gif &quot;Screenshot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>## </a-p><a-tt>Inspection</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>Get info about pixel values and position, with precise picking:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>![Screenshot](res/picker.gif &quot;Screenshot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>## </a-p><a-tt>Network</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>Raw image data can be sent to Oculante and will be loaded if possible, regardless of format. Streams of images will be played as a video. You can send images from cameras or headless systems such as a Raspberry Pi for example.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>![Screenshot](res/net.gif &quot;Screenshot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>## </a-p><a-tt>Correct color channel display:</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>Images may contain color information that is masked by the alpha channel. Although it is present you will not see it since usually RGB values are multiplied with the A channel when displayed. Oculante allows you to inspect all channels individually and see color data without transparency applied.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>![Screenshot](res/premult.png &quot;Screenshot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>## </a-p><a-tt>Installation</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>Oculante needs no installation, as it is just one executable. Just download it for your system from the releases tab (https://github.com/woelper/oculante/releases). In order to open images you can configure your system to open your desired image formats with oculante, drag them onto the executable or into the window. Right now the executables are roughly 20MB, as the default is to statically link dependencies. Minimal versions with less image formats are provided for older computers/tiny systems. Packages for Arm linux are also built. Please open an issue if you want your operating system of choice supported.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>On NetBSD, a pre-compiled binary is available through the native package manager.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>To install it, simply run</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>```</a-p><a-tl>sh</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>pkgin install oculante</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>## </a-p><a-tt>Features</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>### </a-p><a-tt>Image format support:</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>- bmp</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>- gif (animation support and correct timing)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>- hdr, tonemapped</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>- ico</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>- jpeg</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>- png</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>- pnm</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"><a-p>- tga</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>- jxl (JPEG XL, via `jxl-oxide`)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"><a-p>- avif</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>- tiff (via `tiff` with additional float/half support)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>- webp (via `libwebp-sys` - `image` had _very_ limited format support)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>- farbfeld</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"><a-p>- DDS (DXT1-5, via `dds-rs`)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>- psd (via `psd`)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>- svg (via `resvg`)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>- exr (via `exr-rs`), tonemapped</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>- RAW (via `quickraw` - nef, cr2, dng, mos, erf, raf, arw, 3fr, ari, srf, sr2, braw, r3d, nrw, raw). Since raw is a complex field without true standards, not all camera models are supported.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>- ppm</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>- HEIC/HEIF (via `libheif-rs`). Enabled on Windows builds, but optional dependency on MacOS and Linux - available behind `heif` flag.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"><a-p>- qoi</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>### </a-p><a-tt>Platform support:</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>- Linux</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>- Mac</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>- Windows</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>- NetBSD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>### </a-p><a-tt>Misc features</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>- Image info (&lt;kbd&gt;i&lt;/kbd&gt;) (pixel position, color info)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"><a-p>- Threaded image loading</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"><a-p>- Fit image to view</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"><a-p>- Window can be configured to be always on top - helpful to keep image as reference</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>- Low cpu usage</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>- Non-destructive painting and operator stack - edit very large images interactively by scaling them down first, then deleting the downscale operator once you want to export.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"><a-p>- Metafile support: Edit stack can be saved into a metafile which will be auto-loaded and applied when loading the original.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>- Pretty fast startup / loading time</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"><a-p>- Configurable image caching (Select how many images to keep in memory)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"><a-p>- Display unassociated / unpremultiplied alpha (&lt;kbd&gt;u&lt;/kbd&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"><a-p>- Lossless JPEG editing: Crop, rotate, mirror without recompressing data</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"><a-p>- Light/Dark theme and follow system theme mode</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"><a-p>- Network listen mode: Start with `oculante -l port` and oculante will switch to receive mode. You can then pipe raw image data to that port, for example using `nc localhost 8888 &lt; image.jpg`. Image types will be auto-detected. If you pipe image sequences, these will be played at about 30 fps so you can pipe videos to it. This can be useful to visualize images from a headless system.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"><a-p>- EXIF support: Load metadata if present </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-p>- Load files from stdin: pipe your data with `cat image | oculante -s`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"><a-p>### </a-p><a-tt>Misc examples:</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text"><a-p>EXIF display</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"><a-p>![Screenshot](res/screenshot_exif.png &quot;Screenshot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text"><a-p>Extract a signature</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text"><a-p>![signature example](res/ex-signature.gif &quot;Extracting a signature&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text"><a-p>## </a-p><a-tt>Roadmap:</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"><a-p>- ~~Image loading time is still worse than feh or xv~~ This is now very close, in particular after switching to `turbojpeg`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text"><a-p>- Tests and benchmarks</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text"><a-p>- Image rotation (and read EXIF for that)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text"><a-p>- Investigate PVR / ETC support</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text"><a-p>- Brighness/gamma adjust for HDR</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text"><a-p>- ~~SVG support~~</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"><a-p>- ~~Custom display for images with unassociated channels~~</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"><a-p>- ~~EXR support~~</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"><a-p>- ~~Read next image(s) in dir and advance to them~~</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"><a-p>### </a-p><a-tt>Privacy pledge</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text"><a-p>Oculante does in no way collect or send anonymous or non-anonynmous user data or statistics.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text"><a-p>Oculante is and will remain free and open source.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text"><a-p>There will never be ads.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text"><a-p>There are only two instances where oculante interacts with the network, and both never happen without being triggered by the user:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"><a-p>- Updating the application (must be triggered manually from settings)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text"><a-p>- Listening for incoming images on a custom port (must be set on command line)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text"><a-p>In addition, oculante saves some settings locally, for example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text"><a-p>- UI accent color</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text"><a-p>- Keybindings</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"><a-p>- Vsync preferences</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text"><a-p>- Keep view offset/scale</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text"><a-p>- Whether the directory index bar is displayed</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text"><a-p>- Recent files</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text"><a-p>## </a-p><a-tt>Attribution</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text"><a-p>Test / benchmark pictures:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L151" href="#L151">151</a><span class="code-text"><a-p>https://unsplash.com/@mohsen_karimi</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text"><a-p>https://unsplash.com/@frstvisuals</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L154" href="#L154">154</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L155" href="#L155">155</a><span class="code-text"><a-p>## </a-p><a-tt>License</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L156" href="#L156">156</a><span class="code-text"><a-p>This project is MIT licensed.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text"><a-p>This project contains GPL-licensed code, such as the LUTs in res/LUT. As a result, the source code of this project is publically available to comply with the GPL. Authors who wish to use this project without publishing source code are responsible of removing any code and its references that require source code access.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L159" href="#L159">159</a><span class="code-text"><a-p>## </a-p><a-tt>Building</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L160" href="#L160">160</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</a><span class="code-text"><a-p>Linux:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L162" href="#L162">162</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</a><span class="code-text"><a-p>`sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev libgtk-3-dev libasound2-dev nasm cmake`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L164" href="#L164">164</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L165" href="#L165">165</a><span class="code-text"><a-p>Win:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L166" href="#L166">166</a><span class="code-text"><a-p>Install Nasm from https://www.nasm.us/pub/nasm/releasebuilds/2.15.05/win64/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L167" href="#L167">167</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L168" href="#L168">168</a><span class="code-text"><a-p>Mac</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L169" href="#L169">169</a><span class="code-text"><a-p>`brew install nasm`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L170" href="#L170">170</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L171" href="#L171">171</a><span class="code-text"><a-p>### </a-p><a-tt>Cargo Features</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L172" href="#L172">172</a><span class="code-text"><a-p>If you disable `turbo` (on by default), the turbojpeg library will not be used to open jpeg images. You won&#39;t need Nasm to be installed.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L173" href="#L173">173</a><span class="code-text"><a-p>The feature `file_open` will enable/disable a file open dialog. This pulls in additional dependencies and is enabled by default.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L174" href="#L174">174</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L175" href="#L175">175</a><span class="code-text"><a-p>### </a-p><a-tt>Shortcuts:</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L176" href="#L176">176</a><span class="code-text">`mouse wheel` = zoom</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L177" href="#L177">177</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L178" href="#L178">178</a><span class="code-text">`left mouse`,`middle mouse` = pan</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L179" href="#L179">179</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L180" href="#L180">180</a><span class="code-text">`ctrl + mouse wheel` = prev/next image in folder</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L181" href="#L181">181</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L182" href="#L182">182</a><span class="code-text">`Right mouse` pick color from image (in paint mode)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L183" href="#L183">183</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L184" href="#L184">184</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L185" href="#L185">185</a><span class="code-text">&lt;kbd&gt;T&lt;/kbd&gt; = AlwaysOnTop</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L186" href="#L186">186</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L187" href="#L187">187</a><span class="code-text">&lt;kbd&gt;F&lt;/kbd&gt; = Fullscreen</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L188" href="#L188">188</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L189" href="#L189">189</a><span class="code-text">&lt;kbd&gt;I&lt;/kbd&gt; = InfoMode</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L190" href="#L190">190</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L191" href="#L191">191</a><span class="code-text">&lt;kbd&gt;E&lt;/kbd&gt; = EditMode</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L192" href="#L192">192</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L193" href="#L193">193</a><span class="code-text">&lt;kbd&gt;Right&lt;/kbd&gt; = NextImage</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L194" href="#L194">194</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L195" href="#L195">195</a><span class="code-text">&lt;kbd&gt;Home&lt;/kbd&gt; = FirstImage</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L196" href="#L196">196</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L197" href="#L197">197</a><span class="code-text">&lt;kbd&gt;End&lt;/kbd&gt; = LastImage</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L198" href="#L198">198</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L199" href="#L199">199</a><span class="code-text">&lt;kbd&gt;Left&lt;/kbd&gt; = PreviousImage</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L200" href="#L200">200</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L201" href="#L201">201</a><span class="code-text">&lt;kbd&gt;R&lt;/kbd&gt; = RedChannel</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L202" href="#L202">202</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L203" href="#L203">203</a><span class="code-text">&lt;kbd&gt;G&lt;/kbd&gt; = GreenChannel</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L204" href="#L204">204</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L205" href="#L205">205</a><span class="code-text">&lt;kbd&gt;B&lt;/kbd&gt; = BlueChannel</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L206" href="#L206">206</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L207" href="#L207">207</a><span class="code-text">&lt;kbd&gt;A&lt;/kbd&gt; = AlphaChannel</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L208" href="#L208">208</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L209" href="#L209">209</a><span class="code-text">&lt;kbd&gt;U&lt;/kbd&gt; = RGBChannel</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L210" href="#L210">210</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L211" href="#L211">211</a><span class="code-text">&lt;kbd&gt;C&lt;/kbd&gt; = RGBAChannel</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L212" href="#L212">212</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</a><span class="code-text">&lt;kbd&gt;V&lt;/kbd&gt; = ResetView</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L214" href="#L214">214</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L215" href="#L215">215</a><span class="code-text">&lt;kbd&gt;Minus&lt;/kbd&gt; = ZoomOut</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L216" href="#L216">216</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L217" href="#L217">217</a><span class="code-text">&lt;kbd&gt;Equals&lt;/kbd&gt; = ZoomIn</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L218" href="#L218">218</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L219" href="#L219">219</a><span class="code-text">&lt;kbd&gt;Key1&lt;/kbd&gt; = ZoomActualSize</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L220" href="#L220">220</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L221" href="#L221">221</a><span class="code-text">&lt;kbd&gt;Key2&lt;/kbd&gt; = ZoomDouble</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L222" href="#L222">222</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L223" href="#L223">223</a><span class="code-text">&lt;kbd&gt;Key3&lt;/kbd&gt; = ZoomThree</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L224" href="#L224">224</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L225" href="#L225">225</a><span class="code-text">&lt;kbd&gt;Key4&lt;/kbd&gt; = ZoomFour</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L226" href="#L226">226</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L227" href="#L227">227</a><span class="code-text">&lt;kbd&gt;Key5&lt;/kbd&gt; = ZoomFive</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L228" href="#L228">228</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L229" href="#L229">229</a><span class="code-text">&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;C&lt;/kbd&gt; = CompareNext</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L230" href="#L230">230</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L231" href="#L231">231</a><span class="code-text">&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Left&lt;/kbd&gt; = PanLeft</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L232" href="#L232">232</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L233" href="#L233">233</a><span class="code-text">&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Right&lt;/kbd&gt; = PanRight</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L234" href="#L234">234</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L235" href="#L235">235</a><span class="code-text">&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Up&lt;/kbd&gt; = PanUp</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L236" href="#L236">236</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L237" href="#L237">237</a><span class="code-text">&lt;kbd&gt;LShift&lt;/kbd&gt; + &lt;kbd&gt;Down&lt;/kbd&gt; = PanDown</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L238" href="#L238">238</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L239" href="#L239">239</a><span class="code-text">&lt;kbd&gt;Delete&lt;/kbd&gt; = DeleteFile</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L240" href="#L240">240</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L241" href="#L241">241</a><span class="code-text">&lt;kbd&gt;RBracket&lt;/kbd&gt; = LosslessRotateRight</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L242" href="#L242">242</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L243" href="#L243">243</a><span class="code-text">&lt;kbd&gt;LBracket&lt;/kbd&gt; = LosslessRotateLeft</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L244" href="#L244">244</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L245" href="#L245">245</a><span class="code-text">&lt;kbd&gt;LControl&lt;/kbd&gt; + &lt;kbd&gt;C&lt;/kbd&gt; = Copy</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L246" href="#L246">246</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L247" href="#L247">247</a><span class="code-text">&lt;kbd&gt;LControl&lt;/kbd&gt; + &lt;kbd&gt;V&lt;/kbd&gt; = Paste</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L248" href="#L248">248</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L249" href="#L249">249</a><span class="code-text">&lt;kbd&gt;LControl&lt;/kbd&gt; + &lt;kbd&gt;O&lt;/kbd&gt; = Browse</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L250" href="#L250">250</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L251" href="#L251">251</a><span class="code-text">&lt;kbd&gt;Q&lt;/kbd&gt; = Quit</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L252" href="#L252">252</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L253" href="#L253">253</a><span class="code-text">&lt;kbd&gt;Z&lt;/kbd&gt; = ZenMode</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L254" href="#L254">254</a><span class="code-text"></span></span></pre></div></div>
</main>
</body>
</html>
