GSoC 2025: Marquee Selection Masking

[mTvare6]

About:

I'm Austin, a statistics student in IITK and I will be working on my project titled marquee selection masking to implement various features related to masking and clipping into Graphite.

Synopsis

The goal of this project is to supplant the Mask node with a mask input to every graphical node, which takes in a general graphic input. This lays the foundation to build further nodes and operations such as one sided stroke alignment, gradient across strokes. Further a new “mask mode” will be introduced, which works at tooling level to enable a way to implement marquee selection masking, which unlike traditional mask tools(clipping) also supports gradient based operations(masking) and supporting much more than simple lasso, freeform or rectangle type selection present in other tools. Further, a system to show the types of nodes merged through the merge node will be implemented, along with their mask information.

Deliverables

• Add a mask input to most graphical node which uses the mask in some form and remove the old mask node, which is then equivalent to merge with mask.
• Implement the infrastructure to render the output of the mask node with SVGs and vello.
• Add the MaskMode to the DocumentMode, with the live masking ants shader running then, which as expected for a DocumentMode affects tooling behaviour.
• Add the system required to propagate nodes merged through the Merge node in the layer panel, along with masks of nodes if present.
• Flood fill node which takes in a point, tolerance and color.

[mTvare6]

Week 1

This week I've mostly been writing the infrastructure neccessary for clipping, as it would be simpler and act precursorial to masking. This involved using a SVG mask tag if any alpha change is involved and otherwise uses clipPath to simplify operations involved.

• Implement clipping masks #2644

no clip	clipped	fill set to 0

The same works for groups, raster target and vector data.

fill set to 100	fill set to 0

[mTvare6]

Week 2

I started off this week by fixing new bugs and my old PR which didn't work over time.

• Transfer pasted layers to the viewport center when outside the current view area #2306
• Fix regression causing last selected layer to not be deselected #2656

Then into writing a system so that clipPath can be alternatively used instead of mask when possible, as it is faster and has lesser artifacts.

clipPath	mask

Then, along with the help of @Keavon who wrote the frontend part, and assets, I implemented a indicator for clipped layers in Layer panel.

And finally I ended the week by fixing the logic used in clip and mask usage, to ignored layers with stroke.

before	after