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

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

"oyranos-profile-graph" 1 "June 2, 2020" "User Commands"

NAME

oyranos-profile-graph v0.9.7 - Oyranos Profile Graph

SYNOPSIS

oyranos-profile-graph [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-o=-|FILE] [-f=FORMAT] [-c] [-x] [-d=NUMBER] [-n] [-2] [-4] [-r] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE ...
oyranos-profile-graph -H=NUMBER [-L=NUMBER] [-C=NUMBER] [l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE ...] [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-m=FORMAT] [-o=-|FILE] [-p=FORMAT] [-2] [-4] [-r] [-v]
oyranos-profile-graph -S [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]
oyranos-profile-graph -O [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]
oyranos-profile-graph -k=NUMBER [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]
oyranos-profile-graph -u=STRING [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]
oyranos-profile-graph -s=FILE -p=FORMAT [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-P=STRING] [-o=-|FILE] [-v] [-z]
oyranos-profile-graph -i=FILE [-I=PAGE] [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-f=FORMAT] [-o=-|FILE] [-v]
oyranos-profile-graph -X=json|json+command|man|markdown | -h[=synopsis|...] | -V | -R=gui|cli|web|... [-v]

DESCRIPTION

The oyranos-profile-graph programm converts ICC profiles or embedded ICC profiles from images to a graph image. By default the program shows the saturation line of the specified profiles and writes to stdout.

OPTIONS

2D Graph from profiles

   oyranos-profile-graph [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-o=-|FILE] [-f=FORMAT] [-c] [-x] [-d=NUMBER] [-n] [-2] [-4] [-r] [-v] l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE ...

  Create a 2D Graph containing the saturation line from a ICC Profile.

l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE ... ICC Profile
-d|–change-thickness=NUMBER Specify increase of the thickness of the graph lines (NUMBER:0.7 [≥0 ≤2 Δ0.05])
-x|–xyy Use CIE*xyY *x*y plane for saturation line projection
-c|–no-blackbody Omit white line of lambert light emitters
-n|–no-spectral-line Omit the spectral line
-2|–icc-version-2 Select ICC v2 Profiles
-4|–icc-version-4 Select ICC v4 Profiles
-r|–no-repair No Profile repair of ICC profile ID

HLC Color Atlas Pages

   oyranos-profile-graph -H=NUMBER [-L=NUMBER] [-C=NUMBER] [l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE ...] [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-m=FORMAT] [-o=-|FILE] [-p=FORMAT] [-2] [-4] [-r] [-v]

  Create a 2D Graph containing the possible color patches inside the ICC Profile gamut. More information about HLC Color Atlas can be found on www.freiefarbe.de

-H|–hue=NUMBER HLC Color Atlas: Select a page by hue color angle in the HLC Color Atlas. -H=365 will output all hues. (NUMBER:0 [≥0 ≤365 Δ5])
-L|–lightness=NUMBER HLC Color Atlas: Select a page by lightness in the HLC Color Atlas. (NUMBER:-5 [≥-5 ≤100 Δ5])
-C|–chroma=NUMBER HLC Color Atlas: Select a page by chroma (saturation) in the HLC Color Atlas. (NUMBER:-5 [≥-5 ≤130 Δ5])
l|rgb|cmyk|gray|lab|xyz|web|effect|proof|FILE ... ICC Profile
-m|–swatch-format=FORMAT Specify output file format
-m png# PNG - PNG Raster
-m svg# SVG - SVG Vector
-m ncc# NCC - Named Color Collection

Standard Observer 1931 2° Graph

   oyranos-profile-graph -S [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]

-S|–standard-observer CIE Standard Observer 1931 2°

1964 10° Observer Graph

   oyranos-profile-graph -O [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]

-O|–observer-64 CIE Observer 1964 10°

Blackbody Radiator Spectrum Graph

   oyranos-profile-graph -k=NUMBER [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]

-k|–kelvin=NUMBER Blackbody Radiator (NUMBER:0 [≥0 ≤25000 Δ100])

Illuminant Spectrum Graph

   oyranos-profile-graph -u=STRING [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-o=-|FILE] [-f=FORMAT] [-v]

-u|–illuminant=STRING Illuminant Spectrum
-u A# Illuminant A - CIE A spectral power distribution
-u D50# Illuminant D50 - CIE D50 spectral power distribution (computed)
-u D55# Illuminant D55 - CIE D55 spectral power distribution (computed)
-u D65# Illuminant D65 - CIE D65 spectral power distribution (computed)
-u D65T# Illuminant D65 T - CIE D65 spectral power distribution
-u D75# Illuminant D75 - CIE D75 spectral power distribution (computed)
-u D93# Illuminant D93 - CIE D93 spectral power distribution (computed)

Spectral Input Graph

   oyranos-profile-graph -s=FILE -p=FORMAT [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-P=STRING] [-o=-|FILE] [-v] [-z]

-s|–spectral=FILE Spectral Input
-p|–spectral-format=FORMAT Specify spectral output file format
-p png# PNG - PNG Raster
-p svg# SVG - SVG Vector
-p csv# CSV - CSV Values
-p ncc# NCC - Named Color Collection
-p cgats# CGATS - CGATS Values
-p icc-xml# Icc XML - ICC Named Color Values
-p ppm# PPM - Spectral PAM Image
-P|–pattern=STRING Filter of Color Names
-z|–scale Scale the height of the spectrum graph

Render Color Page

   oyranos-profile-graph -i=FILE [-I=PAGE] [-t=NUMBER] [-b] [-l=NUMBER] [-g] [-w=NUMBER] [-T] [-f=FORMAT] [-o=-|FILE] [-v]

-i|–import=FILE Color Page Input
Supported is a color page in NCC format, which contains pages layout with referenced rgb values. Those are placed on a sheed. Such pages are created by e.g. oyranos-profile-graph –hlc=NUMBER -f ncc
-I|–index=PAGE Page Selection
Specify a page name as string or page index as number. -1 will list all page names of the imported file.

GENERAL OPTIONS

General options

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

-t|–thickness=NUMBER Specify the thickness of the graph lines (NUMBER:1 [≥0 ≤10 Δ0.05])
-b|–no-border Omit border in graph
-l|–background-lightness=NUMBER Background Lightness (NUMBER:-1 [≥-1 ≤100 Δ1])
-g|–no-color Draw Gray
-w|–width=NUMBER Specify output image width in pixel (NUMBER:128 [≥64 ≤4096 Δ1])
-T|–raster Draw Raster
-o|–output=-|FILE Specify output file name, default is stdout
-f|–format=FORMAT Specify output file format png or svg, default is png
-f png# PNG - PNG Raster
-f svg# SVG - SVG Vector
-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
-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|–version Version
-v|–verbose verbose

ENVIRONMENT VARIABLES

OY_DEBUG

  set the Oyranos debug level.
  Alternatively the -v option can be used.
  Valid integer range is from 1-20.

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.openicc.org/index.php%3Ftitle=OpenIccDirectoryProposal.html

EXAMPLES

Show graph of a ICC profile

  oyranos-profile-graph ICC_PROFILE

Show the saturation lines of two profiles in CIE*ab 256 pixel width, without spectral line and with thicker lines:

  oyranos-profile-graph -w 256 -n -t 3 sRGB.icc ProPhoto-RGB.icc

Show HLC Color Atlas patches

  oyranos-profile-graph -H=90 -o HLC_H090.png cmyk web
  Color patches are only shown, if they are in gamut of the default CMYK and web profile.

Show the standard observer spectral function as curves:

  oyranos-profile-graph –standard-observer -o CIE-StdObserver.png

SEE AS WELL

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

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