Appear and disappear cool effect in WaveEngine

In this article, I’m going to show how to create a cool effect to make the NPCs in your game appear or disappear. One of the issues that you need to resolve when you kill an enemy in your game is how to hide it from your scene. Unless, of course, you want to pile up enemy bodies.

We are going to create a custom shader in WaveEngine for our aim. If you do not already know it, we recommend reading this article before you start.

Follow the steps to create the project effect.

Create project

Start Wave Visual Editor and choose File -> New project

Set a name and folder location for your game:

Now we have a new DisappearEffect project with the default template. Download the assets zip and add them to the Assets project.

After moving assets to the Assets/Models folder, drag the teapot model to the viewport to create a teapot at the origin coordinates:

Set the entity name to teapot. This is the name that we will use to find the entity in the EntityManager.

This teapot mesh has been edited in 3DStudioMax to add 2 different texture coordinates that we will use later.

Create a custom shader

We are going to create a Custom shader from VisualStudio. Click on File -> Open C# Solution to open the DisappearEffect code project.

In VisualStudio, you can see the code project on Solution Explorer

Create a DisappearMaterial.fx file below the following folder hierarchy

Edit the DisappearMaterial.fx file with the following code:

Define standard matrices

cbuffer Matrices : register(b0)
 float4x4 WorldViewProj : packoffset(c0);
 float4x4 World : packoffset(c4);
 float4x4 WorldInverseTranspose : packoffset(c8);

Define 2 parameters on our shader:

  • Threshold: Is a value between [0 – 1] that indicates the color threshold at which the effect will cut the model.
  • BurnSize: Indicates burn texture size since cut line.
cbuffer Parameters : register(b1)
 float Threshold : packoffset(c0.x);
 float BurnSize : packoffset(c0.y);

Define 3 textures on our shader:

  • DiffuseTexture: Albedo color texture using texture coordinates 1.
  • OpacityRamp: Texture used to cut the model using texture coordinates 2.
  • BurnTexture: Texture to decorate cut line.
Texture2D DiffuseTexture : register(t0);
Texture2D OpacityRamp : register(t1);
Texture2D BurnTexture : register(t2);
SamplerState Sampler1 : register(s0);
SamplerState Sampler2 : register(s1);
SamplerState Sampler3 =
 AddressU = Clamp;
 AddressV = Clamp;

Define VertexShader Input and Output structures.  Note that our model needs two texture coordinates.

struct VS_IN
 float4 Position : POSITION; 
 float2 TexCoord1 : TEXCOORD0;
 float2 TexCoord2 : TEXCOORD1;
struct VS_OUT
 float4 Position : SV_POSITION;
 float2 TexCoord1 : TEXCOORD0;
 float2 TexCoord2 : TEXCOORD1;

Now, define the VertexShader method:

VS_OUT vsDisappear(VS_IN input)
 VS_OUT output = (VS_OUT)0;
 output.Position = mul(input.Position, WorldViewProj);
 output.TexCoord1 = input.TexCoord1;
 output.TexCoord2 = input.TexCoord2;
 return output;

And finally, the most important part, define the PixelShader method:

float4 psDisappear(VS_OUT input) : SV_Target0
	float4 color = DiffuseTexture.Sample(Sampler1, input.TexCoord1);
	float4 ramp = OpacityRamp.Sample(Sampler2, input.TexCoord2);
	half test = ramp.x - Threshold;
	if (test < BurnSize && Threshold > 0 && Threshold < 1)
		color += BurnTexture.Sample(Sampler3, float2(test * (1 / BurnSize), 0));
	return color;

Now we are going to compile the Disappear shader with DirectX tools. Create a CompileShader.cmd bash file on the DisappearEffect\SharedSource\Main\Shaders\HLSL\DisappearMaterial folder.

Edit CompileShader.cmd file with the following code:

@echo off
rem Copyright (c) Wave Corporation 2016. All rights reserved.

set error=0

set fxcpath="C:\Program Files (x86)\Windows Kits\8.1\bin\x86\fxc.exe"

call :CompileShader DisappearMaterial vs vsDisappear
call :CompileShader DisappearMaterial ps psDisappear


