Library Function li_getsigsrc

function hOutPort = li_getsigsrc(hInport, sctFlags)

Finds the source block outport of the signal entering the inport represented by handle <hInport> across subsystem and goto/from borders as well as packing and unpacking into/from busses. The resulting port handle is returned in <hOutPort>.

For variant subsystems, only the currently selected subsystem is taken into account, if no variant is currently selected, the respective outport of such a variant subsystem is considered the signal source.

<sctFlags>, if present, must be a struct containing zero to all boolean members out of the following: - bEnterAtomicSubs, if true, will cause the search to follow a signal into and out of atomic subsystems, otherwise an outport of an atomic subsystem is considered a signal source. Default is true. - bEnterMdlRef, if true, will cause the search to follow a signal into and out of referenced models, otherwise an outport of a model reference block is considered a signal source. An outport on the top level of the direct model parent of <hInport> will generally not be foloowed. Default is false. - 'bFollowVirtBus', if true, will cause the search to follow a signal into and out of a virtual bus created by a bus creator with the non-virtual bus flag unchecked, otherwise an outport of a bus selector of such bus is considered a signal source. Default is true. - bFollowNonVirtBus, if true, will cause the search to follow a signal into and out of a non-virtual bus created by a bus creator with the non-virtual bus flag checked, otherwise an outport of a bus selector of such bus is considered a signal source. A top-level inport is also considered a non-virtual bus. Default is true. - bFollowMembers is currently not implemented. If true, yields an error where any bus is constructed to become the signal searched for, otherwise the composing block is considered the source. Default is false. - bDiagLocal will consider a subsystem or model reference block in the diagram containing the original port a source. The same goes for any block connecting to other diagrams, like inport blocks or from blocks with no corresponding goto placed in the current diagram. Default is false. - bRetTrace will cause <hOutPort> to be a java.util.Stack, where the elements of the stack are the inport handles of all blocks leading to the signal source plus the final outport on the top. Default is false. Any other members or non-boolean values present in struct <sctFlags> yield an error.

SEE ALSO: li_getSigDsts