Skip to content
Andy Baker edited this page Jul 24, 2019 · 22 revisions

Installation

There are reasonable up to date builds for Windows and Mac on the Releases page (Just click "Assets" for the release that's nearest the top and choose the zip file for either Mac or Windows as appropriate.)

Unzip it, move it somewhere convenient and then double click on the app itself.

Alternatively you can install it from itch.io

Installation from source

If you're brave then you can use the bleeding edge version directly in Unity. Download the source and open it via Unity Hub. Unity Hub will tell you the correct version of Unity to use. You're probably safe to use a slightly later version than the one I've used. i.e. If I used 2018.4f1 then 2018.4f3 or f4 will be fine and 2019.1 will also probably be fine. The more the difference, the more chance things will break.

Usage

The app will launch with a sample polyhedron filling most of the screen. You can drag it and spin it using the mouse.

There are four main tabs:

Presets

This is a good place to start playing. These are saved polyhedra that I made or stumbled across while editing and testing. I add new ones every release and they are a good showcase of what's possible. Just click and it will load and replace your current polyhedra. Some of the more complex ones can take a few seconds to appear.

You can also save your own creations here. Just type in a name and click the save button.

Finally there are buttons at the bottom to reset the presets (this won't affect any you've created unless you've used the same name as one of my default presets) and open the presets folder (useful for copying presets to another machine or sending them to somebody else).

Here's a gallery showing the current presets (correct to July 2019)

Geometry

This is the heart of Polyhydra and deserves it's own section. If you load a preset then switch to this tab to see how it is constructed. Try tweaking some of the default presets. Not every change will result in a visible difference but it should become clear as you get the hang of each operator which combinations will produce interesting results.

Learn more about creating your own polyhedral forms

Animation

This tab is experimental and doesn't do anything right now.

Appearance

This tab allows you to apply purely visual presets that don't change the geometry. They do affect, the lighting, background, textures and post-processing effects.

Usage from within the Unity editor

Open up the Main scene in the root Assets folder and play around.

The main component is called Polyhydra. Placing this on an object with a Mesh Filter and Mesh Renderer should be all you need to generate polyhedra via the GeneratePolyhedra method.

More documentation to come.

Upcoming Features

Lots hopefully...

  1. More base polyhedra (Johnson solids, torii, irregular shapes such as T-forms etc.)
  2. More operators (Goldberg/geodesic, joined medial, parameterized forms of existing operators)
  3. More pseudo-operators (The sky is the limit here. Suggestions are welcome)
  4. A better UI - I'm prototyping ideas for a more visual UI that will translate nicely to...
  5. VR support. It looks awesome in VR. I just need a nice user interface.
  6. More varied and better quality appearance presets. I'm moving to the new Unity HDRP which will allow a lot more control. I'd like to focus on more organic, filmic looks.
  7. Export and sharing features
  8. Less bugs...

A few other items I'm pondering:

  1. Allow face selection on all ops by checking that all faces sharing an edge match the rule
  2. Code all ops as primitive ops so we can better preserve face roles through the chain.
  3. Animation: truncation and stellation? P/Q animation similar to 3DS Max's Hedra?
  4. Augmentation
  5. Stellation
  6. Undo
  7. visualise the generation in slow-motion or even via animation where possible

Credits

See the Readme