Skip to content

Commit 3daf6fb

Browse files
Propose Solution for connectorSizing (#3774)
* ProposeSolution * Reformulate * AlmostAsSuggest * Update chapters/annotations.tex Co-authored-by: Henrik Tidefelt <[email protected]>
1 parent c4aad4a commit 3daf6fb

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

chapters/annotations.tex

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1744,11 +1744,17 @@ \subsection{Connector Sizing}\label{connector-sizing}\annotationindex{connectorS
17441744

17451745
If \lstinline!connectorSizing = true!, a tool may set the variable value in a modifier automatically, if used as dimension size of a vector of connectors.
17461746
In that case the value modifier should not be edited directly by the user, and a tool may choose to not display that variable in the dialog or display it with disabled input field.
1747+
There shall be exactly one vector of connectors using the dimension size \lstinline!n! for each variable \lstinline!n! with \lstinline!connectorSizing = true!.
1748+
Other vectors of connectors that need to have the same size may use a different expression with the same value, such as \lstinline!n + 0!, to avoid that multiple vectors become associated with the \lstinline!connectorSizing! automatic updating of \lstinline!n!.
1749+
(Note that non-connector vectors may have size \lstinline!n! without becoming associated.)
17471750

17481751
\begin{nonnormative}
17491752
The \lstinline!connectorSizing! annotation is used in cases where connections to a vector of connectors shall be made and a new connection requires to resize the vector and to connect to the new index (unary connections).
17501753
The annotation allows a tool to perform these two actions in many cases automatically.
17511754
This is, e.g., very useful for state machines and for certain components of fluid libraries.
1755+
1756+
If a variable \lstinline!n! with \lstinline!connectorSizing = true! would have multiple associated vectors of connectors, some of the graphical operations described below would not work reliably.
1757+
If there is no associated vector of connectors, the user may choose to address this by removing the \lstinline!connectorSizing! annotation or the entire variable.
17521758
\end{nonnormative}
17531759

17541760
\begin{nonnormative}

0 commit comments

Comments
 (0)