Viewing post in The Contraption Bazaar

Patternshop, a widget for many-layered drawing.

Patternshop’s been massively simplified to a single widget, inspired by Missooni, but the rest is left here for historical reasons.

%%WGT0{"w":[{"name":"patternshop1","type":"contraption","size":[512,342],"pos":[0,0],"show":"transparent","def":"patternshop","widgets":{"visible":{},"active":{}}}],"d":{"patternshop":{"name":"patternshop","size":[512,342],"margin":[0,0,0,0],"script":"on view do\n  if !visible.locked\n    me.show: \"transparent\"\n    visible.show: \"transparent\"\n    order: 1 drop keys deck.cards\n    i: (first deck.cards).image\n    if active.text\n      n: (extract index where value = active.text from order)[0]\n    else\n      n: (extract index where value = me.parent.name from order)[0]\n    end\n    each c in n take order\n      i: deck.cards[c].image.copy[].paste[i 0,0 1]\n    end\n    visible.paste[i]\n  end \nend\n\non set_canvas x do\n  visible.paste[x]\nend\n\non get_canvas do\n  visible.copy[]\nend\n\non set_locked x do\n  visible.locked: x\nend\n\non get_locked do\n  visible.locked\nend\n\non set_clear x do\n  visible.paste[image[card.parent.size]]\nend\n\non get_clear do\n  visible.paste[image[card.parent.size]]\nend\n\non set_active x do\n  active.text: x\nend\n\non get_active do\n  active.text\nend","attributes":{"name":[],"label":[],"type":[]},"widgets":{"visible":{"type":"canvas","size":[512,342],"pos":[0,0],"show":"transparent","border":0,"scale":1},"active":{"type":"field","size":[100,20],"pos":[-32,-32],"locked":1,"show":"none","style":"plain"}}}}}

Usage:

The first card is the first layer, no contraption needed
Each additional card is a layer, add a Patternshop contraption to it
Use the arrow keys to flip left and right between layers
Use the regular Decker drawing tools to draw on a layer (turn them on in the Decker menu)
Switch back to interact mode (pointer finger or the menu) to have the layers composed - you’ll have to do this when you switch to a layer. Missooni has it part of the layer selection to automatically do that in Patternshop Cinnanom.

This can be much more easily used standalone now as a contraption.

It has several properties for programming:

.canvas: get/set the image
.clear: clear the image
.locked: disable composition

And most importantly:

.active: sets the “active” card name. composites from the first up to but NOT including the active card. it assumes that you are drawing on active and thus don’t want it composed. setting it to nil automatically detects what card it is on.

woodring94 days ago (2 edits)

I’ve made several updates. In particular, added over and under composite modes, along with several other things.

It probably operates more like people expect, now.

I plan on merging a lot of the functionality into the canvas target and layer widgets, to reduce the number of contraptions. Card target and layer contraptions will mostly remain the same. While the cards seem relatively limited compared to the canvases, they both serve a purpose: 1. being able to composite with the existing Decker drawing tools, and 2. a composited background for a canvas layer to trace over or underpaint.

woodring93 days ago(+1)

it’s already gone through a big revamp for usability as I tested it under “real” conditions.

it’s been massively simplified to three contraptions; card, canvas, and layercake.

woodring86 days ago (3 edits) (+1)

Video and tutorial card are still on their way.

I’ve made a couple of more usability passes as I’ve been trying to use it for real (the actual reason this exists).

off the top of my head:

wipe (clear) button
+/- buttons for incrementing and decrementing the brush and pattern on canvas layers
other things that I don’t remember

I’ve done a pretty simple sketch of a face and torso where I sketch the rough on one layer, switch to another to outline the face by overpainting, and then switch to a third to add shading by underpainting. It works pretty well.

There will be a learning curve - but (not that this excuses it) most drawing programs with layering, that I know of, have a steep learning curve.

What needs to be added - but the last two, I don’t know if I’ll get to it. It works for my needs and the amount of work to make them functional is way over my annoyance threshold.

