Math::...:Convex(3pm)

💖 Math::...:Convex(3pm) 💖

okay bestie, welcome to the manual page for this lil Perl module — the header up top says Math::...:Convex(3pm) (yes it's abbreviated like that, the terminal did a little truncation slay) and ngl the whole thing is short and sweet. let's get into it 🫶

---

✨ NAME ✨

Math::Polygon::Convex — a whole collection of convex algorithms. that's the whole name, that's the whole vibe 💅

---

🦋 INHERITANCE 🦋

Math::Polygon::Convex
  is an Exporter

so it's an Exporter, which means it can yeet its functions into your namespace when you ask nicely. iconic behavior ✨

---

🌸 SYNOPSIS 🌸

here's the whole thing in action, fr fr:

use Math::Polygon::Convex  qw/chainHull_2D/;

my @points = ( [1,2], [2,4], [5,7], [1,2] );
my $poly   = chainHull_2D @points;

look at that. import the one function, hand it some points, get a polygon back. main character energy 👑

---

💜 DESCRIPTION 💜

okay so the "convex polygon" around a set of points is literally the polygon with the minimal size that still contains all of the points. like the tightest lil blanket you can wrap around a pile of dots 🎀

This package contains one convex calculation algorithm, but may be extended with alternative implementations in the future. so rn it's a party of one, but the door's open 🚪✨

---

🔥 FUNCTIONS 🔥

chainHull_2D(@points)

Each POINT is an ARRAY of two elements: the X and Y coordinate of a point. Returned is the enclosing convex Math::Polygon object. 🦋

Algorithm by Dan Sunday — credit where credit is due bestie: <https://geometryalgorithms.com/Archive/algorithm_0109/algorithm_0109.htm>

---

🌈 SEE ALSO 🌈

This module is part of Math-Polygon version 2.00, built on September 04, 2025. Website: http://perl.overmeer.net/CPAN/ 🌐

---

🎀 LICENSE 🎀

For contributors see file ChangeLog.

This software is copyright (c) 2004-2025 by Mark Overmeer.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so like, be cool, share it, remix it, it's free free 🫶

---

okay that's the whole page!! 💖 and for the cute sign-off: this was rendered by perl v5.40.1, dated 2025-10-04, filed under Math::...:Convex(3pm) — and that's on periodt 💅✨🌸