Inheritance diagram for Digikam::RegionFrameItem:

Public Types
enum	Flag { NoFlags = 0 , ShowResizeHandles = 1 << 0 , MoveByDrag = 1 << 1 , GeometryEditable = ShowResizeHandles \| MoveByDrag }

Public Slots
void	setViewportRect (const QRectF &rect)

Signals
void	geometryChanged ()

void	geometryEdited ()

void	geometryOnImageChanged ()

void	positionChanged ()

void	positionOnImageChanged ()

void	sizeChanged ()

void	sizeOnImageChanged ()

Public Member Functions
QRectF	boundingRect () const override

void	changeFlags (Flags flags, bool addOrRemove)

Flags	flags () const

QGraphicsWidget *	hudWidget () const

void	moveBy (qreal dx, qreal dy)

QPoint	originalPos () const

QRect	originalRect () const

QSize	originalSize () const

GraphicsDImgItem *	parentDImgItem () const

QRectF	rect () const

	RegionFrameItem (QGraphicsItem *const parent)

QPointF	relativePos () const

QRectF	relativeRect () const

QSizeF	relativeSize () const

void	setFixedRatio (double ratio)

void	setFlags (Flags flags)

void	setHudWidget (QGraphicsWidget *const hudWidget)

void	setHudWidget (QWidget *const widget, Qt::WindowFlags wFlags=Qt::WindowFlags())

void	setHudWidgetVisible (bool visible)

void	setOriginalPos (const QPointF &posInOriginal)

void	setOriginalPos (qreal x, qreal y)

void	setOriginalRect (const QRectF &rect)

void	setOriginalRect (qreal x, qreal y, qreal width, qreal height)

void	setOriginalSize (const QSizeF &sizeInOriginal)

void	setOriginalSize (qreal width, qreal height)

void	setPos (const QPointF &zoomedPos)

void	setPos (qreal x, qreal y)

void	setRect (const QRectF &rect)

void	setRect (qreal x, qreal y, qreal width, qreal height)

void	setRectInSceneCoordinates (const QRectF &rect)

void	setRectInSceneCoordinatesAdjusted (const QRectF &rect)

void	setRelativePos (const QPointF &relativePosition)

void	setRelativePos (qreal x, qreal y)

void	setRelativeRect (const QRectF &rect)

void	setRelativeRect (qreal x, qreal y, qreal width, qreal height)

void	setRelativeSize (const QSizeF &relativeSize)

void	setRelativeSize (qreal width, qreal height)

void	setSize (const QSizeF &zoomedSize)

void	setSize (qreal width, qreal height)

QSizeF	size () const

	~RegionFrameItem () override

Protected Slots
void	imageSizeChanged (const QSizeF &)

Protected Member Functions
bool	eventFilter (QObject watched, QEvent event) override

void	hoverEnterEvent (QGraphicsSceneHoverEvent *event) override

void	hoverLeaveEvent (QGraphicsSceneHoverEvent *event) override

void	hoverMoveEvent (QGraphicsSceneHoverEvent *event) override

QVariant	itemChange (GraphicsItemChange change, const QVariant &value) override

void	mouseMoveEvent (QGraphicsSceneMouseEvent *) override

void	mousePressEvent (QGraphicsSceneMouseEvent *) override

void	mouseReleaseEvent (QGraphicsSceneMouseEvent *) override

void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget=nullptr) override

Member Enumeration Documentation

◆ Flag

enum Digikam::RegionFrameItem::Flag

Enumerator
NoFlags
ShowResizeHandles
MoveByDrag
GeometryEditable

Constructor & Destructor Documentation

◆ RegionFrameItem()

Digikam::RegionFrameItem::RegionFrameItem ( QGraphicsItem *const parent )

explicit

References GeometryEditable, Digikam::DImgChildItem::positionChanged(), setFlags(), and Digikam::DImgChildItem::sizeChanged().

◆ ~RegionFrameItem()

Digikam::RegionFrameItem::~RegionFrameItem ( )

override

Member Function Documentation

◆ boundingRect()

QRectF Digikam::RegionFrameItem::boundingRect ( ) const

override

References Digikam::DImgChildItem::boundingRect().

Referenced by Digikam::FaceGroup::closestItem(), hoverEnterEvent(), hoverLeaveEvent(), hoverMoveEvent(), and paint().

◆ changeFlags()

void Digikam::RegionFrameItem::changeFlags	(	Flags	flags,
		bool	addOrRemove
	)

References flags(), and setFlags().

