RDPipelineColorBlendStateAttachment in Godot – Complete Guide

Blending is a fundamental concept in computer graphics, whether you’re conjuring up immersive environments or dynamic effects in your game. By understanding and implementing blending techniques, you gain control over how colors mix on the screen, creating that magical illusion of translucency and depth that can make your game visuals stand out. In this tutorial, we’re diving into the RDPipelineColorBlendStateAttachment class in Godot 4, a powerful tool within the Godot engine that makes managing blend states an almost artistic endeavor.

What is RDPipelineColorBlendStateAttachment?

The RDPipelineColorBlendStateAttachment is a component of the Godot 4 rendering engine that helps define how pixels on your screen blend together. Whether you’re developing silky smooth UI elements, ghostly apparitions, or just trying to get that perfect tint on your main character’s glowing sword, blending states are crucial. This class enables you to fine-tune how the source (what you’re drawing) and destination (what’s already on screen) colors combine.

What is it for?

Imagine you’re painting on a canvas; each brushstroke combines with the layer underneath to create new hues and shades. Similarly, in game rendering, RDPipelineColorBlendStateAttachment determines the ‘brushstrokes’ for how graphics are drawn to the screen. It holds the settings for blending operations that determine whether your graphics will simply overwrite what’s already there or mingle with it to achieve effects like transparency and lighting.

Why Should I Learn It?

While Godot does a lot of the heavy lifting for you with its ready-to-use blend modes, understanding the RDPipelineColorBlendStateAttachment class equips you with the knowledge to push beyond the typical blend modes. By learning how to manipulate these settings, you enable a more expressive range of visual outcomes in your game. It’s not just about making what’s there work for you; it’s about expanding what’s possible with your game’s graphics. Such expertise can transform good graphics into breathtaking experiences, and that’s a skill worth mastering.

CTA Small Image

Setting Up Your Blend States

To begin working with the RDPipelineColorBlendStateAttachment class, you need to first create an instance of it and set up the blend factors. These factors dictate how the source and destination colors are weighted during the blend. Here’s a basic setup:

var color_blend = RDPipelineColorBlendStateAttachment.new()
color_blend.blend_enable = true
color_blend.src_color_blend_factor = BlendFactor.SRC_ALPHA
color_blend.dst_color_blend_factor = BlendFactor.ONE_MINUS_SRC_ALPHA
color_blend.src_alpha_blend_factor = BlendFactor.ONE
color_blend.dst_alpha_blend_factor = BlendFactor.ZERO

In this example, we set ‘blend_enable’ to true to activate blending. The ‘src_color_blend_factor’ is set to ‘SRC_ALPHA’ while ‘dst_color_blend_factor’ is ‘ONE_MINUS_SRC_ALPHA’, which is a common setup for achieving standard alpha transparency.

Implementing Additive Blending

Additive blending is perfect for effects like fire or lighting, where colors add to each other to become brighter. See how it’s done in Godot 4:

color_blend.src_color_blend_factor = BlendFactor.ONE
color_blend.dst_color_blend_factor = BlendFactor.ONE
color_blend.src_alpha_blend_factor = BlendFactor.ONE
color_blend.dst_alpha_blend_factor = BlendFactor.ONE

The source and destination factors are set to ‘ONE’, meaning that the colors from both the source and destination are added together to produce the final color.

Creating Subtractive Blending

Subtractive blending can be useful for creating shadows or darkening effects. The setup is slightly different:

color_blend.src_color_blend_factor = BlendFactor.ZERO
color_blend.dst_color_blend_factor = BlendFactor.ONE_MINUS_SRC_COLOR
color_blend.src_alpha_blend_factor = BlendFactor.ZERO
color_blend.dst_alpha_blend_factor = BlendFactor.ONE_MINUS_SRC_ALPHA

Here, the destination color is subtracted by the source color, leading to a darker result where the two overlap.

Using Custom Color Blending

Sometimes you may want to define your own blend factors for creative effects. Godot allows you to define a custom blend mode like this:

color_blend.src_color_blend_factor = BlendFactor.DST_COLOR
color_blend.dst_color_blend_factor = BlendFactor.SRC_COLOR
color_blend.src_alpha_blend_factor = BlendFactor.DST_ALPHA
color_blend.dst_alpha_blend_factor = BlendFactor.SRC_ALPHA

