JUCE  v6.1.6 (6.0.8-1114)
JUCE API
Looking for a senior C++ dev?
I'm looking for work. Hire me!
juce::PixelRGB Class Reference

Represents a 24-bit RGB pixel, and can perform compositing operations on it. More...

#include <juce_PixelFormats.h>

Collaboration diagram for juce::PixelRGB:

Public Types

enum  {
  indexR = 0,
  indexG = 1,
  indexB = 2
}
 The indexes of the different components in the byte layout of this type of colour. More...
 

Public Member Functions

 PixelRGB () noexcept=default
 Creates a pixel without defining its colour. More...
 
template<class Pixel >
forcedinline void blend (const Pixel &src) noexcept
 Blends another pixel onto this one. More...
 
template<class Pixel >
forcedinline void blend (const Pixel &src, uint32 extraAlpha) noexcept
 Blends another pixel onto this one, applying an extra multiplier to its opacity. More...
 
forcedinline void blend (PixelRGB src) noexcept
 
forcedinline void desaturate () noexcept
 
forcedinline uint8 getAlpha () const noexcept
 
forcedinline uint8 getBlue () const noexcept
 
forcedinline uint32 getEvenBytes () const noexcept
 Return channels with an even index and insert zero bytes between them. More...
 
forcedinline uint8 getGreen () const noexcept
 
forcedinline uint32 getInARGBMaskOrder () const noexcept
 Returns a uint32 which will be in argb order as if constructed with the following mask operation ((alpha << 24) | (red << 16) | (green << 8) | blue). More...
 
uint32 getInARGBMemoryOrder () const noexcept
 Returns a uint32 which when written to memory, will be in the order a, r, g, b. More...
 
forcedinline uint32 getNativeARGB () const noexcept
 Returns a uint32 which represents the pixel in a platform dependent format which is compatible with the native format of a PixelARGB. More...
 
forcedinline uint32 getOddBytes () const noexcept
 Return channels with an odd index and insert zero bytes between them. More...
 
forcedinline uint8 getRed () const noexcept
 
forcedinline void multiplyAlpha (float) noexcept
 Multiplies the colour's alpha value with another one. More...
 
forcedinline void multiplyAlpha (int) noexcept
 Multiplies the colour's alpha value with another one. More...
 
forcedinline void premultiply () noexcept
 Premultiplies the pixel's RGB values by its alpha. More...
 
template<class Pixel >
forcedinline void set (const Pixel &src) noexcept
 Copies another pixel colour over this one. More...
 
forcedinline void setAlpha (uint8) noexcept
 This method is included for compatibility with the PixelARGB class. More...
 
void setARGB (uint8, uint8 red, uint8 green, uint8 blue) noexcept
 Sets the pixel's colour from individual components. More...
 
template<class Pixel >
forcedinline void tween (const Pixel &src, uint32 amount) noexcept
 Blends another pixel with this one, creating a colour that is somewhere between the two, as specified by the amount. More...
 
forcedinline void unpremultiply () noexcept
 Unpremultiplies the pixel's RGB values. More...
 

Private Member Functions

 PixelRGB (uint32 internal) noexcept
 

Private Attributes

uint8 b
 
uint8 g
 
uint8 r
 

Detailed Description

Represents a 24-bit RGB pixel, and can perform compositing operations on it.

This is used internally by the imaging classes.

See also
PixelARGB

@tags{Graphics}

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

The indexes of the different components in the byte layout of this type of colour.

Enumerator
indexR 
indexG 
indexB 

Constructor & Destructor Documentation

◆ PixelRGB() [1/2]

juce::PixelRGB::PixelRGB ( )
defaultnoexcept

Creates a pixel without defining its colour.

◆ PixelRGB() [2/2]

juce::PixelRGB::PixelRGB ( uint32  internal)
inlineprivatenoexcept

References juce::gl::b, juce::gl::g, and juce::gl::r.

Member Function Documentation

◆ blend() [1/3]

template<class Pixel >
forcedinline void juce::PixelRGB::blend ( const Pixel &  src)
inlinenoexcept

Blends another pixel onto this one.

This takes into account the opacity of the pixel being overlaid, and blends it accordingly.

References juce::gl::alpha, juce::gl::b, juce::clampPixelComponents(), juce::gl::g, juce::maskPixelComponents(), juce::gl::r, and juce::gl::src.

◆ blend() [2/3]

template<class Pixel >
forcedinline void juce::PixelRGB::blend ( const Pixel &  src,
uint32  extraAlpha 
)
inlinenoexcept

Blends another pixel onto this one, applying an extra multiplier to its opacity.

The opacity of the pixel being overlaid is scaled by the extraAlpha factor before being used, so this can blend semi-transparently from a PixelRGB argument.

References juce::gl::alpha, juce::gl::b, juce::clampPixelComponents(), juce::gl::g, juce::maskPixelComponents(), juce::gl::r, and juce::gl::src.

