Represents a 32-bit INTERNAL pixel with premultiplied alpha, and can perform compositing operations with it. More...

#include "juce_PixelFormats.h"

Public Types
enum	{ indexA , indexR , indexG , indexB }
	The indexes of the different components in the byte layout of this type of colour. More...

Public Member Functions
	PixelARGB () noexcept=default
	Creates a pixel without defining its colour.

	PixelARGB (uint8 a, uint8 r, uint8 g, uint8 b) noexcept

forcedinline uint32	getNativeARGB () const noexcept
	Returns a uint32 which represents the pixel in a platform dependent format.

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).

uint32	getInARGBMemoryOrder () const noexcept
	Returns a uint32 which when written to memory, will be in the order a, r, g, b.

forcedinline uint32	getEvenBytes () const noexcept
	Return channels with an even index and insert zero bytes between them.

forcedinline uint32	getOddBytes () const noexcept
	Return channels with an odd index and insert zero bytes between them.

forcedinline uint8	getAlpha () const noexcept

forcedinline uint8	getRed () const noexcept

forcedinline uint8	getGreen () const noexcept

forcedinline uint8	getBlue () const noexcept

template<class Pixel >
forcedinline void	set (const Pixel &src) noexcept
	Copies another pixel colour over this one.

void	setARGB (uint8 a, uint8 r, uint8 g, uint8 b) noexcept
	Sets the pixel's colour from individual components.

template<class Pixel >
forcedinline void	blend (const Pixel &src) noexcept
	Blends another pixel onto this one.

forcedinline void	blend (PixelRGB src) noexcept
	Blends another pixel onto this one.

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.

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.

forcedinline void	setAlpha (uint8 newAlpha) noexcept
	Replaces the colour's alpha value with another one.

forcedinline void	multiplyAlpha (int multiplier) noexcept
	Multiplies the colour's alpha value with another one.

forcedinline void	multiplyAlpha (float multiplier) noexcept

PixelARGB	getUnpremultiplied () const noexcept

forcedinline void	premultiply () noexcept
	Premultiplies the pixel's RGB values by its alpha.

forcedinline void	unpremultiply () noexcept
	Unpremultiplies the pixel's RGB values.

forcedinline void	desaturate () noexcept

Detailed Description

Represents a 32-bit INTERNAL pixel with premultiplied alpha, and can perform compositing operations with it.

This is used internally by the imaging classes.

See also: PixelRGB

@tags{Graphics}

Definition at line 58 of file juce_PixelFormats.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

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

Definition at line 302 of file juce_PixelFormats.h.

Constructor & Destructor Documentation

◆ PixelARGB()

juce::PixelARGB::PixelARGB	(	uint8	a,
		uint8	r,
		uint8	g,
		uint8	b
	)

noexcept

Definition at line 64 of file juce_PixelFormats.h.

Member Function Documentation

◆ blend() [1/3]

template<class Pixel >

forcedinline void juce::PixelARGB::blend ( const Pixel & src )

noexcept

Blends another pixel onto this one.

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

Definition at line 140 of file juce_PixelFormats.h.

◆ blend() [2/3]

template<class Pixel >

forcedinline void juce::PixelARGB::blend	(	const Pixel &	src,
		uint32	extraAlpha
	)

noexcept

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.

Definition at line 167 of file juce_PixelFormats.h.

◆ blend() [3/3]

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

noexcept

Blends another pixel onto this one.

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

Definition at line 584 of file juce_PixelFormats.h.

◆ desaturate()

forcedinline void juce::PixelARGB::desaturate ( )

noexcept

Definition at line 274 of file juce_PixelFormats.h.

◆ getAlpha()

forcedinline uint8 juce::PixelARGB::getAlpha ( ) const

noexcept

Definition at line 107 of file juce_PixelFormats.h.

◆ getBlue()

forcedinline uint8 juce::PixelARGB::getBlue ( ) const

noexcept

Definition at line 110 of file juce_PixelFormats.h.

