org.vishia.fbcl.readOdg

Class OdgModule

java.lang.Object

org.vishia.fbcl.readOdg.OdgModule

public class OdgModule
extends java.lang.Object

This class describes a module from view of LibreOffice odg graphic. It has references mdlw to the creation class of the FBcl module: Module_FBcl.

Sub topics:

• Connect all FBcl pins due to connection of graphic pins: see processGBlockToPin_FBclConnections(OdgGBlock) #Impl-ReadOdg-ConnFBcl

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	dbgFbNamePin_prcConnection Set it for debugging to force a Debugutil#stop()
java.util.Map<java.lang.String,java.lang.String>	idxAlias Module local substitute between name in graphic and name used for FBcl or also the name regarding non determined numeric DTypes.
java.util.Map<java.lang.Integer,OdgGBlock>	idxAllGBlockByGpos Index of all graphic FBlocks sorted by graphic position or posNr do get reproducible output.
java.util.Map<java.lang.Integer,OdgGBlock>	idxDemux List of all connection GBlocks, it is ofbDemux, ofbConnPoint but not Xref.
java.util.Map<java.lang.String,java.util.List<Write_FBlock_FBwr>>	idxFBlockArray Index of all graphic FBlocks which are defined as array.
java.util.Map<java.lang.Integer,OdgGBlock>	idxGBlock Index of all graphic FBlocks sorted by graphic position or posNr do get reproducible output
java.util.Map<java.lang.String,OdgGBlock>	idxGBlockById Instance index sorted by Id to find connections.
java.util.TreeMap<java.lang.String,OdgGBlock>	idxGExprByName Index of all expression graphic blocks sorted by name + graphic position.
java.util.Map<java.lang.Integer,OdgGBlock>	idxGMdlPins Index of Graphic FBlocks which are marked with kind "ofbMdlPins" containing the module pins.
java.util.Map<java.lang.String,OdgGPin>	idxGPinById All pins of this module sorted by the graphic id to find them for connection.
(package private) java.util.Map<java.lang.String,java.lang.String>	idxStyle Index of the styles in the XML file.
java.util.TreeMap<java.lang.String,OdgGPin>	idxVarGPinByName Index of all OdgGPin which are used as variable after, sorted by the variable name, to find the proper OdgGPin if only the variable is shown and accessed in the graphic.
java.util.Map<java.lang.String,OdgGPin>	idxXrefGpin Index of all Xref referenced OdgGPin to find it as textual connection.
java.util.Map<java.lang.String,OdgXrefGraphic>	idxXrefGraphicByName Index of all Xref GBlock to create only one OdgXref per name and for post processing.
java.util.List<OdgNameTypeArray>	listFreeVar Found free expression output variables, later merged with the real used expression variable.
(package private) java.util.List<OdgPage>	listPage List of all pages, also refers the xml-page info XmlForOdg.Draw_page used for more evaluation module wise, especially the connections.
Write_Module_FBwr	mdlw The real module.
protected int	nAutoVariable
protected int	nAutoVariableAccess Counter for the name for FBaccess, start with 1 in this module.
(package private) Prj_FBcl	prj The project used for the translation session.
(package private) java.lang.String	sNameMdl
OdgMdlStates	stm
(package private) long	timeCmpFBcl
(package private) long	timeCompleteModule
(package private) long	timeDataPropg
(package private) long	timeEndModule
(package private) long	timeEventPropg
(package private) long	timePrep
(package private) long	timeStartModule
(package private) long	timeWrCmpCode
(package private) long	timeWrFBcl

Constructor Summary

Constructors

Constructor and Description
OdgModule(java.lang.String mdlName, Prj_FBcl prj, java.util.Map<java.lang.String,java.lang.String> idxStyle) Constructor of the module with the odg data.

Method Summary

