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

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

"oyranos-profile" 1 "March 06, 2015" "User Commands"

NAME

oyranos-profile v0.9.7 - Oyranos Profile

SYNOPSIS

oyranos-profile [–path] [–short] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE
oyranos-profile -l [-p=NUMBER] [-n=NAME] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE
oyranos-profile -r=NUMBER l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE
oyranos-profile -m [-w=ICC_FILE_NAME] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE
oyranos-profile –ppmcie[=FORMAT] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE
oyranos-profile -o=FILENAME [-c=CLASS] [-f=xml...] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE
oyranos-profile -w=ICC_FILE_NAME [-j=FILENAME|-m] [-s=NAME] [-2] [-4] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE
oyranos-profile -h[=synopsis|...] | -X=json|json+command|man|markdown | -V | -R=gui|cli|web|... [-v]

DESCRIPTION

The oyranos-profile programm shows informations about a ICC profile and allows some modifications.

OPTIONS

Show ICC Profile

   oyranos-profile [–path] [–short] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE

l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE ICC Profile
can be file name, internal description string, ICC profile ID or wildcard "rgb", "cmyk", "gray", "lab", "xyz", "web", "rgbi", "cmyki", "grayi", "labi", "xyzi". Wildcards ending with "i" are assumed profiles. "web" is a sRGB profile. The other wildcards are editing profiles.
–path show the full ICC profile path and file name
–short show only the ICC profiles file name

List included ICC tags

   oyranos-profile -l [-p=NUMBER] [-n=NAME] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE

-l|–list-tags list contained tags additional to overview and header.
-p|–tag-pos=NUMBER select tag
-n|–tag-name=NAME select tag

Remove included ICC tag

   oyranos-profile -r=NUMBER l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE

-r|–remove-tag=NUMBER
remove selected tag number.

Show Profile ID

   oyranos-profile -m [-w=ICC_FILE_NAME] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE

-m|–list-hash show internal hash value.
-w|–profile-name=ICC_FILE_NAME write profile with correct ID hash
The -w option specifies the new internal and external profile name. PROFILENAME specifies the source profile.

Show CIE*xy chromaticities

   oyranos-profile –ppmcie[=FORMAT] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE

–ppmcie[=FORMAT] show CIE*xy chromaticities, if available, for use with ppmcie.
–ppmcie TEXT# TEXT
–ppmcie PNG# PNG

Dump Device Infos to OpenICC device JSON

   oyranos-profile -o=FILENAME [-c=CLASS] [-f=xml...] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE

-o|–output=FILENAME
write device informations to OpenICC JSON.
-c|–device-class=CLASS use device class. Useful device classes are monitor, scanner, printer, camera.
-f|–format=xml... use IccXML format

Write to ICC profile

   oyranos-profile -w=ICC_FILE_NAME [-j=FILENAME|-m] [-s=NAME] [-2] [-4] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE

-w|–profile-name=ICC_FILE_NAME write profile with correct ID hash
The -w option specifies the new internal and external profile name. PROFILENAME specifies the source profile.
-j|–json-name=FILENAME embed OpenICC JSON device from file
-m|–list-hash show internal hash value.
-s|–name-space=NAME add prefix
-2|–icc-version-2 Select ICC v2 Profiles
-4|–icc-version-4 Select ICC v4 Profiles

GENERAL OPTIONS

General options

   oyranos-profile -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 VARIABLES

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

EXAMPLES

Show overview and header of profile

  oyranos-profile sRGB.icc

Show first tags content of profile

  oyranos-profile -lv -p=1 sRGB.icc

Show the profile hash sum

  oyranos-profile -m sRGB.icc

Show the RGB primaries of a matrix profile inside a CIE*xy diagram

  ppmcie oyranos-profile --ppmcie sRGB.icc > sRGB_cie-xy.ppm

Add calibration data to meta tag of a device profile

  oyranos-profile -w my_profile -j my_device.json my_profile.icc

Pass the profile to a external tool

  iccdump "`oyranos-profile --path cmyk`"

SEE ALSO

  oyranos-profiles(1)  oyranos-profile-graph(1)  oyranos-config-fltk(1)  oyranos-config(1)  oyranos(3)  ppmcie(1)

http://www.oyranos.org

AUTHOR

Kai-Uwe Behrmann http://www.oyranos.org

COPYRIGHT

© 2005-2021 Kai-Uwe Behrmann and others

License

newBSD http://www.oyranos.org

BUGS

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