if %error% == 0 (
 echo Shaders compiled ok
) else (
 echo There were shader compilation errors!

exit /b

set fxc=%fxcpath% /nologo %1.fx /T %2_4_0_level_9_3 /I Structures.fxh /E %3 /Fo %3.fxo 
echo %fxc%
%fxc% || set error=1

exit /b

Execute CompileShader.cmd bash file and if everything is fine, you should see two new files in the same folder:

Add the new files to the project and set them as Embedded resources.

Create custom Material

Add a new DisappearMaterial class to the project

Edit DisappearMaterial class with the following code:

#region Using Statements
using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Text;
using WaveEngine.Common.Graphics;
using WaveEngine.Framework.Graphics;
using WaveEngine.Framework.Services;
using WaveEngine.Materials.VertexFormats;
namespace DisappearEffect
    public class DisappearMaterial : Material
        private static ShaderTechnique[] techniques =
            new ShaderTechnique("DissapearMaterialTechnique",
        [StructLayout(LayoutKind.Explicit, Size = 16)]
        private struct DisappearMaterialParameters
            public float Threshold;
            public float BurnSize;
        private DisappearMaterialParameters shaderParameters;
        private string diffuseMapPath;
        private string opacityMapPath;
        private string burnMapPath;
        #region Properties
        public override string CurrentTechnique
            get { return techniques[0].Name; }
        public Texture DiffuseMap { get; set; }
        public Texture OpacityMap { get; set; }
        public Texture BurnMap { get; set; }
        public float Threshold { get; set; }
        public float BurnSize { get; set; }
        /// <summary>
        /// Initializes a new instance of the <see cref="DisappearMaterial"/> class.
        /// </summary>
        /// <param name="diffuseMap">The diffuse map.</param>
        public DisappearMaterial(string diffuseMap, string opacityMap, string burnMap)
            : base(DefaultLayers.Opaque)
            this.SamplerMode = AddressMode.LinearClamp;
            this.diffuseMapPath = diffuseMap;
            this.opacityMapPath = opacityMap;
            this.burnMapPath = burnMap;
            this.BurnSize = 10f;
            this.shaderParameters = new DisappearMaterialParameters();
            this.Parameters = this.shaderParameters;
        /// <summary>
        /// Initializes the specified assets.
        /// </summary>
        /// <param name="assets">The assets.</param>
        /// <exception cref="System.InvalidOperationException">Disappear Material needs a valid texture.</exception>
        public override void Initialize(AssetsContainer assets)
                this.DiffuseMap = assets.LoadAsset<Texture2D>(this.diffuseMapPath);
                this.OpacityMap = assets.LoadAsset<Texture2D>(this.opacityMapPath);
                this.BurnMap = assets.LoadAsset<Texture2D>(this.burnMapPath);
            catch (Exception)
                throw new InvalidOperationException("DisappearMaterial needs a valid texture.");
        /// <summary>
        /// Sets the parameters.
        /// </summary>
        /// <param name="cached">if set to <c>true</c> [cached].</param>
        public override void SetParameters(bool cached)
            this.shaderParameters.Threshold = this.Threshold / 255f;
            this.shaderParameters.BurnSize = this.BurnSize / 100.0f;
            this.Parameters = shaderParameters;
            this.graphicsDevice.SetTexture(this.DiffuseMap, 0);
            this.graphicsDevice.SetTexture(this.OpacityMap, 1);
            this.graphicsDevice.SetTexture(this.BurnMap, 2);

Now we have Material using our shader to draw.

Create Scene Animation

Finally, edit the MyScene.cs class with the following code:

public class MyScene : Scene
       private Entity teapot;
       private DisappearMaterial disappearMaterial;
       protected override void CreateScene()
           this.teapot = this.EntityManager.Find("teapot");
           this.disappearMaterial = new DisappearMaterial(WaveContent.Assets.Textures.tile1_png,
           teapot.FindComponent<MaterialsMap>().DefaultMaterial = disappearMaterial;
       protected override void Start()
           IGameAction action = this.CreateDelayGameAction(TimeSpan.FromSeconds(1.0f))
                                .ContinueWith(new FloatAnimationGameAction(this.teapot, 0.0f, 255.0f, TimeSpan.FromSeconds(1.5f), EaseFunction.None, (v) =>
                                    this.disappearMaterial.Threshold = v;
                                .ContinueWith(new FloatAnimationGameAction(this.teapot, 255.0f, 0.0f, TimeSpan.FromSeconds(1.5f), EaseFunction.None, (v) =>
                                    this.disappearMaterial.Threshold = v;

We have created an animation that modifies material parameters to show the result of our custom effect.

Build and run our project to see the result.

You can modify the Opacity Texture or Burn Texture to get another effect.

All sample project code is available to download from github.

Facing navigation flow with Wave Engine

The navigation flow in games is a very important part that can be difficult to deal with. In this article we will introduce a possible strategy to solve this.

Wave Engine provides generic services and tools to manage scene transitions and basic navigation. However, distributing the navigation logic between different scenes and behaviors can be tricky at times and difficult to scale.

To solve this, an interesting approach is to use a service that contains all the navigation logic, managing transitions and deferred loading between scenes. Later, a simple and generic component can be used to link navigation events to buttons in the scene and hardware buttons. Continue reading Facing navigation flow with Wave Engine

How components resolve their dependencies

In this article we will learn how components resolve their dependencies with other components and how the custom attribute [RequiredComponent] works.

Entity and Components

As you know, an Entity represents a logic element of our game and it is an empty box where you can put component insides which define what the entity can do.

The logic hierarchy is handle by the EntityManager which stores the struct of all the entities in our scene. For example:

Continue reading How components resolve their dependencies

[Working on] Relative entity paths

In the next Wave Engine version, we are introducing a new feature that can help improving your productivity.

We have decided to add relative entity path in our engine, allowing to obtain an entity just knowing its path from another entity.

This will be really helpful when you’re creating components that reference other entities and:

  • You don’t know the target entity’s absolute path.
  • Your component is used several times in your scene.
  • You want to make your component / entity reusable.

Continue reading [Working on] Relative entity paths

Nine Patch in WaveEngine

What is Nine-Patch?

A Nine-Patch is an image format that adds extra information on an image file, defining what parts of it should be scaled (and which are not) when the image is rendered in a larger or smaller size. This technique was introduced in the Android SDK and is very useful for creating UI components like buttons, panels, containers, etc.

Using this technique, you can define the background of multiples UI components like panels or buttons with the same image asset. You can also create large panels with a reduced image asset so is very useful for optimizing your project resources.

Continue reading Nine Patch in WaveEngine

What’s new in Wave Engine Saw Shark (2.3.0)

New WaveEngine 2.3.0 (Saw Shark) brings a lot of new features. Although our main new feature is the new Physics 2D engine, we will expose all the new features and improvements of this version.

New Physics 2D Engine integration

WaveEngine 2.3.0 (Saw Shark) includes a native wrapper for Box2D up to 60% faster compared to our last physics engine. Furthermore the new API is faithful to the Box2D API so you can port any Box2D sample to our new WaveEngine API. 

Read this article for more details.

Box2D physics engine

Continue reading What’s new in Wave Engine Saw Shark (2.3.0)

New Animation 2D and 3D GameActions

Wave Engine 2.3.0 (Saw Shark) has added a lot of new features. One of them is a new set of GameActions specialized for animating entities. In this article you may have been realized that GameActions are a really powerful and customizable way to create your own behaviors and interact with others in an easy flow, creating sequential and parallel GameActions to animate your entities. However, they relied on the user the task of creating its own animations as WaveEngine offered the architecture.

Good news is that we’ve included a complete set of GameActions in WaveEngine.Components package. That includes type animations for simple types and transform animations for rotating, scaling and translating entities.

And because they are GameActions, they can be played in sequential order or parallel to others.

Continue reading New Animation 2D and 3D GameActions

WaveEngine 2.2.1 to 2.3 Cheat sheet

In the last WaveEngine 2.3.0 version has been added Box2D physics engine as native integration. It allows a lots of new physics features and a better performance but it brings many API changes.

WaveEditor has a Upgrader Tool that automatically upgrade your project files to last WaveEngine version but doesn’t modify your source code. So you can find some issues after upgrade your project.

This article brings you a list of common issues and how to solve them:

RigidBody and Colliders

WaveEngine 2.2.1

new RigidBody2D() 
      PhysicBodyType = PhysicBodyType.Static 

WaveEngine 2.3.0

new RigidBody2D() 
      PhysicBodyType = RigidBodyType2D.Static

Continue reading WaveEngine 2.2.1 to 2.3 Cheat sheet

Box2D integration in WaveEngine 2.3.0

Box2D is a 2D physics engine for games, for more related help, please visit

Now, in WaveEngine 2.3.0, we have integrated Box2D as 2D Physic engine. In previous versions, we use Farseer Physics (C# reimplementation of Box2D Farseer is a great tool, but we decided to step forward and include a 100% native physic engine.

Continue reading Box2D integration in WaveEngine 2.3.0