Scratch3PenBlocks

The default pen state, to be used when a target has no existing pen state.

The minimum and maximum allowed pen size. The maximum is twice the diagonal of the stage, so that even an off-stage sprite can fill it.

The key to load & store a target's pen-related state.

The ID of the renderer Drawable corresponding to the pen layer.

The ID of the renderer Skin corresponding to the pen layer.

The runtime instantiating this block package.

Convert an alpha value to a pen transparency value. Alpha ranges from 0 to 1, where 0 is transparent and 1 is opaque. Transparency ranges from 0 to 100, where 0 is opaque and 100 is transparent.

Clamp a pen color parameter to the range (0,100).

Clamp a pen size value to the range allowed by the pen.

Retrieve the ID of the renderer "Skin" corresponding to the pen layer. If the pen Skin doesn't yet exist, create it.

Initialize color parameters menu with localized strings

Update the pen state's color from its hue & shade values, Scratch 2.0 style.

When a pen-using Target is cloned, clone the pen state.

Handle a target which has moved. This only fires when the pen is down.

Set or change a single color parameter on the pen state, and update the pen color.

Convert a pen transparency value to an alpha value. Alpha ranges from 0 to 1, where 0 is transparent and 1 is opaque. Transparency ranges from 0 to 100, where 0 is opaque and 100 is transparent.

Update the cached color from the color, saturation, brightness and transparency values in the provided PenState object.

Wrap a color input into the range (0,100).

The "change pen {ColorParam} by {number}" block changes one of the pen's color parameters by a given amound.

Scratch 2 "hue" param is equivelant to twice the new "color" param.

Because "shade" cannot be backed out of hsv consistently, use the previously stored penState._shade to make the shade change.

The pen "change pen size by {number}" block changes the pen size by the given amount.

The pen "clear" block clears the pen layer's contents.

The pen "pen down" block causes the target to leave pen trails on future motion.

The pen "pen up" block stops the target from leaving pen trails.

The "set pen {ColorParam} to {number}" block sets one of the pen's color parameters to a given amound.

The pen "set pen color to {color}" block sets the pen to a particular RGB color. The transparency is reset to 0.

Scratch 2 "hue" param is equivelant to twice the new "color" param.

Use legacy "set shade" code to calculate RGB value for shade, then convert back to HSV and store those components. It is important to also track the given shade in penState._shade because it cannot be accurately backed out of the new HSV later.

The pen "set pen size to {number}" block sets the pen size to the given amount.

The pen "stamp" block stamps the current drawable's image onto the pen layer.