return (num inputs, num outputs, height, width) The port counts and size of one of an ARRAY COMPONENT's IO symbols, sized to the legend it will actually draw. Its own function because the legend can hold a channel EXPRESSION - `Join[i+10]` where the component type alone says `Join[1]` - and only a symbol knows that text. getComponentProperties sizes from the type and so passes None; SymbolReplaceHelpers.resizedForLegend has the symbol and passes what it draws, which is what keeps the text inside the shape.

The legend of an array component's IO: what the copies do with the value, and its width. One line, unlike busTitleAndBits, which puts the width on a second line by way of a "." that addLegendText splits on. Two lines were what stopped these resizing with their width - the symbol is sized by its widest LINE, which was always the first, so the bit range never reached it - and there is room for one line because the symbol is as long as it needs to be.

The style an array component's legend is drawn in. Lighter and smaller than every other legend, because these say a name, a channel and a bit range where an ordinary legend says one word. Written down once because getComponentProperties SIZES the symbol with it and SymbolView DRAWS with it: a symbol sized against a different font is one the text runs out of.

adjust symbol (and component) dimensions based on current ports and labels of a custom component. leaves other symbols unchanged

Insert titles for bus select

Insert titles compatible with greater than 1 buswidth

Work out a label bounding box from symbol, return symbol with box added. The box has a margin Constants. componentLabelOffsetDistance around the label text outline. This function should be included at the end of any function that changes component or label position or orientation or shape.

Function to generate a new symbol Which sheets of a design hold something clocked, worked out once per design rather than once per symbol. Keyed on the LoadedComponent list by identity: it is replaced rather than mutated when the project changes, so a new one is exactly the signal that this is stale.

the output is the rotation got from the two inputs one after the other.

get the max length (in pixels) of any of the Text strings in a list Hack - for now assume text char width is constant

Returns bounding box of a component based on component id

Returns all the bounding boxes of all components in the model

Returns the correct height and width of a transformed symbol as the tuple (real H, real W). Needed because H & W in Component do not change with rotation. NB Pos in component = Pos in Symbol and DOES change with rotation!

`arrayText` is what an ARRAY COMPONENT's symbol draws in place of a number - see SymbolT.Symbol.ArrayText. A join uses it for its channel, so a carry chain reads `Join[i+1]` against `Join[i]` rather than showing what those expressions come to in copy 0. None everywhere else, and on a join whose channel is a plain number, which draws that number as it always did.

obtain map from port IDs to port names for Custom Component. for other components types this returns empty map

Returns the location of an input port based on their portId

Returns the input port positions of the specified symbols in model

Returns the bounding box of the symbol associated with compId

Returns the bounding boxes of all symbol labels in the model

Based on a symbol and an edge, if the port is a mux select, return an extra offset required for the port (because of the weird shape of the mux)

Returns the location of an output port based on their portId

Returns the output port positions of the specified symbols in model

Returns the xy offset of a side relative to the symbol topleft

Returns the location of a given portId, with good efficiency

Returns all the port locations of the given components

Given a symbol and a port, it returns the offset of the port from the top left corner of the symbol

hack so that bounding box of splitwire, mergewires can be smaller height relative to ports

Gives the port positions to the render function, it gives the moving port pos where the mouse is, if there is a moving port

Decodes the component type into component labels

returns the true centre of a component's symbol

Returns the correct height and width of a transformed symbol as the tuple (real H, real W). Needed because H & W in Component do not change with rotation. NB Pos in component = Pos in Symbol and DOES change with rotation!

returns the true centre of a symbol, taking into account its current rotation

Returns the bounding box of a symbol. It is defined by the height and the width as well as the x,y position of the symbol. Works with rotation. For a rotated symbol, TopLeft = Pos, and H,W swapped in getrotatedHAndW

Returns color for the fill of a symbol (when not selected) Depends on theme and whether symbol is closed or not.

Given a symbol and a Port, it returns the orientation of the port

Returns the locations of a given input port and output port based on their portId

work out the initial (default) port placing for a componenent. also used for legacy circuits loaded without port layoiut info.

Returns true if an edge has the select port of a mux

make a completely new component

Needed because the I/Os of a custom component can be changed on anotehr sheet. When the component is reloaded its port maps will be inconsistent. This function keeps existing layout, and adds new I/Os or deletes old ones.

Modify port position maps to move an existing Lefthand port (index in the list) to the bottom edge

By default all output ports are on the right, input ports on lefty, (of a normal orientation symbol). A few symbols have ports on top or bottom as defined here. Note that custom components can have ports positioned by user.

Generates a new list of ports of specified type

The widest legend a join is expected to have. Joins are sized to fit at least this, so that changing a width moves the symbol only where the text really is longer than a common case - a symbol that resizes under every keystroke in the properties box is a symbol that jumps about while being read.