Referenced by Digikam::FaceItem::setEditable(), and Digikam::FocusPointItem::setEditable().

◆ eventFilter()

bool Digikam::RegionFrameItem::eventFilter	(	QObject *	watched,
		QEvent *	event
	)

overrideprotected

◆ flags()

RegionFrameItem::Flags Digikam::RegionFrameItem::flags ( ) const

Referenced by changeFlags(), and setFlags().

◆ geometryChanged

void Digikam::DImgChildItem::geometryChanged ( )

signalinherited

◆ geometryEdited

void Digikam::RegionFrameItem::geometryEdited ( )

signal

◆ geometryOnImageChanged

void Digikam::DImgChildItem::geometryOnImageChanged ( )

signalinherited

Referenced by Digikam::DImgChildItem::setRelativePos(), and Digikam::DImgChildItem::setRelativeSize().

◆ hoverEnterEvent()

void Digikam::RegionFrameItem::hoverEnterEvent ( QGraphicsSceneHoverEvent * event )

overrideprotected

References boundingRect().

◆ hoverLeaveEvent()

void Digikam::RegionFrameItem::hoverLeaveEvent ( QGraphicsSceneHoverEvent * event )

overrideprotected

References boundingRect().

◆ hoverMoveEvent()

void Digikam::RegionFrameItem::hoverMoveEvent ( QGraphicsSceneHoverEvent * event )

overrideprotected

References boundingRect(), and GeometryEditable.

◆ hudWidget()

QGraphicsWidget * Digikam::RegionFrameItem::hudWidget ( ) const

Referenced by Digikam::AssignNameWidgetStates::AssignNameWidgetStates(), Digikam::FaceItem::setHudWidget(), and setHudWidget().

◆ imageSizeChanged

void Digikam::DImgChildItem::imageSizeChanged ( const QSizeF & )

protectedslotinherited

◆ itemChange()

QVariant Digikam::DImgChildItem::itemChange	(	GraphicsItemChange	change,
		const QVariant &	value
	)

overrideprotectedinherited

References value.

◆ mouseMoveEvent()

void Digikam::RegionFrameItem::mouseMoveEvent ( QGraphicsSceneMouseEvent * event )

overrideprotected

References Digikam::GraphicsDImgItem::boundingRect(), Digikam::CH_Bottom, Digikam::CH_Content, Digikam::CH_Left, Digikam::CH_Right, Digikam::CH_Top, Digikam::DImgChildItem::parentDImgItem(), Digikam::DImgChildItem::rect(), and Digikam::DImgChildItem::setRect().

Referenced by Digikam::RubberItem::mouseMoveEvent().

◆ mousePressEvent()

void Digikam::RegionFrameItem::mousePressEvent ( QGraphicsSceneMouseEvent * event )

overrideprotected

References Digikam::CH_Content, and GeometryEditable.

◆ mouseReleaseEvent()

void Digikam::RegionFrameItem::mouseReleaseEvent ( QGraphicsSceneMouseEvent * event )

overrideprotected

References Digikam::CH_None.

Referenced by Digikam::RubberItem::mouseReleaseEvent().

◆ moveBy()

void Digikam::DImgChildItem::moveBy	(	qreal	dx,
		qreal	dy
	)

inlineinherited

◆ originalPos()

QPoint Digikam::DImgChildItem::originalPos ( ) const

inherited

References Digikam::ImageZoomSettings::originalImageSize(), Digikam::DImgChildItem::originalSize(), Digikam::DImgChildItem::parentDImgItem(), and Digikam::GraphicsDImgItem::zoomSettings.

Referenced by Digikam::DImgChildItem::originalRect().

◆ originalRect()

QRect Digikam::DImgChildItem::originalRect ( ) const

inherited

Returns the position and size in coordinates of the original image. Note that the return value is integer based. At high zoom rates, different values of relativeRect() or zoomedRect() may result in the same originalRect(), when one pixel in the original is represented by more than one pixel on screen.

References Digikam::DImgChildItem::originalPos(), and Digikam::DImgChildItem::originalSize().

Referenced by Digikam::FaceGroup::applyItemGeometryChanges(), Digikam::FaceGroup::slotAddItemFinished(), Digikam::FocusPointGroup::slotAddItemFinished(), and Digikam::FaceGroup::slotAssigned().

◆ originalSize()

QSize Digikam::DImgChildItem::originalSize ( ) const

inherited

References Digikam::ImageZoomSettings::originalImageSize(), Digikam::DImgChildItem::parentDImgItem(), and Digikam::GraphicsDImgItem::zoomSettings.

