Skip to content
HALOWERK

Bildwerk

gauge read

Samples the grey image along rays from the centre (default image centre, radius 45 % of the shorter side) every 0.25° between 20 % and 70 % of the radius, avoiding hub and ticks. Needle = direction of strongest dark (or light) contrast to the dial median, smoothed ±1° with parabolic refinement. Angles clockwise from 12 o'clock. The value is interpolated between your scale points in the given direction; outside the span the nearer end is reported.

POST https://bild.halowerk.com/v1/gauge-read

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoImage (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB.
image_urlstringNoOr a public image URL.
centerobjectNoNeedle pivot (default image centre).
radiusnumberNoDial radius (default 45 % of short side).
min_angle_degnumberNoScale start, ° clockwise from 12 o'clock.
max_angle_degnumberNoScale end angle.
min_valuenumberNoValue at start.
max_valuenumberNoValue at end.
scale_pointsarrayNoInstead of min/max: points in scale order.
directionstringNoValues increase this way.
needlestringNoNeedle vs dial.
unitstringNoEchoed unit.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Image (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Or a public image URL."
    },
    "center": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "x",
        "y"
      ],
      "description": "Needle pivot (default image centre).",
      "properties": {
        "x": {
          "type": "number",
          "minimum": 0
        },
        "y": {
          "type": "number",
          "minimum": 0
        }
      }
    },
    "radius": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Dial radius (default 45 % of short side)."
    },
    "min_angle_deg": {
      "type": "number",
      "minimum": -360,
      "maximum": 360,
      "description": "Scale start, ° clockwise from 12 o'clock."
    },
    "max_angle_deg": {
      "type": "number",
      "minimum": -360,
      "maximum": 360,
      "description": "Scale end angle."
    },
    "min_value": {
      "type": "number",
      "description": "Value at start."
    },
    "max_value": {
      "type": "number",
      "description": "Value at end."
    },
    "scale_points": {
      "type": "array",
      "minItems": 2,
      "maxItems": 30,
      "description": "Instead of min/max: points in scale order.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "angle_deg",
          "value"
        ],
        "properties": {
          "angle_deg": {
            "type": "number"
          },
          "value": {
            "type": "number"
          }
        }
      }
    },
    "direction": {
      "type": "string",
      "enum": [
        "clockwise",
        "counterclockwise"
      ],
      "default": "clockwise",
      "description": "Values increase this way."
    },
    "needle": {
      "type": "string",
      "enum": [
        "dark",
        "light"
      ],
      "default": "dark",
      "description": "Needle vs dial."
    },
    "unit": {
      "type": "string",
      "maxLength": 16,
      "description": "Echoed unit."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAHgAAAB4AQMAAAADqqSRAAAABlBMVEX+/v4dHR2T1n7oAAAACXBIWXMAAAsTAAALEwEAmpwYAAACMElEQVQ4jaWVMY7VMBCG/2BpTbF6oUwRkitsmSIQToL2CCkjhN5a4hIchYLCVFwjEgcgHSmeMJqxPZ6Xp5VATOH4ixLP75mxB/grq8OmsQohOMV9CGFXHC7oQ0Eb0CCs5fMNDeryw5NDg+q3rH4BGmDKHszGXPssxjObLKn/zNzkBc8tP4Zz4v2eHw99Wn478XOuowOz3vHz0UYH1iWuouL0Gy3E41vhjzyOwiOPi3DHY4lcze5LHCwJMHlbcDzll/yh50+Fzcpcy9+el+5KWAy5biUsrh5IFA1kEzoSuMTo0D4GErjcy24eOi13j76y3GoHrJJP4bcOVXZvV8C4sh2KpvH0KslztKXCFNbKl+1RWKuVXETj7Cm+RK6VHGBDzCVlFZRTYcM6C8fkziknUQ6wIEejZx6EJx4Lx2Ia8HpXue+/4M1F1cb0FeNLJefViEHLQZt5OnDwB3ZXXP0nI53G9jkeD5ysVdVNNt5we8XDP3N3xYvkK9qMk34xzzjlU012nvU1ArpY7DvFL1T9sK2l3siqtdQjs79lr9j4Uu/MTh9n8OJXDH38wcVbrgfw5o88Kh45BcUGuVSiLfo+QPRl3WOiu3R/ZEWW2XzLOzCfaFb9kAvnO89+yXI/efwg/F5EFXm4uQ974V2CEtdfo1vR4+PrHKF0H6ffykI54/kZj2r5LjUG6QdpIv2C+gkdOcnsE81Kv6GygS4kS6dD9SuEHZPqZzf97tgPj/3yefsDLgi1JHerYHIAAAAASUVORK5CYII=",
  "min_angle_deg": -135,
  "max_angle_deg": 135,
  "min_value": 0,
  "max_value": 10,
  "unit": "bar"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →