Instead of either of those, I will explain how to solve this problem by using a light function.<\/p>\n
A light function is a material shader that can filter the intensity of light being output by a light source.\u00a0 It can be used to give the light different intensities at different angles, with the output of the light dependant on the colour of the material, from black (no illumination) to white (full illumination).<\/p>\n
We will use this to effectively mask the parts of the light where we don’t want it to shine at full brightness.
\nFurther, we will blend between two different masks depending on the distance, giving a more realistic effect where the shadows are fairly sharp close to the light source, but get softer as the distance increases.<\/p>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/11\/MinerLampSoftShadowsPreview.jpg\")
<\/p>\n
<\/p>\n
<\/p>\n\n
Requirements<\/h2>\n
This tutorial will need the following tools:<\/p>\n
- \n
- A 3D modelling package<\/li>\n
- An image manipulation tool (IrfanView<\/a> is suggested, as I have included a batch script which makes use of it to automate some steps.)<\/li>\n
- AMD CubeMapGen<\/a><\/li>\n<\/ul>\n
<\/p>\n
The model<\/h2>\n
The first step is to create the model that you wish the light source to be inside.\u00a0 That is a very complicated subject, far beyond the scope of this tutorial.<\/p>\n
I will be using this miner’s lamp as the example model.<\/p>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/10\/SafetyLamp-566x800.jpg\")
<\/a>A Miner’s Lamp model<\/p><\/div>\n
This model has a cylindrical area which will contain the light.\u00a0 The position of the light is specified by a socket (which the Point Light component will be attached to inside Unreal.)<\/p>\n
The expectation would be for the light produced by this to be blocked in a cylinder at the top and the bottom, and to have six small vertical bars of shadow where the support beams are.<\/p>\n
<\/p>\n
Creating a cubemap for the light mask<\/h2>\n
We will need to create a cubemap to act as a mask for which sides of the lamp are obstructed.
\nThe cubemap will effectively be a 360\u00b0 view from the position of the light source, with white for the angles at which the light escapes the lamp and black for the angles where is obstructed.<\/p>\nI created the cubemap for the lantern by making a copy of the model and placing it inside a sphere with flipped normals.
\nI painted the model itself with a pure black material, and the sphere with a pure white one.\u00a0 (I also subdivided and smoothed the mesh to make the shape of the shadow more rounded than the actual in-game model.)<\/p>\n![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/10\/LanternInSphere.jpg\")
<\/a>Setting up a scene for capturing a cubemap<\/p><\/div>\n
The cubemap needs to be created from the point on the model where the light will originate – in this case, I created it from the socket that I placed in the model for the flame position.<\/p>\n
Most 3D modelling packages should have the capability to create a cubemap for a specific point in 3D space.\u00a0 The exact procedure to create a cubemap will depend on the chosen application.
\nRegardless, the process should result in a set of six images, one for each face of the cube: Back, down, front, left, right, and up.<\/p>\nThe images need to be arranged into a cube-cross image, using the following format:<\/p>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/10\/SampleCubeMap_cubecross.jpg\")
<\/a>A cross view of a sample cubemap with labelled sides<\/p><\/div>\n
<\/p>\n
The following Windows batch script will use IrfanView to rotate and place the six images of the cubemap into the appropriate cross position.
\nIt assumes that the input images are named as follows (replace baseFilename with the appropriate name of for the cubemap.):<\/p>\n- \n
- baseFilename_LF.png – Left<\/li>\n
- baseFilename_RT.png – Right<\/li>\n
- baseFilename_BK.png – Back<\/li>\n
- baseFilename_FR.png – Front<\/li>\n
- baseFilename_UP.png – Up<\/li>\n
- baseFilename_DN.png – Down<\/li>\n<\/ul>\n
<\/p>\n
(To use this, modify the path to IrfanView as appropriate for your system.)<\/p>\n
@echo off\r\nset iview=\"C:\\Program Files (x86)\\IrfanView\\i_view32.exe\"\r\n\r\n%iview% %1_LF.png \/bright=-255 \/convert tmp_0.png\r\n%iview% %1_LF.png \/rotate_l \/convert tmp_1.png\r\n%iview% %1_RT.png \/rotate_r \/convert tmp_2.png\r\n%iview% %1_BK.png \/rotate_r \/rotate_r \/convert tmp_3.png\r\n%iview% %1_FR.png \/convert tmp_4.png\r\n%iview% %1_UP.png \/rotate_r \/rotate_r \/convert tmp_5.png\r\n%iview% %1_DN.png \/rotate_r \/rotate_r \/convert tmp_6.png\r\n%iview% \/panorama=(2,tmp_0.png,tmp_2.png,tmp_0.png,tmp_0.png) \/convert tmp_a.png\r\n%iview% \/panorama=(2,tmp_3.png,tmp_5.png,tmp_4.png,tmp_6.png) \/convert tmp_b.png\r\n%iview% \/panorama=(2,tmp_0.png,tmp_1.png,tmp_0.png,tmp_0.png) \/convert tmp_c.png\r\n%iview% \/panorama=(1,tmp_a.png,tmp_b.png,tmp_c.png) \/convert %1_cubecross.png\r\n\r\ndel tmp_0.png tmp_1.png tmp_2.png tmp_3.png tmp_4.png tmp_5.png tmp_6.png\r\ndel tmp_a.png tmp_b.png tmp_c.png<\/pre>\n
<\/p>\n
Save as MakeCubeCross.cmd and run from the command line with:<\/p>\n
MakeCubeCross basefilename<\/pre>\n
(You can also make the “cube cross” manually using your favourite image editing tool.)<\/p>\n
The cube cross for the miner’s lamp looks like this:<\/p>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/10\/MinerLamp_cubecross.jpg\")
<\/a>The cross view of the cubemap for the Miner’s Lamp<\/p><\/div>\n
Next, open AMD CubeMapGen.<\/p>\n
The interface of this tool is filled with a lot of buttons and it is a bit confusing.<\/p>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/11\/CubeMapGen.png\")
<\/a>The CubeMapGen interface<\/p><\/div>\n
Select the “Load Cube Cross” button near the top of the panel on the right, and open the cube cross file.<\/p>\n
Wait for a few moments for it to load.
\nNear the bottom of the panel, there is an Output Cube Size setting; configure that to an appropriate size.\u00a0 Small sizes (such as 128) might be sufficient for simple shapes, though you may need to go higher if the shape has a lot of round edges.\u00a0 I chose 512 for the lamp model.<\/p>\nSelect “Save CubeMap (.dds)”, pick a filename, and save the resulting DDS file, ready to be imported into Unreal.<\/p>\n
Leave CubeMapGen open for now, as you’ll need it again later.<\/p>\n
<\/p>\n
Setting up the basic light function in Unreal Engine<\/h2>\n
Open Unreal, import the cubemap dds, and then create a new Material for the light function.<\/p>\n
On the Details panel, change the Material Domain to Light Function.\u00a0 A light function material only has one pin – for Emissive Colour.<\/p>\n
Create a Texture Sample, select the cube map texture, and drag the output into the Emissive Colour on the material.<\/p>\n
Create a Light Vector node.\u00a0 This gives the coordinates of the light, and will be used to feed into the UV of the texture sample.
\nHowever, it appears to always be mis-rotated by 90\u00b0, so create an MF_RotateVector_90 node.
\nHook the Light Vector Node into its input, and hook its output CW Y into the UVs of the texture sampler.<\/p>\nThe completed material should look something like this:<\/p>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/10\/LightFunctionSimple-800x441.png\")
<\/a>Simple light function material<\/p><\/div>\n
The next step is to set up the lamp’s blueprint.<\/p>\n
Add a Static Mesh component for the lamp, and create a point light under it, with the appropriate parent socket.
\nOn the Point Light, scroll down the properties panel to the Light Function section, and select the newly created material as the Light Function Material.
\nThe rest of the properties don’t matter for this effect, though you might want to adjust the intensity, attenuation radius, and possibly turn on Ray Traced Distance Field Shadows.<\/p>\nTo make sure that the engine shadows don’t interfere with the fake, masked ones, make sure to turn Casts Shadows off on the lamp mesh.
\n(This does, unfortunately mean that no other light source will be to cast shadows of the lamp, but that should be fine in most cases.\u00a0 You may want to toggle the shadow casting back on at any time that the lamp is turned off.)<\/p>\n![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/10\/SimpleLightFunctionShadows-800x368.jpg\")
<\/a>The “shadows” cast by the simple light function, as they appear in-game.<\/p><\/div>\n
Here is the effect in-game.\u00a0 Notice how the cast shadow is very sharp and harsh.<\/p>\n
There are two issues here.<\/p>\n
The first\u00a0 is that the shadows remain extremely crisp, with hard edges, regardless of the distance.\u00a0 Those shadows should get softer and less defined the farther away from the light they are.<\/p>\n
The second is that the shadowed areas are pitch black.\u00a0 Realistically, there’d be enough light scatter from the surrounding surfaces to provide at least some illumination even in places that are obscured by the shadows.<\/p>\n
We’ll deal with the sharp shadows first.
\nThe idea here is to fade between two different cube maps based on the distance from the light, so that the shadows close to the light will be sharp, while those farther away will be much softer.<\/p>\nCreating a second cubemap to use at farther distances<\/h2>\n
Switch back to CubeMapGen, with the cube cross we created earlier loaded.
\nThe blue part of the control interface is used to apply a filter to the cubemap.<\/p>\nUnder Filter Type, select Gaussian to apply a Gaussian blur.
\nThe Base Filter Angle is the amount of blur to apply.\u00a0 You will probably need to play around with this value to get the exact effect that you want.\u00a0 10 is a good starting point.
\nClick the “Filter Cubemap” button near the bottom of the interface to apply the blur.\u00a0 Note that it will take several seconds to process (or minutes, depending on the level of blur and the size of the map), as indicated by the text at the top-left corner.\u00a0 The map shown in the display will be incomplete until it has finished.<\/p>\n![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/11\/MinerLamp_cubecross2.jpg\")
<\/a>The cross view of the blurred cubemap for the Miner’s Lamp<\/p><\/div>\n
Once you are happy with the level of blur, save this second cube map as .dds.<\/p>\n
<\/p>\n
Adding a distance-based blend to the second cubemap<\/h2>\n
To set up the distance-based facing, first import the second cube map into Unreal, and then go to edit the material we created earlier.<\/p>\n
Add a second Texture Sample using the new cubemap, and plug the same wire (the rotation of the light vector) into the UVs of this one as well.<\/p>\n
Add three Scalar Parameters and name them LightRadius, NearDistance, and FarDistance.
\nThe light function only has access to the distance of the surface being struck as a range between 0 and 1, where 1 represents the maximum attenuation radius of the light source.\u00a0 In order to convert that into an actual distance, the LightRadius will need to be passed into the material.
\nThe other two parameters are to allow the distances to be adjusted; anything below NearDistance will use purely the first (sharp) cubemap, while anything beyond FarDistance will use purely the second (blurred) cubemap, with anything between the two points using an appropriate fade between the two.<\/p>\nThe suggested default values are:<\/p>\n
- \n
- LightRadius: 1000<\/li>\n
- NearDistance: 100<\/li>\n
- FarDistance: 500<\/li>\n<\/ul>\n
<\/p>\n
To set up the fading, grab the CW Y output of the MF_RotateVector_90, and plug it into a VectorLength node (use the V3 pins).<\/p>\n
Then, set up the following sequence of mathematical operations:<\/p>\n
((VectorV3Length * LightRadius) - NearDistance) \/ (FarDistance - NearDistance)<\/pre>\n
And then clamp the result to the range 0 – 1.<\/p>\n
Finally, create a Lerp node between the sharp cubemap (A) and the blurred cubemap (B), using the result of the previous clamp as the alpha.<\/p>\n
The result should look something like this:<\/p>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/11\/LightFunctionLevel2-800x320.png\")
<\/a>Light function material with distance-based fading between sharp and blurred textures<\/p><\/div>\n
There’s one last step, which is to configure the lamp’s blueprint to push the radius of its light down into an instance of the material.<\/p>\n
Set up the Construction Script of the blueprint to create a dynamic material instance of the light function, set its LightFunction parameter base on the light’s attenuation radius, and then apply it as the light function to the light.<\/p>\n
- AMD CubeMapGen<\/a><\/li>\n<\/ul>\n
![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/11\/BlueprintForLightFunctionMaterial-800x276.png\")
<\/a>![\"\"](\"https:\/\/blog.nameless.zanity.net\/wp-content\/uploads\/2018\/11\/LightFunctionLevel3-800x320.png\")
<\/a>