Skip to main content Link Search Menu Expand Document (external link)

Managing draw style

In the previous section we briefly talked about controlling the appearance of drawing primitives, in this section we draw styles and tools to manage the draw style.

Full overview of properties of DrawStyle

Property Type Default Description
fill ColorRGBa? ColorRGBa.BLACK The fill color
stroke ColorRGBa? ColorRGBa.BLACK The stroke color
strokeWeight Double 1.0 The stroke weight
lineCap LineCap    
lineJoin LineJoin    
fontMap FontMap? null The font to use
colorMatrix Matrix55 IDENTITY The color matrix (used for images)
channelWriteMask ChannelMask ALL The channel write mask
shadeStyle ShadeStyle? null The shade style
blendMode BlendMode OVER The blend mode
quality DrawQuality QUALITY A hint that controls the quality of some primitives
depthTestPass DepthTestPass ALWAYS When a fragment should pass the depth test
depthWrite Boolean false Should the fragment depth be written to the depth buffer?
stencil StencilStyle   The stencil style
frontStencil StencilStyle   The stencil style for front-facing fragments
backStencil StencilStyle   The stencil style for back-facing fragments
clip Rectangle? null A rectangle that describes where drawing will take place

The active draw style

val active = drawer.drawStyle.copy()

The draw style stack

Styles can be pushed on and popped from a stack maintained by Drawer.

extend {
    drawer.pushStyle()
    drawer.fill = ColorRGBa.PINK
    drawer.rectangle(100.0, 100.0, 100.0, 100.0)
    drawer.popStyle()
}

The Drawer provides a helper function called isolated {} that pushes style and transforms on a their respective stacks, executes the user code and pops style and transforms back.

extend {
    drawer.isolated {
        fill = ColorRGBa.PINK
        rectangle(100.0, 100.0, 100.0, 100.0)
    }
}

edit on GitHub