CSolver(3U)

✨ CSolver 💅 — enforces connector semantics

okay bestie, so this is from the InterViews Reference Manual, and it's giving "the backstage manager of every connection in your Unidraw app." let's get into it 🫶

🌸 SYNOPSIS 🌸

#include <Unidraw/csolver.h>

🎀 DESCRIPTION 🎀

A CSolver object defines and implements a model for specifying connectivity semantics that connector subclasses can build upon to implement their specialized semantics. no cap, it's the blueprint. Normally, only one CSolver instance is used per application, and only connector subclasses need access to it. The Unidraw class constructor initializes the csolver global to point to a CSolver instance it creates. so like… applications should NOT instantiate CSolver directly. that's not your job, that's Unidraw's job 💅

CSolver models a connection between two connectors (regardless of their particular subclass or semantics) as a pair of generic connectors with a piece of CGlue interposed. The CGlue characterizes the relationship between the connectors' centers in terms of:

• a natural size — which corresponds to the distance between the centers
• elasticity
• deformation limits

Connector subclasses specify their connectivity behavior with a CGlue instance and subsequently rely on the CSolver to reorient them to conform to that behavior. 🦋

fr fr, here's the iconic example: when a pin is told to connect itself to another pin, it registers with the global csolver a connection containing the two connectors (the pins themselves) and a piece of CGlue having zero natural size, elasticity, and deformation limits. This specification effectively constrains the connectors' centers to coincide. slay.

The connectivity semantics of other connector combinations — including those involving application-specific connectors — must be specified using CGlue. no shortcuts, bestie.

👑 PUBLIC OPERATIONS 👑

• CSolver() — Create a new instance. Application programs do not normally instantiate CSolver explicitly. (again. for the people in the back.)
• virtual void Connect(Connector*, Connector*, CGlue* = nil) — Specify a connection between two connectors, optionally with a piece of CGlue interposed. Omitting the CGlue parameter is equivalent to specifying a connection with CGlue having zero natural size, elasticity, and deformation limits. so like, no glue = fully rigid, iykyk.
• void Disconnect(Connector*, Connector*) void Disconnect(Connector*) — Destroy the connection(s) established between two connectors (that's the two-parameter form), or destroy all connections to a given connector (that's the one-parameter form). bye bestie 👋
• void Solve() — Solve instructs the CSolver to reorient connected connectors to conform to their connectivity semantics as reflected by its connection specifications. Normally this function is called automatically and only in response to Unidraw::Update. so like, don't be out here calling it yourself unless you know what you're doing 💀
• CSolverState* GetState(Connector*) void SetState(CSolverState*) — CSolverState is a class that encapsulates all the information about the connections in which a connector participates. Only CSolver can create or do anything with a CSolverState instance. GetState initializes and returns a CSolverState instance for the given connector, and SetState establishes the connections that a CSolverState instance specifies without disturbing existing connections. These operations are useful when it's necessary to reestablish a connector's connections after they've been lost — for example, by removing the connector from the component hierarchy (as caused by a command to delete the component). it's giving "restore from backup" energy ✨
• void Read(istream&) void Write(ostream&) — Explicitly read/write the csolver's contents from/to disk. Normally only a catalog calls these operations. hands off, that's catalog's moment 🎀

🌈 SEE ALSO 🌈

Catalog(3U), GGlue(3U), Connector(3U), globals(3U)

and that's the whole vibe, bestie 💖 this one's from Unidraw, dated 20 November 1990, and yeah it's still filed under CSolver(3U) because some things are simply iconic and never change. periodt. 💅✨