Marker model for storing data needed to display markers on the map. The data is retrieved from Digikam's database. More...

Inheritance diagram for Digikam::GPSMarkerTiler:

Public Types
enum	TilerFlag { FlagNull = 0 , FlagMovable = 1 }

Public Slots
void	slotNewModelData (const QList< ItemInfo > &infoList)
	Receives notifications from the album model about new items. More...

Signals
void	signalModelFilteredImages (const QList< qlonglong > &imagesId)

void	signalThumbnailAvailableForIndex (const QVariant &index, const QPixmap &pixmap)

void	signalTilesOrSelectionChanged ()

Public Member Functions
QVariant	bestRepresentativeIndexFromList (const QList< QVariant > &indices, const int sortKey) override
	This function finds the best representative marker from a group of markers. This is needed to display a thumbnail for a marker group. More...

GeoGroupState	getGlobalGroupState () override

AbstractMarkerTiler::Tile *	getTile (const TileIndex &tileIndex, const bool stopIfEmpty) override
	Returns a pointer to a tile. More...

GeoGroupState	getTileGroupState (const TileIndex &tileIndex) override

int	getTileMarkerCount (const TileIndex &tileIndex) override

QVariant	getTileRepresentativeMarker (const TileIndex &tileIndex, const int sortKey) override
	This function finds the best representative marker from a tile of markers. More...

int	getTileSelectedCount (const TileIndex &tileIndex) override

	GPSMarkerTiler (QObject const parent, ItemFilterModel const imageFilterModel, QItemSelectionModel *const selectionModel)
	Constructor. More...

bool	indicesEqual (const QIntList &a, const QIntList &b, const int upToLevel) const

bool	indicesEqual (const QVariant &a, const QVariant &b) const override
	This function compares two marker indices. More...

bool	isDirty () const

void	onIndicesClicked (const ClickInfo &clickInfo) override
	these can be implemented if you want to react to actions in geolocation interface More...

virtual void	onIndicesMoved (const TileIndex::List &tileIndicesList, const GeoCoordinates &targetCoordinates, const QPersistentModelIndex &targetSnapIndex)

QPixmap	pixmapFromRepresentativeIndex (const QVariant &index, const QSize &size) override
	This function retrieves the thumbnail for an index. More...

void	prepareTiles (const GeoCoordinates &upperLeft, const GeoCoordinates &lowerRight, int level) override
	Requests all images inside a given rectangle from the database. More...

void	regenerateTiles () override

void	removeCurrentRegionSelection ()

void	resetRootTile ()

Tile *	rootTile ()

void	setActive (const bool state) override
	Sets the map active/inactive. More...

void	setDirty (const bool state=true)

void	setPositiveFilterIsActive (const bool state)

void	setRegionSelection (const GeoCoordinates::Pair &sel)

Tile *	tileNew () override

virtual TilerFlags	tilerFlags () const
	these have to be implemented More...

	~GPSMarkerTiler () override
	Destructor. More...

Detailed Description

Marker model for storing data needed to display markers on the map. The data is retrieved from Digikam's database.

Member Enumeration Documentation

◆ TilerFlag

enum Digikam::AbstractMarkerTiler::TilerFlag

inherited

Enumerator
FlagNull
FlagMovable

Constructor & Destructor Documentation

◆ GPSMarkerTiler()

Digikam::GPSMarkerTiler::GPSMarkerTiler	(	QObject *const	parent,
		ItemFilterModel *const	imageFilterModel,
		QItemSelectionModel *const	selectionModel
	)

explicit

Constructor.

Parameters

parent the parent object

References Digikam::CoreDbAccess::databaseWatch(), Digikam::AbstractMarkerTiler::resetRootTile(), and slotNewModelData().

◆ ~GPSMarkerTiler()

Digikam::GPSMarkerTiler::~GPSMarkerTiler ( )

override

Destructor.

Member Function Documentation

◆ bestRepresentativeIndexFromList()

QVariant Digikam::GPSMarkerTiler::bestRepresentativeIndexFromList	(	const QList< QVariant > &	indices,
		const int	sortKey
	)

overridevirtual

This function finds the best representative marker from a group of markers. This is needed to display a thumbnail for a marker group.

Parameters

indices	A list containing markers, obtained by getTileRepresentativeMarker.
sortKey	Sets the criteria for selecting the representative thumbnail, a combination of the SortOptions bits.

Returns: Returns the internally used index of the marker.

Implements Digikam::AbstractMarkerTiler.

References Digikam::GPSItemInfoSorter::fitsBetter(), and getGlobalGroupState().

◆ getGlobalGroupState()

GeoGroupState Digikam::GPSMarkerTiler::getGlobalGroupState ( )

overridevirtual

Implements Digikam::AbstractMarkerTiler.

Referenced by bestRepresentativeIndexFromList(), and getTileRepresentativeMarker().

◆ getTile()

AbstractMarkerTiler::Tile * Digikam::GPSMarkerTiler::getTile	(	const TileIndex &	tileIndex,
		const bool	stopIfEmpty
	)

overridevirtual

Returns a pointer to a tile.

Parameters

tileIndex	The index of a tile.
stopIfEmpty	Determines whether child tiles are also created for empty tiles.

Implements Digikam::AbstractMarkerTiler.

