{
  "id": "unity/asset-import-cr2-raw-not-supported",
  "signature": "Failed to import asset: 'Assets/Textures/photo.cr2'. Error: Could not decode raw image data",
  "signature_zh": "导入资源失败: 'Assets/Textures/photo.cr2'。错误: 无法解码原始图像数据",
  "regex": "Failed to import asset:.*\\.cr2.*Error: Could not decode raw image data",
  "domain": "unity",
  "category": "resource_error",
  "subcategory": null,
  "root_cause": "Unity's texture importer does not support Canon CR2 raw image format; it expects standard formats like PNG, JPG, TGA, or EXR.",
  "root_cause_type": "generic",
  "root_cause_zh": "Unity的纹理导入器不支持佳能CR2原始图像格式；它期望标准格式如PNG、JPG、TGA或EXR。",
  "versions": [
    {
      "version": "Unity 2021.3",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Unity 2022.3",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Unity 2023.2",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Renaming does not change the internal file format; Unity will still attempt to decode the raw data and fail with a similar error.",
      "fail_rate": 0.98,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Unity does not use system codecs for texture import; it relies on built-in decoders for supported formats only.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Re-saving in the same format does not change the encoding; Unity still cannot decode it.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Convert the CR2 file to a supported format (e.g., PNG, JPG, or EXR) using an external tool like Adobe Photoshop, GIMP, or ImageMagick. Command example: magick convert photo.cr2 photo.png",
      "success_rate": 0.95,
      "how": "Convert the CR2 file to a supported format (e.g., PNG, JPG, or EXR) using an external tool like Adobe Photoshop, GIMP, or ImageMagick. Command example: magick convert photo.cr2 photo.png",
      "condition": "",
      "sources": []
    },
    {
      "action": "If the raw image is needed for high-dynamic-range, convert to EXR or HDR format instead of PNG/JPG to preserve data.",
      "success_rate": 0.9,
      "how": "If the raw image is needed for high-dynamic-range, convert to EXR or HDR format instead of PNG/JPG to preserve data.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use a custom importer or script that loads the CR2 file via a third-party library (e.g., LibRaw) at runtime, bypassing Unity's import pipeline entirely.",
      "success_rate": 0.7,
      "how": "Use a custom importer or script that loads the CR2 file via a third-party library (e.g., LibRaw) at runtime, bypassing Unity's import pipeline entirely.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "使用外部工具如Adobe Photoshop、GIMP或ImageMagick将CR2文件转换为支持的格式（如PNG、JPG或EXR）。命令示例：magick convert photo.cr2 photo.png",
    "如果需要原始图像用于高动态范围，转换为EXR或HDR格式而不是PNG/JPG以保留数据。",
    "使用自定义导入器或脚本，通过第三方库（如LibRaw）在运行时加载CR2文件，完全绕过Unity的导入管线。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.unity3d.com/Manual/ImportingTextures.html",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.9,
  "fix_success_rate": 0.95,
  "resolvable": "true",
  "first_seen": "2023-11-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}