Mercurial > hg > indyvon
view README.rst @ 185:83241889daac
BorderBox: properly wrap Geometry of the center view.
| author | Mikhail Kryshen <mikhail@kryshen.net> |
|---|---|
| date | Tue, 21 Nov 2017 19:06:25 +0300 |
| parents | 844921c135d6 |
| children |
line source
1 =========
2 Indyvon
3 =========
5 Indyvon [INteractive DYnamic VisualizatiON] is an experimental GUI
6 library for Clojure. Indyvon allows you to build and draw interactive
7 objects in immediate mode without maintaining a scene graph or a
8 hierarchy of widgets.
10 It is based around the idea of basically stateless UI elements defined
11 by the following simple protocol::
13 (defprotocol View
14 (render! [view]
15 "Draws the view.")
16 (geometry [view]
17 "Returns preferred size for the view."))
19 View functions are called in the View context which is defined by
20 bindings to vars including:
22 - ``*graphics*`` — an instance of java.awt.Graphics2D used for drawing;
23 - ``*width*`` and ``*height*`` — size of the drawing bounds;
24 - ``*clip*`` — clipping area (instance of java.awt.geom.Shape).
26 In the ``render!`` function View could draw using the provided
27 Graphics2D instance, display another Views at the specified locations
28 relative to it's own context, and register event handlers.
30 Event dispatching is done by remembering the clipping areas and affine
31 transforms of visible View contexts after every repaint for the time
32 until the rendering of the next frame is complete.
34 It is possible to draw Views asynchronously in parallel threads by
35 wrapping them in ``async-view``, which uses two off-screen buffers
36 (triple buffering) to avoid locking.