the tutorial
DONE ~don’t allow C to be activated if there are no active layers~
DONE ~a “logical lock” - once switched to layer mode, make it ask more when switching to composite mode and vice versa - to protect drawings from being wiped.~
(maybe, but I probably won’t) a grid widget for globally reordering layers (an overview of the composite)
(maybe) a couple of levels of undo

ahmwma85 days ago(+2)

I'm really curious about this one! I think I'll need the tutorial card to really get my head around it, but I'm definitely interested in checking it out when that's ready.

woodring85 days ago(+1)

I’ll try to get it out soon - I’d like to have your feedback, in particular - as I thought this might be useful for you. Thanks for your interest.

woodring84 days ago(+1)

Another big usability refactor. It’s down to two widgets. patternshop and ps_layercake. Will be working on the tutorial, now.

woodring84 days ago (1 edit) (+1)

Also, the README is simplified a lot. Maybe it’s actually readable for some now, before I get the tutorial deck done. (I tend to write too much - my ADHD brain’s tendency to info dump.)

woodring84 days ago (2 edits) (+1)

teaser for the tutorial deck

–removed– needs to be redone

woodring84 days ago(+1)

As an aside - I only just now noticed there was a WigglyPaint retrospective.

Related to that - in my attempts for making this easier to use:

make compositing order implicit based on the card order, since there’s already the ability to reorder cards
make the background automatically the composite target
probably all that is wanted is underpaint/masking, so I’ll probably remove operator selection. or make it less up front and center
I like the palette/swatch selection. so make it go directly to a “physical palette” where you can select the pattern visually with a select tool. apply your patterns in swatches like paint. kind of like how layercake can be used now to lift brushes off the palette.

this will remove all of the buttons and probably all that’s needed is a few hot keys to operate the layercake tool.

woodring84 days ago(+1)

Yeah - this is going to way simplify everything… sorry for the delay. It will be a much better, though.

woodring83 days ago(+1)

OK - it’s been redone. Hopefully this is the last one for a while.

no more layer buttons; order is implicit on card order
no more operation buttons; probably the only thing that is wanted is underpaint. over is achieved by reordering the cards.
everything has a hotkey and the buttons show what they are. they can be hidden.
UNDO! (infinite right now, but I should limit it - otherwise, you can run out of memory)
support for the palette card: a goto/return button, an eyedropper, copy brush and pattern from palette
probably a few other things

woodring83 days ago (1 edit) (+2)

Updated teaser:

reload if the video is not playing

woodring75 days ago(+1)

Tutorial is still on the way - but I’ve been slacking. (I’m asking Houdini will let me submit this to the App Jam - which will force me to finish it. I’d give myself a deadline of the 29th to be fair.)

woodring68 days ago (2 edits) (+1)

https://woodring.itch.io/patternshop tutorial and playable deck

added a button to start from scratch

woodring8 days ago(+1)

See https://missooni.itch.io/patternshop-cinnamon for a more Decker-like drawing experience with layers (rather than my complicated mess)

woodring6 days ago (1 edit) (+1)

I added a quick and dirty hack inspired by Missooni’s Patternshop Cinnanom, on my Patternshop page. It’s completely a single contraption now (Patternshop Neo) without any modules. Download the patternshop_neo.html to try it out or get it from my codeberg page.

The first card is the first layer, no contraption needed
Each additional card is a layer, add a Patternshop contraption to it
Use the arrow keys to flip left and right between layers
Use the regular Decker drawing tools to draw on a layer (turn them on in the Decker menu)
Switch back to interact mode (pointer finger or the menu) to have the layers composed - you’ll have to do this when you switch to a layer. Missooni has it part of the layer selection to automatically do that.

This can be much more easily used standalone now as a contraption.

It has several properties for programming:

.canvas: get/set the image
.clear: clear the image
.locked: disable composition

And most importantly:

.active: sets the “active” card name. composites from the first up to but NOT including the active card. it assumes that you are drawing on active and thus don’t want it composed. setting it to nil automatically detects what card it is on.

