Mask
Runnable Turf.js example: Mask. Open the live demo, read the complete source, and copy the file into your project. No build step or API key.
single HTML file · CDN dependencies onlyinterface may contain Chinese labels
Source
<!--
示例:掩膜裁剪
核心逻辑:mask 生成带洞大面,洞内是研究区,洞外用半透明压暗
依赖:Turf.js 7 · jsDelivr CDN
-->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta name="robots" content="noindex,follow">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>掩膜裁剪</title>
<style>
html,body{height:100%;margin:0}
body{display:flex;flex-direction:column;overflow:hidden;
font:13px/1.6 -apple-system,"Segoe UI","PingFang SC",sans-serif;color:#16181d;background:#fff}
.bar{flex:0 0 auto;display:flex;gap:12px;align-items:center;padding:8px 12px;
background:#f6f7f9;border-bottom:1px solid #e3e6ea;font-size:12px;color:#58606e;flex-wrap:wrap}
.bar button{font:inherit;font-size:12px;padding:4px 10px;border-radius:4px;cursor:pointer;
border:1px solid #ccd1d9;background:#fff;color:#16181d}
.bar button:hover{background:#eef0f3}
.bar input[type=range]{width:150px}
.bar b{color:#1f5fd0;font-weight:600}
.hint{color:#8a929f}
svg{flex:1 1 auto;min-height:0;width:100%;display:block;background:#fbfcfd}
.out{flex:0 0 auto;display:flex;gap:20px;flex-wrap:wrap;padding:8px 12px;
border-top:1px solid #e3e6ea;
font-family:ui-monospace,Consolas,monospace;font-size:11.5px;color:#3a4250}
.out b{font-weight:600;color:#1f5fd0}
</style>
</head>
<body>
<div class="bar"><span>研究区外压暗</span><span class="hint">掩膜面按奇偶规则填充</span></div>
<svg id="stage" viewBox="0 0 640 320" preserveAspectRatio="xMidYMid meet"></svg>
<div class="out">
<span>研究区面积 <b id="area">—</b></span>
<span>掩膜环数 <b id="rings">—</b></span>
<span>洞的面积 <b id="hole">—</b></span>
</div>
<script src="https://cdn.jsdelivr.net/npm/@turf/turf@7/turf.min.js"></script>
<script>
(function () {
'use strict';
if (typeof turf === 'undefined') {
document.body.innerHTML =
'<div style="padding:24px;color:#b42318">Turf.js 加载失败,请检查能否访问 cdn.jsdelivr.net</div>';
return;
}
function makeProjection(BOX, W, H, PAD) {
var kx = Math.cos(((BOX[1] + BOX[3]) / 2) * Math.PI / 180);
var x0 = BOX[0] * kx, x1 = BOX[2] * kx;
var y0 = BOX[1], y1 = BOX[3];
var s = Math.min((W - PAD * 2) / (x1 - x0), (H - PAD * 2) / (y1 - y0));
var ox = (W - (x1 - x0) * s) / 2;
var oy = (H - (y1 - y0) * s) / 2;
var to = function (c) {
return [(c[0] * kx - x0) * s + ox, (y1 - c[1]) * s + oy];
};
to.inverse = function (px, py) {
return [((px - ox) / s + x0) / kx, y1 - (py - oy) / s];
};
return to;
}
function linePath(pr, coords) {
var d = '';
for (var i = 0; i < coords.length; i++) {
var p = pr(coords[i]);
d += (i ? 'L' : 'M') + p[0].toFixed(1) + ' ' + p[1].toFixed(1);
}
return d;
}
function ringPath(pr, ring) { return linePath(pr, ring) + 'Z'; }
function polyPath(pr, rings) {
var d = '';
for (var i = 0; i < rings.length; i++) d += ringPath(pr, rings[i]);
return d;
}
var BOX = [116.28, 39.82, 116.52, 39.96];
var pr = makeProjection(BOX, 640, 320, 22);
var stage = document.getElementById('stage');
var study = turf.polygon([[[
116.33, 39.86], [116.40, 39.855], [116.46, 39.88],
[116.47, 39.93], [116.39, 39.945], [116.32, 39.91], [116.33, 39.86]
]]);
var veilBox = turf.bboxPolygon([116.20, 39.72, 116.60, 40.04]);
var veil = turf.mask(study, veilBox);
var parts = ['<rect x="0" y="0" width="640" height="320" fill="none" stroke="#e3e6ea"/>'];
var outerRing = veil.geometry.coordinates[0];
var holes = veil.geometry.coordinates.slice(1);
parts.push('<path d="' + ringPath(pr, outerRing) + '" fill="#16181d" fill-opacity="0.55"/>');
holes.forEach(function (h) {
parts.push('<path d="' + ringPath(pr, h) + '" fill="#fbfcfd"/>');
});
parts.push('<path d="' + polyPath(pr, study.geometry.coordinates) +
'" fill="rgba(31,95,208,0.10)" fill-rule="evenodd" stroke="#1f5fd0" stroke-width="2.2"/>');
stage.innerHTML = parts.join('');
document.getElementById('area').textContent = (turf.area(study) / 1e6).toFixed(2) + ' km²';
document.getElementById('rings').textContent = veil.geometry.coordinates.length;
document.getElementById('hole').textContent = (turf.area(study) / 1e6).toFixed(2) + ' km²';
})();
</script>
</body>
</html>
Language: the code and this page are in English; the full tutorial and API notes for this example are in Chinese. The demo itself is the authoritative version — it runs exactly as shown.