WriterCodegen

java.lang.Object
- org.vishia.fbcl.writeFBcl.WriterCodegen

```
public class WriterCodegen
extends java.lang.Object
```
This class organizes the code generation for any languages. It is controlled by the scripts given with #readTpl(Class, String). Depending of the data structure different otx scripts are called. With the otx scripts the adaption to any target language can be done, and also to any desired style. The otx scripts are able to give from outside. The adaption can be done without changing the Java sources and also without study the Java sources.
But in the scripts frequently operations given in this class should be used, which call inside otx scripts again (can be adapted). For that the javadoc of this operations should be studied.

This system is universal as much as possible. But maybe specific approaches needs adaption of the Java sources. This adaption should be done increasing the universality of the universal approach. All adaption to the target language should be possible to do only with the otx scripts.

The whole code generation is called calling #writeCode(File, File, String, Module_FBcl, LogMessage). This operation writes all defined output files. General the script for the whole output file for a target language starts with:
```
 
```
The frequently used operations in otx scripts are:

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`WriterCodegen.CondNode` Contains data saved in a stack for next sibling node after a condition node.
`private static class`	`WriterCodegen.LogLevel` Store info to log level in the stack `stackLogEntries`
`static class`	`WriterCodegen.MdlData`
`static class`	`WriterCodegen.OtxWorkData` This class holds data for one generation of code related to one otx script for a whole file.
`(package private) static class`	`WriterCodegen.XXXECondCode`

Field Summary

Fields
Modifier and Type	Field and Description
`private AliasImport_FBcl`	`aliasImport`
`boolean`	`bVerboseCode`
`java.util.Map<java.lang.String,java.lang.String>`	`cmprOp` Map operators of OFB (compatible IEC61499) to target language C/++, Java Note due IEC61499 '=' is equal and '<>' is not equal from graphic
`java.util.Map<java.lang.String,java.lang.String>`	`cmprOpReverse` Note '>' is translated to '<=' etc. because the relation is to the input, but the operator is written left side, regarded als compare between left and this value.
`(package private) java.util.Map<java.lang.String,java.lang.Object>`	`idxConstData` This map can be filled by the script especially with String-String associations.
`(package private) java.util.Map<java.lang.String,java.lang.String>`	`idxImportImpl`
`(package private) java.util.TreeMap<java.lang.String,OutTextPreparer>`	`idxOtx` Index with all scripts to write, filled after creation of this class calling `#readTpl(Class, String)`.
`(package private) java.util.Map<java.lang.String,OutTextPreparer.DataTextPreparer>`	`idxOtxdata`
`static java.util.List<Din_FBcl>`	`iterDinEmpty` Is used for the first evChain entry, it has the module din.
`static float`	`kNoLimit`
`private LogMessage`	`logPrc`
`private java.lang.StringBuilder`	`logPrcBuffer`
`private Module_FBcl`	`mdl`
`java.util.Map<java.lang.String,java.lang.String>`	`numOp`
`java.util.Map<java.lang.String,java.lang.String>`	`numOpFirst`
`private java.io.OutputStream`	`oLogPrc`
`(package private) OutTextPreparer`	`otx_callFB_evin` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_castValExprLim_SFd`
`(package private) OutTextPreparer`	`otx_ctorFB_evin` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_ctorObjFB_evin` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_defineLocalVar_FBexpr` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_evMdlOutEnd` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_evMdlOutStart` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_exprAccessElement` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_exprCondBitsIf` Called if a condition bit change is found.
`(package private) OutTextPreparer`	`otx_exprCondIf` Called if an event output true is found.
`(package private) OutTextPreparer`	`otx_exprTerm` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_initFB_evin` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setMdlOutArrayCpy` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setMdlOutArrayExpr` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setMdlOutScalar` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setMdlOutStructCpy` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setVar_DoutFBarray2Din` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setVar_FBexpr` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setVarArrayElem` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setVarStruct` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setVarX_Array` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otx_setVarX_Elem` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otxAccessFBdout` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otxEvChainExprSetvar` This is the important OutTextPreparer for one event chain member proper to `#prcEvChain(Evin_FBcl, Integer, Writer)`.
`(package private) OutTextPreparer`	`otxExprCondBitsEndif` Called if a condition bit change is found.
`(package private) OutTextPreparer`	`otxExprElse` Called if an event output true is found.
`(package private) OutTextPreparer`	`otxExprEndif` Called if the chain of an event output true is finished, means the next event given before executing the "true" is found, or on end of all events.
`(package private) OutTextPreparer`	`otxExprEv_OFB_Variable` Called if an event output true is found.
`(package private) OutTextPreparer`	`otxExprIf` Called if an event output true is found.
`(package private) Prj_FBcl`	`prj`
`(package private) java.lang.String`	`sDbgFBexpr`
`(package private) java.lang.String`	`sDbgFBexprEvin`
`private java.lang.String`	`sLineIndent`
`java.lang.String`	`sNewlineIndent`
`private java.util.Stack<WriterCodegen.LogLevel>`	`stackLogEntries` The position in the current StringBuilder for output on call of `#writeLogPrcEntry(StringBuilder, String, Object...)`
`(package private) java.lang.String`	`testData`
`java.util.Map<java.lang.String,java.lang.String>`	`unaryOp`
`static java.lang.String`	`version` Version, history and license.
`private java.io.Writer`	`wrLogPrc`
`(package private) OutTextPreparer`	`XXXotx_exprSetCond` Called if an event output true is found.

Constructor Summary

Constructors
Constructor and Description

WriterCodegen(Prj_FBcl prj)

