Chenyuwen/react-native-mask-segment-canvas

a1518 3a3f07628d

Deploy Docs to GitHub Pages / deploy (push) Has been cancelled

Details

Publish to npm / publish (push) Has been cancelled

Details

feat: add manual lasso wall splitting with magnetic edge-snapping and active contour refinement

- New magneticLasso module: Sobel energy map + Dijkstra shortest-path + Douglas-Peucker
- New activeContour module: greedy snake + balloon force for polygon-to-edge refinement
- wallTextureSplit: edge barrier mask, morphological mask hole closing, Moore boundary tracing, simplified polygon contours, manual pick map patching, gap absorption
- MaskSegmentCanvas: full lasso gesture pipeline (tap vertices, drag, magnetic paths, close polygon, endLasso/cancelLasso/deleteLasso)
- New maskConfig options: splitWallsEdgeBarrierThreshold, splitWallsCloseMaskRadius, manualSplitWalls, manualSplitWallsMaxCount, manualSplitWallsGapAbsorbDilatePx, magneticLasso, activeContourRefine
- New ref methods: startLasso, endLasso, cancelLasso, getManualRegions, deleteLasso
- New exported types: LassoPolygon, ManualWallPartition
- RegionMaskData carries indexToName and wallSemanticIdx through downsample
- Simplify README to point to documentation site
- Update documentation site (EN + ZH-CN) with all new APIs and interaction guide
- Example app: lasso mode toggles and operation buttons

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-06 20:23:57 -07:00

2.3 KiB

Raw Blame History

id	title
index	API 参考

📖 API 参考

导入

import MaskSegmentCanvas, {
  type MaskSegmentCanvasRef,
  type MaskSegmentCanvasProps,
  type MaskSegmentSession,
  type MaskSegmentWatchState,
  type MaskSegmentWatchDetail,
  type BgrColor,
  type MaskSemanticColor,
  type PaintCallbackPayload,
  type PaintedRegionRecord,
  type PipelineConfig,
  type MaskSegmentConfig,
  type PaintConfig,
  type InteractionConfig,
  type SavePaintResult,
  type LassoPolygon,
  type ManualWallPartition,
  MASK_SEMANTIC_COLORS,
  BASEBOARD_SEMANTIC_NAME,
  prewarmPngBgrCacheAsync,
  DEFAULT_PIPELINE_CONFIG,
  DEFAULT_MASK_CONFIG,
  DEFAULT_PAINT_CONFIG,
  DEFAULT_INTERACTION_CONFIG,
} from 'react-native-mask-segment-canvas';

分类	名称
组件	`MaskSegmentCanvas`（默认导出）
Ref / Props 类型	`MaskSegmentCanvasRef`, `MaskSegmentCanvasProps`
会话 / 回调类型	`MaskSegmentSession`, `PaintCallbackPayload`, `PaintedRegionRecord`, `SavePaintResult`
套索类型	`LassoPolygon`, `ManualWallPartition`
Watch 类型	`MaskSegmentWatchState`, `MaskSegmentWatchDetail`
配置类型	`PipelineConfig`, `MaskSegmentConfig`, `PaintConfig`, `InteractionConfig`
语义颜色	`MASK_SEMANTIC_COLORS`, `BASEBOARD_SEMANTIC_NAME`
工具函数	`prewarmPngBgrCacheAsync`
运行时默认值	`DEFAULT_*_CONFIG`

Props 概览

分类	描述
图像与初始化	`originUrl`, `maskUrl`, `initialSession`, `initialPaintColor`
语义颜色与轮廓	`semanticColors`, `regionOutlineColor`
maskConfig	分割和语义区域配置
pipelineConfig	分辨率和处理管线配置
paintConfig	上色渲染和纹理混合配置
interactionConfig	触摸交互和命中测试配置
UI 控件与样式	可见性开关、自定义渲染器、样式
回调	`onWatch`, `onPaintCallback`, `onError`
Ref 方法	通过 `ref` 调用的命令式方法
存储约定	会话持久化和 PNG 导出

2.3 KiB Raw Blame History

📖 API 参考

导入

Props 概览

2.3 KiB

Raw Blame History