displaycal.netDisplayCAL—Display Calibration and Characterization powered by ArgyllCMS

Display CAL — Formerly known as dispcalGUI Display Calibration and Characterization polication. getdefault option Get default option (key-value pair in INI format). getdefaults Get all defaults (key-value pairs in INI format). getmenus Get available menus in the format ID "label" state . state is either enabled or disabled . getmenuitems [menuposition | label] Get available menu items in the format menuposition "menulabel" menuitemID "menuitemlabel" state [checkable] [checked] . state is either enabled or disabled . getstate Get application state. Return value will be either idle , busy , dialogclassname ID dialogname [dialoglabel] state "messagetext" [path "path"] [buttons "buttonlabel"...] if a modal dialog is shown or blocked in case the UI is currently blocked. Most commands will not work if the UI is blocked—the only way to resolve the block is to non-programmatically interact with the actual UI elements of the application or closing it. Note that a state of blocked should normally only occur if an actual file dialog is shown. If using the scripting interface exclusively, this should never happen because it uses a replacement file dialog that supports the same actions as a real file dialog, but doesn’t block. Also note that a return value of blocked for any of the other commands just means that a modal dialog is currently waiting to be interacted with, only if getstate also returns blocked you cannot resolve the situation with scripting alone. getuielement [window ID | name | label] element ID | name | label getuielements [window ID | name | label] Get a single UI element or a list of the visible UI elements of window window or the current active window. Each returned line represents an UI element and has the format classname ID name ["label"] state [checked] [value "value"] [items "item"...] . classname is the internal UI library class name. It can help you determine what type of UI element it is, and which interactions it supports. ID is a numeric identifier. name is the name of the UI element. "label" (if present) is a label which further helps in identifying the UI element. You can use the latter three with the interact command. state is either enabled or disabled . items "item"... (if present) is a list of items connected to the UI element (i.e. selection choices). getvalid Get valid values for options that have constraints (key-value pairs in INI format). There are two sections, ranges and values . ranges are the valid ranges for options that accept numeric values (note that integer options not covered by ranges are typically boolean types). values are the valid values for options that only accept certain values. Options not covered by ranges and values are limited to their data type (you can’t set a numeric option to a string and vice versa). getwindows Get a list of visible windows. The returned format is a list of classname ID name label state . state is either enabled or disabled . import-colorimeter-corrections [filename...] Import colorimeter corrections. install-profile [filename] Install a profile. interact [window ID | name | label] element ID | name | label [setvalue value] Interact with the UI element element of window window or the current active window, e.g. invoke a button or set a control to a value. invokeposition | menulabel menuitemID | menuitemlabel Invoke a menu item. load filename Load filename . Relative paths are possible e.g. for presets: load presets/photo.icc measure Start measurements (must be setup first!). measure-uniformity Measure screen uniformity. measurement-report [filename] If no filename given, show measurement report tab. Otherwise, setup measurement to create the HTML report filename . For non-virtual displays as well as pattern generators (except madVR), call the measure command afterwards to commence measurements. profile Setup profiling measurements (note that this will always use the current calibration if applicable, if you want to use linear calibration instead call load linear.cal prior to calling profile ). For non-virtual displays as well as pattern generators (except madVR), call the measure command afterwards to commence measurements. profile-info [filename] Show profile information, optionally loading profile filename . Relative paths are possible e.g. for presets: profile-info presets/photo.icc refresh Update the GUI after configuration changes via setcfg or restore-defaults . report-calibrated Report on calibrated display. For non-virtual displays as well as pattern generators (except madVR), call the measure command afterwards to commence measurements. report-uncalibrated Report on uncalibrated display. For non-virtual displays as well as pattern generators (except madVR), call the measure command afterwards to commence measurements. restore-defaults [category...] Restore defaults globally or just for category . Call refresh after changing the configuration to update the GUI. setlanguage languagecode Set language. setcfg option value Set configuration option to value . The special value null clears a configuration option. Call refresh after changing the configuration to update the GUI. Also see getdefaults and getvalid . setresponseformat format Set the format for responses. The default plain is a text format that is easy to read, but not necessarily the best for parsing programmatically. The other possible formats are json , json.pretty , xml and xml.pretty . The *.pretty formats use newlines and indentation to make them easier to read. synthprofile [filename] Show synthetic profile creation window, optionally loading profile filename . testchart-editor [filename | create filename] Show testchart editor window, optionally loading or creating testchart filename . Relative paths are possible e.g. for loading a default testchart: testchart-editor ti1/d3-e4-s17-g49-m5-b5-f0.ti1 verify-calibration Verify calibration. For non-virtual displays as well as pattern generators (except madVR), call the measure command afterwards to commence measurements. Interacting with UI elements Invoking a button: interact [window] button e.g. show profile name placeholders information: interact mainframe profile_name_info_btn Setting a value on a dropdown, text field, or slider: interact [window] element setvalue "value" e.g. set calibration gamma to 2.4: interact mainframe trc_textctrl setvalue 2.4 (note that for changing multiple options at once it is generally preferable to call setcfg option value for each option you want to set followed by a single refresh instead) Setting a cell value on a grid: interact [window] grid setvalue "row,col,value" e.g. while the testchart editor is shown, set the cell at the second column of the first row to 33: interact tcgen grid setvalue "0,1,33" Caveats and limitations There are a few things to be aware of when using commands that interact with the UI directly (i.e. activate , alt | cancel | ok , close , interact and invokemenu ). Referring to windows and UI elements: You can refer to windows and UI elements by their ID, name or label (you can find out about windows and UI elements with the getmenus / getmenuitems , getuielement / getuielements , and getwindows commands). If an object’s ID is negative, it means that it has been automatically assigned at object creation time and is only valid during the lifetime of the object (i.e. for modal dialogs, only while the dialog is displayed). For this reason, using an object’s name instead is easier, but names (aswell as non automatically assigned IDs) are not guaranteed to be unique, even for objects which share the same parent window (although most of the important” controls as well as application windows will have unique names). Another possibility is to use an object’s label, which while also not guaranteed to be unique, still has a fairly high likelihood of being unique for controls that share the same parent window, but has the drawback that it is localized (although you can ensure a specific UI language by calling...