{"library":"opencolorio","title":"OpenColorIO (OCIO)","description":"OpenColorIO (OCIO) is an Academy Software Foundation (ASWF) project providing a comprehensive color management solution for motion picture production, visual effects, and computer animation. It offers a consistent user experience, is compatible with the Academy Color Encoding Specification (ACES), and is LUT-format agnostic. The current version is 2.5.1, and the project targets annual releases around September, aligning with the VFX Reference Platform schedule.","language":"python","status":"active","last_verified":"Mon May 18","install":{"commands":["pip install opencolorio"],"cli":{"name":"ocioconvert","version":"Invalid option \"--version\""}},"imports":["import PyOpenColorIO as OCIO"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nimport PyOpenColorIO as OCIO\n\ndef apply_color_transform(rgb_value, source_space, destination_space, ocio_config_path):\n    # Ensure the OCIO environment variable is set for config loading\n    if 'OCIO' not in os.environ or os.environ['OCIO'] != ocio_config_path:\n        os.environ['OCIO'] = ocio_config_path\n    \n    try:\n        config = OCIO.GetCurrentConfig()\n        processor = config.getProcessor(source_space, destination_space)\n        cpu_processor = processor.getDefaultCPUProcessor()\n        \n        # Apply the transform to an RGB tuple/list\n        transformed_rgb = cpu_processor.applyRGB(rgb_value)\n        return transformed_rgb\n    except OCIO.Exception as e:\n        print(f\"OpenColorIO Error: {e}\")\n        return None\n\n# Example Usage (requires an OCIO config file to be set up)\n# You can download reference configs from https://github.com/AcademySoftwareFoundation/OpenColorIO-Config-ACES\n# For example, use 'aces_1.2/config.ocio'\n\n# NOTE: Replace with the actual path to your OCIO config file\nocio_config_file = os.environ.get('OCIO_TEST_CONFIG', './config.ocio') # Placeholder for CI/testing\n\nif not os.path.exists(ocio_config_file):\n    print(f\"Warning: OCIO config file not found at '{ocio_config_file}'. Skipping quickstart example. \"\n          \"Please set the OCIO_TEST_CONFIG environment variable or provide a valid path.\")\nelse:\n    print(f\"Using OCIO config: {ocio_config_file}\")\n    input_rgb = [0.5, 0.1, 0.9] # Example color in source_space\n    src_cs = 'sRGB'\n    dst_cs = 'ACES - ACEScg'\n    \n    # Note: The exact color space names depend on the loaded OCIO config.\n    # Common ones are 'sRGB', 'ACES - ACEScg', 'Utility - Linear - sRGB', etc.\n    \n    transformed_color = apply_color_transform(\n        input_rgb, src_cs, dst_cs, ocio_config_file\n    )\n\n    if transformed_color:\n        print(f\"Original RGB ({src_cs}): {input_rgb}\")\n        print(f\"Transformed RGB ({dst_cs}): {transformed_color}\")\n","lang":"python","description":"This quickstart demonstrates how to perform a basic color space transformation on an RGB value. It requires an OpenColorIO configuration file (e.g., an ACES config) to be accessible, typically via the `OCIO` environment variable. The example shows how to load the current configuration, create a processor between two color spaces, and apply the transformation using the CPU processor.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"2.5.2","pypi_latest":"2.5.2","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":50,"avg_install_s":2.4,"avg_import_s":0.03,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"opencolorio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"opencolorio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.4,"import_time_s":0.03,"mem_mb":1.8,"disk_size":"39M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"opencolorio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"opencolorio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.4,"import_time_s":0.03,"mem_mb":1.2,"disk_size":"41M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"opencolorio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"opencolorio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.9,"import_time_s":0.03,"mem_mb":1,"disk_size":"33M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"opencolorio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"opencolorio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.6,"import_time_s":0.03,"mem_mb":1,"disk_size":"32M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"opencolorio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"opencolorio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.6,"import_time_s":0.04,"mem_mb":1.8,"disk_size":"38M"}]}}