Skip to content
HALOWERK

Formatwerk

format migrate

Raster images: TIFF and GIF (all pages/frames, ICC/EXIF kept, 16-bit kept) via sharp/libvips; BMP, PCX, TGA, PNM, SGI, Sun Raster and XWD via ffmpeg in a separate process without shell or environment, with prlimit (1.5 GB, 6 s CPU) and a private temporary folder. After conversion both source and PNG are decoded again and the raw pixels are compared; the result says pixel_identical per page. CMYK/Lab images are refused (PNG cannot hold them losslessly). Text: decodes with the WHATWG decoder.

POST https://format.halowerk.com/v1/format-migrate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
content_base64stringYesSource file as base64 (max. about 20 MB).
filenamestringNo
source_formatstringNoNeeded for TGA (no magic bytes); otherwise detected.
source_encodingstringNoFor text migration: WHATWG label of the legacy encoding, e.g. windows-1252, iso-8859-15, ibm866, shift_jis.
line_endingsstringNoLine endings of migrated text.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "content_base64"
  ],
  "properties": {
    "content_base64": {
      "type": "string",
      "minLength": 4,
      "maxLength": 28000000,
      "description": "Source file as base64 (max. about 20 MB)."
    },
    "filename": {
      "type": "string",
      "maxLength": 300
    },
    "source_format": {
      "type": "string",
      "enum": [
        "bmp",
        "pcx",
        "tga",
        "pnm",
        "sgi",
        "sun",
        "xwd"
      ],
      "description": "Needed for TGA (no magic bytes); otherwise detected."
    },
    "source_encoding": {
      "type": "string",
      "maxLength": 40,
      "description": "For text migration: WHATWG label of the legacy encoding, e.g. windows-1252, iso-8859-15, ibm866, shift_jis."
    },
    "line_endings": {
      "type": "string",
      "enum": [
        "keep",
        "lf",
        "crlf"
      ],
      "default": "keep",
      "description": "Line endings of migrated text."
    }
  }
}

Open original schema

Published input example

{
  "content_base64": "Qk1GAAAAAAAAADYAAAAoAAAAAgAAAAIAAAABABgAAAAAABAAAAATCwAAEwsAAAAAAAAAAAAA/wAA////AAAAAP8A/wAAAA==",
  "filename": "logo.bmp"
}

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 โ†’