vision.perspective.dewarp.v1
Overview
Verify that the Forge runtime executes the canonical Perspective Dewarp Primitive Profile using the production Media execution kernel.
After completing this example you should be able to:
- execute the canonical Media profile
- inspect transformation metadata
- verify generated artifacts
- validate deterministic replay
- understand the execution contract
This document verifies Media execution.
It does not evaluate computer vision accuracy or image quality.
Primitive Profile
| Property | Value |
|---|---|
| Primitive | media@1 |
| Profile | vision.perspective.dewarp.v1 |
| Runtime | Compute |
| Replay | Supported |
| Artifacts | Supported |
| Deterministic | Supported |
| CPU | Supported |
| GPU | Optional |
Capability
vision.perspective.dewarp.v1 performs deterministic perspective normalization on a supplied image.
The Media kernel transforms an input asset into a geometrically corrected representation according to the registered Primitive Profile.
Rather than interpreting image content, the primitive applies a reproducible transformation pipeline whose behaviour is fully defined by the execution contract.
The objective is to produce a consistent, replayable media transformation.
Canonical Contract
Execution uses the canonical Forge Media execution contract.
Primitive
media
Version
1
Profile
vision.perspective.dewarp.v1Requests are validated before entering the execution runtime.
The canonical payload contains:
op.name
op.version
op.profile
argsOptional execution metadata may include:
ctx
seed
policyRequired Inputs
The canonical execution contract requires:
- source image
- transformation parameters
- execution configuration
Execution begins only after successful canonical validation.
Optional Inputs
Depending on execution policy, optional inputs may include:
- interpolation method
- output format
- preprocessing configuration
- execution evidence
- replay configuration
Only profile-supported fields should be supplied.
Unsupported fields are rejected during validation.
Canonical Smoke
The maintained Media smoke verifies:
- successful profile resolution
- canonical validation
- deterministic transformation
- runtime evidence generation
- replay metadata generation
- artifact availability
The maintained Smoke Suite remains the canonical executable source.
Verification Expectations
A successful execution should demonstrate:
- canonical validation succeeds
- source asset is accepted
- deterministic transformation completes
- transformed artifact is generated
- runtime evidence is produced
- replay metadata is available
- execution artifacts are preserved
Verification includes inspection of both the transformed asset and the execution metadata that produced it.
Runtime Evidence
Successful execution exposes runtime evidence including:
- execution identifier
- primitive profile
- execution metadata
- transformation summary
- processing duration
- generated artifacts
- replay metadata
The exact evidence surface depends on execution policy.
Replay
Replay should reproduce the same transformation when executed using the identical execution contract, source asset, processing parameters, runtime version, and deterministic seed where applicable.
Replay validates the determinism of the Media kernel rather than infrastructure identity.
Replay verification is described in:
→ /verification/replay-determinism
Artifacts
Typical execution artifacts include:
- transformed image
- transformation summary
- execution report
- replay metadata
Artifacts provide observable evidence explaining how the output asset was produced.
Applied Intelligence Modules
This Primitive Profile is reused across multiple Forge Intelligence Modules requiring deterministic image preprocessing and geometric normalization.
The execution primitive remains identical while the Primitive Profile defines media-specific transformation semantics.
Related Documentation
Verification Checklist
| Verification Surface | Status |
|---|---|
| Primitive resolved | ✓ |
| Contract validated | ✓ |
| Transformation completed | ✓ |
| Runtime inspected | ✓ |
| Artifacts inspected | ✓ |
| Replay verified | ✓ |
| Negative validation tested | ✓ |
Final Principle
vision.perspective.dewarp.v1 verifies a versioned Media Primitive Profile rather than an image-processing algorithm.
Its correctness is demonstrated through deterministic transformation, observable runtime evidence, replay, and artifact inspection, allowing independent evaluators to reproduce the same media processing workflow using the canonical execution contract.
Continue in Forge Studio
This document describes the canonical execution contract for this capability.
The Forge documentation explains how this capability works.
Forge Studio allows you to inspect, execute, and verify the live implementation.
Capability Explorer
Browse the live capability catalog, supported execution surfaces, available Primitive Profiles, and execution metadata.
→ https://studio.forgepool.io/capability-explorer
Block Registry
Inspect the registered Primitive Profile, execution contract, block metadata, adapters, versions, and runtime characteristics.
→ https://studio.forgepool.io/studio/blocks-registry
Execute
Execute this capability using Forge Studio, the Execution API, or an MCP-compatible client.
Verify
Before interpreting the result, inspect:
- runtime evidence
- generated artifacts
- deterministic replay
- execution metadata
Trust should be established through independent verification rather than documentation alone.