2 # -*- coding: utf-8 -*-
5 Defines objects creating the *ACES* configuration.
16 import PyOpenColorIO as ocio
18 import aces_ocio.create_arri_colorspaces as arri
19 import aces_ocio.create_canon_colorspaces as canon
20 import aces_ocio.create_red_colorspaces as red
21 import aces_ocio.create_sony_colorspaces as sony
22 from aces_ocio.generate_lut import (
23 generate_1d_LUT_from_CTL,
24 generate_3d_LUT_from_CTL,
26 from aces_ocio.process import Process
27 from aces_ocio.utilities import ColorSpace, mat44_from_mat33, sanitize_path
29 __author__ = 'ACES Developers'
30 __copyright__ = 'Copyright (C) 2014 - 2015 - ACES Developers'
32 __maintainer__ = 'ACES Developers'
33 __email__ = 'aces@oscars.org'
34 __status__ = 'Production'
36 __all__ = ['ACES_OCIO_CTL_DIRECTORY_ENVIRON',
37 'ACES_OCIO_CONFIGURATION_DIRECTORY_ENVIRON',
38 'set_config_default_roles',
40 'generate_OCIO_transform',
43 'generate_baked_LUTs',
51 ACES_OCIO_CTL_DIRECTORY_ENVIRON = 'ACES_OCIO_CTL_DIRECTORY'
52 ACES_OCIO_CONFIGURATION_DIRECTORY_ENVIRON = 'ACES_OCIO_CONFIGURATION_DIRECTORY'
55 def set_config_default_roles(config,
66 Sets given *OCIO* configuration default roles.
72 color_picking : str or unicode
73 Color picking role title.
74 color_timing : str or unicode
75 Color timing role title.
76 compositing_log : str or unicode
77 Compositing log role title.
80 default : str or unicode
82 matte_paint : str or unicode
83 Matte painting role title.
84 reference : str or unicode
86 scene_linear : str or unicode
87 Scene linear role title.
88 texture_paint : str or unicode
89 Texture painting role title.
98 config.setRole(ocio.Constants.ROLE_COLOR_PICKING, color_picking)
100 config.setRole(ocio.Constants.ROLE_COLOR_TIMING, color_timing)
102 config.setRole(ocio.Constants.ROLE_COMPOSITING_LOG, compositing_log)
104 config.setRole(ocio.Constants.ROLE_DATA, data)
106 config.setRole(ocio.Constants.ROLE_DEFAULT, default)
108 config.setRole(ocio.Constants.ROLE_MATTE_PAINT, matte_paint)
110 config.setRole(ocio.Constants.ROLE_REFERENCE, reference)
112 config.setRole(ocio.Constants.ROLE_SCENE_LINEAR, scene_linear)
114 config.setRole(ocio.Constants.ROLE_TEXTURE_PAINT, texture_paint)
119 def write_config(config, config_path, sanity_check=True):
121 Writes the configuration to given path.
126 Parameter description.
131 Return value description.
139 print 'Configuration was not written due to a failed Sanity Check'
142 with open(config_path, mode='w') as fp:
143 fp.write(config.serialize())
146 def generate_OCIO_transform(transforms):
153 Parameter description.
158 Return value description.
161 interpolation_options = {
162 'linear': ocio.Constants.INTERP_LINEAR,
163 'nearest': ocio.Constants.INTERP_NEAREST,
164 'tetrahedral': ocio.Constants.INTERP_TETRAHEDRAL
166 direction_options = {
167 'forward': ocio.Constants.TRANSFORM_DIR_FORWARD,
168 'inverse': ocio.Constants.TRANSFORM_DIR_INVERSE
173 for transform in transforms:
174 if transform['type'] == 'lutFile':
175 ocio_transform = ocio.FileTransform(
176 src=transform['path'],
177 interpolation=interpolation_options[
178 transform['interpolation']],
179 direction=direction_options[transform['direction']])
180 ocio_transforms.append(ocio_transform)
181 elif transform['type'] == 'matrix':
182 ocio_transform = ocio.MatrixTransform()
183 # MatrixTransform member variables can't be initialized directly
184 # and must be set individually.
185 ocio_transform.setMatrix(transform['matrix'])
187 if 'offset' in transform:
188 ocio_transform.setOffset(transform['offset'])
190 if 'direction' in transform:
191 ocio_transform.setDirection(
192 direction_options[transform['direction']])
194 ocio_transforms.append(ocio_transform)
195 elif transform['type'] == 'exponent':
196 ocio_transform = ocio.ExponentTransform()
197 ocio_transform.setValue(transform['value'])
198 ocio_transforms.append(ocio_transform)
199 elif transform['type'] == 'log':
200 ocio_transform = ocio.LogTransform(
201 base=transform['base'],
202 direction=direction_options[transform['direction']])
204 ocio_transforms.append(ocio_transform)
206 print('Ignoring unknown transform type : %s' % transform['type'])
208 if len(ocio_transforms) > 1:
209 group_transform = ocio.GroupTransform()
210 for transform in ocio_transforms:
211 group_transform.push_back(transform)
212 transform = group_transform
214 transform = ocio_transforms[0]
219 def create_config(config_data, nuke=False):
226 Parameter description.
231 Return value description.
234 # Creating the *OCIO* configuration.
235 config = ocio.Config()
237 # Setting configuration overall values.
238 config.setDescription('An ACES config generated from python')
239 config.setSearchPath('luts')
241 # Defining the reference colorspace.
242 reference_data = config_data['referenceColorSpace']
243 print('Adding the reference color space : %s' % reference_data.name)
245 reference = ocio.ColorSpace(
246 name=reference_data.name,
247 bitDepth=reference_data.bit_depth,
248 description=reference_data.description,
249 equalityGroup=reference_data.equality_group,
250 family=reference_data.family,
251 isData=reference_data.is_data,
252 allocation=reference_data.allocation_type,
253 allocationVars=reference_data.allocation_vars)
255 config.addColorSpace(reference)
257 # Creating the remaining colorspaces.
258 for colorspace in sorted(config_data['colorSpaces']):
259 print('Creating new color space : %s' % colorspace.name)
261 ocio_colorspace = ocio.ColorSpace(
262 name=colorspace.name,
263 bitDepth=colorspace.bit_depth,
264 description=colorspace.description,
265 equalityGroup=colorspace.equality_group,
266 family=colorspace.family,
267 isData=colorspace.is_data,
268 allocation=colorspace.allocation_type,
269 allocationVars=colorspace.allocation_vars)
271 if colorspace.to_reference_transforms:
272 print('Generating To-Reference transforms')
273 ocio_transform = generate_OCIO_transform(
274 colorspace.to_reference_transforms)
275 ocio_colorspace.setTransform(
277 ocio.Constants.COLORSPACE_DIR_TO_REFERENCE)
279 if colorspace.from_reference_transforms:
280 print('Generating From-Reference transforms')
281 ocio_transform = generate_OCIO_transform(
282 colorspace.from_reference_transforms)
283 ocio_colorspace.setTransform(
285 ocio.Constants.COLORSPACE_DIR_FROM_REFERENCE)
287 config.addColorSpace(ocio_colorspace)
291 # Defining the *views* and *displays*.
295 # Defining a *generic* *display* and *view* setup.
297 for display, view_list in config_data['displays'].iteritems():
298 for view_name, colorspace in view_list.iteritems():
299 config.addDisplay(display, view_name, colorspace.name)
300 if not (view_name in views):
301 views.append(view_name)
302 displays.append(display)
303 # Defining the *Nuke* specific set of *views* and *displays*.
305 for display, view_list in config_data['displays'].iteritems():
306 for view_name, colorspace in view_list.iteritems():
307 if view_name == 'Output Transform':
309 config.addDisplay(display, view_name, colorspace.name)
310 if not (view_name in views):
311 views.append(view_name)
312 displays.append(display)
314 config.addDisplay('linear', 'View', 'ACES2065-1')
315 displays.append('linear')
316 config.addDisplay('log', 'View', 'ACEScc')
317 displays.append('log')
319 # Setting the active *displays* and *views*.
320 config.setActiveDisplays(','.join(sorted(displays)))
321 config.setActiveViews(','.join(views))
323 set_config_default_roles(
325 color_picking=reference.getName(),
326 color_timing=reference.getName(),
327 compositing_log=reference.getName(),
328 data=reference.getName(),
329 default=reference.getName(),
330 matte_paint=reference.getName(),
331 reference=reference.getName(),
332 scene_linear=reference.getName(),
333 texture_paint=reference.getName())
340 def generate_LUTs(odt_info,
345 lut_resolution_1d=4096,
346 lut_resolution_3d=64,
354 Parameter description.
359 Colorspaces and transforms converting between those colorspaces and
360 the reference colorspace, *ACES*.
363 print('generateLUTs - begin')
366 # Defining the reference colorspace.
367 ACES = ColorSpace('ACES2065-1')
369 'The Academy Color Encoding System reference color space')
370 ACES.equality_group = ''
373 ACES.allocation_type = ocio.Constants.ALLOCATION_LG2
374 ACES.allocation_vars = [-15, 6]
376 config_data['referenceColorSpace'] = ACES
378 config_data['displays'] = {}
379 config_data['colorSpaces'] = []
381 # Matrix converting *ACES AP1* primaries to *AP0*.
382 ACES_AP1_to_AP0 = [0.6954522414, 0.1406786965, 0.1638690622,
383 0.0447945634, 0.8596711185, 0.0955343182,
384 -0.0055258826, 0.0040252103, 1.0015006723]
386 # Matrix converting *ACES AP0* primaries to *XYZ*.
387 ACES_AP0_to_XYZ = [0.9525523959, 0.0000000000, 0.0000936786,
388 0.3439664498, 0.7281660966, -0.0721325464,
389 0.0000000000, 0.0000000000, 1.0088251844]
391 # -------------------------------------------------------------------------
393 # -------------------------------------------------------------------------
394 def create_ACEScc(name='ACEScc',
398 cs = ColorSpace(name)
399 cs.description = 'The %s color space' % name
400 cs.equality_group = ''
404 ctls = [os.path.join(aces_CTL_directory,
406 'ACEScsc.ACEScc_to_ACES.a1.0.0.ctl'),
407 # This transform gets back to the *AP1* primaries.
408 # Useful as the 1d LUT is only covering the transfer function.
409 # The primaries switch is covered by the matrix below:
410 os.path.join(aces_CTL_directory,
412 'ACEScsc.ACES_to_ACEScg.a1.0.0.ctl')]
413 lut = '%s_to_ACES.spi1d' % name
415 lut = sanitize_path(lut)
417 generate_1d_LUT_from_CTL(
418 os.path.join(lut_directory, lut),
430 cs.to_reference_transforms = []
431 cs.to_reference_transforms.append({
434 'interpolation': 'linear',
435 'direction': 'forward'})
437 # *AP1* primaries to *AP0* primaries.
438 cs.to_reference_transforms.append({
440 'matrix': mat44_from_mat33(ACES_AP1_to_AP0),
441 'direction': 'forward'})
443 cs.from_reference_transforms = []
446 ACEScc = create_ACEScc()
447 config_data['colorSpaces'].append(ACEScc)
449 # -------------------------------------------------------------------------
451 # -------------------------------------------------------------------------
452 def create_ACESproxy(name='ACESproxy'):
453 cs = ColorSpace(name)
454 cs.description = 'The %s color space' % name
455 cs.equality_group = ''
459 ctls = [os.path.join(aces_CTL_directory,
461 'ACEScsc.ACESproxy10i_to_ACES.a1.0.0.ctl'),
462 # This transform gets back to the *AP1* primaries.
463 # Useful as the 1d LUT is only covering the transfer function.
464 # The primaries switch is covered by the matrix below:
465 os.path.join(aces_CTL_directory,
467 'ACEScsc.ACES_to_ACEScg.a1.0.0.ctl')]
468 lut = '%s_to_aces.spi1d' % name
470 lut = sanitize_path(lut)
472 generate_1d_LUT_from_CTL(
473 os.path.join(lut_directory, lut),
483 cs.to_reference_transforms = []
484 cs.to_reference_transforms.append({
487 'interpolation': 'linear',
488 'direction': 'forward'
491 # *AP1* primaries to *AP0* primaries.
492 cs.to_reference_transforms.append({
494 'matrix': mat44_from_mat33(ACES_AP1_to_AP0),
495 'direction': 'forward'
498 cs.from_reference_transforms = []
501 ACESproxy = create_ACESproxy()
502 config_data['colorSpaces'].append(ACESproxy)
504 # -------------------------------------------------------------------------
506 # -------------------------------------------------------------------------
507 def create_ACEScg(name='ACEScg'):
508 cs = ColorSpace(name)
509 cs.description = 'The %s color space' % name
510 cs.equality_group = ''
514 cs.to_reference_transforms = []
516 # *AP1* primaries to *AP0* primaries.
517 cs.to_reference_transforms.append({
519 'matrix': mat44_from_mat33(ACES_AP1_to_AP0),
520 'direction': 'forward'
523 cs.from_reference_transforms = []
526 ACEScg = create_ACEScg()
527 config_data['colorSpaces'].append(ACEScg)
529 # -------------------------------------------------------------------------
531 # -------------------------------------------------------------------------
532 def create_ADX(bit_depth=10, name='ADX'):
533 name = '%s%s' % (name, bit_depth)
534 cs = ColorSpace(name)
535 cs.description = '%s color space - used for film scans' % name
536 cs.equality_group = ''
541 cs.bit_depth = ocio.Constants.BIT_DEPTH_UINT10
542 adx_to_cdd = [1023.0 / 500.0, 0.0, 0.0, 0.0,
543 0.0, 1023.0 / 500.0, 0.0, 0.0,
544 0.0, 0.0, 1023.0 / 500.0, 0.0,
546 offset = [-95.0 / 500.0, -95.0 / 500.0, -95.0 / 500.0, 0.0]
547 elif bit_depth == 16:
548 cs.bit_depth = ocio.Constants.BIT_DEPTH_UINT16
549 adx_to_cdd = [65535.0 / 8000.0, 0.0, 0.0, 0.0,
550 0.0, 65535.0 / 8000.0, 0.0, 0.0,
551 0.0, 0.0, 65535.0 / 8000.0, 0.0,
553 offset = [-1520.0 / 8000.0, -1520.0 / 8000.0, -1520.0 / 8000.0,
556 cs.to_reference_transforms = []
558 # Converting from *ADX* to *Channel-Dependent Density*.
559 cs.to_reference_transforms.append({
561 'matrix': adx_to_cdd,
563 'direction': 'forward'})
565 # Convert from Channel-Dependent Density to Channel-Independent Density
566 cs.to_reference_transforms.append({
568 'matrix': [0.75573, 0.22197, 0.02230, 0,
569 0.05901, 0.96928, -0.02829, 0,
570 0.16134, 0.07406, 0.76460, 0,
572 'direction': 'forward'})
574 # Copied from *Alex Fry*'s *adx_cid_to_rle.py*
575 def create_CID_to_RLE_LUT():
577 def interpolate_1D(x, xp, fp):
578 return numpy.interp(x, xp, fp)
580 LUT_1D_xp = [-0.190000000000000,
592 LUT_1D_fp = [-6.000000000000000,
604 REF_PT = ((7120.0 - 1520.0) / 8000.0 * (100.0 / 55.0) -
605 math.log(0.18, 10.0))
609 return interpolate_1D(x, LUT_1D_xp, LUT_1D_fp)
610 return (100.0 / 55.0) * x - REF_PT
612 def fit(value, from_min, from_max, to_min, to_max):
613 if from_min == from_max:
614 raise ValueError('from_min == from_max')
615 return (value - from_min) / (from_max - from_min) * (
616 to_max - to_min) + to_min
618 NUM_SAMPLES = 2 ** 12
621 for i in xrange(NUM_SAMPLES):
622 x = i / (NUM_SAMPLES - 1.0)
623 x = fit(x, 0.0, 1.0, RANGE[0], RANGE[1])
624 data.append(cid_to_rle(x))
626 lut = 'ADX_CID_to_RLE.spi1d'
627 write_SPI_1d(os.path.join(lut_directory, lut),
635 # Converting *Channel Independent Density* values to
636 # *Relative Log Exposure* values.
637 lut = create_CID_to_RLE_LUT()
638 cs.to_reference_transforms.append({
641 'interpolation': 'linear',
642 'direction': 'forward'})
644 # Converting *Relative Log Exposure* values to
645 # *Relative Exposure* values.
646 cs.to_reference_transforms.append({
649 'direction': 'inverse'})
651 # Convert *Relative Exposure* values to *ACES* values.
652 cs.to_reference_transforms.append({
654 'matrix': [0.72286, 0.12630, 0.15084, 0,
655 0.11923, 0.76418, 0.11659, 0,
656 0.01427, 0.08213, 0.90359, 0,
658 'direction': 'forward'})
660 cs.from_reference_transforms = []
663 ADX10 = create_ADX(bit_depth=10)
664 config_data['colorSpaces'].append(ADX10)
666 ADX16 = create_ADX(bit_depth=16)
667 config_data['colorSpaces'].append(ADX16)
669 # -------------------------------------------------------------------------
670 # *Camera Input Transforms*
671 # -------------------------------------------------------------------------
673 # *RED* colorspaces to *ACES*.
674 red_colorspaces = red.create_colorspaces(lut_directory, lut_resolution_1d)
675 for cs in red_colorspaces:
676 config_data['colorSpaces'].append(cs)
678 # *Canon-Log* to *ACES*.
679 canon_colorspaces = canon.create_colorspaces(lut_directory,
681 for cs in canon_colorspaces:
682 config_data['colorSpaces'].append(cs)
685 sony_colorSpaces = sony.create_colorspaces(lut_directory,
687 for cs in sony_colorSpaces:
688 config_data['colorSpaces'].append(cs)
691 arri_colorSpaces = arri.create_colorspaces(lut_directory,
693 for cs in arri_colorSpaces:
694 config_data['colorSpaces'].append(cs)
696 # -------------------------------------------------------------------------
697 # *Generic Log Transform*
698 # -------------------------------------------------------------------------
699 def create_generic_log(name='log',
706 lut_resolution_1d=lut_resolution_1d):
707 cs = ColorSpace(name)
708 cs.description = 'The %s color space' % name
709 cs.equality_group = name
710 cs.family = 'Utility'
713 ctls = [os.path.join(
716 'ACESlib.OCIO_shaper_log2_to_lin_param.a1.0.0.ctl')]
717 lut = '%s_to_aces.spi1d' % name
719 lut = sanitize_path(lut)
721 generate_1d_LUT_from_CTL(
722 os.path.join(lut_directory, lut),
728 {'middleGrey': middle_grey,
729 'minExposure': min_exposure,
730 'maxExposure': max_exposure},
736 cs.to_reference_transforms = []
737 cs.to_reference_transforms.append({
740 'interpolation': 'linear',
741 'direction': 'forward'})
743 cs.from_reference_transforms = []
746 # -------------------------------------------------------------------------
748 # -------------------------------------------------------------------------
749 def create_ACES_LMT(lmt_name,
752 lut_resolution_1d=1024,
753 lut_resolution_3d=64,
755 cs = ColorSpace('%s' % lmt_name)
756 cs.description = 'The ACES Look Transform: %s' % lmt_name
757 cs.equality_group = ''
761 pprint.pprint(lmt_values)
763 # Generating the *shaper* transform.
766 shaper_from_ACES_CTL,
768 shaper_params) = shaper_info
770 shaper_lut = '%s_to_aces.spi1d' % shaper_name
771 if not os.path.exists(os.path.join(lut_directory, shaper_lut)):
772 ctls = [shaper_to_ACES_CTL % aces_CTL_directory]
774 shaper_lut = sanitize_path(shaper_lut)
776 generate_1d_LUT_from_CTL(
777 os.path.join(lut_directory, shaper_lut),
781 1.0 / shaper_input_scale,
787 shaper_OCIO_transform = {
790 'interpolation': 'linear',
791 'direction': 'inverse'}
793 # Generating the forward transform.
794 cs.from_reference_transforms = []
796 if 'transformCTL' in lmt_values:
797 ctls = [shaper_to_ACES_CTL % aces_CTL_directory,
798 os.path.join(aces_CTL_directory,
799 lmt_values['transformCTL'])]
800 lut = '%s.%s.spi3d' % (shaper_name, lmt_name)
802 lut = sanitize_path(lut)
804 generate_3d_LUT_from_CTL(
805 os.path.join(lut_directory, lut),
809 1.0 / shaper_input_scale,
815 cs.from_reference_transforms.append(shaper_OCIO_transform)
816 cs.from_reference_transforms.append({
819 'interpolation': 'tetrahedral',
820 'direction': 'forward'
823 # Generating the inverse transform.
824 cs.to_reference_transforms = []
826 if 'transformCTLInverse' in lmt_values:
827 ctls = [os.path.join(aces_CTL_directory,
828 odt_values['transformCTLInverse']),
829 shaper_from_ACES_CTL % aces_CTL_directory]
830 lut = 'Inverse.%s.%s.spi3d' % (odt_name, shaper_name)
832 lut = sanitize_path(lut)
834 generate_3d_LUT_from_CTL(
835 os.path.join(lut_directory, lut),
845 cs.to_reference_transforms.append({
848 'interpolation': 'tetrahedral',
849 'direction': 'forward'})
851 shaper_inverse = shaper_OCIO_transform.copy()
852 shaper_inverse['direction'] = 'forward'
853 cs.to_reference_transforms.append(shaper_inverse)
857 # -------------------------------------------------------------------------
859 # -------------------------------------------------------------------------
861 lmt_lut_resolution_1d = max(4096, lut_resolution_1d)
862 lmt_lut_resolution_3d = max(65, lut_resolution_3d)
864 # Defining the *Log 2* shaper.
865 lmt_shaper_name = 'LMT Shaper'
868 'minExposure': -10.0,
871 lmt_shaper = create_generic_log(name=lmt_shaper_name,
872 middle_grey=lmt_params['middleGrey'],
873 min_exposure=lmt_params['minExposure'],
874 max_exposure=lmt_params['maxExposure'],
875 lut_resolution_1d=lmt_lut_resolution_1d)
876 config_data['colorSpaces'].append(lmt_shaper)
878 shaper_input_scale_generic_log2 = 1.0
880 # *Log 2* shaper name and *CTL* transforms bundled up.
885 'ACESlib.OCIO_shaper_log2_to_lin_param.a1.0.0.ctl'),
888 'ACESlib.OCIO_shaper_lin_to_log2_param.a1.0.0.ctl'),
889 shaper_input_scale_generic_log2,
892 sorted_LMTs = sorted(lmt_info.iteritems(), key=lambda x: x[1])
894 for lmt in sorted_LMTs:
895 (lmt_name, lmt_values) = lmt
896 cs = create_ACES_LMT(
897 lmt_values['transformUserName'],
900 lmt_lut_resolution_1d,
901 lmt_lut_resolution_3d,
903 config_data['colorSpaces'].append(cs)
905 # -------------------------------------------------------------------------
906 # *ACES RRT* with supplied *ODT*.
907 # -------------------------------------------------------------------------
908 def create_ACES_RRT_plus_ODT(odt_name,
911 lut_resolution_1d=1024,
912 lut_resolution_3d=64,
914 cs = ColorSpace('%s' % odt_name)
915 cs.description = '%s - %s Output Transform' % (
916 odt_values['transformUserNamePrefix'], odt_name)
917 cs.equality_group = ''
921 pprint.pprint(odt_values)
923 # Generating the *shaper* transform.
926 shaper_from_ACES_CTL,
928 shaper_params) = shaper_info
930 if 'legalRange' in odt_values:
931 shaper_params['legalRange'] = odt_values['legalRange']
933 shaper_params['legalRange'] = 0
935 shaper_lut = '%s_to_aces.spi1d' % shaper_name
936 if not os.path.exists(os.path.join(lut_directory, shaper_lut)):
937 ctls = [shaper_to_ACES_CTL % aces_CTL_directory]
939 shaper_lut = sanitize_path(shaper_lut)
941 generate_1d_LUT_from_CTL(
942 os.path.join(lut_directory, shaper_lut),
946 1.0 / shaper_input_scale,
952 shaper_OCIO_transform = {
955 'interpolation': 'linear',
956 'direction': 'inverse'}
958 # Generating the *forward* transform.
959 cs.from_reference_transforms = []
961 if 'transformLUT' in odt_values:
962 transform_LUT_file_name = os.path.basename(
963 odt_values['transformLUT'])
964 lut = os.path.join(lut_directory, transform_LUT_file_name)
965 shutil.copy(odt_values['transformLUT'], lut)
967 cs.from_reference_transforms.append(shaper_OCIO_transform)
968 cs.from_reference_transforms.append({
970 'path': transform_LUT_file_name,
971 'interpolation': 'tetrahedral',
972 'direction': 'forward'})
973 elif 'transformCTL' in odt_values:
975 shaper_to_ACES_CTL % aces_CTL_directory,
976 os.path.join(aces_CTL_directory,
979 os.path.join(aces_CTL_directory,
981 odt_values['transformCTL'])]
982 lut = '%s.RRT.a1.0.0.%s.spi3d' % (shaper_name, odt_name)
984 lut = sanitize_path(lut)
986 generate_3d_LUT_from_CTL(
987 os.path.join(lut_directory, lut),
992 1.0 / shaper_input_scale,
998 cs.from_reference_transforms.append(shaper_OCIO_transform)
999 cs.from_reference_transforms.append({
1002 'interpolation': 'tetrahedral',
1003 'direction': 'forward'})
1005 # Generating the *inverse* transform.
1006 cs.to_reference_transforms = []
1008 if 'transformLUTInverse' in odt_values:
1009 transform_LUT_inverse_file_name = os.path.basename(
1010 odt_values['transformLUTInverse'])
1011 lut = os.path.join(lut_directory, transform_LUT_inverse_file_name)
1012 shutil.copy(odt_values['transformLUTInverse'], lut)
1014 cs.to_reference_transforms.append({
1016 'path': transform_LUT_inverse_file_name,
1017 'interpolation': 'tetrahedral',
1018 'direction': 'forward'})
1020 shaper_inverse = shaper_OCIO_transform.copy()
1021 shaper_inverse['direction'] = 'forward'
1022 cs.to_reference_transforms.append(shaper_inverse)
1023 elif 'transformCTLInverse' in odt_values:
1024 ctls = [os.path.join(aces_CTL_directory,
1026 odt_values['transformCTLInverse']),
1027 os.path.join(aces_CTL_directory,
1029 'InvRRT.a1.0.0.ctl'),
1030 shaper_from_ACES_CTL % aces_CTL_directory]
1031 lut = 'InvRRT.a1.0.0.%s.%s.spi3d' % (odt_name, shaper_name)
1033 lut = sanitize_path(lut)
1035 generate_3d_LUT_from_CTL(
1036 os.path.join(lut_directory, lut),
1047 cs.to_reference_transforms.append({
1050 'interpolation': 'tetrahedral',
1051 'direction': 'forward'})
1053 shaper_inverse = shaper_OCIO_transform.copy()
1054 shaper_inverse['direction'] = 'forward'
1055 cs.to_reference_transforms.append(shaper_inverse)
1059 # -------------------------------------------------------------------------
1060 # *RRT / ODT* Shaper Options
1061 # -------------------------------------------------------------------------
1064 # Defining the *Log 2* shaper.
1065 log2_shaper_name = shaper_name
1068 'minExposure': -6.0,
1071 log2_shaper = create_generic_log(
1072 name=log2_shaper_name,
1073 middle_grey=log2_params['middleGrey'],
1074 min_exposure=log2_params['minExposure'],
1075 max_exposure=log2_params['maxExposure'])
1076 config_data['colorSpaces'].append(log2_shaper)
1078 shaper_input_scale_generic_log2 = 1.0
1080 # *Log 2* shaper name and *CTL* transforms bundled up.
1081 log2_shaper_data = [
1085 'ACESlib.OCIO_shaper_log2_to_lin_param.a1.0.0.ctl'),
1088 'ACESlib.OCIO_shaper_lin_to_log2_param.a1.0.0.ctl'),
1089 shaper_input_scale_generic_log2,
1092 shaper_data[log2_shaper_name] = log2_shaper_data
1094 # Shaper that also includes the AP1 primaries.
1095 # Needed for some LUT baking steps.
1096 log2_shaper_AP1 = create_generic_log(
1097 name=log2_shaper_name,
1098 middle_grey=log2_params['middleGrey'],
1099 min_exposure=log2_params['minExposure'],
1100 max_exposure=log2_params['maxExposure'])
1101 log2_shaper_AP1.name = '%s - AP1' % log2_shaper_AP1.name
1103 # *AP1* primaries to *AP0* primaries.
1104 log2_shaper_AP1.to_reference_transforms.append({
1106 'matrix': mat44_from_mat33(ACES_AP1_to_AP0),
1107 'direction': 'forward'
1109 config_data['colorSpaces'].append(log2_shaper_AP1)
1111 rrt_shaper = log2_shaper_data
1113 # *RRT + ODT* combinations.
1114 sorted_odts = sorted(odt_info.iteritems(), key=lambda x: x[1])
1116 for odt in sorted_odts:
1117 (odt_name, odt_values) = odt
1119 # Handling *ODTs* that can generate either *legal* or *full* output.
1120 if odt_name in ['Academy.Rec2020_100nits_dim.a1.0.0',
1121 'Academy.Rec709_100nits_dim.a1.0.0',
1122 'Academy.Rec709_D60sim_100nits_dim.a1.0.0']:
1123 odt_name_legal = '%s - Legal' % odt_values['transformUserName']
1125 odt_name_legal = odt_values['transformUserName']
1127 odt_legal = odt_values.copy()
1128 odt_legal['legalRange'] = 1
1130 cs = create_ACES_RRT_plus_ODT(
1137 config_data['colorSpaces'].append(cs)
1139 config_data['displays'][odt_name_legal] = {
1142 'Output Transform': cs}
1144 if odt_name in ['Academy.Rec2020_100nits_dim.a1.0.0',
1145 'Academy.Rec709_100nits_dim.a1.0.0',
1146 'Academy.Rec709_D60sim_100nits_dim.a1.0.0']:
1147 print('Generating full range ODT for %s' % odt_name)
1149 odt_name_full = '%s - Full' % odt_values['transformUserName']
1150 odt_full = odt_values.copy()
1151 odt_full['legalRange'] = 0
1153 cs_full = create_ACES_RRT_plus_ODT(
1160 config_data['colorSpaces'].append(cs_full)
1162 config_data['displays'][odt_name_full] = {
1165 'Output Transform': cs_full}
1167 # -------------------------------------------------------------------------
1168 # Generic Matrix transform
1169 # -------------------------------------------------------------------------
1170 def create_generic_matrix(name='matrix',
1171 from_reference_values=None,
1172 to_reference_values=None):
1174 if from_reference_values is None:
1175 from_reference_values = []
1176 if to_reference_values is None:
1177 to_reference_values = []
1179 cs = ColorSpace(name)
1180 cs.description = 'The %s color space' % name
1181 cs.equality_group = name
1182 cs.family = 'Utility'
1185 cs.to_reference_transforms = []
1186 if to_reference_values:
1187 for matrix in to_reference_values:
1188 cs.to_reference_transforms.append({
1190 'matrix': mat44_from_mat33(matrix),
1191 'direction': 'forward'})
1193 cs.from_reference_transforms = []
1194 if from_reference_values:
1195 for matrix in from_reference_values:
1196 cs.from_reference_transforms.append({
1198 'matrix': mat44_from_mat33(matrix),
1199 'direction': 'forward'})
1203 cs = create_generic_matrix('XYZ', from_reference_values=[ACES_AP0_to_XYZ])
1204 config_data['colorSpaces'].append(cs)
1206 cs = create_generic_matrix(
1207 'Linear - AP1', to_reference_values=[ACES_AP1_to_AP0])
1208 config_data['colorSpaces'].append(cs)
1210 # *ACES* to *Linear*, *P3D60* primaries.
1211 XYZ_to_P3D60 = [2.4027414142, -0.8974841639, -0.3880533700,
1212 -0.8325796487, 1.7692317536, 0.0237127115,
1213 0.0388233815, -0.0824996856, 1.0363685997]
1215 cs = create_generic_matrix(
1217 from_reference_values=[ACES_AP0_to_XYZ, XYZ_to_P3D60])
1218 config_data['colorSpaces'].append(cs)
1220 # *ACES* to *Linear*, *P3DCI* primaries.
1221 XYZ_to_P3DCI = [2.7253940305, -1.0180030062, -0.4401631952,
1222 -0.7951680258, 1.6897320548, 0.0226471906,
1223 0.0412418914, -0.0876390192, 1.1009293786]
1225 cs = create_generic_matrix(
1227 from_reference_values=[ACES_AP0_to_XYZ, XYZ_to_P3DCI])
1228 config_data['colorSpaces'].append(cs)
1230 # *ACES* to *Linear*, *Rec. 709* primaries.
1231 XYZ_to_Rec709 = [3.2409699419, -1.5373831776, -0.4986107603,
1232 -0.9692436363, 1.8759675015, 0.0415550574,
1233 0.0556300797, -0.2039769589, 1.0569715142]
1235 cs = create_generic_matrix(
1237 from_reference_values=[ACES_AP0_to_XYZ, XYZ_to_Rec709])
1238 config_data['colorSpaces'].append(cs)
1240 # *ACES* to *Linear*, *Rec. 2020* primaries.
1241 XYZ_to_Rec2020 = [1.7166511880, -0.3556707838, -0.2533662814,
1242 -0.6666843518, 1.6164812366, 0.0157685458,
1243 0.0176398574, -0.0427706133, 0.9421031212]
1245 cs = create_generic_matrix(
1246 'Linear - Rec.2020',
1247 from_reference_values=[ACES_AP0_to_XYZ, XYZ_to_Rec2020])
1248 config_data['colorSpaces'].append(cs)
1250 print('generateLUTs - end')
1254 def generate_baked_LUTs(odt_info,
1260 lut_resolution_shaper=1024):
1267 Parameter description.
1272 Return value description.
1275 odt_info_C = dict(odt_info)
1276 for odt_CTL_name, odt_values in odt_info.iteritems():
1277 if odt_CTL_name in ['Academy.Rec2020_100nits_dim.a1.0.0',
1278 'Academy.Rec709_100nits_dim.a1.0.0',
1279 'Academy.Rec709_D60sim_100nits_dim.a1.0.0']:
1280 odt_name = odt_values['transformUserName']
1282 odt_values_legal = dict(odt_values)
1283 odt_values_legal['transformUserName'] = '%s - Legal' % odt_name
1284 odt_info_C['%s - Legal' % odt_CTL_name] = odt_values_legal
1286 odt_values_full = dict(odt_values)
1287 odt_values_full['transformUserName'] = '%s - Full' % odt_name
1288 odt_info_C['%s - Full' % odt_CTL_name] = odt_values_full
1290 del (odt_info_C[odt_CTL_name])
1292 for odt_CTL_name, odt_values in odt_info_C.iteritems():
1293 odt_prefix = odt_values['transformUserNamePrefix']
1294 odt_name = odt_values['transformUserName']
1297 for input_space in ['ACEScc', 'ACESproxy']:
1298 args = ['--iconfig', config_path,
1300 '--inputspace', input_space]
1301 args += ['--outputspace', '%s' % odt_name]
1302 args += ['--description',
1303 '%s - %s for %s data' % (odt_prefix,
1306 args += ['--shaperspace', shaper_name,
1307 '--shapersize', str(lut_resolution_shaper)]
1308 args += ['--cubesize', str(lut_resolution_3d)]
1309 args += ['--format',
1311 os.path.join(baked_directory,
1313 '%s for %s.icc' % (odt_name, input_space))]
1315 bake_LUT = Process(description='bake a LUT',
1321 for input_space in ['ACEScc', 'ACESproxy']:
1322 args = ['--iconfig', config_path,
1324 '--inputspace', input_space]
1325 args += ['--outputspace', '%s' % odt_name]
1326 args += ['--description',
1327 '%s - %s for %s data' % (
1328 odt_prefix, odt_name, input_space)]
1329 args += ['--shaperspace', shaper_name,
1330 '--shapersize', str(lut_resolution_shaper)]
1331 args += ['--cubesize', str(lut_resolution_3d)]
1333 fargs = ['--format',
1338 '%s for %s Flame.3dl' % (odt_name, input_space))]
1339 bake_LUT = Process(description='bake a LUT',
1341 args=(args + fargs))
1344 largs = ['--format',
1349 '%s for %s Lustre.3dl' % (odt_name, input_space))]
1350 bake_LUT = Process(description='bake a LUT',
1352 args=(args + largs))
1356 for input_space in ['ACEScg', 'ACES2065-1']:
1357 args = ['--iconfig', config_path,
1359 '--inputspace', input_space]
1360 args += ['--outputspace', '%s' % odt_name]
1361 args += ['--description',
1362 '%s - %s for %s data' % (
1363 odt_prefix, odt_name, input_space)]
1364 if input_space == 'ACEScg':
1365 lin_shaper_name = '%s - AP1' % shaper_name
1367 lin_shaper_name = shaper_name
1368 args += ['--shaperspace', lin_shaper_name,
1369 '--shapersize', str(lut_resolution_shaper)]
1371 args += ['--cubesize', str(lut_resolution_3d)]
1373 margs = ['--format',
1378 '%s for %s Maya.csp' % (odt_name, input_space))]
1379 bake_LUT = Process(description='bake a LUT',
1381 args=(args + margs))
1384 hargs = ['--format',
1389 '%s for %s Houdini.lut' % (odt_name, input_space))]
1390 bake_LUT = Process(description='bake a LUT',
1392 args=(args + hargs))
1396 def create_config_dir(config_directory, bake_secondary_LUTs):
1403 Parameter description.
1408 Return value description.
1411 dirs = [config_directory, os.path.join(config_directory, 'luts')]
1412 if bake_secondary_LUTs:
1413 dirs.extend([os.path.join(config_directory, 'baked'),
1414 os.path.join(config_directory, 'baked', 'flame'),
1415 os.path.join(config_directory, 'baked', 'photoshop'),
1416 os.path.join(config_directory, 'baked', 'houdini'),
1417 os.path.join(config_directory, 'baked', 'lustre'),
1418 os.path.join(config_directory, 'baked', 'maya')])
1421 not os.path.exists(d) and os.mkdir(d)
1424 def get_transform_info(ctl_transform):
1431 Parameter description.
1436 Return value description.
1439 with open(ctl_transform, 'rb') as fp:
1440 lines = fp.readlines()
1442 # Retrieving the *transform ID* and *User Name*.
1443 transform_id = lines[1][3:].split('<')[1].split('>')[1].strip()
1444 transform_user_name = '-'.join(
1445 lines[2][3:].split('<')[1].split('>')[1].split('-')[1:]).strip()
1446 transform_user_name_prefix = (
1447 lines[2][3:].split('<')[1].split('>')[1].split('-')[0].strip())
1449 return transform_id, transform_user_name, transform_user_name_prefix
1452 def get_ODT_info(aces_CTL_directory):
1456 For versions after WGR9.
1461 Parameter description.
1466 Return value description.
1469 # TODO: Investigate usage of *files_walker* definition here.
1470 # Credit to *Alex Fry* for the original approach here.
1471 odt_dir = os.path.join(aces_CTL_directory, 'odt')
1473 for dir_name, subdir_list, file_list in os.walk(odt_dir):
1474 for fname in file_list:
1475 all_odt.append((os.path.join(dir_name, fname)))
1477 odt_CTLs = [x for x in all_odt if
1478 ('InvODT' not in x) and (os.path.split(x)[-1][0] != '.')]
1482 for odt_CTL in odt_CTLs:
1483 odt_tokens = os.path.split(odt_CTL)
1485 # Handling nested directories.
1486 odt_path_tokens = os.path.split(odt_tokens[-2])
1487 odt_dir = odt_path_tokens[-1]
1488 while odt_path_tokens[-2][-3:] != 'odt':
1489 odt_path_tokens = os.path.split(odt_path_tokens[-2])
1490 odt_dir = os.path.join(odt_path_tokens[-1], odt_dir)
1492 # Building full name,
1493 transform_CTL = odt_tokens[-1]
1494 odt_name = string.join(transform_CTL.split('.')[1:-1], '.')
1496 # Finding id, user name and user name prefix.
1498 transform_user_name,
1499 transform_user_name_prefix) = get_transform_info(
1500 os.path.join(aces_CTL_directory, 'odt', odt_dir, transform_CTL))
1503 transform_CTL_inverse = 'InvODT.%s.ctl' % odt_name
1504 if not os.path.exists(
1505 os.path.join(odt_tokens[-2], transform_CTL_inverse)):
1506 transform_CTL_inverse = None
1508 # Add to list of ODTs
1510 odts[odt_name]['transformCTL'] = os.path.join(odt_dir, transform_CTL)
1511 if transform_CTL_inverse is not None:
1512 odts[odt_name]['transformCTLInverse'] = os.path.join(
1513 odt_dir, transform_CTL_inverse)
1515 odts[odt_name]['transformID'] = transform_ID
1516 odts[odt_name]['transformUserNamePrefix'] = transform_user_name_prefix
1517 odts[odt_name]['transformUserName'] = transform_user_name
1519 forward_CTL = odts[odt_name]['transformCTL']
1521 print('ODT : %s' % odt_name)
1522 print('\tTransform ID : %s' % transform_ID)
1523 print('\tTransform User Name Prefix : %s' % transform_user_name_prefix)
1524 print('\tTransform User Name : %s' % transform_user_name)
1525 print('\tForward ctl : %s' % forward_CTL)
1526 if 'transformCTLInverse' in odts[odt_name]:
1527 inverse_CTL = odts[odt_name]['transformCTLInverse']
1528 print('\tInverse ctl : %s' % inverse_CTL)
1530 print('\tInverse ctl : %s' % 'None')
1537 def get_LMT_info(aces_CTL_directory):
1541 For versions after WGR9.
1546 Parameter description.
1551 Return value description.
1554 # TODO: Investigate refactoring with previous definition.
1556 # Credit to Alex Fry for the original approach here
1557 lmt_dir = os.path.join(aces_CTL_directory, 'lmt')
1559 for dir_name, subdir_list, file_list in os.walk(lmt_dir):
1560 for fname in file_list:
1561 all_lmt.append((os.path.join(dir_name, fname)))
1563 lmt_CTLs = [x for x in all_lmt if
1564 ('InvLMT' not in x) and ('README' not in x) and (
1565 os.path.split(x)[-1][0] != '.')]
1569 for lmt_CTL in lmt_CTLs:
1570 lmt_tokens = os.path.split(lmt_CTL)
1572 # Handlimg nested directories.
1573 lmt_path_tokens = os.path.split(lmt_tokens[-2])
1574 lmt_dir = lmt_path_tokens[-1]
1575 while lmt_path_tokens[-2][-3:] != 'ctl':
1576 lmt_path_tokens = os.path.split(lmt_path_tokens[-2])
1577 lmt_dir = os.path.join(lmt_path_tokens[-1], lmt_dir)
1579 # Building full name.
1580 transform_CTL = lmt_tokens[-1]
1581 lmt_name = string.join(transform_CTL.split('.')[1:-1], '.')
1583 # Finding id, user name and user name prefix.
1585 transform_user_name,
1586 transform_user_name_prefix) = get_transform_info(
1587 os.path.join(aces_CTL_directory, lmt_dir, transform_CTL))
1590 transform_CTL_inverse = 'InvLMT.%s.ctl' % lmt_name
1591 if not os.path.exists(
1592 os.path.join(lmt_tokens[-2], transform_CTL_inverse)):
1593 transform_CTL_inverse = None
1596 lmts[lmt_name]['transformCTL'] = os.path.join(lmt_dir, transform_CTL)
1597 if transform_CTL_inverse is not None:
1598 lmts[lmt_name]['transformCTLInverse'] = os.path.join(
1599 lmt_dir, transform_CTL_inverse)
1601 lmts[lmt_name]['transformID'] = transform_ID
1602 lmts[lmt_name]['transformUserNamePrefix'] = transform_user_name_prefix
1603 lmts[lmt_name]['transformUserName'] = transform_user_name
1605 forward_CTL = lmts[lmt_name]['transformCTL']
1607 print('LMT : %s' % lmt_name)
1608 print('\tTransform ID : %s' % transform_ID)
1609 print('\tTransform User Name Prefix : %s' % transform_user_name_prefix)
1610 print('\tTransform User Name : %s' % transform_user_name)
1611 print('\t Forward ctl : %s' % forward_CTL)
1612 if 'transformCTLInverse' in lmts[lmt_name]:
1613 inverse_CTL = lmts[lmt_name]['transformCTLInverse']
1614 print('\t Inverse ctl : %s' % inverse_CTL)
1616 print('\t Inverse ctl : %s' % 'None')
1623 def create_ACES_config(aces_CTL_directory,
1625 lut_resolution_1d=4096,
1626 lut_resolution_3d=64,
1627 bake_secondary_LUTs=True,
1630 Creates the ACES configuration.
1635 Parameter description.
1640 Return value description.
1643 odt_info = get_ODT_info(aces_CTL_directory)
1644 lmt_info = get_LMT_info(aces_CTL_directory)
1646 create_config_dir(config_directory, bake_secondary_LUTs)
1648 lut_directory = os.path.join(config_directory, 'luts')
1649 shaper_name = 'Output Shaper'
1650 config_data = generate_LUTs(odt_info,
1659 print('Creating "generic" config')
1660 config = create_config(config_data)
1663 write_config(config,
1664 os.path.join(config_directory, 'config.ocio'))
1666 print('Creating "Nuke" config')
1667 nuke_config = create_config(config_data, nuke=True)
1670 write_config(nuke_config,
1671 os.path.join(config_directory, 'nuke_config.ocio'))
1673 if bake_secondary_LUTs:
1674 generate_baked_LUTs(odt_info,
1676 os.path.join(config_directory, 'baked'),
1677 os.path.join(config_directory, 'config.ocio'),
1692 Parameter description.
1697 Return value description.
1702 p = optparse.OptionParser(description='An OCIO config generation script',
1703 prog='createACESConfig',
1704 version='createACESConfig 0.1',
1705 usage='%prog [options]')
1706 p.add_option('--acesCTLDir', '-a', default=os.environ.get(
1707 ACES_OCIO_CTL_DIRECTORY_ENVIRON, None))
1708 p.add_option('--configDir', '-c', default=os.environ.get(
1709 ACES_OCIO_CONFIGURATION_DIRECTORY_ENVIRON, None))
1710 p.add_option('--lutResolution1d', default=4096)
1711 p.add_option('--lutResolution3d', default=64)
1712 p.add_option('--dontBakeSecondaryLUTs', action='store_true')
1713 p.add_option('--keepTempImages', action='store_true')
1715 options, arguments = p.parse_args()
1717 aces_CTL_directory = options.acesCTLDir
1718 config_directory = options.configDir
1719 lut_resolution_1d = int(options.lutResolution1d)
1720 lut_resolution_3d = int(options.lutResolution3d)
1721 bake_secondary_LUTs = not options.dontBakeSecondaryLUTs
1722 cleanup_temp_images = not options.keepTempImages
1724 # TODO: Investigate the following statements.
1726 args_start = sys.argv.index('--') + 1
1727 args = sys.argv[args_start:]
1729 args_start = len(sys.argv) + 1
1732 print('command line : \n%s\n' % ' '.join(sys.argv))
1734 assert aces_CTL_directory is not None, (
1735 'process: No "{0}" environment variable defined or no "ACES CTL" '
1736 'directory specified'.format(
1737 ACES_OCIO_CTL_DIRECTORY_ENVIRON))
1739 assert config_directory is not None, (
1740 'process: No "{0}" environment variable defined or no configuration '
1741 'directory specified'.format(
1742 ACES_OCIO_CONFIGURATION_DIRECTORY_ENVIRON))
1744 return create_ACES_config(aces_CTL_directory,
1748 bake_secondary_LUTs,
1749 cleanup_temp_images)
1752 if __name__ == '__main__':