Oyranos  git-devel
Oyranos is a full featured Color Management System
oyranos-device v0.9.7

NAME SYNOPSIS DESCRIPTION OPTIONS GENERAL OPTIONS ENVIRONMENT SEE ALSO AUTHOR COPYRIGHT BUGS

"oyranos-device" 1 "May 13, 2021" "User Commands"

NAME ↑

oyranos-device v0.9.7 - Oyranos Color Devices

SYNOPSIS ↑

oyranos-device -a -c=CLASS -d=NUMBER [-p[=ICC_FILE_NAME]] [–system-wide]
oyranos-device -e -c=CLASS -d=NUMBER [–system-wide]
oyranos-device -s -c=CLASS -d=NUMBER
oyranos-device -u -c=CLASS -d=NUMBER
oyranos-device -l [-v] [–short] [–print-class]
oyranos-device -l [-c=CLASS] [-d=NUMBER|–device-name=NAME] [–short] [–path] [-r] [-v]
oyranos-device –list-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]
oyranos-device –list-taxi-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]
oyranos-device -f=icc|openicc+rank-map|openicc|openicc-rank-map -c=CLASS -d=NUMBER -j=FILENAME -k=FILENAME [-o=FILENAME] [–only-db] [-m]
oyranos-device –calibration=FILENAME [-m] [-j=FILENAME] [-f=icc|openicc+rank-map|openicc|openicc-rank-map] [-n=ICC_FILE_NAME]
oyranos-device -h=synopsis|... | -X=json|json+command|man|markdown | -V | -R=gui|cli|web|... [-v]

DESCRIPTION ↑

The oyranos-device program shows and administrates ICC profiles for color devices.

OPTIONS ↑

Set basic parameters

-c|–device-class=CLASS use device class. Useful device classes are monitor, scanner, printer, camera.
-c monitor# Monitor
-c printer# Printer
-c camera# Camera
-c scanner# Scanner
-d|–device-pos=NUMBER device position start from zero
–device-name=NAME alternatively specify the name of a device
-2|–icc-version-2 Select ICC v2 Profiles
-4|–icc-version-4 Select ICC v4 Profiles
-r|–skip-x-color-region-target skip X Color Management device profile

Assign profile to device

   oyranos-device -a -c=CLASS -d=NUMBER [-p[=ICC_FILE_NAME]] [–system-wide]

-a|–assign add configuration to OpenICC DB
-p|–profile-name[=ICC_FILE_NAME] profile file name
Can be "" empty string or "automatic" or a real profile name.
–system-wide add computer wide

Unassign profile from device

   oyranos-device -e -c=CLASS -d=NUMBER [–system-wide]

-e|–erase remove configuration from OpenICC DB

Setup device

   oyranos-device -s -c=CLASS -d=NUMBER

-s|–setup configure session from OpenICC DB

Unset device

   oyranos-device -u -c=CLASS -d=NUMBER

-u|–unset reset session configuration to zero

List device classes

   oyranos-device -l [-v] [–short] [–print-class]

-l|–list List device classes
-v|–verbose verbose
–short print module ID or profile name
–print-class print the modules device class

List devices

   oyranos-device -l [-c=CLASS] [-d=NUMBER|–device-name=NAME] [–short] [–path] [-r] [-v]

  Needs -c option.

-l|–list List device classes
-c|–device-class=CLASS use device class. Useful device classes are monitor, scanner, printer, camera.
-c monitor# Monitor
-c printer# Printer
-c camera# Camera
-c scanner# Scanner
–short print module ID or profile name
–path print the full file name

List local DB profiles for selected device

   oyranos-device –list-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]

  Needs -c and -d options.

–list-profiles List local DB profiles for selected device
–show-non-device-related show as well non matching profiles

List Taxi DB profiles for selected device

   oyranos-device –list-taxi-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]

  Needs -c and -d options.

–list-taxi-profiles List Taxi DB profiles for selected device
–show-non-device-related show as well non matching profiles

Dump device color state

   oyranos-device -f=icc|openicc+rank-map|openicc|openicc-rank-map -c=CLASS -d=NUMBER -j=FILENAME -k=FILENAME [-o=FILENAME] [–only-db] [-m]

  Needs -c and -d options.

-f|–format=icc|openicc+rank-map|openicc|openicc-rank-map dump configuration data
-f icc# write assigned ICC profile
-f fallback-icc# create fallback ICC profile
-f openicc+rank-map# create OpenICC device color state JSON including the rank map
-f openicc# create OpenICC device color state JSON
-f openicc-rank-map# create OpenICC device color state rank map JSON
-o|–output=FILENAME write to specified file
-j|–device-json=FILENAME use device JSON alternatively to -c and -d options
-k|–rank-json=FILENAME use rank map JSON alternatively to -c and -d options
–only-db use only DB keys for -f=openicc
-m|–device-meta-tag embedd device and driver information into ICC meta tag

Convert Calibration Data

   oyranos-device –calibration=FILENAME [-m] [-j=FILENAME] [-f=icc|openicc+rank-map|openicc|openicc-rank-map] [-n=ICC_FILE_NAME]

  Use for VCGT or printer calibrations. The command generates a device link profile. This can be used for insertion into a conversion, which does not use native calibration, like a opt out window with Compiz compicc window color management.

–calibration=FILENAME Generate a device link profile.
FILENAME can be output of xcalib -p .
-m|–device-meta-tag embedd device and driver information into ICC meta tag
-j|–device-json=FILENAME use device JSON alternatively to -c and -d options
-n|–new-profile-name=ICC_FILE_NAME profile file name

GENERAL OPTIONS ↑

General options

   oyranos-device -h=synopsis|... | -X=json|json+command|man|markdown | -V | -R=gui|cli|web|... [-v]

-h|–help=synopsis|... Print help text
Show usage information and hints for the tool.
-X|–export=json|json+command|man|markdown Export formated text
Get UI converted into text formats
-X man# Man : Unix Man page - Get a unix man page
-X markdown# Markdown : Formated text - Get formated text
-X json# Json : GUI - Get a Oyjl Json UI declaration
-X json+command# Json + Command : GUI + Command - Get Oyjl Json UI declaration incuding command
-X export# Export : All available data - Get UI data for developers. The format can be converted by the oyjl-args tool.
-V|–version Version
-R|–render=gui|cli|web|... Select Renderer
Select and possibly configure Renderer. -R="gui" will just launch a graphical UI. -R="web:port=port_number:https_key=TLS_private_key_filename:https_cert=TLS_CA_certificate_filename:css=layout_filename.css" will launch a local Web Server, which listens on local port.
-R gui# Gui : Show UI - Display a interactive graphical User Interface.
-R cli# Cli : Show UI - Print on Command Line Interface.
-R web# Web : Start Web Server - Start a local Web Service to connect a Webbrowser with. Use the -R=web:help sub option to see more information.
-R -
-v|–verbose verbose

ENVIRONMENT ↑

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

SEE ALSO ↑

  oyranos-policy(1)  oyranos-config(1)  oyranos-profiles(1)  oyranos-profile(1)  oyranos(3)

https://gitlab.com/oyranos/oyranos

AUTHOR ↑

Kai-Uwe Behrmann https://gitlab.com/beku

COPYRIGHT ↑

© 2005-2024 Kai-Uwe Behrmann and others

License

newBSD https://gitlab.com/oyranos/oyranos

BUGS ↑

https://www.gitlab.com/oyranos/oyranos/issues

Generated by   doxygen 1.8.13