=====================
LeCroy 93xx Colorizer
=====================
.. toctree::
:maxdepth: 1
:hidden:
settings
LeCroy Colorizer is a command line utility to add color to the black and white
images produced by the screen capture on the LeCroy 93xx series oscilloscopes.
It should run without issue on all platforms that support Python and PIL.
Features
--------
* Colorize all portions of a 93xx series screen capture
* Automatically detects grid layout
* Provides user customizable colors
* Supports a wide variety of input and output image formats
Requirements
------------
* Python 2.6 or 3.x.
* `Pillow library `_
The installation script depends on setuptools which will be installed if it isn't currently present in your Python distribution.
Download
--------
You can access the lecroy-colorizer Git repository from `Github `_. `Packaged source code `_ is also available for download.
Installation
------------
For all platforms, installation via setup.py is provided. After extracting the compressed archive, run the following command:
.. parsed-literal::
> python setup.py install
This will install the lecroy-colorizer distribution (and PIL if necessary) into
your Python's site-packages and create an executable link to the colorize_lecroy
script.
The LeCroy colorizer has been tested on Python 2.6 and 2.7 using native
Windows and the Cygwin environment. It should run without issues on any POSIX
platform. As of 2012/8/5 The PIL installed with Cygwin's Python 2.6
misbehaves slightly by printing "Aborted" when the program ends.
Using LeCroy Colorizer
----------------------
The simplest way to run the colorizer is to supply the input file name:
.. code-block:: sh
> colorize_lecroy -i
This will produce a color output image named ``color_.png`` using the default color style.
======================================= =======================================
Original Colorized
======================================= =======================================
.. image:: images/example_single.png .. image:: images/color_single.png
======================================= =======================================
If you want to control the output file name and format, specify it with the ``-o