Index: trunk/doc/developer/multides.html =================================================================== --- trunk/doc/developer/multides.html (nonexistent) +++ trunk/doc/developer/multides.html (revision 3733) @@ -0,0 +1,53 @@ + + + +

Transition multides support

+Before librnd 4.0.0, sch-rnd already has to support multiple sheets. This +can be done only with some kind of temporary workaround. This document +describes what hacks needs to be applied in sch-rnd to both support +temporary multi-sheet usage and ease transition to the + +official librnd 4.0.0 support. + +

The config problem

+Currently the config, both librnd's rnd_conf and the app's +conf_core are global. These will need to move into the design +struct. However, this requires a lot of breaking changes on librnd side as well +so can not be done before 4.0.0. +

+The workaround on sch-rnd side is: +

temporarily implement the design list in sch-rnd +
temporarily implement the GUI design switch event in sch-rnd +
keep a full rendered copy of all librnd and app config states, uncluding + rnd_conf and conf_core and librnd conf internal states + in each sheet +
use memcpy to copy forth and back between the only one global state + and the per sheet backsups on switch +

+The only librnd-side change this requires is grouping all internal conf states +and being able to allocate and copy them. This can be implemented in a +non-break manner. + +

Other infrastructure

GUI

+It already implements hidlib state. + + +

events

+At the moment all events need to be local. + + +

config change callbacks

+With config swapping this is granted; however the API lacks hidlib passing. +This can be worked around temporarily by relying on a "current design" concept. +For sch-rnd purposes this can be the same as GUI's, if the batch HID implements +it. +