Constructors
Constructor and Description
`WriterCodegen(Prj_FBcl prj)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addImportToPrj(java.lang.String sNameModule, java.lang.String sKind, java.lang.String sImportPath)` Adds the own header of the module to the project wide alias-header- `Prj_FBcl.codegenTypeReplace` So that usage of this Module FBtype imports the header.
`private void`	`callFBoper(FBexpr_FBcl fbx, long[] condBits, Dout_FBcl dout, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst wrCt)` Generates the code for a called operation of an FBexpr as FBoper if it contains a `FBexpr_FBcl.getFunction()`.
`private void`	`callOtx(OutTextPreparer otx, OutTextPreparer.WriteDst out, OutTextPreparer.DataTextPreparer args)` Call the otx script with log entries.
`private static boolean`	`checkConnUse(PinConnect_FBcl connSrc, long mEvinMdlMask, int ixFBlock, java.lang.String sVariant)` Deprecated. use `#iterConnSrcConditional(Din_FBcl, long[])`
`boolean`	`checkSetLocalVariable(java.lang.String name, WriterCodegen.OtxWorkData wd)`
`void`	`debug(java.lang.Object val1)` It can be used to set a debug stop point in an otx script.
`void`	`debug4(java.lang.Object val1, java.lang.Object val2, java.lang.Object val3, java.lang.Object val4)` It can be used to set a debug stop point in an otx script.
`void`	`doInsert(WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst OUT)`
`DinExpr_FBcl.DTypeDesignation`	`dTypeDsgn(java.lang.String sSAT, DinExpr_FBcl xin, DinExpr_FBcl x1)` Wrapper arround `DinExpr_FBcl.dTypeDsgn(String, DinExpr_FBcl)` with log entries.
`void`	`genCastAccess(Dinout_FBcl dinout, DType_FBcl dtDst, DType_FBcl dtSrc, boolean bCast, java.lang.String sSAT, float maxArg, float minArg, boolean bCastConstArg, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst wrCt, java.lang.CharSequence sExprIn)` Generates the cast and bit shift surround an value expression given as string from generation of this value or a constant.
`java.lang.String`	`genConstantValue(Din_FBcl din, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Generates the const value string with given `Din_FBcl.sConstant` and also given `Din_FBcl.dTypeCastInp` as detected type of the constant, tuned to the `Dinout_FBcl.dTypeDecl()`, the type of the pin itself.
`java.lang.String`	`genDinAccess(Din_FBcl din, PinConnect_FBcl conn, long[] condBits, java.lang.String sVariant, java.lang.String ref, int ixFBlock, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Compatible form see `#genDinAccessLimit(Din_FBcl, PinConnect_FBcl, long[], String, String, int, String, float, float, OtxWorkData, StringBuilder)` especially used in otx script, where limitation is not a topic.
`void`	`genDinAccessConnLimit(Din_FBcl dinDst, PinConnect_FBcl connSrc, java.lang.String cacc, int ixFBlock, long[] condBits, java.lang.String ref, float max, float min, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Generates the code for a given `Din_FBcl` for a given connection `PinConnect_FBcl`
`java.lang.String`	`genDinAccessLimit(Din_FBcl din, PinConnect_FBcl conn, long[] condBits, java.lang.String sVariant, java.lang.String ref, int ixFBlock, java.lang.String cacc, float max, float min, boolean bOnlyOne, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Generates the access String for an input of any FBlock.
`void`	`genDinConnAcc(Din_FBcl din, PinConnect_FBcl conn, java.lang.String cacc, int ixFBlock, long[] condBits, int[] ixFBArg, java.lang.String ref, java.lang.String sSat, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Generates the code for one connected Dout for `Din_FBcl`, also for `DinExpr_FBcl` or also for the const value of `Din_FBcl.sConstant` if given.
`java.lang.String`	`genEventOperBody(EvtreeNode_FBcl rootNode, Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`java.lang.String`	`genEventOperHeader(Evout_FBcl evinMdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`private void`	`genExprIn(DinExpr_FBcl din, FBexpr_FBcl fbx, long[] condBits, java.lang.String sOperatorLeftArg, java.lang.String sOperator, java.lang.String sUnaryOp, java.lang.String ref, int ix, java.lang.String caccArg, float max, float min, boolean bOnlyOne, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion)` Generate the code of an expression input regarding constant values and K parts.
`private void`	`genExprInConn(Dout_FBcl doutSrc, DinExpr_FBcl din, FBexpr_FBcl fbx, long[] condBits, java.lang.String sOperatorLeft, java.lang.String sOperator, java.lang.String sUnaryOp, java.lang.String ref, java.lang.String caccArg, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion)` Generates the expression term part for one given connection from its Dout to one Dinexpr.
`private void`	`genExprOut(Dout_FBcl doutExpr, java.lang.String selDinElemDst, FBexpr_FBcl fbx, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion)` Generates the term due to the given expression.
`void`	`genExprSetVar(java.lang.String selDinElemDst, FBexpr_FBcl fbx, java.lang.String var, DoutExpr_FBcl doutExpr, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst sb)` Called from otx.
`private void`	`genExprTerm(OutTextPreparer.WriteDst out, java.lang.String selDinElemDst, FBexpr_FBcl fbx, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, int recursion)` Generates an expression determined by its inputs with its operators and K inputs.
`private void`	`genExprTermCmpr(OutTextPreparer.WriteDst OUT, java.lang.String selDinElemDst, FBexpr_FBcl fbx, java.lang.Iterable<DinExpr_FBcl> dinValues, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, int recursion)`
`java.lang.String`	`genInlineGetOper(Din_FBcl doutMdl, Evin_FBcl evoutMdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`java.lang.String`	`genRefIn(PinRef_FBcl din, long[] condBits, java.lang.String ref, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion)` Generates the access String for a reference of a FBlock for direct connected port output.
`java.lang.String`	`genValueDin(Din_FBcl din, long[] condBits, java.lang.String ref, java.lang.String cacc, WriterCodegen.OtxWorkData wd)` Generates the access String for an input of a FBlock maybe through some combinatoric expressions.
`void`	`genValueDout(java.lang.Iterable<FBlock_FBcl> iterFBsrc, Dout_FBcl dout, long[] condBits, java.lang.String ref, int[] ixFB, int[] ixDout, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion)` Generates the access String to data from the given output pin of any `FBlock_FBcl`, also an `FBexpr_FBcl` or a Variable after expression.
`void`	`genVarExpr(Dout_FBcl doutVar, Dout_FBcl doutExpr, FBlock_FBcl fb, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst sb)` Called in otx (VarX_OFB) to set the variable after expression or access.
`void`	`genVariableDef(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Generates a proper code for variable definitions (usual in header file) for all variables on output on expressions.
`(package private) OutTextPreparer.DataTextPreparer`	`getCreateOtxData(OutTextPreparer otx, WriterCodegen.OtxWorkData wd)` Gets the proper instance of DataTextPreparer to run `OutTextPreparer#exec(Appendable, org.vishia.util.OutTextPreparer.DataTextPreparer)` running repeatedly in the same thread.
`void`	`insertPoint(WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst OUT)`
`static java.lang.Iterable<java.lang.Integer>`	`iterBits(long[] bitArray)`
`java.lang.Iterable<PinConnect_FBcl>`	`iterConnSrcConditional(Din_FBcl din, long[] condBits, java.lang.String sVariant, int ixFBlock, WriterCodegen.OtxWorkData wd)` Wrapper around `Din_FBcl.iterConnSrcConditional(long[], long, String, int)` for code generation with argument wd instead 'mEvinMdlMask'.
`java.lang.Iterable<java.lang.String>`	`iterImportHeader(WriterCodegen.OtxWorkData wd, java.lang.String sKind)` Offers an `Iterable` for all import or header files.
`java.lang.Iterable<java.lang.String>`	`iterImportImpl()` TODO should be organized similar as `iterImportHeader(OtxWorkData, String)`
`java.lang.StringBuilder`	`newStringBuilder()`
`void`	`parseScripts(LogMessage log)` Translates the script to otx, second pass of translation It translates `idxOtx` and set `otx_callFB_evin`.
`private void`	`prc_DefineLocalVar(Evin_FBcl evinDst, Dinout_FBcl varExpr, java.util.List<Dout_FBcl> listVarOut, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Defines local variables used for FBexpr and FBlock as return and reference variables.
`private void`	`prc_setVar_DoutFBarray2Din(Dout_FBcl doutSrc, Din_FBcl dinDst, long[] condBitsSrc, Evin_FBcl evinDst, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`private void`	`prc_setVar_FBexpr(FBexpr_FBcl fbx, Evout_FBcl evSrc, Evin_FBcl evinDst, Dout_FBcl doutExpr, Dinout_FBcl varExpr, java.util.List<Dout_FBcl> listVarOut, long[] condBits, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` Generates code to set the variable(s) after expression.
`void`	`prcEvchainOperation(EvtreeNode_FBcl nodeRoot, Evout_FBcl evStartArg, Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)` This operation follows the `EvtreeNode_FBcl` from evStart to generate the code for this event as operation.
`private void`	`prcEvinFBexpr(Evout_FBcl evSrc, Evin_FBcl evinDst, long[] condBits, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst wrCt)` Process the next FBlock as FBexpr.
`private void`	`prcEvinFBlock(Evout_FBcl evinMdl, Evout_FBcl evoutSrc, Evin_FBcl evinDst, long[] condBitsSrc, java.lang.String sVariant, WriterCodegen.OtxWorkData wd, Module_FBcl mdl, OutTextPreparer.WriteDst out)` Processes one evin to one FBlock.
`private void`	`prcEvNode(Evout_FBcl evinMdl, EvtreeNode_FBcl evNode, long[] condBitsSrc, EvtreeNode_FBcl.IteratorEvoutTree iterTree, Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion)` Generates the code due to one `EvtreeNode_FBcl` called in `#prcEvchainOperation(EvtreeNode_FBcl, Evout_FBcl, Module_FBcl, OtxWorkData, Appendable)` following the event node chain.
`private void`	`prcEvNodesBranch(Evout_FBcl evinMdl, EvtreeNode_FBcl evNode, Evout_FBcl evoutSrc, Evin_FBcl XXXevin, long[][] condBits, int ixCond, WriterCodegen.OtxWorkData wd, Module_FBcl mdl, OutTextPreparer.WriteDst out, int recursion)`
`private void`	`prepareExprTextGiven(OutTextPreparer.WriteDst out, FBexpr_FBcl fbx, long[] condBits, java.lang.String ref, java.lang.String sFn, WriterCodegen.OtxWorkData wd)` Prepares any expression which is given in sFn.
`void`	`readTpl(java.lang.Class<?> classInJar, java.lang.String pathTpl, LogMessage log)` Reads the script file in the first pass It fills `idxOtx` with empty instances of otx.
`void`	`stateDefinitionHeader(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`void`	`stateDefinitionHeader1(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`void`	`stateDefinitionVars(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`void`	`stateDefinitionVars1(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out)`
`private boolean`	`testCondition(Din_FBcl din, long[] condBits)` Test whether the given condition is met on any of the source pins if more connections are given.
`private boolean`	`testCondition(Dout_FBcl doutSrc, long[] condBits)` Test whether the condition is true for the given source pin.
`void`	`testOtx(java.lang.Object... val)`
`void`	`testOtxCond(java.lang.String valTest, java.lang.String sTest, java.lang.Object... val)`
`java.lang.CharSequence`	`testPins(FBlock_FBcl fb)`
`private java.lang.String`	`translateOperatorToTargetLang(char dType, java.lang.String sGraphicOperator, java.util.Map<java.lang.String,java.lang.String> idxTrl, java.lang.String sDefault)` check whether graphic operator with specific type should be translated.
`private void`	`writeCode(java.io.File dirout, java.io.File dirCmp, java.lang.String sMdlName, FBlock_FBcl fbCalling, Module_FBcl mdl, LogMessage log)`
`void`	`writeCodeMain(Module_FBcl mdl)`
`java.lang.String`	`writeLogOtx(WriterCodegen.OtxWorkData wd, java.lang.String sId, java.lang.Object... args)`
`private void`	`writeLogPrcEnd(OutTextPreparer.WriteDst out, java.lang.CharSequence textArg, java.lang.Object... args)` Must be called as closing to `#writeLogPrcEntry(StringBuilder, String, Object...)`.
`private void`	`writeLogPrcEntry(OutTextPreparer.WriteDst out, java.lang.String text, java.lang.Object... args)`
`private void`	`writeLogPrcEntry(java.lang.String sIdLog, OutTextPreparer.WriteDst out, java.lang.String text, java.lang.Object... args)` Writes a log entry for code generation.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - version
```
public static final java.lang.String version
```
    Version, history and license.
    - 2023-12-08: Creation
    Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:
    1. You can use this source without any restriction for any desired purpose.
    2. You can redistribute copies of this source to everybody.
    3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
    4. But the LPGL is not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
    5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.
    If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.
    See Also:
    
    Constant Field Values
  - kNoLimit
```
public static final float kNoLimit
```
    See Also:
    
    Constant Field Values
  - iterDinEmpty
```
public static final java.util.List<Din_FBcl> iterDinEmpty
```
    Is used for the first evChain entry, it has the module din.
  - cmprOpReverse
```
public final java.util.Map<java.lang.String,java.lang.String> cmprOpReverse
```
    Note '>' is translated to '<=' etc. because the relation is to the input, but the operator is written left side, regarded als compare between left and this value. input > means, the input should be greater than the input before, should be translated to inputBefore <= input Note due IEC61499 '=' is equal and '<>' is not equal from graphic
  - cmprOp
```
public final java.util.Map<java.lang.String,java.lang.String> cmprOp
```
    Map operators of OFB (compatible IEC61499) to target language C/++, Java Note due IEC61499 '=' is equal and '<>' is not equal from graphic
  - numOp
```
public final java.util.Map<java.lang.String,java.lang.String> numOp
```
  - numOpFirst
```
public final java.util.Map<java.lang.String,java.lang.String> numOpFirst
```
  - unaryOp
```
public final java.util.Map<java.lang.String,java.lang.String> unaryOp
```
  - sDbgFBexpr
```
final java.lang.String sDbgFBexpr
```
  - sDbgFBexprEvin
```
final java.lang.String sDbgFBexprEvin
```
  - prj
```
final Prj_FBcl prj
```
  - logPrcBuffer
```
private java.lang.StringBuilder logPrcBuffer
```
  - oLogPrc
```
private java.io.OutputStream oLogPrc
```
  - wrLogPrc
```
private java.io.Writer wrLogPrc
```
  - logPrc
```
private LogMessage logPrc
```
  - sLineIndent
```
private java.lang.String sLineIndent
```
  - stackLogEntries
```
private java.util.Stack<WriterCodegen.LogLevel> stackLogEntries
```
    The position in the current StringBuilder for output on call of #writeLogPrcEntry(StringBuilder, String, Object...) to output the text progress in #writeLogPrcEnd(StringBuilder, String, Object...).
  - bVerboseCode
```
public boolean bVerboseCode
```
  - sNewlineIndent
```
public java.lang.String sNewlineIndent
```
  - idxOtx
```
final java.util.TreeMap<java.lang.String,OutTextPreparer> idxOtx
```
    Index with all scripts to write, filled after creation of this class calling #readTpl(Class, String). The content comes from the script as argument pathTpl.
  - idxOtxdata
```
final java.util.Map<java.lang.String,OutTextPreparer.DataTextPreparer> idxOtxdata
```
  - idxImportImpl
```
final java.util.Map<java.lang.String,java.lang.String> idxImportImpl
```
  - aliasImport
```
private AliasImport_FBcl aliasImport
```
  - idxConstData
```
final java.util.Map<java.lang.String,java.lang.Object> idxConstData
```
    This map can be filled by the script especially with String-String associations. It uses the <:set:name:value> capability in a template. Especially the extensions for the files for more as one output files for code generation are contained here with the names "CodeGen..." where "..." is 1, 2 etc.
  - otx_callFB_evin
```
OutTextPreparer otx_callFB_evin
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_ctorFB_evin
```
OutTextPreparer otx_ctorFB_evin
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_ctorObjFB_evin
```
OutTextPreparer otx_ctorObjFB_evin
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_initFB_evin
```
OutTextPreparer otx_initFB_evin
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otxEvChainExprSetvar
```
OutTextPreparer otxEvChainExprSetvar
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_exprTerm
```
OutTextPreparer otx_exprTerm
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_exprAccessElement
```
OutTextPreparer otx_exprAccessElement
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setVar_FBexpr
```
OutTextPreparer otx_setVar_FBexpr
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_defineLocalVar_FBexpr
```
OutTextPreparer otx_defineLocalVar_FBexpr
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setVar_DoutFBarray2Din
```
OutTextPreparer otx_setVar_DoutFBarray2Din
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_evMdlOutStart
```
OutTextPreparer otx_evMdlOutStart
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_evMdlOutEnd
```
OutTextPreparer otx_evMdlOutEnd
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setMdlOutScalar
```
OutTextPreparer otx_setMdlOutScalar
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setMdlOutArrayCpy
```
OutTextPreparer otx_setMdlOutArrayCpy
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setMdlOutArrayExpr
```
OutTextPreparer otx_setMdlOutArrayExpr
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setMdlOutStructCpy
```
OutTextPreparer otx_setMdlOutStructCpy
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otxAccessFBdout
```
OutTextPreparer otxAccessFBdout
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setVarStruct
```
OutTextPreparer otx_setVarStruct
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setVarArrayElem
```
OutTextPreparer otx_setVarArrayElem
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setVarX_Array
```
OutTextPreparer otx_setVarX_Array
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otx_setVarX_Elem
```
OutTextPreparer otx_setVarX_Elem
```
    This is the important OutTextPreparer for one event chain member proper to #prcEvChain(Evin_FBcl, Integer, Writer).
  - otxExprEv_OFB_Variable
```
OutTextPreparer otxExprEv_OFB_Variable
```
    Called if an event output true is found. See #prcEvchainOperation(Evout_FBcl, Module_FBcl, Appendable)
  - otxExprIf
```
OutTextPreparer otxExprIf
```
    Called if an event output true is found. See #prcEvchainOperation(Evout_FBcl, Module_FBcl, Appendable)
  - XXXotx_exprSetCond
```
OutTextPreparer XXXotx_exprSetCond
```
    Called if an event output true is found.
  - otx_exprCondIf
```
OutTextPreparer otx_exprCondIf
```
    Called if an event output true is found.
  - otxExprElse
```
OutTextPreparer otxExprElse
```
    Called if an event output true is found.
  - otx_exprCondBitsIf
```
OutTextPreparer otx_exprCondBitsIf
```
    Called if a condition bit change is found.
  - otxExprCondBitsEndif
```
OutTextPreparer otxExprCondBitsEndif
```
    Called if a condition bit change is found.
  - otxExprEndif
```
OutTextPreparer otxExprEndif
```
    Called if the chain of an event output true is finished, means the next event given before executing the "true" is found, or on end of all events. See #prcEvchainOperation(Evout_FBcl, Module_FBcl, Appendable)
  - otx_castValExprLim_SFd
```
OutTextPreparer otx_castValExprLim_SFd
```
  - mdl
```
private Module_FBcl mdl
```
  - testData
```
java.lang.String testData
```
- Constructor Detail
  - WriterCodegen
```
public WriterCodegen(Prj_FBcl prj)
```
- Method Detail
  - debug
```
public void debug(java.lang.Object val1)
```
    It can be used to set a debug stop point in an otx script. Call there: <:exec:debug(val)>
  - debug4
```
public void debug4(java.lang.Object val1,
                   java.lang.Object val2,
                   java.lang.Object val3,
                   java.lang.Object val4)
```
    It can be used to set a debug stop point in an otx script. Call there: <:exec:debug(val, val, val, val)>
  - testOtx
```
public void testOtx(java.lang.Object... val)
```
  - testOtxCond
```
public void testOtxCond(java.lang.String valTest,
                        java.lang.String sTest,
                        java.lang.Object... val)
```
  - iterBits
```
public static java.lang.Iterable<java.lang.Integer> iterBits(long[] bitArray)
```
  - readTpl
```
public void readTpl(java.lang.Class<?> classInJar,
                    java.lang.String pathTpl,
                    LogMessage log)
```
    Reads the script file in the first pass It fills idxOtx with empty instances of otx.
    
    Parameters:
    
    classInJar - given then read from jar-File, null: read as file
    
    pathTpl - relative path to classInJar or path in file system
    
    Throws:
    
    java.io.IOException
    
    java.text.ParseException
  - parseScripts
```
public void parseScripts(LogMessage log)
```
    Translates the script to otx, second pass of translation It translates idxOtx and set otx_callFB_evin.
    
    Throws:
    
    java.text.ParseException
  - writeCodeMain
```
public void writeCodeMain(Module_FBcl mdl)
```
  - writeCode
```
private void writeCode(java.io.File dirout,
                       java.io.File dirCmp,
                       java.lang.String sMdlName,
                       FBlock_FBcl fbCalling,
                       Module_FBcl mdl,
                       LogMessage log)
```
    Parameters:
    
    dirout - output directory for the generated file
    
    dirCmp - directory where the same files are existing from generation before, to compare
    
    sMdlName -
    
    fbCalling - The FBlock from which the module generation is called. It can contain actual DType_FBcl referenced via FBlock_FBcl.dTypes. This FBlock should reference the module which should be generated, via FBlock_FBcl.fbt and then FBtype_FBcl.mdl.
    
    log -
  - iterImportHeader
```
public java.lang.Iterable<java.lang.String> iterImportHeader(WriterCodegen.OtxWorkData wd,
                                                             java.lang.String sKind)
```
    Offers an Iterable for all import or header files. The container for the Iterable is build on demand. It iterates over all Module_FBcl.iterFBlock(), detects their FBlock_FBcl.typeName() regarding also dedication of non dedicated FBtype, and looks for the header in aliasImport.
    
    Parameters:
    
    wd - working data
    
    sKind - kind of import or header
    
    Returns:
    
    iterator usable in otx: <:for:header:iterImportHeader(wd, 'h')>...
  - iterImportImpl
```
public java.lang.Iterable<java.lang.String> iterImportImpl()
```
    TODO should be organized similar as iterImportHeader(OtxWorkData, String)
    
    Returns:
  - addImportToPrj
```
public void addImportToPrj(java.lang.String sNameModule,
                           java.lang.String sKind,
                           java.lang.String sImportPath)
```
    Adds the own header of the module to the project wide alias-header- Prj_FBcl.codegenTypeReplace So that usage of this Module FBtype imports the header.
    
    Parameters:
    
    sNameModule - identifier of the FBtype is the name of the module.
    
    sKind - kind of header for key in AliasImport_FBcl.Elem#importsType
    
    sImportPath - The path as should be used in relation with the sKind.
  - insertPoint
```
public void insertPoint(WriterCodegen.OtxWorkData wd,
                        OutTextPreparer.WriteDst OUT)
                 throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - doInsert
```
public void doInsert(WriterCodegen.OtxWorkData wd,
                     OutTextPreparer.WriteDst OUT)
```
  - checkSetLocalVariable
```
public boolean checkSetLocalVariable(java.lang.String name,
                                     WriterCodegen.OtxWorkData wd)
```
  - getCreateOtxData
```
OutTextPreparer.DataTextPreparer getCreateOtxData(OutTextPreparer otx,
                                                  WriterCodegen.OtxWorkData wd)
```
    Gets the proper instance of DataTextPreparer to run OutTextPreparer#exec(Appendable, org.vishia.util.OutTextPreparer.DataTextPreparer) running repeatedly in the same thread. Hint: For more as one thread use different instances. Use the threadId also as key.
    
    Parameters:
    
    otx -
    
    Returns:
    
    data instance for the exec(...) call.
  - testPins
```
public java.lang.CharSequence testPins(FBlock_FBcl fb)
```
  - genVariableDef
```
public void genVariableDef(Module_FBcl mdl,
                           WriterCodegen.OtxWorkData wd,
                           OutTextPreparer.WriteDst out)
                    throws java.io.IOException
```
    Generates a proper code for variable definitions (usual in header file) for all variables on output on expressions. It iterates through all FBlocks, look whether FBlock_FBcl.kind() is == FBlock_FBcl.Blocktype#VarAfterExpr and then calls the otx script with the type name of the FBlock_FBcl.typeName() following by "_h".
    It is <otx: VarZ_OFB_h ... or <otx: VarV_OFB_h ... or <otx: VarL_OFB_h ... whereby 'VarL_OFB' is a local variable, should not create a variable definition here, but can be used as comment docu line.
    If the type is not found, otx:otxUndefFB_h is used.
    
    Parameters:
    
    mdl - Module's data
    
    out - to write the source code
    
    Throws:
    
    java.io.IOException
  - prcEvchainOperation
```
public void prcEvchainOperation(EvtreeNode_FBcl nodeRoot,
                                Evout_FBcl evStartArg,
                                Module_FBcl mdl,
                                WriterCodegen.OtxWorkData wd,
                                OutTextPreparer.WriteDst out)
                         throws java.io.IOException
```
    This operation follows the EvtreeNode_FBcl from evStart to generate the code for this event as operation. This routine should be called inside the otx script for the implementation code.
    
    Parameters:
    
    evStart - The event which is the start event of the operation.
    
    mdl - The module data
    
    out - Output. It is anytime a StringBuilder, needs insertion points.
    
    Throws:
    
    java.io.IOException
  - prcEvNode
```
private void prcEvNode(Evout_FBcl evinMdl,
                       EvtreeNode_FBcl evNode,
                       long[] condBitsSrc,
                       EvtreeNode_FBcl.IteratorEvoutTree iterTree,
                       Module_FBcl mdl,
                       WriterCodegen.OtxWorkData wd,
                       OutTextPreparer.WriteDst out,
                       int recursion)
                throws java.io.IOException
```
    Generates the code due to one EvtreeNode_FBcl called in #prcEvchainOperation(EvtreeNode_FBcl, Evout_FBcl, Module_FBcl, OtxWorkData, Appendable) following the event node chain. This follows the connection between two FBlocks or the module's evinMdl and evoutMdl.
    
    Parameters:
    
    evinMdl - The modules evin or the evin on start of this event chain
    
    evNode - the TreeNode with the evin to the FBlock
    
    condBitsSrc - null or maybe given bits for conditions, which are checked with input data.
    
    iterTree - The iterator where the evNode is gotten from. Used to continue on sibling etc. if conditions given
    
    mdl - The module
    
    wd -
    
    out -
    
    recursion -
    
    Throws:
    
    java.io.IOException
  - prcEvNodesBranch
```
private void prcEvNodesBranch(Evout_FBcl evinMdl,
                              EvtreeNode_FBcl evNode,
                              Evout_FBcl evoutSrc,
                              Evin_FBcl XXXevin,
                              long[][] condBits,
                              int ixCond,
                              WriterCodegen.OtxWorkData wd,
                              Module_FBcl mdl,
                              OutTextPreparer.WriteDst out,
                              int recursion)
                       throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - prcEvinFBlock
```
private void prcEvinFBlock(Evout_FBcl evinMdl,
                           Evout_FBcl evoutSrc,
                           Evin_FBcl evinDst,
                           long[] condBitsSrc,
                           java.lang.String sVariant,
                           WriterCodegen.OtxWorkData wd,
                           Module_FBcl mdl,
                           OutTextPreparer.WriteDst out)
                    throws java.io.IOException
```
    Processes one evin to one FBlock. This operation is only called in #prcEvchainOperation(Evout_FBcl, Module_FBcl, OtxWorkData, StringBuilder) for each event from the queue. It calls one of the described processing in the given order of the following list:
    - It checks whether the FBlock_FBcl of the 'evinDst' is an array of FBlocks calling FBlock_FBcl.sizeArray().
    - But this is not done on FBexpr_FBcl because for an FBexpr first the following variable or also doutMdl is relevant. For FBexpr as array of FBlocks this is an array DType. The FBexpr is only called backward as expression lines. The variable after expression is relevant for processing. Hence FBlock_FBcl.sizeArray() should not play a role. It is ignored for FBexpr.
    The for loop is executed with 'ixFBlock' =-1, if the FBlock is not given as array. Then also 'zBlocks' is =1, hence the for loop is only executed one time. For given 'sizeArrayFBlock' it is executed for any FBlock (not for FBexpr).
    In the for loop it is executed:
    - First it checks whether a proper otx script with the FBlock_FBcl.typeName() is existing. Means, specific FBtype_FBcl can have there own source code generation script. The script is called with the arguments:
      fb The FBlock_FBcl itself due to evin.fb
      din Din_FBcl, the first din if given, or null if the fb has not an input. This helps on some simple FBlocks to access
      dout Dout_FBcl, the first output if given, or null if the fb has not an output. This helps on some simple FBlocks to access
      douttype. DoutType_FBcl, This helps on some simple FBlocks to access
      evin Evin_FBcl the evinDst as argument of this operation, it is the original given evin from the event queue
      evSrc Evout_FBcl the evSrc as argument of this operation, it is the source of the evin usable for comments in source code.
    - For FBlock_FBcl.kind() == FBlock_FBcl.Blocktype#VarAfterExpr and the update pin is reached, in that kind point above <otx: VarZ_OFB_upd... is called for update source code. with the arguments shown in the point before.
    - If the current FBlock is a FBaccess_FBcl then #prcEvinFBaccess(Evout_FBcl, Evin_FBcl, List, Map, Appendable) is called, see there.
    - If the FBlock is in the Module_FBcl.idxFBlockTEST, then normally no code generation should be done for it in this operation. But on option -verbodeCode the <otx: infoFBtest ... is called to get an info about this FBlock as part of the event queue.
    - If the evinDst is a output event of the module (PinKind_FBcl.isModulePin()) then <otx: evChainMdlOut... is called with the arguments
      iterDin Evin_FBcl.iterAssocDin() all inputs to this event.
      evout it is evoutSrc of this operation parameter
      evin it is evinDst of this operation parameter
    - else: First an otx-Script with the name of the evinDst and "FB_evin" is searched. This is especially for "initFB_evin", "ctorFB_evin" and also "ctorObjFB_evin", or possible for more specific evin names. If this is not found, <otx: callFB_evin:... is searched and should be found. This found otx is called with the same arguments as <otx: evChainMdlOut..., iterDin, evout and evin.
    After processing the FBlock, after proper code generation, the correspond evout to the evin is put in the queueEvSrc.
    - For Join, it depends from fulfilling of the events to join, as described above.
    - For a TEST FBlock (member of Module_FBcl.idxFBlockTEST) evout are not considerate.
    - For all other FBlock, the FBlock_FBcl.iterEvout(Evin_FBcl) is called to get the correspond evout, and they are put in the queue calling #addEventNextAll(List, Evin_FBcl, Appendable) to generate the code for this FBlocks afterwards in the event order. The event order is firstly regard immediately following events, later parallel events. This is done by "last in first out" organization of the queue.
    Parameters:
    
    evoutSrc - The source of this evin, only used for comment
    
    evinDst - the evin to process
    
    queueEvSrc - queue to add following evout of the FBlock.
    
    idxEvStartChainCodegen - Hash Map stores the already used events for codeGen to prevent twice or circular code generation, may be caused only by an software error
    
    mdl - The module's data
    
    out - output for source code
    
    Throws:
    
    java.io.IOException
  - prcEvinFBexpr
```
private void prcEvinFBexpr(Evout_FBcl evSrc,
                           Evin_FBcl evinDst,
                           long[] condBits,
                           WriterCodegen.OtxWorkData wd,
                           OutTextPreparer.WriteDst wrCt)
                    throws java.io.IOException
```
    Process the next FBlock as FBexpr. This operation is only called in #prcEvinFBlock(Evout_FBcl, Evout_FBcl, Evin_FBcl, long[], String, OtxWorkData, Module_FBcl, Appendable) only if FBexpr_FBcl.cAccess() is '$' or '='. It is FBexpr_FBcl.cAccess which is also given the first character in din[0] able to see in FBcl presentation as constant initializer of 'expr'. If it is not so, the expression is generated as inline access, done backward from inputs, which calls #genExprTerm(StringBuilder, String, FBexpr_FBcl, long[], String, int, String, OtxWorkData, int) maybe with the correct component on complex or comprehensive types.
    
    The expression can have more as one output variable. If that are local ones, they are created as local variable inside the script <otx: setVar_FBexpr....
    The otx script is called with
    - evSrc Evout_FBcl only for comment
    - evinDst Evin_FBcl of the FBexpr
    - fbx FBexpr_FBcl the FBexpr itself
    - cOp char the FBexpr_FBcl#getOperation()
    - iterVout List with all outputs which are variable after the expression generated as local ones as PinKind_FBcl.Dout
    - varExpr FBlock_FBcl the FBlock of the variable after the dout which is type of DoutExpr_FBcl. It is null if the expression has not a connection on its DoutExpr_FBcl. Note: All other outputs of the expression are only Dout_FBcl.
    - doutExpr the DoutExpr_FBcl
    Parameters:
    
    evSrc - the evout before this FBlock, only for comment
    
    evinDst - the relevant prep evin of the FBlock
    
    queueEvSrc - queue to add new driven events
    
    idxEvStartChainCodegen - Hash Map stores the already used events for codeGen to prevent twice or circular code generation, may be caused only by an software error
    
    wr - output
    
    Throws:
    
    java.io.IOException
  - prc_DefineLocalVar
```
private void prc_DefineLocalVar(Evin_FBcl evinDst,
                                Dinout_FBcl varExpr,
                                java.util.List<Dout_FBcl> listVarOut,
                                WriterCodegen.OtxWorkData wd,
                                OutTextPreparer.WriteDst out)
                         throws java.io.IOException
```
    Defines local variables used for FBexpr and FBlock as return and reference variables. It uses otx_defineLocalVar_FBexpr.
    
    Parameters:
    
    evinDst - Only for comment in code.
    
    varExpr - It is possible that DoutMdl will be applied, hence Din_FBcl should be admissible.
    
    listVarOut - list of reference variables
    
    wd -
    
    out -
    
    Throws:
    
    java.io.IOException
  - prc_setVar_FBexpr
```
private void prc_setVar_FBexpr(FBexpr_FBcl fbx,
                               Evout_FBcl evSrc,
                               Evin_FBcl evinDst,
                               Dout_FBcl doutExpr,
                               Dinout_FBcl varExpr,
                               java.util.List<Dout_FBcl> listVarOut,
                               long[] condBits,
                               WriterCodegen.OtxWorkData wd,
                               OutTextPreparer.WriteDst out)
                        throws java.io.IOException
```
    Generates code to set the variable(s) after expression. This is the only one operation which calls otx otx_defineLocalVar_FBexpr, otx_setVar_FBexpr . This is an expression marked with FBexpr_FBcl.cAccess == one of "$=". The proper expression is detect in EvoutTreePrc_FBcl. This operation is called from #prcEvinFBexpr(Evout_FBcl, Evin_FBcl, long[], OtxWorkData, Appendable) and from #prcEvinFBlock(Evout_FBcl, Evout_FBcl, Evin_FBcl, long[], String, OtxWorkData, Module_FBcl, Appendable).
    The otx: setVar_FBexpr calls internally #genExprOut(Dout_FBcl, String, FBexpr_FBcl, long[], String, int, String, OtxWorkData, StringBuilder, int) For debug set a breakpoint there.
    
    Parameters:
    
    fbx -
    
    evSrc -
    
    evinDst -
    
    doutExpr - The output of the expression itself, it is usual a
    
    varExpr - The variable after the expression. It can be either a module's output, which is an Din_FBcl, an referenced input of a FbLock, or also the variable after expression given as Dout_FBcl.
    
    listVarOut - a list of variable which are used in the expression and which should be defined as stack local variable.
    
    condBits - to access inputs, the condition from the evSrc
    
    wd -
    
    out -
    
    Throws:
    
    java.io.IOException
  - prc_setVar_DoutFBarray2Din
```
private void prc_setVar_DoutFBarray2Din(Dout_FBcl doutSrc,
                                        Din_FBcl dinDst,
                                        long[] condBitsSrc,
                                        Evin_FBcl evinDst,
                                        WriterCodegen.OtxWorkData wd,
                                        OutTextPreparer.WriteDst out)
                                 throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - callFBoper
```
private void callFBoper(FBexpr_FBcl fbx,
                        long[] condBits,
                        Dout_FBcl dout,
                        WriterCodegen.OtxWorkData wd,
                        OutTextPreparer.WriteDst wrCt)
                 throws java.io.IOException
```
    Generates the code for a called operation of an FBexpr as FBoper if it contains a FBexpr_FBcl.getFunction().
    
    Note: The function can be contained in the expression either as text in the ofbExpression box or also as text in an Dout_FBcl of the expression. Note: Intrinsically this operation should be hold in the EvinType_FBcl pin but this is not possible because the expression is not determined by the type. Or think about, a special type is created for a specific expression since 2024-07-26 also because different data types.
    
    If the expression contains a FBlock_FBcl.reference pin, then it is the reference to the associated FBlock where this operation is a member of. Hence the operation of the type is called, with the reference as this pointer.
    
    If the expression does not contain a reference, it is a static operation, should be able to find by name in the target language.
    
    If the expression contains more outputs than the given dout argument, then that are output reference variables (call by reference) to store the output values in. In C/++ that are usual pointers to local or variables of the module- In Java that are usual arrays with the [0] element as reference.
    
    Parameters:
    
    fbx - The FBoper
    
    dout - presents the value of the expression, all other outputs are call by value arguments.
    
    wr - to write the code.
    
    Throws:
    
    java.io.IOException
  - genInlineGetOper
```
public java.lang.String genInlineGetOper(Din_FBcl doutMdl,
                                         Evin_FBcl evoutMdl,
                                         WriterCodegen.OtxWorkData wd,
                                         OutTextPreparer.WriteDst out)
                                  throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - genEventOperHeader
```
public java.lang.String genEventOperHeader(Evout_FBcl evinMdl,
                                           WriterCodegen.OtxWorkData wd,
                                           OutTextPreparer.WriteDst out)
                                    throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - genEventOperBody
```
public java.lang.String genEventOperBody(EvtreeNode_FBcl rootNode,
                                         Module_FBcl mdl,
                                         WriterCodegen.OtxWorkData wd,
                                         OutTextPreparer.WriteDst out)
                                  throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - genValueDin
```
public java.lang.String genValueDin(Din_FBcl din,
                                    long[] condBits,
                                    java.lang.String ref,
                                    java.lang.String cacc,
                                    WriterCodegen.OtxWorkData wd)
                             throws java.io.IOException
```
    Generates the access String for an input of a FBlock maybe through some combinatoric expressions. This operation is called from the otx script: <:set:dinVar=genValueDin(fbx.din[1],'', 0)> This example shows set a access variable string with generated access code to use it to set the components of the variable. Also it is called inside #prepareExprTextGiven(Appendable, FBexpr_FBcl, String) to replace the X1.. variables with the code on inputs. Hence the content is not immediately written for the code generation, instead it is prepared in a StringBuilder and returned as String to use. It calls #genValueDout(Dout_FBcl, String, Appendable, int) with this StringBuilder if the input has a connection to an output. Non connected input constant values are immediately returned.
    Parameters: din - The data input which is connected to any output or it has a Din_FBcl.sConstant cacc - access to an element of an input variable, for example ".re" or "[1]" ref - reference to the module data, it is often "thiz" inside the module, or a specific reference variable Returns: String as part of this access code. Throws: java.io.IOException
  genConstantValue public java.lang.String genConstantValue(Din_FBcl din, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Generates the const value string with given Din_FBcl.sConstant and also given Din_FBcl.dTypeCastInp as detected type of the constant, tuned to the Dinout_FBcl.dTypeDecl(), the type of the pin itself. For some combinations 'otx:castValue_TC' is called, whereby here 'T' stands for the target necessary DTypeBase_FBcl.typeChar stored in Dinout_FBcl.dTypeDecl() and 'C' stands for the given DType of the constant typeChar stored in Din_FBcl.dTypeCastInp. For example 'otx:castValue_FD' presents a float constant, in C/++ with following f. "3.14" given in graphic will be presented by "3.14f" in the generated code. The otx script should be written with arguments: This otx scripts can be also used to convert for example a constant given in float/double presentation to a integer presentation necessary for target code with a determined number of fractional bits stored in DTypeBase_FBcl.zBitFrac. Then it converts for example for Pin Dtype "S.8" (short, 8 bits fractional) a constant 1.25 via '(int16)( (1L<<8) * 1.25f)' to a value 0x0140. Parameters: din - The input which may have a Din_FBcl.sConstant. If not, nothing is done. wd - Working data sb - If given then write the text in this StringBuilder, and return null. Returns: if sb ==null, then returns the generated presentation as String. Throws: java.io.IOException genDinAccessLimit public java.lang.String genDinAccessLimit(Din_FBcl din, PinConnect_FBcl conn, long[] condBits, java.lang.String sVariant, java.lang.String ref, int ixFBlock, java.lang.String cacc, float max, float min, boolean bOnlyOne, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Generates the access String for an input of any FBlock. This is called only inside the otx script for code generation. Hence should be public. It is called for ordinary FBlocks as also for Expression inputs and module's outputs. If the din is an DinExpr_FBcl, this is an input of an FBexpr_FBcl, then #genExprIn(DinExpr_FBcl, FBexpr_FBcl, String, String, Appendable, int) is called. This regards also the K.. input of an expression. otherwise, it is tested whether the input is connected to any Dout_FBcl as source for the input. If yes, It is also a type cast and an access to a struct or array element can be contained in the input string. This is regarded here. Then with the doutSrc #genValueDout(Dout_FBcl, String, String, Appendable, int) is called. If the input is not connected, but contains a constant value gotten with Din_FBcl.getConstant() then this constant value is used for the generated code for this input. For that #genConstantValue(Din_FBcl, OtxWorkData, StringBuilder) is called which adapts the given constant String to the necessary target language presentation. for example to create "3.14f" in C/++ code as float designation if "3.14" is given. If the input is not connected but also does not contain a constant, the constant "0" is used, maybe TODO adapted to the correct type. or also for direct connected state outputs and constants. This operation is used frequently in otx scripts. It calls #genValueDout(Dout_FBcl, String, int) from the connected source or taks the Din_FBcl.sConstant Parameters: din - The data input which is delivered from any output or it has a Din_FBcl.sConstant conn - null or the specific connection from din. Then conn: PinConnect_FBcl.pinDst should == din. condBits - sVariant - ref - reference to the module data for the source of din, it is often "thiz" inside the module, or a specific reference variable ixFBlock - -1 or the index of a FBlock from a for loop counted till FBlock_FBcl.sizeArray(int) cacc - access to an element of an input variable, for example ".re" or "[1]" wd - out - the buffer to write the generated source code Returns: empty String "" or an error message. This is written after the produced output to out from the OutTextPreparer algorithm. An empty string produces no more output, but the error message occurs in the generated code and can be manually understand. It should produce a compiler error then on compiling the generated sources. Throws: java.io.IOException genDinAccess public java.lang.String genDinAccess(Din_FBcl din, PinConnect_FBcl conn, long[] condBits, java.lang.String sVariant, java.lang.String ref, int ixFBlock, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Compatible form see #genDinAccessLimit(Din_FBcl, PinConnect_FBcl, long[], String, String, int, String, float, float, OtxWorkData, StringBuilder) especially used in otx script, where limitation is not a topic. Throws: java.io.IOException checkConnUse private static boolean checkConnUse(PinConnect_FBcl connSrc, long mEvinMdlMask, int ixFBlock, java.lang.String sVariant) Deprecated. use #iterConnSrcConditional(Din_FBcl, long[]) Checks whether a given PinConnect_FBcl on a din should be used for this source code expression. Parameters: connSrc - the given connection ixFBlock - >=0 then the dinAccess is in a for-loop of indexed accesses. Then the PinConnect_FBcl.sElemDst should contain [ix] with the same ix value then ixFBlock. Then it is used. sVariant - if given !=null then the PinConnect_FBcl#sVariant should be the same. The sVariant comes from arguments. Returns: genDinAccessConnLimit public void genDinAccessConnLimit(Din_FBcl dinDst, PinConnect_FBcl connSrc, java.lang.String cacc, int ixFBlock, long[] condBits, java.lang.String ref, float max, float min, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Generates the code for a given Din_FBcl for a given connection PinConnect_FBcl Parameters: dinDst - It is the same as connSrc: PinConnect_FBcl.pinDst connSrc - the given connection between dout and din cacc - access string to the ixFBlock - -1 or the index of a FBlock from a for loop counted till FBlock_FBcl.sizeArray(int) condBits - the condition bits necessary for backward selection of dout for inline expressions ref - wd - Write data out - The output where to write the code. Throws: java.io.IOException genRefIn public java.lang.String genRefIn(PinRef_FBcl din, long[] condBits, java.lang.String ref, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion) Generates the access String for a reference of a FBlock for direct connected port output. This operation is used frequently in otx scripts. It calls #genValueDout(Dout_FBcl, String, int) from the connected source, that is a PinPort_FBcl returnd by PinRef_FBcl.getConnPort() or takes the Din_FBcl.sConstant Parameters: din - The data input which is delivered from any output or it has a Din_FBcl.sConstant cacc - access to an element of an input variable, for example ".re" or "[1]" ref - reference to the module data, it is often "thiz" inside the module, or a specific reference variable recursion - Returns: empty String "" or an error message. This is written after the produced output to out from the OutTextPreparer algorithm genValueDout public void genValueDout(java.lang.Iterable<FBlock_FBcl> iterFBsrc, Dout_FBcl dout, long[] condBits, java.lang.String ref, int[] ixFB, int[] ixDout, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion) throws java.io.IOException Generates the access String to data from the given output pin of any FBlock_FBcl, also an FBexpr_FBcl or a Variable after expression. First it is checked whether the given dout is an output of a specific FBtype. An otx script with the <typeName>_acc is searched. This is espcially for VarL_OFB_acc etc. to access the output of variables as output of an expression. Else it is tested whether this dout is a module's input pin. Its name is used immediately. For code generation this is correct if the module's input is used with the same event and hence it is part of the argument list of this generated operation. Else it checks whether the dout is an DoutExpr_FBcl, then #genExprOut(Dout_FBcl, FBexpr_FBcl, String, String, HashMap, Appendable, int) is called which regards all possibilies of expressions in the graphic. At least it is checked whether the dout.name is "THIS", means it is the whole FBlock as port reference. Then <otx: doutAccessThis ... is called, else <otx: doutAccessThis ... , with the following arguments: sEvout String, name of the event for the dout dout the dout itself from argument fb FBlock_FBcl from dout.fb fbtName type name of the FBlock_FBcl.typeName() ref as given as argument of this operation cacc as given as argument of this operation It should access the output of any FBlock. The simplest form presumes, that the output is part of a struct of the FBlock. It can be adapted in the otx script. Parameters: dout - The data output which delivers a value condBits - ref - reference to the module data, it is often "thiz" inside the module, or a specific reference variable ixFB - null or possible index to the FBlock instance ixDout - null or possible index to the element of the out variable. cacc - access to an element of an input variable, for example ".re" or "[1]" wd - out - StringBuilder to write in recursion - Throws: java.io.IOException genVarExpr public void genVarExpr(Dout_FBcl doutVar, Dout_FBcl doutExpr, FBlock_FBcl fb, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst sb) throws java.io.IOException Called in otx (VarX_OFB) to set the variable after expression or access. Parameters: doutExpr - fb - condBits - ref - ix - cacc - wd - sb - recursion - Throws: java.io.IOException genExprOut private void genExprOut(Dout_FBcl doutExpr, java.lang.String selDinElemDst, FBexpr_FBcl fbx, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion) throws java.io.IOException Generates the term due to the given expression. First it depends from the operation of the expression FBexpr_FBcl#getOperation() or FBexpr_FBcl.cOp what is done: '$' = : FBexpr_FBcl.cOpTextExpr The expression has an expression text given in the FBexpr shape. This is handled by the specific #prepareExprTextGiven(Appendable, FBexpr_FBcl, String, String). '(': The FBexpr has named a function in its DoutExpr_FBcl (from the ofpExprOut pin style in odg diagram). In this case param doutExpr may be null if the ofpExprOut is not connected. This is detected by a before called #setVar_FBexpr(FBexpr_FBcl, Evout_FBcl, Evin_FBcl, Evout_FBcl, Appendable) to define expression output variables. In this case either for the given FBexpr_FBcl.getFunction() a specific otx script is found, then it is executed with the arguments: sName String, the name in FBexpr_FBcl#getOperation() till the opened '('. fbx FBexpr_FBcl the expression cacc String, usual "" but possible set if an element of the output result should be accessed. This is not a normal case. If a otx for the function is not found, then #callFBoper(FBexpr_FBcl, Dout_FBcl, Appendable) is executed. All other operators are used for ordinary expression terms, executed with #genExprTerm(StringBuilder, String, FBexpr_FBcl, long[], String, int, String, OtxWorkData, int). The doutExpr should be given, not null. It is possible that some more output variables are set in the term in C/++ as "call by reference". It is possible that one reference input is given in the expression, then it is an operation of the referenced FBlock, hence a FBoper. In the otx script it is the argument "THIZ" It is possible that either some Parameters: doutExpr - It is the dout connected to either any input or to the variable which presents this output in the graphic. It can be null if one of the FBlock_FBcl.dout is type of DoutExpr_FBcl but has no connection, or it is null if all FBlock_FBcl.dout has variables on its outputs, hence the type of FBlock_FBcl.dout is only Dout_FBcl, and not DoutExpr_FBcl. This is detected by the before called #setVar_FBexpr(FBexpr_FBcl, Evout_FBcl, Evin_FBcl, Evout_FBcl, Appendable) selDinElemDst - to select DinExpr due to PinConnect_FBcl#elemDst ix - if >=0 then doutExpr is an array, which is evaluated in the otx script. This is the index while evaluation. It is used also as index for inputs with the same array properties. fbx - The expression ref - reference to the module data, it is often "thiz" inside the module, or a specific reference variable cacc - optional an access string added to any data input out - output buffer. Throws: java.io.IOException genExprSetVar public void genExprSetVar(java.lang.String selDinElemDst, FBexpr_FBcl fbx, java.lang.String var, DoutExpr_FBcl doutExpr, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst sb) throws java.io.IOException Called from otx. It is the code to set internal variables as variable after expression. It checks first whether the FBexpr has a limitation or saturation, if 'min' or 'max' pin exists. If yes, it needs specific code with saturation macros in C/++. For that the specific otx scripts for ADD and MUL are called. If no saturation, then the script otx: setVarExprNoSaturation is called which calls yet the same as in the past: #genExprOut(Dout_FBcl, String, FBexpr_FBcl, long[], String, int, String, OtxWorkData, StringBuilder, int). Parameters: selDinElemDst - fbx - var - doutExpr - condBits - ref - ix - cacc - wd - sb - Throws: java.io.IOException genExprTerm private void genExprTerm(OutTextPreparer.WriteDst out, java.lang.String selDinElemDst, FBexpr_FBcl fbx, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, int recursion) throws java.io.IOException Generates an expression determined by its inputs with its operators and K inputs. Parameters: out - the output, usual a StringBuilder fbx - the FBexpr itself ref - reference to the module data, it is often "thiz" inside the module, or a specific reference variable cacc - additional access String to access each the same sub element (".re", ".im", "[ix]") recursion - Throws: java.io.IOException translateOperatorToTargetLang private java.lang.String translateOperatorToTargetLang(char dType, java.lang.String sGraphicOperator, java.util.Map<java.lang.String,java.lang.String> idxTrl, java.lang.String sDefault) check whether graphic operator with specific type should be translated. Parameters: dType - The data type chacter sGraphicOperator - given operator in graphic idxTrl - translator map. key may be dType + sGraphicOperator or only sGraphicOperator Returns: either found dType + sGraphicOperator, or only found sGraphicOperator translation, or sGraphicOperator non translated if not found. genExprTermCmpr private void genExprTermCmpr(OutTextPreparer.WriteDst OUT, java.lang.String selDinElemDst, FBexpr_FBcl fbx, java.lang.Iterable<DinExpr_FBcl> dinValues, long[] condBits, java.lang.String ref, int ix, java.lang.String cacc, WriterCodegen.OtxWorkData wd, int recursion) throws java.io.IOException Throws: java.io.IOException genExprIn private void genExprIn(DinExpr_FBcl din, FBexpr_FBcl fbx, long[] condBits, java.lang.String sOperatorLeftArg, java.lang.String sOperator, java.lang.String sUnaryOp, java.lang.String ref, int ix, java.lang.String caccArg, float max, float min, boolean bOnlyOne, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion) throws java.io.IOException Generate the code of an expression input regarding constant values and K parts. The operator and also the unary operator is not regarded here. TODO handling unary operator. Parameters: din - One of the expression input fbx - of this FBexpr condBits - sOperatorLeftArg - sOperator - sUnaryOp - ref - reference to the module data, it is often "thiz" inside the module, or a specific reference variable ix - -1 or >=0 if the expression is used as array expression. caccArg - possible access to component of variables max - if not Float.NaN then use as limitation for the input. min - if not Float.NaN then use as limitation for the input. bOnlyOne - true then this is the only one input, used for input limitation. wd - out - output recursion - Throws: java.io.IOException genDinConnAcc public void genDinConnAcc(Din_FBcl din, PinConnect_FBcl conn, java.lang.String cacc, int ixFBlock, long[] condBits, int[] ixFBArg, java.lang.String ref, java.lang.String sSat, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Generates the code for one connected Dout for Din_FBcl, also for DinExpr_FBcl or also for the const value of Din_FBcl.sConstant if given. This is the most frequently used operation called in otx to write the Din target code. Parameters: din - Din which is the input pin to generate target code conn - maybe null only if Din_FBcl.sConstant is set, else the PinConnect_FBcl to use cacc - "" or a specific access String to an element of the delivered target code from the source. It is used for specific otx scripts, especially provide ".re" and ".im" to access a complex value source. Note that also the 'conn' can contain a PinConnect_FBcl.sElemSrc for the same effect. But different reason. ixFBlock - -1 or the index of the FBlock in Slides condBits - null or condition bits ixFB - ref - access in target code to data, 'thiz' sSat - "" or String to create saturation macros. wd - WriterCodegen.OtxWorkData out - output StringBuilder Throws: java.io.IOException genExprInConn private void genExprInConn(Dout_FBcl doutSrc, DinExpr_FBcl din, FBexpr_FBcl fbx, long[] condBits, java.lang.String sOperatorLeft, java.lang.String sOperator, java.lang.String sUnaryOp, java.lang.String ref, java.lang.String caccArg, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out, int recursion) throws java.io.IOException Generates the expression term part for one given connection from its Dout to one Dinexpr. Parameters: doutSrc - The found dout of the PinConnect_FBcl.pinSrc din - The din of the expression fbx - the FBexpr_FBcl, it is same is din.fb condBits - for conditional connection sOperatorLeft - sOperator - sUnaryOp - ref - caccArg - max - If Float.NaN then no limitation, elsewhere either overflow prevention or input limitation. min - If given (!= Float.isNaN(), then max should be given and this is the minimal value. If max is given but min is NaN, then min is the negate max. bOnlyOne - true then this is the only one input, used for input limitation. wd - out - recursion - Throws: java.io.IOException prepareExprTextGiven private void prepareExprTextGiven(OutTextPreparer.WriteDst out, FBexpr_FBcl fbx, long[] condBits, java.lang.String ref, java.lang.String sFn, WriterCodegen.OtxWorkData wd) throws java.io.IOException Prepares any expression which is given in sFn. The expression can contain "X1", "X2" etc or only "X". That are replaced by the values of the inputs if the fbx. For the values of the inputs #genValueDin(Din_FBcl, String) is called which may invoke (depending on the input delivering FBlock) a proper otx Script. Parameters: fbx - The FBexpr using its FBlock_FBcl.din ref - reference to the module data, it is often "thiz" inside the module, or a specific reference variable sFn - the given function from FBexpr_FBcl.sFn Throws: java.io.IOException stateDefinitionVars public void stateDefinitionVars(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Throws: java.io.IOException stateDefinitionVars1 public void stateDefinitionVars1(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Throws: java.io.IOException stateDefinitionHeader public void stateDefinitionHeader(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Throws: java.io.IOException stateDefinitionHeader1 public void stateDefinitionHeader1(Module_FBcl mdl, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst out) throws java.io.IOException Throws: java.io.IOException genCastAccess public void genCastAccess(Dinout_FBcl dinout, DType_FBcl dtDst, DType_FBcl dtSrc, boolean bCast, java.lang.String sSAT, float maxArg, float minArg, boolean bCastConstArg, WriterCodegen.OtxWorkData wd, OutTextPreparer.WriteDst wrCt, java.lang.CharSequence sExprIn) throws java.io.IOException Generates the cast and bit shift surround an value expression given as string from generation of this value or a constant. There are four situations: otx: castKG: cast from float or double to integer type: First the input may be limited with min and max. If limitation is not given, an non predictable result because overflow may be given in the target code execution. But this is in responsibility by the user. It is admissible if calculation time should be fast and the input is never out of range. The value is multiplied adequate number of fractional bits, and then cast. otx: castGK: cast from integer to float/double with given number of fractional bits. First the value should be cast to float/double, and the divide by the powerof 2 with number of fractional bits. otx: castKgreater: cast from integer to higher integer with bit shift, with more or equal int bits: Simple first cast, then shift. Or with lesser int bits: Check of limitation, limit, then cast. otx: castKless: cast from integer to lower integer with bit shift, with more or equal int bits: Simple shift and then cast. Or with lesser int bits: Check of limitation, limit, then cast. Parameters: dinout - regarded Din_FBcl or Dout_FBcl, this is especially to set debug breaks, not used for algorithm. Can be null. dtDst - dtSrc - bCast - true then a cast is definitely set. sSAT - "" or null, then no saturation, if given, in some cases this string is used to name macros for saturation. maxArg - Given for float inputs which should be cast to integer with fractional bits. minArg - adequate maxArg. If the value is Float.NaN or kNoLimit then the limitation is defined by the number of pre-fractional bits possible. bCastConst - The sExprIn is expected as const literal. wd - Working data sb - Output Buffer to write sExprIn - The value expression which should be casted. Throws: java.io.IOException dTypeDsgn public DinExpr_FBcl.DTypeDesignation dTypeDsgn(java.lang.String sSAT, DinExpr_FBcl xin, DinExpr_FBcl x1) Wrapper arround DinExpr_FBcl.dTypeDsgn(String, DinExpr_FBcl) with log entries. Parameters: sSAT - xin - x1 - Returns: iterConnSrcConditional public java.lang.Iterable<PinConnect_FBcl> iterConnSrcConditional(Din_FBcl din, long[] condBits, java.lang.String sVariant, int ixFBlock, WriterCodegen.OtxWorkData wd) Wrapper around Din_FBcl.iterConnSrcConditional(long[], long, String, int) for code generation with argument wd instead 'mEvinMdlMask'. The checkConnUse(PinConnect_FBcl, long, int, String) algorithm is here contained. Parameters: din - Din_FBcl which's Pin_FBcl.connectSrc should be tested condBits - null or condition bits in connection. sVariant - Designation on DoutMdl pins which should be used. ixFBlock - -1 or index for slicing or FB array access. wd - WriterCodegen.OtxWorkData.mEventOperation is used to select only proper inputs Returns: List contains the appropriate connections. callOtx private void callOtx(OutTextPreparer otx, OutTextPreparer.WriteDst out, OutTextPreparer.DataTextPreparer args) throws java.io.IOException Call the otx script with log entries. Parameters: otx - wr - args - Throws: java.io.IOException writeLogOtx public java.lang.String writeLogOtx(WriterCodegen.OtxWorkData wd, java.lang.String sId, java.lang.Object... args) writeLogPrcEntry private void writeLogPrcEntry(OutTextPreparer.WriteDst out, java.lang.String text, java.lang.Object... args) writeLogPrcEntry private void writeLogPrcEntry(java.lang.String sIdLog, OutTextPreparer.WriteDst out, java.lang.String text, java.lang.Object... args) Writes a log entry for code generation. See logPrcBuffer Parameters: sb - null or the current output for generated code, same as in #writeLogPrcEnd(StringBuilder, String, Object...) to detect what was written text - maybe formatted text to output, should contain the name of the operation which is executed yet, and important argument names. args - arguments to text. writeLogPrcEnd private void writeLogPrcEnd(OutTextPreparer.WriteDst out, java.lang.CharSequence textArg, java.lang.Object... args) Must be called as closing to #writeLogPrcEntry(StringBuilder, String, Object...). elsewhere the stack stackLogEntries is wrong. Parameters: sb - null or the current output for generated code, same as in #writeLogPrcEntry(StringBuilder, String, Object...) to detect what was written text - null or an maybe formatted text to output args - arguments to text. testCondition private boolean testCondition(Din_FBcl din, long[] condBits) Test whether the given condition is met on any of the source pins if more connections are given. Calls testCondition(Dout_FBcl, long[]) for all sources. Parameters: din - may have connections or not condBits - maybe null Returns: true if condBits ==null or no connections, true if at least one connection met, false if it has condBits and connections but all does not met. testCondition private boolean testCondition(Dout_FBcl doutSrc, long[] condBits) Test whether the condition is true for the given source pin. The condition is tested on the evout pin corresponds to the doutSrc. Conditions are stored in Evinout_FBcl.condBits. Calls Evinout_FBcl.getConditionBits() to check and calls Bitfield#checkOrConditionMet(long[][], long[]) to test the condition. Parameters: doutSrc - the dout where the condition should met. condBits - maybe null Returns: true if condBits ==null, true if condition mets. newStringBuilder public java.lang.StringBuilder newStringBuilder()

Class WriterCodegen

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

version

kNoLimit

iterDinEmpty

cmprOpReverse

cmprOp

numOp

numOpFirst

unaryOp

sDbgFBexpr

sDbgFBexprEvin

prj

logPrcBuffer

oLogPrc

wrLogPrc

logPrc

sLineIndent

stackLogEntries

bVerboseCode

sNewlineIndent

idxOtx

idxOtxdata

idxImportImpl

aliasImport

idxConstData

otx_callFB_evin

otx_ctorFB_evin

otx_ctorObjFB_evin

otx_initFB_evin

otxEvChainExprSetvar

otx_exprTerm

otx_exprAccessElement

otx_setVar_FBexpr

otx_defineLocalVar_FBexpr

otx_setVar_DoutFBarray2Din

otx_evMdlOutStart

otx_evMdlOutEnd

otx_setMdlOutScalar

otx_setMdlOutArrayCpy

otx_setMdlOutArrayExpr

otx_setMdlOutStructCpy

otxAccessFBdout

otx_setVarStruct

otx_setVarArrayElem

otx_setVarX_Array

otx_setVarX_Elem

otxExprEv_OFB_Variable

otxExprIf

XXXotx_exprSetCond

otx_exprCondIf

otxExprElse

otx_exprCondBitsIf

otxExprCondBitsEndif

otxExprEndif

otx_castValExprLim_SFd

mdl

testData

Constructor Detail

WriterCodegen

Method Detail

debug

debug4

testOtx

testOtxCond

iterBits

readTpl

parseScripts

writeCodeMain

writeCode

iterImportHeader

iterImportImpl

addImportToPrj

insertPoint

doInsert