Deleted post6 days ago

Deleted 4 days ago

woodring5 days ago (1 edit)

Old historical, see my top post in this thread for the latest single widget version

https://woodring.itch.io/patternshop tutorial and deck

See: https://missooni.itch.io/patternshop-cinnamon for a Decker drawing with layers

patternshop

a compositing tool for cards and ps canvases as layers

https://woodring.itch.io/patternshop

Also: see https://missooni.itch.io/patternshop-cinnamon for a more Decker-like experience with layers

reload if the video is not playing

tutorial and playable deck: https://woodring.itch.io/patternshop

direct download of deck: https://codeberg.org/woodring/decker.patternshop/raw/branch/main/patternshop.deck

project and readme, which is pasted below: https://codeberg.org/woodring/decker.patternshop/src/branch/main

see https://codeberg.org/woodring for more decker things

synopsis

It’s a module and several contraptions that emulate layered drawing in other drawing tools. Or, it can be thought of as “Decker mega-underpaint mode.”

https://woodring.itch.io/patternshop

teaser video apng

make at least three cards
put the patternshop contraption on each of those cards.
switch to interactive mode.
press 0 (zero) on each of the cards to activate the contraption.
draw on the first card in interactive mode.
switch to the second card. what was drawn on the first card appears there.
draw on the second card.
switch to the third card. what was drawn on the second will be under the first.
et voila, layered drawing!

Why is this important? Imagine:

card1 has a rough sketch.
card2 shows card1, to trace over card1’s sketch.
card1 is deactivated, automatically removing the sketch, without having to manually erase it from card2.
card3 shows the outline of card2, to add shading without worrying about staying exactly in the lines.

layered drawing - how it works

patternshop is a contraption that combines multiple images into one. In another PS or other drawing programs, it’s what’s called layering. In graphics, it’s what we call compositing or image composition.

Another analogy is that it’s like old school cel drawing, for animation, where the scene is composed of several stacked layers of transparent celluloid.

The mode of operation is to draw on the patternshop canvas, which is a transparent drawing surface, in front of the card background. All of the active patternshop drawing surfaces are combined together - in a stack. Then, the combined stack is copied onto each card background of each card that patternshop is on. This provides the combined result on each layer - i.e., card.

Images are combined in card order. To change it so a drawing appears under another, reorder the cards in the Decker menu, i.e. File->Cards. Later cards in the stack appear under the ones in front of it. For n layers, make n+1 cards with patternshop on it. The final card will show everything together, by itself.

IMPORTANT: Drawing on patternshop requires interactive mode - not drawing mode. Decker drawing mode only works on cards. To use the Decker drawing tools, draw on a card then use the patternshop swap function to move the image to the patternshop contraption. Alternatively, use ps_layercake contraption to copy it.

When drawing on a card, with an image on the patternshop canvas, it will be under the canvas - which is what might be wanted for more accurate underpainting. Drawing on patternshop only supports the freehand pencil with custom brushes and patterns.

But, what makes patternshop different is that allows for drawing on the canvas and simultaneously seeing the card background underneath - to trace over it. It’s like Decker’s built-in underpainting, but with patternshop there’s an arbitrary number of underpainting layers.

Note: the only composite mode that patternshop supports is under. To achieve over, move the card to the front of the card stack. The other compositing modes that Decker likely aren’t used in practice by most people and are not included.

usage notes