◆ blend() [3/3]

forcedinline void juce::PixelRGB::blend ( PixelRGB  src)
inlinenoexcept

References juce::gl::src.

◆ desaturate()

forcedinline void juce::PixelRGB::desaturate ( )
inlinenoexcept

References juce::gl::b, juce::gl::g, and juce::gl::r.

◆ getAlpha()

forcedinline uint8 juce::PixelRGB::getAlpha ( ) const
inlinenoexcept

◆ getBlue()

forcedinline uint8 juce::PixelRGB::getBlue ( ) const
inlinenoexcept

References juce::gl::b.

◆ getEvenBytes()

forcedinline uint32 juce::PixelRGB::getEvenBytes ( ) const
inlinenoexcept

Return channels with an even index and insert zero bytes between them.

This is useful for blending operations. The exact channels which are returned is platform dependent but compatible with the return value of getEvenBytes of the PixelARGB class.

See also
PixelARGB::getEvenBytes

References juce::gl::b, and juce::gl::r.

◆ getGreen()

forcedinline uint8 juce::PixelRGB::getGreen ( ) const
inlinenoexcept

References juce::gl::g.

◆ getInARGBMaskOrder()

forcedinline uint32 juce::PixelRGB::getInARGBMaskOrder ( ) const
inlinenoexcept

Returns a uint32 which will be in argb order as if constructed with the following mask operation ((alpha << 24) | (red << 16) | (green << 8) | blue).

References juce::gl::b, juce::gl::g, and juce::gl::r.

◆ getInARGBMemoryOrder()

uint32 juce::PixelRGB::getInARGBMemoryOrder ( ) const
inlinenoexcept

Returns a uint32 which when written to memory, will be in the order a, r, g, b.

In other words, if the return-value is read as a uint8 array then the elements will be in the order of a, r, g, b

References juce::gl::b, juce::gl::g, and juce::gl::r.

◆ getNativeARGB()

forcedinline uint32 juce::PixelRGB::getNativeARGB ( ) const
inlinenoexcept

Returns a uint32 which represents the pixel in a platform dependent format which is compatible with the native format of a PixelARGB.

See also
PixelARGB::getNativeARGB

References juce::gl::b, juce::gl::g, and juce::gl::r.

◆ getOddBytes()

forcedinline uint32 juce::PixelRGB::getOddBytes ( ) const
inlinenoexcept

Return channels with an odd index and insert zero bytes between them.

This is useful for blending operations. The exact channels which are returned is platform dependent but compatible with the return value of getOddBytes of the PixelARGB class.

See also
PixelARGB::getOddBytes

References juce::gl::g.

◆ getRed()

forcedinline uint8 juce::PixelRGB::getRed ( ) const
inlinenoexcept

References juce::gl::r.

◆ multiplyAlpha() [1/2]

forcedinline void juce::PixelRGB::multiplyAlpha ( float  )
inlinenoexcept

Multiplies the colour's alpha value with another one.

◆ multiplyAlpha() [2/2]

forcedinline void juce::PixelRGB::multiplyAlpha ( int  )
inlinenoexcept

Multiplies the colour's alpha value with another one.

◆ premultiply()

forcedinline void juce::PixelRGB::premultiply ( )
inlinenoexcept

Premultiplies the pixel's RGB values by its alpha.

◆ set()

template<class Pixel >
forcedinline void juce::PixelRGB::set ( const Pixel &  src)
inlinenoexcept

Copies another pixel colour over this one.

This doesn't blend it - this colour is simply replaced by the other one. Because PixelRGB has no alpha channel, any alpha value in the source pixel is thrown away.

References juce::gl::b, juce::gl::g, juce::gl::r, and juce::gl::src.

◆ setAlpha()

forcedinline void juce::PixelRGB::setAlpha ( uint8  )
inlinenoexcept

This method is included for compatibility with the PixelARGB class.

◆ setARGB()

void juce::PixelRGB::setARGB ( uint8  ,
uint8  red,
uint8  green,
uint8  blue 
)
inlinenoexcept

Sets the pixel's colour from individual components.

References juce::gl::b, juce::Colours::blue, juce::gl::g, juce::Colours::green, juce::gl::r, and juce::Colours::red.

◆ tween()

template<class Pixel >
forcedinline void juce::PixelRGB::tween ( const Pixel &  src,
uint32  amount 
)
inlinenoexcept

Blends another pixel with this one, creating a colour that is somewhere between the two, as specified by the amount.

References juce::gl::b, juce::gl::g, juce::gl::r, and juce::gl::src.

◆ unpremultiply()

forcedinline void juce::PixelRGB::unpremultiply ( )
inlinenoexcept

Unpremultiplies the pixel's RGB values.

Member Data Documentation

◆ b

uint8 juce::PixelRGB::b
private

◆ g

uint8 juce::PixelRGB::g
private

◆ r

uint8 juce::PixelRGB::r
private

The documentation for this class was generated from the following file: