#include <kpixmapregionselectorwidget.h>

Inheritance diagram for KPixmapRegionSelectorWidget:

Public Types
enum	RotateDirection { Rotate90, Rotate180, Rotate270 }

Public Slots
void	rotateClockwise ()

void	rotateCounterclockwise ()

Signals
void	pixmapRotated ()

Public Member Functions
	KPixmapRegionSelectorWidget (QWidget *parent=0)

	~KPixmapRegionSelectorWidget ()

QPixmap	pixmap () const

void	resetSelection ()

void	rotate (RotateDirection direction)

QImage	selectedImage () const

QRect	selectedRegion () const

void	setFreeSelectionAspectRatio ()

void	setMaximumWidgetSize (int width, int height)

void	setPixmap (const QPixmap &pixmap)

void	setSelectedRegion (const QRect &rect)

void	setSelectionAspectRatio (int width, int height)

QRect	unzoomedSelectedRegion () const

Protected Member Functions
virtual KMenu *	createPopupMenu ()

Properties
QPixmap	pixmap

Detailed Description

KPixmapRegionSelectorWidget is a widget that shows a picture and provides the user with a friendly way to select a rectangular subregion of the pixmap.

NOTE: There are two copies of this .h and the .cpp file, with subtle differences. One copy is in kdelibs/kdeui, and the other copy is in kdepim/libkdepim This is because kdepim has to remain backwards compatible. Any changes to either file should be made to the other.

KDE Pixmap Region Selector

Author: Antonio Larrosa larro.nosp@m.sa@k.nosp@m.de.or.nosp@m.g

Definition at line 44 of file kpixmapregionselectorwidget.h.

Member Enumeration Documentation

enum KPixmapRegionSelectorWidget::RotateDirection

This enum provides a rotation direction.

See also: KPixmapRegionSelectorWidget::rotate()

Enumerator
Rotate90	Rotate 90 degrees to the right.
Rotate180	Rotate 180 degrees.
Rotate270	Rotate 90 degrees to the left.

Definition at line 54 of file kpixmapregionselectorwidget.h.

Constructor & Destructor Documentation

KPixmapRegionSelectorWidget::KPixmapRegionSelectorWidget ( QWidget * parent = 0 )

explicit

Constructor for a KPixmapRegionSelectorWidget.

Definition at line 77 of file kpixmapregionselectorwidget.cpp.

KPixmapRegionSelectorWidget::~KPixmapRegionSelectorWidget ( )

Destructor for a KPixmapRegionSelectorWidget.

Definition at line 103 of file kpixmapregionselectorwidget.cpp.

Member Function Documentation

KMenu * KPixmapRegionSelectorWidget::createPopupMenu ( )

protectedvirtual

Creates a KMenu with the menu that appears when clicking with the right button on the label.

Definition at line 188 of file kpixmapregionselectorwidget.cpp.

QPixmap KPixmapRegionSelectorWidget::pixmap ( ) const

Returns: the original whole pixmap that we're using in this widget as the pixmap the user is selecting a region from.

void KPixmapRegionSelectorWidget::pixmapRotated ( )

signal

void KPixmapRegionSelectorWidget::resetSelection ( )

Resets the selection to use the whole image.

Definition at line 122 of file kpixmapregionselectorwidget.cpp.

void KPixmapRegionSelectorWidget::rotate ( RotateDirection direction )

Rotates the image as specified by the direction parameter, also tries to rotate the selected region so that it doesn't change, as long as the forced aspect ratio setting is respected, in other case, the selected region is reset.

Definition at line 216 of file kpixmapregionselectorwidget.cpp.

void KPixmapRegionSelectorWidget::rotateClockwise ( )

slot

Rotates the current image 90º clockwise.

Definition at line 274 of file kpixmapregionselectorwidget.cpp.

void KPixmapRegionSelectorWidget::rotateCounterclockwise ( )

slot

Rotates the current image 90º counterclockwise.

Definition at line 279 of file kpixmapregionselectorwidget.cpp.

QImage KPixmapRegionSelectorWidget::selectedImage ( ) const