Mercurial > code > home > repos > light9
changeset 2153:a1b30c3463b4
add some old docs that still look good
author | drewp@bigasterisk.com |
---|---|
date | Wed, 17 May 2023 19:36:07 -0700 |
parents | f5bdb8a89cef |
children | b6a8289b1d1e |
files | light9/web/live/README.md |
diffstat | 1 files changed, 24 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/light9/web/live/README.md Wed May 17 19:36:07 2023 -0700 @@ -0,0 +1,24 @@ +This is an editor of :Effect resources, which have graphs like this: + + <http://light9.bigasterisk.com/effect/effect43> a :Effect; + rdfs:label "effect43"; + :publishAttr :strength; + :setting <http://light9.bigasterisk.com/effect/effect43_set0> . + + <http://light9.bigasterisk.com/effect/effect43_set0> :device dev:strip1; :deviceAttr :color; :scaledValue 0.337 . + +# Objects + +SyncedGraph has the true data. + +Effect sends/receives data from one :Effect resource in the graph. Only Effect knows that there are :setting edges in the graph. Everything else on the page +sees the effect as a list of (effect, device, deviceAttr, value) tuples. Those values are non-null. Control elements that aren't contributing the effect +(_probably_ at their zero position, but this is not always true) have a null value. + +GraphToControls has a record of all the control widgets on the page, and sends/receives edits with them. + +We deal in ControlValue objects, which are the union of a brightness, color, choice, etc. Some layers deal in ControlValue|null. A null value means there is no +:setting for that device+attribute + +SyncedGraph and GraphToControls live as long as the web page. Effect can come and go (though there is a plan to make a separate web page url per effect, then +the Effect would live as long as the page too)