References Digikam::GPSItemInfo::coordinates, Digikam::TileIndex::fromCoordinates(), Digikam::TileIndex::indexCount(), Digikam::TileIndex::lastIndex(), Digikam::TileIndex::level(), Digikam::TileIndex::linearIndex(), Digikam::TileIndex::MaxLevel, Digikam::AbstractMarkerTiler::rootTile(), and tileNew().

Referenced by getTileGroupState(), getTileMarkerCount(), and getTileRepresentativeMarker().

◆ getTileGroupState()

GeoGroupState Digikam::GPSMarkerTiler::getTileGroupState ( const TileIndex & tileIndex )

overridevirtual

Implements Digikam::AbstractMarkerTiler.

References Digikam::GroupStateComputer::addState(), Digikam::FilteredPositiveMask, Digikam::GroupStateComputer::getState(), getTile(), Digikam::RegionSelectedMask, and Digikam::SelectedNone.

◆ getTileMarkerCount()

int Digikam::GPSMarkerTiler::getTileMarkerCount ( const TileIndex & tileIndex )

overridevirtual

Implements Digikam::AbstractMarkerTiler.

References getTile().

◆ getTileRepresentativeMarker()

QVariant Digikam::GPSMarkerTiler::getTileRepresentativeMarker	(	const TileIndex &	tileIndex,
		const int	sortKey
	)

overridevirtual

This function finds the best representative marker from a tile of markers.

Parameters

tileIndex	Index of the tile from which the best marker should be found.
sortKey	Sets the criteria for selecting the representative thumbnail, a combination of the SortOptions bits.

Returns: Returns the internally used index of the marker.

Implements Digikam::AbstractMarkerTiler.

References Digikam::GPSItemInfoSorter::fitsBetter(), getGlobalGroupState(), getTile(), and Digikam::GPSItemInfo::id.

◆ getTileSelectedCount()

int Digikam::GPSMarkerTiler::getTileSelectedCount ( const TileIndex & tileIndex )

overridevirtual

Implements Digikam::AbstractMarkerTiler.

◆ indicesEqual() [1/2]

bool Digikam::AbstractMarkerTiler::indicesEqual	(	const QIntList &	a,
		const QIntList &	b,
		const int	upToLevel
	)		const

inherited

◆ indicesEqual() [2/2]

bool Digikam::GPSMarkerTiler::indicesEqual	(	const QVariant &	a,
		const QVariant &	b
	)		const

overridevirtual

This function compares two marker indices.

Implements Digikam::AbstractMarkerTiler.

◆ isDirty()

bool Digikam::AbstractMarkerTiler::isDirty ( ) const

inherited

Referenced by Digikam::ItemMarkerTiler::addMarkerIndexToGrid(), Digikam::ItemMarkerTiler::getTile(), Digikam::ItemMarkerTiler::getTileGroupState(), Digikam::ItemMarkerTiler::getTileMarkerCount(), Digikam::ItemMarkerTiler::getTileSelectedCount(), Digikam::ItemMarkerTiler::removeMarkerIndexFromGrid(), and Digikam::AbstractMarkerTiler::rootTile().

◆ onIndicesClicked()

void Digikam::GPSMarkerTiler::onIndicesClicked ( const ClickInfo & clickInfo )

overridevirtual

these can be implemented if you want to react to actions in geolocation interface

Reimplemented from Digikam::AbstractMarkerTiler.

References Digikam::AbstractMarkerTiler::ClickInfo::currentMouseMode, Digikam::AbstractMarkerTiler::ClickInfo::groupSelectionState, Digikam::MouseModeFilter, Digikam::MouseModeSelectThumbnail, Digikam::AbstractMarkerTiler::ClickInfo::representativeIndex, Digikam::SelectedAll, Digikam::SelectedMask, setPositiveFilterIsActive(), signalModelFilteredImages(), and Digikam::AbstractMarkerTiler::ClickInfo::tileIndicesList.

◆ onIndicesMoved()

void Digikam::AbstractMarkerTiler::onIndicesMoved	(	const TileIndex::List &	tileIndicesList,
		const GeoCoordinates &	targetCoordinates,
		const QPersistentModelIndex &	targetSnapIndex
	)

virtualinherited

Reimplemented in Digikam::ItemMarkerTiler.

◆ pixmapFromRepresentativeIndex()

QPixmap Digikam::GPSMarkerTiler::pixmapFromRepresentativeIndex	(	const QVariant &	index,
		const QSize &	size
	)

overridevirtual

This function retrieves the thumbnail for an index.

Parameters

index	The marker's index.
size	The size of the thumbnail.

Returns: If the thumbnail has been loaded in the ThumbnailLoadThread instance, it is returned. If not, a QPixmap is returned and ThumbnailLoadThread's signal named signalThumbnailLoaded is emitted when the thumbnail becomes available.

Implements Digikam::AbstractMarkerTiler.

References Digikam::ItemInfo::id(), and Digikam::ItemInfo::thumbnailIdentifier().

◆ prepareTiles()

void Digikam::GPSMarkerTiler::prepareTiles	(	const GeoCoordinates &	upperLeft,
		const GeoCoordinates &	lowerRight,
		int	level
	)

overridevirtual

Requests all images inside a given rectangle from the database.

This function calls the database for the images found inside a rectangle defined by upperLeft and lowerRight points. The images are returned from the database in batches.

Parameters