https://kev.town/raymarching-toolkit/ Recent content on Raymarching Toolkit for Unity Hugo -- gohugo.io en-us © 2018. All rights reserved. Tue, 27 Mar 2018 17:35:27 -0400 https://kev.town/raymarching-toolkit/reference/raymarcher/ Tue, 27 Mar 2018 17:35:27 -0400 https://kev.town/raymarching-toolkit/reference/raymarcher/ The Raymarcher component renders your raymarched scene to all cameras (the exception being any cameras with a culling mask that excludes the layer the Raymarcher’s GameObject is on). Properties Target RenderererThis Raymarcher will render into the space defined by this renderer. Otherwise, if it's null, the Raymarcher will render "everywhere" as a fullscreen effect. Draw DistanceHow far to render out the raymarcher content. Acts like a separate far plane. ResolutionA value from 0-1. https://kev.town/raymarching-toolkit/acknowledgments/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/acknowledgments/ The Raymarching Toolkit wouldn’t be possible without the inspiring work of these people and institutions, who share their techniques and help others like us! Inigo Quilez for Shadertoy, and for an extensive set of pages about raymarching online. His Shadertoy raymarching examples are MIT licensed. mercury for the hg_sdf library, a super readable library of SDF glsl code released under Creative Commons Attribution-NonCommercial (CC BY-NC). The Raymarching Toolkit originally shipped with a few snippets of code from this project mistakenly, but that code has since been removed. https://kev.town/raymarching-toolkit/examples/character-creator/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/examples/character-creator/ This example shows a character creator where the character is rendered using raymarching. With the Raymarching Toolkit, raymarched shapes and their parameters can be bound to UI elements easily. .content { max-width: 1100px; overflow-y: hidden; } iframe.webgl-example { width: 100%; border: 0; height: 700px; } var gameInstance = UnityLoader.instantiate("gameContainer", "Build/character-creator.json"); https://kev.town/raymarching-toolkit/faq/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/faq/ If don’t find your answer here, check out our itch.io community page. How do I see the generated shader? Expand the “Advanced” section of the Raymarcher component in your scene and double click the “Generated Shader” link there. Does my purchase include future updates to the toolkit? Yes. Can I use this in a build of my game? Yes–the toolkit was designed to work in platform builds, as well as in the editor. https://kev.town/raymarching-toolkit/gallery/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/gallery/ -- https://kev.town/raymarching-toolkit/installation/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/installation/ To use the Raymarching Toolkit in your Unity project, you need to import its asset package (see the Unity docs for a description of packages). 1. Download the asset package The Raymarching Toolkit for Unity is available for download at itch.io. 2. Import the Unity Package With your project open, you can navigate to the .unitypackage on disk and double click it, and Unity will import it into your project. https://kev.town/raymarching-toolkit/license/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/license/ Raymarching Toolkit for Unity License © 2018 by Kevin Watters and Fernando Ramallo all rights reserved If you purchased this toolkit, you may use it for personal and/or commercial purposes in as many projects as you like. You may not redistribute the contents of its editor scripts without permission. Additional licenses for software used by this project: See acknowledgements for projects that helped us learn to do raymarching. The toolkit makes use of MIT Licensed software. https://kev.town/raymarching-toolkit/limitations/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/limitations/ Raymarching is an unusual technique for videogame developers, so there’re some things to be aware of when using this toolkit: Performance Since raymarching is a very performance-heavy rendering technique, a complex scene will rarely reach 60FPS at full resolution. Note that the Raymarching Toolkit requires a gaming-grade GPU, and its performance is bound to certain limitations: Every operation adds a considerable performance hit: as you add objects, blends and modifiers, your max framerate will go down. https://kev.town/raymarching-toolkit/more-resources/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/more-resources/ Raymarching and related techniques are an active area of research. Online Jamie Wong’s Raymarching and Signed Distance Functions Very clear explanations with interactive demos describing what raymarching is and how to build up a shader that does it. hg_sdf (local copy) The demogroup Mercury’s glsl library of SDF primitives and “space-folding operators.” Super readable code! iq’s SDF pages These and his Shadertoy examples are some of the best places online to go to learn. https://kev.town/raymarching-toolkit/examples/museum/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/examples/museum/ .content { max-width: 1100px; overflow-y: hidden; } iframe.webgl-example { width: 100%; border: 0; height: 700px; } var gameInstance = UnityLoader.instantiate("gameContainer", "Build/museum.json"); https://kev.town/raymarching-toolkit/quick-start/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/quick-start/ Install Make sure you’ve installed the toolkit into your Unity project. Quick overview Let’s go! Let’s make this shape and learn how the toolkit works along the way: First: add a raymarched sphere Add your first raymarched object by right clicking in the Hierarchy Window, or clicking its “Create ▼” button, and then select Raymarcher → Object. You’ll see a GameObject called “Sphere” added to your scene. That GameObject has a RaymarchObject component attached to it, with its Object Snippet set to Sphere. https://kev.town/raymarching-toolkit/reference/raymarchblend/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/reference/raymarchblend/ About Add a RaymarchBlend component to a GameObject to make any RaymarchObjects in it or its children blend together. Properties RecursiveIf true, this blend will apply to all children, grand-children, etc. recursively underneath this component's Transform. SnippetThe blend snippet to apply. Built-in Blend Snippets Union Union is the "default" blend, and simply places your objects together in the scene without any modification. You don't need to add a RaymarchBlend component to get this default behavior. https://kev.town/raymarching-toolkit/reference/raymarchlight/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/reference/raymarchlight/ RaymarchLight is a component you add to any object with a Unity Light component to make it participate in the raymarching process. Inside the Unity Light component, the type of light, its intensity and color, and whether it has shadows or not are all parameters used by the Raymarcher. Additionally, you can adjust the light’s shadow penumbra size with the ShadowSharpness property. Properties Shadow SharpnessAdjusts how fuzzy this light's shadows are. https://kev.town/raymarching-toolkit/reference/raymarchmodifier/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/reference/raymarchmodifier/ With modifiers you can take the primitives you make with Objects and tweak them to make new shapes. It’s useful to think of modifiers as “bending the space” around your object. Properties GlobalIf true, this modifier will apply to all objects in the scene. Otherwise, it applies to RaymarchObjects in its own Transform, and any children. SnippetThe modifier snippet to use. Built-in Modifier Snippets Bend Displacement Mirror Pixelate Repeat Slice Twist Making your own Modifiers In the Project window, click Create -> Raymarcher -> Modifier. https://kev.town/raymarching-toolkit/reference/raymarchobject/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/reference/raymarchobject/ The RaymarchObject component adds an object primitive in your scene at the position and rotation of its Transform. Objects are primitives you use to compose raymarched scenes and objects. They are defined by signed distance functions, which is just a fancy way of describing some code that answers a question: “How far away from this object am I?” Properties ObjectSnippetWhich primitive to render MaterialSnippetThe snippet defining how rays will act when they bounce off this object Subtract None - The object will render normally. https://kev.town/raymarching-toolkit/reference/raymarchingpreferences/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/reference/raymarchingpreferences/ You can change advanced settings in the “Raymarching Toolkit Preferences” object by navigating in your Project window to Raymarching Toolkit/Assets/Resources/Raymarching Toolkit Preferences: In the Inspector window you’ll see the Preferences object. These settings apply across all Raymarchers in your project. Properties Raymarching TemplateThe default raymarching shader template the toolkit uses when you create a new Raymarcher. (Note this value can be overriden for each individual Raymarcher via its "Shader Template" https://kev.town/raymarching-toolkit/report-a-bug/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/report-a-bug/ When you find a bug, please help us out by reporting it! Please include: A description of the bug Your system environment (operating system, Unity version, version of the toolkit) Explain clearly how to reproduce the issue with step-by-step instructions Any other information you think might be useful or relevant If it’s easy for you to send a video showing it, that’s even better! Send your bug to: kevinwatters@gmail. https://kev.town/raymarching-toolkit/roadmap/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/roadmap/ Planned features Some features planned for future releases of the toolkit: Integrate with Unity’s lighting and shadow passes Export static scenes (or scenes with some dynamic elements) as slim WebGL pages as 4kb demoscene-like executables PBR (physically-based-rendering) materials like the Standard Unity shader Turn any part of your scene into a polygonal mesh Import a polygonal mesh as a 3D texture Conetracing for more performance https://kev.town/raymarching-toolkit/reference/snippets/ Mon, 01 Jan 0001 00:00:00 +0000 https://kev.town/raymarching-toolkit/reference/snippets/ Snippet Types ObjectSnippet Defines a primitive shape. MaterialSnippet Determines what happens when light hits an object. ModifierSnippet Changes space. BlendSnippet Blends object primitives together. Snippet Inputs When writing snippet code, you use HLSL like usual in Unity, with one exception. For variables you want to expose as knobs in the editor for easy tweaking, you can use the “SnippetInput” syntax, which is just a normal variable name prefixed with a dollar sign: