Oyranos/Device Profiles

From ColourWiki

Currently only monitor profiles are supported on unix X window systems.

The man page for the appropriate command line tool "oyranos-monitor" is shown below:

oyranos-monitor(1)                                          oyranos-monitor(1)

NAME
      oyranos-monitor - Oyranos CMS monitor configuration

SYNOPSIS
      oyranos-monitor |-s [[-x num] [-y num]|-d NUMBER] [-v]
      oyranos-monitor PROFILENAME [[-x num] [-y num]|-d NUMBER] [-v]
      oyranos-monitor -e [[-x num] [-y num]|-d NUMBER] [-v]
      oyranos-monitor -l [[-x num] [-y num]|-d NUMBER] [-v]
                      [ --module MODULENAME ]
      oyranos-monitor --modules [-v]
      oyranos-monitor  -f [edid|icc|edid_icc] [-o OUT_FILENAME | default:std‐
      out] [[-x num] [-y num]|-d NUMBER] [-m] [-v]
      oyranos-monitor --add-edid FILENAME --profile  FILENAME  [--name  NAME]
      [-v]

DESCRIPTION
      The  oyranos-monitor  programm  let  you query and set the monitor pro‐
      file(s) within the Oyranos colour management system (CMS). Profiles are
      stored in a data base, the Oyranos DB.

OPTIONS
      -s Setup a ICC profile for a all or a selected monitor

             -s,  --setup [default] Set up the X11 server with the Oyranos DB
             stored monitor ICC profile(s). This option is optional.

             -d NUMBER , -d=NUMBER position in device list.
             -x POSITION , -x=POSITION select the screen at the x position.
             -y POSITION , -y=POSITION select the screen at the y position.

      PROFILENAME  assign a ICC profile to a monitor device
             Assign a monitor ICC profile to the selected screen and store in
             the Oyranos DB.

             -d NUMBER , -d=NUMBER position in device list.
             -x POSITION , -x=POSITION select the screen at the x position.
             -y POSITION , -y=POSITION select the screen at the y position.

      -e, --erase  release a ICC profile from a monitor device
             Reset  the  hardware  gamma table to the defaults and erase from
             the Oyranos DB

             -d NUMBER , -d=NUMBER position in device list.
             -x POSITION , -x=POSITION select the screen at the x position.
             -y POSITION , -y=POSITION select the screen at the y position.

      -l, --list list devices
             -v increase verbosity
             --short show only the ICC profiles file name

      --modules
             list monitor modules

      -f, --format [edid|icc|edid_icc] Get data
             Select a data format. Possible are edid  for  server  side  EDID
             data,  icc  for a server side ICC profile and edid_icc for a ICC
             profile created from server side EDID.  Without  the  -o/--ouput
             option the output is written to stdout.

             -d NUMBER , -d=NUMBER position in device list.
             -x POSITION , -x=POSITION select the screen at the x position.
             -y POSITION , -y=POSITION select the screen at the y position.
             -m  (--device-meta-tag)  switch  is  accepted  by the -f=icc and
             -f=edid_icc option. It embeddes device and  driver  informations
             about  the  actual device for later easier ICC profile to device
             assignment.  This becomes useful for sharing ICC profiles.
             -o, --output OUT_FILENAME Write data selected by -f/--format  to
             the given filename.

      --add-edid EDID_FILENAME
             Embedd  EDID  keys to a ICC profile as meta tag. Requires --pro‐
             file.
             --profile ICC_FILENAME ICC profile.
             --name ICC_INTERNAL_NAME String for ICC profile internal name.

GENERAL OPTIONS
      -d NUMBER , -d=NUMBER position in device list.  The numbering of  moni‐
      tors  starts  with  zero for the first device. To get the number of all
      available devices use "oyranos-monitor -l | wc -l".
      -x POSITION , -x=POSITION select the screen at  the  x  position.   The
      Oyranos screens are if possible real devices. A screen position must be
      unique and not shared  by  different  screens,  otherwise  it  will  be
      ambiguous.
      -y POSITION , -y=POSITION select the screen at the y position
      -v, --verbose increase verbosity
      --module select module

      --daemon
             Run  as  daemon to observe monitor hotplug events and update the
             setup.

ENVIRONMENT
      DISPLAY
             On X11 systems the display is selected by this variable.

      OY_DEBUG
             set the Oyranos debug level. Alternatively the -v option can  be
             used.

      XDG_DATA_HOME XDG_DATA_DIRS
             route  Oyranos  to  top  directories  containing  resources. The
             derived paths for ICC profiles have a "color/icc" appended.
             http://www.oyranos.com/wiki/index.php?title=OpenIccDirectoryProposal

      OY_MODULE_PATH
             route Oyranos to additional directories containing modules.

EXAMPLES
      Put the following in a setup script like .xinitrc:
             # select a monitor profile, load the binary blob into X and
             # fill the VideoCardGammaTable, if appropriate
             oyranos-monitor

      Assign a ICC profile to a screen:
             oyranos-monitor -x pos -y pos profilename

      Reset a screens hardware LUT in order to do a calibration:
             oyranos-monitor -e -x pos -y pos profilename

      Query the server side, network transparent profile:
             oyranos-monitor -x pos -y pos

      List all Oyranos monitor devices:
             oyranos-monitor -l

      Show the first Oyranos monitor device verbosely:
             oyranos-monitor -l -v -d 0

      List all monitor devices through the oyX1 module:
             oyranos-monitor -l --module oyX1

      Dump data in the format following the -f option:
             oyranos-monitor -f=[edid|icc|edid_icc] -o=edid.bin -x=pos -y=pos
             -m

      Embedd device informations into ICC meta tag:
             oyranos-monitor    --add-edid=edid_filename   --profile=profile‐
             name.icc --name=profilename

AUTHOR
      Kai-Uwe Behrmann (ku.b (at) gmx.de)

COPYRIGHT
      (c) 2005-2012, Kai-Uwe Behrmann and others
      License: new BSD <http://www.opensource.org/licenses/bsd-license.php>

SEE ALSO
      oyranos-config-fltk(1) oyranos-policy(1) oyranos-profiles(1) oyranos(3)
      http://www.oyranos.org

BUGS
      at: http://sourceforge.net/tracker/?group_id=177017&atid=879553

User Commands                    July 29, 2012              oyranos-monitor(1)