To save your work, save the deck. Everything is retained between sessions.
Reordering cards to change layer combining order is immediate, after closing the card order dialog.
The starting visibility of patternshop and ps_layercake is transparent for the canvas to provide tracing over the card background, by default. They can both toggle between “solid”, “transparent”, “invert”, and “none”.
Everything is hotkey driven - for two reasons: (1) save screen real estate, but more importantly (2) when drawing, especially with a tablet, it is common to have a hand hovering over hotkeys or program the tablet for the hotkeys. It starts with a toolbar that can be hidden with q after learning the hotkeys.
- Buttons for 4, Z, and X only work with hotkeys. They are visually present to show what they hotkey is.
As noted earlier, there’s a second contraption, ps_layercake, which is an advanced rubberband/select box that knows how to work with patternshop contraptions and cards.
The patternshop and ps_layercake contraptions can be used in any Decker project, as long as the ps module is copied over, too. They will not work without it.
Switching to a card will composite (combine) all layers if there is an activate patternshop on a card. It only updates “on view”; i.e., changing cards or having an animated widget on that card. But, having an animated widget on a patternshop card will slow Web Decker down quite significantly. While drawing, I do not suggest having animated widgets on the cards.

controls for `patternshop`

patternshop home row

1: toggle canvas visibility between “solid”, “transparent”, “invert” and “none”. starts in “transparent”. “solid” will hide the card background and “none” will hide the canvas.

2: toggle to the last brush used. starts with brush “1”.

3: toggle to pattern 0 and back to the last pattern used.

4: eyedropper tool that picks a pattern under the cursor. picks from the canvas first and the card second. does not change the pattern if it is pattern 0.

5: goto a card named palette. to be used in concert with 4, w, e, and ps_layercake’s custom brush function - to store patterns and brushes on a card, like a real-world palette. the palette card can contain whatever you wish - as long as it has a patternshop contraption on it. pressing 5 when on the palette card returns you to the previous card.

after learning the hotkeys or needing to temporarily move it

q: hide the toolbar

palette support

w: copy the brush from the palette card.

e: copy the pattern from the palette card

off patternshop home row

6: swap the image between the canvas and the card. to use Decker drawing tools - draw on the card and then swap it to the canvas.

7: erase the canvas.

8: set the brush. it will ask to provide a brush number or custom brush name. 2 swaps between two brushes.

9: set the pattern. it will ask to provide a pattern number in. for quicker pattern changing, use 4 and 5 with 3.

0: activate/deactivate the patternshop on this card. once activated, it will show all other active patternshops combined in card order. to remove a layer, deactivate it with 0. IMPORTANT activating a pattershop will ERASE any existing card background image.

undo and redo

z: infinite undo for canvases - up to available memory. no effect for cards. TODO need to put an undo limiter in to not accidentally run out of memory.

x: redo after undo. drawing after redoing will clear the redo stack.

ps_layercake support

r: make a ps_layercake at 100,100

ps_layercake hotkey to support patternshop

y: remove all layercake instances from the card. IMPORTANT: if there is more than one on a card, it will remove ALL of them.

controls for `ps_layercake`

ps_layercake is a select/rubberband box companion for patternshop. It can copy and move selections around the canvas and card background, more selectively than the patternshop swap (6) function.

It works in interactive mode, like patternshop. The upper-left box moves it and the lower-right box resizes it. All of the other controls are hotkey driven, like the rest of patternshop.

Also, it can be copy and pasted to any other card, just like any other contraption, moving the copied image between cards.

layercake to-and-from the card background

c: copy card background into layercake.

v: paste layercake onto card background.

n: merge card background into layercake. this is different than c, because it treats pattern 0 as transparent.

m: merge layercake onto card background. like n, this is different than v, because it also treats pattern 0 as transparent.

layercake to-and-from the canvas

d, f, h, j: copy, paste, merge into, merge onto for the canvas layer, instead of the card background.

other functions

t: toggle layercake visibility between “solid”, “transparent”, “invert” and “none”.

g: erase the layercake image contents.

b: save the layercake image contents as a custom brush. it will ask for a name.

y: remove all layercake instances from the card. IMPORTANT if there is more than one on a card, it will remove ALL of them.

on patternshop to support layercake

r: make a ps_layercake at 100,100

https://woodring.itch.io/patternshop

itch.io

Viewing post in The Contraption Bazaar

patternshop

a compositing tool for cards and ps canvases as layers

synopsis

layered drawing - how it works

usage notes

controls for patternshop

controls for ps_layercake

controls for `patternshop`

controls for `ps_layercake`