/cassowary-csharp

A C#implementation of the Cassowary constraint solving algorithm

Primary LanguageC#GNU General Public License v3.0GPL-3.0

cassowary-csharp

Build Status

This is a C# implementation of the Cassowary constraint solving algorithm (Badros et. al 2001). It is based heavily on the implementation for Rust at dylanede/cassowary-rs. The implementation does however differ in some details.

Cassowary is designed for solving constraints to lay out user interfaces. Constraints typically take the form "this button must line up with this text box", or "this box should try to be 3 times the size of this other box". Its most popular incarnation by far is in Apple's Autolayout system for Mac OS X and iOS user interfaces. UI libraries using the Cassowary algorithm manage to achieve a much more natural approach to specifying UI layouts than traditional approaches like those found in HTML.

This library is a low level interface to the solving algorithm, though it tries to be as convenient as possible. As a result it does not have any intrinsic knowledge of common user interface conventions like rectangular regions or even two dimensions. These abstractions belong in a higher level crate.

Getting Started

Add the following to your csproj file:

dotnet add package cassowary-csharp

License

Cassowary is licensed under the GNU GENERAL PUBLIC LICENSE license.