Modifier and Type	Method and Description
private void	addPinConnected(java.util.List<FBlock_FBcl> listFBmdlSrc, Pin_FBcl pinSrc, java.lang.String connText, OdgConnection.ECkind connKind, Pin_FBcl pinDst, int ixMux, java.lang.String sElemSrc, java.lang.String sElemDstArg) Qualifies or checks admissibility of the pin with the connection kind and adds the pin to the correct idx... in the FBlock of the source pin.
private void	buildAssociatedEventDataPins(OdgGBlock fbg, Write_Module_FBwr mdlwr) Associates events and data from graphic for one graphic fblock.
private void	buildAssociatedFBtypeEventDataPins(Write_Module_FBwr mdlwr)
(package private) void	buildAssociatedMdlEventDataPins(Write_Module_FBwr mdlwr) Evaluates all graphic blocks of the module interface of kind "ofbMdlInp" and "ofbMdlOut" given in OdgReader#idxFBlockGraphicModuleIfc.
void	buildFBclData() This operation sorts the graphic raw data to build a FBcl-kind mapping of data.
private OdgConnection.ECkind	checkConnectionKind(OdgConnection.ECkind cKind, OdgConnection conn, boolean bSrc) Check and set a new Connection kind if given is null or default.
private java.lang.String[]	checkPrepareExprOperator(java.lang.String sDescr, boolean bCast, FBexpr_FBcl fbx) Checks the input text of the expression input pin due to: first ".[" is searched, 'posAccDst' set internally.
private void	completeMissingFBtypeInGBlocks() Completes the FBtype_FBcl or also the Write_FBtype_FBwr in all idxGBlock of this module.
private boolean	connect_pinCXref(java.lang.String nameXref, java.util.List<Pin_FBcl> listDinDst)
private void	connectPinSrcDstObj(OdgGPin gpinStart, OdgGPin gpinSrc, java.lang.String deMuxSelSrc, java.lang.String deMuxSelDst, int ixPinMux, OdgConnection conn, OdgGPin gpinDst) Connect immediately the gpinStart OdgGPin.pinObj to the gpinDst OdgGPin.pinObj with given selection of deMuxSelSrc and deMuxSelDst.
private void	connectViaDemux(OdgGPin gpinStart, OdgGPin gpinSrc, java.lang.String deMuxSelSrc, java.lang.String deMuxSelDst, OdgConnection.ECkind cKindArg, int ixPinMux, int recursion) This is the commonly used connection function from given graphic connections to the FBcl connections regarding Demux FBlocks and slicing.
private void	connectViaDemux(OdgGPin gpinStart, OdgGPin gpinSrc, java.lang.String deMuxSelSrc, java.lang.String deMuxSelDst, OdgConnection.ECkind cKind, OdgGPin gpinDst, OdgGBlock gfbDst, int ixPinMux, int recursion)
private DinExpr_FBcl	createDinExpr(java.lang.String nameSpec, int[] nrDinout, EvinType_FBcl evint, java.lang.String sOper, OdgGBlock fbg, OdgGPin gpin) Creates a DinExpr_FBcl with the given infos.
private Dout_FBcl	createDoutExpr(OdgGPin gpin, java.lang.String sAccess, int[] ixArray, OdgGBlock fbg, FBexpr_FBcl fbx, EvoutType_FBcl evoutt, java.lang.String sOper, DType_FBcl.DtIxmdl dType, OdgGPin gExprOut, int[] nrDinout) Creates the pin as exprOut.
(package private) void	createFBclConnectionsFromGraphic() Gets the connections from the graphic and stores it to the real used pins.
private void	createFBexpr(OdgGBlock fbg, FBtype_FBcl fbtx, java.util.List<Write_FBlock_FBwr> fbwRef) Creates an FBexpr_FBcl as expression inside the OdgGBlock.
private Pin_FBcl	createFBexprPinAndKpin(OdgGPin gpin, OdgGBlock fbg, FBexpr_FBcl fbx, EvinType_FBcl evint, EvoutType_FBcl evoutt, java.lang.String sOper, OdgGPin gExprOut, int[] nrDinout, java.lang.String[] sExpr) Creates the expression pin(s) from the given graphic pin gpin.
(package private) void	createFBexprPins_duetoGBlockPins(OdgGBlock fbg) Create the Pin_FBcl with the PinType_FBcl for the given OdgGPin in the given FBlock.
private PinType_FBcl	createFBlockPin(OdgGPin gpin, OdgGBlock fbg, EvinType_FBcl evint, int ctEvinType) Creates or gets the pin(s) in the non graphic instance from given Graphic pin gpin: OdgGBlock.fbw, maybe more as one, OdgGBlock.fbtw and sets the pin reference in gpin: OdgGPin.pinType, OdgGPin.pinObj.
(package private) void	createFBlockPins(OdgGBlock fbg) Create the Pin_FBcl with the PinType_FBcl for the given OdgGPin in the given OdgGBlock.
(package private) void	createFBPins_duetoGBlockPins() completes the graphic Pins() with the FBlock_FBcl pins, create or search the adequate pins in FBlock_FBcl and FBtype_FBcl
private void	createInheritanceFBclConnectionsFromGraphic(Write_Module_FBwr mdlwr) Gets the connections from the graphic for inheritance and stores it to the real used pins.
private DinExprK_FBcl	createKinExpr(DinExpr_FBcl exprInp, java.lang.String sOpK, OdgGBlock fbg)
private void	createPinObjWithGivenPinType(OdgGPin gpin, OdgGBlock fbg)
private PinRef_FBcl	createThizRefForFBoper(OdgGPin gpin, OdgGBlock fbg, FBexpr_FBcl fbx)
private Dout_FBcl	createVarRefRetInMdl(Dout_FBcl pinSrc, PinKind_FBcl pinKind, java.lang.String sNameFBy, DType_FBcl.DtIxmdl dtype) Creates a variable in the module which is used either as variable after an expression or also as call by reference variable for an FBoper or any FBlock or also as return variable for a FBlock operation.
private void	evalPinForAssociatedEvDataPins(OdgGPin pi, Write_FBtype_FBwr fbtw, java.util.List<EvinoutType_FBcl> listEvin, java.util.List<EvinoutType_FBcl> listEvout, EvinoutType_FBcl evUpdin, EvinoutType_FBcl evUpdout, Write_Module_FBwr mdlwr, boolean bFirstCall, XY_FBcl xy) Associate any pin to evin, evout, evUpdin evUpdout, due to its functionality.
private void	fulfillVariablesInExpressionFactors() This operation fulfills textual connections in expressions for K-pins.
private java.lang.String	getAccess(java.lang.String text, int zText)
private void	getListDstXrefPins(java.util.List<OdgConnection> listAdd, OdgXref xref, int recursion)
private java.lang.String	getNextNamePin(java.lang.String sNameType, int[] nrDinout, int ixDinout) Builds the name of the next pin for a multiple pin or returns sNameType if it is not a multiple type
private PinType_FBcl	getPinTypeViaDemux(OdgGPin gpin) Searches and returns the PinType on the opposite end of the deMux
java.lang.String	getStyleFromid(java.lang.String id)
private void	processFBlockPinGraphicConnectionTextual(OdgGPin pi) Processes the textual given connection.
(package private) void	processGBlockToPin_FBclConnections(OdgGBlock fbg) This routine processes all pins of the given GBlock in OdgGBlock#idxPinInstance and then their OdgGPin.connections for the source of the connection.
private void	processGPinToPin_FBclConnections(OdgGPin gpin, OdgGBlock fbg, OdgConnection.ECkind onlyConnKind) Process all connections in the graphic from the given graphic pin (excl. inheritance, should be already processed).
private void	processGraphicPinInheritance(OdgGPin pi, OdgGBlock fbg) Process all graphic connections which are inheritances.
private void	processMdlout() Process all mdl Dout in that kind that it is tested whether it is present by a variable in the Module.
private boolean	processTypePinGraphicConnection(OdgGPin gpinSrc, OdgConnection.ECkind onlyConnKind, java.util.Iterator<OdgConnection> iterConn, OdgConnection conn, boolean bInstanceConn) Process the graphic connection due to type connection which determines the type of src pin
(package private) boolean	putGBlockByGrapicPos(OdgGBlock gblock) Write a GBlock to this #idxGBlock with test whether it is twice.
private void	resolveXrefGraphicConnections(OdgXrefGraphic xref) Resolves the Xref connections to the real connections, now also over pages.
(package private) void	writeFbgData(boolean bFbg, java.lang.String sExt2, int ixGraphicOrderStart) Writes the Odg data to text file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

sNameMdl

final java.lang.String sNameMdl

mdlw

public final Write_Module_FBwr mdlw

The real module.

stm

public final OdgMdlStates stm

listPage

final java.util.List<OdgPage> listPage

List of all pages, also refers the xml-page info XmlForOdg.Draw_page used for more evaluation module wise, especially the connections.

idxStyle

final java.util.Map<java.lang.String,java.lang.String> idxStyle

Index of the styles in the XML file. TODO it is intrinsic bad here, if a module is dispersed over more as one file.

idxGBlockById

public final java.util.Map<java.lang.String,OdgGBlock> idxGBlockById

Instance index sorted by Id to find connections.

listFreeVar

public final java.util.List<OdgNameTypeArray> listFreeVar

Found free expression output variables, later merged with the real used expression variable. It is the description of the variable pin, OdgNameTypeArray.descr contains the name, OdgNameTypeArray.pinC contains the id from xml for connection.

idxGPinById

