Decoding Scanin: Resolving Chart Recognition Errors in ArgyllCMS

In the precision-driven workflow of digital archiving and film scanning, ArgyllCMS stands as the gold standard for creating custom ICC color profiles. However, the scanin command—the bridge that translates a physical color target into a data-driven .ti3 file—is notoriously sensitive. If your lighting is uneven, your crop is too tight, or your target description file (.cht) doesn't match your physical chart, scanin will fail with cryptic error messages. Mastering these errors is the difference between a color-accurate workflow and a digital mess. This tutorial deconstructs the common failure points of the scanin process to ensure your profiling is flawless on the first pass.

Table of Content

• Purpose: Validating Color Accuracy
• The Logic: How Scanin Finds the Grid
• Step-by-Step: Fixing Scanin Failures
• Use Case: Profiling an IT8.7/2 Target
• Best Results: Optimal Scan Settings
• FAQ
• Disclaimer

Purpose

Efficiently troubleshooting scanin ensures:

• Data Integrity: Guaranteeing that the RGB values extracted from the scan match the physical patches exactly.
• Time Efficiency: Avoiding repetitive high-resolution scans caused by minor alignment or cropping errors.
• Profile Quality: Ensuring the resulting .ti3 file has a low "Delta E" for professional-grade color reproduction.

The Logic: How Scanin Finds the Grid

The scanin command works by looking for "fidelity landmarks"—usually the black-and-white borders or corner marks of your color chart (like an IT8.7/2 or ColorChecker). It uses the .cht file as a geometric map and the .cie (or .ti1) as a reference of true color values.

If the command returns "Pattern match failed" or "Can't find chart corners," it means the software cannot distinguish the chart borders from the background scan area. This is often due to a lack of "breathing room" around the target or excessive glare on the black patches that the software uses for orientation.

Step-by-Step: Fixing Scanin Failures

1. Check File Format and Gamma

ArgyllCMS scanin prefers uncompressed TIFF files. Ensure your scan is "linear" (Gamma 1.0). If you have applied a curve or "Auto-Exposure" in your scanning software, scanin may fail to recognize the contrast ratios of the alignment marks.

2. Add a Neutral Border

If you receive the "Failed to find chart" error, re-scan or crop your image so there is a consistent, neutral (usually black or grey) border around the entire chart. If the chart touches the very edge of the image file, the algorithm cannot "see" the external boundary of the target.

3. Verify the Command Syntax

The most common non-visual error is a mismatch in the argument order. A standard successful command looks like this:

scanin -v -dipn input_scan.tif target_definition.cht reference_data.cie

• -v: Verbose mode (shows you exactly where it fails).
• -dipn: Generates a diagnostic TIFF (diag.tif) showing where the software thinks the patches are.

4. Analyze the Diagnostic Image

If the command runs but the profile is "weird," open the diag.tif. If the red grid lines do not sit perfectly in the center of the color patches, your .cht file is likely the wrong version for your specific physical chart. You must adjust the alignment or find the correct chart description.

Use Case: Profiling an IT8.7/2 Target

A photographer is scanning 40-year-old slides and needs an ICC profile for their Epson V850.

• The Problem: scanin keeps returning "Inconsistent scan values."
• The Diagnosis: The photographer used "Dust Removal" (ICE) in the scanning software. This infrared pass altered the edges of the black patches on the IT8 target.
• The Action: Disable all software corrections (ICE, Sharpening, Auto-Level) and scan in "Raw" mode.
• The Result: scanin identifies the grid instantly, and the resulting profile provides perfect color for the slide archive.

Best Results

FAQ

Can I use a JPEG for scanin?

Technically yes, but the compression artifacts at patch edges can lead to "noisy" data in your profile. For professional work, always use TIFF.

What does the '-dipn' flag do?

It stands for "Diagnostic Image." It creates a visual map of the sampling points. If your profile feels "off," this is the first file you should check to see if the grid is misaligned.

Why does scanin say my chart is "upside down"?

ArgyllCMS looks for specific patch arrangements (usually the grayscale ramp). If your scan is flipped or mirrored, scanin will fail. Check your scanner software for "Mirror" settings.

Disclaimer

ArgyllCMS is a command-line power tool. Ensure all filenames do not contain spaces, as this is a frequent cause of "File not found" errors on Windows systems. March 2026.

Tags: ArgyllCMS, ICC_Profiling, Color_Management, Scanin_Errors