Math::...yrinth(3pm)

πŸ“¦
version 129 Β· 3 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

okay bestie, buckle up πŸ’– you just opened Math::...yrinth(3pm) in your terminal β€” yes that's the truncated little name it goes by in the header, but the whole glow-up lives under Math::PlanePath::CretanLabyrinth. It's a User Contributed Perl Documentation page, it's giving infinite maze core, and I'm about to explain every last bit of it to you like we're texting at 2am. no skips. periodt.


🌸 NAME 🌸

Math::PlanePath::CretanLabyrinth β€” infinite Cretan labyrinth. that's it, that's the vibe. an endless maze, no cap. πŸ¦‹


✨ SYNOPSIS ✨

use Math::PlanePath::CretanLabyrinth;
my $path = Math::PlanePath::CretanLabyrinth->new;
my ($x, $y) = $path->n_to_xy (123);

three lines. load it, make it, ask it where point 123 lives. iconic behavior honestly. πŸ’…


πŸŒ€ DESCRIPTION πŸŒ€

okay so this is a Cretan 7-circuit style labyrinth, except it doesn't stop β€” it's extended out infinitely. she's endless fr fr. look at her:

   81--80--79--78--77--76--75--74--73--72--71--70--69         7
    |                                               |
   82 137-138-139-140-141-142-143-144-145-146-147  68         6
    |   |                                       |   |
   83 136 165-164-163-162-161-160-159-158-157 148  67         5
    |   |   |                               |   |   |
   84 135 166  49--50--51--52--53--54--55 156 149  66         4
    |   |   |   |                       |   |   |   |
   85 134 167  48   9-- 8-- 7-- 6-- 5  56 155 150  65         3
    |   |   |   |   |               |   |   |   |   |
   86 133 168  47  10  25--26--27   4  57 154 151  64         2
    |   |   |   |   |   |       |   |   |   |   |   |
   87 132 169  46  11  24  29--28   3  58 153-152  63         1
    |   |   |   |   |   |   |       |   |           |
   88 131 170  45  12  23  30   1-- 2  59--60--61--62    <- Y=0
    |   |   |   |   |   |   |
   89 130 171  44  13  22  31--32--33 186-187-188-189        -1
    |   |   |   |   |   |           |   |           |
   90 129 172  43  14  21--20--19  34 185 112-111 190        -2
    |   |   |   |   |           |   |   |   |   |   |
   91 128 173  42  15--16--17--18  35 184 113 110  ...       -3
    |   |   |   |                   |   |   |   |
   92 127 174  41--40--39--38--37--36 183 114 109            -4
    |   |   |                           |   |   |
   93 126 175-176-177-178-179-180-181-182 115 108            -5
    |   |                                   |   |
   94 125-124-123-122-121-120-119-118-117-116 107            -6
    |                                           |
   95--96--97--98--99-100-101-102-103-104-105-106            -7

                                        ^
   -7  -6  -5  -4  -3  -2  -1  X=0  1   2   3   4

the way she just keeps going?? the repeating part is those N=59 to N=189 style groups β€” bundles of 4 circuits going back and forward. that's the loop she does forever, iykyk. πŸ”

now, the gaps between the path? those are the labyrinth walls. and bestie, look at N=2,59,33,186 β€” the + where those walls join is so characteristic of this style labyrinth, it's literally her signature. main character detail only. πŸ‘‘

         |   3  |  58  |
         |      |      |
   ------+      |      +-------
                |
     1       2  |  59      60
                |
   -------------+--------------       walls
                |
    32      33  | 186     187
                |
   ------+      |      +-------
         |      |      |
         |  34  | 185  |

want to see it in action? check examples/cretan-walls.pl for a sample program that carves out the path from a solid block and leaves the walls behind. it's giving sculptor energy, we love to see it. πŸŽ€


πŸ’« FUNCTIONS πŸ’«

heads up bestie: see "FUNCTIONS" in Math::PlanePath for the behaviour that's common to all the path classes. these here are the ones this specific girl brings to the group chat.

  • $path = Math::PlanePath::CretanLabyrinth->new () β€” creates and returns a brand new path object. fresh out the box, no notes. ✨
  • ($x,$y) = $path->n_to_xy ($n) β€” returns the X,Y coordinates of point number $n on the path. points begin at 0, and if $n < 0 then the return is an empty list. also, fractional positions give you an X,Y spot along a straight line between the integer positions β€” she interpolates, slay. πŸ’…
  • $n = $path->xy_to_n ($x,$y) β€” returns the point number for coordinates $x,$y. if there's nothing at $x,$y then it returns undef. empty. ghosted. πŸ’€
  • $n = $path->n_start() β€” returns 1, the first N in the path. the beginning, the origin story, the pilot episode. 🌟

πŸ”­ SEE ALSO πŸ”­

  • Math::PlanePath
  • Math::PlanePath::SquareSpiral

🏠 HOME PAGE 🏠

http://user42.tuxfamily.org/math-planepath/index.html


πŸ“œ LICENSE πŸ“œ

Copyright 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Kevin Ryde

This file is part of Math-PlanePath.

Math-PlanePath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

Math-PlanePath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

bestie this part is serious β€” no warranty, none, zero, read the GPL for the details fr. 🫢

You should have received a copy of the GNU General Public License along with Math-PlanePath. If not, see http://www.gnu.org/licenses/.


and that's the whole page, bestie, you ate it up πŸ’– this was perl v5.32.0, dated 2021-01-23, served under the Math::...yrinth(3pm) banner. mwah. πŸŽ€βœ¨πŸ’