Troubleshooting¶
Image Is Not Available¶
Source and target selectors only include images with all 24 sampled values. In the Image Editor, align the overlay and use Sample Chart.
Incorrect Brightness or Color¶
Verify the input Color Space on every sampled image. An incorrect input transform changes the values used by the fit.
Other common causes are reversed chart orientation, inaccurate corner alignment, clipped patches, uneven lighting, reflections, and an unsuitable Normalize or Create Exposure Node setting.
Incorrect Target Gamut¶
MacBlend supports 14 target gamuts. It matches explicit aliases for Blender’s blend-file working space, or the OCIO scene_linear role on older Blender versions, and shows Auto-detected when it finds one. Otherwise, it shows Couldn’t detect target gamut from scene and keeps Linear Rec. 709 selected as a fallback. Select the actual scene-linear working gamut manually when a custom OCIO configuration uses another name.
Sampling Fails or Uses Too Much Memory¶
The image requires a valid resolution and supported channel count. Its full decoded pixel buffer must fit in memory; reduce the image dimensions when memory is constrained. Patch Size has comparatively little effect on peak memory.
Enable Debug Logging in the MacBlend extension preferences to print pixel-transfer, patch-average, and calibration diagnostics to Blender’s console.
Reporting a Problem¶
Open a GitHub bug report with the Blender and MacBlend versions, operating system, reproduction steps, image color-space settings, relevant console output, and screenshots or redistributable sample files.