KPIM::KPixmapRegionSelectorWidget Class Reference

#include <kpixmapregionselectorwidget.h>

Inherits TQWidget.

Public Slots

void rotateClockwise ()
 
void rotateCounterclockwise ()
 

Public Member Functions

 KPixmapRegionSelectorWidget (TQWidget *parent=0L, const char *name=0L)
 
 ~KPixmapRegionSelectorWidget ()
 
void setPixmap (const TQPixmap &pixmap)
 
TQPixmap pixmap () const
 
void setSelectedRegion (const TQRect &rect)
 
TQRect selectedRegion () const
 
TQRect unzoomedSelectedRegion () const
 
void resetSelection ()
 
TQImage selectedImage () const
 
void setSelectionAspectRatio (int width, int height)
 
void setFreeSelectionAspectRatio ()
 
void setMaximumWidgetSize (int width, int height)
 
void rotate (KImageEffect::RotateDirection direction)
 

Protected Member Functions

virtual TDEPopupMenu * createPopupMenu ()
 

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 tdelibs/tdeui, and the other copy is in tdepim/libtdepim This is because tdepim has to remain backwards compatible. Any changes to either file should be made to the other.

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

Definition at line 47 of file kpixmapregionselectorwidget.h.

Constructor & Destructor Documentation

◆ KPixmapRegionSelectorWidget()

KPixmapRegionSelectorWidget::KPixmapRegionSelectorWidget ( TQWidget *  parent = 0L,
const char *  name = 0L 
)

Constructor for a KPixmapRegionSelectorWidget.

Definition at line 44 of file kpixmapregionselectorwidget.cpp.

◆ ~KPixmapRegionSelectorWidget()

KPixmapRegionSelectorWidget::~KPixmapRegionSelectorWidget ( )

Destructor for a KPixmapRegionSelectorWidget.

Definition at line 67 of file kpixmapregionselectorwidget.cpp.

Member Function Documentation

◆ createPopupMenu()

TDEPopupMenu * KPixmapRegionSelectorWidget::createPopupMenu ( )
protectedvirtual

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

Definition at line 141 of file kpixmapregionselectorwidget.cpp.

◆ pixmap()

TQPixmap KPIM::KPixmapRegionSelectorWidget::pixmap ( ) const
inline
Returns
the original whole pixmap that we're using in this widget as the pixmap the user is selecting a region from.

Definition at line 73 of file kpixmapregionselectorwidget.h.

◆ resetSelection()

void KPixmapRegionSelectorWidget::resetSelection ( )

Resets the selection to use the whole image.

Definition at line 80 of file kpixmapregionselectorwidget.cpp.

◆ rotate()

void KPixmapRegionSelectorWidget::rotate ( KImageEffect::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 resetted.

Definition at line 163 of file kpixmapregionselectorwidget.cpp.

◆ rotateClockwise

void KPixmapRegionSelectorWidget::rotateClockwise ( )
slot

Rotates the current image 90º clockwise.

Definition at line 202 of file kpixmapregionselectorwidget.cpp.

◆ rotateCounterclockwise

void KPixmapRegionSelectorWidget::rotateCounterclockwise ( )
slot

Rotates the current image 90º counterclockwise.

Definition at line 207 of file kpixmapregionselectorwidget.cpp.

◆ selectedImage()

TQImage KPixmapRegionSelectorWidget::selectedImage ( ) const
Returns
a TQImage object with just the region the user selected from the image

Definition at line 399 of file kpixmapregionselectorwidget.cpp.

◆ selectedRegion()

TQRect KPixmapRegionSelectorWidget::selectedRegion ( ) const

Returns the selected region ( in zoomed pixmap coordinates )

Definition at line 86 of file kpixmapregionselectorwidget.cpp.

◆ setFreeSelectionAspectRatio()

void KPixmapRegionSelectorWidget::setFreeSelectionAspectRatio ( )

Allows the user to do a selection which has any aspect ratio.

This is the default.

See also
setSelectionAspectRatio()

Definition at line 410 of file kpixmapregionselectorwidget.cpp.

◆ setMaximumWidgetSize()

void KPixmapRegionSelectorWidget::setMaximumWidgetSize ( int  width,
int  height 
)

Sets the maximum size for the widget.

If the image is larger than this (either horizontally or vertically), it's scaled to adjust to the maximum size (preserving the aspect ratio)

Definition at line 415 of file kpixmapregionselectorwidget.cpp.

◆ setPixmap()

void KPixmapRegionSelectorWidget::setPixmap ( const TQPixmap &  pixmap)

Sets the pixmap which will be shown for the user to select a region from.

Parameters
pixmapThe pixmap. Must be non-null.

Definition at line 71 of file kpixmapregionselectorwidget.cpp.

◆ setSelectedRegion()

void KPixmapRegionSelectorWidget::setSelectedRegion ( const TQRect &  rect)

Sets the selected region to be rect (in zoomed pixmap coordinates)

Definition at line 91 of file kpixmapregionselectorwidget.cpp.

◆ setSelectionAspectRatio()

void KPixmapRegionSelectorWidget::setSelectionAspectRatio ( int  width,
int  height 
)

Sets the aspect ration that the selected subimage should have.

The way to select it, is specifying an example valid width and height.

See also
setFreeSelectionAspectRatio()

Definition at line 405 of file kpixmapregionselectorwidget.cpp.

◆ unzoomedSelectedRegion()

TQRect KPixmapRegionSelectorWidget::unzoomedSelectedRegion ( ) const

Returns the selected region ( in unzoomed, original pixmap coordinates )

Definition at line 391 of file kpixmapregionselectorwidget.cpp.


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