Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
oyranos-monitor(1)	     General Commands Manual	      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] [--system-wide]
     [-v]
     oyranos-monitor -e [[-x num] [-y num]|-d NUMBER] [--system-wide] [-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:stdout]
     [[-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 profile(s)
     within the Oyranos color 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.
	    --system-wide do system wide, might need admin or root privileges

     -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.
	    --system-wide do system wide, might need admin or root privileges

     -l, --list list devices
	    -v increase verbosity
	    --short show only the ICC profiles file name
	    --path show the full ICC profile path and 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 --profile.
	    --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	monitors
     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

     Pass the monitor profile to a external tool:
	    iccDumpProfile -v "`oyranos-monitor -l -d 0 -c --path`"

     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=profilename.icc
	    --name=profilename

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

COPYRIGHT
     (c) 2005-2015, Kai-Uwe Behrmann and others
     License: new BSD <http://www.opensource.org/licenses/BSD-3-Clause>

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			 March 06, 2015 	      oyranos-monitor(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=oyranos-monitor&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help