{"uid":"cap_v4XPGsspx57t-XRFL9z2q","slug":"four-control-point-projective-plane-homography-bf050f87","name":"Four-Control-Point Projective Plane Homography","description":"Register a planar drawing/image using four point correspondences.","url":"https://detect.halowerk.com/v1/F-TD2000-GEO-INDUSTRY-B002/four-control-point-projective-plane-homography?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"artifact":{"type":"object","required":["homography"],"properties":{"homography":{"type":"object","required":["data","claim"],"properties":{"data":{"type":"object","required":["source","target","queries"],"properties":{"source":{"type":"array","items":{"type":"array","items":{"type":"number","maximum":1000000,"minimum":-1000000},"maxItems":2,"minItems":2},"maxItems":4,"minItems":4},"target":{"type":"array","items":{"type":"array","items":{"type":"number","maximum":1000000,"minimum":-1000000},"maxItems":2,"minItems":2},"maxItems":4,"minItems":4},"queries":{"type":"array","items":{"type":"array","items":{"type":"number","maximum":1000000,"minimum":-1000000},"maxItems":2,"minItems":2},"maxItems":64,"minItems":1}},"additionalProperties":false},"claim":{}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dEsdBA5ciVjsG3ex_4Uk0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a planar projective homography from four 2D point correspondences and applies it to transform query points.","exampleAgentPrompt":"I have four source points [(0,0),(100,0),(100,100),(0,100)] and their corresponding target points [(10,15),(120,5),(115,110),(5,105)] on a planar drawing — compute the projective homography and tell me where the query points [(50,50),(25,75)] end up.","exampleUseCases":[{"title":"Aerial image ground plane registration","prompt":"I have four GPS-surveyed ground control points in pixel coords [(12,34),(890,22),(910,780),(8,790)] mapped to real-world coords [(0,0),(100,0),(100,60),(0,60)], and I need to project the query pixels [(450,400),(200,300)] into real-world coordinates using a projective homography."},{"title":"Document scan perspective correction","prompt":"I scanned a document and the four corners in the scan are at [(30,20),(610,10),(620,850),(25,845)] — I want them mapped to a clean rectangle [(0,0),(595,0),(595,842),(0,842)]. Can you compute the homography and transform these content marker points [(100,100),(300,400),(500,200)]?"},{"title":"AR planar marker pose estimation","prompt":"My AR marker detector found four fiducial corners in camera image space at [(120,80),(320,70),(330,260),(110,275)] corresponding to the known marker template corners [(0,0),(200,0),(200,200),(0,200)]. Use the four-point homography to find where query texture coordinates [(100,100),(50,150)] project in the camera image."}],"resultDescription":"Returns a homography artifact containing the computed 3×3 projective transformation matrix derived from the four source-to-target point correspondences, along with the transformed coordinates of all supplied query points mapped through the homography into the target plane.","failureModes":["Collinear or nearly-collinear control points causing a degenerate homography (singular matrix)","Query points outside the numeric range (-1000000 to 1000000) rejected by schema validation","Fewer or more than exactly 4 source/target point pairs causing request rejection","Mismatched source and target arrays (different lengths) causing computation failure","Payment failure via x402 protocol returning 402 status before computation","Malformed 2D point arrays (wrong number of coordinates per point) failing schema validation"],"whenToPreferThis":"Use this endpoint when you need a fast, exact projective (perspective) transformation from exactly four 2D point correspondences — the minimal set required for a full planar homography. Prefer this over affine or similarity transforms when you need to handle full perspective distortion. Ideal for image registration, document rectification, planar AR marker tracking, or any task where you know four corresponding point pairs and need to map additional query points through the same transformation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:39:37.932Z","isFirstParty":false,"canonicalSlug":"four-control-point-projective-plane-homography-bf050f87"}