{"reference_analysis":{"provider":"OpenCV","checked_at":"2026-10-08","source_access":{"en":"Official project and developer sources reviewed; no provider API was called. Expected outputs below are our illustrative contracts, not measured results.","zh-TW":"已核對官方專案與開發來源；沒有呼叫供應商 API。下方預期輸出是本站示意契約，不是實測結果。"},"selection_basis":{"en":"Ten documented technical entry points, selected by task; not ten independent SDKs or an official ranking.","zh-TW":"依任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。"},"about_url":"https://opencv.org/about/","about":[{"label":{"en":"Organization","zh-TW":"組織"},"value":{"en":"OpenCV is an open-source vision library operated by the nonprofit Open Source Vision Foundation.","zh-TW":"OpenCV 是由非營利 Open Source Vision Foundation 營運的開源視覺函式庫。"}},{"label":{"en":"Purpose","zh-TW":"宗旨"},"value":{"en":"Provides shared infrastructure for computer vision and machine perception applications.","zh-TW":"提供電腦視覺與機器感知應用的共用基礎。"}},{"label":{"en":"Product scope","zh-TW":"產品範圍"},"value":{"en":"Combines classical image processing, geometry and machine-learning utilities across platforms.","zh-TW":"跨平台整合傳統影像處理、幾何與機器學習工具。"}},{"label":{"en":"Support and participation","zh-TW":"支援與參與"},"value":{"en":"Official documentation, forums and issue reports support development; community contributions and sponsorship support the project.","zh-TW":"官方文件、論壇與問題回報協助開發；社群貢獻與贊助支持專案。"}}],"items":[{"id":"codecs","name":"Image codecs","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d4/da8/group__imgcodecs.html","audience":{"en":"Image ingestion developers","zh-TW":"影像匯入工程師"},"capability":{"en":"Decode and encode image files.","zh-TW":"影像檔解碼與編碼。"},"io":{"en":"File bytes → image matrix; matrix → encoded bytes.","zh-TW":"檔案位元組 → 影像矩陣；矩陣 → 編碼資料。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Codec support depends on the installed build; define channel order.","zh-TW":"編碼支援取決於安裝版本；須定義通道順序。"},"validation":{"en":"Reject undecodable files before processing.","zh-TW":"無法解碼時應在處理前拒絕。"}},{"id":"capture","name":"VideoCapture","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d8/dfe/classcv_1_1VideoCapture.html","audience":{"en":"Camera integration engineers","zh-TW":"攝影機整合工程師"},"capability":{"en":"Read frames from video files or capture devices.","zh-TW":"從影片或擷取裝置讀取影格。"},"io":{"en":"Device/file → frames and read state.","zh-TW":"裝置／檔案 → 影格與讀取狀態。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Backend and device settings vary; frame reads can fail.","zh-TW":"後端與裝置設定有差異；影格讀取可能失敗。"},"validation":{"en":"Test disconnection and end-of-file separately.","zh-TW":"分別測試斷線與影片結束。"}},{"id":"processing","name":"Image processing","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d7/dbd/group__imgproc.html","audience":{"en":"Inspection pipeline developers","zh-TW":"檢測流程工程師"},"capability":{"en":"Color conversion, filtering and geometric image operations.","zh-TW":"色彩轉換、濾波與幾何影像運算。"},"io":{"en":"Image and parameters → transformed image.","zh-TW":"影像與參數 → 處理後影像。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Resize and crop change coordinate interpretation.","zh-TW":"縮放與裁切會改變座標解釋。"},"validation":{"en":"Preserve the transform mapping back to the original image.","zh-TW":"保留回推至原圖的轉換關係。"}},{"id":"arrays","name":"Array operations","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d2/de8/group__core__array.html","audience":{"en":"Numerical processing developers","zh-TW":"數值處理工程師"},"capability":{"en":"Matrix arithmetic and array manipulation.","zh-TW":"矩陣運算與陣列操作。"},"io":{"en":"Typed arrays → computed arrays or statistics.","zh-TW":"指定型別陣列 → 計算陣列或統計量。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Shape, data type and saturation affect results.","zh-TW":"形狀、型別與飽和運算影響結果。"},"validation":{"en":"Use a small known matrix to verify types and range.","zh-TW":"以已知小矩陣驗證型別與範圍。"}},{"id":"gradients","name":"Image gradients","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d5/d0f/tutorial_py_gradients.html","audience":{"en":"Edge and surface inspection teams","zh-TW":"邊緣與表面檢測團隊"},"capability":{"en":"Compute Sobel, Scharr and Laplacian derivatives.","zh-TW":"計算 Sobel、Scharr 與 Laplacian 微分。"},"io":{"en":"Grayscale image → gradient response.","zh-TW":"灰階影像 → 梯度回應。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Unsigned conversion may discard negative derivatives.","zh-TW":"無號型別轉換可能遺失負微分值。"},"validation":{"en":"Check signed output before display conversion.","zh-TW":"顯示轉換前核對有號輸出。"}},{"id":"contours","name":"Contours","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d4/d73/tutorial_py_contours_begin.html","audience":{"en":"Shape measurement developers","zh-TW":"形狀量測工程師"},"capability":{"en":"Extract contours from a prepared binary image.","zh-TW":"從預處理二值圖擷取輪廓。"},"io":{"en":"Binary image → contour points and hierarchy.","zh-TW":"二值圖 → 輪廓點與階層。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Contours are geometry, not semantic product classes.","zh-TW":"輪廓是幾何資訊，不是產品語意分類。"},"validation":{"en":"Test isolated shapes, holes and an empty mask.","zh-TW":"測試獨立形狀、孔洞與空遮罩。"}},{"id":"features","name":"Features and descriptors","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/db/d27/tutorial_py_table_of_contents_feature2d.html","audience":{"en":"Image alignment developers","zh-TW":"影像對位工程師"},"capability":{"en":"Detect local features and compare descriptors.","zh-TW":"偵測局部特徵並比較描述子。"},"io":{"en":"Images → keypoints, descriptors and matches.","zh-TW":"影像 → 關鍵點、描述子與配對。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Texture-poor or repetitive parts may give weak matches.","zh-TW":"低紋理或重複紋理零件可能難以配對。"},"validation":{"en":"Reject inadequate correspondence before geometry fitting.","zh-TW":"幾何擬合前拒絕不足的對應點。"}},{"id":"calibration","name":"Calibration and reconstruction","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d9/d0c/group__calib3d.html","audience":{"en":"Metrology and robotics engineers","zh-TW":"量測與機器人工程師"},"capability":{"en":"Camera calibration and geometric reconstruction functions.","zh-TW":"攝影機校正與幾何重建函式。"},"io":{"en":"Correspondences → camera/geometric parameters.","zh-TW":"對應點 → 攝影機／幾何參數。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Physical units depend on the reference geometry supplied.","zh-TW":"物理單位取決於提供的參考幾何。"},"validation":{"en":"Validate with held-out views and known dimensions.","zh-TW":"使用未參與校正的視角與已知尺寸驗證。"}},{"id":"dnn","name":"DNN module","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/d6/d0f/group__dnn.html","audience":{"en":"Model deployment developers","zh-TW":"模型部署工程師"},"capability":{"en":"Load supported neural networks and run inference.","zh-TW":"載入支援的神經網路並推論。"},"io":{"en":"Model and prepared tensors → output tensors.","zh-TW":"模型與預處理張量 → 輸出張量。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Operators, preprocessing and backends must match the model.","zh-TW":"運算子、預處理與後端須符合模型。"},"validation":{"en":"Compare outputs against the original model with tolerances.","zh-TW":"依容許誤差與原始模型比對輸出。"}},{"id":"tracking","name":"Motion and tracking","kind":"API / SDK / developer guide","url":"https://docs.opencv.org/4.x/dc/d6b/group__video__track.html","audience":{"en":"Video analytics engineers","zh-TW":"影片分析工程師"},"capability":{"en":"Estimate motion including optical flow.","zh-TW":"估計包含光流的移動資訊。"},"io":{"en":"Adjacent frames → displacement and tracking state.","zh-TW":"相鄰影格 → 位移與追蹤狀態。"},"runtime":{"en":"Local application / pinned library and model","zh-TW":"本地應用／固定函式庫與模型"},"constraint":{"en":"Motion vectors do not establish identity or intent.","zh-TW":"移動向量不代表身分或意圖。"},"validation":{"en":"Test occlusion, blur and lost features.","zh-TW":"測試遮擋、模糊與特徵遺失。"}}],"supporting_references":[{"id":"documentation","name":"Official documentation overview","url":"https://docs.opencv.org/","audience":{"en":"Developers and product owners selecting the supported technical path.","zh-TW":"選擇支援技術路徑的工程師與產品負責人。"},"validation":{"en":"Choose the operation, supported version and runtime before assigning implementation.","zh-TW":"安排實作前先選定操作、支援版本與執行環境。"}},{"id":"primary-docs","name":"Primary developer documentation","url":"https://docs.opencv.org/4.x/","audience":{"en":"Engineers choosing the supported API and installed version.","zh-TW":"選擇支援 API 與安裝版本的工程師。"},"validation":{"en":"Match the operation and version to the specific references above before implementation. The illustrative output is an internal application contract.","zh-TW":"實作前將操作與版本對應至上述具體文件；示意輸出是內部應用契約。"}}]},"content_coverage":{"reference_guide":true,"developer_starter":false,"expected_results":true,"integration_test":"not-run","updated_at":"2026-10-08"},"developer_starter":{"version":"1.0.0","verification":"illustrative-contract-only;live-provider-not-run","filename":"OpenCV-expected-results.json","format":"json-example","scope":{"en":"Illustrative local contour-processing contract, not a cloud API response or a calibrated physical measurement.","zh-TW":"本地輪廓處理的示意契約，不是雲端 API 回應或校正後的物理量測。"},"setup":{"en":"Review the scenarios below and map the actual SDK response into this internal contract. No credential, API call or live output is included. Replace example data only after your own integration test.","zh-TW":"先審閱下方情境，再將實際 SDK 回應對應至此內部契約。此處不含憑證、API 呼叫或真實輸出，示意資料須在自行串接測試後替換。"},"code":"{\n  \"schema_version\": \"1.0.0\",\n  \"example\": true,\n  \"provider\": \"OpenCV\",\n  \"status\": \"ok\",\n  \"input_id\": \"sample-001\",\n  \"data\": {\n    \"contours\": [\n      {\n        \"id\": 0,\n        \"area_px2\": 2400,\n        \"bounds_xywh_px\": [\n          20,\n          30,\n          60,\n          40\n        ]\n      }\n    ],\n    \"measurement_units\": \"pixels\",\n    \"opencv_version\": \"record-at-runtime\"\n  },\n  \"error\": null,\n  \"verification\": \"illustrative-only;not-provider-response\"\n}","expected_results":[{"scenario":{"en":"Valid contour extraction","zh-TW":"有效輪廓擷取"},"input":{"en":"A binary test mask with one isolated part.","zh-TW":"含一個獨立零件的二值測試遮罩。"},"output":{"en":"ok; contour count and pixel-coordinate geometry.","zh-TW":"ok；輪廓數量與像素座標幾何。"},"acceptance":{"en":"Points stay within image bounds; compare area to a known mask.","zh-TW":"點位於影像界內；面積與已知遮罩比對。"}},{"scenario":{"en":"No foreground","zh-TW":"沒有前景"},"input":{"en":"An all-background mask.","zh-TW":"全背景遮罩。"},"output":{"en":"ok with contours: []; no fabricated measurement.","zh-TW":"ok 且 contours: []；不捏造量測值。"},"acceptance":{"en":"Empty is a valid processing result, not a decoder failure.","zh-TW":"空結果是有效處理結果，不等於解碼失敗。"}},{"scenario":{"en":"Invalid image","zh-TW":"無效影像"},"input":{"en":"Unreadable or corrupt bytes.","zh-TW":"不可讀或損壞的位元組。"},"output":{"en":"error with decode-failed; no contours.","zh-TW":"error 與 decode-failed；無輪廓。"},"acceptance":{"en":"Stop before image operations and retain input ID.","zh-TW":"影像運算前停止並保留輸入識別。"}},{"scenario":{"en":"Camera unavailable","zh-TW":"攝影機不可用"},"input":{"en":"Disconnected capture device.","zh-TW":"擷取裝置斷線。"},"output":{"en":"error or explicit retry state; no stale frame as new output.","zh-TW":"error 或明確重試狀態；不得把舊影格當新輸出。"},"acceptance":{"en":"Expose the failure and bound any retry policy.","zh-TW":"揭露失敗並限制重試次數。"}}],"decisions":[[{"en":"Result states","zh-TW":"結果狀態"},{"en":"ok means the selected operation returned a valid result; a valid empty result differs from error. Pending work remains pending until a terminal result. Do not infer real-world correctness from API success.","zh-TW":"ok 表示所選操作回傳有效結構；有效空結果與 error 不同。未完成工作保持 pending 直到終態。API 成功不代表現實判斷必然正確。"}],[{"en":"Reproducibility","zh-TW":"可重現性"},{"en":"Record input ID, library/model version, configuration, runtime and coordinate/score conventions. Examples contain invented sample values.","zh-TW":"記錄輸入識別、函式庫／模型版本、設定、執行環境及座標／分數慣例。範例數值為示意。"}],[{"en":"Acceptance — proposed","zh-TW":"建議驗收"},{"en":"Use representative authorized samples plus empty, malformed and unavailable-runtime cases. Agree quality and latency targets before running tests. No measured accuracy, cost or speed is claimed.","zh-TW":"使用授權代表樣本，加上空結果、格式錯誤與環境不可用案例。測試前先約定品質與延遲目標；不宣稱已量測準確率、成本或速度。"}],[{"en":"Operation boundary","zh-TW":"操作範圍"},{"en":"Illustrative local contour-processing contract, not a cloud API response or a calibrated physical measurement.","zh-TW":"本地輪廓處理的示意契約，不是雲端 API 回應或校正後的物理量測。"}]]},"schema_version":"1.0.0","type":"development-proposal","product_id":"industrial-api:OpenCV","name":"OpenCV","provider":"OpenCV","url":"https://smart-tools.ai/product/OpenCV","localized_urls":{"en":"https://smart-tools.ai/product/OpenCV","zh-TW":"https://smart-tools.ai/zh-tw/product/OpenCV"},"category":"vision","capability_id":"cap:computer-vision","technology_hub":"https://smart-tools.ai/industrial-ai/computer-vision","interface_kind":"SDK","deployment":"local","official_documentation":"https://docs.opencv.org/4.x/","sources":["https://docs.opencv.org/4.x/","https://opencv.org/about/","https://docs.opencv.org/4.x/d4/da8/group__imgcodecs.html","https://docs.opencv.org/4.x/d8/dfe/classcv_1_1VideoCapture.html","https://docs.opencv.org/4.x/d7/dbd/group__imgproc.html","https://docs.opencv.org/4.x/d2/de8/group__core__array.html","https://docs.opencv.org/4.x/d5/d0f/tutorial_py_gradients.html","https://docs.opencv.org/4.x/d4/d73/tutorial_py_contours_begin.html","https://docs.opencv.org/4.x/db/d27/tutorial_py_table_of_contents_feature2d.html","https://docs.opencv.org/4.x/d9/d0c/group__calib3d.html","https://docs.opencv.org/4.x/d6/d0f/group__dnn.html","https://docs.opencv.org/4.x/dc/d6b/group__video__track.html","https://docs.opencv.org/"],"source_review":{"level":"P1","status":"official-source-reviewed","checked_at":"2026-10-08"},"provider_summary":{"en":"Process images and video through a computer-vision library.","zh-TW":"透過電腦視覺函式庫處理圖片與影片。"},"proposed_product":{"en":"Inspection image preprocessing","zh-TW":"巡檢影像前處理工具"},"feasibility":{"tier":"prototype","rationale":{"en":"Test one documented operation with a small real sample after access is confirmed. This is a development judgment, not a delivery estimate.","zh-TW":"確認存取後，用少量真實樣本測試一個有文件的操作。此為開發判斷，不是交期估算。"},"basis":"development-judgment;not-traffic-ranked"},"proposed_inputs":{"en":"A small authorized image dataset, task definition and reference annotations.","zh-TW":"少量經授權影像、任務定義與參考標註。"},"proposed_deliverable":{"en":"A reviewable result with image references, labels or annotation state; keep original files.","zh-TW":"可審核的影像引用、標籤或標註狀態；保留原始檔案。"},"acceptance_criterion":{"en":"Compare the supported operation against a labeled sample; report errors and missing results separately.","zh-TW":"用已標註樣本比對支援的操作；錯誤與缺漏結果分開呈現。"},"dependencies":{"en":"Dataset access, image rights and a supported model or annotation project.","zh-TW":"資料集存取、影像使用權與支援的模型或標註專案。"},"integration_condition":null,"proposed_adapter_envelope":{"provider":"OpenCV","operation":"chosen-documented-operation","source_url":"https://docs.opencv.org/4.x/","captured_at":"ISO-8601 timestamp","status":"ok|pending|unknown|failed","data":"provider response mapped by the team","evidence":"source references","errors":"explicit error details"},"adapter_envelope_status":"proposed-internal-contract;not-a-provider-response","development_status":"concept-specification","integration_test":"not-run","pricing_status":"provider-terms-review-required","estimate_status":"requires-access-and-sample-validation","traffic_status":"not-measured-in-this-assessment","measurement_events":["product_view","product_to_docs","product_to_spec","bridge_to_industrial_ai"]}