Helper to retrieve bitmaps while handling icon themes and scaling. More...

#include <bitmap_store.h>

Public Member Functions
	BITMAP_STORE ()

	~BITMAP_STORE ()=default

wxBitmap	GetBitmap (BITMAPS aBitmapId, int aHeight=-1)
	Retrieves a bitmap from the given bitmap id.

wxBitmapBundle	GetBitmapBundle (BITMAPS aBitmapId, int aMinHeight=-1)
	Constructs and returns a bitmap bundle containing all available sizes of the given ID.

wxBitmapBundle	GetDisabledBitmapBundle (BITMAPS aBitmapId)
	Constructs and returns a bitmap bundle for the given icon ID, with the bitmaps converted to disabled state according to the current UI theme.

wxBitmap	GetBitmapScaled (BITMAPS aBitmapId, int aScaleFactor, int aHeight=-1)
	Retrieves a bitmap from the given bitmap id, scaled to a given factor.

void	ThemeChanged ()
	Notifies the store that the icon theme has been changed by the user, so caches must be invalidated.

bool	IsDarkTheme () const

Private Member Functions
wxImage	getImage (BITMAPS aBitmapId, int aHeight=-1)

const wxString &	bitmapName (BITMAPS aBitmapId, int aHeight=-1)

wxString	computeBitmapName (BITMAPS aBitmapId, int aHeight=-1)

void	buildBitmapInfoCache ()

Private Attributes
std::unique_ptr< ASSET_ARCHIVE >	m_archive

std::unordered_map< std::pair< BITMAPS, int >, wxString >	m_bitmapNameCache

std::unordered_map< BITMAPS, std::vector< BITMAP_INFO > >	m_bitmapInfoCache

wxString	m_theme

Detailed Description

Helper to retrieve bitmaps while handling icon themes and scaling.

Definition at line 46 of file bitmap_store.h.

Constructor & Destructor Documentation

◆ BITMAP_STORE()

BITMAP_STORE::BITMAP_STORE ( )

Definition at line 104 of file bitmap_store.cpp.

References buildBitmapInfoCache(), PATHS::GetStockDataPath(), IMAGE_ARCHIVE, m_archive, path, ThemeChanged(), and traceBitmaps.

◆ ~BITMAP_STORE()

BITMAP_STORE::~BITMAP_STORE ( )

default

Member Function Documentation

◆ bitmapName()

const wxString & BITMAP_STORE::bitmapName	(	BITMAPS	aBitmapId,
		int	aHeight = `-1`
	)

private

Definition at line 234 of file bitmap_store.cpp.

References computeBitmapName(), and m_bitmapNameCache.

Referenced by getImage().

◆ buildBitmapInfoCache()

void BITMAP_STORE::buildBitmapInfoCache ( )

private

Definition at line 278 of file bitmap_store.cpp.

References BuildBitmapInfo(), and m_bitmapInfoCache.

Referenced by BITMAP_STORE().

◆ computeBitmapName()

wxString BITMAP_STORE::computeBitmapName	(	BITMAPS	aBitmapId,
		int	aHeight = `-1`
	)

private

Definition at line 245 of file bitmap_store.cpp.

References info, m_bitmapInfoCache, m_theme, and traceBitmaps.

Referenced by bitmapName().

◆ GetBitmap()

wxBitmap BITMAP_STORE::GetBitmap	(	BITMAPS	aBitmapId,
		int	aHeight = `-1`
	)

Retrieves a bitmap from the given bitmap id.

Parameters

aBitmapId	is from the BITMAPS enum in bitmaps_list.h
aHeight	is the requested height in pixels of the source image, or -1 for any height

Definition at line 118 of file bitmap_store.cpp.

References getImage().

Referenced by KiBitmap().

◆ GetBitmapBundle()

wxBitmapBundle BITMAP_STORE::GetBitmapBundle	(	BITMAPS	aBitmapId,
		int	aMinHeight = `-1`
	)

Constructs and returns a bitmap bundle containing all available sizes of the given ID.

Parameters

aBitmapId	is from the BITMAPS enum in bitmaps_list.h
aMinHeight	is the minimum height of the bitmaps to include in the bundle. This is important for uses of GetPreferredBitmap and more on wxBitmap bundles because wx assumes the smallest bitmap is the "original" intended size. This is a problem where some icons may be reused between controls at different intended sizes.

Definition at line 124 of file bitmap_store.cpp.

References getImage(), info, m_bitmapInfoCache, and m_theme.

Referenced by KiBitmapBundle().

◆ GetBitmapScaled()

wxBitmap BITMAP_STORE::GetBitmapScaled	(	BITMAPS	aBitmapId,
		int	aScaleFactor,
		int	aHeight = `-1`
	)

Retrieves a bitmap from the given bitmap id, scaled to a given factor.

This factor is for legacy reasons divided by 4, so a scale factor of 4 will return the original image.

Todo:: this should be improved to take advantage of a number of different resolution PNGs stored in the asset archive, so we take the closest PNG and scale it rather than always starting with a low-resolution version.

Parameters

aBitmapId	is from the BITMAPS enum in bitmaps_list.h
aScaleFactor	is used to scale the bitmap uniformly
aHeight	is the requested height in pixels of the source image to scale from

Definition at line 161 of file bitmap_store.cpp.

References getImage(), and image.

Referenced by KiScaledBitmap().