◆ getEvenBytes()

forcedinline uint32 juce::PixelARGB::getEvenBytes ( ) const

noexcept

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.

Definition at line 100 of file juce_PixelFormats.h.

◆ getGreen()

forcedinline uint8 juce::PixelARGB::getGreen ( ) const

noexcept

Definition at line 109 of file juce_PixelFormats.h.

◆ getInARGBMaskOrder()

forcedinline uint32 juce::PixelARGB::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).

Definition at line 78 of file juce_PixelFormats.h.

◆ getInARGBMemoryOrder()

uint32 juce::PixelARGB::getInARGBMemoryOrder ( ) const

noexcept

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

Definition at line 89 of file juce_PixelFormats.h.

◆ getNativeARGB()

forcedinline uint32 juce::PixelARGB::getNativeARGB ( ) const

noexcept

Returns a uint32 which represents the pixel in a platform dependent format.

Definition at line 74 of file juce_PixelFormats.h.

◆ getOddBytes()

forcedinline uint32 juce::PixelARGB::getOddBytes ( ) const

noexcept

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.

Definition at line 104 of file juce_PixelFormats.h.

◆ getRed()

forcedinline uint8 juce::PixelARGB::getRed ( ) const

noexcept

Definition at line 108 of file juce_PixelFormats.h.

◆ getUnpremultiplied()

PixelARGB juce::PixelARGB::getUnpremultiplied ( ) const

noexcept

Definition at line 223 of file juce_PixelFormats.h.

◆ multiplyAlpha() [1/2]

forcedinline void juce::PixelARGB::multiplyAlpha ( float multiplier )

noexcept

Definition at line 217 of file juce_PixelFormats.h.

◆ multiplyAlpha() [2/2]

forcedinline void juce::PixelARGB::multiplyAlpha ( int multiplier )

noexcept

Multiplies the colour's alpha value with another one.

Definition at line 207 of file juce_PixelFormats.h.

◆ premultiply()

forcedinline void juce::PixelARGB::premultiply ( )

noexcept

Premultiplies the pixel's RGB values by its alpha.

Definition at line 231 of file juce_PixelFormats.h.

◆ set()

template<class Pixel >

forcedinline void juce::PixelARGB::set ( const Pixel & src )

noexcept

Copies another pixel colour over this one.

This doesn't blend it - this colour is simply replaced by the other one.

Definition at line 118 of file juce_PixelFormats.h.

◆ setAlpha()

forcedinline void juce::PixelARGB::setAlpha ( uint8 newAlpha )

noexcept

Replaces the colour's alpha value with another one.

Definition at line 201 of file juce_PixelFormats.h.

◆ setARGB()

void juce::PixelARGB::setARGB	(	uint8	a,
		uint8	r,
		uint8	g,
		uint8	b
	)

noexcept

Sets the pixel's colour from individual components.

Definition at line 125 of file juce_PixelFormats.h.

◆ tween()

template<class Pixel >

forcedinline void juce::PixelARGB::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.

Definition at line 184 of file juce_PixelFormats.h.

◆ unpremultiply()

forcedinline void juce::PixelARGB::unpremultiply ( )

noexcept

Unpremultiplies the pixel's RGB values.

Definition at line 253 of file juce_PixelFormats.h.

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

juce_graphics/colour/juce_PixelFormats.h

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ PixelARGB()

Member Function Documentation

◆ blend() [1/3]

◆ blend() [2/3]

◆ blend() [3/3]

◆ desaturate()

◆ getAlpha()

◆ getBlue()

◆ getEvenBytes()

◆ getGreen()

◆ getInARGBMaskOrder()

◆ getInARGBMemoryOrder()

◆ getNativeARGB()

◆ getOddBytes()

◆ getRed()

◆ getUnpremultiplied()

◆ multiplyAlpha() [1/2]

◆ multiplyAlpha() [2/2]

◆ premultiply()

◆ set()

◆ setAlpha()

◆ setARGB()

◆ tween()

◆ unpremultiply()