1.32.2 Send methods

connection ->compute:

Performs the following operations:

• if -for either graphical-, graphical<-is_displayed yields @off, undisplay the connection.
• Recompute connection<-from_handle and connection<-to_handle if these are not fixed
• Recompute the positions of these handles and update the line using connection->points if necessary.

connection ->geometry: x=[int], y=[int], width=[int], height=[int]

No-op. The coordinates of a connection are determined by the graphical objects related. See also connection->points.

connection ->initialise: from=graphical, to=graphical, link=[link], handle_from=[name]*, handle_to=[name]*

Create a connection object (automatically updating line) between the two graphicals. The first becomes connection<-from; the second connection<-to. Link is a link object describing the handles and characteristics of the line (graphical<-pen, joint<-arrows, ...). The two name arguments define the name of the handle to connect to at the connection<-from resp. connection<-to side. When omitted and there are multiple matching handles PCE will connect to the best-looking one.

Always succeeds, also if the line cannot (yet) been created because there is no common device to display the graphical on.

See also

graphical->connect

connection ->points: start_x=[int], start_y=[int], end_x=[int], end_y=[int]

Define the start and end-point of the connection. This method is called from connection->compute. connection->points is the only method to change a connection as all other methods are discarded by a redefined connection->geometry method.

connection->points may be used to manage a label for the connection.

connection ->update_link_attributes:

Re-read joint<-arrows, graphical<-texture and graphical<-pen from the connection<-link and update accordingly.