Referenced by Digikam::DImgChildItem::originalPos(), Digikam::DImgChildItem::originalRect(), Digikam::DImgChildItem::setOriginalPos(), and Digikam::DImgChildItem::setOriginalSize().

◆ paint()

void Digikam::RegionFrameItem::paint	(	QPainter *	painter,
		const QStyleOptionGraphicsItem *	option,
		QWidget *	widget = `nullptr`
	)

overrideprotected

References boundingRect(), Digikam::CH_None, and Digikam::DImgChildItem::rect().

◆ parentDImgItem()

GraphicsDImgItem * Digikam::DImgChildItem::parentDImgItem ( ) const

inherited

If the parent item is a GraphicsDImgItem, return it, if the parent item is null or of a different class, returns 0.

Referenced by mouseMoveEvent(), Digikam::DImgChildItem::originalPos(), Digikam::DImgChildItem::originalSize(), Digikam::DImgChildItem::setOriginalPos(), and Digikam::DImgChildItem::setOriginalSize().

◆ positionChanged

void Digikam::DImgChildItem::positionChanged ( )

signalinherited

These signals are emitted in any case when the geometry changed: Either after changing the geometry relative to the original image, or when the size of the parent GraphicsDImgItem changed (zooming). positionChanged() is equivalent to listening to xChanged() and yChanged().

Referenced by RegionFrameItem().

◆ positionOnImageChanged

void Digikam::DImgChildItem::positionOnImageChanged ( )

signalinherited

These signals are emitted when the geometry, relative to the original image, of this item has changed. This happens by calling any of the methods above.

Referenced by Digikam::DImgChildItem::setRelativePos().

◆ rect()

QRectF Digikam::DImgChildItem::rect ( ) const

inherited

Returns position and size of this item, in coordinates of the parent DImg with the current zoom. This is the same result as QRectF(pos(), boundingRect()), boundingRect is virtual and may be overridden by base classes.

References Digikam::DImgChildItem::size().

Referenced by mouseMoveEvent(), paint(), Digikam::DImgChildItem::setOriginalRect(), Digikam::DImgChildItem::setRect(), Digikam::DImgChildItem::setRectInSceneCoordinates(), setRectInSceneCoordinatesAdjusted(), Digikam::DImgChildItem::setRelativeRect(), and setViewportRect().

◆ relativePos()

QPointF Digikam::DImgChildItem::relativePos ( ) const

inherited

Referenced by Digikam::DImgChildItem::setRelativePos().

◆ relativeRect()

QRectF Digikam::DImgChildItem::relativeRect ( ) const

inherited

Returns the position and size relative to the DImg displayed in the parent item. All four values are in the interval [0;1].

◆ relativeSize()

QSizeF Digikam::DImgChildItem::relativeSize ( ) const

inherited

Referenced by Digikam::DImgChildItem::setRelativeSize().

◆ setFixedRatio()

void Digikam::RegionFrameItem::setFixedRatio ( double ratio )

◆ setFlags()

void Digikam::RegionFrameItem::setFlags ( Flags flags )

References flags(), GeometryEditable, and ShowResizeHandles.

Referenced by changeFlags(), and RegionFrameItem().

◆ setHudWidget() [1/2]

void Digikam::RegionFrameItem::setHudWidget ( QGraphicsWidget *const hudWidget )

Sets a widget item as HUD item. A HUD item will be positioned relative to this item, and repositioned on position changes or resizing. Ownership of the item is taken, and it is made a child item of this item. You can also add QWidget directly. It will be wrapped in a proxy item.

References hudWidget().

Referenced by Digikam::FaceItem::setHudWidget(), and setHudWidget().

◆ setHudWidget() [2/2]

void Digikam::RegionFrameItem::setHudWidget	(	QWidget *const	widget,
		Qt::WindowFlags	wFlags = `Qt::WindowFlags()`
	)

References setHudWidget().

◆ setHudWidgetVisible()

void Digikam::RegionFrameItem::setHudWidgetVisible ( bool visible )

◆ setOriginalPos() [1/2]

void Digikam::DImgChildItem::setOriginalPos ( const QPointF & posInOriginal )

inherited

Sets the position and size of this item, in coordinates of the original image. Requires a valid parent item.

References Digikam::ImageZoomSettings::originalImageSize(), Digikam::DImgChildItem::originalSize(), Digikam::DImgChildItem::parentDImgItem(), Digikam::DImgChildItem::setRelativePos(), and Digikam::GraphicsDImgItem::zoomSettings.

