Skip to content
HALOWERK

Image Processing

pnm sample sample headroom

Portable raster headroom reports the lowest and highest observed values and unused headroom per channel. Use it when an agent needs clipping margin relative to the declared sample maximum.

POST https://bild.halowerk.com/v1/pnm-sample-sample-headroom

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
pnmstringYes
Show full input schema
{
  "type": "object",
  "properties": {
    "pnm": {
      "type": "string",
      "maxLength": 45000,
      "minLength": 1
    }
  },
  "required": [
    "pnm"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "pnm": "P3\n# tile swatch\n3 2\n15\n0 0 0 15 0 0 0 15 0\n0 0 15 15 15 15 15 0 0"
}

Result & documentation

Show published result schema
{
  "type": "object",
  "required": [
    "measured_at",
    "source",
    "data",
    "limitations"
  ],
  "properties": {
    "measured_at": {
      "type": "string"
    },
    "source": {
      "type": "object",
      "required": [
        "reference",
        "retrieved_at"
      ],
      "properties": {
        "reference": {
          "type": "string"
        },
        "retrieved_at": {
          "type": "string"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "headroom": {
          "type": "array",
          "items": {
            "type": "integer"
          }
        }
      },
      "required": [
        "minimum",
        "maximum",
        "headroom"
      ]
    },
    "limitations": {
      "type": "string"
    }
  }
}

Machine-readable documentation of this hub

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

More endpoints in this hub

All endpoints in this hub →