Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision Next revisionBoth sides next revision | ||
opu_projects:active_projects:outposthd:planetstitch [2021/11/14 19:18] – created leeor_net | opu_projects:active_projects:outposthd:planetstitch [2021/11/14 20:49] – leeor_net | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{ : | ||
====== PlanetStitch ====== | ====== PlanetStitch ====== | ||
+ | PlanetStitch is very basic tool to quickly assemble frames of animation that are rendered by Blender. It then offers a preview of the planet animation and the option to save the resulting texture. | ||
- | Planets are rendered using a Blender scene file that outputs 256 frames of animation | + | === Download === |
+ | Head over to PS's GitHub release page for downloads: https:// | ||
+ | ==== Getting Started ==== | ||
+ | === Blender Scene === | ||
+ | {{ : | ||
+ | |||
+ | This scene file is used to render the individual frames of animation for planets. This document will stay be updated with changes to the file as necessary. To change the planet texture click on the Sphere, then head to Materials and then use the file chooser to choose a sphere map texture. Press Ctrl+F12 to render the animation. All frames will be saved to a folder named ' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | === Generating The Texture === | ||
+ | |||
+ | After you've rendered all 256 frames of animation, you can fire up PlanetStitch and click on the "Load Folder..." | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Depending on your hardware this will take anywhere from a few seconds to a few minutes (Windows GDI+ functions are really really slow, can't help that without using additional dependencies). Once processed you'll see the planet animation preview. From here you can click on Save Atlas to save the planet texture. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | === Previewing The Texture Atlas === | ||
+ | |||
+ | After the planet animation preview has loaded, you can double click on the planet to open up the Texture Preview window. This will allow you to scroll around to see the entirety of the generated texture. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | This is really only useful for verifying that all frames of animation have been properly loaded and blitted to the texture. | ||
+ | |||
+ | ==== Asset Requirements & Assumptions ==== | ||
+ | |||
+ | This tool is specifically designed to be used for OutpostHD to generate planet animation texture' | ||
+ | |||
+ | - That you're running Windows 10 or higher (it may work on 7 and 8 but I haven' | ||
+ | - That .NET Framework 4.7.2 is installed -- the installer will automatically download and install this for you | ||
+ | - That it's provided with a set of PNG files that are 128x128 pixels in dimension | ||
+ | - That you do not provide more than 256 images | ||
+ | - That the sequence of frames is in alpha-numeric order | ||
+ | |||
+ | If you really want to use your own tool to generate the set of animation frames expected, fine. It will only work with PNG files (it's hard coded that way and I don't plan to change that). | ||
+ | |||
+ | The output file will always be 2048x2048 pixels in dimension. | ||
+ | |||
+ | ==== Notes, Quirks & Known Issues ==== | ||
+ | |||
+ | === Notes === | ||
+ | This is a quick and dirty tool, it's not fancy and it doesn' | ||
+ | |||
+ | === Quirks === | ||
+ | It takes way longer than is really necessary to assemble the texture atlas. As stated above, this is because I'm using built in Windows GDI+ commands to do it. GDI+ is stupid slow but it's really easy to work with and doesn' | ||
+ | |||
+ | === Known Issues === | ||
+ | Sometimes after loading the animation frames it doesn' | ||
+ | |||
+ | ==== FAQ ==== | ||
+ | === Is the source code available? === | ||
+ | Yes. I'll update this section once I push it up to GitHub. | ||
+ | |||
+ | === Will you add Feature X for me? === | ||
+ | No. This is specifically purposed application. If you want to add features grab the code and add it yourself. If you want to have it included in the official release you can create a Pull Request on GitHub. | ||
+ | |||
+ | == Wouldn' | ||
+ | Yes. When we start getting the structure animations going I'll update this application to handle that as well. | ||
+ | |||
+ | === I found a bug, what should I do? === | ||
+ | Let me know on Discord or the Forums and steps to reproduce. |