1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089
3090
3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
3146
3147
3148
3149
3150
3151
3152
3153
3154
3155
3156
3157
3158
3159
3160
3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203
3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258
3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
3310
3311
3312
3313
3314
3315
3316
3317
3318
3319
3320
3321
3322
3323
3324
3325
3326
3327
3328
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338
3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
3384
3385
3386
3387
3388
3389
3390
3391
3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
3403
3404
3405
3406
3407
3408
3409
3410
3411
3412
3413
3414
3415
3416
3417
3418
3419
3420
3421
3422
3423
3424
3425
3426
3427
3428
3429
3430
3431
3432
3433
3434
3435
3436
3437
3438
3439
3440
3441
3442
3443
3444
3445
3446
3447
3448
3449
3450
3451
3452
3453
3454
3455
3456
3457
3458
3459
3460
3461
3462
3463
3464
3465
3466
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
3479
3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491
3492
3493
3494
3495
3496
3497
3498
3499
3500
3501
3502
3503
3504
3505
3506
3507
3508
3509
3510
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<!--[if lte IE 8 ]>
<html xmlns="http://www.w3.org/1999/xhtml" class="ie_lte_8">
<![endif]-->
<!--[if (gt IE 8)|!(IE) ]><!-->
<html xmlns="http://www.w3.org/1999/xhtml">
<!--<![endif]-->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>dispcalGUI—Open Source Display Calibration and Characterization powered by Argyll CMS</title>
<meta name="description" content="A graphical front-end for display calibration and profiling using Argyll CMS" />
<link rel="shortcut icon" href="theme/icons/favicon.ico" type="image/x-icon" />
<link rel="stylesheet" href="theme/readme.css" />
<link rel="stylesheet" href="theme/slimbox2/slimbox2.css" />
<script type="text/javascript" src="theme/jquery.js"></script>
<script type="text/javascript" src="theme/jquery.scrollTo.js"></script>
<script type="text/javascript" src="theme/jquery.localscroll.js"></script>
<script type="text/javascript" src="theme/slimbox2/slimbox2.js"></script>
<script type="text/javascript" src="theme/readme.js"></script>
</head>
<body>
<h1><img src="theme/icon-reflection.png" alt="dispcalGUI" /> <a href="http://dispcalGUI.hoech.net">dispcalGUI</a><span><span class="dash">—</span>Open Source Display Calibration and Characterization powered by <a href="http://argyllcms.com">Argyll CMS</a></span></h1>
<div id="intro">
<div id="friendlybox">
<div id="get">
<h2>2.5 </h2>
<p>2014-09-06 00:07 UTC</p>
<ul>
<li class="download"><a href="#download">Get dispcalGUI</a></li>
<li class="requirements"><a href="#requirements">System requirements</a></li>
<li class="changelog"><a href="#changelog">What's new in this version</a></li>
</ul>
</div>
<ul class="complementary">
<li class="about"><a href="#about">About</a></li>
<li class="quickstart"><a href="#quickstart">Quickstart guide</a></li>
<li class="issues"><a href="#issues">Issues & solutions</a></li>
<li class="help"><a href="#help">Get help</a></li>
<li class="reportbug"><a href="#reportbug">Report a bug</a></li>
<li class="donate"><a href="#donate">Donate</a></li>
</ul>
</div>
<p id="teaser">
<a href="#screenshots" title="View screenshots"><img src="theme/dispcalGUI-adjust-reflection.png" alt="" /></a>
</p>
</div>
<div id="infobox">
<p id="info">Stay up-to-date and be notified of new releases by signing up to the <a href="https://lists.sourceforge.net/lists/listinfo/dispcalgui-news" title="dispcalGUI-news mailing list">dispcalGUI-news</a> mailing list (unless you're already subscribed to <a href="https://lists.sourceforge.net/lists/listinfo/dispcalgui-users" title="dispcalGUI-users mailing list">dispcalGUI-users</a> which also receives new release notifications).</p>
</div>
<div id="donation-box">
<div id="donate">If you would like to support the development of dispcalGUI, you can make a donation.<br />
If you decide to donate, please also consider donating to <a href="http://argyllcms.com">Argyll CMS</a> (if you haven't already), as dispcalGUI wouldn't be possible without it (visit <a href="http://argyllcms.com">argyllcms.com</a> and scroll down a bit to get to its donation link).<br />
<a href="#thanks">Thanks to all donors!</a><br />
<form id="donationform" action="https://www.paypal.com/cgi-bin/webscr" method="post">
<p>
Donate using PayPal:
<input type="hidden" name="cmd" value="_donations" />
<input id="donationform_business" type="hidden" name="business" value="" />
<input type="hidden" name="item_name" value="Donation to Florian Hoech/dispcalGUI" />
<input type="hidden" name="no_shipping" value="1" />
<button type="submit" name="amount" value="5" class="paypal">5</button>
<button type="submit" name="amount" value="10" class="paypal">10</button>
<button type="submit" name="amount" value="20" class="paypal">20</button>
<button type="submit" name="amount" value="50" class="paypal">50</button>
<button type="submit" class="paypal">Own amount</button>
Currency: <select name="currency_code">
<option value="EUR" selected="selected">€ Euro</option>
<option value="GBP">£ Pound</option>
<option value="AUD">$ Australian Dollar</option>
<option value="CAD">$ Canadian Dollar</option>
<option value="USD">$ US Dollar</option>
</select>
</p>
</form>
<script type="text/javascript">
//<![CDATA[
(function () {
var btns = document.getElementsByTagName('button'), i;
for (i = 0; i < btns.length; i ++) {
btns[i].style.visibility = 'hidden';
}
setTimeout(function () {
document.getElementById('donationform_business').value = ['dispcalgui.hoech.net', 'donate'].reverse().join('\x40');
for (i = 0; i < btns.length; i ++) {
btns[i].style.visibility = 'visible';
}
}, 3000);
})();
//]]>
</script>
<span>(For other means of donating, please contact me under <a>dispcalGUI ‹at› hoech . net</a>)</span>
</div>
</div>
<div id="content">
<div id="toc">
<h2>Table of contents</h2>
<ul>
<li><a href="#about">About dispcalGUI</a>
</li>
<li><a href="#disclaimer">Disclaimer</a></li>
<li><a href="#download">Download</a></li>
<li><a href="#quickstart">Quickstart guide</a></li>
<li><a href="#requirements">System requirements and other prerequisites</a>
<ul>
<li><a href="#requirements">General system requirements</a></li>
<li><a href="#argyll">Argyll CMS</a></li>
<li><a href="#instruments">Supported instruments</a></li>
<li><a href="#requirements-unattended">Additional requirements for unattended calibration and profiling</a></li>
<li><a href="#requirements-source">Additional requirements for using the source code</a></li>
</ul>
</li>
<li><a href="#install">Installation</a></li>
<li><a href="#concept">Basic concept of display calibration</a></li>
<li><a href="#colorimeter-corrections">A note about colorimeters, displays and dispcalGUI</a></li>
<li><a href="#usage">Usage</a>
<ul>
<li><a href="#usage">General usage</a></li>
<li><a href="#settingsfile">Settings file</a></li>
<li><a href="#presets">Predefined settings (presets)</a></li>
<li><a href="#display_instrument">Choosing a display and measurement device</a></li>
<li><a href="#settings_calibration">Calibration settings</a></li>
<li><a href="#settings_profiling">Profiling settings</a></li>
<li><a href="#calibrating">Calibrating / profiling</a></li>
<li><a href="#remote">Remote measurements and profiling</a></li>
<li><a href="#untethered">Untethered display measurement and profiling</a></li>
</ul>
</li>
<li><a href="#menu">Menu commands</a>
<ul>
<li><a href="#menu">List of menu commands</a></li>
<li><a href="#menu-file">File menu</a></li>
<li><a href="#menu-options">Options menu</a></li>
<li><a href="#menu-tools">Tools menu</a></li>
<li><a href="#menu-lang">Language menu</a></li>
</ul>
</li>
<li><a href="#issues">Known issues & solutions</a></li>
<li><a href="#help">Get help</a></li>
<li><a href="#reportbug">Report a bug</a></li>
<li><a href="#discuss">Discussion</a></li>
<li><a href="#todo">To-Do / planned features</a></li>
<li><a href="#thanks">Thanks and acknowledgements</a></li>
<li><a href="#changelog">Version history / changelog</a></li>
<li><a href="#definitions">Definitions</a></li>
</ul>
</div>
<div id="about">
<h2>About dispcalGUI</h2>
<p>dispcalGUI is a graphical user interface for the display calibration and profiling tools of <a href="http://argyllcms.com">Argyll CMS</a>, an open source color management system by Graeme Gill.</p>
<p>Calibrate and characterize your display devices using one of the <a href="#instruments">many supported hardware sensors</a>, with support for multi-display setups and a variety of available settings like customizable whitepoint, luminance, tone response curve as well as the option to create matrix and look-up-table ICC profiles, with optional gamut mapping, as well as some proprietary 3D LUT formats. Other features include:</p>
<ul>
<li>Support of colorimeter correction for different screens via <em>correction matrices</em> or <em>calibration specral sample</em> files (the latter only for specific colorimeters i.e. i1 Display Pro, ColorMunki Display and Spyder 4).</li>
<li>Profile verification: Check the quality of profiles via measurements. Also supports custom CGATS files (e.g. FOGRA, GRACoL/IDEAlliance, SWOP) and using of reference profiles to obtain test values.</li>
<li>Test chart editor: Create charts with any amount of color patches, easy copy & paste from CGATS, CSV files (only tab-delimited) and spreadsheet applications.</li>
<li>Create synthetic ICC (matrix) profiles with custom primaries, white- and blackpoint as well as tone response.</li>
</ul>
<div id="screenshots">
<h3>Screenshots</h3>
<p>
<span><a href="screenshots/dispcalGUI-screenshot-GNOME.png" class="imagelink" rel="lightbox-set" title="dispcalGUI running under Linux with GNOME 3"><img src="screenshots/dispcalGUI-screenshot-GNOME-thumb.png" alt="Thumbnail of dispcalGUI running under Linux with GNOME 3" class="opaque" /></a><br />
<small>Main window</small><br /></span>
<span><a href="screenshots/dispcalGUI-screenshot-GNOME-gamutmap.png" class="imagelink" rel="lightbox-set" title="Gamut mapping options"><img src="screenshots/dispcalGUI-screenshot-GNOME-gamutmap-thumb.png" alt="Thumbnail of dispcalGUI running under Linux with GNOME" class="opaque" /></a><br />
<small>Gamut mapping options</small><br /></span>
<span><a href="screenshots/dispcalGUI-screenshot-GNOME-edit-testchart.png" class="imagelink" rel="lightbox-set" title="Testchart editor"><img src="screenshots/dispcalGUI-screenshot-GNOME-edit-testchart-thumb.png" alt="Thumbnail of dispcalGUI running under Linux with GNOME" class="opaque" /></a><br />
<small>Testchart editor</small><br /></span>
</p>
<p>
<span><a href="screenshots/dispcalGUI-screenshot-GNOME-adjust.png?date=2012-02-05" class="imagelink" rel="lightbox-set" title="Display adjustment"><img src="screenshots/dispcalGUI-screenshot-GNOME-adjust-thumb.png?date=2012-02-05" alt="Thumbnail of dispcalGUI running under Linux with GNOME" class="opaque" /></a><br />
<small>Display adjustment</small><br /></span>
<span><a href="screenshots/dispcalGUI-screenshot-GNOME-measure.png" class="imagelink" rel="lightbox-set" title="Measurements"><img src="screenshots/dispcalGUI-screenshot-GNOME-measure-thumb.png" alt="Thumbnail of dispcalGUI running under Linux with GNOME" class="opaque" /></a><br />
<small>Measurements</small><br /></span>
<span><a href="screenshots/dispcalGUI-screenshot-GNOME-view-curves.png" class="imagelink" rel="lightbox-set" title="Calibration curves"><img src="screenshots/dispcalGUI-screenshot-GNOME-view-curves-thumb.png" alt="Thumbnail of dispcalGUI running under Linux with GNOME" class="opaque" /></a><br />
<small>Calibration curves</small><br /></span>
</p>
<p>
<span><a href="screenshots/dispcalGUI-screenshot-KDE4.png" class="imagelink" rel="lightbox-set" title="dispcalGUI running under Linux with KDE4"><img src="screenshots/dispcalGUI-screenshot-KDE4-thumb.png" alt="Thumbnail of dispcalGUI running under Linux with KDE4" class="opaque" /></a><br />
<small>KDE4</small><br /></span>
<span><a href="screenshots/dispcalGUI-screenshot-Mac.png" class="imagelink" rel="lightbox-set" title="dispcalGUI running under Mac OS X"><img src="screenshots/dispcalGUI-screenshot-Mac-thumb.png" alt="Thumbnail of dispcalGUI running under Mac OS X" class="opaque" /></a><br />
<small>Mac OS X</small><br /></span>
<span><a href="screenshots/dispcalGUI-screenshot-Win7.png" class="imagelink" rel="lightbox-set" title="dispcalGUI running under Windows 7"><img src="screenshots/dispcalGUI-screenshot-Win7-thumb.png" alt="Thumbnail of dispcalGUI running under Windows 7" class="opaque" /></a><br />
<small>Windows 7</small><br /></span>
</p>
</div>
</div>
<div id="disclaimer">
<h2>Disclaimer</h2>
<p>This program is free software; you can redistribute it and/or modify it
under the terms of the <a href="LICENSE.txt">GNU General Public License</a> as published by the
<a href="http://fsf.org/">Free Software Foundation</a>; either <a href="LICENSE.txt">version 3 of the License</a>, or (at your
option) any later version.</p>
<p>This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the <a href="LICENSE.txt">GNU General Public License</a> for more details.</p>
<p>dispcalGUI is written in <a href="http://python.org/">Python</a> and uses the 3rd-party packages <a href="http://numpy.scipy.org/">NumPy</a>, <a href="http://pypi.python.org/pypi/demjson">demjson</a> (<acronym title="JavaScript Object Notation">JSON<sup><a href="#definition_JSON">[6]</a></sup></acronym> library) and <a href="http://wxpython.org/">wxPython</a> (<acronym title="Graphical User Interface">GUI<sup><a href="#definition_GUI">[4]</a></sup></acronym> toolkit). It also makes extensive use of several <a href="http://argyllcms.com/">Argyll CMS</a> utilities. The build system to create standalone executables additionally uses <a href="http://pypi.python.org/pypi/setuptools">setuptools</a> and <a href="http://pypi.python.org/pypi/py2app">py2app</a> on Mac OS X or <a href="http://pypi.python.org/pypi/py2exe">py2exe</a> on Windows. All of these software packages are © by their respective authors.</p>
</div>
<div id="download">
<h2>Get dispcalGUI and Argyll CMS via Zero Install (recommended)</h2>
<ul>
<li>
<h3>Brief introduction to Zero Install</h3>
<div>
<p>(<strong>Note:</strong> Usually you do not have to install Zero Install separately, it is handled automatically by the dispcalGUI downloads linked below. The following paragraph is only informational.)</p>
<p><a href="http://0install.net">Zero Install</a> is a decentralised cross-platform software installation system. The benefits you get from Zero Install are:</p>
<ul>
<li><strong>Always up-to-date.</strong> Zero Install automatically keeps all software updated.</li>
<li><strong>Easily switch between software versions</strong> from within Zero Install if desired.</li>
<li><strong>No administrator rights needed</strong> to add or update software (*).</li>
</ul>
<p class="footnote">* Note: Installing/updating Zero Install itself or software dependencies through the operating system's mechanisms may require administrative privileges.</p>
</div>
</li>
<li>
<h3>For Linux</h3>
<div>
<p>Native packages for several distributions are available via <a href="https://build.opensuse.org">openSUSE Build Service</a>:</p>
<ul class="packages">
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Arch_Extra/any/dispcalGUI.pkg.tar.xz">Arch Linux</a> <em>(please see note below)</em></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/CentOS_CentOS-6/noarch/dispcalGUI.rpm">CentOS 6</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/CentOS_CentOS-7/noarch/dispcalGUI.rpm">CentOS 7</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Debian_5.0/all/dispcalGUI.deb">Debian 5 (Lenny)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Debian_6.0/all/dispcalGUI.deb">Debian 6 (Squeezy)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Debian_7.0/all/dispcalGUI.deb">Debian 7 (Wheezy)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_16/noarch/dispcalGUI.rpm">Fedora 16</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_17/noarch/dispcalGUI.rpm">Fedora 17</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_18/noarch/dispcalGUI.rpm">Fedora 18</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_19/noarch/dispcalGUI.rpm">Fedora 19</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_20/noarch/dispcalGUI.rpm">Fedora 20</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2009.1/noarch/dispcalGUI.rpm">Mandriva 2009.1</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2010/noarch/dispcalGUI.rpm">Mandriva 2010</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2010.1/noarch/dispcalGUI.rpm">Mandriva 2010.1</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2011/noarch/dispcalGUI.rpm">Mandriva 2011</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_12.1/noarch/dispcalGUI.rpm">openSUSE 12.1</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_12.2/noarch/dispcalGUI.rpm">openSUSE 12.2</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_12.3/noarch/dispcalGUI.rpm">openSUSE 12.3</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_13.1/noarch/dispcalGUI.rpm">openSUSE 13.1</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_Factory/noarch/dispcalGUI.rpm">openSUSE Factory</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_Tumbleweed/noarch/dispcalGUI.rpm">openSUSE Tumbleweed</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/RedHat_RHEL-6/noarch/dispcalGUI.rpm">RedHat RHEL 6</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/RedHat_RHEL-7/noarch/dispcalGUI.rpm">RedHat RHEL 7</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_10.04/all/dispcalGUI.deb">Ubuntu 10.04 (Lucid)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_10.10/all/dispcalGUI.deb">Ubuntu 10.10 (Maverick)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_11.04/all/dispcalGUI.deb">Ubuntu 11.04 (Natty)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_11.10/all/dispcalGUI.deb">Ubuntu 11.10 (Oneiric)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_12.04/all/dispcalGUI.deb">Ubuntu 12.04 (Precise)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_12.10/all/dispcalGUI.deb">Ubuntu 12.10 (Quantal)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_13.04/all/dispcalGUI.deb">Ubuntu 13.04 (Raring)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_13.10/all/dispcalGUI.deb">Ubuntu 13.10 (Saucy)</a></span>
</li>
<li>
<span></span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_14.04/all/dispcalGUI.deb">Ubuntu 14.04 (Trusty)</a></span>
</li>
</ul>
<div>
<em>Arch Linux note:</em> The zeroinstall-injector 2.6.1 package in AUR is broken. Get a working version here:
</div>
<div>
<a href="http://download.opensuse.org/repositories/home:/fhoech:/0install/Arch_Extra/i686/zeroinstall-injector-2.6.2-1-i686.pkg.tar.xz" title="Zero Install 2.6.2 for Arch Linux (x86)">x86</a> |
<a href="http://download.opensuse.org/repositories/home:/fhoech:/0install/Arch_Extra/x86_64/zeroinstall-injector-2.6.2-1-x86_64.pkg.tar.xz" title="Zero Install 2.6.2 for Arch Linux (x86_64)">x86_64</a>
</div>
<p>Please note:</p>
<ul>
<li><strong>The version number in the package name does not necessarily reflect the dispcalGUI version</strong>.</li>
<li><strong>An official Argyll CMS version from ArgyllCMS.com will be used by default</strong> unless the distribution-packaged version is newer, but you can switch to a distribution-packaged version anytime (see <a href="#zeroinstall-updating">“Updating or switching between software versions”</a> below).</li>
</ul>
<p>Packages made for older distributions may work on newer distributions as long as nothing substantial has changed (i.e. Python version). Also there are several distributions out there that are based on one in the above list (e.g. Linux Mint which is based on Ubuntu). This means that packages for that base distribution should also work on derivatives, you just need to know which version the derivative is based upon and pick your download accordingly. In all other cases, please try the instructions below or one of the <a href="#standalone">standalone installations</a>.</p>
<h4>Alternate installation method</h4>
<p>If your distribution is not listed above, please follow these instructions:</p>
<ol>
<li>Install the <strong>0install</strong> or <strong>zeroinstall-injector</strong> package from your distribution. In case it is not available, there are pre-compiled <a href="http://0install.net/tools/0install.xml">generic binaries</a>. Download the appropriate archive for your system, unpack it, <code>cd</code> to the extracted folder in a terminal, and run <code>sudo ./install.sh local</code> to install to /usr/local, or <code>./install.sh home</code> to install to your home directory (you may have to add ~/bin to your PATH variable in that case). You'll need libcurl installed (most systems have it by default).</li>
<li>Choose the <strong>0install</strong> entry from the applications menu (older versions of Zero Install will have an “Add New Program” entry instead).</li>
<li>Drag <a href="http://dispcalgui.hoech.net/0install/dispcalGUI.xml">dispcalGUI's Zero Install feed</a> link to the Zero Install window.</li>
</ol>
<p>Note on dispcalGUI's standalone tools under Linux (3D LUT maker, curve viewer, profile information, synthetic profile creator, testchart editor, VRML to X3D converter): If using the alternate installation method, an application icon entry will only be created for dispcalGUI itself. This is currently a limitation of Zero Install under Linux. You can manually install icon entries for the standalone tools by running the following in a terminal:</p>
<pre><code>0launch --command=install-standalone-tools-icons \<br /> http://dispcalgui.hoech.net/0install/dispcalGUI.xml</code></pre>
<p>And you may uninstall them again with:</p>
<pre><code>0launch --command=uninstall-standalone-tools-icons \<br /> http://dispcalgui.hoech.net/0install/dispcalGUI.xml</code></pre>
</div>
</li>
<li>
<h3>For Mac OS X (10.5 or newer)</h3>
<div>
<p>Download the <a href="http://dispcalGUI.hoech.net/download/dispcalGUI-0install.dmg">dispcalGUI Zero Install Launcher</a> disk image and run any of the included applications.</p>
</div>
</li>
<li>
<h3>For Windows (XP or newer)</h3>
<div>
<p>Download and install the dispcalGUI Zero Install Setup: <a href="http://dispcalGUI.hoech.net/download/dispcalGUI-0install-Setup.exe">Administrator install</a> | <a href="http://dispcalGUI.hoech.net/download/dispcalGUI-0install-Setup-per-user.exe">Per-user install</a>.</p>
</div>
</li>
<li>
<h3 id="zeroinstall-updating">Manually updating or switching between software versions</h3>
<div>
<p>Updates are normally applied automatically. If you want to manually update or switch between software versions, please follow the instructions below.</p>
<ul>
<li>
<h4>Linux</h4>
<p>Choose the <strong>0install</strong> entry from the applications menu (older versions of Zero Install will have a “Manage Programs” entry instead). In the window that opens, right-click the dispcalGUI icon and select “Choose versions” (with older versions of Zero Install, you have to click the small “Update or change version” icon below the “Run” button instead). You can then click the “Refresh all” button to update, or click the small button to the right of an entry and select “Show versions”.</p>
<p>To select a specific software version, click on the version entry and set the rating to “preferred” (note that this will prevent updates being downloaded for the selected software until you manually change to a different version or reset the rating).</p>
</li>
<li>
<h4>Mac OS X</h4>
<p>Run the <strong>0install Launcher</strong>. In the window that opens, click the “Refresh all” button to update, or click the small button to the right of an entry and select “Show versions”.</p>
<p>To select a specific software version, click on the version entry and set the rating to “preferred” (note that this will prevent updates being downloaded for the selected software until you manually change to a different version or reset the rating).</p>
</li>
<li>
<h4>Windows</h4>
<p>Choose the <strong>Zero Install</strong> entry from the start page under Windows 8, or the respective subfolder of the programs folder in the start menu under Windows 7 and earlier, and switch to the “My Applications” tab in the window that opens. Click the small “down” arrow inside the “Start” button to the right of the dispcalGUI entry and choose “Update” or “Select version”.</p>
<p>To select a specific software version, click on the “change” link next to an item, then click on the version entry and set the rating to “preferred” (note that this will prevent updates being downloaded for the selected software until you manually change to a different version or reset the rating).</p>
</li>
</ul>
</div>
</li>
</ul>
<p>Please continue with the <a href="#quickstart">Quickstart Guide</a>.</p>
<h2 id="standalone">Get dispcalGUI standalone</h2>
<p><em>Please note: <a href="http://argyllcms.com">Argyll CMS</a> is a separate download unless you use a dispcalGUI for Linux native RPM package. I recommend to use the official Argyll CMS binaries from <a href="http://argyllcms.com">argyllcms.com</a>.</em></p>
<ul>
<li>
<h3 id="packages">For Linux</h3>
<div>
<p>Native packages for several distributions are available via <a href="https://build.opensuse.org">openSUSE Build Service</a>:</p>
<ul class="packages">
<li>
<span>Arch Linux</span>
<span><a href="http://dispcalgui.hoech.net/download/Arch_Extra/i686/dispcalGUI.pkg.tar.xz">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Arch_Extra/x86_64/dispcalGUI.pkg.tar.xz">x86_64</a></span>
</li>
<li>
<span>CentOS 6</span>
<span><a href="http://dispcalgui.hoech.net/download/CentOS_CentOS-6/i686/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/CentOS_CentOS-6/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>CentOS 7</span>
<span>
<a href="http://dispcalgui.hoech.net/download/CentOS_CentOS-7/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Debian 5 (Lenny)</span>
<span><a href="http://dispcalgui.hoech.net/download/Debian_5.0/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Debian_5.0/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Debian 6 (Squeezy)</span>
<span><a href="http://dispcalgui.hoech.net/download/Debian_6.0/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Debian_6.0/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Debian 7 (Wheezy)</span>
<span><a href="http://dispcalgui.hoech.net/download/Debian_7.0/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Debian_7.0/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Fedora 16</span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_16/i686/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Fedora_16/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Fedora 17</span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_17/i686/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Fedora_17/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Fedora 18</span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_18/i686/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Fedora_18/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Fedora 19</span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_19/i686/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Fedora_19/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Fedora 20</span>
<span><a href="http://dispcalgui.hoech.net/download/Fedora_20/i686/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Fedora_20/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Mandriva 2009.1</span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2009.1/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Mandriva_2009.1/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Mandriva 2010</span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2010/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Mandriva_2010/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Mandriva 2010.1</span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2010.1/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Mandriva_2010.1/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Mandriva 2011</span>
<span><a href="http://dispcalgui.hoech.net/download/Mandriva_2011/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/Mandriva_2011/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>openSUSE 11.4</span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_11.4/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/openSUSE_11.4/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>openSUSE 12.1</span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_12.1/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/openSUSE_12.1/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>openSUSE 12.2</span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_12.2/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/openSUSE_12.2/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>openSUSE 12.3</span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_12.3/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/openSUSE_12.3/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>openSUSE 13.1</span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_13.1/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/openSUSE_13.1/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>openSUSE Factory</span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_Factory/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/openSUSE_Factory/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>openSUSE Tumbleweed</span>
<span><a href="http://dispcalgui.hoech.net/download/openSUSE_Tumbleweed/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/openSUSE_Tumbleweed/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>RedHat RHEL 6</span>
<span><a href="http://dispcalgui.hoech.net/download/RedHat_RHEL-6/i686/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/RedHat_RHEL-6/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>RedHat RHEL 7</span>
<span>
<a href="http://dispcalgui.hoech.net/download/RedHat_RHEL-7/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>SUSE Linux Enterprise 11</span>
<span><a href="http://dispcalgui.hoech.net/download/SLE_11/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/SLE_11/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>SUSE Linux Enterprise 11 SP1</span>
<span><a href="http://dispcalgui.hoech.net/download/SLE_11_SP1/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/SLE_11_SP1/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>SUSE Linux Enterprise 11 SP2</span>
<span><a href="http://dispcalgui.hoech.net/download/SLE_11_SP2/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/SLE_11_SP2/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>SUSE Linux Enterprise 11 SP3</span>
<span><a href="http://dispcalgui.hoech.net/download/SLE_11_SP3/i586/dispcalGUI.rpm">x86</a> |
<a href="http://dispcalgui.hoech.net/download/SLE_11_SP3/x86_64/dispcalGUI.rpm">x86_64</a></span>
</li>
<li>
<span>Ubuntu 10.04 (Lucid)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_10.04/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_10.04/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 10.10 (Maverick)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_10.10/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_10.10/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 11.04 (Natty)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_11.04/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_11.04/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 11.10 (Oneiric)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_11.10/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_11.10/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 12.04 (Precise)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_12.04/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_12.04/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 12.10 (Quantal)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_12.10/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_12.10/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 13.04 (Raring)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_13.04/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_13.04/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 13.10 (Saucy)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_13.10/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_13.10/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
<li>
<span>Ubuntu 14.04 (Trusty)</span>
<span><a href="http://dispcalgui.hoech.net/download/xUbuntu_14.04/i386/dispcalGUI.deb">x86</a> |
<a href="http://dispcalgui.hoech.net/download/xUbuntu_14.04/amd64/dispcalGUI.deb">x86_64</a></span>
</li>
</ul>
<p>Packages made for older distributions may work on newer distributions as long as nothing substantial has changed (i.e. Python version). Also there are several distributions out there that are based on one in the above list (e.g. Linux Mint which is based on Ubuntu). This means that packages for that base distribution should also work on derivatives, you just need to know which version the derivative is based upon and pick your download accordingly.</p>
<p>In all other cases, you can try this universal install that should work on a multitude of distributions (if you use it, please uninstall any already installed version of dispcalGUI first to avoid file conflicts):</p>
<p><a href="http://dispcalGUI.hoech.net/download/dispcalGUI.package">Autopackage (Python 2.5, 2.6 and 2.7, x86 and x86_64)</a></p>
</div>
</li>
<li>
<h3>For Mac OS X (10.5 or newer)</h3>
<div>
<p>
<a href="http://dispcalGUI.hoech.net/download/standalone/dispcalGUI.dmg">Disk image</a>
</p>
</div>
</li>
<li>
<h3>For Windows (XP or newer)</h3>
<div>
<p>
<a href="http://dispcalGUI.hoech.net/download/standalone/dispcalGUI-Setup.exe">Installer (recommended)</a> or <a href="http://dispcalGUI.hoech.net/download/standalone/dispcalGUI-win32.zip">ZIP archive</a>
</p>
</div>
</li>
<li>
<h3>Source code</h3>
<div>
<p>You need to have a working Python installation and all <a href="#requirements-source">requirements</a>.</p>
<p><a href="http://dispcalGUI.hoech.net/download/dispcalGUI.tar.gz">Source Tarball</a></p>
<p>
Alternatively, if you don't mind trying out development code, <a href="http://sourceforge.net/p/dispcalgui/code/">browse the <acronym title="Subversion">SVN<sup><a href="#definition_SVN">[8]</a></sup></acronym> repository of the latest development version</a> (or do a full checkout using <code>svn checkout svn://svn.code.sf.net/p/dispcalgui/code/trunk dispcalgui</code>). But please note that the development code might contain bugs or not run at all, or only on some platform(s). Use at your own risk.
</p>
</div>
</li>
</ul>
</div>
<div id="quickstart">
<h2>Quickstart guide</h2>
<p>This short guide intends to get you up and running quickly, but if you run into a problem, you should refer to the full <a href="#requirements">prerequisites</a> and <a href="#install">installation</a> sections.</p>
<ol>
<li>
<p><strong>If you use Zero Install you can skip this step.</strong> Download and unpack Argyll CMS: <a href="http://argyllcms.com/downloadlinux.html">Linux</a> | <a href="http://argyllcms.com/downloadmac.html">Mac OS X</a> | <a href="http://argyllcms.com/downloadwin.html">Windows</a>. Put the extracted directory (Argyll_VX.X.X) in a convenient place on your harddisk.</p>
</li>
<li>
<p>Launch dispcalGUI. If it cannot determine the path to the Argyll CMS binaries, it will prompt you to select the location manually on first launch.</p>
</li>
<li>
<p class="info"><strong>Windows only:</strong> If your measurement device is <strong>not</strong> a ColorMunki Display, i1 Display Pro, Huey or ColorHug, you need to install an Argyll-specific driver before continuing. Select “Install Argyll CMS instrument drivers...” from the “Tools” menu. See also <a href="#install-windows-driver">“Instrument driver installation under Windows”.</a></p>
<p class="info"><strong>Mac OS X only:</strong> If you want to use the HCFR colorimeter, follow the instructions in the “HCFR Colorimeter” section under “<a href="http://argyllcms.com/doc/Installing_OSX.html">Installing Argyll CMS on Mac OS X</a>” in the Argyll CMS documentation before continuing.</p>
<p>Connect your measurement device to your computer.</p>
</li>
<li>
<p>Click the small icon with the swirling arrows <img src="theme/refresh_lr.png" alt="" /> in between the “Display device” and “Instrument” controls to detect connected display devices and instruments. The detected instrument(s) should show up in the “Instrument” dropdown.</p>
<p class="info"><strong>If your measurement device is a Spyder 2</strong>, a popup dialog will show which will let you enable the device. This is required to be able to use the Spyder 2 with Argyll CMS and dispcalGUI.</p>
<p class="info"><strong>If your measurement device is a i1 Display 2, i1 Display Pro, ColorMunki Display, DTP94, Spyder 2, Spyder 3 or Spyder 4</strong>, a popup dialog will show and allow you to import generic <a href="#colorimeter-corrections">colorimeter corrections</a> from the vendor software which may help measurement accuracy on the type of display you're using. After importing, they are available under the “Correction” dropdown, where you can choose one that fits the type of display you have, or leave it at “Auto” if there is no match. <em>Note:</em> Importing from the Spyder 4 software enables additional measurement modes for that instrument.</p>
</li>
<li>
<p>Refer to the <a href="#concept">documentation</a> for <a href="#usage">usage instructions</a>.</p>
<p class="info"><em>Linux only:</em> If you cannot access your instrument, first try unplugging and reconnecting it, or a reboot. If that doesn't help, read “<a href="http://argyllcms.com/doc/Installing_Linux.html">Installing Argyll CMS on Linux: Setting up instrument access</a>”.</p>
</li>
</ol>
</div>
<div id="requirements">
<h2>System requirements and other prerequisites</h2>
<div>
<h3>General system requirements</h3>
<ul>
<li>A recent Linux, Mac OS X (10.5 or newer) or Windows (XP/Server 2003 or newer) operating system.</li>
<li>A graphics card with at least 24 bits per pixel (true color) support and the desktop set up to use this color depth.</li>
</ul>
</div>
<div id="argyll">
<h3>Argyll CMS</h3>
<p>To use dispcalGUI, you need to download and install <a href="http://argyllcms.com">Argyll CMS</a> (1.0 or newer).</p>
</div>
<div id="instruments">
<h3>Supported instruments</h3>
<p>You need one of the supported instruments to make measurements. All instruments supported by Argyll CMS are also supported by dispcalGUI. For display readings, these currently are:</p>
<h4>Colorimeters</h4>
<ul>
<li>Calman X2 (treated as i1 Display 2)</li>
<li>Datacolor/ColorVision Spyder 2</li>
<li>Datacolor Spyder 3 (since Argyll CMS 1.1.0)</li>
<li>Datacolor Spyder 4 (since Argyll CMS 1.3.6)</li>
<li>HP Advanced Profiling Solution (treated as i1 Display 2)</li>
<li>HP DreamColor (treated as i1 Display 2)</li>
<li>Hughski ColorHug (experimental only, does not work reliably on all platforms, especially on Mac OS X. Linux support since Argyll CMS 1.3.6, Windows support with newest ColorHug firmware since Argyll CMS 1.5.0)</li>
<li>Klein K10-A (new in Argyll CMS 1.7.0 beta)</li>
<li>Lacie Blue Eye (treated as i1 Display 2)</li>
<li>Sequel Imaging MonacoOPTIX (treated as i1 Display 1)</li>
<li>X-Rite ColorMunki Create (treated as i1 Display 2)</li>
<li>X-Rite ColorMunki Smile (since Argyll CMS 1.5.0)</li>
<li>X-Rite DTP92</li>
<li>X-Rite DTP94</li>
<li>X-Rite/GretagMacbeth/Pantone Huey</li>
<li>X-Rite/GretagMacbeth i1 Display 1</li>
<li>X-Rite/GretagMacbeth i1 Display 2/LT</li>
<li>X-Rite i1 Display Pro, ColorMunki Display (since Argyll CMS 1.3.4)</li>
</ul>
<h4>Spectrometers</h4>
<ul>
<li>JETI specbos 1211/1201 (since Argyll CMS 1.6.0 beta)</li>
<li>X-Rite ColorMunki Design, ColorMunki Photo (since Argyll CMS 1.1.0)</li>
<li>X-Rite/GretagMacbeth i1 Monitor (since Argyll CMS 1.0.3)</li>
<li>X-Rite/GretagMacbeth i1 Pro</li>
<li>X-Rite i1 Pro 2 (since Argyll CMS 1.5.0)</li>
<li>X-Rite/GretagMacbeth Spectrolino</li>
</ul>
<p>Note that the <em>i1 Display Pro</em> and <em>i1 Pro</em> are very different instruments despite their naming similarities.</p>
<p>Also there are currently (2014-05-20) five instruments (or rather, packages) under the ColorMunki brand, two of which are spectrometers, and three are colorimeters (not all of them being recent offerings, but you should be able to find them used in case they are no longer sold new):</p>
<ul>
<li>The <em>ColorMunki Design</em> and <em>ColorMunki Photo</em> spectrometers differ only in the functionality of the bundled vendor software. There are no differences between the instruments when used with Argyll CMS and dispcalGUI.</li>
<li>The <em>ColorMunki Display</em> colorimeter is a less expensive version of the i1 Display Pro colorimeter. It comes bundled with a simpler vendor software and has longer measurement times compared to the i1 Display Pro. Apart from that, the instrument appears to be virtually identical.</li>
<li>The <em>ColorMunki Create</em> and <em>ColorMunki Smile</em> colorimeters are similar hardware as the i1 Display 2 (with the ColorMunki Smile no longer having a built-in correction for CRT but for white LED backlit LCD instead).</li>
</ul>
</div>
<div id="requirements-unattended">
<h3>Additional requirements for unattended calibration and profiling</h3>
<p>When using a spectrometer that is supported by the unattended feature (see below), having to take the instrument off the screen to do a sensor self-calibration again after display calibration before starting the measurements for profiling may be avoided if the menu item “Allow skipping of spectrometer self-calibration” in the “Options” menu is checked (colorimeter measurements are always unattended because they generally do not require a sensor calibration away from the screen, with the exception of the i1 Display 1).</p>
<p>Unattended calibration and profiling currently supports the following spectrometers in addition to most colorimeters:</p>
<ul>
<li>X-Rite ColorMunki</li>
<li>X-Rite/GretagMacbeth i1 Monitor & Pro</li>
<li>X-Rite/GretagMacbeth Spectrolino</li>
<li>X-Rite i1 Pro 2</li>
</ul>
<p>Be aware you may still be forced to do a sensor calibration if the instrument requires it. Also, please look at the possible <a href="#issue-samplereadfail">caveats</a>.</p>
</div>
<div id="requirements-source">
<div id="requirements-source-basic">
<h3>Additional requirements for using the source code</h3>
<div>
<p>You can <a href="#install">skip</a> this section if you downloaded a package, installer, ZIP archive or disk image of dispcalGUI for your operating system and do not want to run from source.</p>
<h4>All platforms:</h4>
<ul>
<li><a href="http://python.org/">Python</a> >= v2.5 <= v2.7.x (2.7.x is the recommended version. Mac OS X users: If you want to compile dispcalGUI's C extension module, it is advisable to <strong>first</strong> install XCode and <strong>then</strong> the official python.org Python)</li>
<li><a href="http://numpy.scipy.org/">NumPy</a></li>
<li><a href="http://wxpython.org/">wxPython</a> <acronym title="Graphical User Interface">GUI<sup><a href="#definition_GUI">[4]</a></sup></acronym> toolkit</li>
</ul>
<h4>Windows:</h4>
<ul>
<li><a href="http://sourceforge.net/projects/pywin32/">pywin32</a></li>
<li><a href="http://pypi.python.org/pypi/WMI/">WMI</a></li>
</ul>
</div>
</div>
<div id="requirements-source-compile">
<h3>Additional requirements for compiling the C extension module</h3>
<div>
<p>Normally you can <a href="#install">skip</a> this section as the source code contains pre-compiled versions of the C extension module that dispcalGUI uses.</p>
<h4>Linux:</h4>
<ul>
<li>GCC and development headers for Python + X11 + Xrandr + Xinerama + Xxf86vm if not already installed, they should be available through your distribution's packaging system</li>
</ul>
<h4>Mac OS X:</h4>
<ul>
<li><a href="http://developer.apple.com/xcode/">XCode</a></li>
<li><a href="http://pypi.python.org/pypi/py2app/">py2app</a> if you want to build a standalone executable (on Mac OS X before 10.5, install setuptools first: <code>sudo python util/ez_setup.py setuptools</code>)</li>
</ul>
<h4>Windows:</h4>
<ul>
<li>a C-compiler (e.g. <a href="http://www.microsoft.com/germany/Express/product/visualcplusplusexpress.aspx">MS Visual C++ Express</a> or <a href="http://www.mingw.org">MinGW</a>. If you're using the official python.org Python 2.6 or later I'd recommend Visual C++ Express as it works out of the box)</li>
<li><a href="http://pypi.python.org/pypi/py2exe/">py2exe</a> if you want to build a standalone executable</li>
</ul>
</div>
</div>
<div id="requirements-source-run">
<h3 id="runsource">Running directly from source</h3>
<div>
<p>After satisfying all <a href="#requirements-source">additional requirements for using the source code</a>, you can simply run any of the included <code>.pyw</code> files from a terminal, e.g. <code>python2 dispcalGUI.pyw</code>, or install the software so you can access it via your desktop's application menu with <code>python2 setup.py install</code>. Run <code>python2 setup.py --help</code> to view available options.</p>
<p>One-time setup instructions for source code checked out from SVN:</p>
<p>Run <code>python2 setup.py</code> to create the version file so you don't see the update popup at launch.</p>
<p>If the pre-compiled extension module that is included in the sources does not work for you (in that case you'll notice that the movable measurement window's size does not closely match the size of the borderless window generated by Argyll CMS during display measurements) or you want to re-build it unconditionally, run <code>python2 setup.py build_ext -i</code> to re-build it from scratch (you need to satisfy the <a href="#requirements-source-compile">requirements for compiling the C extension module</a> first).</p>
</div>
</div>
</div>
</div>
<div id="install">
<h2>Installation</h2>
<p>It is recommended to first remove all previous versions unless you used Zero Install to get them.</p>
<div id="install-windows-driver">
<h3>Instrument driver installation under Windows</h3>
<div>
<p class="info">You only need to install the Argyll-specific driver if your measurement device is <strong>not</strong> a ColorMunki Display, i1 Display Pro, Huey or ColorHug.</p>
<div class="info">If you are using Windows 8, you need to <strong>disable driver signature enforcement</strong> before you can install the driver:
<ol>
<li>Go to “Settings” (hover the lower right corner of the screen, then click the gear icon).</li>
<li>Select “Power” (the on/off icon).</li>
<li>Hold the SHIFT key down and click “Restart”.</li>
<li>Select “Troubleshoot → “Advanced Options” → “Startup Settings” → “Restart”.</li>
<li>After reboot, select “Disable Driver Signature Enforcement” (number 7 on the list).</li>
</ol></div>
<p>To install the Argyll-specific driver that is needed to use some instruments, launch dispcalGUI and select “Install Argyll CMS instrument drivers...” from the “Tools” menu.</p>
<p>To switch between the Argyll CMS and vendor drivers, launch Windows' Device Manager and locate the instrument in the device list. It may be underneath one of the top level items.
Right click on the instrument and select “Update Driver Software...”, then choose “Browse my computer for driver software”, “Let me pick from a list of device drivers on my computer” and finally select the Argyll driver for your instrument from the list.</p>
</div>
</div>
<div id="install-deb-rpm">
<h3>Linux package (.deb/.rpm)</h3>
<div>
<p>A lot of distributions allow easy installation of packages via the graphical desktop, i.e. by double-clicking the package file's icon. Please consult your distribution's documentation if you are unsure how to install packages.</p>
<p class="info">If you cannot access your instrument, first try unplugging and reconnecting it, or a reboot. If that doesn't help, read “<a href="http://argyllcms.com/doc/Installing_Linux.html">Installing Argyll CMS on Linux: Setting up instrument access</a>”.</p>
</div>
</div>
<div id="install-autopackage">
<h3>Linux Autopackage (.package)</h3>
<div>
<p>Before installing the autopackage, first install wxPython (on some systems called python-wxGTK or python-wxWidgets) and NumPy using your system's package management software. To install the autopackage, follow these three steps (you only have to do it once, next time, you can just skip these steps and open the .package file directly):</p>
<ol>
<li>Click on the package with your right mouse button. Then click on the “Properties” menu item.</li>
<li>Go to the “Permissions” tab.
<ul>
<li>Check the “Execute”, “Exec” or “Is Executable” checkbox. If there are more than one Execute/Exec checkboxes, check the top-most one.</li>
<li>Click “Close” or “OK”, depending on the dialog.</li>
</ul>
</li>
<li>If you already have the software installed from your distributions packages or from the source, remove it first. Then <em>open</em> the package file. If you are asked whether you want to display or run the package, choose “Run”.</li>
</ol>
<p>The installation will now begin. Follow further intructions that are displayed, if any.</p>
<p class="info">If you cannot access your instrument, first try unplugging and reconnecting it, or a reboot. If that doesn't help, read “<a href="http://argyllcms.com/doc/Installing_Linux.html">Installing Argyll CMS on Linux: Setting up instrument access</a>”.</p>
</div>
</div>
<div id="install-mac">
<h3>Mac OS X</h3>
<div>
<p>Mount the disk image and option-drag its icon to your “Applications” folder. Afterwards open the “dispcalGUI” folder in your “Applications” folder and drag dispcalGUI's icon to the dock if you want easy access.</p>
<p class="info">If you want to use the HCFR colorimeter under Mac OS X, follow the instructions under “<a href="http://argyllcms.com/doc/Installing_OSX.html">installing Argyll CMS on Mac OS X</a>” in the Argyll CMS documentation.</p>
</div>
</div>
<div id="install-windows-setup">
<h3>Windows (Installer)</h3>
<div>
<p>Launch the installer which will guide you trough the required setup steps.</p>
<p class="info">If your measurement device is <strong>not</strong> a ColorMunki Display, i1 Display Pro, Huey or ColorHug, you need to install an Argyll-specific driver. <a href="#install-windows-driver">See “Instrument driver installation under Windows”.</a></p>
</div>
</div>
<div id="install-windows-zip">
<h3>Windows (ZIP archive)</h3>
<div>
<p>Unpack and then simply run dispcalGUI from the created folder.</p>
<p class="info">If your measurement device is <strong>not</strong> a ColorMunki Display, i1 Display Pro, Huey or ColorHug, you need to install an Argyll-specific driver. <a href="#install-windows-driver">See “Instrument driver installation under Windows”.</a></p>
</div>
</div>
<div id="install-src">
<h3>Source code (all platforms)</h3>
<div>
<p>See the “Prerequisites” section to <a href="#runsource">run directly from source</a>.</p>
<p>Starting with dispcalGUI 0.2.5b, you can use standard distutils/setuptools commands with setup.py to build, install, and create packages. <code>sudo python setup.py install</code> will compile the extension modules and do a standard installation. Run <code>python setup.py --help</code> or <code>python setup.py --help-commands</code> for more information. A few additional commands and options which are not part of distutils or setuptools (and thus do not appear in the help) are also available:</p>
<h4>Additional setup commands</h4>
<div class="info">
<dl>
<dt><code>0install</code></dt>
<dd>Create/update 0install feeds and create Mac OS X application bundles to run those feeds.</dd>
<dt><code>appdata</code></dt>
<dd>Create/update <a href="http://people.freedesktop.org/~hughsient/appdata/">AppData</a> file.</dd>
<dt><code>bdist_appdmg</code> (Mac OS X only)</dt>
<dd>Creates a DMG of previously created (by the py2app or bdist_standalone commands) application bundles, or if used together with the <code>0install</code> command.</dd>
<dt><code>bdist_deb</code> (Linux/Debian-based)</dt>
<dd>Create an installable Debian (.deb) package, much like the standard distutils command bdist_rpm for RPM packages. Prerequisites:
You first need to install alien and rpmdb, create a dummy RPM database via <code>sudo rpmdb --initdb</code>, then edit (or create from scratch) the setup.cfg (you can have a look at misc/setup.ubuntu9.cfg for a working example). Under Ubuntu, running utils/dist_ubuntu.sh will automatically use the correct setup.cfg. If you are using Ubuntu 11.04 or any other debian-based distribution which has Python 2.7 as default, you need to edit /usr/lib/python2.7/distutils/command/bdist_rpm.py, and change the line <code>install_cmd = ('%s install <span style="color: #c00">-O1</span> --root=$RPM_BUILD_ROOT '</code> to <code>install_cmd = ('%s install --root=$RPM_BUILD_ROOT '</code> by removing the <code><span style="color: #c00">-O1</span></code> flag. Also, you need to change /usr/lib/rpm/brp-compress to do nothing (e.g. change the file contents to <code>exit 0</code>, but don't forget to create a backup copy first) otherwise you will get errors when building.</dd>
<dt><code>bdist_lipa</code></dt>
<dd>Create a <a href="http://listaller.tenstral.net/">Listaller</a> package.</dd>
<dt><code>bdist_pyi</code></dt>
<dd>An alternative to <code>bdist_standalone</code>, which uses <a href="http://www.pyinstaller.org/">PyInstaller</a> instead of bbfreeze/py2app/py2exe.</dd>
<dt><code>bdist_standalone</code></dt>
<dd>Creates a standalone application that does not require a Python installation. Uses bbfreeze on Linux, py2app on Mac OS X and py2exe on Windows. setup.py will try and automatically download/install these packages for you if they are not yet installed and if not using the --use-distutils switch. Note: On Mac OS X, older versions of py2app (before 0.4) are not able to access files inside python “egg” files (which are basically ZIP-compressed folders). Setuptools, which is needed by py2app, will normally be installed in “egg” form, thus preventing those older py2app versions from accessing its contents. To fix this, you need to remove any installed setuptools-<version>-py<python-version>.egg files from your Python installation's site-packages directory (normally found under <code>/Library/Frameworks/Python.framework/Versions/Current/lib</code>). Then, run <code>sudo python util/ez_setup.py -Z setuptools</code> which will install setuptools unpacked, thus allowing py2app to acces all its files. This is no longer an issue with py2app 0.4 and later.</dd>
<dt><code>buildservice</code></dt>
<dd>Creates control files for openSUSE Build Service (also happens implicitly when invoking <code>sdist</code>).</dd>
<dt><code>finalize_msi</code> (Windows only)</dt>
<dd>Adds icons and start menu shortcuts to the MSI installer previously created with <code>bdist_msi</code>. Successful MSI creation needs a <a href="http://bugs.python.org/file15898/msilib_make_short.diff">patched msilib</a> (<a href="http://bugs.python.org/issue1128">additional</a> <a href="http://bugs.python.org/issue7639">information</a>).</dd>
<dt><code>inno</code> (Windows only)</dt>
<dd>Creates <a href="http://www.jrsoftware.org/isinfo.php">Inno Setup</a> scripts which can be used to compile setup executables for standalone applications generated by the <code>py2exe</code> or <code>bdist_standalone</code> commands and for 0install.</dd>
<dt><code>purge</code></dt>
<dd>Removes the <code>build</code> and <code>dispcalGUI.egg-info</code> directories including their contents.</dd>
<dt><code>purge_dist</code></dt>
<dd>Removes the <code>dist</code> directory and its contents.</dd>
<dt><code>readme</code></dt>
<dd>Creates README.html by parsing misc/README.template.html and substituting placeholders like date and version numbers.</dd>
<dt><code>uninstall</code></dt>
<dd>Uninstalls the package. You can specify the same options as for the <code>install</code> command.</dd>
</dl>
</div>
<h4>Additional setup options</h4>
<div class="info">
<dl>
<dt><code>--cfg=<name></code></dt>
<dd>Use an alternate setup.cfg, e.g. tailored for a given Linux distribution. The original setup.cfg is backed up and restored afterwards. The alternate file must exist as misc/setup.<name>.cfg</dd>
<dt><code>-n</code>, <code>--dry-run</code></dt>
<dd>Don't actually do anything. Useful in combination with the uninstall command to see which files would be removed.</dd>
<dt><code>--skip-instrument-configuration-files</code></dt>
<dd>Skip installation of udev rules and hotplug scripts.</dd>
<dt><code>--skip-postinstall</code></dt>
<dd>Skip post-installation on Linux (an entry in the desktop menu will still be created, but may not become visible until logging out and back in or rebooting) and Windows (no shortcuts in the start menu will be created at all).</dd>
<dt><code>-stability=stable|testing|developer|buggy|insecure</code></dt>
<dd>Set the stability for the implementation that is added/updated via the <code>0install</code> command.</dd>
<dt><code>--use-distutils</code></dt>
<dd>Force setup to use distutils (default) instead of setuptools. This is useful in combination with the bdist* commands, because it will avoid an artificial dependency on setuptools. This is actually a switch, use it once and the choice is remembered until you specify the <code>--use-setuptools</code> switch (see next paragraph).</dd>
<dt><code>--use-setuptools</code></dt>
<dd>Force setup to try and use setuptools instead of distutils. This is actually a switch, use it once and the choice is remembered until you specify the <code>--use-distutils</code> switch (see above).</dd>
</dl>
</div>
</div>
</div>
</div>
<div id="install-2">
<h3>Instrument-specific setup</h3>
<p><strong>If your measurement device is a i1 Display 2, i1 Display Pro, ColorMunki Display, DTP94, Spyder 2, Spyder 3 or Spyder 4</strong>, you'll want to import the colorimeter corrections that are part of the vendor software packages, which can be used to better match the instrument to a particular type of display. <em>Note:</em> The full range of measurement modes for the Spyder 4 are also only available if they are imported from the Spyder 4 software.</p>
<p>Choose “Import colorimeter corrections from other display profiling software...” from dispcalGUI's “Tools” menu.</p>
<p><strong>If your measurement device is a Spyder 2</strong>, you need to enable it to be able to use it with Argyll CMS and dispcalGUI. Choose “Enable Spyder 2 colorimeter...” from dispcalGUI's “Tools” menu.</p>
</div>
<div id="concept">
<h2>Basic concept of display calibration and profiling</h2>
<p>If you have previous experience, <a href="#colorimeter-corrections">skip ahead</a>. If you are new to display
calibration, here is a quick outline of the basic concept.</p>
<p>First, the display behavior is measured and adjusted to meet
user-definable target characteristics, like brightness, gamma and white point.
This step is generally referred to as <em>calibration</em>. Calibration is done by
adjusting the monitor controls, and the output of the graphics card (via
<em>calibration curves</em>, also sometimes called <em>video <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> curves</em>—please don't confuse these with <em>LUT profiles</em>, the <a href="#difference_lutcurves_lutprofile" title="Difference between LUT (calibration) curves and LUT profiles">differences are explained here</a>) to get as
close as possible to the chosen target.<br />
To meet the user-defined target characteristics, it is generally advisable to
get as far as possible by using the monitor controls, and only thereafter by
manipulating the output of the video card via calibration curves, which are loaded into the <em>video card gamma table</em>, to get the best
results.</p>
<p>Second, the calibrated displays response is measured and an <acronym title="International Color Consortium">ICC<sup><a href="#definition_ICC">[5]</a></sup></acronym> profile
describing it is created.</p>
<p>Optionally and for convenience purposes, the calibration is stored in the profile, but both
still need to be used together to get correct results. This can lead to some ambiguity,
because loading the calibration curves from the profile is generally the
responsibility of a third party utility or the OS, while applications using
the profile to do color transforms usually don't know or care about the calibration (they don't need to). Currently, the only OS that
applies calibration curves out-of-the-box is Mac OS X (under <a href="#issue-win7-autoloadcalibration">Windows 7 you can enable it</a>, but it's off by default)—for other OS's, dispcalGUI takes care of creating an appropriate loader.</p>
<p>Even non-color-managed applications will benefit from a loaded
calibration because it is stored in the graphics card—it is “global”. But the calibration alone will not yield accurate colors—only fully color-managed applications will make use of display
profiles and the necessary color transforms.</p>
<p>Regrettably there are several image viewing and editing applications that
only implement half-baked color management by not using the system's display profile (or any display profile at all), but an internal and often unchangeable “default”
color space like sRGB, and sending output unaltered to the display after converting to that default colorspace. If the
display's actual response is close to sRGB, you might get pleasing (albeit not
accurate) results, but on displays which behave differently, for example wide-color-gamut displays, even mundane colors can
get a strong tendency towards neon.</p>
</div>
<div id="colorimeter-corrections">
<h2>A note about colorimeters, displays and dispcalGUI</h2>
<p>Colorimeters need a correction in hardware or software to obtain correct measurements from different types of displays (please also see <a href="http://argyllcms.com/doc/WideGamutColmters.html">“Wide Gamut Displays and Colorimeters”</a> on the Argyll CMS website for more information). The latter is supported when using Argyll CMS >= 1.3.0, so if you own a display and colorimeter which has not been specifically tuned for this display (i.e. does not contain a correction in hardware), you can apply a correction that has been calculated from spectrometer measurements to help better measure such a screen.<br />
You need a spectrometer in the first place to do the necessary measurements to create such a correction, or you may query dispcalGUI's <a href="http://dispcalgui.hoech.net/colorimetercorrections">Colorimeter Corrections Database</a>, and there's also a <a href="http://argyllcms.com/doc/ccmxs.html">list of contributed colorimeter correction files on the Argyll CMS website</a>—<strong>please note</strong> though that a matrix created for one particular instrument/display combination may not work well for different instances of the same combination because of generally low inter-instrument agreement of most older colorimeters (with the exception of the DTP94), newer devices like the i1 Display Pro/ColorMunki Display and possibly the Spyder 4 seem to be less affected by this.<br />
Starting with dispcalGUI 0.6.8, you can also <a href="#import-correction-matrices">import generic corrections</a> from some profiling softwares by choosing the corresponding item in the “Tools” menu.</p>
<p>If you buy a screen bundled with a colorimeter, the instrument may have been matched to the screen in some way already, so you may not need a software correction in that case.</p>
<h3>Special note about the X-Rite i1 Display Pro, ColorMunki Display and Spyder 4 colorimeters</h3>
<p>These instruments greatly reduce the amount of work needed to match them to a display because they contain the spectral sensitivities of their filters in hardware, so only a spectrometer reading of the display is needed to create the correction (in contrast to matching other colorimeters to a display, which needs two readings: One with a spectrometer and one with the colorimeter).<br />
That means anyone with a particular screen and a spectrometer can create a special <em>Colorimeter Calibration Spectral Set</em> (<code>.ccss</code>) file of that screen for use with those colorimeters, without needing to actually have access to the colorimeter itself.</p>
</div>
<div id="usage">
<h2>Usage</h2>
<p>Through the main window, you can choose your settings. When running calibration measurements, another window will guide you through the interactive part of display adjustment.</p>
<div id="settingsfile">
<h3>Settings file</h3>
<p>Here, you can load a preset, or a calibration (<code>.cal</code>) or ICC profile (<code>.icc</code> / <code>.icm</code>) file from a previous
run. This will set options to
those stored in the file. If the file contains only a subset of settings, the other options will be reset to defaults.</p>
<p>If a calibration file or profile is loaded in this way, its name will
show up here to indicate that the settings reflect those in the file.
Also, if a calibration is present it can be used as the base when “Just Profiling”.<br />
The chosen settings file will stay selected as long as you do not change any of the
calibration or profiling settings, with one exception: When a <code>.cal</code> file with the same base name as the settings file
exists in the same directory, adjusting the quality and profiling controls will not cause unloading of the settings file. This allows you to use an existing calibration with new profiling settings for “Just Profiling”, or to update an existing calibration with different quality and/or profiling settings. If you change settings in other situations, the file will get unloaded (but current settings will be retained—unloading just happens to remind you that the settings no longer match those in the file), and current display profile's calibration curves will be restored (if present, otherwise they will reset to linear).</p>
<p>When a calibration file is selected, the “Update calibration”
checkbox will become available, which takes less time than a calibration from scratch.
If a <acronym title="International Color Consortium">ICC<sup><a href="#definition_ICC">[5]</a></sup></acronym> profile is selected, and a calibration file with the same base name
exists in the same directory, the profile will be updated with the new calibration. Ticking the “Update calibration” checkbox will gray out
all options as well as the “Calibrate & profile” and “Just profile” buttons, only the quality level will be changeable.</p>
</div>
<div id="presets">
<h3>Predefined settings (presets)</h3>
<p>Starting with dispcalGUI v0.2.5b, predefined settings for several use cases are selectable in the settings dropdown. I strongly recommend to NOT view these presets as the solitary “correct” settings you absolutely should use unmodified if your use case matches their description. Rather view them as starting points, from where you can work towards your own, optimized (in terms of your requirements, hardware, surroundings, and personal preference) settings.</p>
<h4>Why has a default gamma of 2.2 been chosen for some presets?</h4>
<p>Many displays, be it CRT, LCD, Plasma or OLED, have a default response characteristic close to a gamma of approx. 2.2-2.4 (for CRTs, this is the actual native behaviour; and other technologies typically try to mimic CRTs). A target response curve for calibration that is reasonably close to the native response of a display should help to minimize calibration artifacts like banding, because the adjustments needed to the video card's gamma tables via calibration curves will not be as strong as if a target response farther away from the display's native response had been chosen.</p>
<p>Of course, you can and should change the calibration response curve to a value suitable for your own requirements. For example, you might have a display that offers hardware calibration or gamma controls, that has been internally calibrated/adjusted to a different response curve, or your display's response is simply not close to a gamma of 2.2 for other reasons. You can run “Report on uncalibrated display device” from the “Tools” menu to measure the approximated overall gamma among other info.</p>
</div>
<div id="display_instrument">
<h3>Choosing the display to calibrate and the measurement device</h3>
<p>After connecting the instrument, click the small icon with the swirling arrows <img src="theme/refresh_lr.png" alt="" /> in between the “Display device” and “Instrument” controls to detect connected display devices and instruments.</p>
<h4 id="settings_measurement_modes">Choosing a measurement mode</h4>
<p>Some instruments may support different measurement modes for different types of display devices. In general, there are three base measurement modes: “LCD”, “Refresh” (e.g. CRT and Plasma are refresh-type displays) and “Projector” (the latter is only available if supported by the instrument). Some instruments like the Spyder 4 and ColorHug support additional measurement modes, where a mode is coupled with a predefined colorimeter correction (in that case, the <a href="#settings_colorimeter_correction">colorimeter correction</a> dropdown will automatically hide).<br />
Variations of these measurement modes may be available depending on the instrument: “Adaptive” measurement mode for spectrometers uses varying integration times (always used by colorimeters) to increase accuracy of dark readings. “HiRes” turns on high resolution spectral mode for spectrometers like the i1 Pro, which may increase the accuracy of measurements.</p>
<h4 id="settings_drift_compensation">Drift compensation during measurements (only available if using Argyll CMS >= 1.3.0)</h4>
<p>White level drift compensation tries to counter luminance changes of a warming up display device. For this purpose, a white test patch is measured periodically, which increases the overall time needed for measurements.</p>
<p>Black level drift compensation tries to counter measurement deviations caused by black calibration drift of a warming up measurement device. For this purpose, a black test patch is measured periodically, which increases the overall time needed for measurements. Many colorimeters are temperature stabilised, in which case black level drift compensation should not be needed, but spectrometers like the i1 Pro or ColorMunki Design/Photo are not temperature compensated.</p>
<h4 id="settings_colorimeter_correction">Choosing a colorimeter correction for a particular display</h4>
<p>This can improve a colorimeters accuracy for a particular type of display, please also see <a href="#colorimeter-corrections">“A note about colorimeters, displays and dispcalGUI”</a>. You can import generic matrices from some other display profiling softwares as well as check the online <a href="http://dispcalgui.hoech.net/colorimetercorrections/">Colorimeter Corrections Database</a> for a match of your display/instrument combination (click the small globe next to the correction dropdown). A <a href="http://argyllcms.com/doc/ccmxs.html">list of contributed correction matrices</a> can also be found on the Argyll CMS website.</p>
<p>Please note this option is only available if using Argyll CMS >= 1.3.0 and a colorimeter.</p>
</div>
<div id="settings_calibration">
<h3>Calibration settings</h3>
<dl>
<dt>Interactive display adjustment</dt>
<dd>Turning this off skips straight to calibration or profiling measurements instead of giving you the opportunity to alter the display's controls first. You will normally want to keep this checked, to be able to use the controls to get closer to the chosen target characteristics.</dd>
<dt id="settings_calibration_white_point">White point</dt>
<dd>
<p>Allows setting the target white point locus to the equivalent of a daylight or black body spectrum of the given temperature in degrees Kelvin, or as chromaticity co-ordinates. By default the white point target will be the native white of the display, and it's color temperature and delta E to the daylight spectrum locus will be shown during monitor adjustment, and adjustments will be recommended to put the display white point directly on the Daylight locus. If a daylight color temperature is given, then this will become the target of the adjustment, and the recommended adjustments will be those needed to make the monitor white point meet the target. Typical values might be 5000 for matching printed output, or 6500, which gives a brighter, bluer look. A white point temperature different to that native to the display may limit the maximum brightness possible.</p>
<p>If you want to find out the current uncalibrated whitepoint of your display, you can run “Report on uncalibrated display device” from the “Tools” menu to measure it.</p>
<p>If you want to adjust the whitepoint to the chromaticities of your ambient lighting, or those of a viewing booth as used in prepress and photography, and your measurement device has ambient measuring capability (e.g. like the i1 Pro or i1 Display with their respective ambient measurement heads), you can use the “Measure” button next to the whitepoint settings. If you want to measure ambient lighting, place the instrument upwards, beside the display. Or if you want to measure a viewing booth, put a metamerism-free gray card inside the booth and point the instrument towards it. Further instructions how to measure ambient may be available in your instrument's documentation.</p>
</dd>
<dt id="settings_calibration_white_level">White level</dt>
<dd>
<p>Set the target brightness of white in cd/m<sup>2</sup>. If this number cannot be reached, the brightest output possible is chosen, consistent with matching the white point target. Note that many of the instruments are not particularly accurate when assessing the absolute display brightness in cd/m<sup>2</sup>. NOTE that some LCD screens behave a little strangely near their absolute white point, and may therefore exhibit odd behavior at values just below white. It may be advisable in such cases to set a brightness slightly less than the maximum such a display is capable of.</p>
<p>If you want to find out the current uncalibrated white level of your display, you can run “Report on uncalibrated display device” from the “Tools” menu to measure it.</p>
</dd>
<dt id="settings_calibration_black_level">Black level</dt>
<dd>
<p>(To see this setting, go into the “Options” menu, and enable “Show advanced calibration options”)</p>
<p>Can be used to set the target brightness of black in cd/m<sup>2</sup> and is useful for e.g. matching two different screens with different native blacks to one another, by measuring the black levels on both (i.e. in the “Tools” menu, choose “Report on uncalibrated display”) and then entering the highest measured value. Normally you may want to use native black level though, to maximize contrast ratio. Setting too high a value may also give strange results as it interacts with trying to achieve the target “advertised” tone curve shape. Using a black output offset of 100% tries to minimize such problems.</p>
</dd>
<dt id="trc">Tone curve / gamma</dt>
<dd>
<p>The target response curve is normally an exponential curve (output = input<sup>gamma</sup>), and defaults to 2.2 (which is close to a typical CRT displays real response). Four pre-defined curves can be used as well: the sRGB colorspace response curve, which is an exponent curve with a straight segment at the dark end and an overall response of approximately gamma 2.2, the L* curve, which is the response of the CIE L*a*b* perceptual colorspace, the Rec. 709 video standard response curve and the SMPTE 240M video standard response curve.</p>
<p>Note that a real display can't reproduce any of these ideal curves, since it will have a non-zero black point, whereas all the ideal curves assume zero light at zero input.</p>
<p>For gamma values, you can also specify wheter it should be interpreted relative, meaning the gamma value provided is used to set an actual response curve in light of the non-zero black of the actual display that has the same relative output at 50% input as the ideal gamma power curve, or absolute, which allows the actual power to be specified instead, meaning that after the actual displays non-zero black is accounted for, the response at 50% input will probably not match that of the ideal power curve with that gamma value (to see this setting, you have to go into the “Options” menu, and enable “Show advanced calibration options”).</p>
<p>To allow for the non-zero black level of a real display, by default the target curve values will be offset so that zero input gives the actual black level of the display (output offset). This ensures that the target curve better corresponds to the typical natural behavior of displays, but it may not be the most visually even progression from display minimum. This behavior can be changed using the black output offset option (see further below).</p>
<p>Also note that many color spaces are encoded with, and labelled as having a gamma of approximately 2.2 (ie. sRGB, REC 709, SMPTE 240M, Macintosh OS X 10.6), but are actually intended to be displayed on a display with a typical CRT gamma of 2.4 viewed in a darkened environment.<br />
This is because this 2.2 gamma is a source gamma encoding in bright viewing conditions such as a television studio, while typical display viewing conditions are quite dark by comparison, and a contrast expansion of (approx.) gamma 1.1 is desirable to make the images look as intended.<br />
So if you are displaying images encoded to the sRGB standard, or displaying video through the calibration, just setting the gamma curve to sRGB or REC 709 (respectively) is probably not what you want! What you probably want to do, is to set the gamma curve to about gamma 2.4, so that the contrast range is expanded appropriately, or alternatively use sRGB or REC 709 or a gamma of 2.2 but also specify the actual ambient viewing conditions via a light level in Lux, so that an appropriate contrast enhancement can be made during calibration. If your instrument is capable of measuring ambient light levels, then you can do so.<br />
<span class="footnote">(For in-depth technical information about sRGB, see “<a href="http://www.color.org/sRGB.xalter">A Standard Default Color Space for the Internet: sRGB</a>” at the <acronym title="International Color Consortium">ICC<sup><a href="#definition_ICC">[5]</a></sup></acronym> website for details of how it is intended to be used)</span></p>
<p>If you're wondering what gamma value you should use, you can run “Report on uncalibrated display device” from the “Tools” menu to measure the approximated overall gamma among other info. Setting the gamma to the reported value can then help to reduce calibration artifacts like banding, because the adjustments needed for the video card's gamma table should not be as strong as if a gamma further away from the display's native response was chosen.</p>
</dd>
<dt id="ambient">Ambient light level</dt>
<dd>
<p>(To see this setting, go into the “Options” menu, and enable “Show advanced calibration options”)</p>
<p>As explained for the tone curve settings, often colors are encoded in a situation with viewing conditions that are quite different to the viewing conditions of a typical display, with the expectation that this difference in viewing conditions will be allowed for in the way the display is calibrated. The ambient light level option is a way of doing this. By default calibration will not make any allowances for viewing conditions, but will calibrate to the specified response curve, but if the ambient light level is entered or measured, an appropriate viewing conditions adjustment will be performed. For a gamma value or sRGB, the original viewing conditions will be assumed to be that of the sRGB standard viewing conditions, while for REC 709 and SMPTE 240M they will be assumed to be television studio viewing conditions.<br />
By specifying or measuring the ambient lighting for your display, a viewing conditions adjustment based on the CIECAM02 color appearance model will be made for the brightness of your display and the contrast it makes with your ambient light levels.</p>
<p>Please note your measurement device needs ambient measuring capability (e.g. like the i1 Pro or i1 Display with their respective ambient measurement heads) to measure the ambient light level.</p>
</dd>
<dt id="settings_calibration_black_output_offset">Black output offset</dt>
<dd>
<p>(To see this setting, go into the “Options” menu, and enable “Show advanced calibration options”)</p>
<p>Real displays do not have a zero black response, while all the target response curves do, so this has to be allowed for in some way.</p>
<p>The default way of handling this (equivalent to 100% black output offset) is to allow for this at the output of the ideal response curve, by offsetting and scaling the output values. This defined a curve that will match the responses that many other systems provide and may be a better match to the natural response of the display, but will give a less visually even response from black.</p>
<p>The other alternative is to offset and scale the input values into the ideal response curve so that zero input gives the actual non-zero display response. This ensures the most visually even progression from display minimum, but might be hard to achieve since it is different to the natural response of a display.</p>
<p>A subtlety is to provide a split between how much of the offset is accounted for as input to the ideal response curve, and how much is accounted for at the output, where the degree is 0.0 accounts for it all as input offset, and 100% accounts for all of it as output offset.</p>
</dd>
<dt id="settings_calibration_black_point_correction">Black point correction</dt>
<dd>
<p>(To see this setting, go into the “Options” menu, and enable “Show advanced calibration options”)</p>
<p>Normally dispcal will attempt to make all colors down the neutral axis (R=G=B) have the same hue as the chosen white point. Near the black point, red, green or blue can only be added, not subtracted from zero, so the process of making the near black colors have the desired hue, will lighten them to some extent. For a device with a good contrast ratio or a black point that has nearly the same hue as the white, this is not a problem. If the device contrast ratio is not so good, and the black hue is noticeably different to that of the chosen white point (which is often the case for LCD type displays), this could have a noticeably detrimental effect on an already limited contrast ratio. Here the amount of black point hue correction can be controlled.<br />
By default a factor of 100% will be used, which is usually good for “Refresh”-type displays like CRT or Plasma and also by default a factor of 0% is used for LCD type displays, but you can override these with a custom value between 0% (no correction) to 100% (full correction), or enable automatically setting it based on the measured black level of the display.</p>
<p>If less than full correction is chosen, then the resulting calibration curves will have the target white point down most of the curve, but will then cross over to the native or compromise black point.</p>
</dd>
<dt id="settings_calibration_black_point_correction_rate">Black point correction rate (only available if using Argyll CMS >= 1.0.4)</dt>
<dd>
<p>(To see this setting, go into the “Options” menu, and enable “Show advanced calibration options”)</p>
<p>If the black point is not being set completely to the same hue as the white point (ie. because the factor is less than 100%), then the resulting calibration curves will have the target white point down most of the curve, but will then blend over to the native or compromise black point that is blacker, but not of the right hue. The rate of this blend can be controlled. The default value is 4.0, which results in a target that switches from the white point target to the black, moderately close to the black point. While this typically gives a good visual result with the target neutral hue being maintained to the point where the crossover to the black hue is not visible, it may be asking too much of some displays (typically LCD type displays), and there may be some visual effects due to inconsistent color with viewing angle. For this situation a smaller value may give a better visual result (e.g. try values of 3.0 or 2.0. A value of 1.0 will set a pure linear blend from white point to black point). If there is too much coloration near black, try a larger value, e.g. 6.0 or 8.0.</p>
</dd>
<dt id="settings_calibration_quality">Calibration speed</dt>
<dd>
<p>(This setting will not apply and be hidden when the tone curve is set to “As measured”)</p>
<p>Determines how much time and effort to go to in calibrating the display. The lower the speed, the more test readings will be done, the more refinement passes will be done, the tighter will be the accuracy tolerance, and the more detailed will be the calibration of the display. The result will ultimately be limited by the accuracy of the instrument, the repeatability of the display and instrument, and the resolution of the video card gamma table entries and digital or analogue output (RAMDAC).</p>
</dd>
</dl>
</div>
<div id="settings_profiling">
<h3>Profiling settings</h3>
<dl>
<dt>Profile quality</dt>
<dd>Sets the level of effort and/or detail in the resulting profile. For table based profiles (<acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym>), it sets the main lookup table size, and hence quality in the resulting profile. For matrix profiles it sets the per channel curve detail level and fitting “effort”.</dd>
<dt id="settings_profiling_profile_type">Profile type</dt>
<dd>
<p>Generally you can differentiate between two types of profiles: <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> based and matrix based.</p>
<p>Matrix based profiles are smaller in filesize, somewhat less accurate (though in most cases smoother) compared to <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> based types, and usually have the best compatibility across <acronym title="Color Mangement Module">CMM<sup><a href="#definition_CMM">[2]</a></sup></acronym>s, applications and systems — but only support the colorimetric intent for color transforms. For matrix based profiles, the <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym> is always XYZ. You can choose between using individual curves for each channel (red, green and blue), a single curve for all channels, individual gamma values for each channel or a single gamma for all channels. Curves are more accurate than gamma values. A single curve or gamma can be used if individual curves or gamma values degrade the gray balance of an otherwise good calibration.</p>
<p><acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> based profiles are larger in filesize, more accurate (but may sacrifice smoothness), in some cases less compatible (applications might not be able to use or show bugs/quirks with <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> type profiles, or certain variations of them).
When choosing a <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> based profile type, advanced gamut mapping options become available which you can use to create perceptual and/or saturation tables inside the profile in addition to the default colorimetric tables which are always created.<br />
L*a*b* or XYZ can be used as <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>, with XYZ being recommended especially for wide-gamut displays bacause their primaries might exceed the <acronym title="International Color Consortium">ICC<sup><a href="#definition_ICC">[5]</a></sup></acronym> L*a*b* encoding range (Note: Under Windows, XYZ <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> types are only available in dispcalGUI if using Argyll CMS >= 1.1.0 because of a requirement for matrix tags in the profile, which are not created by prior Argyll CMS versions).<br />
As it is hard to verify if the <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> of an combined XYZ <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> + matrix profile is actually used, you may choose to create a profile with a swapped matrix (which I'd recommend), ie. blue-red-green instead of red-green-blue, so it will be obvious if an application uses the (deliberately wrong) matrix instead of the (correct) LUT because the colors will look very wrong (e.g. everything that should be red will be blue, green will be red, blue will be green, yellow will be purple etc).</p>
<p id="difference_lutcurves_lutprofile">Note: <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym>-based profiles (which contain three-dimensional LUTs) might be confused with video card <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> (calibration) curves (one-dimensional LUTs), but they're two different things. Both <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym>-based and matrix-based profiles may include calibration curves which can be loaded into a video card's gamma table hardware.</p>
</dd>
<dt id="settings_profiling_gamutmapping">Advanced gamut mapping options</dt>
<dd>
<p>You can choose any of the following options after selecting a LUT profile type and clicking “Advanced...”. <em>Note:</em> The options “Low quality <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device tables” and “Enhance effective resolution of colorimetric <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device table” are mutually exclusive.</p>
<h4>Low quality <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device tables</h4>
<p>Choose this option if the profile is only going to be used with inverse device-to-<acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym> gamut mapping to create a DeviceLink or 3D LUT (dispcalGUI always uses inverse device-to-<acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym> gamut mapping when creating a DeviceLink/3D LUT). This will reduce the processing time needed to create the <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device tables. <strong>Don't</strong> choose this option if you want to install or otherwise use the profile.</p>
<h4>Enhance effective resolution of colorimetric <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device table</h4>
<p>To use this option, you have to select a XYZ LUT profile type. This option increases the effective resolution of the <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym> to device colorimetric color lookup table by using a matrix to fill the whole grid with the values obtained by inverting the device-to-<acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym> table, as well as optionally applies smoothing. If no <a href="#settings_profiling_gamutmapping_ciecam02">CIECAM02 gamut mapping</a> has been enabled for the perceptual intent, a simple but effective perceptual table (which is almost identical to the colorimetric table, but maps the black point to zero) will also be generated.</p>
<p>You can also set the interpolated lookup table size. The default 33x33x33 resulution will provide a good balance between smoothness and accuracy. Lowering the resolution can increase smoothness (at the potential expense of some accuracy), while increasing resolution may make the resulting profile potentially more accurate (at the expense of some smoothness). Note that computation will need a lot of memory (>= 4 GB of RAM recommended to prevent swapping to harddisk) especially at higher resolutions.</p>
<p>See below example images for the result you can expect, where the original image has been converted from sRGB to the display profile. Note though that the particular synthetic image chosen, a “granger rainbow”, exaggerates banding, real-world material is much less likely to show this. Also note that the sRGB blue in the image is actually out of gamut for the specific display used, and the edges visible in the blue gradient for the rendering are a result of the color being out of gamut, and the gamut mapping thus hitting the less smooth gamut boundaries.</p>
<div style="overflow: hidden; padding: 1.4em 0;">
<div style="text-align: center;">
<p><a rel="lightbox-set-smooth_b2a" href="http://dispcalGUI.hoech.net/img/GrangerRainbow.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow.thumb.png" alt="Original Granger Rainbow image" style="box-shadow: 0px 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>Original “granger rainbow” image</p>
</div>
<div style="float: left; margin: 0 15px 0 22px; width: 200px">
<p><a rel="lightbox-set-smooth_b2a" href="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_colorimetric_default.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_colorimetric_default.thumb.png" alt="Granger Rainbow - default colorimetric rendering" style="box-shadow: 0 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>Default colorimetric rendering <span style="white-space: nowrap">(2500 OFPS XYZ LUT profile)</span></p>
</div>
<div style="float: left; margin: 0 15px; width: 200px">
<p><a rel="lightbox-set-smooth_b2a" href="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_colorimetric.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_colorimetric.thumb.png" alt="Granger Rainbow - “smooth” colorimetric rendering" style="box-shadow: 0 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>“Smooth” colorimetric rendering <span style="white-space: nowrap">(2500 OFPS XYZ LUT profile</span>, inverted A2B)</p>
</div>
<div style="float: left; margin: 0 15px; width: 200px">
<p><a rel="lightbox-set-smooth_b2a" href="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_perceptual.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_perceptual.thumb.png" alt="Granger Rainbow - “smooth” perceptual rendering" style="box-shadow: 0 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>“Smooth” perceptual rendering <span style="white-space: nowrap">(2500 OFPS XYZ LUT profile</span>, inverted A2B)</p>
</div>
</div>
<h4>Default rendering intent for profile</h4>
<p>Sets the default rendering intent. In theory applications could use this, in practice they don't, so changing this setting probably won't have any effect whatsoever.</p>
<h4 id="settings_profiling_gamutmapping_ciecam02">CIECAM02 gamut mapping</h4>
<p>Normally, profiles created by dispcalGUI only incorporate the colorimetric rendering intent, which means colors outside the display's gamut will be clipped to the next in-gamut color. LUT-type profiles can also have gamut mapping by implementing perceptual and/or saturation rendering intents. You can choose if and which of those you want by specifying a source profile and marking the appropriate checkboxes. Note that a input, output, display or device colororspace profile should be specified as source, not a non-device colorspace, device link, abstract or named color profile. You can also choose viewing conditions which describe the intended use of both the source and the display profile that is to be generated. An appropriate source viewing condition is chosen automatically based on the source profile type.</p>
<p>For more information on why a source gamut is needed, see “<a href="http://argyllcms.com/doc/iccgamutmapping.html">About ICC profiles and Gamut Mapping</a>” in the Argyll CMS documentation.</p>
<p>One strategy for getting the best perceptual results with display profiles is as follows: Select a CMYK profile as source for gamut mapping. Then, when converting from another RGB profile to the display profile, use relative colorimetric intent, and if converting from a CMYK profile, use the perceptual intent.<br />
Another approach which especially helps limited-gamut displays is to choose one of the larger (gamut-wise) source profiles you usually work with for gamut mapping, and then always use perceptual intent when converting to the display profile.</p>
<p>Please note that not all applications support setting a rendering intent for display profiles and might default to colorimetric (e.g. Photoshop normally uses relative colorimetric with black point compensation, but can use different intents via custom soft proofing settings).</p>
</dd>
<dt id="settings_profiling_bpc">Black point compensation</dt>
<dd>
<p>(Note: This option has no effect if just calibrating and creating a simple curves + matrix profile directly from the calibration data without additional profiling measurements)</p>
<p>This effectively prevents black crush when using the profile, but at the expense of accuracy. It is generally best to only use this option with a curves + matrix profile type. For LUT profiles, more sophisticated options exist (i.e. <a href="#settings_profiling_gamutmapping">advanced gamut mapping options</a> and enable either “Enhance effective resolution of colorimetric <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device tables” or “Gamut mapping for perceptual intent”, which can be used to create a perceptual table that maps the black point).</p>
</dd>
<dt id="testchart_file">Testchart file</dt>
<dd>You can choose the test patches used when profiling the display here. The default ones are automatically chosen based on profile quality and type, but you can also use and create your own using the built-in testchart editor (click on the colored patches next to the testchart file selector or choose “Edit testchart...” from the “File” menu to launch it).</dd>
<dt id="testchart_editor">Testchart editor</dt>
<dd>
<p>The provided default testcharts should work well in most situations, but allowing you to create custom charts ensures maximum flexibility when characterizing a display and can improve profiling accuracy and efficiency. See also <a href="#optimizecharts">optimizing testcharts</a>.</p>
<h4>Testchart generation options</h4>
<p>You can enter the amount of patches to be generated for each patch type (white, black, gray, single channel, iterative and multidimensional cube steps). The iterative algorythm can be tuned if more than zero patches are to be generated. What follows is a quick description of the several available iterative algorythms, with “device space” meaning in this case RGB coordinates, and “perceptual space” meaning the (assumed) XYZ numbers of those RGB coordinates. The assumed XYZ numbers can be influenced by providing a previous profile, thus allowing optimized test point placement.</p>
<ul>
<li>Optimized Farthest Point Sampling (OFPS) will optimize the point locations to minimize the distance from any point in device space to the nearest sample point</li>
<li>Incremental Far Point Distribution incrementally searches for test points that are as far away as possible from any existing points</li>
<li>Device space random chooses test points with an even random distribution in device space</li>
<li>Perceptual space random chooses test points with an even random distribution in perceptual space</li>
<li>Device space filling quasi-random chooses test points with a quasi-random, space filling distribution in device space</li>
<li>Perceptual space filling quasi-random chooses test points with a quasi-random, space filling distribution in perceptual space</li>
<li>Device space body centered cubic grid chooses test points with body centered cubic distribution in device space</li>
<li>Perceptual space body centered cubic grid chooses test points with body centered cubic distribution in perceptual space</li>
</ul>
<p>You can set the degree of adaptation to the known device characteristics used by the default full spread OFPS algorithm. A preconditioning profile should be provided if adaptation is set above a low level. By default the adaptation is 10% (low), and should be set to 100% (maximum) if a profile is provided. But, if for instance, the preconditioning profile doesn't represent the device behavior very well, a lower adaption than 100% might be appropriate.</p>
<p>For the body centered grid distributions, the angle parameter sets the overall angle that the grid distribution has.</p>
<p>The “Gamma” parameter sets a power-like (to avoid the excessive compression that a real power function would apply) value applied to all of the device values after they are generated. A value greater than 1.0 will cause a tighter spacing of test values near device value 0.0, while a value less than 1.0 will cause a tighter spacing near device value 1.0. Note that the device model used to create the expected patch values will not take into account the applied power, nor will the more complex full spread algorithms correctly take into account the power.</p>
<p>The neutral axis emphasis parameter allows changing the degree to which the patch distribution should emphasise the neutral axis. Since the neutral axis is regarded as the most visually critical area of the color space, it can help maximize the quality of the resulting profile to place more measurement patches in this region. This emphasis is only effective for perceptual patch distributions, and for the default OFPS distribution if the adaptation parameter is set to a high value. It is also most effective when a preconditioning profile is provided, since this is the only way that neutral can be determined. The default value of 50% provides an effect about twice the emphasis of the CIE94 Delta E formula.</p>
<p>The dark region emphasis parameter allows changing the degree to which the patch distribution should emphasis dark region of the device response. Display devices used for video or film reproduction are typically viewed in dark viewing environments with no strong white reference, and typically employ a range of brightness levels in different scenes. This often means that the devices dark region response is of particular importance, so increasing the relative number of sample points in the dark region may improve the balance of accuracy of the resulting profile for video or film reproduction. This emphasis is only effective for perceptual patch distributions where a preconditioning profile is provided. The default value of 0% provides no emphasis of the dark regions. A value somewhere around 15% - 30% is a good place to start for video profile use. A scaled down version of this parameter will be passed on to the profiler. Note that increasing the proportion of dark patches will typically lengthen the time that an instrument takes to read the whole chart. Emphasizing the dark region characterization will reduce the accuracy of measuring and modelling the lighter regions, given a fixed number of test points and profile quality/grid resolution. The parameter will also be used in an analogous way to the “Gamma” value in changing the distribution of single channel, grayscale and multidimensional steps.</p>
<p>The “Limit samples to sphere” option is used to define an L*a*b* sphere to filter the test points through. Only test points within the sphere (defined by it's center and radius) will be in the generated testchart. This can be good for targeting supplemental test points at a troublesome area of a device. The accuracy of the L*a*b* target will be best when a reasonably accurate preconditioning profile for the device is chosen. Note that the actual number of points generated can be hard to predict, and will depend on the type of generation used. If the OFPS, device and perceptual space random and device space filling quasi-random methods are used, then the target number of points will be achieved. All other means of generating points will generate a smaller number of test points than expected. For this reason, the device space filling quasi-random method is probably the easiest to use.</p>
<h4>Generating diagnostic 3D views of testcharts</h4>
<p>You can generate 3D views in several formats. The default HTML format should be viewable in a modern WebGL-enabled browser. You can choose the colorspace(s) you want to view the results in and also control wether to use RGB black offset (which will lighten up dark colors so they are better visible) and wether you want white to be neutral. All of these options are purely visual and will not influence the actual test patches.</p>
<h4>Other functions</h4>
<p>If generating any number of iterative patches as well as single channel, gray or multidimensional patches, you can add the single channel, gray and multidimensional patches in a separate step by holding the shift key while clicking on “Create testchart”. This prevents those patches affecting the iterative patch distribution, with the drawback of making the patch distribution less even. This is an experimental feature.</p>
<p>You are also able to:</p>
<ul>
<li>Export patches as TIFF or PNG files, and set how often each patch should be repeated after you click the “Export” button (black patches will be repeated according to the “Max” value, and white patches according to the “Min” value, and patches in between according to their lightness in L* scaled to a value between “Min” and “Max”).</li>
<li>Add saturation sweeps which are often used in a video or film context to check color saturation. A preconditioning profile needs to be used to enable this.</li>
<li>Add reference patches from measurement files in CGATS format, from named color ICC profiles, or by analyzing TIFF, JPEG or PNG images. A preconditioning profile needs to be used to enable this.</li>
<li>Sort patches by various color criteria (warning: this will interfere with the Argyll CMS 1.6.0 or newer patch order
optimisation which minimizes measurement times, so manual sorting should only be used for visual inspection of testcharts, or if required to optimize the patch order for untethered measurements in automatic mode where it is useful to maximize the lightness difference from patch to patch so the automatism has an easier time detecting changes).</li>
</ul>
<h4>Patch editor</h4>
<p>Controls for the spreadsheet-like patch editor are as follows:</p>
<ul>
<li>To select patches, click and drag the mouse over table cells, or hold SHIFT (select range) or CTRL/CMD (add/remove single cells/rows to/from selection)</li>
<li>To add a patch below an existing one, double-click a row label</li>
<li>To delete patches, select them, then hold CTRL (Linux, Windows) or CMD (Mac OS X) and hit DEL or BACKSPACE (will always delete whole rows even if only single cells are selected)</li>
<li>CTRL-C/CTRL-V/CTRL-A = copy/paste/select all</li>
</ul>
<p>If you want to insert a certain amount of patches generated in a spreadsheet application (as RGB coordinates in the range 0.0-100.0 per channel), the easiest way to do this is probably to copy the values from the spreadsheet app, entering the testchart editor, generating a corresponding amount of patches and then overwriting them by doing CTRL-A, CTRL-V.</p>
</dd>
<dt>Profile name</dt>
<dd>
<p>As long as you do not enter your own text here, the profile name is auto generated from the chosen calibration and profiling options. The current auto naming mechanism creates quite verbose names which are not necessarily nice to read, but they can help in identifying the profile.<br />
Also note that the profile name is not only used for the resulting profile, but for all intermediate files as well (filename extensions are added automatically) <em>and</em> all files are stored in a folder of that name. You can choose where this folder is created by clicking the disk icon next to the field (it defaults to your system's default location for user data).</p>
<p>Here's an example under Linux, on other platforms some file extensions and the location of the home directory will differ (you can mouse over the filenames to get a tooltip with a short description what the file is for):</p>
<p>Chosen profile save path: <samp title="User home directory">~/.local/share/dispcalGUI/storage</samp></p>
<p>Profile name: <samp>mydisplay</samp></p>
<p>The following folder will be created: <samp>~/.local/share/dispcalGUI/storage/mydisplay</samp></p>
<p>During calibration & profiling the following files will be created:</p>
<p><samp><span title="Log of the generation of the 3D representation of the profile colorspace vs. Adobe RGB (useful for troubleshooting)">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay vs ClayRGB1998.log</span><br />
<span title="3D representation of the profile colorspace vs. Adobe RGB as compressed VRML file">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay vs ClayRGB1998.wrz</span><br />
<span title="Log of the generation of the 3D representation of the profile colorspace vs. sRGB (useful for troubleshooting)">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay vs sRGB.log</span><br />
<span title="3D representation of the profile colorspace vs. sRGB as compressed VRML file">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay vs sRGB.wrz</span><br />
<span title="Contains calibration curves and most settings used for calibration">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay.cal</span><br />
<span title="Gamut of the profile colorspace as compressed CGATS file">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay.gam.gz</span><br />
<span title="The end result, a display profile">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay.icc</span><br />
<span title="Log of the generation of the display profile (useful for troubleshooting)">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay.log</span><br />
<span title="Contains the measurement patches used to create the .ti3 measurement file">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay.ti1</span><br />
<span title="Contains the measured display response">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay.ti3</span><br />
<span title="3D representation of the profile colorspace">~/.local/share/dispcalGUI/storage/mydisplay/mydisplay.wrz</span></samp></p>
<p>Any used colorimeter correction file will also be copied to the profile folder.</p>
</dd>
</dl>
</div>
<div id="calibrating">
<h3>Calibrating / profiling</h3>
<p>If you are unclear about the difference between calibration and profiling (also called characterisation), see “<a href="http://www.argyllcms.com/doc/calvschar.html">Calibration vs. Characterization</a>” in the Argyll CMS documentation.</p>
<p>Please let the screen stabilize for at least half an hour after powering it up before doing any measurements or assessing its color properties. The screen can be used normally with other applications during that time.</p>
<p>After you have set your options, click on one of the three buttons at the bottom
to start the actual calibration/profiling process. The main window will hide during measurements, and should pop up again after they are completed (or after an
error). You can always cancel out of running measurements using the “Cancel” button in the progress dialog, or by pressing ESC or Q. Viewing the informational log window (from the “Tools” menu) after measurements will give you access to the raw output of the Argyll CMS commandline tools and other verbose information.</p>
<h4 id="adjusting">Adjusting a display before calibration</h4>
<p>If you clicked “Calibrate” or “Calibrate & profile” and have not turned off “Interactive display adjustment”, you will be presented with the interactive display adjustment window which contains several options to help you bring a display's characteristics closer to the chosen target values. Depending on wheter you have a “Refresh”- or LCD-type display, I will try to give some recommendations here which options to adjust, and which to skip.</p>
<h5>Adjusting a LCD display</h5>
<p>For LCD displays, you will in most cases only want to adjust white point (if the screen has RGB gain or other whitepoint controls) and white level (with the white level also affecting the black level unless you have a local dimming LED model), as many LCDs lack the necessary “offset” controls to adjust the black point (and even if they happen to have them, they often change the overall color temperature, not only the black point). Also note that for most LCD screens, you should leave the “contrast” control at (factory) default.</p>
<dl>
<dt>White point</dt>
<dd>
If your screen has RGB gain, colortemperature or other whitepoint controls, the first step should be adjusting the whitepoint. Note that you may also benefit from this adjustment if you have set the target whitepoint to “native”, as it will allow you to bring it closer to the daylight or blackbody locus, which can help the human visual system to better adapt to the whitepoint. Look at the bars shown during the measurements to adjust RGB gains and minimize the delta E to the target whitepoint.
</dd>
<dt>White level</dt>
<dd>
Continue with the white level adjustment. If you have set a target white level, you may reduce or increase the brightness of your screen (ideally using only the backlight) until the desired value is reached (i.e. the bar ends at the marked center position). If you haven't set a target, simply adjust the screen to a visually pleasing brightness that doesn't cause eye strain.
</dd>
</dl>
<h5>Adjusting a “Refresh”-type display like CRT or Plasma</h5>
<dl>
<dt>Black level</dt>
<dd>
On “Refresh”-type displays, this adjustment is usually done using the “brightness” control. You may reduce or increase the brightness of your screen until the desired black level is reached (i.e. the bar ends at the marked center position).
</dd>
<dt>White point</dt>
<dd>
The next step should be adjusting the whitepoint, using the display's RGB gain controls or other means of adjusting the whitepoint. Note that you may also benefit from this adjustment if you have set the target whitepoint to “native”, as it will allow you to bring it closer to the daylight or blackbody locus, which can help the human visual system to better adapt to the whitepoint. Look at the bars shown during the measurements to adjust RGB gains and minimize the delta E to the target whitepoint.
</dd>
<dt>White level</dt>
<dd>
Continue with the white level adjustment. On “Refresh”-type displays this is usually done using the “contrast” control. If you have set a target white level, you may reduce or increase contrast until the desired value is reached (i.e. the bar ends at the marked center position). If you haven't set a target, simply adjust the screen to a visually pleasing level that doesn't cause eye strain.
</dd>
<dt>Black point</dt>
<dd>
If your display has RGB offset controls, you can adjust the black point as well, in much the same way that you adjusted the whitepoint.
</dd>
</dl>
<h5>Finishing adjustments and starting calibration/characterisation</h5>
<p>After the adjustments, you can run a check on all the settings by choosing the last option from the left-hand menu to verify the achieved values. If adjusting one setting adversely affected another, you can then simply repeat the respective option as necessary until the target parameters are met.</p>
<p>Finally, select “Continue on to calibration/profiling” to start the non-interactive part. You may want to get a coffee or two as the process can take a fair amount of time, especially if you selected a high quality level. If you only wanted help to adjust the display and don't want/need calibration curves to be created, you can also choose to exit by closing the interactive display adjustment window and then select “Profile only” from the main window.<br />
If you originally selected “Calibrate & profile” and fulfil the requirements for <a href="#requirements-unattended">unattended calibration & profiling</a>, the characterisation measurements for the profiling process should start automatically after calibration is finished. Otherwise, you may be forced to take the instrument off the screen to do a sensor self-calibration before starting the profiling measurements.</p>
<h5 id="optimizecharts">Optimizing testcharts for improved profiling accuracy and efficiency</h5>
<p>A good way to generate a custom testchart to improve profiling is to use one of the default testcharts “optimized for ...” as base, altering the parameters as necessary and desired. Especially the use of an existing display profile to precondition generated test patches for improved profiling performance is recommended. You could go about this in the following way:</p>
<ul>
<li>When calibrating, choose “just calibrate” and the option to create a fast curves + matrix profile.</li>
<li>After calibration, select a testchart to use as base (preferably one of the optimized ones) and bring up the testchart editor.</li>
<li>Next to “Preconditioning profile” click on “current profile”. It should automatically select the curves + matrix profile that was created during calibration. Then place a check in the checkbox. Make sure adaptation is set to a high level (e.g. 100%)</li>
<li>If desired, adjust the number of patches and make sure the iterative patches amount is not zero.</li>
<li>Create the chart and save it. Click “yes” when asked to select the newly generated chart.</li>
<li>Start the profiling measurements (e.g. click “profile only”).</li>
</ul>
<h4>Profile installation</h4>
<p>When installing a profile after creating or updating it, a startup item to load its calibration curves
automatically on login will be created (on Windows and Linux, Mac OS X does not need a loader). You may also prevent this loader from doing anything by removing the check in the “Load calibration curves on Login” checkbox in the profile installation dialog, and in case you are using Windows 7 or later, you may let the operating system handle calibration loading instead (to be able to change this option, you need to run dispcalGUI as administrator).</p>
<h3>Advanced functions</h3>
<h4 id="remote">Remote measurements and profiling</h4>
<p>When using Argyll CMS 1.4.0 and newer, remote measurements on a device not directly connected to the machine that is running dispcalGUI is possible (e.g. a smartphone or tablet). The remote device needs to be able to run a web browser (Firefox recommended), and the local machine running dispcalGUI may need firewall rules added or altered to allow incoming connections. To set up remote profiling, select “Web @ localhost” from the display device dropdown menu, then choose the desired action (e.g. “Profile only”). When the message “Webserver waiting at http://<IP>:<Port>” appears, open the shown address in the remote browser and attach the measurement device.<br />
<strong>NOTE:</strong> If you use this method of displaying test patches, there is no access to the display video <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym>s and hardware calibration is not possible. The colors will be displayed with 8 bit per component precision, and any screen-saver or power-saver will not be automatically disabled. You will also be at the mercy of any color management applied by the web browser, and may have to carefully review and configure such color management.<br />
<strong>NOTE:</strong> Close the web browser window or tab after each run, otherwise reconnection may fail upon further runs.</p>
<h4 id="untethered">Untethered display measurements</h4>
<p>Untethered mode is another option to measure and profile a remote display that is not connected via standard means (calibration is not supported). To use untethered mode, the testchart that should be used needs to be optimized, then exported as image files (via the testchart editor) and those image files need to be displayed on the device that should be measured, in successive order. The procedure is as follows:</p>
<ul>
<li>Select the desired testchart, then open the testchart editor.</li>
<li>Select “Optimize for untethered in auto mode” from the sorting options dropdown, click “Apply”, then export the testchart.</li>
<li>Burn the images to a DVD, copy them on an USB stick or use any other available means to get them to display onto the device that should be measured.</li>
<li>In dispcalGUI's display dropdown, select “Untethered” (the last option).</li>
<li>Show the first image on the remote display, and attach the instrument. Then select “Profile only”.</li>
</ul>
<p>Measurements will commence, and changes in the displayed image should be automatically detected if “auto” mode is enabled. Use whatever means available to you to cycle through the images from first to last, carefully monitoring the measurement process and only changing to the next image if the current one has been successfully measured (as will be shown in the untethered measurement window). Note that untethered mode will be (atleast) twice as slow as normal display measurements.</p>
</div>
</div>
<div id="menu">
<h2>Menu commands</h2>
<div id="menu-file">
<h3>“File” menu</h3>
<dl>
<dt>Load settings...</dt>
<dd>Loads settings from a profile created by dispcalGUI, or a calibration file, as described under “<a href="#settingsfile">settings file</a>”.</dd>
<dt>Choose testchart file...</dt>
<dd>Loads a testchart <code>.ti1</code> file used for profiling (existing profiles created with Argyll CMS or dispcalGUI can also be selected as source).</dd>
<dt>Edit testchart...</dt>
<dd>Opens the testchart editor/creator.</dd>
<dt>Choose save path...</dt>
<dd>Allows you to select a directory to store the files created by dispcalGUI during calibration/profiling and custom measurements.</dd>
<dt>Profile information</dt>
<dd>Show gamut plot, calibration and tone response curves, as well as header and tag information for the current profile.</dd>
<dt>Locate Argyll CMS executables...</dt>
<dd>Normally dispcalGUI will look for and use the Argyll CMS binaries using your system's PATH variable, but you may specify a different location.</dd>
</dl>
</div>
<div id="menu-options">
<h3>“Options” menu</h3>
<dl>
<dt>Measure testchart</dt>
<dd>Measures the currently selected testchart on the selected display in its current state and creates a <code>.ti3</code> measurement data file. The file is saved under the chosen save path (see “Choose save path...” under the “File” menu) and with the same base name used for profiles.</dd>
<dt id="create_profile_from_measurement_data">Create profile from measurement data...</dt>
<dd>Allows you to (re-)create a profile from existing measurement data (existing profiles created with Argyll CMS or dispcalGUI can also be selected as source) with the current profiling settings.</dd>
<dt>Create profile from extended display identification data...</dt>
<dd>Allows you to create a profile from your display's <acronym title="Extended Display Identification Data">EDID<sup><a href="#definition_EDID">[10]</a></sup></acronym> (if available).</dd>
<dt>Install display device profile...</dt>
<dd>Install an existing profile for the currently selected display.</dd>
<dt>Upload profile...</dt>
<dd>Share a profile via the <a href="http://icc.opensuse.org">openSUSE ICC Profile Taxi</a> service. This will only work for profiles created from actual measurements by dispcalGUI 0.8.0.8 and newer, and not for profiles created from EDID.</dd>
<dt>Load calibration curves from calibration file or profile...</dt>
<dd>Unlike “Load settings....” from the “File” menu, loads just calibration curves for the currently selected display into the video card without changing settings.</dd>
<dt>Load calibration curves from current display device profile</dt>
<dd>Tries to determine the profile associated to the currently selected display and loads its calibration curves from the 'vcgt' tag.</dd>
<dt>Reset video card gamma table</dt>
<dd>Resets the video card gamma table for the currently selected display to linear, clearing any calibration curves, such that input = output.</dd>
<dt>Detect displays and instruments</dt>
<dd>To detect changes in display setup or connected instruments, use this menu entry.</dd>
<dt>Automatically detect instruments</dt>
<dd>If this menu item is checked, dispcalGUI will automatically detect instruments on startup and periodically check for changes roughly every 10 seconds after that, if no other operation is currently running.</dd>
<dt>Use separate video card gamma table acccess</dt>
<dd>Because of the difficulty caused by TwinView and MergedFB in X11 based systems, you can optionally specify a separate display for accessing the video card gamma table hardware during calibration. You may be able to calibrate one screen, and then share the calibration with another screen. Profiling can be done independently to calibration on each screen. Normally dispcalGUI will automatically detect if separate video card gamma table access is needed (and appropriate controls need to be displayed), but you may force it by selecting this menu entry.</dd>
<dt>Do not use video card gamma table to apply calibration</dt>
<dd>Calibration will be applied to the test values for each measurement instead of being loaded into the video card gamma table, and also included in measurement data files, so that the profiler can include it as a vcgt tag in the resulting profile. This is <strong>not</strong> normally the best way to profile a calibrated display, since the frame buffer may have lower precision than the video card gamma table. This is the way calibration should be applied if madVR is being used to display the test patches.</dd>
<dt>Allow skipping of spectrometer self-calibration</dt>
<dd>Spectrometers require a sensor calibration before measurements. If this option is checked, dispcalGUI will try to skip the sensor calibration for characterization measurements if they are run directly after display calibration measurements (unattended calibration & profiling). <em>NOTE</em> even if this option is checked, you may be forced to do a sensor calibration if the instrument requires it.</dd>
<dt>Show advanced calibration options</dt>
<dd>Enabling this menu option will show some additional controls for advanced users in the main window.</dd>
<dt id="additional-commandline-arguments">Set additional commandline arguments...</dt>
<dd>
<p>Allows you to set additional options for dispcal, dispread, spotread and colprof in the same way you would specify them on the commandline, as well as override the minimum display update delay (requires Argyll CMS 1.5 or newer) and display settle time multiplier (requires Argyll CMS 1.7 Beta or newer).</p>
<p>Normally a delay of 200 milliseconds is allowed between changing a patch color on a display, and reading the color with an instrument, although some instruments (ie. i1 Display Pro/ColorMunki Display, i1 Pro, ColorMunki Design/Photo) will automatically measure and set an appropriate delay during instrument calibration. In rare situations this delay may not be sufficient (i.e. some TVs with extensive image processing features turned on), and a larger delay can be set, e.g. a 400 milliseconds minimum delay.</p>
<p>The display technology type determines how long is allowed between when a patch color change appears on the display, and when that change has settled down, and as actually complete within measurement tolerance. A CRT or Plasma display for instance, can have quite a long settling delay due to the decay characteristics of the phosphor used, while an LCD can also have a noticeable settling delay due to the liquid crystal response time and any response time enhancement circuitry (instruments without a display technology type selection such as spectrometers assume a worst case).<br />
The display settle time multiplier allows the rise and fall times of the model to be scaled to extend or reduce the settling time. For instance, a value of 2.0 would double the settling time, while a value of 0.5 would halve it.</p>
</dd>
<dt>Enable Argyll CMS diagnostic output</dt>
<dd>When checked, outputs diagnostic information for measurements. Useful for debugging. Warning: Very verbose.</dd>
<dt>Dry run</dt>
<dd>When enabled, all functionality that calls Argyll CMS executables will effectively do nothing. This allows review of the used command line parameters by checking the log.</dd>
<dt>Restore defaults</dt>
<dd>Restores all settings except language, selected display, instrument, measurement mode and profile name to default.</dd>
</dl>
</div>
<div id="menu-tools">
<h3>“Tools” menu</h3>
<dl>
<dt id="report-uncal">Report on uncalibrated display device</dt>
<dd>Does some quick measurements on the currently selected display, first resetting the video card gamma table, and displays information about the measured response like luminance, approx. gamma, color temperature, and video card gamma table bit depth.</dd>
<dt id="report-cal">Report on calibrated display device</dt>
<dd>Does some quick measurements on the currently selected display, keeping the video card gamma table, and displays information about the measured response like luminance, approx. gamma, and color temperature.</dd>
<dt id="verify-cal">Verify calibration</dt>
<dd>Run verify measurements on the selected display as it is currently setup (ie. video card gamma table). This will use the usual input parameters to establish the expected (target) characteristic. Note that if the initial calibration was modified due to it being out of gamut of the display, verify will show the resulting discrepancy.</dd>
<dt id="verify-profile">Measurement report</dt>
<dd><p>Do verification measurements to assess the display chain's (display profile - video card and the calibration curves in its gamma table - monitor) fit to the measured data, or to find out about the soft proofing capabilities of the display chain.</p>
<p>To do the former, you have to select a <acronym title="CGATS.5 Data Exchange Format">CGATS<sup><a href="#definition_CGATS">[1]</a></sup></acronym> testchart file containing device values (RGB). The measured values are then compared to the values obtained by feeding the device RGB numbers through the display profile (measured vs expected values). The default verification chart contains 26 patches and can be used, for example, to check if a display needs to be re-profiled. If a RGB testchart with gray patches (R=G=B) is measured, like the default and extended verification charts, you also have the option to evaluate the graybalance through the calibration only, by placing a check in the corresponding box on the report.</p>
<p>To perform a check on the soft proofing capabilities, you have to provide a CGATS reference file containing XYZ or L*a*b* data, or a combination of simulation profile and testchart file, which will be fed through the display profile to lookup corresponding device (RGB) values, and then be sent to the display and measured. Afterwards, the measured values are compared to the original XYZ or L*a*b* values, which can give a hint how suitable (or unsuitable) the display is for softproofing to the colorspace indicated by the reference.</p>
<p>The target profile that is to be evaluated can be chosen freely. You can quickly set it to the one currently selected in dispcalGUI's main window under “settings” by clicking the “current” button. The report files generated after the verification measurements are plain HTML with some embedded JavaScript, and are fully self-contained. They also contain the reference and measurement data, which consists of device RGB numbers, original measured XYZ values, and D50-adapted L*a*b* values computed from the XYZ numbers, and which can be examined as plain text directly from the report at the click of a button.</p>
<h5>HowTo—Common scenarios</h5>
<p>In all cases, make sure to select the profile you want to evaluate under “target profile” (for evaluating 3D LUTs and DeviceLink profiles, this setting has only significance if a Rec. 1886 or custom gamma tone response curve was applied).</p>
<p>Also there are two sets of verification charts in different sizes, one for general use (verify) and one for Rec. 709 video (verify-video). The “small” and “extended” versions can be used for a quick to moderate check to see if a display should be re-profiled, or if the used profile/3D LUT is any good to begin with. The “large” and “xl” versions can be used for a more thorough check. Also, you can create your own customized verification charts with the testchart editor.</p>
<h6>Checking the accuracy of a display profile (evaluating how well the profile characterizes the display)</h6>
<p>In this case, you want to use a testchart with RGB device values and no simulation profile. Select a suitable file under “testchart or reference” and disable “simulation profile”. Other settings that do not apply in this case will be grayed out.</p>
<h6>Checking how well a display can simulate another colorspace (evaluating softproofing capabilities, 3D LUTs, DeviceLink profiles, or native display performance)</h6>
<p>There are two ways of doing this:</p>
<ul>
<li>Use a reference file with XYZ or L*a*b* aim values,</li>
<li>or use a combination of testchart with RGB or CMYK device values and an RGB or CMYK simulation profile (for an RGB testchart, it will only allow you to use an RGB simulation profile and vice versa, and equally a CMYK testchart needs to be used with a CMYK simulation profile)</li>
</ul>
<p>Then, you have a few options that influence the simulation.</p>
<ul>
<li>
<strong>Whitepoint simulation</strong>. If you are using a reference file that contains device white (100% RGB or 0% CMYK), or if you use a combination of testchart and simulation profile, you can choose if you want whitepoint simulation of the reference or simulation profile, and if so, if you want the whitepoint simulated relative to the target profile whitepoint. To explain the latter option: Let's assume a reference has a whitepoint that is slightly blueish (compared to D50), and a target profile has a whitepoint that is more blueish (compared to D50). If you do <em>not</em> choose to simulate the reference white relative to the target profile whitepoint, and the target profile's gamut is large and accurate enough to accomodate the reference white, then that is exactly what you will get. Depending on the adaptation state of your eyes though, it may be reasonable to assume that you are to a large extent adapted to the target profile whitepoint (assuming it is valid for the device), and the simulated whitepoint will look a little yellowish compared to the target profile whitepoint. In this case, choosing to simulate the whitepoint relative to that of the target profile may give you a better visual match e.g. in a softproofing scenario where you compare to a hardcopy proof under a certain illuminant, that is close to but not quite D50, and the display whitepoint has been matched to that illuminant. It will “add” the simulated whitepoint “on top” of the target profile whitepoint, so in our example the simulated whitepoint will be even more blueish than that of the target profile alone.
</li>
<li>
<strong>Using the simulation profile as target profile</strong> will override the profile set under “taget profile”. Whitepoint simulation does not apply here because color management will not be used and the display device is expected to be in the state described by the simulation profile. This may be accomplished in several ways, for example the display may be calibrated internally or externally, by a 3D LUT or device link profile. If this setting is enabled, a few other options will be available:
<ul>
<li>
<strong>Enable madVR 3D LUT</strong> (if using the madVR display device/madTPG under Windows). This allows you to check how well a madVR 3D LUT transforms the simulation colorspace to the display colorspace. Note this setting can not be used together with a DeviceLink profile.
</li>
<li>
<strong>Apply tone response curve</strong>. If you are evaluating a 3D LUT or DeviceLink profile, choose the same settings here as during 3D LUT/DeviceLink creation (and also make sure the same target profile is set, because it is used to map the blackpoint).
</li>
<li>
<strong>DeviceLink profile</strong>. This allows you to check how well the DeviceLink transforms the simulation colorspace to the display colorspace. Note this setting can not be used together with the “Enable madVR 3D LUT” setting.
</li>
</ul>
</li>
</ul>
<h4>How were the nominal and recommended aim values chosen?</h4>
<p>The nominal tolerances, with the whitepoint, average, maximum and gray balance Delta E CIE 1976 aim values stemming from <a href="http://www.fogra.org/mediawedge/">UGRA/Fogra Media Wedge</a> and <a href="http://www.ugra.ch/ugra-display-analysis-and-certification-tool.phtml">UDACT</a>, are pretty generous, so I've included somewhat stricter “recommended” numbers which I've chosen more or less arbitrarily to provide a bit “extra safety margin”.</p>
<p>For reports generated from reference files that contain CMYK numbers in addition to L*a*b* or XYZ values, you can also select the official Fogra Media Wedge V3 or IDEAlliance Control Strip aim values for paper white, CMYK solids and CMY grey, if the chart contains the right CMYK combinations.</p>
<h4>How are the results of the profile verification report to be interpreted?</h4>
<p>This depends on the chart that was measured. The explanation in the first paragraph sums it up pretty well: If you have calibrated and profiled your display, and want to check how well the profile fits a set of measurements (profile accuracy), or if you want to know if your display has drifted and needs to be re-calibrated/re-profiled, you select a chart containing RGB numbers for the verification. Note that directly after profiling, accuracy can be expected to be high if the profile characterizes the display well, which will usually be the case if the display behaviour is not very non-linear, in which case creating a LUT profile instead of a “Curves + matrix” one, or increasing the number of measured patches for LUT profiles, can help.</p>
<p>If you want to know how well your profile can simulate another colorspace (softproofing), select a reference file containing L*a*b* or XYZ values, like one of the <a href="http://www.fogra.org/mediawedge/">Fogra Media Wedge</a> subsets, or a combination of a simulation profile and testchart. Be warned though, only wide-gamut displays will handle a larger offset printing colorspace like FOGRA39 or similar well enough.</p>
<p>In both cases, you should check that atleast the nominal tolerances are not exceeded. For a bit “extra safety margin”, look at the recommended values instead.</p>
<p>Note that both tests are “closed-loop” and will not tell you an “absolute” truth in terms of “color quality” or “color accuracy” as they may not show if your instrument is faulty/measures wrong (a profile created from repeatable wrong measurements will usually still verify well against other wrong measurements from the same instrument if they don't fluctuate too much) or does not cope with your display well (which is especially true for <a href="#colorimeter-corrections">colorimeters and wide-gamut screens</a>, as such combinations need a <a href="http://argyllcms.com/doc/ccmxs.html" title="List of contributed colorimeter correction files on the Argyll CMS website">correction</a> in hardware or software to obtain accurate results—this problem does not exist with spectrometers, which do not need a correction for wide-gamut, but have lately been discovered to have issues measuring the correct brightness of some LED backlit displays which use white LEDs), or if colors on your screen match an actual colored object next to it (like a print). It is perfectly possible to obtain good verification results but the actual visual performance being sub-par. It is always wise to combine such measurements with a test of the actual visual appearance via a “known good” reference, like a print or proof (although it should not be forgotten that those also have tolerances, and illumination also plays a big role when assessing visual results). Keep all that in mind when admiring (or pulling your hair out over) verification results :)</p>
<h4>How are profiles evaluated against the measured values?</h4>
<p>Different softwares use different methods (which are not always disclosed in detail) to compare and evaluate measurements. This section aims to give interested users a better insight how dispcalGUI's profile verification feature works “under the hood”.</p>
<h5>How is a testchart or reference file used?</h5>
<p>There are currently two slightly different paths depending if a testchart or reference file is used for the verification measurements, as outlined above. In both cases, Argyll's <a href="http://www.argyllcms.com/doc/xicclu.html">xicclu</a> utility is run behind the scenes and the values of the testchart or reference file are fed relative colorimetrically (if no whitepoint simualtion is used) or absolute colorimetrically (if whitepoint simulation is used) through the profile that is tested to obtain corresponding L*a*b* (in the case of RGB testcharts) or device RGB numbers (in the case of XYZ or L*a*b* reference files or a combination of simulation profile and testchart). If a combination of simulation profile and testchart is used as reference, the reference L*a*b* values are calculated by feeding the device numbers from the testchart through the simulation profile absolute colorimetrically if whitepoint simulation is enabled (which will be the default if the simulation profile is a printer profile) and relative colorimetrically if whitepoint simulation is disabled (which will be the default if the simulation profile is a display profile, like most RGB working spaces). Then, the original RGB values from the testchart, or the looked up RGB values for a reference are sent to the display through the calibration curves of the profile that is going to be evaluated. A reference white of D50 (ICC default) and complete chromatic adaption of the viewer to the display's whitepoint is assumed if “simulate whitepoint relative to target profile whitepoint” is used, so the measured XYZ values are adapted to D50 (with the measured whitepoint as source reference white) using the Bradford transform (see <a href="http://brucelindbloom.com/Eqn_ChromAdapt.html">Chromatic Adaption</a> on <a href="http://brucelindbloom.com/">Bruce Lindbloom's website</a> for the formula and matrix that is used by dispcalGUI) or with the adaption matrix from the profile in the case of profiles with 'chad' chromatic adaption tag, and converted to L*a*b*. The L*a*b* values are then compared by the generated dynamic report, with user-selectable critera and ΔE (delta E) formula.</p>
<h5>How is the assumed vs. measured whitepoint ΔE calculated?</h5>
<p>In a report, the correlated color temperature and assumed target whitepoint, as well as the whitepoint ΔE, do warrant some further explanations: The whitepoint ΔE is calculated as difference between the measured whitepoint's and the assumed target whitepoint's normalized XYZ values, which are first converted to L*a*b*. The assumed target whitepoint color temperature shown is simply the rounded correlated color temparature (100K threshold) calculated from the measured XYZ values. The XYZ values for the assumed target whitepoint are obtained by calculating the chromaticity (xy) coordinates of a CIE D (daylight) or blackbody illuminant of that color temperature and converting them to XYZ. You can find all the used formulas on <a href="http://brucelindbloom.com/">Bruce Lindbloom's website</a> and on <a href="http://en.wikipedia.org/wiki/Planckian_locus#Approximation">Wikipedia</a>.</p>
<h5>How is the gray balance “range” evaluated?</h5>
<p>The gray balance “range” uses a combined delta a/delta b absolute deviation (e.g. if max delta a = -0.5 and max delta b = 0.7, the range is 1.2). Because results in the extreme darks can be problematic due to lack of instrument accuracy and other effects like a black point which has a different chromaticity than the whitepoint, the gray balance check in dispcalGUI only takes into account gray patches with a minimum measured luminance of 1% (i.e. if the white luminance = 120 cd/m², then only patches with at least 1.2 cd/m² will be taken into account).</p>
<h5>What does the “Evaluate gray balance through calibration only” checkbox on a report actually do?</h5>
<p>It sets the nominal (target) L* value to the measured L* value and a*=b*=0, so the profile is effectively ignored and only the calibration (if any) will influence the results of the gray balance checks. Note that this option will not make a difference for a “Single curve + matrix” profile, as the single curve effectively already achieves a similar thing (the L* values can be different, but they are ignored for the gray balance checks and only influence the overall result).</p>
</dd>
<dt>Update measurement report...</dt>
<dd>This allows to update an existing report HTML file with the template and functionality from a newer version of dispcalGUI (no measurements involved). It's a handy way to get new or changed comparison features, updated layout and even bugfixes into old reports. A backup copy of the old report with a date extension will automatically be created.</dd>
<dt>Measure display device uniformity...</dt>
<dd>Measure the display at several points to evaluate evenness of illumination and chroma errors. The results are shown after all patches are measured, and include the luminance difference, delta C, which is the chrominance difference, CCT (correlated color temperature), and CDT (closest daylight temperature) or CPT (closest planckian temperature) depending on the selection for the whitepoint locus in the main window. Differences are computed in comparison to the center point, which is used as reference.</dd>
<dt>Check measurement file...</dt>
<dd>This checks a measurement file for suspicious (erroneous) readings. An sRGB-like display is assumed, so this option will not work well if the display response is not so close to sRGB, and may report false positives.</dd>
<dt>Automatically check measurements</dt>
<dd>This automatically checks measurements for suspicious (erroneous) readings. An sRGB-like display is assumed, so this option will not work well if the display response is not so close to sRGB, and may report false positives.</dd>
<dt id="import-correction-matrices">Import colorimeter corrections from other display profiling software...</dt>
<dd>Converts matrices from other softwares to Argyll's CCMX / CCSS formats and adds them to the corresponding dropdown menu. Currently iColor Display, i1 Profiler, ColorMunki Display and Spyder 4 softwares are supported. If they are installed or the CD / disk image is mounted, the correct file(s) can in most cases be imported directly, otherwise they can be downloaded automatically. Please note: The colorimeter corrections imported from Spyder 4 software are only usable with the Spyder 4 and need to be selected in the measurement mode dropdown instead of the colorimeter corrections dropdown.</dd>
<dt id="create-colorimeter-correction">Create colorimeter correction...</dt>
<dd>Allows you to create correction matrices for ordinary colorimeters as well as Colorimeter Calibration Spectral Set files for i1 Display Pro, ColorMunki Display and Spyder 4.
Before you choose this menu option though, you must measure the special Colorimeter Correction testchart with a spectrometer and (in case you want to create an ordinary correction matrix) with the colorimeter. To do this, select the aforementioned chart in the testchart file dropdown, then select “Measure testchart” from the “Options” menu. After you have measured the chart(s), you can select the resulting measurement files for processing into a correction matrix or Colorimeter Calibration Spectral Set file.
</dd>
<dt id="upload-colorimeter-correction">Upload colorimeter correction...</dt>
<dd>Upload a colorimeter correction to the online <a href="http://dispcalgui.hoech.net/colorimetercorrections/">Colorimeter Corrections Database</a> to share it with other users or download it later on another machine.
</dd>
<dt id="synthprofile">Create synthetic ICC profile...</dt>
<dd>Create a synthetic ICC profile by entering XYZ or chromaticity coordinates for R, G, B and white, and by choosing a tone response curve.</dd>
<dt id="create-3dlut">Create 3D LUT...</dt>
<dd>Create display correction 3D LUTs for use in movie post-processing applications that don't have ICC support. Currently supported are Autodesk/Kodak (<code>.3dl</code>), Iridas (<code>.cube</code>), eeColor (<code>.txt</code>), madVR (<code>.3dlut</code>), Pandora (<code>.mga</code>) and Sony Imageworks (<code>.spi3d</code>) formats.</dd>
<dt id="install-argyll-instrument-drivers">Install Argyll CMS instrument drivers... (Windows only)</dt>
<dd>Install the Argyll CMS instrument drivers that are needed by some instruments.</dd>
<dt id="uninstall-argyll-instrument-drivers">Uninstall Argyll CMS instrument drivers... (Windows Vista and newer only)</dt>
<dd>Uninstall the Argyll CMS instrument drivers.</dd>
<dt>Enable Spyder 2 colorimeter...</dt>
<dd>The Spyder 2 instrument cannot function without the presence of the instrument vendors PLD firmware pattern for the device. This firmware is not provided with Argyll CMS nor dispcalGUI, since it has not been made available under a compatible license.<br />
The purchaser of a Spyder 2 instrument should have received a copy of this firmware along with their instrument from the original vendor, as part of the instrument setup files.<br />
On Microsoft Windows or Mac OS X, if the vendors software has been installed on the users machine, the firmware pattern can usually automatically be located from there. If the vendors software have not been installed, or the user does not wish to install it, or no vendors software are available for the users platform (i.e. Linux), then the Spyder 2 installation CDROM will also be searched if present. In case no firmware files are found, the necessary binary can be downloaded automatically.</dd>
<dt id="curveviewer">Show curves</dt>
<dd>Shows/hides the curve viewer, which graphs calibration and profile tone response curves and also shows the percentage and amount of tone values for calibration curves.</dd>
<dt>Show actual calibration curves from video card</dt>
<dd>When this is enabled in the curve viewer window, it will show the actual calibration curves from the video card gamma table instead of showing the curves of the currently active profile. (only available if using Argyll CMS 1.1.0 or newer)</dd>
<dt>Show log window</dt>
<dd>Shows/hides the informational log window.</dd>
<dt>Show log window automatically</dt>
<dd>Shows the log window automatically after actions like measurements or creating a profile.</dd>
</dl>
</div>
<div id="menu-lang">
<h3>“Language” menu</h3>
<p>Allows you to select one of the available localizations.</p>
</div>
</div>
<div id="issues">
<h2>Known issues and solutions</h2>
<ul>
<li><a href="#issue-redgreenswapped">General: Wacky image colors (swapped colors)</a></li>
<li><a href="#issue-samplereadfail">General: Measurements are failing if using the “Allow skipping of spectrometer self-calibration” option and/or highres/adaptive mode</a></li>
<li><a href="#issue-win-madvr">MS Windows/madVR: “The process <dispcal.exe|dispread.exe> has stopped working” / “Calibration / profiling has not been finished”</a></li>
<li><a href="#issue-win-process-startfail">Windows: “The process <dispcal.exe|dispread.exe|coloprof.exe|...> could not be started.”</a></li>
<li><a href="#issue-win-photoshop-monprofdefect">Photoshop: “The monitor profile […] appears to be defective. Please rerun your monitor calibration software.”</a></li>
<li><a href="#issue-win-uac-cal-reset">MS Windows Vista: The calibration gets unloaded when a User Access Control prompt is shown</a></li>
<li><a href="#issue-win-intel-cal-reset">MS Windows with Intel graphics: The Calibration gets unloaded after login/resume/User Access Control prompt</a></li>
<li><a href="#issue-win-user-profile-not-used">MS Windows Vista and 7: The display profile isn't used if it was installed for the current user</a></li>
<li><a href="#issue-win64-driversigenforcement">MS Windows Vista and 7, 64-bit: Driver signature enforcement prevents the installation of unsigned Argyll USB drivers</a></li>
<li><a href="#issue-win7-autoloadcalibration">MS Windows 7: Calibration does not load automatically on login when not using the dispcalGUI Profile Loader</a></li>
<li><a href="#issue-winxp-multidisplay">MS Windows XP, multiple displays: One profile is used by all displays connected to a graphics card</a></li>
<li><a href="#issue-mac-dispcalgui-damaged">Mac OS X: dispcalGUI.app is damaged and can't be opened.</a></li>
<li><a href="#issue-mac-pscursor">Photoshop CS3 (Mac OS X): The brush cursor looks funny (box around brush)</a></li>
<li><a href="#issue-linux-lutaccess">Linux/Windows: No video card gamma table access (“Calibrate only” and “Calibrate & profile” buttons grayed, “Profile only” button available)</a></li>
<li><a href="#issue-linux-libmtp">Linux: Instrument not working correctly/constantly disconnecting (conflict with libmtp)</a></li>
</ul>
<dl>
<dt id="issue-redgreenswapped"><span>General:</span> Wacky image colors (swapped colors)</dt>
<dd><strong>Solution:</strong> This happens when you created a “XYZ LUT + swapped matrix” profile and is a way to alert you that the software you're using does not support XYZ LUT profiles and falls back to the included matrix (which generally means you'd loose accuracy). If you're having this situation only in some applications, creating a “XYZ LUT + matrix” profile will remedy it (but please keep in mind that those applications not supporting XYZ LUT will still fall back to the matrix, so results can be different from applications that support XYZ LUT correctly). If all colormanaged applications you use show swapped colors, you should create a matrix profile instead. Note that you do not have to re-run any measurements: In dispcalGUI, choose a profile type as suggested previously, adjust quality and profile name if you want, then choose “Create profile from measurement data...” in the “Options” menu and select the profile you had the issue with.</dd>
<dt id="issue-samplereadfail"><span>General:</span> Measurements are failing (“Sample read failed”) if using the “Allow skipping of spectrometer self-calibration” option and/or highres/adaptive mode</dt>
<dd><strong>Solution:</strong> Disable either or all of the above options. The problem seems to mainly occur with the ColorMunki.</dd>
<dt id="issue-win-madvr"><span>MS Windows/madVR:</span> “The process <dispcal.exe|dispread.exe> has stopped working” / “Calibration / profiling has not been finished”</dt>
<dd><strong>Solution:</strong> Copy the file madHcNet32.dll from your madVR folder to the Argyll CMS binaries folder (e.g. Argyll_VX.X.X\bin).</dd>
<dt id="issue-win-process-startfail"><span>Windows:</span> “The process <dispcal.exe|dispread.exe|coloprof.exe|...> could not be started.”</dt>
<dd><strong>Solution:</strong> If you downloaded Argyll CMS manually, go to your Argyll_VX.X.X\bin directory, and right-click the exe file from the error message. Select “Properties”, and then if there is a text on the “General” tab under security “This file came from another computer and might be blocked”, click “Unblock”. Sometimes also over-zealous Antivirus or 3rd-party Firewall solutions cause such errors, and you may have to add exceptions for all involved programs (which may include all the Argyll CMS executables and if you're using Zero Install also python.exe which you'll find in a subdirectory under C:\ProgramData\0install.net\implementations) or (temporarily) disable the Antivirus/Firewall.</dd>
<dt id="issue-win-photoshop-monprofdefect"><span>Photoshop:</span> “The monitor profile […] appears to be defective. Please rerun your monitor calibration software.”</dt>
<dd><strong>Solution:</strong> Adobe ACE, Adobe's color conversion engine, contains monitor profile validation functionality which attempts to filter out bad profiles. With XYZ LUT profiles created in Argyll CMS versions up to 1.3.2, the B2A white point mapping is sometimes not particularly accurate, just enough so that ACE will see it as a problem, but in actual use it may only have little impact that the whitepoint is a bit off. So if you get a similar message when launching Photoshop, with the options “Use profile regardless” and “Ignore profile”, you may choose “Use profile regardless” and check visually or with the pipette in Photoshop if the inaccurate whitepoint poses a problem. This issue is fixed in Argyll CMS 1.3.3 and newer. Alternatively, you can create a L*a*b* LUT profile.</dd>
<dt id="issue-win-uac-cal-reset"><span>MS Windows Vista:</span> The calibration gets unloaded when a User Access Control prompt is shown</dt>
<dd><strong>Solution:</strong> (Intel and Intel/AMD hybrid graphics users please see <a href="#issue-win-intel-cal-reset">“The Calibration gets unloaded after login/resume/User Access Control prompt”</a> first) This Windows Vista bug seems to have been fixed under Windows 7, and can be remedied under Vista by either manually reloading calibration, or disabling UAC—but please note that you sacrifice security by doing this. To manually reload the calibration, either open dispcalGUI and select “Load calibration curves from current display profile” in the “Options” menu, or (quicker) open the Windows start menu and select “dispcalGUI Profile Loader” in the “Startup” subfolder. To disable <acronym title="User Access Control">UAC<sup><a href="#definition_UAC">[9]</a></sup></acronym> (not recommended!), open the Windows start menu and enter “msconfig” in the search box. Click on the Tools tab. Select the line “Disable UAC” and click the “Launch” button. Close msconfig. You need to reboot your system for changes to apply.</dd>
<dt id="issue-win-intel-cal-reset"><span>MS Windows with Intel graphics (also Intel/AMD hybrid):</span> The Calibration gets unloaded after login/resume/User Access Control prompt</dt>
<dd><strong>Solution:</strong> The Intel graphics drivers contain several utilities that interfere with correct calibration loading. A workaround is to rename, move or disable (e.g. using a tool like <a href="http://technet.microsoft.com/en-us/sysinternals/bb963902">AutoRuns</a>) the following files:
<pre><code>C:\Windows\system32\igfxtray.exe
C:\Windows\system32\igfxpph.dll
C:\Windows\system32\igfxpers.exe</code></pre></dd>
<dt id="issue-win-user-profile-not-used"><span>MS Windows Vista and 7:</span> The display profile isn't used if it was installed for the current user</dt>
<dd><strong>Solution:</strong> Open the Windows start menu, select “Control Panel”, then “Color Management” (you may have to select “Classic View” under Vista and anything other than “Category View” under Windows 7 to see it). Under the “Devices” tab, select your display device, then tick “Use my settings for this device”.</dd>
<dt id="issue-win64-driversigenforcement"><span>MS Windows Vista and 7, 64-bit:</span> Driver signature enforcement prevents the installation of unsigned Argyll USB drivers</dt>
<dd><strong>Solution:</strong> Please upgrade to Argyll CMS 1.2.0 or later. For prior versions, signing the Argyll drivers or disabling driver signature enforcement altogether on each boot was needed to successfully use the drivers. <strong>Such workarounds are no longer needed with recent versions of Argyll CMS</strong> which include drivers that will work out-of-the-box (if you already have drivers for your measurement device installed, see “Updating Argyll drivers” under “<a href="http://argyllcms.com/doc/Installing_MSWindows.html">Installing Argyll CMS on Microsoft Windows</a>” in the Argyll CMS documentation if you use a prior version of the Argyll drivers, or “Adding Argyll drivers to existing drivers” if you are using vendor drivers).</dd>
<dt id="issue-win7-autoloadcalibration"><span>MS Windows 7:</span> Calibration does not load automatically on login when not using the dispcalGUI Profile Loader</dt>
<dd><strong>Solution:</strong> Open the Windows start menu, select “Control Panel”, then “Color Management” (you may have to select something other than “Category View” to see it). Select the “Advanced” tab, then “Change system defaults...”, and finally tick the “Use Windows display calibration” checkbox. <strong>Note</strong> that the quality of Windows' built-in calibration loading is <strong>inferior</strong> in quality compared to the dispcalGUI profile loader and may introduce inaccuracies and artifacts.</dd>
<dt id="issue-winxp-multidisplay"><span>MS Windows XP, multiple displays:</span> One profile is used by all displays connected to a graphics card</dt>
<dd><strong>Solution:</strong> The underlying issue is that Windows XP assigns color profiles per (logical) graphics card, not per output. Most XP graphics drivers present only one logical card to the OS even if the card itself has multiple outputs. There are several possible solutions to this problem:
<ul>
<li>Use different graphics cards and connect only one display to each (this is probably the preferable solution in terms of ease of use and is least prone to configuration error)</li>
<li>Install and use the <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=1e33dca0-7721-43ca-9174-7f8d429fbb9e">Windows XP color control applet</a></li>
<li>Some graphics cards, like the Matrox Parhelia APV (no longer produced), will expose two logical cards to the OS when using a specific vendor driver (some older ATI drivers also had this feature, but it seems to have been removed from newer ones)</li>
</ul>
</dd>
<dt id="issue-mac-dispcalgui-damaged"><span>Mac OS X:</span> dispcalGUI.app is damaged and can't be opened.</dt>
<dd><strong>Solution:</strong> Go to the “Security & Privacy” settings in System Preferences and set “Allow applications downloaded from” (under the “General” tab) to the “Anywhere” setting. After you have successfully launched dispcalGUI, you can change the setting back to a more secure option and dispcalGUI will continue to run properly.</dd>
<dt id="issue-mac-pscursor"><span>Photoshop CS3 (Mac OS X):</span> Under Mac OS X, the brush cursor in Photoshop CS3 looks funny (box around brush)</dt>
<dd><strong>Solution:</strong> This seems to be a bug which shows with <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym>-type profiles that have only one rendering intent. You can try to overcome it by selecting “Advanced...” next to the profile type dropdown, selecting an existing <acronym title="International Color Consortium">ICC<sup><a href="#definition_ICC">[5]</a></sup></acronym> profile as source (for hints as to which profile to select, see “<a href="#settings_profiling_gamutmapping">Advanced gamut mapping options</a>”) and tick at least one of the “Enhance effective resolution of colorimetric <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device table” or “Apply gamut mapping to” checkboxes before profiling. To do that for an existing profile, adjust quality and profile name if you want, choose “Create profile from measurement data...” from the “Options” menu and select the profile. Note that this does not always solve the issue. Trying another profile type (XYZ LUT instead of L*a*b* LUT) might also help.</dd>
<dt id="issue-linux-lutaccess"><span>Linux/Windows:</span> No video card gamma table access (“Calibrate only” and “Calibrate & profile” buttons grayed, “Profile only” button available)</dt>
<dd><strong>Solution:</strong> Make sure you have not selected a display that doesn't support calibration (i.e. “Web @ localhost” or “Untethered”) and that you have enabled “Interactive display adjustment” or set the tone curve to a different value than “As measured”. Under Linux, please refer to the Argyll CMS documentation, “<a href="http://argyllcms.com/doc/Installing_Linux.html">Installing the software on Linux with X11</a>” and “Note on X11 multi-monitor setups” / “Fixing access to Video LUTs” therein. Under Windows, please also see the solution posted under “<a href="#issue-win-user-profile-not-used">The display profile isn't used if it was installed for the current user</a>” if you are using Windows 7 and make sure you have a recent driver for your video card installed.</dd>
<dt id="issue-linux-libmtp"><span>Linux:</span> Instrument not working correctly/constantly disconnecting (conflict with libmtp)</dt>
<dd><strong>Solution:</strong> There is a bug on some systems with libmtp that causes instruments to continuously switch between connected and disconnected state.
This seems to be a <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=626010">bug in libmtp-runtime</a>.
You can work around it by renaming <code>/lib/udev/mtp-probe</code> or updating to libmtp 1.0.6 where the issue should be fixed.</dd>
</dl>
</div>
<div id="help">
<h2>Get help</h2>
<p>Need help with a specific task or problem? It may be a good idea to first check the <a href="#issues">known issues & solutions</a> if the topic has been covered.
If you want to report a bug, please see the <a href="#reportbug">guidelines on bug reporting</a>. Otherwise, feel free to use one of the following channels:</p>
<ul>
<li><a href="http://sourceforge.net/p/dispcalgui/discussion/932493/">Help & support forum</a></li>
<li><a href="https://lists.sourceforge.net/lists/listinfo/dispcalgui-users">dispcalGUI-users mailing list</a></li>
<li>Contact me directly via E-Mail: <a>dispcalGUI ‹at› hoech . net</a> (but keep in mind other users may also benefit from exchanges, so I'm encouraging the use one of the above channels if possible)</li>
</ul>
</div>
<div id="reportbug">
<h2>Report a bug</h2>
<p>Found a bug? If so, please first check the <a href="https://sourceforge.net/p/dispcalgui/bug-reports/">bug tracker</a>, it may have been reported already.
Please follow these guidelines for reporting bugs:</p>
<ul>
<li>Try to give a <strong>short, but concise summary of the problem</strong>.</li>
<li>Try to give some <strong>steps to reproduce the problem</strong>.</li>
<li>Always <strong>attach logfiles</strong> if possible. They are usually automatically created by dispcalGUI as part of normal program operation. You can find them here:
<ul>
<li>Linux:
<samp>/home/<var>Your Username</var>/.local/share/dispcalGUI/logs</samp></li>
<li>Mac OS X:
<samp>/Users/<var>Your Username</var>/Library/Logs/dispcalGUI</samp></li>
<li>Windows Vista and newer:
<samp>C:\Users\<var>Your Username</var>\AppData\dispcalGUI\logs</samp></li>
<li>Windows XP:
<samp>C:\Documents and Settings\<var>Your Username</var>\Application Data\dispcalGUI\logs</samp></li>
</ul>
<p>As the folder may contain several logfiles, it is a good idea to compress the whole folder to a ZIP or tar.gz archive that you can easily attach to a bug report.</p>
<p><em>Please note the logfiles may contain your username as well as paths of files you may have used in dispcalGUI. I will respect your privacy at all times, but you may want to consider this when attaching logfiles to public places like the <a href="https://sourceforge.net/p/dispcalgui/bug-reports/">bug tracker</a>.</em></p>
</li>
</ul>
<p>Create a new ticket (or if the bug has been reported already, use the existing ticket) at the <a href="https://sourceforge.net/p/dispcalgui/bug-reports/">bug tracker</a>, following the guidelines above, and attach the logfiles archive.</p>
<p>If you don't want to or can't use the bug tracker, feel free to use one of the <a href="#help">other support channels</a>.</p>
</div>
<div id="discuss">
<h2>Discussion</h2>
<p>Do you want to get in touch with me or other users regarding dispcalGUI or related topics? The <a href="http://sourceforge.net/p/dispcalgui/discussion/932494/">general discussion forum</a> or <a href="https://lists.sourceforge.net/lists/listinfo/dispcalgui-users">dispcalGUI-users mailing list</a> is a good place to do so. You can also contact me directly via E-Mail: <a>dispcalGUI ‹at› hoech . net</a>.</p>
</div>
<div id="todo">
<h2>To-Do / planned features (in no particular order)</h2>
<ul>
<li>On first launch, guide user through basic setup using a wizard (postpone dispcalGUI update check until after wizard has run?):
<ul>
<li><del>Check Argyll CMS availability, if not available or outdated, offer automatic download & installation (consider 0install/native Linux distribution packages?)</del> (use 0install/native distribution packages, other users can download manually for now)</li>
<li>Windows only: Install instrument drivers if necessary (probably need to check if already installed)</li>
<li>Check available instruments and instrument capabilities</li>
<li>Do instrument specific first launch stuff:
<ul>
<li>Import OEM files</li>
<li>Choose/create colorimeter correction if applicable</li>
</ul>
</li>
</ul>
</li>
<li>When an instrument is first selected:
<ul>
<li><del>Check if OEM files from the vendor software have already been imported (if applicable); if not, offer to do it.</del> (implemented in v2.1.1.3 Beta and newer, after detecting instruments)</li>
<li>Check colorimeter corrections if applicable (from respective vendor software and online database, skip the latter if a spectro is available), in case of no usable specific or generic correction, offer to create one if possible, preferably using spectro measurements as reference, EDID as user-selectable fallback? (Need to sanity-check EDID red/green/blue/white xy coordinates in that case! Possibly against sRGB and AdobeRGB as the most commonly cited gamuts for standard gamut and wide-gamut displays? As some cheaper panels and many of those found in Laptops/Notebooks are sometimes very limited in gamut, additionally a special “low-gamut RGB” may be needed)</li>
<li>Users need to be made aware of the implications their colorimeter correction choice has, e.g.
<ul>
<li>When using a correction created from spectral reference measurements of the specific display (user needs a spectro): Usually very good accuracy/match to user's specific display/instrument combination</li>
<li>When using a vendor-supplied generic correction: Good (?) (e.g. i1 DisplayPro, ColorMunki Display) to poor (?) (e.g. i1 Display 1/2/LT, Huey, ColorHug) accuracy/match to user's specific display/instrument combination, in case of CCSS considered preferable to corrections supplied by other users because of lab-grade equipment (high spectral resolution) used by vendor.</li>
<li>When using a correction supplied by another user for the same display/instrument combination: Good (?) (e.g. i1 DisplayPro, ColorMunki Display, DTP94) to poor (?) (e.g. i1 Display 1/2/LT, Huey, ColorHug) accuracy/match to user's specific display/instrument combination</li>
<li>When using EDID of the specific display as reference: Moderate (?) to poor (?) accuracy/match to user's specific display/instrument combination (could be ok match, could be awful, but should in most cases still be able to fix problems like e.g. ColorHug red sensitivity so may be ok as last resort)</li>
</ul>
</li>
</ul>
</li>
<li><del>When trying to import colorimeter corrections or enable the Spyder 2, have automatic mode download the vendor software if needed.</del> (implemented in v2.1.1.2 Beta and newer)</li>
<li>(Long-term) improve UI.</li>
<li><del>Better interface to <a href="http://projects.gnome.org/gnome-color-manager/">GNOME Color Manager</a></del> (implemented in v0.8.1.0+)</li>
<li><del>Measure and report on screen homogenity / evenness of illumination</del></li>
<li><del>Get rid of the terminal and implement a proper GUI for the interactive part of calibration</del> (implemented in v0.8.5.6+)</li>
<li><del>Better user interface for profile verification: If a test set contains multiple value formats (CMYK, RGB, XYZ, L*a*b*), allow selection which one(s) should be used in a “setup” window</del> (“setup” window implemented in v1.5.6.9+, value format selection added in v1.6.3.5)</li>
<li>Add gamut coverage percentages to the profile verification report if the test set contains reference values (not *.ti1): Calculate profiles from test set and verification measurements on-the-fly and create gamut volumes from test set profile, evaluated profile, and verification measurements profile using Argyll's <code>iccgamut</code> tool. Compare gamut volumes using Argyll's <code>viewgam</code> tool with <code>-i</code> option and include the results in the report (coverage calculation for test set reference and profile to be evaluated could be done before the actual measurements and also shown in the yet-to-be-implemented profile verification “setup” window).</li>
<li><del>Complete the documentation in the README</del></li>
<li>German language README (postponed)</li>
<li><del>Profile verification (feed XYZ or L*a*b* to display profile, display
corresponding RGB values, measure, output Delta E)</del> (implemented in v0.3.6+)</li>
<li><del>“Before” / “After” switch when calibration / profiling complete</del> (implemented in v0.2+)</li>
<li><del>Store all settings in profile, allow loading of settings from profile in
addition to <code>.cal</code> file</del> (implemented in v0.2+)</li>
<li><del>Document the code</del> (code documentation could still be enhanced, for now it'll do)</li>
<li><del>Code cleanup</del> (mostly done)</li>
</ul>
</div>
<div id="thanks">
<h2>Thanks and acknowledgements</h2>
<p>I would like to thank the following people:</p>
<p>Graeme Gill, for creating Argyll CMS</p>
<p>Translators: Loïc Guégant (french translation),
Roberto Quintero (spanish translation),
Tommaso Schiavinotto (italian translation)</p>
<p>Recent donors: Tomislav Stojanović, Michel Mougey, Tim Oberbillig, Peter Clarke, Lionel Davey, Christian-Aurel Buru, James Hainis, Nejib Boubaker, Tomislav Stojanović, Scott Miller, John Navarro, Stephen Wall, Andrej Schmitt, Olivier Besner Morin, Christian Ramharter, Dieter Pongratz, <a href="#more_donors" onclick="document.getElementById('more_donors').style.display = 'inline'; this.style.display = 'none'; return false" style="cursor: pointer">more...</a><span id="more_donors" style="display: none">Andrew Hunter, Yulian Martsenkov, Catherine Goniot, Ben Edwards, Ievgen Morskyi, Ahammed Umminiyil, LivingWithBugs.com, Christoph Clarenbach, Paul Fokkens, Kieren Hinch, Dale Somerville, Francesco Demontis, Projection Mapping Central, Scott Janz, Govindanunny Thekkadath, Nejib Boubaker, Mason Livingston, Daniel Lenardon, Manuel López Pérez, Xavier Potel, Andrew Hunter, Thomas Voigt, Александр Ольховский, Eugeniy Yurov, Hans Cremers, George Pop, Michael Gestgrasser, Stefan Pallari, Oliver Hoefele, Kyle Winfree, Alexander Mitchell, Juho Turunen, Jon Sands, Evgueni Ivanov, Riccardo Mandarano, Roman Romenskiy, Myron Blume, WTPM van Vucht, Philip Tobias, Richard Luney, Matthias Klausing, M E M van Ineveld, Patryk Bajer, Gregor Kofler, Richard Egger, Michael Dougherty, Christian Spyr, Konstantin Pyanzin</span></p>
<p>And everyone who sent me feedback or bug reports, suggested features, or simply uses dispcalGUI.</p>
<p class="h">Acknowledgements</p>
<p>Part of the comprehensive Argyll CMS documentation has been used in this document, and was only slightly altered to better fit dispcalGUI's behavior and notations.</p>
</div>
<div id="changelog">
<h2>Version history / changelog</h2>
<!-- 2014-09-06 00:07 (UTC) 2.5 -->
<dl>
<dt id="changelog-2.5">2014-09-06 00:07 (UTC) 2.5 </dt>
<dd>
<h3>2.5 </h3>
<h4>Added in this release:</h4>
<ul>
<li><strong>Argyll CMS 1.7 beta compatibility:</strong> Klein K10-A support (requires <a href="http://www.avsforum.com/forum/139-display-calibration/1471169-madvr-argyllcms-61.html?styleid=129#post24742730">Argyll CMS 1.7 beta test 2014-05-21</a> or newer) and updated technology strings for colorimeter correction creation. When creating 3D LUTs with Rec. 1886 or custom tone response curve, force RGB source 0 0 0 to map to RGB destination 0 0 0 (requires Argyll CMS 1.7 beta development code 2014-07-10 or newer).</li>
<li>Enable black output offset instead of all-input offset for 3D LUTs, measurement report and synthetic profile creation (based on Argyll CMS 1.7 beta development code 2014-07-12, thanks to Graeme Gill). Note that for 3D LUTs, if using output offset ideally Argyll CMS 1.7 should be used aswell once it becomes available since the current implementation in dispcalGUI that enables output offset when used with Argyll CMS 1.6.3 or older has limited 16-bit precision for the black point mapping (due to the implementation altering the source profile TRC on-the-fly in that case, and the ICCv2 16-bit encoding used for the TRC tags in the source profile), while Argyll CMS 1.7 will enable full floating point processing (due to the black point mapping then taking place internally in <code>collink</code>, and dispcalGUI not having to alter the source profile TRC beforehand).</li>
<li>Black point can be specified in XYZ or chromaticity coordinates when creating a synthetic ICC profile.</li>
<li>When dropping an existing profile onto the synthetic ICC profile creation window, set whitepoint, primaries, blackpoint and tone response curve (average) according to the profile.</li>
<li><strong>Support for the Resolve 10.1 (and newer) CM pattern generator.</strong> See also <a href="https://sourceforge.net/p/dispcalgui/wiki/3D%20LUT%20creation%20workflow%20for%20Resolve/">3D LUT creation workflow for Resolve</a> on the <a href="https://sourceforge.net/p/dispcalgui/wiki/browse_pages/">dispcalGUI Wiki</a>.</li>
<li>Enable interactive display adjustment without creating calibration curves by setting “Tone curve” to “As measured”. This also causes all calibration setting placeholders in the profile name to be ignored.</li>
<li>Added options to override the minimum display update delay (requires Argyll CMS 1.5 or newer) and display settle time multiplier (requires Argyll CMS 1.7 Beta or newer). These options can be found in the <a href="#additional-commandline-arguments">“Set additional commandline arguments...”</a> window accessible from the “Options” menu. Note that these two settings (unlike the additional commandline parameters) are stored in the profile, and will be restored when the profile is selected again under “Settings”.</li>
<li>Testchart editor: If generating any number of iterative patches as well as single channel, gray or multidimensional patches, it is possible to add the single channel, gray and multidimensional patches in a separate step by holding the shift key while clicking on “Create testchart”. This prevents those patches affecting the iterative patch distribution, with the drawback of making the patch distribution less even. This is an experimental feature.</li>
<li>Windows: Simplified Argyll CMS instrument driver installation by adding a respective menu item to the “Tools” menu.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Visual overhaul.</li>
<li>Calibration curves are no longer automatically loaded into the video card gamma table when loading a settings file. To manually load calibration curves into the video card gamma table, choose “Load calibration curves from calibration file or profile...” in the “Options” menu (Linux and Windows only), or install a profile, or use the “Preview calibration” checkbox (Linux and Windows only) in the profile installation dialog. The previous behavior can be restored by editing dispcalGUI.ini and adding a line <code>calibration.autoload = 1</code>.</li>
<li>Split “Smooth B2A tables” into “Enhance effective resolution of colorimetric <acronym title="Profile Connection Space">PCS<sup><a href="#definition_PCS">[11]</a></sup></acronym>-to-device table” and “Smoothing” options and moved them to advanced gamut mapping options.</li>
<li>Renamed “Apply BT.1886 gamma mapping” to “Apply tone response curve”.</li>
<li>Always override the source profile tone response curve when using “Apply tone response curve” (3D LUT creation and measurement report) so the result will be correct for the chosen parameters regardless of source profile tone response curve.</li>
<li>Removed black point compensation option from synthetic profile creation window.</li>
<li>Changing the black level or black point Y value when creating a synthetic ICC profile now rounds up or down to make it a multiple of the 16-bit encoding precision used in ICC v2 profiles (which is roughly 0.00153 when normalized to 0..100).</li>
<li>Re-enabled moving the standalone curve viewer between displays updating the graph according to the display it is currently on.</li>
<li>Always append the measurement mode to the instrument string in the measurement report.</li>
<li>Confirm quitting the application (via the application menu “Quit” item or the associated keyboard shortcut) if a task is still running (in practice this only affects Mac OS X as the menu is not accessible on other platforms while a task is running).</li>
<li>When selecting “Locate Argyll CMS executables...” in the menu to switch to a different Argyll CMS version, automatically detect if a newer version is on the search path and offer to use it right away without having to manually browse to the location.</li>
<li>Renamed “Gamma” entry in calibration tone response curve dropdown to “Custom” to emphasize that it is a curve with custom gamma exponent and other parameters.</li>
<li>When switching calibration tone response curve from Rec. 1886 to custom, restore the previous gamma and black output offset parameters (or defaults in case a preset was used).</li>
<li>Show an error message if trying to measure the ambient light color with an instrument which only has a monochrome ambient sensor (e.g. Spyder 3 and 4 Elite or Pro).</li>
<li>Importing colorimeter corrections and enabling the Spyder 2 is now truly automatic (necessary files are downloaded if not present on the local system).</li>
<li>Made black level control an advanced calibration option.</li>
<li>Loading a profile that does not contain calibration settings sets all calibration options to “As measured”.</li>
<li>When creating or loading a profile (except presets), it is now automatically set as the current profile in the measurement report and 3D LUT creation windows.</li>
<li>Enabled interactive display adjustment for the madVR and Resolve presets and altered them to not do video card gamma table calibration by default.</li>
<li>All presets that create LUT profiles use optimized testcharts.</li>
<li>When a virtual display is selected, don't offer profile installation but 3D LUT creation instead.</li>
<li>ReadMe: Completed testchart editor documentation.</li>
<li>Testchart editor: Always enable “Add saturation sweeps” and “Add reference patches...” controls when a preconditioning profile is set, regardless of selected patch distribution and adaptation.</li>
<li>Testchart editor: When enabling/disabling the preconditioning profile, set adaptation to 100%/10% respectively.</li>
<li>Testchart editor: Greatly improved the speed of inserting patches into large testcharts with thousands of patches.</li>
<li>Linux, profile installation: Try to install the profile using all available systems regardless if one of them fails to install the profile. Only report profile installation as failed if all available systems failed to install the profile. Report specific failures when profile installation only partly succeeds.</li>
<li>Linux, profile installation: Try colormgr as fallback (if available) if profile installation using Argyll 1.6+ failed.</li>
<li>Linux: Use the EDID MD5 to find the device ID (this only works with colord versions released after 26. Apr. 2013).</li>
<li>Mac OS X: No longer require administrator privileges if running from a non-administrator user account.</li>
<li>Windows Vista and newer: Enable system-wide profile and OEM files installation without the need to run the whole application as administrator. The UAC shield icon is shown on buttons if an action requires administrator privileges.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>The “Apply BT.1886 gamma mapping” checkbox in the 3D LUT creation window did re-enable itself when clicking on “Create 3D LUT” if Rec709.icm was selected as source profile.</li>
<li>Synthetic ICC profile creation: Setting gamma to absolute or relative when not using Rec. 1886 now actually makes a difference (previously the end result was always an absolute curve).</li>
<li>“Show actual calibration curves from video card” could not be enabled in the standalone curve viewer if the previously selected display did not allow video LUT access.</li>
<li>Measuring the ambient light level with an instrument which only has a monochrome ambient sensor (e.g. Spyder 3 and 4 Elite or Pro).</li>
<li>If loading a settings file created with automatic black point hue correction, that setting was not restored and the default value of no correction was used.</li>
<li>When doing a “Profile only” and using the current calibration from the video card gamma table, Argyll CMS expects 256 entries. Interpolate on-the-fly if the number of entries in the video card gamma table is not 256 (this currently only affects Mac OS X 10.9 and newer where the table contains 1024 entries).</li>
<li>If the display manufacturer string recorded in a profile was the same as the three-letter manufacturer ID string (e.g. NEC), the profile could not be uploaded to the <a href="http://icc.opensuse.org">openSUSE ICC Profile Taxi</a> service due to a bogus “missing metadata” error message (regression of r1422).</li>
<li>Profile information window: Color coordinates in the status bar were wrong if the selected colorspace was not a*b* (bug introduced in dispcalGUI 2.0).</li>
<li>The specbos 1201 was not working due to not supporting measurement mode selection.</li>
<li>When getting normalized vcgt tag values, scaling was off if the vcgt wasn't 16-bit. This prevented e.g. the measurement report from working with certain 3rd-party display profiles.</li>
<li>Cosmetic: Correct padding of the patch number in the measurement report summary (fixes missing padding when multiple patches are evaluated for a single criterion).</li>
<li>Trivial: Tab order of controls (top-down, left-right).</li>
<li>Testchart editor: IndexError if trying to add saturation sweeps or reference patches when no cells are selected.</li>
<li>Linux, profile installation: Do not regard a missing colormgr as error.</li>
<li>Mac OS X: Selecting “About”, “Locate Argyll CMS executables...” (preferences) and “Quit” in the application menu does something again (this stopped working with the move to wxPython 3.0 GUI library in dispcalGUI 2.0).</li>
</ul>
</dd>
<dt id="changelog-2.1">2014-05-11 19:00 (UTC) 2.1</dt>
<dd>
<h3>2.1</h3>
<h4>Added in this release:</h4>
<ul>
<li><strong>“Auto” measurement mode for the ColorHug.</strong> This will automatically create a colorimeter correction with the reference based on <acronym title="Extended Display Identification Data">EDID<sup><a href="#definition_EDID">[10]</a></sup></acronym> as part of the normal measurement process. This is a work-around for the red primary shift problem that some ColorHug users are experiencing (note that this will make ColorHug measurements closely match the gamut boundaries defined by the primaries and whitepoint from EDID). This mode should only be used as a last resort if no colorimeter correction with reference measurements from a spectrometer or other known accurate instrument can be obtained.</li>
<li><strong>Auto-update functionality.</strong> Apply updates from within dispcalGUI under Mac OS X and Windows, or if using Zero Install.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li><strong>Improved Zero Install integration.</strong> Installation is now as simple as a standalone installation.</li>
<li>Switched “Smooth B2A tables” off and “Low quality B2A tables” back on for the madVR preset to save some time during profile generation.</li>
<li>The HTML-embedded X3D viewer will now by default try and load its components from the web, with a fallback to a locally cached copy (if available) and not anymore the other way around. This means generated HTML files will automatically use updated viewer components when an internet connection is available.</li>
<li>Choosing “Profile information” from the “File” menu will now always present a file dialog to pick a profile and no longer use the profile currently selected in the main window (this functionality is still available via the small blue “Info” button next to the settings dropdown).</li>
<li>Show profile information with right pane expanded by default.</li>
<li>Don't lock measurement mode for colorimeter corrections, instead set colorimeter correction to none if an incompatible measurement mode is selected.</li>
<li>Allow black point compensation if “low quality B2A tables” is enabled.</li>
<li>Windows: Limit profile name length so that the length of the path of the temporary directory plus the length of the profile name does not exceed 254 characters (which is the maximum useable length for Argyll CMS tools where an extension with a length of four characters is added automatically).</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>When using the ColorHug in “Factory” or “Raw” measurement mode in dispcalGUI (r1378 or later) with a colorimeter correction that was created with Argyll CMS 1.5 or later, the measurement mode was being locked to the wrong mode (a colorimeter correction created in “Factory” mode would lock to “Raw” and vice versa).</li>
<li>Transpareny rendering in the HTML-embedded X3D viewer: Transparency is now gamma-corrected.</li>
<li>Tone response curves plot: Removed the very slight interpolation offset error at zero input (around +0.5 RGB on a 0-255 scale for a synthetic 16-bit tone response curve following a gamma of 2.2 with no black offset) for tone response curves that have zero output at non-zero input.</li>
<li>Trying to open files with unicode characters in their filename or path in the standalone testchart editor, curve viewer, profile information, or VRML to X3D converter application from the commandline, via the desktop's “open with” functionality, or by assigning a supported filetype to be opened with the respective application failed (dragging and dropping the file onto the respective application window worked fine).</li>
<li>Correctly reflect in the GUI if black point compensation can be applied. Black point compensation is available for curves + matrix profiles and XYZLUT profiles with either “low quality B2A tables” or “smooth B2A tables” enabled.</li>
<li>Linux: Fixed a problem with unicode when querying colord for the current display profile (regression of r1832).</li>
<li>Windows: Report could not be saved after finishing display uniformity measurements due to the file dialog not receiving mouse clicks or keyboard input.</li>
<li>Windows: Work-around python issues with long pathnames (>= 260 characters).</li>
</ul>
</dd>
<dt id="changelog-2.0">2014-04-23 00:43 (UTC) 2.0</dt>
<dd>
<h3>2.0</h3>
<h4>Added in this release:</h4>
<ul>
<li>
<p><strong>New profiling option “smooth B2A tables” for XYZ LUT profiles.</strong> This should improve the smoothness of the relative colorimetric gamut mapping. Enabling this option will also generate a simple but effective perceptual mapping (which will be almost identical to the colorimetric mapping, but map the black point) if no other advanced gamut mapping options have been chosen.</p>
<p>See below example images for the result you can expect (note though that the particular synthetic image chosen, a “granger rainbow”, exaggerates banding, real-world material is much less likely to show this).</p>
<div style="overflow: hidden; padding: 1.4em 0;">
<div style="text-align: center;">
<p><a rel="lightbox-set-1784" href="http://dispcalGUI.hoech.net/img/GrangerRainbow.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow.thumb.png" alt="Original Granger Rainbow image" style="box-shadow: 0px 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>Original “granger rainbow” image</p>
</div>
<div style="float: left; margin: 0 15px 0 22px; width: 200px">
<p><a rel="lightbox-set-1784" href="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_colorimetric_default.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_colorimetric_default.thumb.png" alt="Granger Rainbow - default colorimetric rendering" style="box-shadow: 0 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>Default colorimetric rendering <span style="white-space: nowrap">(2500 OFPS XYZ LUT profile)</span></p>
</div>
<div style="float: left; margin: 0 15px; width: 200px">
<p><a rel="lightbox-set-1784" href="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_colorimetric.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_colorimetric.thumb.png" alt="Granger Rainbow - “smooth” colorimetric rendering" style="box-shadow: 0 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>“Smooth” colorimetric rendering <span style="white-space: nowrap">(2500 OFPS XYZ LUT profile</span>, inverted A2B)</p>
</div>
<div style="float: left; margin: 0 15px; width: 200px">
<p><a rel="lightbox-set-1784" href="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_perceptual.png"><img src="http://dispcalGUI.hoech.net/img/GrangerRainbow_sRGB_to_widegamut_smooth_perceptual.thumb.png" alt="Granger Rainbow - “smooth” perceptual rendering" style="box-shadow: 0 1px 3px rgba(0, 0, 0, .75);" /></a></p>
<p>“Smooth” perceptual rendering <span style="white-space: nowrap">(2500 OFPS XYZ LUT profile</span>, inverted A2B)</p>
</div>
</div>
<p>For the test, the image has been converted from sRGB to the display profile. Note that the sRGB blue in the image is actually out of gamut for the specific display used, which made the test particularly challenging (the edges visible in the blue gradient for the rendering are a result of the color being out of gamut, and the gamut mapping thus hitting the less smooth gamut boundaries).</p>
<p><em>Technical discussion:</em> “smooth B2A tables” works by inverting the already present A2B colorimetric table, making use of Argyll CMS to do clipping in CAM Jab for saturated colors. A new cLUT, cLUT matrix and cLUT device channel curves are then generated. The matrix and device channel curves scale and transform the input values to distribute them across the cLUT grid points, trying to make good use of the limited number of points. Additional smoothing is then applied to the cLUT (this can be disabled by editing dispcalGUI.ini and adding a line <code>profile.b2a.smooth.extra = 0</code>). Diagnostic PNG images are created for each of the B2A cLUT tables (pre/post/post smoothing). This approach is relatively straightforward, but seems very effective in creating a smooth yet accurate mapping. There is a drawback though, if the native device gamut boundary is bumpy, the error at the gamut boundary and thus the max error can go up. In most cases, I feel this will be acceptable, and the smoothness and often also increased in-gamut accuracy should make up for the potential higher max error. If you're interested, you can check the error of the B2A table vs the A2B table by running (in a terminal) <code>invprofcheck -k -h -w -e</code> on the profile, and compare it to the error of a profile where “smooth B2A tables” was not used. Comments and feedback welcome as always.</p>
</li>
<li>Synthetic ICC profiles can be created with DICOM or BT.1886 tone response curve, with or without black offset, and can either be RGB (curves + matrix) or gray (curves only).</li>
<li>Expanded the color space choices for profile gamut views with L*u*v* and DIN99 family colorspaces.</li>
<li>Expanded the color space choices for diagnostic 3D views of testcharts with HSI, HSL, DIN99 family, LCH(ab), LCH(uv), L*u*v*, Lu'v' and xyY colorspaces. To differentiate the LCH(ab) and LCH(uv) views from L*a*b* and L*u*v* respectively, a layout where the hue angle increases along the horizontal and chroma along the vertical axis is used.</li>
<li><strong>3D views of profile gamuts and testcharts</strong> can be created as VRML, X3D, or X3D in HTML with embedded viewer for WebGL-enabled browsers.</li>
<li><strong>VRML to X3D standalone converter.</strong> Output options are X3D (XML) and X3D in HTML. The HTML files generated by default use the <a href="http://www.x3dom.org/">X3DOM</a> runtime to implement a viewer, which requires a WebGL-enabled browser. The converter can be run from a terminal without GUI. Run it with the <code>--help</code> argument to view the list of options.</li>
<li>Rendering intent and direction selector for curve viewer tone response curve plot. Also changed layout of controls slightly.</li>
<li>LUT checkbox to profile info gamut view (if the profile is a LUT profile and contains both LUT and matrix tags). This allows inspecting the gamut characterized by the LUT versus the one defined by the matrix.</li>
<li>Show estimated remaining time in the progress dialog if applicable. Note that it is not always particularly accurate, and for operations consisting of multiple steps (e.g. calibration & profiling), the shown estimate is for the current (sub-)step only.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Slightly adjusted presets:
<ul>
<li>Changed “madVR” and “Video” presets to use Rec. 1886 as calibration target.</li>
<li>Changed “Prepress” and “Softproof” presets to use full black point hue correction during calibration.</li>
<li>Disabled interactive display adjustment for “Laptop” preset.</li>
<li>Set profile type for those presets that defaulted to curves + matrix to single curve + matrix.</li>
</ul>
</li>
<li>Changed profile black point compensation option to map the black point to zero more reliably. This means black point compensation can no longer be used for L*a*b* LUT profiles, and will only be applied to the LUT part of XYZ LUT profiles if the new “smooth B2A tables” profiling option is used.</li>
<li>Changed 3D LUT and measurement report settings to automatically enable/disable Rec. 1886 gamma mapping if the source profile has/doesn't have a known “camera” transfer function (e.g. SMPTE 240M or Rec. 709).</li>
<li>Unlocked calibration Rec. 1886 gamma controls to bring them in line with the 3D LUT and measurement report offerings.</li>
<li>Set BT.1886 gamma mapping defaults to gamma 2.4 absolute to match the recommendation.</li>
<li>Show error message in case of ambient measurement failing due to instrument communications failure.</li>
<li>Curve viewer: Enable dragging and zooming.</li>
<li>Profile information comparison profile selection, measurement report simulation profile selection: The list of automatically recognized profiles (if they are installed) has been extended to the full range of <a href="http://www.eci.org/">ECI</a> offset, gravure and newsprint profiles as well as their basICColor equivalents (available on <a href="http://www.colormanagement.org">colormanagement.org</a>) and an increased range of RGB working space profiles. Other profiles can be added by dragging-and-dropping them on the profile list.</li>
<li>Never center the display adjustment and untethered measurement windows on the screen, or show them at their parent window coordinates if no previous coordinates were stored in the configuration (always use default coordinates of topleft screen corner in that case).</li>
<li>In the case of essential resource files missing (e.g. broken installation or deleted application files), show a more informative error message.</li>
<li>Diagnostic 3D views of testcharts are no longer created automatically. You have to click the “3D” button.</li>
<li>Slightly increased the logging verbosity.</li>
<li>Linux: No longer use GObject Introspection to interface with colord. It could in rare cases cause hard to diagnose problems with wxPython. Rely on colord support in Argyll CMS 1.6 and newer instead (with a fallback to colormgr for profile queries or if libcolordcompat.so is not available for profile installation).</li>
<li>Linux: Deal with distribution-specific differences for the location of Argyll CMS reference files (currently supported are <code>XDG_DATA_DIRS</code>/argyllcms/ref, <code>XDG_DATA_DIRS</code>/color/argyll and <code>XDG_DATA_DIRS</code>/color/argyll/ref).</li>
<li>Linux: Use udev hwdb instead of pnp.ids for looking up PNP ID to manufacturer name if available.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Unhandled exception when trying to start measurements on a display that was added/enabled while dispcalGUI was already running.</li>
<li>In case of untethered measurements, correctly detect and react to recurring need for intermittent instrument calibration.</li>
<li>Re-enabled the ability to generate some 3D LUT formats from existing DeviceLink profiles.</li>
<li>Don't allow leading dashes in profile filename which might trick the Argyll CMS tools into mistaking parts of it as an option parameter.</li>
<li>Refresh display measurement mode was not correctly restored from saved settings.</li>
<li>Moving the measurement window between displays resulted in an error and did not update the display configuration (regression of r1737).</li>
<li>Linux: Make curve viewer and profile information compatible with wxPython 3.0.</li>
<li>Linux: When the trash directory was not already present, files couldn't be moved to the trash.</li>
<li>Linux: System-wide profile installation should now also work if sudo is configured to require a TTY.</li>
<li>Linux/colord interface: Leave out manufacturer name part of device ID if the PNP ID wasn't found in the database.</li>
<li>Linux/colord interface: Deal with potential differences in device ID depending on installed colord version and desktop environment.</li>
<li>Linux, Mac OS X: In rare cases, a worker thread could reach an infinitely blocked state.</li>
<li>Mac OS X: Standalone tools (broken due to internal symlinks pointing to wrong locations).</li>
<li>Mac OS X: Create user profile directory if it does not exist when trying to install a profile (fixes inability to install a profile if the user profile directory does not exist).</li>
<li><strong>Mac OS X 10.6 and newer: Calibration loading/clearing is now disabled</strong> due to undesirable side-effects (loading calibration from the current display profile could make it necessary to manually restore the display profile by opening system preferences → display → color and loading or clearing a calibration could have side-effects on calibration and profiling measurements).</li>
</ul>
</dd>
<dt id="changelog-1.7.5.7">2014-02-09 22:55 (UTC) 1.7.5.7</dt>
<dd>
<h3>1.7.5.7</h3>
<h4>Added in this release:</h4>
<ul>
<li>Unique icons for all standalone tools.</li>
<li>Profile information can plot and display colors from named color profiles (including ICC v4). Thanks to Alexander Bohn for adding the original named color support in the ICC profile module.</li>
<li>Testchart editor, “Add reference patches”: Named color profiles can be used as reference.</li>
<li>Linux: Desktop entries for standalone tools.</li>
<li>Mac OS X: Application bundles for standalone tools (Note: They won't work without the main application being present in the same folder, as the resources are shared and contained in the main application bundle).</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Error handling: Omit traceback from error messages for filesystem and operating system related errors (like disk full or no read permissions on a file) as such errors are not code-related.</li>
<li>Updated french translation (thanks to Loïc Guegant).</li>
<li>If a profile is corrupted, show the curves window regardless if enabled. Show the profile error message only when the corrupted profile is first accessed, not each time the curves window is shown/hidden.</li>
<li>Testchart editor, “Add reference patches” (dealing with image colorspaces): Support Lab TIFF images. Fail on colorspace mismatches.</li>
<li>Removed DCI_P3.icm profile (prefer SMPTE431_P3.icm which is part of recent Argyll CMS releases).</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Disable double-click centering and scaling for curve views (this was never supposed to be possible in the first place).</li>
<li>Testchart editor, “Add reference patches” (chromatic adaptation): When no device white is available, make sure alternate whitepoint definitions (APPROX_WHITE_POINT, LUMINANCE_XYZ_CDM2 fields) are actually used if present.</li>
<li>Always automatically add a file type extension to the filename in the curve/gamut saving dialog (fixes “unsupported filetype” error when trying to save under Mac OS X without manually adding the extension to the filename).</li>
<li>Calibration preview for calibration & profile from “<current>” setting no longer switches between .cal and .icm file created in that same run.</li>
</ul>
</dd>
<dt id="changelog-1.7.1.6">2014-01-19 10:02 (UTC) 1.7.1.6</dt>
<dd>
<h3>1.7.1.6</h3>
<h4>Added in this release:</h4>
<ul>
<li>A new option to not use the video card gamma table to apply calibration (default like in 1.5.2.5/1.5.3.1: On for madVR, off for everything else).</li>
<li>Correlated color temperature, gamma, RGB gray balance and gamut graphs to measurement report.</li>
<li>Re-added the default testchart for gamma + matrix profiles.</li>
<li>Testchart editor: Dark region emphasis controls (Argyll CMS 1.6.2).</li>
<li>Testchart editor: Black patches amount control (Argyll CMS 1.6).</li>
<li>Testchart editor: Ability to add saturation sweeps and reference patches (from CGATS or images) to a testchart if using a preconditioning profile and adaptation = 100%.</li>
<li>Standalone curve viewer. This allows to view the curves of the currently assigned display profile or the actual video card gamma table without launching dispcalGUI.</li>
<li>Curve viewer can reload, apply black point compensation to, load into the videocard, and export calibration files.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Untethered measurements window: Enable keyboard navigation in the grid view (up/down/pageup/pagedown/home/end keys).</li>
<li>Measurements are now pauseable.</li>
<li>Cancelling a potentially long-running operation like measurements or profile generation now needs to be confirmed.</li>
<li>Improved robustness of ambient measurement code.</li>
<li>Show an error message when communication with the instrument fails (instead of just logging the error).</li>
<li>Show an error message when trying to measure ambient light and ambient measurements are unsupported (instead of just logging the error).</li>
<li>Regenerated testcharts preconditioned by gamma-based profiles with slight dark region emphasis.</li>
<li>Updated french translation (thanks to Loïc Guégant).</li>
<li>“Allow skipping of spectrometer calibration” will now <em>always</em> try to skip spectrometer calibration if enabled, not just when doing a calibration and subsequent profile in one go (“Calibrate & profile”). This means a calibration timeout will then be in effect (which is 60 minutes for the ColorMunki Design/Photo, i1 Pro and i1 Pro 2), and a recalibration will only be needed if this timeout has been exceeded before the start of an operation.</li>
<li>Testchart VRML export: Only use Bradford chromatic adaptation if ACCURATE_EXPECTED_VALUES in the <code>.ti1</code> file is true (i.e. a preconditioning profile was used), otherwise XYZ scaling (to visually match VRML files generated by Argyll CMS).</li>
<li>Renamed “Verify profile” to “Measurement report”. Added options for BT.1886 gamma mapping, whitepoint simulation, (limited) support for device link profiles, and madVR color management (3D LUTs). Overhauled report HTML layout and style.</li>
<li>Use nicer filenames and titles for HTML reports and uniformity check (e.g. include the display name for which the report was generated).</li>
<li>Improved dealing with profile linking errors during 3D LUT generation (show error dialog instead of just logging the error).</li>
<li>Always use a cLUT resolution of 65 and don't preserve device curves for 3D LUT generation, regardless of the selected 3D LUT format or size (this should make results consistent between eeColor/madVR, which were always generated like that, and the other formats).</li>
<li>Allow the use of PC levels for madVR 3D LUT output encoding.</li>
<li>Synchronize input and output encoding for eeColor 3D LUT format.</li>
<li>Disable xvYCC output encoding (not supported) and consequently disable it also as input encoding for eeColor because it needs the same input/output encoding.</li>
<li>Allow loading of calibration files that do not contain settings.</li>
<li>Testchart editor: Combined patch ordering controls.</li>
<li>Testchart editor: Vastly enhanced performance of row delete operations on very large testcharts (several thousand patches). Also slightly improved speed of testchart loading.</li>
<li>Measurement report charts: Each larger chart contains all the patches from the previous smaller chart. Re-generated video charts preconditioned to Rec. 709 and with slight dark region emphasis.</li>
<li>Windows 7 and up: Prefer dispcalGUI profile loader over calibration loading facility of the OS (the latter introduces quantization artifacts and applies wrong scaling, the former uses Argyll CMS and thus doesn't have these problems).</li>
<li>Windows: Do not regard unability to determine startup folders as fatal error (this means an autostart entry to load calibration on login can not be created automatically in that case though, so unless Windows 7 or newer is used which has the ability to load calibration without external utilities, calibration needs to be loaded manually).</li>
<li>Windows/madVR: Always reset the video card gamma table to linear when using a calibration file and not using the video card gamma table to apply the calibration (this should prevent the potential problem of double calibration being applied if loading a calibration on a display, then switching over to madVR on the same display and using a calibration file while not using the video card gamma table to apply the calibration).</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>A possible unicode decode error when the computer name contains non-ASCII characters, introduced in 1.5.2.5.</li>
<li>In some instances the handling of profile name placeholders was quirky (problematic character sequences were those consisting of the same characters, case insensitive, as calibration speed or profile quality shortcodes, i.e. F<em>x</em>F, M<em>x</em>M, S<em>x</em>S, VF<em>x</em>VF and VS<em>x</em>VS, with <em>x</em> being any non alphanumeric character).</li>
<li>When loading a settings file, only switch to the associated display device if it can be unambiguously determined (fixes multi-screen setups with identical screens always switching to the first one, a bug introduced in 1.5.2.5).</li>
<li>Ignore messages from the logging module (fixes a bogus error message being displayed under Windows when closing dispcalGUI, introduced in 1.5.2.5).</li>
<li>Handling of separate video card gamma table access controls was a bit quirky since the addition of virtual display devices.</li>
<li>If the 3D LUT target profile was overwritten by the generated device link profile (which could happen if choosing the same path and file name for the 3D LUT/device link profile as the target profile), it prevented changing the source profile.</li>
<li>Instrument (spectrometer) calibration can be required multiple times during a calibration run, depending on its duration. This was not handled correctly by the GUI.</li>
<li>3D LUT generation with TV RGB 16-235 encoding could lead to wrongly encoded 3D LUTs if not using the eeColor or madVR format.</li>
<li>3D LUT generation with YCbCr encodings failed with an error if not using the eeColor or madVR format.</li>
<li>Standalone utilities (3D LUT maker, curve viewer, profile information, and testchart editor) now function properly even if dispcalGUI itself was never launched before (previously the Argyll CMS version was read from the configuration, so if it was never configured before it could happen that not all available options where shown or it was never asked to select an Argyll CMS executable directory in case the Argyll CMS executables were not found).</li>
<li>Don't block other windows when an operation fails while a progress dialog with a modal dialog on top is shown.</li>
</ul>
</dd>
<dt id="changelog-1.5.3.1">2013-10-23 20:09 (UTC) 1.5.3.1</dt>
<dd>
<h3>1.5.3.1</h3>
<h4>Added in this release:</h4>
<ul>
<li>New feature: When creating a profile from existing measurement data, averaging of measurements can be performed by selecting multiple files.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Fixed possible unicode error in logging module.</li>
<li>Fixed a bug with optimizing a testchart for untethered measurements halving the amount of different device combinations by repeating patches if the total patch count was even.</li>
<li>Mac OS X 10.6: Fixed weird behavior due to a bug in OS X 10.6's version of <code>sudo</code>.</li>
</ul>
</dd>
<dt id="changelog-1.5.2.5">2013-10-22 14:32 (UTC) 1.5.2.5</dt>
<dd>
<h3>1.5.2.5</h3>
<h4>Added in this release:</h4>
<ul>
<li><strong>Full Argyll CMS 1.6.0 support</strong> (e.g. JETI specbos 1211/1201, madVR calibration and 3D LUT generation, body centered cubic grid option for creating testcharts).</li>
<li>Testchart editor: Charts can be exported as PNG or TIFF files.</li>
<li>Testchart editor: Gamma and neutral axis emphasis controls.</li>
<li>Testchart editor: “Use current profile as preconditioning profile” button.</li>
<li>Testchart editor: Save VRML diagnostic files for testcharts without the need to re-generate the chart.</li>
<li>Testchart editor: Sort patches by L*, RGB, sum of RGB or sort RGB gray and white to top.</li>
<li><a href="#untethered">Untethered display measurement and profiling</a>. Be sure to read the note on optimizing testcharts for untethered measurements in automatic mode.</li>
<li>Shortcut for the BT.1886 tone curve (previously available by setting gamma to 2.4, absolute, and black output offset to zero).</li>
<li>3D LUT: Enable additional intents.</li>
<li>3D LUT: Support eeColor and <a href="http://pogle.pandora-int.com/download/manual/lut3d_format.html" title="Pandora 3D LUT format specification">Pandora</a> LUT formats.</li>
<li>3D LUT: Support Argyll CMS 1.6 video encodings and BT.1886 gamma mapping.</li>
<li><a href="#install-windows-driver">Windows 8 Argyll CMS driver installation instructions</a> to the ReadMe.</li>
<li><a href="#issue-win-process-startfail">Instructions how to proceed when a process cannot be started</a> to the ReadMe.</li>
<li>Softproof preset (based on FOGRA recommendation).</li>
<li>madVR preset.</li>
<li>sRGB preset.</li>
<li>Allow specifying extra arguments for Argyll's <code>targen</code> command.</li>
<li>Computer name, EDID serial and EDID CRC32 placeholders for use in the profile name.</li>
<li>Synthetic profile creation facility (e.g. for use as source in 3D LUT generation).</li>
<li>ACES RGB and DCI P3 colorspace definitions and reference profiles.</li>
<li><strong>Dry run.</strong> If enabled in the options menu, all functionality that calls Argyll CMS executables will effectively do nothing. This allows review of the used command line parameters by checking the log.</li>
<li>Additional session logs are saved for most operations involving the Argyll tools (i.e. directly in the folder where created files are saved to).</li>
<li>Show profile self check ΔE*76 info in profile installation dialog.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li><strong>Testchart and preset improvements:</strong>
<ul>
<li>All testcharts for LUT profiles have been complemented with additional single channel patches. This should in most cases improve average and maximum delta E of generated profiles, in some cases significantly. In fact, testing has shown that the new “small testchart for LUT profiles” with 154 patches total yields better results than the previous “extended testchart for LUT profiles” with 238 patches.</li>
<li>The charts for curves + matrix profiles have been improved by adding a few additional body centered cubic grid patches - all the charts which are not tuned for a certain display type are body centered cubic grid based (this was also the case previously for the LUT testcharts, but not for the matrix charts).</li>
<li>The patch order in the LUT charts has been optimized to improve measurement speed.</li>
<li>The chart for gamma + matrix profiles has been removed in favor of the updated default chart for matrix profiles.</li>
<li>New additional charts for LUT profiles have been added in various sizes.</li>
<li>For each of the new charts for LUT profiles, starting from the “very large” size, optimized farthest-point-sampled versions have been added which are pre-conditioned for several common display types: sRGB tone response with Rec. 709 primaries and D65 whitepoint (consumer-grade displays), gamma 2.2 with Rec. 709 primaries and D65 whitepoint (consumer-grade displays, TVs), gamma 2.2 with AdobeRGB primaries and D65 whitepoint (entry-level and high-end graphics displays), L* tone response with NTSC primaries and D50 whitepoint (high-end graphics displays).</li>
<li>The naming and patch count of the testcharts for LUT profiles has changed. The mapping that most closely resembles the old testcharts is as follows (total number of patches in parentheses):
<ul>
<li>Old “Default testchart for LUT profiles” (124) → new “Small testchart for LUT profiles” (154)</li>
<li>Old “Extended testchart for LUT profiles” (238) → new “Default testchart for LUT profiles” (270)</li>
<li>Old “Large testchart for LUT profiles” (396) → new “Extended testchart for LUT profiles” (442)</li>
<li>Old “Very large testchart for LUT profiles” (912) → new “Very large testchart for LUT profiles” (994)</li>
<li>Old “Massive testchart for LUT profiles” (2386) → new “Massive testchart for LUT profiles” (2527)</li>
</ul>
</li>
</ul>
Use of the new charts is highly recommended. All presets have been updated to use the new chart types. The “prepress" preset has also been updated to generate a XYZ LUT profile by default.</li>
<li>Detect if the instrument can use CCMX or CCSS colorimeter corrections based on the measurement mode. Disable colorimeter corrections for non-base display types.</li>
<li>Correctly map measurement mode to DISPLAY_TYPE_BASE_ID for all supported instruments when creating CCMX.</li>
<li>If a colorimeter correction with DISPLAY_TYPE_BASE_ID or DISPLAY_TYPE_REFRESH is selected, automatically set the correct measurement mode.</li>
<li>If measuring the colorimeter correction testchart, automatically ensure a suitable measurement mode for colorimeters (if they support more than refresh and non-refresh measurement modes).</li>
<li>Do not use spline interpolation for curve plots.</li>
<li>Updated french translation, thanks to Loïc Guégant.</li>
<li>Renamed calibration quality to calibration speed.</li>
<li>Set calibration speed for all presets to medium.</li>
<li>Standalone testchart editor: Parse first non-option argument as file to be opened.</li>
<li>Testchart editor: Always generate good optimized points rather than fast.</li>
<li>Testchart editor: Use existing file path when saving testchart.</li>
<li>Testchart editor: Greatly improved the speed of paste operations when comparatively large data sets are used.</li>
<li>Disallow -d and -D as extra arguments for Argyll's <code>targen</code> as the testchart editor only supports video RGB.</li>
<li>Reset adaptive measurement mode when restoring defaults.</li>
<li>Close all profile information windows when hiding the main window instead of just hiding them (don't reopen them when the main window is shown again).</li>
<li>Curve viewer: Use float formatting for input RGB display.</li>
<li>Only skip legacy serial ports if no instrument detected.</li>
<li>Also specify Argyll <code>dispcal</code>/<code>dispread</code> -y parameter for spectrometers.</li>
<li>Use Rec. 709 whitepoint chromaticity coordinates for “Video” preset.</li>
<li>Changed profile installation error message for virtual display devices.</li>
<li>Make it clearer which calibration is used when doing a “Profile only”: When a calibration file is going to be used, change the message from the warning “The current calibration curves will be used” to the informational “The calibration file <code><x></code> will be used” with the usual options to embed/not embed/reset video card gamma table.</li>
<li>Allow the use of calibration curves when profiling a web display.</li>
<li>When creating a colorimeter correction from profile(s), get the instrument name from the embedded TI3 if the data source is not EDID.</li>
<li>Do not specify (superfluous and thus ignored) patch window positioning arguments for <code>dispcal</code>/<code>dispread</code> when using a virtual display.</li>
<li>3D LUT: Removed black point compensation option (no longer easily possible because it now uses Argyll's <code>collink</code> internally. You can still have the effect of BPC by creating a display profile with BPC enabled and using it as destination profile during 3D LUT creation).</li>
<li>Always copy/move temporary files to the save location if not a dry run, also in case of an error. If copy/move fails, keep them in the temporary directory and inform the user.</li>
<li>Disable black point compensation for the “Prepress” preset (there are three presets without bpc - “madVR”, “Prepress” and “Softproof”) and use L* as calibration tone curve.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Show black point correction choice also when switching from refresh to any other measurement mode instead of only when switching from refresh to LCD measurement mode or vice versa.</li>
<li>Corrected averaged RGB transfer function display.</li>
<li>Adaptive measurement mode could not be disabled (regression of r1152 where adaptive measurement mode was made default in dispcalGUI).</li>
<li>Work-around a very rare problem where a (bogus) display size of 0x0 mm is returned.</li>
<li>Check if the configured colorimeter correction exists before adding it to the list.</li>
<li>Update colorimeter correction and testchart lists after deleting settings files.</li>
<li>Don't carry over colprof arguments from testchart file (fixes occasional wrong display model and manufacturer in profiles).</li>
<li>Average, RMS and maximum delta E metadata was not added to profiles if equal to or greater than 10.</li>
<li>Unhandled exception when 3D LUT window was opened and there was no profile selected under settings and also no display profile set.</li>
<li>Unhandled exception if colorimeter correction does not exist.</li>
<li>Standalone curve viewer: Fix loading of .cal file via commandline argument.</li>
<li>Don't strip trailing zeros when displaying average gamma in the status bar of the profile information or curve window.</li>
<li>Only set adaptive and hires measurement mode when the instrument supports it (fixes measurement mode switching to non-adaptive if toggling betweeen a colorimeter and a spectrometer).</li>
<li>Mac OS X with Argyll CMS 1.5 and newer: Also search library folders for Argyll CMS support files (fixes imported colorimeter corrections not found).</li>
<li>Only fall back to private copy of pnp.ids under Mac OS X and Windows.</li>
<li>Updated link to Datacolor website download section for the Spyder 2 Windows installers.</li>
<li>Transposed bits for EDID red y chromaticity coordinate.</li>
<li>Curve viewer / profile info window: Reset tone response curve calculation when toggling LUT checkbox.</li>
<li>Correctly react to detected display changes when the actual physical displays didn't change (e.g. when switching Argyll between versions supporting and not supporting the virtual “Web” display).</li>
<li>Keypresses or cancel were not recognized during patch reading.</li>
<li>Display uniformity measurements: Q or ESC had to be pressed twice to exit.</li>
<li>Do not use “install profile” message for non-display profiles.</li>
<li>3D LUT: “apply vcgt” checkbox stayed disabled after switching from a devicelink source profile to a non-devicelink source profile.</li>
<li>Update all open windows when switching Argyll versions</li>
<li>Do not reset selected colorimeter correction to none when selecting a preset or a settings file.</li>
<li>Measurement window position was not correct when switching from web display.</li>
<li>Show an error message when choosing a directory as profile save path where no subdirectories can be created.</li>
<li>Python 2.7 compatibility: Mask u16Fixed16Number (fixes profile information not working for profiles with negative XYZ or chromaticity values when using Python 2.7).</li>
<li>wxPython 2.9 compatibility: Do not specify number of rows in dynamically growing FlexGridSizer.</li>
<li>Linux: Use colord's quirk_vendor_name to fix the manufacturer string.</li>
<li>Mac OS X 10.6 and up: Clearing and loading calibration needs root privileges in some circumstances.</li>
<li>Windows: Correctly escape quotes in arguments (fixes hang when profile name, program path or Argyll path contains a single quote).</li>
<li>Windows: Show a meaningful error message when a subprocess can't be started instead of hanging indefinitely.</li>
<li>Windows: Ignore WMI errors.</li>
<li>Windows: Selecting testcharts saved in the root of a drive under Windows.</li>
<li>Windows: Disable broken Windows 2000 support (was broken since 0.8.5.6 when the interactive display adjustment GUI was introduced and is not fixable as Windows 2000 does not implement the required AttachConsole functionality).</li>
<li>Windows/Mac OS X: If Argyll profile installation failed, a success message was still shown.</li>
</ul>
</dd>
<dt id="changelog-1.2.7.0">2013-03-03 19:42 (UTC) 1.2.7.0</dt>
<dd>
<h3>1.2.7.0</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Colorimeter correction creation not working when using Argyll CMS 1.5.0 because of missing newly required fields in CGATS data.</li>
<li>Mac OS X: Accidentally swapped “/Users/<Username>/Library/Application Support” and “/Library/Application Support”.</li>
</ul>
</dd>
<dt id="changelog-1.2.6.6">2013-03-01 09:39 (UTC) 1.2.6.6</dt>
<dd>
<h3>1.2.6.6</h3>
<h4>Added in this release:</h4>
<ul>
<li>Argyll CMS 1.5.0 compatibility.</li>
<li>Ability to do remote measurements using Argyll CMS 1.4.0 and newer (Firefox is recommended as client). See <a href="#remote">remote measurements and profiling</a>.</li>
<li>Include black level and contrast in profile verification reports (if possible, i.e. if the test chart contains a RGB=0 patch).</li>
<li>3D LUT: Support color space conversion ('spac') profiles.</li>
<li>DCI P3 reference profile.</li>
<li>Add “Quality” (if applicable) and “License” metadata to profiles.</li>
<li>Add colord device ID mapping to profile metadata.</li>
<li>Linux: Add screen brightness to profile metadata if profiling a mobile computer's screen (using the org.gnome.SettingsDaemon.Power DBus interface).</li>
<li>Additional logging.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Revised display uniformity test to generate HTML reports.</li>
<li>Use a delay of 200 ms for display uniformity measurements.</li>
<li>Detect “Calibrate failed with 'User hit Abort Key' (No device error)” Argyll CMS error message and ignore further errors to prevent popping up multiple error dialogs.</li>
<li>Reload currently selected calibration after verifying a profile.</li>
<li>Add metadata to fast shaper matrix profiles (e.g. gamut volume and coverage).</li>
<li>When deleting a settings file, also offer CCSS, CCMX and files starting with the settings file basename in the same directory for deletion.</li>
<li>Enable use of absolute values in profile verification reports regardless of testchart.</li>
<li>When loading a profile without calibration settings, look for an accompanying colorimeter correction in the same directory.</li>
<li>When only creating a profile and not calibrating, give a clear choice whether to embed current calibration curves in a profile or not.</li>
<li>When using black point compensation, keep the black point compensated TI3 measurement file in addition to the unaltered file.</li>
<li>When restoring default settings, don't reset the 3D LUT abstract profile as well as 3D LUT and profile info window positions.</li>
<li>Truncate the colorimeter correction description displayed in the dropdown if it's overly long.</li>
<li>Only load linear calibration curves into the curve viewer when resetting the video card gamma table.</li>
<li>Do not remove spaces from the instrument name when assembling the profile name.</li>
<li>Only compress JavaScript in HTML reports if the <code>report.pack_js</code> configuration option is set (default 1 = compress).</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Improved instrument event handling.</li>
<li>When measuring the screen using a spectrometer, make sure to repeat the instrument calibration until it is successfully completed or canceled (ColorMunki Design/Photo).</li>
<li>When measuring ambient light with a spectrometer, abort after a 30 second timeout if instrument calibration did not complete.</li>
<li>Correctly react if the instrument sensor is in the wrong position and prompt the user to set the correct position.</li>
<li>Mouse cursor and clicked “Measure” button stayed hidden when aborting a measurement in the display device uniformity test window.</li>
<li>Updating the calibration (vcgt) of a profile didn't work if first selecting a <code>.cal</code> file, ticking the “Update calibration” checkbox and then switching to the profile.</li>
<li>Disable all calibration controls (except the quality slider) when “Update calibration” is ticked.</li>
<li>Only enable “Update calibration” checkbox if calibration can actually be updated.</li>
<li>Disable the “Create colorimeter correction...” and “Create 3D LUT...” menu items as well as the “LUT” checkbox in the curves and profile information windows if Argyll CMS executables are not found.</li>
<li>Update measurement modes when switching Argyll versions.</li>
<li>wxPython 2.9 compatibility.</li>
<li>Set manufacturer, model, creator and ID in reference profiles (except ClayRGB and sRGB from Argyll).</li>
<li>Only switch over to progress dialog after a three second delay (fixes erroneously switching over to progress dialog under Windows when running calibration or display uniformity measurements directly after a canceled testchart measurement).</li>
<li>If using a DTP92, only offer refresh measurement mode.</li>
<li>Make sure updated profiles also have updated descriptions.</li>
<li>Also overwrite .gam.gz and .wrz files if overwriting an existing profile.</li>
<li>Mac OS X: Make sure the menus are re-enabled after calibrate & profile.</li>
</ul>
</dd>
<dt id="changelog-1.1.8.3">2013-01-07 19:41 (UTC) 1.1.8.3</dt>
<dd>
<h3>1.1.8.3</h3>
<h4>Changed in this release:</h4>
<ul>
<li>Show display device uniformity measurement window on selected display device if multiple display devices are connected.</li>
<li>Hide mouse cursor and clicked button while measuring display device uniformity.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Sporadic measurement hang when measuring display device uniformity.</li>
<li>Wrong window being shown when calibrating after display device uniformity measurements or vice versa.</li>
</ul>
</dd>
<dt id="changelog-1.1.7.0">2013-01-05 13:32 (UTC) 1.1.7.0</dt>
<dd>
<h3>1.1.7.0</h3>
<h4>Added in this release:</h4>
<ul>
<li>Preliminary Argyll CMS 1.5.0 compatibility.</li>
<li>Added facility to measure and report display device uniformity. <strong>Known issue:</strong> Sometimes measurements hang. Press space to try and continue.</li>
<li>3D LUTs can optionally incorporate abstract (“Look”) profiles.</li>
<li>3D LUTs can be created from Device Link (class “link”) and input (class “scnr”) profiles.</li>
<li>3D LUTs can also be created in SPI3D format.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Updated french translation, thanks to Loïc Guégant.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Fedora: Calibration curves were reset to linear when installing a profile and using the Fedora packaged Argyll CMS.</li>
<li>Linux, Mac OS X, Windows (Administrator): Colorimeter corrections imported from i1 Profiler and ColorMunki Display software were not listed in the dropdown menu.</li>
</ul>
</dd>
<dt id="changelog-1.1.2.9">2012-11-05 20:32 (UTC) 1.1.2.9</dt>
<dd>
<h3>1.1.2.9</h3>
<h4>Changed in this release:</h4>
<ul>
<li>Simplified Spyder 2 enabling instructions.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Broken Unicode support (unhandled exception) when dealing with colorimeter correction descriptions containing 8-Bit characters.</li>
<li>Check if xicclu is found before attempting to use it for the profile information window (gets rid of bogus “'NoneType' object has no attribute 'encode'” message).</li>
<li>Use a default generic message when prompting to choose a profile.</li>
</ul>
</dd>
<dt id="changelog-1.1.2.1">2012-10-05 19:04 (UTC) 1.1.2.1</dt>
<dd>
<h3>1.1.2.1</h3>
<h4>Changed in this release:</h4>
<ul>
<li>Disable source profile selector in advanced gamut mapping options if not atleast one of perceptual or saturation checkboxes is selected.</li>
<li>Only show a warning if an incompatible colorimeter correction is explicitly selected via the filebrowser.</li>
<li>Show a less cryptic error message if an invalid file is selected when importing colorimeter corrections from other display profiling software.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Whitepoint color temperature is an integer, not a float. This fixes calibration settings being detected as changed when they actually haven't.</li>
<li>Worked around a bug in wxPython where controls in a hidden window react to focus events. This fixes the sporadic hang after calibration measurements during a “Calibrate & profile” run.</li>
<li>Linux, Mac OS X: Unhandled exception when trying to import colorimeter corrections from other display profiling software and selecting a file with '.txt' extension.</li>
</ul>
</dd>
<dt id="changelog-1.1">2012-09-15 15:38 (UTC) 1.1</dt>
<dd>
<h3>1.1</h3>
<h4>Added in this release:</h4>
<ul>
<li>Additional profile name placeholder %ds for the display device serial from EDID if applicable (may be empty or bogus).</li>
<li>Windows: Additional profile name placeholders %dnw (DeviceString) and %dnws (shortened DeviceString, it may be the same as %dnw if shortening isn't possible). The former is equivalent to what's shown in the display device dropdown. The DeviceString is often more verbose as the sometimes very generic EDID device name (placeholder %dn).</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Updated spanish translation (thanks to Roberto Quintero).</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Show an error message if a colorimeter correction cannot be used with the selected instrument.</li>
<li>Show an error message when trying to import colorimeter corrections from an unsupported filetype.</li>
</ul>
</dd>
<dt id="changelog-1.0.9.0">2012-08-01 10:13 (UTC) 1.0.9.0</dt>
<dd>
<h3>1.0.9.0</h3>
<h4>Changed in this release:</h4>
<ul>
<li>Use the original file basename for colorimeter corrections copied over to the storage directory (previously, if a colorimeter correction was copied, it inherited the same basename as the rest of the measurement/profile/calibration files, thus making it a bit cumbersome to determine which colorimeter correction was originally the source, especially in profile verification reports which only showed the filename and not the description from the file contents).</li>
<li>Show colorimeter correction file basename in addition to the description if they are different.</li>
<li>Linux: Fall back to gcm-import if colord profile installation fails.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>When switching to L*/Rec. 709/SMPTE or sRGB and then loading settings with a gamma value, the gamma entry field was not shown.</li>
<li>Report on calibrated/uncalibrated display and calibration verification did not work if using a colorimeter correction (regression of changeset #1020).</li>
<li>Do not freeze if loading a settings file which had an accompanying colorimeter correction that was since deleted.</li>
<li>Windows 2000: Don't fail to launch.</li>
</ul>
</dd>
<dt id="changelog-1.0.7.7">2012-06-28 22:05 (UTC) 1.0.7.7</dt>
<dd>
<h3>1.0.7.7</h3>
<p>This is a bug-fix release for version 1.0.7.6.</p>
<h4>Fixed in this release:</h4>
<ul>
<li>Unhandled exception in gamut view calculation after profile creation if using french localization.</li>
</ul>
</dd>
<dt id="changelog-1.0.7.6">2012-06-23 00:25 (UTC) 1.0.7.6</dt>
<dd>
<h3>1.0.7.6</h3>
<h4>Added in this release:</h4>
<ul>
<li>Option to auto-select a suitable colorimeter correction if available locally.</li>
<li>Ability to choose between L*a*b*, XYZ and xyY in profile verification reports.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Reset default black point correction from automatic to off.</li>
<li>If a profile contains no 'vcgt' tag, assume linear calibration.</li>
<li>When creating a colorimeter correction, remember the last selected reference and colorimeter measurement file separately.</li>
<li>When creating a colorimeter correction, automatically only use white, red, green and blue patches (at 100% device value each) from measurement files, regardless if they contain more patches. This allows re-using of measurement files with different patch counts (as long as they contain those four combinations) that have been created as by-product of other operations, e.g. during profiling. Note that measurements still need to be done under identical conditions and within reasonable timeframe (ideally less than a few minutes apart) to minimize effects of display and instrument drift when creating colorimeter corrections from them.</li>
<li>When measuring the colorimeter correction testchart, automatically set the resulting measurement as last selected reference or colorimeter file depending on whether it contains spectral data or not.</li>
<li>When restoring the current calibration after measuring the colorimeter correction testchart, do it silently (don't show a message window).</li>
<li>Filter colorimeter corrections by selected instrument.</li>
<li>Show colorimeter correction description in the dropdown instead of the filename. Show the filename and path on mouse hover.</li>
<li>ColorHug: Only enable colorimeter corrections for “Factory” and “Raw” measurement modes.</li>
<li>ColorHug: Automatically set “Factory” measurement mode when measuring the colorimeter correction testchart and measurement mode is not yet “Factory” or “Raw”. Restore previous measurement mode afterwards.</li>
<li>Linux: Enable ColorHug support by default.</li>
<li>Linux: colord wrapper now uses PyGObject instead of ctypes.</li>
<li>Updated french translation, thanks to Loïc Guégant.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>When creating a 3D LUT, don't fail if the target profile contains no 'vcgt' tag and the preference is “Apply calibration” (which is the default) irrespective of checkbox state.</li>
<li>Use colorimeter correction (if applicable) from settings stored in calibration files and profiles when loading them.</li>
<li>When creating a colorimeter correction, the display name in the description is now taken from the measurement file if available.</li>
<li>When creating a colorimeter correction, automatically order the measurements exactly the same by device (RGB) triplets.</li>
<li>Hide any profile information window(s) when the main window is hidden and restore them when it is shown again.</li>
<li>Correct ID on profile created from EDID after adding gamut coverage/volume metadata.</li>
<li>Measurement modes other than “LCD (generic)” and “Refresh (generic)” are now correctly restored from settings embedded in calibration files and profiles.</li>
<li>If using the current calibration curves for profiling without calibrating (“Profile only” with “Reset video card gamma table” unchecked), using Argyll CMS 1.4.0, the resulting profile will now contain a 'vcgt' tag with the current calibration like with previous Argyll versions.</li>
<li>RGB bars and chromaticity/color temperature readouts when adjusting a whitepoint with blackbody target are now working correctly.</li>
<li>Ignore and do not show any explicitly selected Colorimeter Calibration Spectral Sample (CCSS) file for instruments that do not support it.</li>
<li>Changing Argyll version/binaries in dispcalGUI with automatic instrument detection switched off is working correctly again without the need to restart the program.</li>
<li>Show ColorHug-specific measurement modes (please run instrument detection once again to refresh the list if you already used the ColorHug in a previous version of dispcalGUI).</li>
<li>Saturation gamut mapping settings are no longer ignored.</li>
<li>Trying to view profile information for profiles whose black point X Y Z sum is zero will no longer result in a division by zero error.</li>
<li>Black point compensation is no longer attempted if not atleast one black or white patch is found in measurement data.</li>
<li>Linux: Don't error out if profile installation with dispwin fails, but profile installation via colord or oyranos-monitor is successful (fixes profile installation when using the distribution-packaged Argyll under Fedora)</li>
<li>Linux: colord device key name now correctly adheres to device naming spec for xrandr devices (fixes some profile installation problems).</li>
<li>Linux, Windows: Correctly detect in the profile loader if linear calibration is assumed when using Argyll CMS 1.4.0 or newer.</li>
<li>Windows: Continuous measurements during interactive display adjustment are now stopped reliably when clicking the “Stop measurements” button or hitting the space key.</li>
</ul>
</dd>
<dt id="changelog-0.9.9.1">2012-04-02 19:24 (UTC) 0.9.9.1</dt>
<dd>
<h3>0.9.9.1</h3>
<h4>Added in this release:</h4>
<ul>
<li>Spyder 4 support if using Argyll CMS >= 1.3.6. To make all measurement modes available, you have to use “Import correction matrices from other display profiling softwares...” from the “Tools” menu.</li>
<li>Experimental ColorHug support is enabled through Argyll CMS >= 1.3.6 if the <code>ENABLE_COLORHUG</code> environment variable is set, but the ColorHug currently doesn't work reliably across all platforms.</li>
<li>Added information about <a href="#settings_measurement_modes">instrument measurement modes</a> to the ReadMe.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>GUI spring-cleaning: Re-arranged some controls and replaced radiobuttons and read-only combo-boxes with choice controls instead. Only the controls related to a selected choice are shown.</li>
<li>Default calibration black point correction to automatic.</li>
<li>Replaced previous 19-patch colorimeter correction testchart with smaller 4-patch version (just red, green, blue at 100% each and white, as is the default with Argyll CMS 1.3.6).</li>
<li>Linux packages: Added Argyll CMS to dependencies. Please note: If you want the latest Argyll features or run into problems, it is recommended to download the standalone Argyll binaries from argyllcms.com as the distribution repositories often only contain older Argyll CMS releases.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Fixed unhandled exception when adding metadata to a profile from EDID that contains an invalid (out of range) gamma value.</li>
<li>Fixed slightly off the mark whitepoint in resulting profile when using black point compensation (typical max. error 0.2 ΔE*76). You may want to <a href="#create_profile_from_measurement_data">re-create existing profiles</a>.</li>
<li>Do not reset visibility of advanced calibration options when restoring defaults.</li>
<li>Store black point compensation setting in profiles.</li>
<li>Mac OS X: The application bundle now again contains all required files (no missing files when dragging just the bundle to Mac OS X “Applications” folder).</li>
</ul>
</dd>
<dt id="changelog-0.9.6.6">2012-03-15 14:45 (UTC) 0.9.6.6</dt>
<dd>
<h3>0.9.6.6</h3>
<h4>Added in this release:</h4>
<ul>
<li><strong>Black point compensation option for profiles (default ON).</strong> This effectively prevents black crush, but at the expense of accuracy of the resulting profile.</li>
<li><strong>Profile information window with 2D gamut plot</strong> as well as information pane which shows profile header and tag data in detail (with few exceptions).</li>
<li><strong>Ability to create display correction 3D LUTs</strong> for use in movie post-processing applications that don't have ICC support. Currently supported are the <code>.3dl</code> and <code>.cube</code> formats.</li>
<li>Write gamut VRML files and calculate coverage and volume percentages against sRGB and Adobe RGB when creating profiles.</li>
<li>Add 'chrm' tag (xy chromaticities for each primary) to created profiles. Unlike the values from 'rXYZ', 'gXYZ', 'bXYZ', A2Bx or 'clrt' tags, the 'chrm' data corresponds to the actual measured chromaticities without chromatic adaptation or interpolation. The 'chrm' tag is purely informational.</li>
<li>Windows 7 and later: Added an option to let the operating system handle calibration loading when installing a profile (this option requires dispcalGUI to be run as Administrator and is also available in the dispcalGUI installer. If selecting the option there, the dispcalGUI Profile Loader will not be installed to the startup items. A shortcut to the loader is still available in the dispcalGUI folder in the start menu though, to be able to quickly force a reload of calibration).</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li><strong>Instrument detection now defaults to manual.</strong> A click on the icon with the swirling arrows or choosing the corresponding menu item in the “Options” menu detects connected instruments. Automatic instrument detection can be (re-)enabled/disabled there, too.</li>
<li>The dispcalGUI Profile Loader can now be set to not show error messages again (errors will still be logged).</li>
<li>Tone response curves are now plotted as L* → RGB by default and are also calculated for LUT profiles (profiles with both LUT and matrix TRC tags allow on-the-fly switching between them). In addition, the transfer function is shown if it can be estimated.</li>
<li>Windows: Allow enabling/disabling of calibration loading on login when installing a profile (to be able to change this option when Windows 7 or later is set up to handle calibration loading, either dispcalGUI needs to be run as administrator or in the Windows color management control panel “Advanced” tab, click on “Change system defaults...” and disable “Use Windows display calibration”).</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Do not fail to launch due to unhandled exception when parsing CGATS files containing KEYWORD, INDEX, SAMPLE_ID or DATA_FORMAT values in exponential notation.</li>
<li>Do not use exponential notation for low (< 0.0001) calibration black level target values.</li>
<li>Correctly handle failed instrument calibration (by asking to repeat) and measurement failures which are not misreads or communication failures (and should thus not be retried automatically).</li>
<li>Also look at ASCII descriptor blocks when determining the display device name from EDID (fixes display model not being set in profiles for certain Apple displays).</li>
<li>Don't loose 'mmod' tag (monitor make and model) when creating a profile from measurement data embedded in an existing profile.</li>
<li>Automatically restore calibration after measuring the colorimeter correction testchart.</li>
<li>Restore Argyll CMS < 1.3.0 compatibility (broken in 0.8.9.3).</li>
<li>Windows Vista, 7 and later: Automatically enable “Use my settings for this device” in Windows' colormanagement settings when installing a profile.</li>
</ul>
</dd>
<dt id="changelog-0.8.9.3">2012-02-11 03:56 (UTC) 0.8.9.3</dt>
<dd>
<h3>0.8.9.3</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Selecting a smaller default testchart than the recommended one did not work (was reset to the recommended default when starting measurements or re-starting dispcalGUI).</li>
<li>Restore previously selected testchart if canceling colorimeter correction measurements.</li>
<li>Disable the “Measure” button in the “Create colorimeter correction” dialog if no display or instrument detected/selected.</li>
<li>Disable menus while the main window isn't shown (only affects operating systems where the menu is not part of the main window e.g. Mac OS X).</li>
<li>Linux: Fixed i1 Display Pro / ColorMunki Display missing from Argyll udev rules (this was actually already fixed in 0.8.5.2, but not mentioned in the changelog).</li>
<li>Mac OS X Lion: Removed sporadic password dialog being shown after calibration measurements when running “Calibrate & profile”.</li>
<li>Mac OS X Lion: Fixed an issue with profile installation for the current user which only installed the profile for the root user, thus not making it available in system preferences and making e.g. the login screen the only visible place where it was effectively being used.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Allow the selection of LCD or CRT measurement modes for spectrometers too (determines the available controls during interactive display adjustment).</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>GUI for interactive display adjustment.</li>
<li>Add 'mmod' tag (monitor make and model, an Apple-specific private tag) to created profiles (ensures the profiles still show up in Mac OS X system preferences if “Show profiles for this display only” is ticked).</li>
</ul>
</dd>
<dt id="changelog-0.8.5.2">2012-01-24 18:40 (UTC) 0.8.5.2</dt>
<dd>
<h3>0.8.5.2</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Added missing numbers to “delta E too high” message when trying to upload a profile with low self-fit accuracy.</li>
<li>Decoding of numerical manufacturer ID from EDID when adding metadata to a profile was done in the wrong byte order.</li>
<li>Fixed missing terminating NUL character for copyright tag when creating a profile from EDID.</li>
<li>Fixed missing underscore in EDID colorimetric metadata key names as per the <a href="http://www.oyranos.org/wiki/index.php?title=ICC_meta_Tag_for_Monitor_Profiles_0.1">ICC meta Tag for Monitor Profiles</a> specification.</li>
<li>Linux: Display measurements couldn't be started if dispcalGUI was installed via the 0install feed.</li>
<li>Mac OS X: The file which maps Plug'n'Play device IDs to manufacturer names was not found when running from the application bundle, resulting in manufacturer entries in profiles always being equivalent to the three-letter PnP ID instead of the full manufacturer name.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Measurements for colorimeter corrections can now be started directly from the dialog, and the previous testchart is restored afterwards.</li>
<li>Add more metadata to generated profiles to allow better automatic selection/ranking on systems that support it and standardized a few previously dispcalGUI-only keys (<a href="http://www.oyranos.org/wiki/index.php?title=ICC_meta_Tag_for_Monitor_Profiles_0.1">ICC meta Tag for Monitor Profiles</a> / <a href="http://gitorious.org/colord/master/blobs/master/doc/metadata-spec.txt">GCM metadata specification</a>).</li>
<li>Use product code as fallback for make/model when creating profiles from EDID.</li>
<li>Windows: In case of an Argyll CMS 'config 1 failed' error upon trying to use an instrument, inform the user its driver may not be installed.</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Added ability to specify the display technology for created colorimeter corrections.</li>
<li>Enabled overriding of default gamut mapping intents for LUT profiles. “Luminance matched appearance” is the default override for perceptual intent, which provides an effect similar to black point compensation.</li>
<li>The <a href="http://dispcalgui.hoech.net/colorimetercorrections/">colorimeter corrections database</a> now has a public web interface and API.</li>
</ul>
</dd>
<dt id="changelog-0.8.1.9">2011-12-08 13:33 (UTC) 0.8.1.9</dt>
<dd>
<h3>0.8.1.9</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Ignore 'unknown' (not required) fields when verifying CGATS (fixes bug 'invalid testchart' after profiling with spectrometer, introduced in r780).</li>
<li>Force a default testchart if the selected one is invalid.</li>
<li>Linux (autopackage): Set <code>PYTHONDONTWRITEBYTECODE=</code> (empty string) to fix installation on Mandriva 2011.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Default profile type should be 3x shaper + matrix, not single shaper + matrix.</li>
<li>Some of the advanced calibration options (gamma type relative/absolute, ambient adjustment, black point correction and offset) are now hidden by default and can be shown via the corresponding menu item in the options menu.</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Option to share profiles via the <a href="http://icc.opensuse.org/">openSUSE ICC Profile Taxi</a> service.</li>
<li>Option to create profiles from extended display identification data (EDID).</li>
<li>Linux (GNOME 3): <a href="http://www.freedesktop.org/software/colord/">colord</a> compatibility (query current profile, install & set profile).</li>
</ul>
</dd>
<dt id="changelog-0.7.8.9">2011-10-06 21:44 (UTC) 0.7.8.9</dt>
<dd>
<h3>0.7.8.9</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Additional commandline arguments were ignored when doing profile verification measurements.</li>
<li>Windows: If the startup folder in the start menu was deliberately deleted, the profile loader shortcut wasn't created when installing a profile.</li>
<li>Windows: Profile loader correctly verifies if the calibration was sucessfully loaded.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Skip legacy serial ports by default when detecting instruments (serial instruments like the DTP92 or Spectrolino will no longer be selectable unless you manually set <code>skip_legacy_serial_ports = 0</code> in <code>dispcalGUI.ini</code> or use a serial to USB adapter).</li>
<li>Windows: The profile loader shortcut in the startup folder inside the start menu is now created at installation time (and removed when uninstalling).</li>
<li>When checking for program updates, show the changelog for the new version if an update is available.</li>
<li>Confirm enabling of debugging output.</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Support for Argyll CMS 1.3.4 features: i1 Display Pro and Colormunki Display, Colorimeter Calibration Spectral Sample (.ccss) files.</li>
<li>Ability to import colorimeter corrections from other display profiling softwares. Currently iColor Display, i1 Profiler and ColorMunki Display are supported.</li>
<li>Ability to create correction matrices and Calibration Spectral Sample files, with the option to share them via an online database.</li>
<li>Option to automatically check for program updates on startup.</li>
<li>Added <a href="#issue-linux-libmtp">information how to fix instrument not working correctly/constantly disconnecting under Linux due to a conflict with libmtp</a> (thanks to Pascal Obry who notified me of the issue back in May 2011).</li>
</ul>
</dd>
<dt id="changelog-0.7.3.7">2011-08-05 01:06 (UTC) 0.7.3.7</dt>
<dd>
<h3>0.7.3.7</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Linux: Fixed multi-display support when not using separate X screens.</li>
<li>Mac OS X: Fixed not being able to run under a standard user account, and Mac OS X 10.7 compatibility.</li>
<li>Mac OS X 10.4.x: Fixed functionality requiring elevated privileges, e.g. installing profiles system wide or enabling the Spyder 2 using Argyll 1.1.x (regression of a change introduced in r706 / 0.7.0.7)</li>
<li>Windows: Fixed several problems with special characters in paths which are not representable through the file system encoding.</li>
<li>Windows: Worked around OS localtime() bug. If the system's clock was set to a date far into the future, dispcalGUI failed to launch on subsequent runs because of the logfile's timestamp which could not be processed by localtime().</li>
<li>Windows Vista/7: Querying the user display profile resulted in a “not found” error if the checkbox “Use my settings for this device” was never ticked in Windows' color management control panel, failing the fallback of querying the system display profile in case of no user display profile.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>All presets now use curves + matrix as profile type (for better overall application compatibility).</li>
<li>Better feedback when trying to open broken/invalid files (display an error dialog instead of just logging the error).</li>
<li>Icons in the task switcher on Windows Vista/7 (and presumably Linux) should now be crisp and not pixelated.</li>
</ul>
</dd>
<dt id="changelog-0.7.0.7">2011-06-02 21:45 (UTC) 0.7.0.7</dt>
<dd>
<h3>0.7.0.7</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>wxPython 2.8.12 compatibility.</li>
<li>Linux: Preserve environment when installing a profile system-wide so $DISPLAY is available for dispwin.</li>
<li>Linux (Source): Changed highest supported Python version to “lower than 3.0” because openSUSE Build Service would choke on “lower than or equal to 2.7” when building for Ubuntu 11.04.</li>
<li>Linux (Source): Fixed setup.py bdist_deb as far as possible (see notes under <a href="#install-src">installing from source</a>, additional setup commands, bdist_deb)</li>
<li>Windows: Fixed error when the display profile cannot be determined (e.g. when running remotely).</li>
</ul>
</dd>
<dt id="changelog-0.7.0.0">2011-04-20 21:08 (UTC) 0.7.0.0</dt>
<dd>
<h3>0.7.0.0</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Updating profile verification reports created in versions prior to revision 672 should not strip calibration and gray balance information anymore (regression of a change in r672).</li>
<li>If the Spyder 2 was enabled using Argyll CMS 1.2 or newer, this should now be reflected correctly in the “Tools” menu by a checkmark next to the “Enable Spyder 2” menu item.</li>
<li>Linux (Autopackage, DEB and RPM installs) and source: Fixed missing application icons in sizes other than 16x16 and 32x32 if the source archive was created with setup.py under Mac OS X or Windows (regression of a change in r501).</li>
<li>Linux/Windows: The location of the Argyll binaries was not stored in the system-wide configuration, which could prevent the profile loader from finding the Argyll binaries if they were not on the PATH environment variable and a profile was installed system-wide.</li>
<li>Windows: Fixed program termination if EnumDisplayDevices fails (e.g. when running remotely).</li>
<li>Windows: Fixed program termination if a display device has no driver entry in the registry (the very generic Windows error message is misleading in that case: It pretends a file was not found).</li>
<li>Windows XP: Correctly enumerate display device names and EDID.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>When doing verification measurements of a (non-Argyll) profile containing a chromatic adaptation 'chad' tag, dispcalGUI now tries to use the same chromatic adaptation transform to calculate adapted values from the measurements instead of using a hardcoded Bradford transform.</li>
<li>The default delta E formula for “RGB + gray balance” evaluation is now DE 2000.</li>
<li>The delta E formula is now locked for the Fogra MediaWedge and IDEAlliance Control Strip evaluation criteria.</li>
<li>The “Update calibration” and “Update profile” checkboxes were combined into one. This removes the ambiguity about what “Update profile” functionality actually was: Only updating the calibration inside the profile. Both updating stand-alone calibration '.cal' files and calibrations embedded in profiles are now handled with the single “Update calibration” checkbox. The slightly different workflow of only updating the calibration, and then creating an actual new profile on top of it in one go, is still possible by explicitly loading a calibration '.cal' file under “Settings”.</li>
<li>Made the GUI a bit nicer towards low screen resolutions by moving more controls into the scrollable area and also removing the graphical banner and allowing horizontal scrollbars if things get really cramped.</li>
<li>Windows Vista/7 and later: To be able to install a profile system-wide, you now need to run dispcalGUI explicitly as administrator (right-click the dispcalGUI icon, then select “Run as administrator”) to show the appropriate controls in the profile installation dialog.</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Documentation: Updated the information for <a href="#issue-win-photoshop-monprofdefect">Photoshop's “The monitor profile […] appears to be defective”</a> message under <a href="#issues">Known issues and solutions</a>.</li>
<li>Documentation: Added <a href="#issue-winxp-multidisplay">Windows XP multiple displays and profiles</a> under <a href="#issues">Known issues and solutions</a>.</li>
</ul>
</dd>
<dt id="changelog-0.6.7.7">2011-01-24 03:56 (UTC) 0.6.7.7</dt>
<dd>
<h3>0.6.7.7</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Fixed measurements hanging at the start if using the black background option.</li>
<li>wxPython 2.9 compatibility.</li>
<li>Windows: Potential COM error caused by obsolete code.</li>
<li>Windows Vista/7: Potential WMI errors when trying to read a display's EDID are now suppressed (the EDID can not be read on systems where WMI has errors, which may prevent more accurate display descriptions, but will not impede functionality otherwise).</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Profiles can now be dragged and dropped onto the curve viewer.</li>
<li>When using the profile verification feature, it is now possible to first select a simulation profile before choosing a testchart.</li>
</ul>
</dd>
<dt id="changelog-0.6.6.7">2010-11-05 03:12 (UTC) 0.6.6.7</dt>
<dd>
<h3>0.6.6.7</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Re-enabled warning message from the profile loader if the calibration in the video card does not match the requested calibration after loading.</li>
<li>Fixed “Show curves” checkbox in the profile installation dialog not doing anything if the curve viewer was not shown before (regression of a change in version 0.6.2.2).</li>
<li>Fixed a small visual glitch where the message “Calibration complete” was not cleared from the progress window after instrument calibration.</li>
<li>Fixed possibility of unprintable characters from EDID strings (e.g. display name) causing errors.</li>
<li>Fixed Argyll CMS diagnostic output not working for dispwin when using Argyll CMS 1.3.1</li>
<li>Linux: Fixed Autopackage install not working with Python 2.7</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Linux: Added a “Load profile and calibration on login” checkbox to the profile installation dialog. Normally, you want to keep this checked, so that dispcalGUI's profile loader can setup the configured display(s). But if you use another solution for loading profiles, like Oyranos with the CompICC plugin, you should uncheck it, so that display profiles are solely handled by CompICC.</li>
<li>Mac OS X: Like on the other platforms, EDID is now used if available.</li>
</ul>
</dd>
<dt id="changelog-0.6.5.3">2010-10-24 04:36 (UTC) 0.6.5.3</dt>
<dd>
<h3>0.6.5.3</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Fixed a bug where the wrong correction matrix setting was stored in a profile or calibration file when changing the correction matrix, and creating a profile with a previous settings file selected which used a different correction matrix. Note this didn't affect measurements when creating the new profile or calibration file, but when loading it in dispcalGUI, the correction matrix used for the previously selected settings file was set instead of the one actually used when creating the new file.</li>
<li>Fixed missing XYZ values for the assumed whitepoint in profile verification reports.</li>
<li>Fixed crash when the manufacturer ID from a display's EDID contains invalid data.</li>
<li>Honor the selected display when loading calibration curves from a settings file.</li>
<li>Linux: Installing profiles under multi-display configurations using separate X screens should now work better when Oyranos is installed (previously, when the profile for the second screen was installed after the profile for the first screen, it would override the first profile in the Oyranos configuration. Profiles can be re-installed with this version of dispcalGUI to fix this).</li>
<li>Linux: Profile loader: When Oyranos is installed, but not xcalib, the fallback to dispwin to load the calibration curves was not working.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Reset additional commandline arguments too when restoring defaults.</li>
<li>The profile loader will no longer show an error message when unable to determine a display's current ICC profile, as there may just not be any profile installed for the respective display. Instead, such errors are now silently logged.</li>
<li>Improved error messages from the profile loader by adding some information about the affected display for easier troubleshooting of multi-display configurations.</li>
<li>Windows: Profile installation: When a system-wide autostart entry for the calibration loader already exists, do not create a per-user entry.</li>
<li>Linux: The autopackage can now be installed just for the current user. Note this will not setup instrument access though, as that requires root privileges.</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Save the device model and manufacturer description to measurement data (.ti3) files and use that information when creating a profile.</li>
<li>Log all output from the profile loader.</li>
<li>Ability to just measure a testchart and create a measurement data file (menu “Options”, “Measure testchart”).</li>
<li>Approximate gamma for grayscales is shown in profile verification reports.</li>
<li>Build system: Added <code>--skip-postinstall</code> option.</li>
</ul>
</dd>
<dt id="changelog-0.6.2.2">2010-09-19 17:53 (UTC) 0.6.2.2</dt>
<dd>
<h3>0.6.2.2</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Trying to verify or view curves of a (non-Argyll) profile with a 'formula' type vcgt tag no longer fails with a 'NameError'.</li>
<li>When the measurement window was moved to the leftmost and/or topmost coordinates of the screen, the calculated relative position could become negative and prevent starting measurements.</li>
<li>Trying to profile a display which provides an empty model description via EDID no longer fails.</li>
<li>Profile name placeholder %im (instrument measurement mode) now inserts the correct string.</li>
<li>Profiling did not finish if “Show actual calibration curves from video card gamma table” was checked and the curves window shown.</li>
<li>Fixed black point correction rate not being restored correctly when loading settings.</li>
<li>Fixed conversion of the color temperature to xy chromaticity coordinates (the input fields in the GUI) which was erroneously being calculated with the formula for daylight even if a blackbody locus was chosen.</li>
<li>Fixed assumed whitepoint in profile verification reports erroneously being calculated with the formula for daylight even if a blackbody locus was originally chosen when creating the profile.</li>
<li>Fixed profile verification reports not working in Internet Explorer 5.x-6.0 and Opera 7.x.</li>
<li>Fixed profile verification reports showing “missing data” for some fields if using the Fogra Media Wedge V3 criteria and the reference file contained both XYZ and Lab data.</li>
<li>Mac OS X: A double extension (.icc.icm) is no longer added when creating a profile from an existing one (menu “Options”, “Create profile from measurement data...”).</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>When loading settings from calibration (.cal) files, the actual parameters chosen when calibrating are now set instead of stored measured values (e.g. whitepoint, black- and white level. Will only work for .cal files created in this version and up).</li>
<li>“Allow skipping of spectrometer self-calibration” (in the “Options” menu) for characterization readings after calibration is now disabled by default to help sensor stability (especially for the ColorMunki).</li>
<li>Black point correction rate now uses a floating-point control with the range 0.05...20.0 (consistent with the Argyll CMS dispcal commandline tool) instead of the previous integer control with the range 5...2000.</li>
<li>The default evaluation criteria for RGB testcharts in profile verification reports is now RGB only.</li>
<li>The default Delta E formula used for results in profile verification reports is now Delta E 2000 (except for standardised criteria like the Fogra Media Wedge V3).</li>
<li>Additional statistics in profile verification reports are now hidden by default.</li>
<li>Selecting “CMYK” or “RGB” in profile verification reports now actually makes a difference (shows the corresponding device values in the overview).</li>
<li>“Evaluate gray balance through calibration only” in profile verification reports is now disabled by default.</li>
<li>Windows: Installing a profile system-wide removes an existing user autostart entry for the profile loader to avoid having two entries.</li>
<li>Windows: EDID info will be used if available instead of generic device strings ('PnP-Monitor' et al).</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Ability to enable Argyll CMS diagnostic (debugging) output for measurements via menu “Options”.</li>
<li>Option to choose blackbody whitepoint reference instead of daylight in profile verification reports.</li>
<li>Original profile whitepoint is now shown in profile verification reports.</li>
<li>Instrument black level and display white level drift compensation options when using Argyll CMS >= 1.3.0</li>
<li>Ability to choose a correction matrix for colorimeters when using Argyll CMS >= 1.3.0</li>
<li>Allow setting of additional commandline arguments for dispcal, dispread, spotread and colprof via a new menu item in the “Options” menu.</li>
<li>IDEAlliance Control Strip 2009 aim values for profile verification with CMYK test charts.</li>
<li>Profile verification report shows instrument measurement mode and correction matrix (if any).</li>
<li>Menu option to update existing profile verification reports with the current templates.</li>
</ul>
</dd>
<dt id="changelog-0.5.8.1">2010-08-01 03:19 (UTC) 0.5.8.1</dt>
<dd>
<h3>0.5.8.1</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Argyll CMS 1.2.0 compatibility</li>
</ul>
</dd>
<dt id="changelog-0.5.8.0">2010-07-25 13:19 (UTC) 0.5.8.0</dt>
<dd>
<h3>0.5.8.0</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>The timeout of 10 seconds for the startup of Argyll tools and instrument initialization was too short for some instruments and is now increased to 30 seconds. If the timeout is ever exceeded, dispcalGUI should now also abort automatically and no longer hang.</li>
<li>When previewing the calibration upon profile installation, use a linear calibration if no display profile is present when toggling the preview on and off (fixes the curve viewer not updating).</li>
<li>Fixed closing the log window not re-enabling the “show log automatically” menuitem.</li>
<li>Linux (Autopackage install): Fixed menu entry sometimes disappearing permanently after logging out under GNOME.</li>
<li>Linux: Fixed dispcalGUI not working if libX11 or libXrandr do not expose certain functions (e.g. under Mandriva 2009).</li>
<li>Linux: Fixed not being able to install a profile using GNOME Color Manager when the profile was not writable.</li>
<li>Linux: Fixed not being able to install a profile using Oyranos when the profile was not located in ~/.color/icc/devices/display.</li>
<li>Linux/Mac OS X: Saving a log file from the log window now works correctly.</li>
<li>Mac OS X: The terminal should no longer lose its focus when the measurement area is shown. This should also make the mouse cursor reappear which is otherwise hidden by dispcal/dispread.</li>
<li>Mac OS X 10.6: The current display profile should now be determined correctly (e.g. for the curve viewer) when loading its calibration curves or selecting the “<Current>” settings.</li>
<li>Windows (installer): An unused console window is no longer shown when launching dispcalGUI via the installed shortcuts.</li>
<li>Windows: Fixed executable not working under Windows 2000.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Do not pass through the “hit any key to retry” message from Argyll CMS tools to the progress dialog in case of misreads/port communication problems (retries happen automatically, so there is no need and also no possibility for keyboard interaction).</li>
<li>Enabling the Spyder 2 is now less cumbersome if the original installation CD is not available (especially on Mac OS X, where the firmware couldn't be found if a recent version of the Spyder 2 software was installed) and should work with the downloadable Spyder 2 software installers (but they need to be run to install the software first because the firmware can't be extracted from the installer binaries directly). Messages are now hopefully more informative to give a better idea of what to do. If the firmware can't be extracted from the Spyder 2 software installer, you are asked to install the software and try again. If that can't be done because of platform incompatibility (Linux), the last choice is to locate the Spyder.lib/CVSpyder.dll file manually (it must be copied from a Mac OS X or Windows system in that case).</li>
<li>Linux: Allow installation of profiles using GNOME Color Manager even if XRandR is not working/available.</li>
<li>Linux: Installation now checks for existing udev rules/hotplug scripts for instruments and only installs its own rules if none exist yet.</li>
<li>Linux/Windows: The profile loader will now show a warning dialog if a profile couldn't be loaded.</li>
<li>Linux/Windows: Device model and manufacturer are added to profiles if <acronym title="Extended Display Identification Data">EDID<sup><a href="#definition_EDID">[10]</a></sup></acronym> info is available.</li>
</ul>
<p>+ Numerous other small fixes and changes.</p>
</dd>
<dt id="changelog-0.4.9.2">2010-06-29 19:23 (UTC) 0.4.9.2</dt>
<dd>
<h3>0.4.9.2</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Spectrometer sensor calibration sometimes accidentally occured when the instrument was still attached to the screen, leading to erroneous subsequent readings.</li>
<li>Immediately close a profile after reading to avoid locking it (fixes not being able to delete files from within the GUI).</li>
<li>Fixed quirks in “update calibration” and “update profile” operation.</li>
<li>The system-wide installation option in the profile install dialog is no longer hidden just because a profile has no embedded calibration curves (vcgt tag).</li>
<li>If the calibration curves of the current display profile couldn't be loaded for some reason (broken video card gamma table access, or no profile set), the curve viewer was not yet shown, and then a profile under “Settings” was selected, and then deleted, and then the curve viewer called up, an unhandled exception was raised.</li>
<li>Fixed ambient measurement via the “Measure” buttons timing out with the ColorMunki and various error handling issues regardless of instrument which could lead to an un-cancelable, forever looping progress bar.</li>
<li>Fixed ambient color temperature measurement via the “Measure” button not updating the kelvin field if selected.</li>
<li>Linux (only if the detected filesystem encoding is not UTF-8), Mac OS X and Windows: When installing a profile with “special” characters in the filename (everything not representable as 7-bit ASCII), it is now given an unique name containing the display number and MD5 hash, which fixes a few problems with filename encoding under Linux and Mac OS (under Linux the profile couldn't be successfully installed, under Mac OS X system-wide installation partly broke). This also fixes an issue under Windows where a profile whose name starts with the same first few characters (but has not the same name) as an already existing file in the system profile directory could accidentally overwrite that file, because I had not considered that filenames returned by win32api.GetShortPathName are only unique for the directory where a given file resides—and upon installation, that is the profile storage directory, not the system profile directory.</li>
<li>Linux, Mac OS X: When installing a profile, interaction with the curves window works now while the installation dialog is shown.</li>
<li>Windows (standalone executable): Fixed ambient measurement via the “Measure” buttons reproducably hanging (regardless of instrument) if the MS Visual C++ 2008 Redistributable Package (x86) was not installed.</li>
</ul>
<h4>Added in this release:</h4>
<ul>
<li>Linux: <a href="http://oyranos.org/">Oyranos</a> support. If it is available, profiles are imported to the Oyranos database using <code>oyranos-monitor</code> upon installation, and an appropriate autostart entry is created to load calibration curves and setup the X _ICC_PROFILE atoms on login.</li>
<li>Linux: Rudimentary support for <a href="http://projects.gnome.org/gnome-color-manager/">GNOME Color Manager</a>. If it is available and XRandR is working, profiles are imported to GCM upon installation. Any calibration loaders created previously by dispcalGUI will be removed (except the possible <code>oyranos-monitor</code> entry). You then still have to manually assign the profile to a display in the GCM preferences by selecting it and then choosing the profile from the dropdown menu (in the future, this process will be made obsolete by using GCM library functions). Loading of calibration curves and setting up the X _ICC_PROFILE atom and XRandR output properties is then handled by GCM.</li>
<li>Menu option to automatically show the log window after certain operations (measurements, profile creation).</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li><em>The terminal window is now only shown when required (e.g. keyboard interaction during interactive display adjustment).</em> Also, the terminal used is no longer an external application, but a minimal emulator that just passes keyboard input to the Argyll CMS tools.</li>
<li><em>All measurements which do not require keyboard interaction with Argyll CMS tools now show a progress dialog with the option to cancel the measurements.</em> All output that was previously visible through the terminal is still available via the log window (“Tools” menu) and -file.</li>
<li>Always load calibration curves before installing a profile, even if the profile has no vcgt tag (resets calibration to linear).</li>
<li>Automatically scroll to bottom when messages are added to the log window.</li>
<li>Store calibration and profiling settings in extra sections inside the TI3 file instead of the profile copyright tag. Use “generic” copyright information (“Created with dispcalGUI <code><version></code> and Argyll CMS <code><version></code>”), overridable by adding a line <code>copyright = My copyright information</code> in dispcalGUI's configuration file.</li>
<li>Made sure that only 7-bit ASCII gets written to a profile's copyright, ASCII description, and ASCII device model description. ICC v2 Unicode and Mac ScriptCode descriptions are now also written by default.</li>
<li>Presets default to high profile quality.</li>
<li>Remember visible state of curves, log window and testchart editor.</li>
<li>Updated french translation (thanks).</li>
<li>Linux: Unattended calibration & profiling no longer depends on xautomation.</li>
<li>Linux: <acronym title="Extended Display Identification Data">EDID<sup><a href="#definition_EDID">[10]</a></sup></acronym> is now used (if available) when generating descriptive identifiers for displays.</li>
<li>Linux: When determining a display's associated profile, check XrandR _ICC_PROFILE output properties first if available.</li>
<li>Linux: The option to install a profile system-wide is not offered if using <a href="http://projects.gnome.org/gnome-color-manager/">GNOME Color Manager</a> to install profiles (GCM has its own way to set profiles as system default).</li>
<li>Linux (only when <a href="http://projects.gnome.org/gnome-color-manager/" title="GNOME Color Manager">GCM</a> is not installed or XRandR is not working), Mac OS X, Windows: Installing a profile system-wide now also sets it as default for the current user.</li>
<li>Windows Vista and later: The option to install a profile system-wide is no longer offered if using Argyll CMS <= 1.1.1 (system scope in Argyll releases up to 1.1.1 acts like user scope on those systems).</li>
</ul>
<p>+ Numerous other small fixes and changes. There is now also a mailing list for discussion and support as well as announcements (see at the <a href="#contact">top</a> of this document).</p>
</dd>
<dt id="changelog-0.3.9.9">2010-05-07 22:36 (UTC) 0.3.9.9</dt>
<dd>
<h3>0.3.9.9</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Fixed unreliable (hanging occasionally) profile install when using system scope under Linux and Mac OS X (regression of a change in SVN r391 / 0.3.9.3).</li>
<li>Fixed ICC profile truncation if actual tag data is not in the same order as the tag table (regression of a change in SVN r274 / 0.3.0.7. Argyll profiles were not affected).</li>
<li>Fixed potential invalid profile name being generated if some unicode characters can't be conveyed in the file system encoding (Windows, Linux).</li>
<li>Fixed possible backslash in profile name due to wrong escaping when replacing invalid characters.</li>
<li>Fixed support for codepages 65000 (UTF-7) and 65001 (UTF-8) in the main application under Windows. This is actually a fix for shortcomings of Python.</li>
</ul>
</dd>
<dt id="changelog-0.3.9.3">2010-05-03 18:45 (UTC) 0.3.9.3</dt>
<dd>
<h3>0.3.9.3</h3>
<h4>Added in this release:</h4>
<ul>
<li>Show percentage and amount of tone values per channel (+ grayscales) for calibration curves in the curve viewer and profile verification reports.</li>
<li>Profile verification: Enabled gray balance evaluation for all RGB charts containing grayscales (R=G=B). Added option to verify graybalance through calibration only (sets the target L* of each grayscale patch to the measured L* and target a*=b*=0).</li>
<li>Added documentation for the interactive display adjustment part of calibration.</li>
<li>Added further documentation of the profile verification feature with detailed information about underlying technical aspects.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Fixed an unicode error after creating a profile verification report in a path containing unicode characters and a few other unrelated (potential) unicode errors.</li>
<li>Fixed potential unhandled exception if a JSON language file is malformed.</li>
<li>Fixed unhandled exception (local variable referenced before assignment) if trying to view calibration curves of an output with no video card gamma table access.</li>
<li>Fixed rare unhandled exception (local variable referenced before assignment) if logfile couldn't be renamed or removed during rollover.</li>
<li>Fail more gracefully (omit traceback from error message) if temp directory couldn't be created.</li>
<li>Fixed handling of XDG_CONFIG_DIRS and the system-wide autostart directory if the preferred configuration directory does not exist under Linux when installing a profile in local system scope, which prevented the system-wide autostart entry to be created.</li>
<li>Correctly determine system display profile under Windows Vista and 7 if no user profile is set. Fall back to sRGB if no display profile is set.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Changed default gamma from 2.4 to 2.2 in an attempt to increase the amount of available gamma table tone values after calibration for LCD screens, which often have a native response that is closer to a gamma of 2.2 than 2.4.</li>
<li>Changed default profile type to single curve + matrix.</li>
<li>Profile verification: Only evaluate grayscales (R=G=B) if their luminance is atleast 1% of the white luminance. Also evaluate combined Δa and Δb range.</li>
<li>Moved instrument feature details to separate JSON configuration file.</li>
<li>Made compatible with wxPython 2.8.6.0.</li>
</ul>
</dd>
<dt id="changelog-0.3.8.0">2010-03-31 15:24 (UTC) 0.3.8.0</dt>
<dd>
<h3>0.3.8.0</h3>
<h4>Added in this release:</h4>
<ul>
<li>“Very large” testchart with 912 patches.</li>
<li>Profile verification: Support (non-Argyll) profiles which use chromatic adaption.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Improved error message when Argyll binaries are not found (only files not found are now shown, together with alternatives). Automatically fall back to xicclu if icclu is not found (eg. Ubuntu's Argyll 1.0.3 package doesn't contain icclu).</li>
<li>Fixed 'invalid syntax' error when running under Python 2.5.</li>
<li>Profile verification report: Fixed a parsing error when reference or measurement data contained numbers in exponential notation.</li>
<li>Linux: Unhandled exception if DISPLAY environment variable is in the format <code>[host]:displaynumber</code> instead of <code>[host]:displaynumber.screennumber</code> (eg. <code>:0</code> instead of <code>:0.0</code>).</li>
<li>Mac OS X: Fixed values entered in combo boxes not updating the configuration correctly under some circumstances.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Profile verification: Lookup device values relative colorimetrically and adapt the measured values to D50 before comparison (using Bradford matrix), so that the measured whitepoint corresponds to L*a*b* 100 0 0. Please note that verification results obtained with reference files measured in earlier versions of dispcalGUI should not be compared to those obtained via this new approach if the display whitepoint is not D50, as the results are likely to be different as an effect of the relative lookup and the chromatic adaption.</li>
<li>Profile verification: Improved support for non-Argyll CGATS text files. Handling is as follows:
<ul>
<li>If the file contains RGB_R RGB_G RGB_B fields, it is handled like a Argyll *.ti1 (testchart) file—any XYZ or Lab data is ignored and the RGB numbers are sent to the display and measured. Afterwards, the measured values are compared to the expected values, which are obtained by sending the RGB numbers through the profile. If RGB values above 100 are found, a range of 0-255 is assumed. Otherwise, a range of 0-100 (like Argyll *.ti1) is assumed.</li>
<li>If the file doesn't contain RGB_R RGB_G RGB_B fields, but XYZ_X XYZ_Y XYZ_Z or LAB_L LAB_A LAB_B, it is handled like a Argyll measurement data (*.ti3) file—the values are used to lookup corresponding RGB numbers through the profile and these are then sent to the display and measured. Afterwards, the measured values are compared to the original XYZ or Lab values.</li>
</ul>
</li>
<li>Profile verification report: Show measured whitepoint and assumed target color temperature (based on closest daylight temperature), and use them to calculate the Delta E for the whitepoint. A few performance improvements when processing large datasets with several hundred or thousand measurements.</li>
<li>GUI and ReadMe: Changed all occurences of the term “LUT curves” to “calibration curves” and also changed all occurences of the term “video LUT” to “video card gamma table” to better distinguish from “LUT profile”. Also renamed the “LUT viewer” to curve viewer as a more accurate description of its functionality.</li>
</ul>
</dd>
<dt id="changelog-0.3.6.4">2010-03-17 18:50 (UTC) 0.3.6.4</dt>
<dd>
<h3>0.3.6.4</h3>
<h4>Added in this release:</h4>
<ul>
<li>Profile verification: CGATS-compatible text files (*.txt) containing measurement data can now be selected in addition to Argyll testchart (*.ti1) and measurement data (*.ti3) files.</li>
<li>Profile verification report: Depending on the chart used, you can now choose among different evaluation criteria from within the report. Also added Fogra Media Wedge V3 tolerance values for CMYK testcharts.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Profile verification: Error 'Unknown color representation Lab' when trying to verify a L*a*b* LUT profile.</li>
<li>Profile verification: Wrong XYZ scaling when reading from *.ti3 files containing XYZ, but no L*a*b* values.</li>
<li>Profile verification: When measuring a display other than the first one, the calibration curves were erroneously still loaded to the 1st display.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Profile verification report: Show nominal and actual measured values as L*a*b* instead of XYZ. Reduced visible decimals in report to increase readability.</li>
<li>Split the cramped “Extra” menu into “Options” and “Tools”.</li>
</ul>
</dd>
<dt id="changelog-0.3.6.2">2010-03-13 06:31 (UTC) 0.3.6.2</dt>
<dd>
<h3>0.3.6.2</h3>
<h4>Added in this release:</h4>
<ul>
<li><strong>Profile verification by measurements.</strong> Argyll testchart (*.ti1) and measurement data (*.ti3) files can be measured.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Testchart editor: Do not automatically select a saved testchart (regression of a change in 0.3.3.5). Do not show empty rows when creating a testchart using an algorythm that does not create the expected number of rows.</li>
<li>Bumped wxPython version check to 2.8.8.0 so a proper error message is displayed if wxPython is too old.</li>
<li>Linux: When using TwinView or Xinerama, the size of the measurement window was sometimes not correct.</li>
<li>Linux: Failure in get_argyll_version if Argyll utilities have alternate names (eg. argyll-targen instead of targen), which could prevent being able to open the testchart editor (regression of a change in 0.3.3.5).</li>
<li>Mac OS X 10.4: Fall back to ColorSyncScripting if Image Events does not return a display profile.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Linux: Info window no longer stays always on top.</li>
<li>Linux: When getting the current profile for a display, also look at the _ICC_DEVICE_PROFILE atom (see draft <a href="http://www.oyranos.org/wiki/index.php?title=ICC_Profiles_in_X_Specification_0.4">ICC Profiles in X Specification 0.4</a>).</li>
</ul>
</dd>
<dt id="changelog-0.3.3.6">2010-03-02 20:12 (UTC) 0.3.3.6</dt>
<dd>
<h3>0.3.3.6</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Linux/Mac OS X: 'tcgetattr failed' when trying to calibrate or profile.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>Linux: Updated udev rules.</li>
</ul>
</dd>
<dt id="changelog-0.3.3.5">2010-03-01 06:27 (UTC) 0.3.3.5</dt>
<dd>
<h3>0.3.3.5</h3>
<h4>Added in this release:</h4>
<ul>
<li>Capability to set whitepoint or ambient light level for viewing condition adjustment by measuring ambient light.</li>
<li>Profile name %tpa placeholder (test patch amount).</li>
<li>Documentation for ambient light level viewing conditions adjustment, advanced profiling options (gamut mapping) and testchart editor in the ReadMe. Also a few additions to the existing whitepoint/white level and tone curve documentation (mostly taken from the Argyll CMS documentation).</li>
<li>Two entries to the <a href="#issues">known issues & solutions</a> section in the ReadMe (swapped colors and Photoshop “Monitor profile appears to be defective”).</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li><strong>New improved testcharts and presets, with lower patch counts:</strong> 12 patches default for gamma+matrix profiles, 48 patches default for curves+matrix profiles (former chart had 91 patches), 124 patches default for LUT profiles which should actually be usable this time around when coupled with a profile quality setting of “high”, unlike its predecessor with 127 patches which yielded mediocre results at best (but for increased accuracy, the new 238-patch “extended” testchart is recommended). 396 and 2386-patch charts (the new “large” and “massive” quantity) are also included.</li>
<li>Default to high profile quality (and force for gamma+matrix profiles, as there is no processing penalty like for curves+matrix or LUT profiles).</li>
<li>Removed limit for remembered settings files.</li>
<li>When calibration or profiling measurements fail, first show the main application window, then the error message (small dialog boxes are sometimes hard to spot on big screens if the application context is missing).</li>
<li>Moved profile quality, type and advanced settings above testchart selector (this order is more logical, as profile quality and type influences testchart selection).</li>
<li>Testchart editor: Default to adaption of 10% for testchart creation using optimized farthest point sampling (OFPS). Support both device and L*a*b* diagnostic VRML files when creating testcharts using Argyll >= 1.1.0. No longer calculate the amount of white/gray/single color patches or multidimensional cube steps if info is missing in testchart file (calculations take way too long for little added benefit).</li>
<li>Cleaned up the <a href="#issues">known issues & solutions</a> section in the ReadMe.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Wrong value for adaption settings in testchart editor being stored.</li>
<li>Linux (cosmetic): Incorrect special characters in console window when using non-english locale under certain configurations (regression of a change introduced in 0.3.0.7).</li>
<li>Non-critical: File information in Argyll CGATS TI1 to TI3 conversion.</li>
<li>Testchart editor: Do not allow overwriting of predefined testcharts when saving. Correctly remember last used filename when “saving as...”.</li>
<li>Log window: Correctly remember last used filename when saving.</li>
<li>Typo in the ReadMe (the second “Report on calibrated display device” entry under “<a href="#menu">Menu commands</a>” should have been “Report on <strong>un</strong>calibrated display device”).</li>
</ul>
</dd>
<dt id="changelog-0.3.1.0">2010-02-17 15:53 (UTC) 0.3.1.0</dt>
<dd>
<h3>0.3.1.0</h3>
<h4>Fixed in this release:</h4>
<ul>
<li>Running “Calibrate & profile” several times in succession no longer fails on the 2nd and subsequent runs.</li>
<li>Linux: Missing wxPython version check for the measurement window subprocess.</li>
</ul>
</dd>
<dt id="changelog-0.3.0.9">2010-02-15 17:27 (UTC) 0.3.0.9</dt>
<dd>
<h3>0.3.0.9</h3>
<h4>Added in this release:</h4>
<ul>
<li>Test chart editor: Support for Argyll 1.1.0 perceptual space-filling quasi-random test patch distribution.</li>
</ul>
</dd>
<dt id="changelog-0.3.0.8">2010-02-13 16:36 (UTC) 0.3.0.8</dt>
<dd>
<h3>0.3.0.8</h3>
<h4>Fixed in this release:</h4>
<ul>
<li><a href="https://sourceforge.net/tracker/?func=detail&aid=2951168&group_id=257092&atid=1127028">#2951168</a> Windows: Critical bug with win32 API calls to get the display name returning 8-bit characters where only ASCII was expected.</li>
</ul>
</dd>
<dt id="changelog-0.3.0.7">2010-02-12 20:13 (UTC) 0.3.0.7</dt>
<dd>
<h3>0.3.0.7</h3>
<h4>Added in this release:</h4>
<ul>
<li>Support for Argyll >= 1.1.0 adaptive emissive measurement mode with the i1 Pro spectrometer.</li>
<li>All of Argyll's profile types are now available (XYZ LUT on Windows only if using Argyll >= 1.1.0).</li>
<li>Support for “very low” calibration quality.</li>
<li>Optionally create a fast matrix/shaper profile when just calibrating.</li>
<li>“Reset video card gamma table” checkbox in the dialog shown when just profiling.</li>
<li>Information how to install Argyll >= 1.1.0 USB drivers on Windows Vista/7 64-bit to the “known issues and solutions” section in the ReadMe.</li>
<li>ReadMe, license, bug tracker and support forum can now be accessed from the “Help” menu.</li>
<li>“Check for update...” in the help menu (launches a web browser and displays the dispcalGUI homepage if a new version is found).</li>
<li>Curve viewer: Capability to show the actual curves from the video card.</li>
<li>Curve viewer: Capability to show a matrix profile's rTRC/gTRC/bTRC curves.</li>
</ul>
<h4>Changed in this release:</h4>
<ul>
<li>When restoring defaults, selected display/instrument/measurement mode, language and profile name are retained.</li>
<li>The display/instrument selector is only enabled if more than one device detected respectively.</li>
<li>Changed i1 Pro highres measurement mode from implicit to user choice.</li>
<li>Gamut mapping: When selecting a source profile, pre-select a source viewing condition based on profile class (monitor or printer).</li>
<li>Updated defaults and presets to Argyll 1.1.0 values (i.e. black output offset).</li>
<li>Short display name placeholder (%dns) for profile name should not yield single numbers or model name without model number any more (or atleast less likely).</li>
<li>Log messages from most informational and all error dialogs.</li>
<li>Show file paths in most dialogs involving file processing.</li>
<li>Documentation in the ReadMe has been updated and is now more or less complete for the main application (testchart editor docs are still to be done). Setup instructions have also been streamlined.</li>
<li>Moved information how to fix video card gamma table access under Linux/X11 to the “known issues and solutions” section in the ReadMe.</li>
<li>Linux: Updated udev rules to those provided with Argyll 1.1.0. Removed obsolete permissions and policy files.</li>
<li>Linux: In multi-display setups using separate X screens, it should no longer be necessary to launch dispcalGUI on the display you want to measure.</li>
<li>Windows: Get names of displays via additional Windows API calls (should yield more descriptive names than “DISPLAY1”, “DISPLAY2” etc.)</li>
<li>Windows (cosmetic): Use default command prompt text color, and a darker variant only when doing measurements.</li>
<li>dispcalGUI version now corresponds to SVN revision number, split into its digit components. Build system (setup.py) uses SVN to generate version information.</li>
</ul>
<h4>Fixed in this release:</h4>
<ul>
<li>Curve viewer: When no display is selected (i.e. when Argyll binaries are not found), it will now try to show the vcgt of the 1st display's profile.</li>
<li>Curve viewer: When hiding the viewer and loading different calibration curves, those changes were not reflected when showing the viewer again.</li>
<li>Curve viewer: If a profile does not contain a 'vcgt' tag, clear canvas and disable R/G/B checkboxes.</li>
<li>Selection of display used for video card gamma table access not working correctly.</li>
<li>Loading of calibration upon initial preview in profile installation dialog if profile does not contain dispcalGUI settings.</li>
<li>Do not show failure message if user cancels profile installation via the password dialog when installing in system scope.</li>
<li>In some cases, values read from the configuration file were not correctly validated (would only show with deliberately altered or broken config file).</li>
<li>colprof output is no longer swallowed when creating a matrix profile with Argyll versions <= 1.0.4.</li>
<li>Linux: Fall back to ASCII if detected encoding is not UTF-8 to fix profile install issues.</li>
<li>Linux/Mac OS X: Enabling the Spyder 2 colorimeter might need elevated privileges.</li>
<li>Linux/Mac OS X: When installing a profile in local system scope, the necessary password was not accepted under newer Linux distros and also Mac OS X > 10.4.11</li>
<li>Mac OS X (cosmetic): Suppress spurious AppleScript messages.</li>
<li>Windows: Get display profile via registry instead of Windows API because the latter does not reflect runtime changes to profile associations (you still need to refresh the curve viewer when changing profile associations <em>outside</em> of dispcalGUI while it is running).</li>
</ul>
<h4>Known issues in this release:</h4>
<ul>
<li>Linux: You can't interact with the drop-down menu or the checkboxes in the curve viewer while a profile installation dialog is shown.</li>
</ul>
</dd>
<dt id="changelog-2009-07-16">2009-07-16</dt>
<dd>
<ul>
<li>Fixed a glitch in the Linux Autopackage installer where it would install even if required libraries were missing.</li>
</ul>
</dd>
<dt id="changelog-0.2.6b3">2009-06-30 0.2.6b3 (SVN r239)</dt>
<dd>
<ul>
<li>fix (Windows): Fixed a critical bug in the Windows codepath which tried to access non-existent paths when certain settings were used.</li>
</ul>
</dd>
<dt id="changelog-0.2.6b2">2009-06-26 0.2.6b2</dt>
<dd>
<ul>
<li>fix: Only look at <major>.<minor> during the Python version check (fixes a critical error on Ubuntu 9.10 Beta, where the Python revision number has an unexpected value).</li>
<li>fix: The curve viewer is now also able to plot calibration curves from *.cal files.</li>
<li>fix (Linux): If launched on an X display which is not the first display, the measurement window's location no longer determines the display which is used for measurements. This allows non-Xinerama multiscreen configurations to work with dispcalGUI. Note: You need to launch dispcalGUI on the display you want to measure, e.g. <code>`DISPLAY=:0.1 dispcalGUI`</code>.</li>
<li>fix (Linux): Get the profile from the correct display when loading a display's calibration curves into the curve viewer.</li>
<li>fix (Linux, cosmetic): Suppress CUPS warnings encountered on some systems when using the curve viewer.</li>
<li>fix (Mac OS X): Do not offer 'Network' scope during profile installation if <code>/Network/Library/ColorSync/Profiles</code> does not exist.</li>
<li>fix (Windows, cosmetic): Made sure the message "Debug: src/helpers.cpp(140): 'CreateActCtx' failed with error 0x0000007b (the filename, directory name, or volume label syntax is incorrect.)" is not shown when launching the standalone Windows executable, by changing the way *.pyd files are bundled (they are now copied to the executable's directory and are no longer part of the executable itself).</li>
<li>chg: The curve viewer resets to linear if a display without associated profile is selected.</li>
</ul>
</dd>
<dt id="changelog-0.2.6b">2009-06-22 0.2.6b</dt>
<dd>
<ul>
<li>fix: calibration preview checkbox in the “install profile” dialog should now correctly toggle between previous and new calibration.</li>
<li>fix: profiling failed when creating a profile on top of an existing calibration.</li>
<li>fix: correctly decode environment variables (should fix a failure when trying to create a profile and the username contains non-ASCII characters).</li>
<li>fix: automatic restoration of defaults before loading settings from a profile or cal file should no longer restore “do not show again” dialogs.</li>
<li>fix (Windows): several errors related to character encoding.</li>
<li>chg: unattended calibration and profiling: wait 10 seconds instead of 5 after calibration before trying to start profiling measurements (some instruments seem to need longer to initialize than others, e.g. Spyder 2).</li>
<li>chg (Python packages and source): instead of requiring wxPython 2.8.x specifically, only ensure a minimal version of 2.8.</li>
<li>add: Curve viewer.</li>
</ul>
</dd>
<dt id="changelog-2009-06-11">2009-06-11 21:33 (UTC)</dt>
<dd>
<ul>
<li>Added Linux Autopackage download.</li>
<li>Renamed 55-Argyll.rules to 92-Argyll.rules, so it can work on Debian too.</li>
<li>Removed “Creating a standalone executable from source” section from the ReadMe (the topic is still handled under “Installing from source” / “Additional setup.py commands”).</li>
</ul>
</dd>
<dt id="changelog-0.2.5b4">2009-06-07 0.2.5b4</dt>
<dd>
<ul>
<li>fix: “TypeError: coercing to Unicode: need string or buffer, instance found” when calling any of the get*Description() methods of an ICCProfile instance, which caused profile creation from existing profile to fail.</li>
<li>fix: (Windows Vista) application exit on launch if autostart directory did not exist.</li>
<li>fix: (source, Debian and RPM packages) use the correct wxPython version</li>
<li>fix: tab-key traversal of calibration settings controls.</li>
<li>fix: automatically scroll into view focused calibration settings controls if scrollbars are shown.</li>
<li>fix: properly clean & remove temporary directory.</li>
<li>fix: (cosmetic) added some padding to calibration settings right-hand side so scrollbar won't overlap if shown.</li>
<li>chg: (cosmetic) enable auto-sizing (fit to contents) for colortemp locus, trc type and profile type selectors.</li>
<li>chg: (cosmetic) do not show vendor name in instrument select dropdown (conserve some space).</li>
<li>chg: (cosmetic) made the instrument selector a little narrower (needs less space now to display instrument name because the vendor name is stripped) and the measure mode selector a bit wider (to accommodate for projector mode).</li>
<li>chg: only try to re-start within terminal if running as standalone executable.</li>
<li>chg: show application restart request in the chosen language after changing it.</li>
<li>chg: allow resizing/maximizing of main window (a minimal size is forced to prevent layout glitches).</li>
<li>chg: (Linux) install from source or package will try to automatically setup access to your instrument. Some services (PolicyKit/HAL or udev) may need to be restarted to get the updated configuration recognized. If in doubt, a reboot should work in all cases.</li>
<li>add: french translation (by Loïc Guégant, thanks!)</li>
<li>add: bdist_deb command and --cfg option for setup.py</li>
</ul>
</dd>
<dt id="changelog-0.2.5b3">2009-05-16 0.2.5b3</dt>
<dd>
<ul>
<li>Fixed calibration loader autostart entry creation (“access denied” error) under Windows Vista and later with User Account Control enabled.</li>
</ul>
</dd>
<dt id="changelog-0.2.5b2">2009-05-07 0.2.5b2</dt>
<dd>
<ul>
<li>Fixed “error: nothing to repeat” when using a spectrometer.</li>
</ul>
</dd>
<dt id="changelog-0.2.5b">2009-05-05 0.2.5b</dt>
<dd>
<ul>
<li>fix: encoding-related issues on all platforms and strange Unicode-related problems with AppleScript and Terminal on Mac OS X 10.4 (<a href="#osx-104-applescript-unicode-peculiarities" onclick="var element = document.getElementById('osx-104-applescript-unicode-peculiarities'); element.style.display = element.style.display == 'block' ? 'none' : 'block'; return false">Details</a>).
<div id="osx-104-applescript-unicode-peculiarities" style="display: none">
Prerequisites to reproduce Unicode-related issues under Mac OS X 10.4: Terminal closed, or with atleast one window opened. Script inside an AppleScript bundle, the bundle filename contains UTF-8 characters. “main.command” (executable shell script) inside Contents/Resources subfolder of the bundle.<br />
<br />
Not working (messagebox “Resource not found”):
<pre><code class="applescript"><span class="keyword">tell</span> application <span class="string">"Terminal"</span>
activate
do script quoted form <span class="keyword">of</span> <span class="operator">(</span>POSIX path <span class="keyword">of</span> <span class="operator">(</span>path <span class="keyword">to</span> resource <span class="string">"main.command"</span><span class="operator">)</span><span class="operator">)</span>
<span class="keyword">end tell</span></code></pre>
Not working (messagebox “Resource not found”):
<pre><code class="applescript"><span class="keyword">tell</span> application <span class="string">"Terminal"</span>
activate
do script quoted form <span class="keyword">of</span> <span class="operator">(</span>POSIX path <span class="keyword">of</span> <span class="operator">(</span>path <span class="keyword">to</span> resource <span class="string">"main.command"</span><span class="operator">)</span><span class="operator">)</span> in <span class="keyword">first</span> window
<span class="keyword">end tell</span></code></pre>
Not working (message “No such file or directory” printed to Terminal window):
<pre><code class="applescript">set <span class="identifier">shellscript</span> <span class="keyword">to</span> quoted form <span class="keyword">of</span> <span class="operator">(</span>POSIX path <span class="keyword">of</span> <span class="operator">(</span>path to resource <span class="string">"main.command"</span><span class="operator">)</span><span class="operator">)</span>
<span class="keyword">tell</span> application <span class="string">"Terminal"</span>
activate
do script <span class="identifier">shellscript</span>
<span class="keyword">end tell</span></code></pre>
Working:
<pre><code class="applescript">set <span class="identifier">shellscript</span> <span class="keyword">to</span> quoted form <span class="keyword">of</span> <span class="operator">(</span>POSIX path <span class="keyword">of</span> <span class="operator">(</span>path to resource <span class="string">"main.command"</span><span class="operator">)</span><span class="operator">)</span>
<span class="keyword">tell</span> application <span class="string">"Terminal"</span>
activate
do script <span class="identifier">shellscript</span> in <span class="keyword">first</span> window
<span class="keyword">end tell</span></code></pre>
</div>
</li>
<li>fix: (Windows) several actions unexpectedly failing under Windows 7 (dispcalGUI created temporary files via system calls on several occasions, but on Windows, this does not create the file in the user's temp directory as one would expect, but in the ROOT directory e.g. C:\—a sane method is now being used instead).</li>
<li>fix: bug in sorting function caused leading and trailing zeroes of numbers in testchart filenames to get lost, thus failing to load such files.</li>
<li>fix: (Linux) “No module named _md5” error with the standalone executable on some Linux distros (apparently an OpenSSL-related issue, because normally it wouldn't fall back to the legacy _md5 module which is not even built by default in recent Python versions). The fallback _md5 module is now included.</li>
<li>fix: calibration was not automatically added & selected in the dropdown menu when only calibrating.</li>
<li>fix: dropping a profile which was not created in dispcalGUI onto the application window no longer results in an unhandled error.</li>
<li>fix: when trying to load calibration curves from a profile which actually does not contain any, an error message is now shown instead of resetting the video card gamma table to linear and erroneously stating the curves were succesfully loaded.</li>
<li>fix: add display device name as device model description when profiling.</li>
<li>fix: when creating a new profile from an existing profile, use that profile's device model description if present.</li>
<li>fix: also create .app/.sh/.cmd files when creating a new profile from existing measurement data.</li>
<li>fix: restore advanced gamut mapping options to default if selecting a profile which does not contain those settings.</li>
<li>fix: allow free selection of source and target viewing conditions in advanced gamut mapping options for <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> profiles regardless of source profile type.</li>
<li>fix: if the screen or instrument that was selected in a previous session is not available, select an available one.</li>
<li>fix: (Mac) the “enable spyder 2” menu item would not allow to select files other than “setup.exe”.</li>
<li>fix: [src] (Mac) if dispcalGUI was installed as application and then run from (separate) source, multiple copies were launched at certain occasions.</li>
<li>fix: selecting a different Argyll binary directory than the previous one now actually works.</li>
<li>chg: the previously empty entry at the top of the settings dropdown (settings which are not associated to a profile or .cal file) is now named “<current settings>”.</li>
<li>chg: changed settings which are associated to a profile or .cal file are now marked with a leading asterisk in the settings dropdown.</li>
<li>chg: default to a gamma of 2.4 (Argyll default).</li>
<li>chg: warn before changed settings are discarded.</li>
<li>chg: new default profile naming scheme.</li>
<li>chg: new default file locations on all platforms.<br />
- On Linux, dispcalGUI now adheres to the <a href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG Base Directory Specification</a>—the configuration file is saved as <code>$XDG_CONFIG_HOME/dispcalGUI/dispcalGUI.ini</code> ($XDG_CONFIG_HOME defaults to ~/.config if not set), all files created during calibration/profiling go into <code>$XDG_DATA_HOME/dispcalGUI/storage/</code> ($XDG_DATA_HOME defaults to ~/.local/share if not set) by default, and logfiles into <code>$XDG_DATA_HOME/dispcalGUI/logs/</code><br />
Any old (pre v0.2.5b) configuration data is retained in the file <code>~/.dispcalGUI</code> and may be safely deleted after using v0.2.5b or newer for the first time.<br />
- On Mac OS, the configuration is saved as <code>~/Library/Preferences/dispcalGUI/dispcalGUI.ini</code>, all files created during calibration/profiling go into <code>~/Library/Application Support/dispcalGUI/storage/</code> by default, and logfiles into <code>~/Library/Logs/dispcalGUI/</code><br />
Any old (pre v0.2.5b) configuration data is retained in the file <code>~/Library/Preferences/dispcalGUI Preferences</code> and may be safely deleted after using v0.2.5b or newer for the first time.<br />
- On Windows, the configuration file is saved as <code>%APPDATA%\dispcalGUI\dispcalGUI.ini</code>, all files created during calibration/profiling go into <code>%APPDATA%\dispcalGUI\storage\</code> by default, and logfiles into <code>%APPDATA%\dispcalGUI\logs\</code><br />
Any old (pre v0.2.5b) configuration data is retained in the registry key <code>HKEY_CURRENT_USER\Software\dispcalGUI</code>.</li>
<li>chg: [build/src] (Windows) removed MS Visual C++ 2008 Redistributable DLLs from the source package. Users who build under Windows will have them anyway as they are installed with Python 2.6, so they are now copied directly from %SystemRoot%\WinSxS (Windows side-by-side assemblies) if possible.</li>
<li>chg: [build/src] <a href="http://www.rutherfurd.net/python/sendkeys/">SendKeys</a> is now a dependency on Windows when running or building from source.</li>
<li>chg: [build/src] made dispcalGUI a distutils package, so it can be built/installed via setup.py.</li>
<li>chg: default locations are now also searched for resource files (<code>$XDG_DATA_HOME/dispcalGUI</code>, <code>$XDG_DATA_DIRS/dispcalGUI</code> on Linux, <code>~/Library/Application Support/dispcalGUI</code>, <code>/Library/Application Support/dispcalGUI</code> on Mac OS X, <code>%APPDATA%\dispcalGUI</code>, <code>%COMMONAPPDATA%\dispcalGUI</code> and <code>%COMMONPROGRAMFILES%\dispcalGUI</code> on Windows) in addition to the current working directory (which is always searched first if it differs from the executable directory) and the executable directory (which is always searched last).</li>
<li>chg: better error handling. For unhandled exceptions, a message box is shown and an entry is written to the logfile.</li>
<li>chg: (Linux) the calibration loader will no longer try and handle gnome-screensaver quirks—it was working too unreliably, and should really be fixed in gnome-screensaver. The current recommendation is to not use a screensaver at all if possible, and instead rely on the system's energy saving options.</li>
<li>chg: (Linux) there's no longer an installer for the Linux version.</li>
<li>chg: cancelling of certain operations like profile calculation and testchart generation is now also supported when using Python 2.5</li>
<li>chg: when searching for Argyll executables, also search for files with “argyll-” prefix or “-argyll” suffix (thanks to Mark Whitis for report).</li>
<li>chg: disable measurement mode selection when using a spectrometer.</li>
<li>add: logging (also see the change related to file-storage). Logfiles are created per-date. A maximum of 5 old ones is being kept as backup.</li>
<li>add: placeholders like display name, measurement device, whitepoint etc. can now be used in the profile name.</li>
<li>add: unattended calibration and profiling for some instruments, meaning it is no longer necessary to press a key after calibration to start the measurements for profiling (needs xautomation under Linux).</li>
<li>add: settings and related files can be deleted.</li>
<li>add: (Linux, Mac, Vista) profile install scope can be selected (note: local system scope install is broken with current Argyll versions under Linux).</li>
<li>add: version and translation information in the about window.</li>
<li>add: projector mode when using Argyll 1.1.0 Beta or newer with the X-Rite ColorMunki.</li>
</ul>
</dd>
<dt id="changelog-2009-01-01">2009-01-01</dt>
<dd>Linux and sourcecode bugfix update: Creation of the autostart entry failed when the autostart directory did not yet exist.</dd>
<dt id="changelog-0.2.1b">2008-12-24 0.2.1b</dt>
<dd>
<ul>
<li>fix: video card gamma table access check always returned false when no display profile was set.</li>
<li>chg: (Linux) dispcalGUI now uses the autostart specification from freedesktop.org for the profile loader under Linux when installing profiles. NOTE for users: This also means you should manually remove any autostarts from previous versions, e.g.<br/>
<code>rm ~/.gnome2/dispwin-*.sh<br/>
rm ~/.kde/Autostart/dispwin-*.sh</code><br/>
and then re-install your current profile so the new loader is created. The new loader will be created in $XDG_CONFIG_HOME/autostart/ (if set) or ~/.config/autostart/ (if not set), with the filename dispcalGUI-Calibration-Loader-Display-<strong>x</strong>.desktop, where <strong>x</strong> is the display number.</li>
<li>chg: the calibration loader will check if gnome-screensaver is running and if so, exit it before loading the calibration, then start it again to prevent resetting the calibration when activated.</li>
<li>chg: .sh/.cmd file in profile folder is no longer created when just installing a profile.</li>
<li>add: message box when selecting <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> as profile type with recommendation to use more samples for higher quality profiles.</li>
<li>add: default to english locale if translation doesn't exist.</li>
</ul>
</dd>
<dt id="changelog-0.2b">2008-12-18 0.2b</dt>
<dd>
<ul>
<li>fix: no longer possible to introduce invalid value types through a malformed config file (which could lead to dispcalGUI not launching).</li>
<li>fix: windows can no longer be moved permanently out of the visible screen area.</li>
<li>fix: spaces and special chars in the profile name should work now (should have from the start, but I had some superfluous code which broke it).</li>
<li>fix: spaces in the path to dispcalGUI should work now under Linux and Mac OS X too (Windows had no problem)</li>
<li>fix: measurement file no longer gets deleted after successful measurement if profile generation fails (was a simple oversight on my side).</li>
<li>fix: [cosmetic] logo header now always spans the whole width of the window.</li>
<li>fix: [cosmetic] (Mac OS X) on first launch, a second, unused, terminal window is no longer opened.</li>
<li>fix: windows will now try to adjust its height to fit on small screens (scrollbars might appear).</li>
<li>chg: “Calibration file” renamed to “Settings” and moved to the top, is now a dropdown box remembering the last 10 used files. Settings are stored in and loaded from profiles.</li>
<li>chg: renamed “Display type” to “Measurement mode” and moved over to measurement device selector.</li>
<li>chg: default to “LCD” for measurement mode.</li>
<li>chg: default testchart file names are now localized.</li>
<li>chg: new default testcharts, four flavours: matrix default (91 patches), <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym> default (127 patches), large (512 patches) and massive (3012 patches).</li>
<li>chg: testchart selector is now a dropdown box, shows all testchart files in chosen directory plus the default testcharts.</li>
<li>chg: [build/src] new and improved build system.</li>
<li>chg: [build/src] Python 2.6 is now the recommended version to run and/or build dispcalGUI. Python 2.5 is still supported, but you will not be able to cancel profile or testchart creation through the <acronym title="Graphical User Interface">GUI<sup><a href="#definition_GUI">[4]</a></sup></acronym>.</li>
<li>chg: (Linux) externally installed wxGTK is no longer a dependency for executables.</li>
<li>chg: [build] Executables are now completely self-contained. The following paths are searched for additional language files: <code><user home directory>/dispcalGUI/lang</code>, <code><dispcalGUI root directory>/lang</code></li>
<li>add: all settings now stored in profile whenever possible.</li>
<li>add: “Install” button next to settings dropdown to install selected profile.</li>
<li>add: dropdown to choose the display to use for video card gamma table access if all of the following applies:<br />
- more than one display connected<br />
- one of those displays seems to have non-working video card gamma table access (detected on startup)<br />
- one of those displays seems to have working video card gamma table access (detected on startup)</li>
<li>add: show patch count of selected testchart next to dropdown.</li>
<li>add: ability to select an icc profile (if it contains appropriate data) or measurement data file (.ti3) as testchart (converted on-the-fly).</li>
<li>add: testchart generator with editing cabability (experimental)<br />
- to select patches, click and drag the mouse over table cells, or hold SHIFT (select range) or CTRL/CMD (add/remove single cells/rows to/from selection)<br />
- to add a patch, double-click a row label<br />
- to delete patches, select them, then hold CTRL or CMD and hit DEL or BACKSPACE (will always delete whole rows even if only single cells selected)<br />
- CTRL-C/CTRL-V/CTRL-A = copy/paste/select all</li>
<li>add: advanced gamut mapping options for <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym>-type profiles, can also be used to overcome an apparent Photoshop CS3 bug under Mac OS X where the brush cursor shows strange artifacts when using <acronym title="Look Up Table">LUT<sup><a href="#definition_LUT">[7]</a></sup></acronym>-profiles with only one intent (thanks to Klaus Karcher for reporting this).</li>
<li>add: ability to generate profile from existing measurement data, even from an existing profile (if it contains appropriate data).</li>
<li>add: drag and drop calibration files (.cal), profiles (.icc/.icm), testcharts (.ti1) and measurement data files (.ti3) to the main window to process/select them (does not work very reliably on Mac OS X depending on where you drop the files, and you also get no optical feedback during the drag operation like the changed mouse cursor on Linux/Windows. Your best bet when dropping any files is perhaps the unoccupied area below “Settings”).</li>
<li>add: fully movable/resizable measurement window.</li>
<li>add: profile and testchart creation can be aborted (when running from source only if using Python >= 2.6).</li>
<li>add: “Before” / “After” switch when calibration / profiling complete.</li>
<li>add: menu item to enable Spyder 2 from within dispcalGUI.</li>
<li>add: italian and spanish <acronym title="Graphical User Interface">GUI<sup><a href="#definition_GUI">[4]</a></sup></acronym> translations (thanks contributors!)</li>
<li>Numerous other small fixes/changes.</li>
</ul>
</dd>
<dt id="changelog-2008-08-21">2008-08-21</dt>
<dd>Executable-only update for Linux (thanks to Patrice Vetsel for bug report): dispcalGUI is now built against wxGTK 2.8.7.1, which becomes a dependency.</dd>
<dt id="changelog-0.1b">2008-08-18 0.1b</dt>
<dd>First public release.</dd>
</dl>
</div>
<div id="definitions">
<h2>Definitions</h2>
<dl>
<dt id="definition_CGATS">[1] CGATS</dt>
<dd><span>Graphic Arts Technologies Standards, CGATS.5 Data Exchange Format (ANSI CGATS.5-1993 Annex J)</span></dd>
<dt>[2] <span id="definition_CMM">CMM</span> / <span id="definition_CMS">CMS</span></dt>
<dd>Color Management Module / Color Management System</dd>
<dt id="definition_GPL">[3] GPL</dt>
<dd>GNU General Public License — <a href="http://gnu.org/licenses/gpl.html">gnu.org/licenses/gpl.html</a></dd>
<dt id="definition_GUI">[4] GUI</dt>
<dd>Graphical User Interface</dd>
<dt id="definition_ICC">[5] ICC</dt>
<dd>International Color Consortium — <a href="http://color.org">color.org</a></dd>
<dt id="definition_JSON">[6] JSON</dt>
<dd>JavaScript Object Notation, a lightweight data-interchange format — <a href="http://json.org">json.org</a></dd>
<dt id="definition_LUT">[7] LUT</dt>
<dd>Look Up Table — <a href="http://en.wikipedia.org/wiki/Lookup_table">en.wikipedia.org/wiki/Lookup_table</a></dd>
<dt id="definition_SVN">[8] SVN</dt>
<dd>Subversion, a version-control system — <a href="http://subversion.tigris.org">subversion.tigris.org</a></dd>
<dt id="definition_UAC">[9] UAC</dt>
<dd>User Account Control — <a href="http://en.wikipedia.org/wiki/User_Account_Control">en.wikipedia.org/wiki/User_Account_Control</a></dd>
<dt id="definition_EDID">[10] EDID</dt>
<dd>Extended Display Identification Data — <a href="http://en.wikipedia.org/wiki/EDID">en.wikipedia.org/wiki/EDID</a></dd>
<dt id="definition_PCS">[11] EDID</dt>
<dd>Profile Connection Space — <a href="http://en.wikipedia.org/wiki/ICC_profile">en.wikipedia.org/wiki/ICC_profile</a></dd>
</dl>
</div>
</div>
<hr />
<p id="copyright">dispcalGUI © 2008-2014 Florian Höch</p>
<div id="footer-container">
<div id="footer"><a href="#toc" id="totop">↑ Top</a></div>
</div>
</body>
</html>
|
