{
  "title": "Image difference overlay",
  "human_url": "https://happytails.ai/en/image-tools/image-difference-overlay/",
  "agent_url": "https://happytails.ai/agents/en/image-tools/image-difference-overlay/",
  "language": "en",
  "markdown_url": "https://happytails.ai/en/image-tools/image-difference-overlay.md",
  "content": "Image difference overlay\nCompare two images on the same pixel grid. Download the difference image, highlighted overlay and change mask.\nHow can we improve this tool?\nReport a problem or share an idea.\nPlease leave out private information. Your message and the tool name go to our team via PostHog.\nHow to use Image difference overlay\nChoose two still images in the order shown in the file list.\nAlign the second image with horizontal and vertical offsets, then set a difference threshold.\nRun the comparison and download the images or report.\nUseful next steps\nImage to ASCII art\nReplace image color\nAlign before comparing\nOffsets place the second image within the first image’s coordinate grid. Regions without overlap are shown in magenta on the difference image and mask, and counted separately.\nA precise pixel comparison\nA pixel changes when its largest decoded RGBA channel difference is greater than the threshold. The red overlay shows changed pixels. This is not a perceptual similarity score.",
  "content_format": "text/plain",
  "visibility": "public",
  "links": [
    {
      "name": "Image to ASCII art",
      "url": "https://happytails.ai/en/image-tools/image-to-ascii-art/"
    },
    {
      "name": "Replace image color",
      "url": "https://happytails.ai/en/image-tools/image-color-replacement/"
    }
  ],
  "tool": {
    "id": "image-difference-overlay",
    "category": "image-tools",
    "built": true,
    "requirements": "Files stay in this browser. Use still PNG, JPEG or WebP images, up to 20 MiB per file, 40 MiB combined and 16 million decoded pixels combined. Outputs total at most 100 MiB. Processing stops after 30 seconds. Source metadata and color profiles are not copied.",
    "implementation": {
      "fields": [
        {
          "key": "offsetX",
          "label": "Second image horizontal offset",
          "value": 0,
          "type": "number",
          "min": -16384,
          "max": 16384,
          "step": 1
        },
        {
          "key": "offsetY",
          "label": "Second image vertical offset",
          "value": 0,
          "type": "number",
          "min": -16384,
          "max": 16384,
          "step": 1
        },
        {
          "key": "threshold",
          "label": "Channel difference threshold",
          "value": 0,
          "type": "number",
          "min": 0,
          "max": 255,
          "step": 1
        },
        {
          "key": "opacity",
          "label": "Highlight opacity",
          "value": 0.65,
          "type": "number",
          "min": 0,
          "max": 1,
          "step": 0.05
        }
      ],
      "registrationFamily": "raster-image-studio",
      "files": true,
      "input": false,
      "multiple": true,
      "accept": ".png,.jpg,.jpeg,.webp",
      "maxFileBytes": 41943040,
      "deferImagePreview": true,
      "note": "Files stay in this browser. Use still PNG, JPEG or WebP images, up to 20 MiB per file, 40 MiB combined and 16 million decoded pixels combined. Outputs total at most 100 MiB. Processing stops after 30 seconds. Source metadata and color profiles are not copied.",
      "experience": {
        "automatic": false,
        "single": false,
        "inputMaxLength": 1000000,
        "inputMode": "text",
        "label": "Your text",
        "placeholder": "Type or paste your input…",
        "help": "Up to 1,000,000 characters. Review the settings before running.",
        "action": null
      },
      "mode": "explicit",
      "interactive": false
    },
    "execution": "Browser interface",
    "api": null,
    "browser_agent": {
      "supported": true,
      "name": "run_current_tool",
      "discovery": "WebMCP on the human page in a supporting browser",
      "verification": "See audit/API-AUDIT.md; availability is not verification"
    }
  },
  "markdown": "# Image difference overlay\n\n- Human page: https://happytails.ai/en/image-tools/image-difference-overlay/\n- Markdown: https://happytails.ai/en/image-tools/image-difference-overlay.md\n- Structured JSON: https://happytails.ai/agents/en/image-tools/image-difference-overlay/index.json\n- Visibility: public\n\n## Tool capabilities\n\n| Property | Value |\n| --- | --- |\n| Tool ID | `image-difference-overlay` |\n| Category | image-tools |\n| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |\n| Browser execution | Use the visible action or interactive controls. |\n| Browser processing | Browser; see tool notes for network behavior. |\n| HTTP API | Not callable through HTTP. |\n| Browser-agent interface | run_current_tool |\n\n### Implementation notes\n\nFiles stay in this browser. Use still PNG, JPEG or WebP images, up to 20 MiB per file, 40 MiB combined and 16 million decoded pixels combined. Outputs total at most 100 MiB. Processing stops after 30 seconds. Source metadata and color profiles are not copied.\n\n### Inputs and settings\n\nNo free-text input is required. Use the file inputs and/or settings below.\n\nAccepted browser files: `.png,.jpg,.jpeg,.webp`. Multiple files are supported.\n\nBrowser file-input limit: 41943040 bytes in total. HTTP limits can differ.\n\n| Setting | Meaning | Control type | Default | Constraints |\n| --- | --- | --- | --- | --- |\n| `offsetX` | Second image horizontal offset | number | 0 | min=-16384 max=16384 step=1 |\n| `offsetY` | Second image vertical offset | number | 0 | min=-16384 max=16384 step=1 |\n| `threshold` | Channel difference threshold | number | 0 | min=0 max=255 step=1 |\n| `opacity` | Highlight opacity | number | 0.65 | min=0 max=1 step=0.05 |\n\n### Browser-agent workflow\n\n1. Open the human page in a browser that supports WebMCP.\n2. Discover the interface exposed by that page; use its actual schema.\n3. Select files on the page first when the tool requires files.\n4. Call `run_current_tool` with valid input and settings.\n5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.\n\nCalls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.\n\n### Planning specification\n\nFiles stay in this browser. Use still PNG, JPEG or WebP images, up to 20 MiB per file, 40 MiB combined and 16 million decoded pixels combined. Outputs total at most 100 MiB. Processing stops after 30 seconds. Source metadata and color profiles are not copied.\n\nThis describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.\n\n### Complete machine-readable capability record\n\n```json\n{\n  \"id\": \"image-difference-overlay\",\n  \"category\": \"image-tools\",\n  \"built\": true,\n  \"requirements\": \"Files stay in this browser. Use still PNG, JPEG or WebP images, up to 20 MiB per file, 40 MiB combined and 16 million decoded pixels combined. Outputs total at most 100 MiB. Processing stops after 30 seconds. Source metadata and color profiles are not copied.\",\n  \"implementation\": {\n    \"fields\": [\n      {\n        \"key\": \"offsetX\",\n        \"label\": \"Second image horizontal offset\",\n        \"value\": 0,\n        \"type\": \"number\",\n        \"min\": -16384,\n        \"max\": 16384,\n        \"step\": 1\n      },\n      {\n        \"key\": \"offsetY\",\n        \"label\": \"Second image vertical offset\",\n        \"value\": 0,\n        \"type\": \"number\",\n        \"min\": -16384,\n        \"max\": 16384,\n        \"step\": 1\n      },\n      {\n        \"key\": \"threshold\",\n        \"label\": \"Channel difference threshold\",\n        \"value\": 0,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 255,\n        \"step\": 1\n      },\n      {\n        \"key\": \"opacity\",\n        \"label\": \"Highlight opacity\",\n        \"value\": 0.65,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 1,\n        \"step\": 0.05\n      }\n    ],\n    \"registrationFamily\": \"raster-image-studio\",\n    \"files\": true,\n    \"input\": false,\n    \"multiple\": true,\n    \"accept\": \".png,.jpg,.jpeg,.webp\",\n    \"maxFileBytes\": 41943040,\n    \"deferImagePreview\": true,\n    \"note\": \"Files stay in this browser. Use still PNG, JPEG or WebP images, up to 20 MiB per file, 40 MiB combined and 16 million decoded pixels combined. Outputs total at most 100 MiB. Processing stops after 30 seconds. Source metadata and color profiles are not copied.\",\n    \"experience\": {\n      \"automatic\": false,\n      \"single\": false,\n      \"inputMaxLength\": 1000000,\n      \"inputMode\": \"text\",\n      \"label\": \"Your text\",\n      \"placeholder\": \"Type or paste your input…\",\n      \"help\": \"Up to 1,000,000 characters. Review the settings before running.\",\n      \"action\": null\n    },\n    \"mode\": \"explicit\",\n    \"interactive\": false\n  },\n  \"execution\": \"Browser interface\",\n  \"api\": null,\n  \"browser_agent\": {\n    \"supported\": true,\n    \"name\": \"run_current_tool\",\n    \"discovery\": \"WebMCP on the human page in a supporting browser\",\n    \"verification\": \"See audit/API-AUDIT.md; availability is not verification\"\n  }\n}\n```\n\n## Page guide\n\nCompare two images on the same pixel grid. Download the difference image, highlighted overlay and change mask.\n\nHow can we improve this tool?\n\nReport a problem or share an idea.\n\nPlease leave out private information. Your message and the tool name go to our team via PostHog.\n\n### How to use Image difference overlay\n\n1. Choose two still images in the order shown in the file list.\n2. Align the second image with horizontal and vertical offsets, then set a difference threshold.\n3. Run the comparison and download the images or report.\n\n## Useful next steps\n\n- [Image to ASCII art](https://happytails.ai/en/image-tools/image-to-ascii-art/) ([Markdown](https://happytails.ai/en/image-tools/image-to-ascii-art.md))\n\n- [Replace image color](https://happytails.ai/en/image-tools/image-color-replacement/) ([Markdown](https://happytails.ai/en/image-tools/image-color-replacement.md))\n\n## Align before comparing\n\nOffsets place the second image within the first image’s coordinate grid. Regions without overlap are shown in magenta on the difference image and mask, and counted separately.\n\n### A precise pixel comparison\n\nA pixel changes when its largest decoded RGBA channel difference is greater than the threshold. The red overlay shows changed pixels. This is not a perceptual similarity score.\n"
}