annotate web/live/README.md @ 2450:a4052905ca7d default tip

notes about how rdfdb syncs, or should sync
author drewp@bigasterisk.com
date Mon, 03 Jun 2024 23:01:54 -0700
parents 4556eebe5d73
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2153
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
1 This is an editor of :Effect resources, which have graphs like this:
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
2
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
3 <http://light9.bigasterisk.com/effect/effect43> a :Effect;
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
4 rdfs:label "effect43";
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
5 :publishAttr :strength;
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
6 :setting <http://light9.bigasterisk.com/effect/effect43_set0> .
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
7
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
8 <http://light9.bigasterisk.com/effect/effect43_set0> :device dev:strip1; :deviceAttr :color; :scaledValue 0.337 .
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
9
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
10 # Objects
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
11
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
12 SyncedGraph has the true data.
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
13
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
14 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
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
15 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
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
16 (_probably_ at their zero position, but this is not always true) have a null value.
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
17
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
18 GraphToControls has a record of all the control widgets on the page, and sends/receives edits with them.
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
19
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
20 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
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
21 :setting for that device+attribute
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
22
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
23 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
a1b30c3463b4 add some old docs that still look good
drewp@bigasterisk.com
parents:
diff changeset
24 the Effect would live as long as the page too)