public final java.util.Map<java.lang.String,OdgGPin> idxGPinById

All pins of this module sorted by the graphic id to find them for connection.

idxGMdlPins

public final java.util.Map<java.lang.Integer,OdgGBlock> idxGMdlPins

Index of Graphic FBlocks which are marked with kind "ofbMdlPins" containing the module pins. Sorted by graphic position do get deterministic and reproducible output

idxGBlock

public final java.util.Map<java.lang.Integer,OdgGBlock> idxGBlock

Index of all graphic FBlocks sorted by graphic position or posNr do get reproducible output

idxAllGBlockByGpos

public final java.util.Map<java.lang.Integer,OdgGBlock> idxAllGBlockByGpos

Index of all graphic FBlocks sorted by graphic position or posNr do get reproducible output. This index is used also to detect whether two shapes have the same left-top position. This occurs by accident if copy'n paste to the same position was done which is not seen in the graphic but causes an error. Also an ERROR message occurs, if two GBlocks have the same position number ("...´12"). This is used for report to write out what is read from the Graphic. It is also usable for debug. This index is not used for further evaluation, but the GBlocks are also stored in other indices.

idxFBlockArray

public final java.util.Map<java.lang.String,java.util.List<Write_FBlock_FBwr>> idxFBlockArray

Index of all graphic FBlocks which are defined as array. With the name as key all associated GBlocks can be accessed.

idxGExprByName

public java.util.TreeMap<java.lang.String,OdgGBlock> idxGExprByName

Index of all expression graphic blocks sorted by name + graphic position. The name comes from OdgNameTypeArray.descr. Some GBlocks with the same name, and hence the same only one representing FBgl instance can be existing. They should all contained here, separately. Hence the graphic position is added to the key. To search one occurrence of the GBlock with only the correct name use TreeMap.ceilingEntry(Object).

idxVarGPinByName

public java.util.TreeMap<java.lang.String,OdgGPin> idxVarGPinByName

Index of all OdgGPin which are used as variable after, sorted by the variable name, to find the proper OdgGPin if only the variable is shown and accessed in the graphic. used for connection. It is then the same as connect immediately this odgGpin.

idxDemux

public java.util.Map<java.lang.Integer,OdgGBlock> idxDemux

List of all connection GBlocks, it is ofbDemux, ofbConnPoint but not Xref. It is only to show for debug.

idxXrefGraphicByName

public final java.util.Map<java.lang.String,OdgXrefGraphic> idxXrefGraphicByName

Index of all Xref GBlock to create only one OdgXref per name and for post processing.

idxXrefGpin

public final java.util.Map<java.lang.String,OdgGPin> idxXrefGpin

Index of all Xref referenced OdgGPin to find it as textual connection.

idxAlias

public java.util.Map<java.lang.String,java.lang.String> idxAlias

Module local substitute between name in graphic and name used for FBcl or also the name regarding non determined numeric DTypes.

prj

final Prj_FBcl prj

The project used for the translation session.

nAutoVariable

protected int nAutoVariable

nAutoVariableAccess

protected int nAutoVariableAccess

Counter for the name for FBaccess, start with 1 in this module.

timeStartModule

long timeStartModule

timePrep

long timePrep

timeDataPropg

long timeDataPropg

timeEventPropg

long timeEventPropg

timeCompleteModule

long timeCompleteModule

timeWrFBcl

long timeWrFBcl

timeCmpFBcl

long timeCmpFBcl

timeWrCmpCode

long timeWrCmpCode

timeEndModule

long timeEndModule

dbgFbNamePin_prcConnection

private static java.lang.String dbgFbNamePin_prcConnection

Set it for debugging to force a Debugutil#stop()

Constructor Detail

OdgModule

public OdgModule(java.lang.String mdlName,
                 Prj_FBcl prj,
                 java.util.Map<java.lang.String,java.lang.String> idxStyle)

Constructor of the module with the odg data. Creates also the Module_FBcl and its writing wrapper Write_Module_FBwr.

Parameters:

mdlName - name from the ofbTitle shape.

prj -

args -

Method Detail

buildFBclData

public void buildFBclData()

This operation sorts the graphic raw data to build a FBcl-kind mapping of data.

• createFBPins_duetoGBlockPins()
• For the modules pins, the association between events and its data pins are build: #buildAssociatedMdlEventDataPins(OdgReader)
• All FBlocks and CBlocks which are multiple existing in the graphic are merged to one FBlock per name and one CBlock per name. Also the connections are associated (merged), of course: #createFBclConnectionsFromGraphic(OdgReader)
• Not connected pins are handled: #supplementNotConnectedPins()
• Data types are propagated forward from inputs of the module and from determined outputs of FBlocks. DataTracking_FBcL#propagateTypesEvents(Module_FBcl)
• Events are propagated from inputs through the FBlocks, if not given in graphic, appropriate to the data flow. Also in DataTracking_FBcL#propagateTypesEvents(Module_FBcl)
• Last not least the data connections are tracked backward, starting from module's output, using the event connections: #processDflow()

Parameters:

odg -

writeFbgData

void writeFbgData(boolean bFbg,
                  java.lang.String sExt2,
                  int ixGraphicOrderStart)

Writes the Odg data to text file.

Parameters:

sExt2 - control of output name:

• null then do nothing (prevent effort)
• "" then write with extension ".fbg.txt"
• "Xxx" use this before extension
• "ext" starting with dot. use this as extension

ixGraphicOrderStart - >=0 then touch all new OdgGBlock.ixGraphicOrder with a new value starting with this.

completeMissingFBtypeInGBlocks

private void completeMissingFBtypeInGBlocks()

Completes the FBtype_FBcl or also the Write_FBtype_FBwr in all idxGBlock of this module.

• This is a typical case, because the '...:Type' of a FBlock should be written only in one of the GBlocks with the same name.
• All GBlocks with an instance name (builds a FBlock) have the proper OdgGBlock.fbw set.
• The Write_FBlock_FBwr knows its Write_FBlock_FBwr.fbtw or just via its FBlock_FBcl the FBlock_FBcl.fbt after at least one OdgGBlock is created with the FBtype information.
• From this Write_FBlock_FBwr the FBtype information is taken and stored here in the OdgGBlock.fbtw respectively OdgGBlock.fbt.
• It means this information can be gotten via two ways, but it is ready to use given then here. Note that the OdgGBlock.fbtw is also necessary to define a GBlock as class (as FBtype_FBcl).

getStyleFromid

public java.lang.String getStyleFromid(java.lang.String id)

putGBlockByGrapicPos

boolean putGBlockByGrapicPos(OdgGBlock gblock)