Referenced by Digikam::DImgChildItem::setOriginalRect().

◆ setOriginalPos() [2/2]

void Digikam::DImgChildItem::setOriginalPos	(	qreal	x,
		qreal	y
	)

inlineinherited

◆ setOriginalRect() [1/2]

void Digikam::DImgChildItem::setOriginalRect ( const QRectF & rect )

inherited

References Digikam::DImgChildItem::rect(), Digikam::DImgChildItem::setOriginalPos(), and Digikam::DImgChildItem::setOriginalSize().

Referenced by Digikam::FaceGroup::Private::createItem(), and Digikam::FocusPointGroup::Private::createItem().

◆ setOriginalRect() [2/2]

void Digikam::DImgChildItem::setOriginalRect	(	qreal	x,
		qreal	y,
		qreal	width,
		qreal	height
	)

inlineinherited

◆ setOriginalSize() [1/2]

void Digikam::DImgChildItem::setOriginalSize ( const QSizeF & sizeInOriginal )

inherited

References Digikam::ImageZoomSettings::originalImageSize(), Digikam::DImgChildItem::originalSize(), Digikam::DImgChildItem::parentDImgItem(), Digikam::DImgChildItem::setRelativeSize(), and Digikam::GraphicsDImgItem::zoomSettings.

Referenced by Digikam::DImgChildItem::setOriginalRect().

◆ setOriginalSize() [2/2]

void Digikam::DImgChildItem::setOriginalSize	(	qreal	width,
		qreal	height
	)

inlineinherited

◆ setPos() [1/2]

void Digikam::DImgChildItem::setPos ( const QPointF & zoomedPos )

inherited

Sets the position and size of this item, in coordinates of the parent DImg item. This is accepting unscaled parent coordinates, just like the "normal" setPos() does. Requires a valid parent item.

References Digikam::DImgChildItem::setRelativePos().

Referenced by Digikam::DImgChildItem::setRect().

◆ setPos() [2/2]

void Digikam::DImgChildItem::setPos	(	qreal	x,
		qreal	y
	)

inlineinherited

◆ setRect() [1/2]

void Digikam::DImgChildItem::setRect ( const QRectF & rect )

inherited

References Digikam::DImgChildItem::rect(), Digikam::DImgChildItem::setPos(), and Digikam::DImgChildItem::setSize().

Referenced by mouseMoveEvent(), and Digikam::DImgChildItem::setRectInSceneCoordinates().

◆ setRect() [2/2]

void Digikam::DImgChildItem::setRect	(	qreal	x,
		qreal	y,
		qreal	width,
		qreal	height
	)

inlineinherited

◆ setRectInSceneCoordinates()

void Digikam::DImgChildItem::setRectInSceneCoordinates ( const QRectF & rect )

inherited

Equivalent to mapping the scene coordinates to the parent item, and calling setRect().

References Digikam::DImgChildItem::rect(), and Digikam::DImgChildItem::setRect().

Referenced by setRectInSceneCoordinatesAdjusted().

◆ setRectInSceneCoordinatesAdjusted()

void Digikam::RegionFrameItem::setRectInSceneCoordinatesAdjusted ( const QRectF & rect )

References Digikam::DImgChildItem::rect(), and Digikam::DImgChildItem::setRectInSceneCoordinates().

Referenced by Digikam::FaceGroup::slotAddItemFinished(), Digikam::FocusPointGroup::slotAddItemFinished(), Digikam::FaceGroup::slotAddItemMoving(), and Digikam::FocusPointGroup::slotAddItemMoving().

◆ setRelativePos() [1/2]

void Digikam::DImgChildItem::setRelativePos ( const QPointF & relativePosition )

inherited

Sets the position and size of this item, relative to the DImg displayed in the parent item. The values of relativePosition must be in the interval [0;1].

References Digikam::DImgChildItem::geometryOnImageChanged(), Digikam::DImgChildItem::positionOnImageChanged(), and Digikam::DImgChildItem::relativePos().

Referenced by Digikam::DImgChildItem::setOriginalPos(), Digikam::DImgChildItem::setPos(), and Digikam::DImgChildItem::setRelativeRect().

◆ setRelativePos() [2/2]

void Digikam::DImgChildItem::setRelativePos	(	qreal	x,
		qreal	y
	)

inlineinherited

◆ setRelativeRect() [1/2]

void Digikam::DImgChildItem::setRelativeRect ( const QRectF & rect )

inherited

References Digikam::DImgChildItem::rect(), Digikam::DImgChildItem::setRelativePos(), and Digikam::DImgChildItem::setRelativeSize().

