Oyranos Documentation
0.1.7
Copyright 2004-2006 © Kai-Uwe Behrmann
Introduction | Concept | Proposal | Tools Documentation | User Documentation | Installation | References | Using Oyranos
- Author:
- Kai-Uwe Behrmann
- Date:
- Project start: March 2004
>
- Internet:
- http://www.oyranos.org
Oyranos is intended as a entry point for colour savy applications. In its current stage it configures profile paths, sets default profiles, maps devices to profiles, sets a monitor profile in X and uploads a vcgt tag. This means for instance all applications using Oyranos will use for a incoming digital camera picture the same profile and watch it through the same monitor profile with the same options for rendering intent, simulation and so on.
- oyranos-monitor - a commandline tool for calling from a setup script like .xinitrc. It selects a profile for the current monitor and sets up the X server at startup time. Usage:
# select a monitor profile, load the binary blob into X and fill the
# VideoCardGammaTable, if appropriate
oyranos-monitor
- oyranos-policy - a tool to set a policy from a xml file. Use it like:
oyranos-policy `oyranos-config --syscolordir`/`oyranos-config --settingsdirname`/office.policy.xml
Affected are default profiles and some behaviour settings. - oyranos-config-fltk - a configuration UI application, using some functions of the Oyranos APIs. If you have ICC Examin installed it can be called to show details of profiles.
- oyranos-config - a command line tool to get compiler flags to using Oyranos in your own project. Try oyranos-config --help to see the appropriate options.
The basic Oyranos API gets included with oyranos.h. An application, which wants to use these functions, needs to link against Oyranos and Elektra.
The monitor related API is contained in oyranos_monitor.h. Linkage on Linux needs X11. Therefore this library part is separated from the main one.
The key names, which Oyranos uses to store its configuration in an Elektra file tree, are defined in oyranos_definitions.h.
Frist you have to put a
#include <oyranos/oyranos.h>
in your source text, in order to use Oyranos. oyranos-config --cflags delivers the compiler flags and oyranos-config --ldflags the linker flags.
Then you can put Oyranos functions in your code and compile with:
cc `oyranos-config --cflags` `oyranos-config --ldflags` mycode.c -o myApp
to link Oyranos into your application.
For C++ make shure you use the oyranos:: namespace.
Generated on Sat Jun 16 21:05:40 2007 for Oyranos by
1.5.1