Custom blend modes can give you unique results, as in this case where the source and destination colors are swapped.

By setting different blend factors, you gain precise control over the color blending in your game. Next, we’ll look into how to apply these settings to your rendering pipeline and see them in action!When implementing complex visual effects, you might need to go beyond the conventional blending equations and experiment with diverse operations. In some situations, you might want to apply different equations for color and alpha blending, which is achievable via the `color_blend_op` and `alpha_blend_op` properties.

Let’s see how we can manipulate these operations in our blend state setup:

color_blend.color_blend_op = BlendOp.ADD
color_blend.alpha_blend_op = BlendOp.SUBTRACT

The `BlendOp.ADD` is the default operation, which simply adds the colors together. However, with `BlendOp.SUBTRACT` specified for the alpha operation, the alpha of the destination will be subtracted from that of the source, providing a unique effect that could be used for stencil-like visuals or masking.

Now let’s dive into more specific examples demonstrating various blending results you can achieve:

Multiplicative Blending

This form of blending multiplies the source and destination colors, which can yield a dimming effect as if your scene is illuminated by colored light.

color_blend.src_color_blend_factor = BlendFactor.DST_COLOR
color_blend.dst_color_blend_factor = BlendFactor.ZERO
color_blend.color_blend_op = BlendOp.ADD

Inverse Blending

For effect like ghost images where you want to create an inverted color effect, you would negate the color values from each other.

color_blend.src_color_blend_factor = BlendFactor.ONE_MINUS_DST_COLOR
color_blend.dst_color_blend_factor = BlendFactor.ZERO
color_blend.color_blend_op = BlendOp.ADD

Maximum and Minimum Blending

You may want colors to only blend towards the brightest (max) or darkest (min) values. This can be executed with the `BlendOp.MAX` and `BlendOp.MIN` operations.

For brightest:

color_blend.color_blend_op = BlendOp.MAX

For darkest:

color_blend.color_blend_op = BlendOp.MIN

Screen Blending

Screen blending is another useful technique that’s commonly used to create a look similar to multiple projectors shining on the same screen. This mode is particularly good for achieving a soft light effect.

color_blend.src_color_blend_factor = BlendFactor.ONE_MINUS_DST_COLOR
color_blend.dst_color_blend_factor = BlendFactor.ONE
color_blend.color_blend_op = BlendOp.ADD

Applying Blending to Materials

Now that you’ve seen how to define blend states using the RDPipelineColorBlendStateAttachment class, you might be wondering how to apply these to your materials in Godot. You can set the blend state for your material by assigning the configured blend attachment to the material’s `render_priority` property:

var material = ShaderMaterial.new()
material.render_priority = color_blend

By mastering the blending states in Godot 4, you take a significant step in enhancing the visual quality and artistic direction of your projects. Blending is an essential tool in the toolkit of any serious game developer aiming to create visually compelling games.

Remember that while these examples provide you with practical blend modes, the real power lies in experimenting with different factors and operations to achieve the desired effect for your game. We, at Zenva, encourage you to try out these techniques and bring your unique visual style to life with Godot 4.As you continue to explore the depths of RDPipelineColorBlendStateAttachment, it’s crucial to understand how different blend factors affect the alpha and color channels respectively. Here are a variety of examples showcasing different scenarios:

Color Dodge Blending

Color dodge is a lighter blend that can push colors towards the higher end of the spectrum, making them appear more vibrant and bright.

color_blend.src_color_blend_factor = BlendFactor.ONE
color_blend.dst_color_blend_factor = BlendFactor.ONE_MINUS_SRC_COLOR
color_blend.color_blend_op = BlendOp.ADD

Color Burn Blending

Conversely, color burn provides a strong contrast effect by darkening colors, which enhances detail in darker regions.

color_blend.src_color_blend_factor = BlendFactor.ZERO
color_blend.dst_color_blend_factor = BlendFactor.ONE_MINUS_SRC_COLOR
color_blend.color_blend_op = BlendOp.ADD

Reflect Blending

Reflect blending is often used for shiny surfaces and specular highlights, imitating how light might reflect off a mirror-like surface.

