diff --git a/doc/devel/draw/builder-primitives.svg b/doc/devel/draw/builder-primitives.svg new file mode 100644 index 000000000..aa1ae5801 --- /dev/null +++ b/doc/devel/draw/builder-primitives.svg @@ -0,0 +1,2115 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + style="overflow:visible"> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + Transition + + + + + + + + + + + + + + + x + + + + + + + Effect + + + + + + + + + + + + + + + + + + + x + + + + + + + + + + + Effect + + + + + + + + + + + + + + + x + + + + + + + + x + + + + + + + + + + + + + + + + + + + x + + + + + + + Transition + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Clip + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Clip + + + + + + + + + + + + + + + + + + + + + + + Conv + + + + + + + Cam + + + + + + + + + + + + + + + + x + + + + + + + + + + + x + + + + + + + + + Con-Req + + + + + + + + + + Placement + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + x + + + + + + + + ∑ + + + + + + + + + + + + + + + + + + + + Conv + + + + + + + + + + + + + Proj + + + + + + + + + + + + + + + + + + x + + + + + diff --git a/wiki/draw/builder-primitives1.png b/wiki/draw/builder-primitives1.png new file mode 100644 index 000000000..986aa4227 Binary files /dev/null and b/wiki/draw/builder-primitives1.png differ diff --git a/wiki/draw/builder-primitives2.png b/wiki/draw/builder-primitives2.png new file mode 100644 index 000000000..1844f2af1 Binary files /dev/null and b/wiki/draw/builder-primitives2.png differ diff --git a/wiki/draw/builder-primitives3.png b/wiki/draw/builder-primitives3.png new file mode 100644 index 000000000..f80b1f5c6 Binary files /dev/null and b/wiki/draw/builder-primitives3.png differ diff --git a/wiki/draw/builder-primitives4.png b/wiki/draw/builder-primitives4.png new file mode 100644 index 000000000..6d60ddf2c Binary files /dev/null and b/wiki/draw/builder-primitives4.png differ diff --git a/wiki/renderengine.html b/wiki/renderengine.html index b076f0d9b..93cf42061 100644 --- a/wiki/renderengine.html +++ b/wiki/renderengine.html @@ -773,25 +773,38 @@ As the builder has to create a render node network implementing most of the feat !!pattern of operation The working pattern of this builder mechanics can be described as triggering, enqueuing, priorizing, recursing and exhausting. Without the priorizing part, it would be a depth-first call graph without any context state, forcing us to have all cross reference information available at every node or element to be treated. We prefer to avoid this overhead by ordering the operations into several phases and within these phases into correlated entities with the help of a ''weighting function'' and scheduling with a ''priority queue'' -
-
While assembling and building up the render engines node network, a small number of primitive building situations is encountered repeatedly. The BuilderToolKit provides a "fitting tool" for each of these situations, typically involving parametrisation and the application of a [[processing pattern|ProcPatt]].
+

+
While assembling and building up the render engines node network, a small number of primitive building situations is encountered repeatedly. The BuilderToolKit provides a "[[mould|BuilderMould]]" for each of these situations, typically involving parametrisation and the application of a [[processing pattern|ProcPatt]].
 
 !List of elementary building situations
 !!!inserting an Effect or Plugin
+[>img[draw/builder-primitives1.png]]
 * participating: a Pipe and an Effect
 * result: Effect appended at the pipe's exit node
 
+@@clear(right):display(block):@@
+
+
+!!!attaching a transition 
+[>img[draw/builder-primitives2.png]]
+* participating: N pipe's exit nodes, transition
+* result: transition has been attached with the pipe's exit nodes, new wiring requests created attached to the transition's exit node(s)
+
+@@clear(right):display(block):@@
+
 !!!building a source connection
+[>img[draw/builder-primitives3.png]]
 * participating: source port of a clip, media access point, processing pattern
 * result: processing pattern has been //executed//, resulting in a chain of nodes from the source reader to the clip source port
 
+@@clear(right):display(block):@@
+
 !!!wiring a general connection
 * participating: already verified connection request, providing a Pipe and an exit node; a processing pattern and a Placement
 * result: summation node prepended to the port of the pipe, processing pattern has been //executed// for building the connection from the exit node to the pipe's port, ParamProvider has been setup in accordance to the Placement.
+[>img[draw/builder-primitives4.png]]
 
-!!!attaching a transition 
-* participating: N pipe's exit nodes, transition
-* result: transition has been attached with the pipe's exit nodes, new wiring requests created attached to the transition's exit node(s)
+@@clear(right):display(block):@@
 

 

 

@@ -815,11 +828,11 @@ While building, the application of such a visiting tool (especially the [[NodeCr
-
-
Besides the primary working tool within the builder (namely the [[Node Creator Tool|PlanningNodeCreatorTool]]), on a lower level, we encounder several [[elementary building situations|BuilderPrimitives]] — and for each of these elementary situations we can retrieve a suitable "fitting tool". The palette of these fitting tools is called the ''tool kit'' of the builder. It is subject to configuration by rules.
+

+
Besides the primary working tool within the builder (namely the [[Node Creator Tool|PlanningNodeCreatorTool]]), on a lower level, we encounder several [[elementary building situations|BuilderPrimitives]] — and for each of these elementary situations we can retrieve a suitable "fitting tool" or [[mould|BuilderMould]]. The palette of these moulds is called the ''tool kit'' of the builder. It is subject to configuration by rules.
 
 !! {{red{open questions}}}
-* how to address these fitting tools
+* how to address these moulds
 * how to type them
 * how to parametrize them