Portals are the special generators used to organize the graph in a more convenient way. Sometimes it is necessary to connect some inputs and outputs on opposite sides of the graph. It is not easy to connect generators using the furthest zoom and makes it hard to read the graph.
Portals are the mean to solve the problem. One portal (an input form) has an Input connection and the other portal (an output form) has an Output connection. On generate the input portal just passes the object to the output one, connecting the two generators together.
There is no functional difference between a portal connection and the standard one.
Think of portal connection as a standard connection with no line displayed.
To switch between Input Portal and Output portal use the In/Out button in the middle.
To change the portal In/Out type (Map or Object) use the Map/Obj button to the left.
One more thing that’s important to know about portals in order to use them is the portal article. Only those portals that are linked share the same article - in the example above, the article is called “Height”. So to link the portals you’ve got to type portal article in an Input Portal and then select a typed name in an Output Portal. An article could be any name you like and which describes portal map the best in your opinion.
Portals are not linked because of an article mismatch
Portals are linked because they share the same article
In a complex graph you would like to use portals with a different articles. Keep in mind that only those portals that share the same name are connected.
Portals are cross-connected using the article principle
Multiple portal connections are also possible. To create them, use one Input Portal and multiple Output Portals. More complex combinations are also possible.
Possible portals connections
One might ask: “Why use these portals are if they could be replaced with direct connections?” It is even more confusing when using a simple graph when learning Map Magic. But I’d like to show a portal connection from a rather complex graph:
Demo scene portal system
So portals should not be used with every connection and not even on every fourth connection but they could be used from time-to-time to make a graph a bit more pretty and readable. Most likely even a complex graph will not have more than a dozen different portal articles.
Map/Object: portal input & output. Change the default "Map" it if you are going to create an objects portal.
In/Out: portal type. In-portal have the input, but does not have output. Out-portal is the one that has the output, but don't have input.
Button: shows portal connections as lines (for graph debug purpose).
Focus Button (in output portal): focuses editor window on the linked input portal.
Name field: type portal name (for input portal) or select a link from the list (for output portal).