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: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 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	privi-
	      leges

       -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	privi-
	      leges

       -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	--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 am-
       biguous.
       -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  de-
	      rived 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=profile-
	      name.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+14.3.quarterly>

home | help