Tree [13fef1] default eilin-2.0.2 /

File Date Author Commit
 include 2012-06-26 Lukas Jirkovsky Lukas Jirkovsky [3f6442] More documentation.
 libeilin 2012-06-26 Lukas Jirkovsky Lukas Jirkovsky [1567b9] Fix memory leaks in the config file loader (the...
 qeilin 2012-06-26 Lukas Jirkovsky Lukas Jirkovsky [91666d] Make sure qeilin doesn't lock itself when the e...
 .hgtags 2012-06-24 Lukas Jirkovsky Lukas Jirkovsky [58a692] Added tag 2.0.1 for changeset d56ce8f98bde
 CMakeLists.txt 2012-06-23 Lukas Jirkovsky Lukas Jirkovsky [d96c71] Add foundations for the Qt GUI.
 LICENSE 2010-09-01 Lukas Jirkovsky Lukas Jirkovsky [54d37c] Initial commit.
 NEWS 2012-06-26 Lukas Jirkovsky Lukas Jirkovsky [13fef1] Update NEWS.
 README 2012-06-24 Lukas Jirkovsky Lukas Jirkovsky [8e8622] Update README.
 eilin.c 2012-06-23 Lukas Jirkovsky Lukas Jirkovsky [877cf0] Make eilin a library. This commit still contain...
 eilin.xml 2012-06-26 Lukas Jirkovsky Lukas Jirkovsky [4fcd5b] Document the configuration file a bit.

Read Me

eilin is a Linux utility to control settings of EIZO monitors.

Tested Monitors:

If your monitor is not listed and thus is not supported you can try setting
any of supported monitors (using --type option). However this is unsafe
and not recommended.

If it works please let me know what monitor you are using and what settings
works for you and I'll add it to the list of supported monitors.

If it doesn't work you can still get the monitor working. See How Can I Help
section below.

C compiler
CMake 2.8
libusb 1.x or libusbx

GUI requirements (optional)
C++ compiler
Qt 4

In order to compile eilin run following commands within the source directory.

cmake .
make install

To print possible options run eilin without any parameters. The monitor type must
be specified on command line or in the config file, because eilin is not able
to determine the monitor model automatically.

Note that some settings are not available in some modes. For example, in srgb mode
only brightness and contrast can be changed.

GUI usage
The Qt GUI creates an icon in the sytem tray. The application can be run only in
one instance.

By clicking on the icon, the mode is changed. Double click on the icon, or right
click and choosing settings, opens the detailed settings window.

To quit the application, right click on the system tray icon and select quit.

eilin uses rather self-descriptive xml configuration. The configuration is read
from eilin.xml, ~/.eilin.xml and /etc/eilin.xml in that order.

Most of it's content are "magic" numbers needed for eilin to work. These numbers
are monitor-specific. Every monitor has it's <monitor> entry.

To select the default monitor change the <default monitor="TYPE" /> line to match
the type from <monitor type="TYPE"> tag. This monitor type will be used when you
call eilin without -t (--type) parameter.

Known Bugs
Sometimes there are off-by-one bugs in setting/reading numeric values. That's because
the real range of values differ from the one reported by monitor. eilin uses one
function to convert between the two representations but due to rounding the values
reported by eilin may differ a bit (personally I never saw difference bigger than 1)

How Can I help?
If your monitor doesn't work you can help by catching the USB communication of
the official Eizo control utility with adding necessary information what was done.

If you know the basics of how USB works it should not be a problem for you to get the
necessary "magic numbers" and update configuration file accordingly.
Otherwise send me sniffed communication  where you describe exactly what you did
with every tested feature in separate file.