Write a GBlock to this #idxGBlock with test whether it is twice. If the GBlock with the same position (key) is already stored, an error is written and the GBlock is not stored. This is especially if two blocks overlaps in the Graphic by accident. Secondary the manual given number in the GBlock may be twice. This is in the name after "`12".

Parameters:

key - the position as int key

gblock - the GBlock.

createFBPins_duetoGBlockPins

void createFBPins_duetoGBlockPins()

completes the graphic Pins() with the FBlock_FBcl pins, create or search the adequate pins in FBlock_FBcl and FBtype_FBcl

createFBlockPins

void createFBlockPins(OdgGBlock fbg)

Create the Pin_FBcl with the PinType_FBcl for the given OdgGPin in the given OdgGBlock.

• The OdgGBlock.fbt, OdgGBlock.fbtw and OdgGBlock.fbw are already set. whereby OdgGBlock.fbw is null if it is a GBlock for only the FBtype_FBcl definition (a class ) and OdgGBlock.fbtw is null but OdgGBlock.fbt is set if the FBtype_FBcl is not defined on demand, it is existing from a definition module. Note that the association of the correct FBtype_FBcl or also Write_FBtype_FBwr is done in

The OdgGPin.kind contains the kind of the Pin. If it is an expression, the expression operand stored in OdgGPin.sText will be transferred to Din_FBcl.sConstant.
Note: The OdgGBlock.fbPinSrc and OdgGBlock.fbPinDst are handled later in processGBlockToPin_FBclConnections(OdgGBlock) because more as one kind of connection may force more as one pins. It depends from the connections.

Parameters:

fbg -

createFBlockPin

private PinType_FBcl createFBlockPin(OdgGPin gpin,
                                     OdgGBlock fbg,
                                     EvinType_FBcl evint,
                                     int ctEvinType)

Creates or gets the pin(s) in the non graphic instance from given Graphic pin gpin: OdgGBlock.fbw, maybe more as one, OdgGBlock.fbtw and sets the pin reference in gpin: OdgGPin.pinType, OdgGPin.pinObj. The pins may be already existing in the non graphic instances, also get from OdgGBlock.fbt(). For connection processing the pins can be used referenced in gpin: OdgGPin.pinObj and OdgGPin.pinType.
From gpin also the FBlock_FBcl and FBtype_FBcl instances are accessible via Pin_FBcl.fb and PinType_FBcl.fbt. The gpin.pinObj is an array of pins, due to the array of FBlock_FBcl in fbg.fbw. Usual used only one instance, but possible more for Multi-FBlocks.

Parameters:

gpin - Given graphic pin with name and maybe type in OdgGPin.nameType and also Destination where gpin.pinObj and gpin.pinType is set. OdgGPin.pinObj, OdgGPin.pinType

fbg - Source where and from where the non graphic pins are set and get, using OdgGBlock.fbw and OdgGBlock.fbtw

createPinObjWithGivenPinType

private void createPinObjWithGivenPinType(OdgGPin gpin,
                                          OdgGBlock fbg)

createFBexprPins_duetoGBlockPins

void createFBexprPins_duetoGBlockPins(OdgGBlock fbg)

Create the Pin_FBcl with the PinType_FBcl for the given OdgGPin in the given FBlock. The OdgGPin.kind contains the kind of the Pin. If it is an expression, the expression operand stored in OdgGPin.sText will be transferred to Din_FBcl.sConstant.

Parameters:

fbg -

odgr -

createFBexpr

private void createFBexpr(OdgGBlock fbg,
                          FBtype_FBcl fbtx,
                          java.util.List<Write_FBlock_FBwr> fbwRef)

Creates an FBexpr_FBcl as expression inside the OdgGBlock. It adds the event pins "prep" and "prepO". FBlock_FBcl#_kindFBlock is FBlock_FBcl.Blocktype#expr

• If the expression text contains a "...=text" then it is either an "...=operation()", results in FBexpr_FBcl.cOp == '('.
• or it is any given expression given in destination language, which should be prepared, results in FBexpr_FBcl.cOp == '' see org.vishia.fbcl.writeFBcl.WriterCodegen#prepareExprTextGiven(Appendable, FBexpr_FBcl, String, String)

Parameters:

fbg - given Graphic block

fbtx - The expression type, maybe StdLibFBlocks_FBcl.fbtExpr_OFB, OFB_ExprEv or OFB_Oper

odgMdl - The module

fbwRef - If a FBoper_OFB should be created, the associated FBlock

createFBexprPinAndKpin

private Pin_FBcl createFBexprPinAndKpin(OdgGPin gpin,
                                        OdgGBlock fbg,
                                        FBexpr_FBcl fbx,
                                        EvinType_FBcl evint,
                                        EvoutType_FBcl evoutt,
                                        java.lang.String sOper,
                                        OdgGPin gExprOut,
                                        int[] nrDinout,
                                        java.lang.String[] sExpr)

Creates the expression pin(s) from the given graphic pin gpin. Depending on the OdgGPin.kind either a input or output pin is created:

• PinKind_FBcl.exprInp or PinKind_FBcl.fbdst: An DinExpr_FBcl is created and stored as input in Write_FBlock_FBwr.idxDin, with the name X1... and the PinType_FBcl#Din.
• PinKind_FBcl.exprOut or PinKind_FBcl.Dout or PinKind_FBcl.vout or PinKind_FBcl.zout: An Dout_FBcl is created and stored as output in Write_FBlock_FBwr.idxDout with the name either y, Y, Vm, Q and that given PinKind_FBcl from OdgGPin.kind. But not that the PinKind comes from the name of the pin y Y V Q and then from the name of the pin in the FBtype_FBcl representing the expression. But it is asserted it is the same.

Type of the pin
DinExpr_FBcl.sOperator determined from the sExpr
Creating a pin with "K1..." for multiplier determined from sExpr If the sExpr in an input pin contains

Parameters:

gpin - graphic pin

fbg - graphic block where the pin is member of. For expression only one fbg exists. OdgGBlock.fbw is the writer to the FBexpr_FBcl where the pin(s) is/are inserted.

sExpr - should be String[2].
sExpr[0] the contribution for this pin is added to the first part of the Din_FBcl.sConstant for the "expr" pin.
sExpr[1]: the contribution of the K pins is added to the next part of the Din_FBcl.sConstant for the "expr" pin.
sExpr[2]: the contribution of the output is added to the last part of the Din_FBcl.sConstant for the "expr" pin. return null of a din for K... to add at last.

checkPrepareExprOperator

private java.lang.String[] checkPrepareExprOperator(java.lang.String sDescr,
                                                    boolean bCast,
                                                    FBexpr_FBcl fbx)

Checks the input text of the expression input pin due to:

• first ".[" is searched, 'posAccDst' set internally. It is an access to destination, used for the variable after expression.
• left from 'posAccDst' is the operator written. If 'posAccDst ==0', then the default operator FBexpr_FBcl#getOperator is used as operator.
• Operators with two character "<<" ">>" "<=" etc. are separately tested 2 characters left from posAccDst or from end of descr.
• If on position left from operator the proper unary operator is found, use it.
• return[0] is filled with
  • 'C' if bCast is set
  • the unary operator if given, optional
  • The operator as one or two characters, obligate.
  • optional "@" following by the access to destination.
  Hence, evaluating the return[0],:
  • first check whether the text starts with 'C' for cast.
  • then check if more as 1 character after optional cast till end or till '@', then check whether it is an unary operator. It is not an unary if only 1 character is given after cast, before optioal '@'
  • the next till end or '@' is the operator.
  • If '@' follows, then an access to dst follows
  This evaluation is done in FBexpr_FBcl.setOperatorToPins(Prj_FBcl), in this form taken from the 'sExpr' pin. This evaluation is not done here. Only the content of 'sExpr' pin is prepared here.
• All left from position of unary operator or operator is the K string. This part is written to return[1].

Parameters:

sDescr - Given text from shape ofpExprPart

sNameIn -

fbx - The expression

Returns:

String [0] for the operator to store in DinExpr_FBcl.sOperator and if an accDst is given, "@[123]" or "@.element" for the access to the variable after expression. [1] to evaluate for the K-pin. It it is the DinExpr_FBcl#setConstant(String) if the pin has not a connection. If length==3 then is is the flag for a detected limit operator. Then this Din with this operator should not use as X1.. pin (ordinary expression input). .

createDinExpr

private DinExpr_FBcl createDinExpr(java.lang.String nameSpec,
                                   int[] nrDinout,
                                   EvinType_FBcl evint,
                                   java.lang.String sOper,
                                   OdgGBlock fbg,
                                   OdgGPin gpin)

Creates a DinExpr_FBcl with the given infos.

Note: The element DinExpr_FBcl.sOperator is left empty here. It is set in FBexpr_FBcl.setOperatorToPins(Prj_FBcl) which is called in Write_Module_FBwr.setExprOperatorToPins() after reading all content, before further evaluation.

Parameters:

nameSpec - if not null then it is a specific name for a specific version of FBexpr. null if not specific, in the ordinary case.

nrDinout - on pos [0] either -1 for a single pin or only one multiple pin or >=0 for the number of the multiple pin. if nameSpec is a multiple pin or null, then this will be used and increment if >=0

fbg - used for access to FBlock, type etc.

gpin - The pin from graphic. The OdgGPin.nameType holds all necessary information for the data type and the graphic position.

Returns:

The pin created and registered. Note: The text on the pin and the K pin is not used here. It is the core operation to create a pin.

getNextNamePin

private java.lang.String getNextNamePin(java.lang.String sNameType,
                                        int[] nrDinout,
                                        int ixDinout)

Builds the name of the next pin for a multiple pin or returns sNameType if it is not a multiple type

Parameters:

sNameType - If ends with "999" the part without "x999" is used.

nrDinout - array with the current index start from 0 or 1 to take this index and increment or nrDinout[ixDinout] == -1 if only the base name should be used because there is only one pin instead multiple.

ixDinout - the position in nrDinout where the index is stored, usual 0 for input, 1 for output

Returns:

proper name.

createKinExpr

private DinExprK_FBcl createKinExpr(DinExpr_FBcl exprInp,
                                    java.lang.String sOpK,
                                    OdgGBlock fbg)

createDoutExpr

private Dout_FBcl createDoutExpr(OdgGPin gpin,
                                 java.lang.String sAccess,
                                 int[] ixArray,
                                 OdgGBlock fbg,
                                 FBexpr_FBcl fbx,
                                 EvoutType_FBcl evoutt,
                                 java.lang.String sOper,
                                 DType_FBcl.DtIxmdl dType,
                                 OdgGPin gExprOut,
                                 int[] nrDinout)

Creates the pin as exprOut. An expression can have more as one doutExpr, especially if it is an FBoper_FBcl, or also if it contains a String given operation.

• Creates also a variable after expression VarL_OFB VarV_OFB VarZ_OFB

Parameters:

gpin - The graphic pin

ixArray -

sAccess -

fbg - The frame where the graphic pin is member of

fbx - it is fbg.fbw, but cast as FBexpr_FBcl

evoutt - given if bOper = true, as evin to associate with the created dout type

bOper -

dt -

gExprOut - if gpin == gExprOut then creates a exprOut instead Dout, Zout, Vout but creates the following variable.

nrDinout -

Returns:

createVarRefRetInMdl

private Dout_FBcl createVarRefRetInMdl(Dout_FBcl pinSrc,
                                       PinKind_FBcl pinKind,
                                       java.lang.String sNameFBy,
                                       DType_FBcl.DtIxmdl dtype)

Creates a variable in the module which is used either as variable after an expression or also as call by reference variable for an FBoper or any FBlock or also as return variable for a FBlock operation.

• The Dout_FBcl pin which was first created as pin of the FBexpr or pin of FBlock_FBcl is given here as 'pinSrc'.
• The returned Dout_FBcl from the created variable is stored in OdgGPin.pinObj because it is used for connect in the module.
• The connection between pinSrc and the and the returned dout is done here.
• The returned Dout_FBcl is the output of the FBlock_FBcl of type 'VarL_OFB' or 'VarV_OFB' or 'VarZ_OFB' which is registered in the module.
• Hence, connectViaDemux(OdgGPin, OdgGPin, String, String, org.vishia.fbcl.readOdg.OdgConnection.ECkind, int, int) connects the variable, the variable is connected with the 'pinSrc'. The fbd file (IEC61499) contains the variable extra, and the connection, all proper.

Parameters:

pinSrc - The output which should be connected to the Var..._OFB.X input

pinKind - kind of the variable, PinKind_FBcl.Dout or ~Vout or ~Zout

sNameFBy - Name of the variable resp. the representing Var---OFB FBlock

dtype - data type same as the expression or operation output

Returns:

The Dout of the new created variable FBlock

createThizRefForFBoper

private PinRef_FBcl createThizRefForFBoper(OdgGPin gpin,
                                           OdgGBlock fbg,
                                           FBexpr_FBcl fbx)

getAccess

private java.lang.String getAccess(java.lang.String text,
                                   int zText)

buildAssociatedMdlEventDataPins

void buildAssociatedMdlEventDataPins(Write_Module_FBwr mdlwr)