color_blend.src_color_blend_factor = BlendFactor.DST_COLOR
color_blend.dst_color_blend_factor = BlendFactor.ONE
color_blend.color_blend_op = BlendOp.ADD

Overlay Blending

Overlay combines the multiply and screen blend modes in a way that retains the highlights and shadows of the base color while mixing in the blend color.

color_blend.src_color_blend_factor = BlendFactor.SRC_ALPHA
color_blend.dst_color_blend_factor = BlendFactor.ONE_MINUS_SRC_ALPHA
color_blend.color_blend_op = BlendOp.OVERLAY

Silhouette Blending

Silhouette blending is used to create an effect where the silhouette of an object is visible but its internal colors are not, useful for shadow effects or cutscenes.

color_blend.src_color_blend_factor = BlendFactor.ZERO
color_blend.dst_color_blend_factor = BlendFactor.SRC_ALPHA
color_blend.color_blend_op = BlendOp.ADD

These examples illustrate the diverse effects available through the manipulation of blending states. Be aware that while these modes can be powerful, they also have their specific use cases. Crafting the right blend mode for your materials can change the ambiance and feel of a scene entirely.

Keep in mind that not only do the blend factors define the outcome, but also the underlying colors and textures that you are blending. It is sometimes necessary to adjust texture outputs or base colors to get the perfect blend. Exploring and tweaking these combinations will allow you to create rich, dynamic visuals that take full advantage of Godot’s rendering power.

In practice, a common way to use these complex blend modes in Godot 4 is through shaders. Shaders give you the ultimate control, allowing for frame-by-frame nuanced adjustments. For example:

shader_type canvas_item;
render_mode blend_mix;

void fragment() {
    vec4 tex_color = texture(TEXTURE, UV);
    COLOR = tex_color * vec4(1.0, 1.0, 1.0, 0.5);

In this fragment shader script, we’re defining a semi-transparent blend (‘blend_mix’) and applying it to the texture’s color, resulting in a translucency effect.

To summarize, using RDPipelineColorBlendStateAttachment in Godot 4, along with shader scripts, opens up a world of visual possibilities. Push the boundaries, experiment with different blend factors and operations, and harness the full potential of blending to elevate the artistry of your game. At Zenva, we’re passionate about empowering game developers through education, and we invite you to deepen your skill set with these tools to create remarkable experiences in your gaming projects.

Where to Go Next in Your Game Development Journey

Having explored the intricate world of blending with Godot 4’s RDPipelineColorBlendStateAttachment, you’re well on your way to crafting visually stunning games. But remember, there is always more to learn and room to grow in the realm of game development. If you’re eager to continue your education and take your skills to the next level, our Godot Game Development Mini-Degree provides a thorough dive into the engine’s capabilities. From mastering 2D and 3D game creation to understanding gameplay mechanics across a variety of genres, the curriculum is designed to elevate your learnings from beginner concepts to professional-grade game development.

With Zenva, your journey doesn’t have to end here. Whether you’re just starting out or looking to polish your existing skills, our Godot courses cater to learners of all levels. Dip into the depths of GDScript, get hands-on with real-world game projects, and progress at your own pace with our 24/7 accessible content. Unleash your potential and open doors to new opportunities within the game development industry with the tools and knowledge gained through Zenva Academy.

Take that next step, and join a vibrant community of learners and gamers alike. Let’s create, learn, and grow together as we build the games of tomorrow.


Blending is an essential brush in the digital artist’s palette, and with Godot 4’s robust RDPipelineColorBlendStateAttachment, you’re equipped to paint your virtual world with unprecedented detail. By mastering these concepts, you’ve unlocked a new dimension of creativity for your projects, allowing you to blend reality with imagination in vibrant and interactive ways. But, as with any fine art, practice makes perfect. We encourage you to experiment, explore, and create with the confidence of your newfound knowledge.

Ready to take your game development ambitions even further? Embark on a comprehensive learning adventure with our Godot Game Development Mini-Degree. Whether you are a beginner aiming for a strong foundation or an advanced developer refining your artistic toolkit, Zenva Academy is your partner in this creative quest. Join us and unlock the full potential of your game development skills—your journey toward crafting captivating game experiences is just a click away!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.