Install, Readme and Changes files updated. Documentation removed.
[Faustine.git] / interpretor / faust-0.9.47mr3 / compiler / documentator / doc_sharing.cpp
1 /************************************************************************
2 ************************************************************************
3 FAUST compiler
4 Copyright (C) 2003-2004 GRAME, Centre National de Creation Musicale
5 ---------------------------------------------------------------------
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
19 ************************************************************************
20 ************************************************************************/
21
22
23
24 /*****************************************************************************
25 ******************************************************************************
26 FAUST SIGNAL COMPILER
27 Y. Orlarey, (c) Grame 2002
28 ------------------------------------------------------------------------------
29 Compile a list of FAUST signals into a LaTeX equation.
30
31 History :
32 ---------
33 2002-02-08 : First version (of sharing.cpp)
34 2009-08-18 : Doc version (Karim Barkati)
35
36 ******************************************************************************
37 *****************************************************************************/
38
39
40
41 #include <stdio.h>
42
43 //#include "compile_vect.hh"
44 //#include "compile_scal.hh"
45 //#include "doc_compile_vect.hh"
46 #include "doc_compile.hh"
47 #include "sigtype.hh"
48 #include "sigtyperules.hh"
49 #include "sigprint.hh"
50
51 //#include "doc_sharing.hh"
52
53
54 /*****************************************************************************
55 ******************************************************************************
56
57 SHARING ANALYSIS
58
59 ******************************************************************************
60 *****************************************************************************/
61
62 //------------------------------------------------------------------------------
63 // Create a specific property key for the sharing count of subtrees of t
64 //------------------------------------------------------------------------------
65
66 int DocCompiler::getSharingCount(Tree sig)
67 //int getSharingCount(Tree sig, int count)
68 {
69 //cerr << "getSharingCount of : " << *sig << " = ";
70 Tree c;
71 if (getProperty(sig, fSharingKey, c)) {
72 //cerr << c->node().getInt() << endl;
73 return c->node().getInt();
74 } else {
75 //cerr << 0 << endl;
76 return 0;
77 }
78 }
79
80
81 void DocCompiler::setSharingCount(Tree sig, int count)
82 //void setSharingCount(Tree sig, int count)
83 {
84 //cerr << "setSharingCount of : " << *sig << " <- " << count << endl;
85 setProperty(sig, fSharingKey, tree(count));
86 }
87
88
89
90 //------------------------------------------------------------------------------
91 // Create a specific property key for the sharing count of subtrees of t
92 //------------------------------------------------------------------------------
93
94
95
96 void DocCompiler::sharingAnalysis(Tree t)
97 //void sharingAnalysis(Tree t)
98 {
99 fSharingKey = shprkey(t);
100 if (isList(t)) {
101 while (isList(t)) {
102 sharingAnnotation(kSamp, hd(t));
103 t = tl(t);
104 }
105 } else {
106 sharingAnnotation(kSamp, t);
107 }
108 }
109
110
111
112 //------------------------------------------------------------------------------
113 // Create a specific property key for the sharing count of subtrees of t
114 //------------------------------------------------------------------------------
115
116
117 void DocCompiler::sharingAnnotation(int vctxt, Tree sig)
118 //void sharingAnnotation(int vctxt, Tree sig)
119 {
120 //cerr << "START sharing annotation of " << *sig << endl;
121 int count = getSharingCount(sig);
122
123 if (count > 0) {
124 // it is not our first visit
125 setSharingCount(sig, count+1);
126
127 } else {
128 // it is our first visit,
129 int v = getCertifiedSigType(sig)->variability();
130
131 // check "time sharing" cases
132 if (v < vctxt) {
133 setSharingCount(sig, 2); // time sharing occurence : slower expression in faster context
134 } else {
135 setSharingCount(sig, 1); // regular occurence
136 }
137
138 // Annotate the sub signals
139 vector<Tree> subsig;
140 int n = getSubSignals(sig, subsig);
141 if (n>0 && ! isSigGen(sig)) {
142 for (int i=0; i<n; i++) sharingAnnotation(v, subsig[i]);
143 }
144 }
145 //cerr << "END sharing annotation of " << *sig << endl;
146 }
147
148