docs/cyan.html

<html>
<head></head>
<body>

<p align="center"><img src=":/cyan.png" alt="Promo"></p>
<h1 id="cyan" align="center">Cyan _VERSION_</h1>

<p align="justify">Cyan is an open source cross-platform image viewer and converter, designed for prepress (print) work. Like converting an image from RGB to CMYK, or the other way around. Cyan supports color profiles complying with the International Color Consortium (ICC) standard, and strives to create as color-accurate images as possible, with support for RGB, CMYK and GRAY with up to 32-bit image depth.</p>

<h1 id="usage">Usage</h1>
<p align="center"><img src=":/docs/images/cyan-promo-04.png" alt="Promo"></p>

<p align="justify">Cyan should be relatively easy to use and understand. The first thing you should know is that Cyan converts images using color profiles. Converting an image to another colorspace requires two profiles, one with the same colorspace as the image and a second profile with the desired output colorspace.</p>

<h2 id="setup">Setup</h2>

<p align="justify">Cyan requires some minimal setup before usage. You will need to select default color profiles for RGB, CMYK and GRAY. These are used when you load an image without an embedded color profile.</p>

<p align="center"><img src=":/docs/images/cyan-usage-02.png" alt="Promo" /></p>

<p align="justify">You can set a color profile for your monitor if wanted, this will enable a RGB preview/proof of the final image. Note that this will add a performance penalty and you will need a color calibrated monitor with the color profile (available in Cyan).</p>

<p align="center"><img src=":/docs/images/cyan-usage-05.png" alt="Promo" /></p>

<p align="justify">For final adjustments you have rendering intent and black point compensation.</p>
<p align="center"><img src=":/docs/images/cyan-usage-06.png" alt="Promo" /></p>

<h2 id="convert">Convert</h2>

<p align="justify">Load image and verify the input profile (the embedded is recommended).</p>
<p align="center"><img src=":/docs/images/cyan-usage-07.png" alt="Promo" /></p>

<p align="justify">Now selected the desired output profile (in this example we want a CMYK image for print).</p>
<p align="center"><img src=":/docs/images/cyan-usage-08.png" alt="Promo" /></p>

<p align="justify">When you are satisfied with the result just hit save. you can output as JPEG, TIFF and PSD.</p>

<h2 id="mousekeyboard">Mouse/Keyboard</h2>

<ul>
  <li><strong>Ctrl+O</strong> - Open image</li>
  <li><strong>Ctrl+S</strong> - Save image</li>
  <li><strong>Ctrl+I</strong> - Image information</li>
  <li><strong>Ctrl+E</strong> - Save embedded profile (from loaded image)</li>
  <li><strong>Ctrl+Q</strong> - Quit</li>
  <li><strong>Right mouse button</strong> - Fit-to-view</li>
  <li><strong>Left mouse button</strong> - Drag</li>
  <li><strong>Middle mouse button</strong> - View 100%</li>
  <li><strong>Mouse wheel</strong> - Zoom in/out</li>
</ul>

<h1 id="integration">Integration</h1>
<p align="center"><img src=":/docs/images/cyan-promo-07.png" alt="Promo" /></p>

<p align="justify">Cyan offers integration with <a href="https://www.gimp.org">GIMP</a> and works as an import/export plug-in in <a href="https://www.gimp.org">GIMP</a> 2.8+. Just select <code class="highlighter-rouge">Cyan/Import Image</code> or <code class="highlighter-rouge">Cyan/Export Image</code>.</p>

<h2 id="import-cmyk-from-gimp">Import CMYK from GIMP</h2>

<p align="justify">Open GIMP and select <code class="highlighter-rouge">Cyan/Import Image</code>, in Cyan open the desired image and convert to RGB, then hit <code class="highlighter-rouge">save</code> and your image is automatically imported into GIMP.</p>

<h2 id="export-to-cmyk-from-gimp">Export to CMYK from GIMP</h2>

<p align="justify">When you are finished editing in GIMP select <code class="highlighter-rouge">Cyan/Export Image</code>, in Cyan convert to CMYK then hit <code class="highlighter-rouge">save</code>, you can save to TIFF, JPEG and PSD.</p>

<h2 id="gimp-notes">GIMP notes</h2>

<p align="justify">When Cyan starts it will scan your home folder for GIMP 2.x plug-in folders, if found it will install a Cyan Python plug-in in the folder that does not have it.</p>

<p align="justify">If you upgrade GIMP and <code class="highlighter-rouge">Cyan/*</code> is gone just launch Cyan manually once to update the plug-in against your new version of GIMP, this will only happen on GIMP feature releases (2.8=&gt;2.10 etc).</p>

<h1 id="changelog">ChangeLog</h1>

<pre>
_CHANGELOG_
</pre>

<h1 id="open-source">Open Source</h1>

<p align="center"><img src=":/docs/images/cyan-promo-05.png" alt="Promo"></p>

<ul>
<li>Cyan is copyright &copy; 2018-2022 Ole-André Rodlie. All rights reserved.</li>
<li>Cyan is copyright &copy; 2016-2017 Ole-André Rodlie, INRIA. All rights reserved.</li>
</ul>

<p align="justify">This software is governed by the CeCILL license under French law and abiding by the rules of distribution of free software. You can use, modify and / or redistribute the software under the terms of the CeCILL license as circulated by CEA, CNRS and INRIA at the following <a href="https://www.cecill.info">URL</a>.</p>

<p align="justify">Cyan includes ICC color profiles from <a href="http://www.basiccolor.de/">basICColor GmbH</a>, licensed under a <a href="http://creativecommons.org/licenses/by-nd/3.0/">Creative Commons Attribution-No Derivative Works 3.0 license</a>.</p>

<p>
_3RDPARTY_
</p>

</body>
</html>