@ Zeno Rogue Games @ Vapors of Insanity @ Necklace of the Eye @ Hydra Slayer @ [ HyperRogue ] @ Untahris @
@ About @ Downloads @ FAQ @ Gallery of Lands @ Images & Videos @ History & Naming & Credits @ Programming @ RogueViz @

Conformal/history menu

In this mode, you can do two separate things, which nevertheless work well together. One of these features is displaying the history of the game; another feature is displaying the world of HyperRogue in one of the conformal models of hyperbolic plane (see Vladimir Bulatov's presentation) -- that is, ones where angles do not change, thus there is no distortion. This document explains how to use the features of the conformal/history menu (CH menu for shot).

Line animation

Interestingly, unless you return to a place you have been before, most of the path your character takes can be approximated by a straight line in the hyperbolic plane. The only exceptions are the cases when you return to a place you have been before and wander in another direction -- this typically happens during the Yendor quest, and also in the Ivory Tower and Yendorian Forest.

Press 'e' in the CH menu, and the game will start automatically scrolling along this straight line. Note that this could be considered cheating in some situations, so it is only allowed after gameover, or in the cheat mode. Obviously, you also need to move from your starting point a bit.

You can also press 'a' to configure the speed of this animation, and 'r' to rotate it. You can also press 'i' to include the character's actual path, and locations of found items and killed monsters.

Poincaré half-plane model

Yendorian Forest
Poincaré half-plane model is one of the basic models that are taught in hyperbolic geometry courses. Since it uses the whole (infinite) half-plane, it is not well suited for playing HyperRogue. However, there are two nice uses for it. One is combining with the line animation ('e'): if you set the rotation parameter ('r') correctly, the world will appear to zoom in or zoom out, leading to quite a nice effect. Another one is displaying lands with large circles, equidistants, or horocycles -- again, if you set the rotation parameter ('r') correctly, these lines will appear horizontal, as on the picture above (from the Yendorian Forest). You can activate this model with 'm' in the CH menu. (Of course, in some lands, finding the direction to the center is a challenge -- in these cases, the view will be automatically rotated only in the cheat mode.)

It is possible to zoom in/out this model (and other conformal models too) by changing the 'zoom' (z) parameter in the basic HyperRogue configuration.

Band model

Band model is a not very well known model of hyperbolic plane. A certain straight line H in HyperRogue's world is taken, and that line is mapped to an Euclidean straight line E, while places further and further from H are conformally mapped into smaller and smaller places, so we obtain a band in the end. You can activate this model with 'm' in the CH menu, or see how horocycles look (again, setting the rotation appropriately) , but this model really shines with the line animation -- when H is taken to be the line connecting the starting and ending point of your travel, and the animation is basically moving the band horizontally.

Render band to a file

By activating the band model ('m') and the line animation ('e') together, you can watch the moving band on the screen, but you can also render the whole band to an image file. Change the width of the band by pressing ('d') (shift-d to reduce). Since we could obtain very long bands, they are automatically cut into segments -- press 's' to change the size of a segment. Then press 'f' to save to a file. Here are some bands obtained in this way: Chaos mode (a vertical HTML file) , going through three Camelots (a large PNG file).

HyperRogue can be also configured to render bands automatically when the game ends or the Orb of Safety is used -- press 'o' to enable this, then 'j' to decide whether include history or not.


Windy Plains
By taking the band and applying the (complex) exponent function to it, we obtain a beautiful spiral. The spiral is rendered on screen automatically when the band is rendered to a file (either manually or automatically), unless you turn it off with 'g'. The spiral is animated -- it can be rotated, or saved to a file.

Polygonal model

Emerald Mines
By Riemann's mapping theorem it is possible to conformally map the Poincaré disk model (and thus the hyperbolic plane) to any shape. These mappings are described by analytic functions in the complex plane; however, the actual formulas might be not obvious. The polygonal model (selectable with 'm') supports mapping to regular polygons, and regular stars. The number of sides can be chosen with (Shift+)'x', and the 'star factor' parameter can be changed with (Shift+)'y' to draw a star. This is done by calculating the coefficients of the Taylor series of the analytic function -- we don't exactly get a polygonal boundary in this way, but the approximation should be good enough to render the visible part of the world quite well. Press 'n' (or Shift+n) to change the degree of the approximating polynomial. (According to this discussion, a perfect square could be obtained by applying the Jacobi elliptic functions.) Note how all the straight lines (vines) in the Vineyard picture above end orthogonal to the boundary. The corners of the star look curved because of inaccuracies in the polygonal approximation, and also because the points that would be mapped here are very distant from the player. Also remember to take "high quality screenshots" (F6 in the map editor/vector graphics editor mode).

Polynomial model

In this model, the coefficients of the Taylor series which describes the conformal mapping can be given explicitly. It is possible to edit the coefficients here, but probably it's more convenient to edit the configuration file.

Other models available in HyperRogue

Crossroads III
Red Rock Valley
Windy Plains
(Hypersian Rug)
(paper model)
For completeness, some other ways that HyperRogue can use to represent its world: Models can be also switched quickly with keys (1=Gans, 2=small Poincaré, 3=normal Poincaré, 4=Klein-Beltrami). These are most useful when using spherical geometry.

It is possible to enable several of these at once -- but then, several transformations will be applied, leading to a weird result. If you enable one of the models from the CH menu in the Euclidean mode, you'll get a (glitched) conformal mapping of the plane.


Thanks to tehora for showing me Bulatov's presentation, from where I have learned about the band model, and about other possible conformal mappings. The star and the spiral are for her :) We got the idea of the spiral mapping from this art by Ross Hilbert. I wanted to draw the HyperRogue world in a square form after seeing Escher's Square Limit, although a closer inspection reveals that this woodcut is not actually uniform (contrary to his Circle Limit, which are the Poincaré disk model). Thanks to Fulgur14 for pointing me to the square mapping discussion, and to simon_clarkstone for suggestions about automatic band writing. Azimuthal equidistant and Lambert azimuthal equi-area models are based on this video by David Madore.

@ Donate @ Project Blog @ Discuss @


Thanks to Slashie for hosting this at RogueTemple!
@ Zeno Rogue Games @ Vapors of Insanity @ Necklace of the Eye @ Hydra Slayer @ [ HyperRogue ] @ Untahris @
@ About @ Downloads @ FAQ @ Gallery of Lands @ Images & Videos @ History & Naming & Credits @ Programming @ RogueViz @