◆ setRelativeRect() [2/2]

void Digikam::DImgChildItem::setRelativeRect	(	qreal	x,
		qreal	y,
		qreal	width,
		qreal	height
	)

inlineinherited

◆ setRelativeSize() [1/2]

void Digikam::DImgChildItem::setRelativeSize ( const QSizeF & relativeSize )

inherited

References Digikam::DImgChildItem::geometryOnImageChanged(), Digikam::DImgChildItem::relativeSize(), and Digikam::DImgChildItem::sizeOnImageChanged().

Referenced by Digikam::DImgChildItem::setOriginalSize(), Digikam::DImgChildItem::setRelativeRect(), and Digikam::DImgChildItem::setSize().

◆ setRelativeSize() [2/2]

void Digikam::DImgChildItem::setRelativeSize	(	qreal	width,
		qreal	height
	)

inlineinherited

◆ setSize() [1/2]

void Digikam::DImgChildItem::setSize ( const QSizeF & zoomedSize )

inherited

References Digikam::DImgChildItem::setRelativeSize(), and Digikam::DImgChildItem::size().

Referenced by Digikam::DImgChildItem::setRect().

◆ setSize() [2/2]

void Digikam::DImgChildItem::setSize	(	qreal	width,
		qreal	height
	)

inlineinherited

◆ setViewportRect

void Digikam::RegionFrameItem::setViewportRect ( const QRectF & rect )

slot

The associated HUD item is dynamically moved to be visible. This can only be done for one region at a time. Set the current primary view region of the scene by this method to dynamically reposition the HUD inside this region. The rect given is in scene coordinates.

References Digikam::DImgChildItem::rect().

◆ size()

QSizeF Digikam::DImgChildItem::size ( ) const

inherited

Referenced by Digikam::DImgChildItem::boundingRect(), Digikam::DImgChildItem::rect(), and Digikam::DImgChildItem::setSize().

◆ sizeChanged

void Digikam::DImgChildItem::sizeChanged ( )

signalinherited

Referenced by RegionFrameItem().

◆ sizeOnImageChanged

void Digikam::DImgChildItem::sizeOnImageChanged ( )

signalinherited

Referenced by Digikam::DImgChildItem::setRelativeSize().

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

core/libs/widgets/graphicsview/regionframeitem.h
core/libs/widgets/graphicsview/regionframeitem.cpp

Public Types

Public Slots

Signals

Public Member Functions

Protected Slots

Protected Member Functions

Member Enumeration Documentation

◆ Flag

Constructor & Destructor Documentation

◆ RegionFrameItem()

◆ ~RegionFrameItem()

Member Function Documentation

◆ boundingRect()

◆ changeFlags()

◆ eventFilter()

◆ flags()

◆ geometryChanged

◆ geometryEdited

◆ geometryOnImageChanged

◆ hoverEnterEvent()

◆ hoverLeaveEvent()

◆ hoverMoveEvent()

◆ hudWidget()

◆ imageSizeChanged

◆ itemChange()

◆ mouseMoveEvent()

◆ mousePressEvent()

◆ mouseReleaseEvent()

◆ moveBy()

◆ originalPos()

◆ originalRect()

◆ originalSize()

◆ paint()

◆ parentDImgItem()

◆ positionChanged

◆ positionOnImageChanged

◆ rect()

◆ relativePos()

◆ relativeRect()

◆ relativeSize()

◆ setFixedRatio()

◆ setFlags()

◆ setHudWidget() [1/2]

◆ setHudWidget() [2/2]

◆ setHudWidgetVisible()

◆ setOriginalPos() [1/2]

◆ setOriginalPos() [2/2]

◆ setOriginalRect() [1/2]

◆ setOriginalRect() [2/2]

◆ setOriginalSize() [1/2]

◆ setOriginalSize() [2/2]

◆ setPos() [1/2]

◆ setPos() [2/2]

◆ setRect() [1/2]

◆ setRect() [2/2]

◆ setRectInSceneCoordinates()

◆ setRectInSceneCoordinatesAdjusted()

◆ setRelativePos() [1/2]

◆ setRelativePos() [2/2]

◆ setRelativeRect() [1/2]

◆ setRelativeRect() [2/2]

◆ setRelativeSize() [1/2]

◆ setRelativeSize() [2/2]

◆ setSize() [1/2]

◆ setSize() [2/2]

◆ setViewportRect

◆ size()

◆ sizeChanged

◆ sizeOnImageChanged