{
  "_description": "Generated from data/ — edit the sources, not this file. The agent access guide explains the evidence boundary of every field.",
  "schemaVersion": "1.0.0",
  "kind": "entry",
  "locale": "en",
  "id": "masking",
  "name": {
    "zh": "蒙版",
    "en": "Masking"
  },
  "page": "https://designvocabulary.com/en/entries/masking/",
  "self": "https://designvocabulary.com/en/entries/masking.json",
  "alternates": {
    "zh-CN": "https://designvocabulary.com/zh/entries/masking.json",
    "en": "https://designvocabulary.com/en/entries/masking.json"
  },
  "site": {
    "catalogSchemaVersion": "0.1.0",
    "entries": 137,
    "index": "https://designvocabulary.com/en/entries/index.json",
    "query": "https://designvocabulary.com/api/query?lang=en",
    "guide": "https://designvocabulary.com/en/agents/",
    "llms": "https://designvocabulary.com/llms.txt"
  },
  "provenance": {
    "sourceBacked": [
      "entry.definition"
    ],
    "editorial": [
      "entry.boundary",
      "entry.signature",
      "entry.when",
      "entry.when_not",
      "entry.tradeoff",
      "entry.comparison",
      "entry.rules",
      "entry.relations",
      "entry.implementationNote",
      "entry.behavior"
    ],
    "scope": "Definitions reference these sources. Digital specimens, selection advice, relationships, and recipes are editorial work and have not been validated through user research.",
    "editorialStatus": "drafted",
    "specimenData": "fictional",
    "specimenNote": "Original fictional specimens. Definitions cite sources; usage advice and recipes are editorial.",
    "sources": [
      {
        "id": "masking-w3c-css",
        "url": "https://www.w3.org/TR/css-masking-1/",
        "title": "W3C · CSS Masking Module Level 1",
        "checkedAt": "2026-09-16",
        "archive": {
          "status": "pending",
          "confirmed": false,
          "url": null,
          "capturedAt": null,
          "lookupUrl": "https://web.archive.org/web/20260916*/https://www.w3.org/TR/css-masking-1/"
        }
      },
      {
        "id": "masking-wikipedia-layers",
        "url": "https://en.wikipedia.org/wiki/Layers_(digital_image_editing)",
        "title": "Wikipedia · Layers (digital image editing)",
        "checkedAt": "2026-09-16",
        "archive": {
          "status": "available",
          "confirmed": true,
          "url": "https://web.archive.org/web/20260922115601/https://en.wikipedia.org/wiki/Layers_(digital_image_editing)",
          "capturedAt": "2026-09-22T11:56:01Z",
          "lookupUrl": "https://web.archive.org/web/20260916*/https://en.wikipedia.org/wiki/Layers_(digital_image_editing)"
        }
      }
    ],
    "lists": [],
    "ordered": false,
    "listDisclaimer": "Seat numbers are editorial positions, not scores, rankings, or popularity measurements. A list that is not filled is left as it is."
  },
  "entry": {
    "id": "masking",
    "type": "interaction",
    "name": {
      "zh": "蒙版",
      "en": "Masking"
    },
    "aliases": [
      "Mask",
      "Layer Mask",
      "遮罩",
      "图层蒙版"
    ],
    "granularity": "component",
    "intents": [
      "manipulate-object",
      "organize-content"
    ],
    "tags": [
      "layer",
      "mask",
      "non-destructive",
      "transparency",
      "clipping"
    ],
    "definition": "Controlling how much of a layer is visible by means of another shape, gradient, or greyscale image: the covered part stops showing while the original pixels stay intact and can be brought back at any time.",
    "boundary": "The test for a mask is hiding without deleting. Cropping or erasing pixels is not masking, because the original data is gone; simply lowering a layer’s opacity is not masking either, because that changes everything uniformly while a mask decides visibility point by point. This entry covers the operation and its interface in editing and authoring tools, not any particular application’s menu layout, and not other senses of the word — perceptual masking in psychology, or a privacy redaction workflow.",
    "signature": [
      "The hidden content still exists and can be restored at any time",
      "How much is hidden varies by position, with hard edges or gradients",
      "The mask and the layer it hides are independent and can be adjusted separately"
    ],
    "when": [
      "Composition or crop needs repeated experimentation without losing the original material",
      "Two layers need a soft transition rather than a hard-edged join",
      "One asset must reveal different parts across several sizes or layouts"
    ],
    "when_not": [
      "A mask covers sensitive information but the exported file still contains the recoverable original",
      "The final output format does not support masks and the hiding fails only at delivery",
      "Masks are nested until no one can tell which layer decides the result"
    ],
    "tradeoff": "Leaving the original data intact keeps every change reversible, at the cost of a more complex file: the final image is computed from stacked layers, and the later someone joins, the harder it is to tell which layer produced an effect.",
    "comparison": {
      "focus": "Controlling what is visible without deleting the original data",
      "mechanism": "Another shape or greyscale image decides the hiding point by point",
      "cost": "The file gets more complex and the result comes from stacked layers"
    },
    "sources": [
      {
        "id": "masking-w3c-css",
        "title": "W3C · CSS Masking Module Level 1",
        "url": "https://www.w3.org/TR/css-masking-1/",
        "claim": "The specification explains that CSS Masking provides two means of partially or fully hiding visual elements — masking and clipping — where masking uses another graphical element or image as a luminance or alpha mask that influences the transparency of the element’s buffer before compositing, while clipping defines the visible region and anything outside it is not rendered. This entry takes the distinction between point-by-point visibility and outright cropping from it.",
        "checkedAt": "2026-09-16",
        "archive": {
          "lookupUrl": "https://web.archive.org/web/20260916*/https://www.w3.org/TR/css-masking-1/",
          "status": "pending",
          "checkedAt": "2026-09-16T17:36:16.101Z",
          "error": "status-request-failed",
          "jobId": "spn2-f53ed63ea0324291134f1a14dc7f6316583c0796"
        }
      },
      {
        "id": "masking-wikipedia-layers",
        "title": "Wikipedia · Layers (digital image editing)",
        "url": "https://en.wikipedia.org/wiki/Layers_(digital_image_editing)",
        "claim": "The article explains that a digital image is often made of multiple layers each carrying a different function, and that a layer can be compared to a transparency placed over or under an image. This entry takes the layer model that masking depends on from it; the trade-off between reversibility and file complexity is editorial.",
        "checkedAt": "2026-09-16",
        "archive": {
          "lookupUrl": "https://web.archive.org/web/20260916*/https://en.wikipedia.org/wiki/Layers_(digital_image_editing)",
          "status": "available",
          "checkedAt": "2026-09-22T11:55:37.204Z",
          "jobId": "spn2-9b8cc489c642536ae0134378626f20da8f037592",
          "url": "https://web.archive.org/web/20260922115601/https://en.wikipedia.org/wiki/Layers_(digital_image_editing)",
          "timestamp": "20260922115601"
        }
      }
    ],
    "relations": [
      {
        "target": "undo-redo",
        "kind": "related",
        "condition": "The user needs to get back to a state before some hiding was applied",
        "reason": "Undo steps back along a timeline while a mask keeps the result editable in space; both provide reversibility, one by step and one by layer.",
        "basis": "editorial"
      },
      {
        "target": "direct-manipulation",
        "kind": "composes_with",
        "condition": "The user drags the mask’s edge or handles directly to adjust what is hidden",
        "reason": "Editing a mask usually means manipulating the shape on the canvas itself and seeing the result as it happens.",
        "basis": "editorial"
      },
      {
        "target": "source-inspection",
        "kind": "composes_with",
        "condition": "The final image comes from several stacked masks and it has to be traced to one layer",
        "reason": "Non-destructive editing separates the result from its source, so the composition of each layer has to be inspectable rather than only the final image.",
        "basis": "editorial"
      }
    ],
    "rules": [
      {
        "when": "A mask covers personal data, keys, or other sensitive content",
        "instruction": "Flatten the mask or delete the underlying pixels before exporting; never deliver a file from which the original can be recovered.",
        "strength": "must",
        "basis": "editorial"
      },
      {
        "when": "Masks are used in a file that will be handed to someone else",
        "instruction": "Name the mask and its layer to say what it hides, so whoever inherits the file does not have to toggle layers to understand it.",
        "strength": "recommend",
        "basis": "editorial"
      }
    ],
    "behavior": {
      "states": [
        "unmasked",
        "masked",
        "editing"
      ],
      "a11y": [
        "Mask editing controls are keyboard-operable and their handles have accessible names",
        "The enabled state of a layer and its mask is announced rather than shown by icon alone"
      ],
      "motion": "The result updates immediately, with no transition animation needed"
    },
    "demo": null,
    "version": "0.1.0",
    "editorialStatus": "drafted",
    "requirements": [],
    "demoCapabilities": [],
    "implementationNote": "This entry has no runnable specimen; the illustration is an editorial sketch of how a mask relates to its layer, not a verified implementation. When used to cover sensitive information, confirm before export that the underlying pixels are really gone.",
    "image": {
      "src": "/images/masking.webp",
      "alt": "A fictional FIELDNOTES editor sketch: a layers panel on the left listing one layer beside its black-and-white mask thumbnail, and on the right a canvas where part of the same shape is hidden by a soft gradient, the hidden outline drawn as a dashed line to show it still exists."
    },
    "searchTerms": [
      "图层",
      "遮罩",
      "非破坏性编辑",
      "透明度",
      "裁切"
    ]
  }
}
