struct SF::BlendMode

• SF::BlendMode
• Struct
• Value
• Object

Overview

Blending modes for drawing

SF::BlendMode is a struct that represents a blend mode. A blend mode determines how the colors of an object you draw are mixed with the colors that are already in the buffer.

The struct is composed of 6 components, each of which has its own public member variable:

• Color Source Factor (#color_src_factor)
• Color Destination Factor (#color_dst_factor)
• Color Blend Equation (#color_equation)
• Alpha Source Factor (#alpha_src_factor)
• Alpha Destination Factor (#alpha_dst_factor)
• Alpha Blend Equation (#alpha_equation)

The source factor specifies how the pixel you are drawing contributes to the final color. The destination factor specifies how the pixel already drawn in the buffer contributes to the final color.

The color channels RGB (red, green, blue; simply referred to as color) and A (alpha; the transparency) can be treated separately. This separation can be useful for specific blend modes, but most often you won't need it and will simply treat the color as a single unit.

The blend factors and equations correspond to their OpenGL equivalents. In general, the color of the resulting pixel is calculated according to the following formula (src is the color of the source pixel, dst the color of the destination pixel, the other variables correspond to the public members, with the equations being + or - operators):

dst.rgb = color_src_factor * src.rgb (color_equation) color_dst_factor * dst.rgb
dst.a   = alpha_src_factor * src.a   (alpha_equation) alpha_dst_factor * dst.a

All factors and colors are represented as floating point numbers between 0 and 1. Where necessary, the result is clamped to fit in that range.

The most common blending modes are defined as constants in the SF module: SF::BlendAlpha, SF::BlendAdd, SF::BlendMultiply, SF::BlendNone.

In SFML, a blend mode can be specified every time you draw a SF::Drawable object to a render target. It is part of the SF::RenderStates compound that is passed to the member function SF::RenderTarget.draw().

See also: SF::RenderStates, SF::RenderTarget

Defined in:

graphics/graphics.cr
graphics/obj.cr

Constant Summary

BlendAdd = BlendMode.new(BlendMode::SrcAlpha, BlendMode::One, BlendMode::Add, BlendMode::One, BlendMode::One, BlendMode::Add)

Add source to dest

BlendAlpha = BlendMode.new(BlendMode::SrcAlpha, BlendMode::OneMinusSrcAlpha, BlendMode::Add, BlendMode::One, BlendMode::OneMinusSrcAlpha, BlendMode::Add)

Blend source and dest according to dest alpha

BlendMultiply = BlendMode.new(BlendMode::DstColor, BlendMode::Zero)

Multiply source and dest

BlendNone = BlendMode.new(BlendMode::One, BlendMode::Zero)

Overwrite dest with source

Constructors

• .new(color_source_factor : BlendMode::Factor, color_destination_factor : BlendMode::Factor, color_blend_equation : BlendMode::Equation, alpha_source_factor : BlendMode::Factor, alpha_destination_factor : BlendMode::Factor, alpha_blend_equation : BlendMode::Equation)

  Construct the blend mode given the factors and equation.

• .new(source_factor : BlendMode::Factor, destination_factor : BlendMode::Factor, blend_equation : BlendMode::Equation = Add)

  Construct the blend mode given the factors and equation.

• .new

  Default constructor

Instance Method Summary

• #!=(right : BlendMode) : Bool

  Overload of the != operator

• #==(right : BlendMode) : Bool

  Overload of the == operator

• #alpha_dst_factor : BlendMode::Factor

  Destination blending factor for the alpha channel

• #alpha_dst_factor=(alpha_dst_factor : BlendMode::Factor)
• #alpha_equation : BlendMode::Equation

  Blending equation for the alpha channel

• #alpha_equation=(alpha_equation : BlendMode::Equation)
• #alpha_src_factor : BlendMode::Factor

  Source blending factor for the alpha channel

• #alpha_src_factor=(alpha_src_factor : BlendMode::Factor)
• #color_dst_factor : BlendMode::Factor

  Destination blending factor for the color channels

• #color_dst_factor=(color_dst_factor : BlendMode::Factor)
• #color_equation : BlendMode::Equation

  Blending equation for the color channels

• #color_equation=(color_equation : BlendMode::Equation)
• #color_src_factor : BlendMode::Factor

  Source blending factor for the color channels

• #color_src_factor=(color_src_factor : BlendMode::Factor)
• #dup : BlendMode

  Returns a shallow copy of this object.

Constructor Detail

Instance Method Detail