Skip to main content

​
Overview

Validates image dimensions, megapixels, and aspect ratio against your requirements.

​
Configuration

​
config.allowed_aspect_ratios
array
Allowed aspect ratios (for example: “1:1”, “4:5”).
​
config.min_width
integer
Minimum width in pixels.
​
config.min_height
integer
Minimum height in pixels.
​
config.min_megapixels
number
Minimum megapixels required.

​
Example Configuration

{
  "detector_name": "image_specs",
  "config": {
    "allowed_aspect_ratios": ["1:1", "4:5"],
    "min_width": 1080,
    "min_height": 1080,
    "min_megapixels": 1.0
  }
}

​
Result Schema

{
  "detector_name": "image_specs",
  "pass_check": true,
  "score": 1.0,
  "rationale": "Image meets resolution/aspect specifications",
  "metrics": {
    "checks": {
      "min_width": {"pass": true, "actual": 1200, "threshold": 1080},
      "min_height": {"pass": true, "actual": 1200, "threshold": 1080},
      "min_megapixels": {"pass": true, "actual": 1.44, "threshold": 1.0},
      "aspect_ratio": {
        "pass": true,
        "actual": 1.0,
        "closest_ratio": "1:1",
        "deviation": 0.0,
        "limit": 0.02
      }
    },
    "issues": [],
    "image_metadata": {
      "width": 1200,
      "height": 1200,
      "megapixels": 1.44,
      "mode": "RGB",
      "format": "JPEG",
      "dpi": [72, 72]
    }
  }
}

​
Interpreting Results

  • checks: Per-rule pass/fail details for size and aspect ratio.
  • issues: Human-readable reasons when a check fails.
  • image_metadata: Observed properties used for validation.