All shapes that are common to both groups remain linked. This differs from the previous option in that it creates a new group of shapes, allowing shapes to be added to or removed from the group independently of the module from which they were copied. use same shapes as Add a list of shapes used in another module to the current module’s mask. If that shape or group is used elsewhere, any changes you make will be reflected everywhere the shape or group is used. The following options are available for selection: add existing shape Choose either an individual shape or a group of shapes that you’ve drawn previously (either within the mask manager or from within the drawn mask of another module). Click on the shapes drop-down (next to the ‘show and edit mask elements’ button) to choose previously-drawn shapes individually or to use the same group of shapes as used by another module. You can reuse shapes that you have drawn in other modules. While in edit mode right-click on a shape to remove it. This is particularly useful to avoid costly mistakes when editing path and brush shapes.Ĭlick and drag a shape to move it around the image canvas.

dragging a complete shape or changing its size) are blocked. Ctrl+click on the same icon to enter restricted edit mode, where certain actions (e.g. This will show all drawn masks in use by the current module and allow you to edit those shapes. The new default values will be used the next time you create a new shape.Ĭlick on the ‘show and edit mask elements’ icon Note: When used in shape creation mode, the preceding scroll operations will also cause the default feathering or opacity to be changed. These operations are available in both creation and edit modes (as long as your mouse is over the shape in question). While in continuous creation mode, right-click on the image to stop drawing shapes and enter edit mode.įor all drawn shapes, you can hold Shift while scrolling with the mouse wheel to change the extent of the shape’s feathering (the blur at the edge of the shape) and use Ctrl+scroll to change the shape’s opacity (how transparent it is). Once you have finished drawing your shape you will automatically be taken into edit mode.Ĭtrl+click on the shape icon to continuously draw multiple shapes of the same type – each time a shape is completed, you will re-enter creation mode for a new instance of that shape. This will take you into the creation mode for that shape. 🔗creating shapesĬhoose a shape by clicking on the appropriate shape icon (from left to right: circle, ellipse, path, brush, gradient). You can also create and edit shapes using the mask manager module. The controls required to create and alter drawn masks may be enabled by selecting either the “drawn mask” or “drawn & parametric mask” icon at the bottom of a module. This means that a shape will always work on the same image area regardless of any modifications that may be subsequently applied. Shapes are expressed in the coordinate system of the original image and are transformed along with the rest of the image by any active distorting modules in the pipe ( lens correction, crop & rotate for example). Shapes are stored internally as vectors and are rendered with the required resolution during pixelpipe processing. Once a shape has been drawn on an image it can be adjusted, removed, or reused in other modules. Shapes can be used alone or in combination. Ideally we would only take one additional parameter which we could link to some CTRL-scroll action.With the drawn mask feature you can construct a mask by drawing shapes directly onto the image canvas. The standard use case is lens correction so we could use a simplified mathematical model of the underlying distortion algorithm. If the topic discussed here is an issue then I would rather suggest to extend the gradient shape by an option to curve the line.

Sure a simple gradient is easy to set up and a corresponding path takes much more time to construct.

But if this is an issue more complex forms like ellipses and paths are available. This of course means that simple forms like lines and circles will distort more or less. They need coordinates and it has been a clever decision to base them on the input image which is the only coordinate system that does not change in the pixelpipe. This would be a massive system of complexity further complicated by the option to move modules around in pixelpipe.ĭrawn shapes are there to mask features of your scene. You will end up with a situation where some modules do distort, others not, some shapes yes, few excluded and so on. One would want to be able to set a forms to not be distorted in any ways (non default behavior).

Darktable 3.0 gradient mask