diff --git a/crates/engine/src/cmd/layerpanel.rs b/crates/engine/src/cmd/layerpanel.rs index 9446902516..b88f6ce636 100644 --- a/crates/engine/src/cmd/layerpanel.rs +++ b/crates/engine/src/cmd/layerpanel.rs @@ -132,7 +132,7 @@ pub fn specs() -> Vec { "Locate Object", ["Window", "Layers"], None, - "{id?, layersOnly?} (default: the frontmost selected object in the stacking order) highlight the object's row; the Layers panel opens the layers around it and scrolls to it, also when the row was already highlighted, unless Show Layers Only, a search or the filter leaves the row out of the list → {id, ancestry: [layer…, id]}. layersOnly (default false; the panel sends true while Show Layers Only is on, as Locate Layer) highlights the innermost layer or sublayer holding the object instead, or a layer id itself → {id: layer, objectId, ancestry: [layer…]}", + "{id?, layersOnly?} (default: the frontmost selected object in the stacking order) highlight the object's row; the Layers panel opens the layers around it, and scrolls to its row when the row is in the list, also when the row was already highlighted (Show Layers Only, a search, the filter, or editing an opacity mask on another layer can leave the row out) → {id, ancestry: [layer…, id]}. layersOnly (default false; the panel sends true while Show Layers Only is on, as Locate Layer) highlights the innermost layer or sublayer holding the object instead, or a layer id itself → {id: layer, objectId, ancestry: [layer…]}", has_doc, locate ), diff --git a/docs/mcp.md b/docs/mcp.md index 72d5c003d0..c219adf30b 100644 --- a/docs/mcp.md +++ b/docs/mcp.md @@ -5877,8 +5877,9 @@ and `layerRows`, the rows highlighted in the panel. `layer.locate {id?, layersOnly?}` (highlights the selected object's row, or with several selected the row of the one frontmost in the stacking order, whatever order they were selected in; an `id` locates that object instead; the panel opens the rows around it; - it scrolls to it on every call, also when the row was already highlighted, unless Show Layers Only, a search or the - filter leaves the row out of the list, in which case it does not scroll; + it scrolls to the row on every call when the row is in the list, also when the row was already highlighted; + Show Layers Only, a search, the filter, or editing an opacity mask on another layer can leave the row out, and then + the panel still opens the rows around it but does not scroll; `layersOnly: true`, which the panel sends while Show Layers Only is on, as Locate Layer, highlights the innermost layer or sublayer holding the object instead, or a layer `id` itself, and returns `{id, objectId, ancestry}`) and `layer.clippingMask.toggle`.