Updated: 14 May 2020


Initializes the calculator ready for calculating. 


Initialize( inputItem, variables, sectionName, sectionId, pageWidth, pageHeight ) 


inputItem  Optional input text formatted in Microsoft Rich Text Format (RTF)   
  which will be calculated.
variables Optional xml string of the variables to initialize the calculator with
  or the file path to a legacy variable file (.vbl). 
sectionName   Optional initial section name. 
sectionId Optional initial section identifier. 
pageWidth Optional output page width in twips, default is 180 twips. 
pageHeight Optional output page height in twips, default is 260 twips. 


The initialize method is normally used without any parameters, the optional parameters are only required for advanced usage scenarios.

The inputItem is required if you're wanting to calculate an existing RTF source, for example if you were wanting to integrate Tedds with an alternative word processor you would get the RTF from the document and pass it as this parameter so that Tedds would calculate the expressions in the RTF. The inputItem is also required if you want to obtain output RTF once calculating is finished. Output is obtained by using the Calculator.GetOutput method but if no inputItem has been specified to the Initialize method then GetOutput will not return any output. 

If the calculator has been used to perform a calculation and you want to save the variables so that they can be used at a later date for re-calculating then you can use the optional variables parameter to initialise the calculator with the previously saved variables. The variables from a previous calculation are retrieved by using the Calculator.GetVariables method

Example (C# - important semicolons may be hidden when viewed in Tedds) 

//Create calculator ICalculator calculator = new Calculator(); //Initialize first time calculator.Initialize(); //Set all required variables calculator.functions.SetVar("E", 75, "m"); calculator.functions.SetVar("N", 100, "m"); //Get variables as XML string 
Tedds 2019 – API Reference 
string variables = calculator.GetVariables(); //... //Application performs other tasks or stores XML for later use //... //Initialize calculator with existing variables XML calculator.Initialize( "", variables )