Evaluates all graphic blocks of the module interface of kind "ofbMdlInp" and "ofbMdlOut" given in OdgReader#idxFBlockGraphicModuleIfc. Any of this block can contain

• One prepare event input of the module (kind "ofpEvout...") for inputs of the module. Then this event is related to the input data.
• Some input data of the module (kind "ofpDout...", they are associated to the event input which should be given. calling PinBase_FBcl#addAssociatedEvData(PinBase_FBcl).
• One update event input of the module (kind "ofbEvUpdout..."). Then this update event input is associated to the prepare event input as EvinType_FBcl#setPrepUpdEvent(EvinoutType_FBcl)
• One prepare event output (king "ofpEvin..."), then this pin is associated to the given prepare event input and vice versa if the prepare event input is also given.
• If some output data of the module (kind "ofpDin..." are given, and the prepare event output is given, but the update event output is not given, then this output data are associated to the prepare event output as feed through data.
• One update event output (kind "ofpEvUpdin...") may be given.
• If some output data of the module (kind "ofpDin..." are given, and the prepare event output is not given, but the update event output, then this output data are associated to the update event output as state data of the module.
• Both, the prepare event output and the update event output are not necessary. If data are given and both event outputs are given, then an error message is occurring because it is an ambiguous situation.

Parameters:

odg - The gathered graphic data.

buildAssociatedFBtypeEventDataPins

private void buildAssociatedFBtypeEventDataPins(Write_Module_FBwr mdlwr)

buildAssociatedEventDataPins

private void buildAssociatedEventDataPins(OdgGBlock fbg,
                                          Write_Module_FBwr mdlwr)

Associates events and data from graphic for one graphic fblock. It iterates over all pins in the OdgGBlock.iterPin(). This operation is called twice for a fbg which is first not unique.

• A graphic block can have more as one evin. Then the din pins are associated to all these evin, hence more as one operation with the same din arguments are built.
• If din are existing, but no evin are given, then this block is first deferred, because on other graphic instances of the same type a proper association may be given. If the data pins are not associated, detected in the second call, then an evin is built either with the name of a given evout without trailing "O", or with the default name "prep".
• Adequate for dout. If they are existing, either the existing given evout is associated, or in a second call either evout are built from given evin with trailing "O", or the evout is build with the default name "prepO".
• If Aggregations are given, then either "init" or "ctor" is searched in the list of given din and associated. Aggregations should always set initially. Hence either with "init" or "ctor" as default names for this events. If "init" or "ctor" are not found in the listEvin, then "init" as evin of the FBlock is searched, and created if not existing. This is done in the second call, because another graphic instance may associate "ctor" for an aggregation instead "init". Alternatively to "init" or "ctor" also an event which's name starts with "=" for example "=ini".
• Adequates is done for ports, associated to the init output.

Parameters:

fbg - The graphic block

mdlwr - null if executed for a fbg inside the module, the module for a module pin graphic block. It is used in #evalPinForAssociatedEvDataPins(OdgGPin, Write_FBlock_FBwr, List, EvinoutType_FBcl, EvinoutType_FBcl, EvinoutType_FBcl, Write_Module_FBwr) to associate an EccAction_FBcl stored in the module to event pins.

evalPinForAssociatedEvDataPins

private void evalPinForAssociatedEvDataPins(OdgGPin pi,
                                            Write_FBtype_FBwr fbtw,
                                            java.util.List<EvinoutType_FBcl> listEvin,
                                            java.util.List<EvinoutType_FBcl> listEvout,
                                            EvinoutType_FBcl evUpdin,
                                            EvinoutType_FBcl evUpdout,
                                            Write_Module_FBwr mdlwr,
                                            boolean bFirstCall,
                                            XY_FBcl xy)

Associate any pin to evin, evout, evUpdin evUpdout, due to its functionality. Note, init and other pins are not merged. It is possible to have init beside other prepare events. This is necessary if the same data inputs uses both. See also Write_FBtype_FBwr.completeMissingEventPins(). Not all pins need to be drawn in the graphic.

Parameters:

pi - The pin from the graphic block From OdgGBlock

listEvin - given more as one evin of the block or emtpy

evout - given evout in the graphic appearance , or null

evUpdin - same for update

evUpdout -

mdlwr - null if this is not a module pin FBlock.

processMdlout

private void processMdlout()

Process all mdl Dout in that kind that it is tested whether it is present by a variable in the Module. If it is so (same name), then

• mark the variable public with selecting the second output in the FBlock, this is for public. See StdLibFBlocks_FBcl.fbtVarV_OFB and ~fbtVarZ_OFB
• Set DinoutType_FBcl.changeAccTargetCode(DoutTargetCodeAccess) with DoutTargetCodeAccess.UseVarMdl.

Both is used by code generation.
All other Dout are not changed.

createInheritanceFBclConnectionsFromGraphic

private void createInheritanceFBclConnectionsFromGraphic(Write_Module_FBwr mdlwr)

Gets the connections from the graphic for inheritance and stores it to the real used pins. The connections in graphic are stored in OdgGPin.connections which are only stored in the graphic level in OdgReader
As result the inheritances are stored in Write_FBtype_FBwr.listInheritance.
After execution Write_FBtype_FBwr.createInheritanceType() and FBtype_FBcl.CreateFBT.createIdxInheritance() the inheritances are stored in the FBtype_FBcl.inheritance array. But this routines must be called only after gather all inheritances in the graphic.

Parameters:

odg - graphic data

createFBclConnectionsFromGraphic

void createFBclConnectionsFromGraphic()

Gets the connections from the graphic and stores it to the real used pins. The connections in graphic are stored in OdgGPin.connections which are only stored in the graphic level in OdgReader The PinInstances are referred from OdgGBlock#idxPinInstance and also OdgGBlock.fbPinSrc and OdgGBlock.fbPinDst.
As result the pins are stored in FBlock in the adequate specific idx...
The connections are stored in PinConnection#idxPinConnected and PinConnection#idxPinBackConnected

Parameters:

odg - graphic data

resolveXrefGraphicConnections

private void resolveXrefGraphicConnections(OdgXrefGraphic xref)

Resolves the Xref connections to the real connections, now also over pages.

• It reads the OdgGPin as source of this Xref (expected only one) via its OdgGBlock.fbPinDst connected.
• Then it iterates over all dstPin of this Xref via its OdgGBlock.fbPinSrc connected.
• It connects the source OdgPin immediately with all dst OdgPin and removes the Xref connection.
• If this is done for all Xref, also for ofbConnPoint, then these elements are completely dissolved.

The index of all Xref and connection points is idxXrefGraphicByName. It contains all Xref and also all ofbConnPoints of the module.

Parameters:

xref - The OdgGBlock which is an OdgXrefGraphic. For all Xref with the same name only one instance is used.

checkConnectionKind

private OdgConnection.ECkind checkConnectionKind(OdgConnection.ECkind cKind,
                                                 OdgConnection conn,
                                                 boolean bSrc)

Check and set a new Connection kind if given is null or default.

Parameters:

cKind - given

conn - the new given connection in this Xref connections

Returns:

the kind of conn if cKind is null or default, or cKind == newKind if equal, or cKind if newKind is not proper. If not proper, error message via prj occurs.

Since:

2025-04-08: It changes also the OdgConnection.eKind if the given cKind is more deterministic. This is necessary for connections via Demux to transport information about the connection kind especially to non determined connection kinds for aggregation to the THIS port. The last one cannot be automatically determined because it is a connection to the whole GBlock.

processGBlockToPin_FBclConnections

void processGBlockToPin_FBclConnections(OdgGBlock fbg)

This routine processes all pins of the given GBlock in OdgGBlock#idxPinInstance and then their OdgGPin.connections for the source of the connection.

#Impl-ReadOdg-ConnFBcl#docu: Connect all FBcl pins due to connection of graphic pins
• #-gathConn: Gather all connections page per page: OdgReader.processGraphicConnectionsOfAllModulePages(OdgModule, org.vishia.fbcl.readOdg.xml.XmlForOdg)
• #-

The FBcl connections are built from the graphic connections:

State before:
The OdgGPin.pinObj() are created, but have not connections.

State after:
The OdgGPin.pinObj() are connected each other.
During that, the Xref and connections via ofbConnPoint are dissolved. Result is the filled Pin_FBcl#connect which refers immediately the dst pin in the FBlock_FBcl / FBlock_FBcl All idxXrefGraphicByName which are no more necessary (all connections are used) are deleted.

Parameters:

fbg - the GBlock or GExpession graphical instance which contains the pins with their connections.

processGPinToPin_FBclConnections

private void processGPinToPin_FBclConnections(OdgGPin gpin,
                                              OdgGBlock fbg,
                                              OdgConnection.ECkind onlyConnKind)

Process all connections in the graphic from the given graphic pin (excl. inheritance, should be already processed).

• It tracks type connection via processTypePinGraphicConnection(OdgGPin, org.vishia.fbcl.readOdg.OdgConnection.ECkind, Iterator, OdgConnection, boolean). This is to clarify types of data and references.
• it tracks data connections, first calling #connectViaDemuxXref(OdgGPin, OdgGPin, String, String, int, int), because the connections maybe made over XRef and DeMux.

It is possible that the connection in the graphic comes from any other Din_FBcl instead of the correct Dout_FBcl. The problem is solved from Pin_FBcl#connectFrom(Pin_FBcl): Either the real source is found in the immediately connected Din_FBcl by the existing source connection, or the source connection is catched up if the connection from the real source is processed. Then all indirect connections are resolved.

Parameters:

gpin - The pin in graphic. For textual connection it is the dst pin. For graphic connection it is only used as OdgConnection.piSrc of all found connections, means only as source pin of the connection.

fbg - the graphic FBlock. More as one graphic FBlock can exist for one really FBlock_FBcl or FBtype_FBcl. They are referenced from OdgGBlock.fbw and OdgGBlock.fbtw

onlyKind - if null process all pins. If given process only this pin Kind.

processTypePinGraphicConnection

private boolean processTypePinGraphicConnection(OdgGPin gpinSrc,
                                                OdgConnection.ECkind onlyConnKind,
                                                java.util.Iterator<OdgConnection> iterConn,
                                                OdgConnection conn,
                                                boolean bInstanceConn)

Process the graphic connection due to type connection which determines the type of src pin

Parameters:

gpinSrc - the pin instance which's connections are handled

fbg - the graphic block from which comes pin

onlyConnKind - null for all, or handle only this connection kind

iterConn - iterator in pin to remove the connection

conn - the given connection

bInstanceConn - true then it is also an instance connection

getPinTypeViaDemux

private PinType_FBcl getPinTypeViaDemux(OdgGPin gpin)

Searches and returns the PinType on the opposite end of the deMux

Parameters:

gpin - given pin of a Demux, may be a Demux pin or Mux pin as src or dst, OdgGBlock.fbPinSrc

Returns:

null if no connection (then warning), or also null yet if the Connection goes via more deMux or Xref

connectViaDemux

private void connectViaDemux(OdgGPin gpinStart,
                             OdgGPin gpinSrc,
                             java.lang.String deMuxSelSrc,
                             java.lang.String deMuxSelDst,
                             OdgConnection.ECkind cKindArg,
                             int ixPinMux,
                             int recursion)

This is the commonly used connection function from given graphic connections to the FBcl connections regarding Demux FBlocks and slicing. As result of this operation, Pin_FBcl.connectDst and Pin_FBcl.connectSrc is set. Pin_FBcl.connDst(). This operation regards destination of ofpDemux and ofbDemux. The connection paths is tracked through all these path parts. Also connections of arrays are regarded.

• The given graphic connections as input of this operation are stored in OdgGPin.connections. There are gathered from the graphic in OdgReader#gatherConnection(OdgPage, OdgModule, org.vishia.fbcl.readOdg.xml.XmlForOdg.Draw_connector, org.vishia.fbcl.readOdg.xml.XmlForOdg).
• Before calling this operation, all Xref are dissolved and all textual connections are solved.
• All OdgGPin.connections are tracked, the OdgConnection.piDst is used, the OdgConnection.piSrc should be equal gpinSrc.
• But only connections of OdgConnection.eKind "rpagdze" are used. This excludes composition, dependency, inheritance, docu, requirement, attrib and evDataRel.
• This operation is called recursively if the connection is made longer with more as one part via FBmux or XRef. Then the gpinStart is the same. gpinSrc is the source of the part. deMuxSelDst and ixPinMux may be set.
• If the OdgGBlock.eKindBlock is FBkind_FBcl.demux, then either the pin is a deMux pin (style ofpDemux) or the pin is the source or destination of a DeMux FBlock (style ofbDemux). Then #connectViaDemux(OdgGPin, OdgGPin, String, String, OdgGPin, OdgGBlock, int, int) is called for further tracking.

Parameters:

gpinStart - The pin from where the connection starts

gpinSrc - The pin of the current connection

cKindArg - kind of the connection will be transferred from start to the end, because end connections may have OdgConnection.ECkind.unspec else.

deMuxSelSrc - For sliced FBlocks as source or bus connections using Demux: The name in the ofpDemux pin.

deMuxSelDst - For sliced FBlocks as destination using ofpDemux as input and ofbDemux OdgGBlock.fbPinSrc as output to a sliced block. The name in the ofpDemux input pin.

recursion - countered for all connection paths

connectViaDemux

private void connectViaDemux(OdgGPin gpinStart,
                             OdgGPin gpinSrc,
                             java.lang.String deMuxSelSrc,
                             java.lang.String deMuxSelDst,
                             OdgConnection.ECkind cKind,
                             OdgGPin gpinDst,
                             OdgGBlock gfbDst,
                             int ixPinMux,
                             int recursion)

connectPinSrcDstObj

private void connectPinSrcDstObj(OdgGPin gpinStart,
                                 OdgGPin gpinSrc,
                                 java.lang.String deMuxSelSrc,
                                 java.lang.String deMuxSelDst,
                                 int ixPinMux,
                                 OdgConnection conn,
                                 OdgGPin gpinDst)

Connect immediately the gpinStart OdgGPin.pinObj to the gpinDst OdgGPin.pinObj with given selection of deMuxSelSrc and deMuxSelDst. The following constellations are possible:

• deMuxSelSrc == null && deMuxSelDst == null: It is a pin connection 1:1 for all gpinStart.pinObj to all gpinDst.pinObj whereas one start pin can feed all gpinDst.pinObj or also pins can feed each other or also more as one gpinStart.pinObj() can feed only one gpinDst.pinObj() (multiple connection possible to a multiple pin).
• deMuxSelSrc !=null but deMuxSelDst == null

     FBlock-sliced.pin --->|deMuxSelSrc--->pinDst

  In the chain a deMux is given with input on mux and output on a selected ofpDemux pin. Then the sliced fbSrc is accessed with the required deMuxSelSrc.
• deMuxSelSrc ==null but deMuxSelDst != null

     pinStart --->deMuxSelDst|--->pinDst

  In the chain a deMux is given with input on a selected ofpDemux pin and mux output. Then the sliced fbDst is accessed with the required deMuxSelDst.
• The case the both deMuxSelSrc!=null && deMuxSelDst != null is excluded. This would be a mux-deMux connection.

Parameters:

gpinStart - The original output pin before all deMux

gpinSrc - The current pin after given deMux

deMuxSelSrc - String for selection deMux on gpinSrc

deMuxSelDst - String for selection deMux before gpinDst

conn - Info about connection

gpinDst - the current destination pin.

processFBlockPinGraphicConnectionTextual

private void processFBlockPinGraphicConnectionTextual(OdgGPin pi)

Processes the textual given connection. The connection is stored in OdgGPin.nameType . OdgNameTypeArray.fblockC and in OdgNameTypeArray.pinC. It is written in form "fb@pin" or "@modulePin" or "@fbVariable". The part after '@' is stored in OdgNameTypeArray.pinC, see OdgNameTypeArray. A variable after expression resp. a module variable is also addressed with '@fbVariable' whereas the 'fbVariable' is the name of the FBlock which is a FBlock_FBcl.Blocktype#VarAfterExpr.

• The OdgNameTypeArray.fblockC is optional, can be null.
• The OdgNameTypeArray.fblockC can contain more as one name separated with dot to access a FBlock internally in a given FBlock which is used as module. This is especially used to access values for a scope. It is not recommended for general use, because the property of 'pin' or 'interface' to a module is circumvented, hence only to access test values.
• The OdgNameTypeArray.pinC can be null if OdgNameTypeArray.fblockC is given. Then the 'THIZ'-port of the FBlock is used (aggregation to the whole FBlock).
• If OdgNameTypeArray.fblockC and OdgNameTypeArray.pinC is given,
  • first search an existing pin on the FBlock.
  • If not found, TODO search an create a pin which is defined in the FBtype
  • If not found, search a variable inside the module presenting by the FBlock. This is already a deeper non recommended access, recommended only for test pins.
• If OdgNameTypeArray.fblockC is null, then
  • First a Xref is searched in the module
  • Then a module instance variable is searched (can be also local, a ofpDout)
  • As last, a module pin is searched.

Parameters:

pi - The graphic pin instance

processGraphicPinInheritance

private void processGraphicPinInheritance(OdgGPin pi,
                                          OdgGBlock fbg)

Process all graphic connections which are inheritances. This should be firstly called before processing all other connections because the deviation of types should be clarified.

Parameters:

pi -

fbg -

connect_pinCXref

private boolean connect_pinCXref(java.lang.String nameXref,
                                 java.util.List<Pin_FBcl> listDinDst)

fulfillVariablesInExpressionFactors

private void fulfillVariablesInExpressionFactors()

This operation fulfills textual connections in expressions for K-pins.

getListDstXrefPins

private void getListDstXrefPins(java.util.List<OdgConnection> listAdd,
                                OdgXref xref,
                                int recursion)

addPinConnected

private void addPinConnected(java.util.List<FBlock_FBcl> listFBmdlSrc,
                             Pin_FBcl pinSrc,
                             java.lang.String connText,
                             OdgConnection.ECkind connKind,
                             Pin_FBcl pinDst,
                             int ixMux,
                             java.lang.String sElemSrc,
                             java.lang.String sElemDstArg)

Qualifies or checks admissibility of the pin with the connection kind and adds the pin to the correct idx... in the FBlock of the source pin. Some specific connections creates a second pin and adds it instead the original one. This is true for:

• connKind = Pin.ECkind#inheritance: Instead connection to FBbase#XXXfbPinDst a new pin with PinKind_FBcl.impl is created and stored in FBtype_FBcl#idxImpl.
• connText is given as simple Identifier: Instead connection to FBbase#XXXfbPinSrc of a FBlock_FBcl a new pin is created and stored in FBlock_FBcl#pinExpr.
• etc. docu more

To add #addPinConnected(FBbase, PinConnection, PinConnection, ECdst, String) is called which calls FBlock#addPinKind(PinKind_FBcl, Pin_FBcl, PinConnection, ECdst, String). This puts the correct pin in the correct index, means FBlock#idxAggr etc. and also FBtype_FBcl#idxAggr etc.
Adds also the connection from pcSrc to the pcDst pin in PinConnection#idxPinConnected and the back connection in PinConnection#idxPinBackConnected.

Parameters:

pinSrc - The original found pin maybe without exact designation PinKind_FBcl.unspec or PinKind_FBcl.fbsrc. Either the pin will be qualified by the kind of connection, or the connection kind is checked whether it is admissible for the pin kind, or a second qualified pin will be created additionally for this connection.

connText - possible text of the connection

connKind - kind of connection (adequate the style in the graphic data)

pinDst - The pin for destination of this connection.

sElemSrc - written to PinConnect_FBcl.sElemSrc used for code generation.

sElemDst - written to PinConnect_FBcl.sElemDst used for code generation.