uRaymarching

uRaymarching is a raymarching shader templates using uShaderTemplate (the latest version of uShaderTemplate is included in this asset). The following functions are implemented:

• Create a raymarching object only by writing a distance function
• Legacy (Forward / Deferred) and UniversalRP are supported
  • HDRP will be supported in the future
• Mixed with polygon objects
• VR ready
• Standard / Unlit / Transparent
• Shadows for Directional / Spot / Point lights
• Object-space and full-screen (full-screen is only in Legacy pipelines)

Screenshots

The following shapes are rendered in a 12-polygon cube.

Check more examples here:

• https://github.com/hecomi/uRaymarchingExamples

Install

Please download the latest version of .unitypackage from the Releases page and extract it in your project.

How to use

1. Select Create > Shader > uShaderTemplate > Generator in the Project view.
2. Input Shader Name and select Shader Template from Inspector.
3. Edit items in Conditions, Variables, Properties, Distance Function, and Post Effect.
4. Press Export button or Ctrl + R to create shader from the Generator.
5. Create material in the Project view (or press Create Material button).
6. Create Cube in the Hierarchy view.
7. Apply the generated material to the cube.

Please also see uShaderTemplate to learn the detail of shader generation function.

Inspector

The UI is generated by uShaderTemplate automatically from template files located in the Assets/uRaymarching/Editor/Resources/ShaderTemplates.

Shader Templates

• Forward > Standard
  • The lighting is done by the same method as a standard surface shader in ForwardBase/Add pass.
• Forward > Unlit
  • No lighting by default so you have to write output colors manually.
• Deferred > Standard
  • The lighting is done by the same method as a standard surface shader.
• Deferred > Direct GBuffer
  • Write values directly into GBuffers without effects like GI and LightProbe.
• UniversalRP > Lit
  • Same lighting as the built-in Universal Render Pipelin/Lit shader.
• UniversalRP > Unlit
  • No lighting, and same as the built-in Universal Render Pipelin/Unlit shader.

The items in Conditions and Variables are different depending on the selected template. Please see each page for further details:

• Legacy (Forward / Deferred)
• UniversalRP

Properties

This block is inserted into a Property section in a shader.

[Header(Additional Parameters)]
_Grid("Grid", 2D) = "" {}

Distance Function

Write a distance function here. The following code is the one generating the example of morphing sphere in Screenshots section in this document.

inline float DistanceFunction(float3 pos)
{
    float r = abs(sin(2 * PI * _Time.y / 2.0));
    float d1 = RoundBox(Repeat(pos, float3(6, 6, 6)), 1 - r, r);
    float d2 = Sphere(pos, 3.0);
    float d3 = Plane(pos - float3(0, -3, 0), float3(0, 1, 0));
    return SmoothMin(SmoothMin(d1, d2, 1.0), d3, 1.0);
}

Math.cginc and Primitives.cginc are included in the generated shader, so in this example some functions like RoundBox() and Repeat() come from these include files (of cource you can write them by yourself).

Post Effect

Post Effect is similar to a surface function in a surface shader. The following code is used in the hexagon-tile example in Screenshots section.

float4 _TopColor;

inline void PostEffect(RaymarchInfo ray, inout PostEffectOutput o)
{
    float3 localPos = ToLocal(ray.endPos);
    o.Emission += smoothstep(0.48, 0.50, localPos.y) * _TopColor;
    o.Occlusion *= 1.0 - 1.0 * ray.loop / ray.maxLoop;
}

RaymarchInfo is the input and the output of a raymarching calculation and this is defined in Struct.cginc.

struct RaymarchInfo
{
    // Input
    float3 startPos;    // start position of ray
    float3 rayDir;      // ray direction
    float3 projPos;     // ComputeScreenPos-applied position
    float3 polyNormal;  // normal on polygon surface
    float minDistance;  // minimum ray distance (comes from material setting)
    float maxDistance;  // maximum ray distance (changes by the raymarching setting)
    int maxLoop;        // maximum number of loop (comes from material setting)

    // Output
    int loop;           // total number of loop of the calculation (<= maxLoop)
    float3 endPos;      // last position (= surface of the distance function)
    float lastDistance; // the final distance of the raymarching
    float totalLength;  // total ray length
    float depth;        // depth (encoded)
    float3 normal;      // normal (encoded)
};

So ray.loop / ray.maxLoop is a normalized value and becomes close to 0.0 on the position where a ray reaches easily and becomes close to 1.0 when hard. So you can use it as a factor of a rechability or 1.0 - ray.loop / ray.maxLoop as an simple and a light-weight occlusion factor.

PostEffectOutput is defferent depending on the selected shader template. For example, it is an alias of SurfaceOutputStandard in Standard template. Please see the following pages for more details.

• Legacy (Forward / Deferred)
• UniversalRP

Please see each template file by clicking Edit button on the right side of the Shader Template drop-down list for more details.

Export

Press Export button or Ctrl + R to export shader. Then, press Create Material button to generate a material which uses the shader (or create a material manually from the Project pane).

Material

• Loop
  • The maximum number of loops of raymarching in basic passes.
• Minimum Distance
  • If the distance returned by a distance function becomes lower than this value, the loop finishes.
• Distance Multiplier
  • This value is multiplied by the output of a distance function.
• Shadow Loop
  • The maximum number of loops of raymarching in shadow pass.
• Shadow Minimum Distance
  • Minimum Distance in shadow pass.
• Shadow Extra Bias
  • Additional shadow bias to avoid shadow acne.

License

The MIT License (MIT)

Copyright (c) 2016 hecomi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.