Quick search

Table Of Contents

Stencil View

_images/stencilview.gif

New in version 1.0.4.

StencilView limits the drawing of child widgets to the StencilView’s bounding box. Any drawing outside the bounding box will be clipped (trashed).

The StencilView uses the stencil graphics instructions under the hood. It provides an efficient way to clip the drawing area of children.

Note

As with the stencil graphics instructions, you cannot stack more than 128 stencil-aware widgets.

Note

StencilView is not a layout. Consequently, you have to manage the size and position of its children directly. You can combine (subclass both) a StencilView and a Layout in order to achieve a layout’s behavior. For example:

class BoxStencil(BoxLayout, StencilView):
    pass
class kivy.uix.stencilview.StencilView(**kwargs)[source]

Bases: kivy.uix.widget.Widget

StencilView class. See module documentation for more information.