KisAngleSelector Class Reference

A widget with several options to select an angle. More...

#include <KisAngleSelector.h>

Inheritance diagram for KisAngleSelector:

Classes
struct	Private

Public Types
enum	FlipOptionsMode { FlipOptionsMode_NoFlipOptions , FlipOptionsMode_MenuButton , FlipOptionsMode_Buttons , FlipOptionsMode_ContextMenu }
	Options to select how the flip options should be presented. More...

Public Slots
void	reset ()
	Sets the current angle to the reset angle.
void	setAngle (qreal newAngle)
	Sets the current angle.

Signals
void	angleChanged (qreal angle)

Public Member Functions
qreal	angle () const
	Gets the current angle.
qreal	closestCoterminalAngleInRange (qreal angle, bool *ok=nullptr) const
	Gets the closest coterminal angle to the provided angle that is in the range established.
int	decimals () const
	Gets the number of decimals (precision) used by the angle.
void	flip (Qt::Orientations orientations)
	Flips the angle horizontally, vertically, or both.
FlipOptionsMode	flipOptionsMode () const
	Gets the mode in which the flip options should be shown.
KisAngleGauge::IncreasingDirection	increasingDirection () const
	Gets the direction in which the angle increases in the angle gauge.
bool	isUsingFlatSpinBox () const
	Gets if the spin box is flat (no border or background)
	KisAngleSelector (QWidget *parent=0)
	Construct a new KisAngleSelector widget.
qreal	maximum () const
	Gets the maximum value for the angle.
qreal	minimum () const
	Gets the minimum value for the angle.
QString	prefix () const
	Gets the prefix shown in the spin box.
qreal	resetAngle () const
	Gets the angle that is used to reset the current angle.
void	setDecimals (int newNumberOfDecimals)
	Sets the number of decimals (precision) used by the angle.
void	setFlipOptionsMode (FlipOptionsMode newMode)
	Sets the mode in which the flip options should be shown.
void	setIncreasingDirection (KisAngleGauge::IncreasingDirection newIncreasingDirection)
	Sets the increasing direction in the angle gauge.
void	setMaximum (qreal newMaximum)
	Sets the maximum value for the angle.
void	setMinimum (qreal newMinimum)
	Sets the minimum value for the angle.
void	setPrefix (const QString &newPrefix)
	Sets the prefix shown in the spin box.
void	setRange (qreal newMinimum, qreal newMaximum)
	Sets the minimum and maximum values for the angle.
void	setResetAngle (qreal newResetAngle)
	Sets the angle that is used to reset the current angle.
void	setSnapAngle (qreal newSnapAngle)
	Sets the angle to which multiples the selected angle will snap.
void	setWidgetsHeight (int newHeight)
	Sets the common height of the widgets inside this angle selector. Use 0 to reset widgets to default height.
void	setWrapping (bool newWrapping)
	Sets if the angle should wrap pass the minimum or maximum angles.
qreal	snapAngle () const
	Gets the angle to which multiples the selected angle will snap.
void	useFlatSpinBox (bool newUseFlatSpinBox)
	Sets if the spin box should be flat.
int	widgetsHeight () const
	Gets the common height of the widgets inside this angle selector.
bool	wrapping () const
	Gets if the angle should wrap pass the minimum or maximum angles.
	~KisAngleSelector ()

Static Public Member Functions
static qreal	closestCoterminalAngleInRange (qreal angle, qreal minimum, qreal maximum, bool *ok=nullptr)
	Gets the closest coterminal angle to the provided angle that is in the range provided.
static qreal	flipAngle (qreal angle, qreal minimum, qreal maximum, Qt::Orientations orientations, bool *ok=nullptr)
	Flips an angle horizontally, vertically, or both.
static qreal	flipAngle (qreal angle, Qt::Orientations orientations)
	Flips an angle horizontally, vertically, or both.

Private Member Functions
bool	event (QEvent *e) override
bool	eventFilter (QObject *o, QEvent *e) override

Private Attributes
const QScopedPointer< Private >	m_d

Detailed Description

A widget with several options to select an angle.

This widget is a combination of a KisAngleGauge and a spin box, along with some flipping options

Definition at line 60 of file KisAngleSelector.h.

Member Enumeration Documentation

FlipOptionsMode

enum KisAngleSelector::FlipOptionsMode

Options to select how the flip options should be presented.

See also

flipOptionsMode() const

setFlipOptionsMode(FlipOptionsMode newMode)

Enumerator
FlipOptionsMode_NoFlipOptions	There is no flip options available.
FlipOptionsMode_MenuButton	The flip options are shown as a menu accessible via a options button.
FlipOptionsMode_Buttons	The flip options are shown as individual buttons.
FlipOptionsMode_ContextMenu	The flip options are shown only as a context menu when right-clicking the gauge widget. The options are shown in the context menu also if the mode is FlipOptionsMode_MenuButton or FlipOptionsMode_Buttons but with this mode there will be no additional buttons

Definition at line 70 of file KisAngleSelector.h.

    {
        FlipOptionsMode_NoFlipOptions,
        FlipOptionsMode_MenuButton,
        FlipOptionsMode_Buttons,
        FlipOptionsMode_ContextMenu
    };

Constructor & Destructor Documentation

KisAngleSelector()

KisAngleSelector::KisAngleSelector ( QWidget * parent = 0 )

explicit

Construct a new KisAngleSelector widget.

Parameters

parent

the parent widget

Definition at line 194 of file KisAngleSelector.cpp.

    : QWidget(parent)
    , m_d(new Private)
{
    m_d->q = this;
 
    QHBoxLayout *mainLayout = new QHBoxLayout;
    mainLayout->setSpacing(5);
    mainLayout->setContentsMargins(0, 0, 0, 0);
 
    m_d->angleGauge = new KisAngleGauge(this);
    m_d->angleGauge->installEventFilter(this);
 
    m_d->spinBox = new KisAngleSelectorSpinBox(this);
    m_d->spinBox->setSuffix(i18nc("Degrees symbol", "˚"));
    m_d->spinBox->setRange(0, 360);
    m_d->spinBox->setWrapping(true);
 
    m_d->actionFlipHorizontally = new QAction(this);
    m_d->actionFlipHorizontally->setText(
        i18nc(
            "Flips the angle horizontally, around the vertical axis",
            "Flip the angle horizontally"
        )
    );
    m_d->actionFlipVertically = new QAction(this);
    m_d->actionFlipVertically->setText(
        i18nc(
            "Flips the angle vertically, around the horizontal axis",
            "Flip the angle vertically"
        )
    );
    m_d->actionFlipHorizontallyAndVertically = new QAction(this);
    m_d->actionFlipHorizontallyAndVertically->setText(
        i18nc(
            "Flips the angle horizontally and vertically",
            "Flip the angle horizontally and vertically"
        )
    );
    QAction *menuSeparator = new QAction(this);
    menuSeparator->setSeparator(true);
    m_d->actionResetAngle = new QAction(this);
    m_d->actionResetAngle->setText(
        i18nc(
            "Reset the angle to a predefined value",
            "Reset angle"
        )
    );
    m_d->menuFlip = new QMenu(this);
    m_d->menuFlip->addAction(m_d->actionFlipHorizontally);
    m_d->menuFlip->addAction(m_d->actionFlipVertically);
    m_d->menuFlip->addAction(m_d->actionFlipHorizontallyAndVertically);
    m_d->menuFlip->addAction(menuSeparator);
    m_d->menuFlip->addAction(m_d->actionResetAngle);
 
    QHBoxLayout *layoutFlipButtons = new QHBoxLayout;
    layoutFlipButtons->setSpacing(1);
    layoutFlipButtons->setContentsMargins(0, 0, 0, 0);
 
    m_d->toolButtonFlipOptions = new QToolButton(this);
    m_d->toolButtonFlipOptions->setPopupMode(QToolButton::InstantPopup);
    m_d->toolButtonFlipOptions->setAutoRaise(true);
    m_d->toolButtonFlipOptions->setIcon(KisIconUtils::loadIcon("view-choose"));
    m_d->toolButtonFlipOptions->setStyleSheet("QToolButton::menu-indicator { image: none; }");
    m_d->toolButtonFlipOptions->setMenu(m_d->menuFlip);
    m_d->toolButtonFlipOptions->setFocusPolicy(Qt::StrongFocus);
 
    m_d->toolButtonFlipHorizontally = new QToolButton(this);
    m_d->toolButtonFlipHorizontally->setAutoRaise(true);
    m_d->toolButtonFlipHorizontally->setIcon(KisIconUtils::loadIcon("flip_angle_h"));
    m_d->toolButtonFlipHorizontally->setIconSize(QSize(20, 20));
    m_d->toolButtonFlipHorizontally->setToolTip(m_d->actionFlipHorizontally->text());
    m_d->toolButtonFlipHorizontally->setFocusPolicy(Qt::StrongFocus);
 
    m_d->toolButtonFlipVertically = new QToolButton(this);
    m_d->toolButtonFlipVertically->setAutoRaise(true);
    m_d->toolButtonFlipVertically->setIcon(KisIconUtils::loadIcon("flip_angle_v"));
    m_d->toolButtonFlipVertically->setIconSize(QSize(20, 20));
    m_d->toolButtonFlipVertically->setToolTip(m_d->actionFlipVertically->text());
    m_d->toolButtonFlipVertically->setFocusPolicy(Qt::StrongFocus);
 
    m_d->toolButtonFlipHorizontallyAndVertically = new QToolButton(this);
    m_d->toolButtonFlipHorizontallyAndVertically->setAutoRaise(true);
    m_d->toolButtonFlipHorizontallyAndVertically->setIcon(KisIconUtils::loadIcon("flip_angle_hv"));
    m_d->toolButtonFlipHorizontallyAndVertically->setIconSize(QSize(20, 20));
    m_d->toolButtonFlipHorizontallyAndVertically->setToolTip(m_d->actionFlipHorizontallyAndVertically->text());
    m_d->toolButtonFlipHorizontallyAndVertically->setFocusPolicy(Qt::StrongFocus);
 
    layoutFlipButtons->addWidget(m_d->toolButtonFlipOptions);
    layoutFlipButtons->addWidget(m_d->toolButtonFlipHorizontally);
    layoutFlipButtons->addWidget(m_d->toolButtonFlipVertically);
    layoutFlipButtons->addWidget(m_d->toolButtonFlipHorizontallyAndVertically);
 
    mainLayout->addWidget(m_d->angleGauge);
    mainLayout->addWidget(m_d->spinBox);
    mainLayout->addLayout(layoutFlipButtons);
 
    setLayout(mainLayout);
 
    setTabOrder(m_d->angleGauge, m_d->spinBox);
    setTabOrder(m_d->spinBox, m_d->toolButtonFlipOptions);
    setTabOrder(m_d->toolButtonFlipOptions, m_d->toolButtonFlipHorizontally);
    setTabOrder(m_d->toolButtonFlipHorizontally, m_d->toolButtonFlipVertically);
    setTabOrder(m_d->toolButtonFlipVertically, m_d->toolButtonFlipHorizontallyAndVertically);
 
    setFlipOptionsMode(FlipOptionsMode_Buttons);
    setWidgetsHeight(0);
    
    using namespace std::placeholders;
    connect(
        m_d->angleGauge,
        &KisAngleGauge::angleChanged,
        std::bind(&Private::on_angleGauge_angleChanged, m_d.data(), _1)
    );
    connect(
        m_d->spinBox,
        QOverload<double>::of(&KisDoubleParseSpinBox::valueChanged),
        std::bind(&Private::on_spinBox_valueChanged, m_d.data(), _1)
    );
    connect(
        m_d->actionFlipHorizontally,
        &QAction::triggered,
        std::bind(&Private::on_actionFlipHorizontally_triggered, m_d.data())
    );
    connect(
        m_d->actionFlipVertically,
        &QAction::triggered,
        std::bind(&Private::on_actionFlipVertically_triggered, m_d.data())
    );
    connect(
        m_d->actionFlipHorizontallyAndVertically,
        &QAction::triggered,
        std::bind(&Private::on_actionFlipHorizontallyAndVertically_triggered, m_d.data())
    );
    connect(m_d->actionResetAngle, SIGNAL(triggered()), SLOT(reset()));
    connect(m_d->toolButtonFlipHorizontally, SIGNAL(clicked()), m_d->actionFlipHorizontally, SLOT(trigger()));
    connect(m_d->toolButtonFlipVertically, SIGNAL(clicked()), m_d->actionFlipVertically, SLOT(trigger()));
    connect(m_d->toolButtonFlipHorizontallyAndVertically, SIGNAL(clicked()), m_d->actionFlipHorizontallyAndVertically, SLOT(trigger()));
}

References KisAngleGauge::angleChanged(), connect(), FlipOptionsMode_Buttons, KisIconUtils::loadIcon(), m_d, KisAngleSelector::Private::on_actionFlipHorizontally_triggered(), KisAngleSelector::Private::on_actionFlipHorizontallyAndVertically_triggered(), KisAngleSelector::Private::on_actionFlipVertically_triggered(), KisAngleSelector::Private::on_angleGauge_angleChanged(), KisAngleSelector::Private::on_spinBox_valueChanged(), reset(), setFlipOptionsMode(), and setWidgetsHeight().

~KisAngleSelector()

KisAngleSelector::~KisAngleSelector

(

)

Definition at line 334 of file KisAngleSelector.cpp.

{}

Member Function Documentation

angle()

qreal KisAngleSelector::angle

(

)

const

Gets the current angle.

Returns

The current angle

See also

setAngle(qreal)

Definition at line 337 of file KisAngleSelector.cpp.

{
    return m_d->spinBox->value();
}

References m_d.

angleChanged

void KisAngleSelector::angleChanged ( qreal angle )

signal

closestCoterminalAngleInRange() [1/2]

qreal KisAngleSelector::closestCoterminalAngleInRange	(	qreal	angle,
		bool *	ok = nullptr ) const

Gets the closest coterminal angle to the provided angle that is in the range established.

A coterminal angle to the provided angle is one that differs in size by an integer multiple of a turn (360 degrees)

Parameters

	angle	The reference angle for which the function will try to find a coterminal angle
[out]	ok	This parameter will be set to true if a coterminal angle exists in the specified range, or to false otherwise

Returns

The closest coterminal angle in the specified range if one exists, or the closest value in the range (the minimum or maximum) otherwise. If the reference angle is already in the range then it is returned

Definition at line 523 of file KisAngleSelector.cpp.

{
    return closestCoterminalAngleInRange(angle, m_d->spinBox->minimum(), m_d->spinBox->maximum(), ok);
}

References angle(), closestCoterminalAngleInRange(), and m_d.

closestCoterminalAngleInRange() [2/2]

qreal KisAngleSelector::closestCoterminalAngleInRange ( qreal angle, qreal minimum, qreal maximum, bool * ok = nullptr )

static

Gets the closest coterminal angle to the provided angle that is in the range provided.

A coterminal angle to the provided angle is one that differs in size by an integer multiple of a turn (360 degrees)

Parameters

	angle	The reference angle for which the function will try to find a coterminal angle
	minimum	The range's lower bound
	maximum	The range's upper bound
[out]	ok	This parameter will be set to true if a coterminal angle exists in the provided range, or to false otherwise

Returns

The closest coterminal angle in the provided range if one exists, or the closest value in the range (the minimum or maximum) otherwise. If the reference angle is already in the range then it is returned

Definition at line 495 of file KisAngleSelector.cpp.

{
    bool hasCoterminalAngleInRange = true;
 
    if (angle < minimum) {
        const qreal d = minimum - angle;
        const qreal cycles = std::floor(d / 360.0) + 1;
        angle += cycles * 360.0;
        if (angle > maximum) {
            hasCoterminalAngleInRange = false;
            angle = minimum;
        }
    } else if (angle > maximum) {
        const qreal d = angle - maximum;
        const qreal cycles = std::floor(d / 360.0) + 1;
        angle -= cycles * 360.0;
        if (angle < minimum) {
            hasCoterminalAngleInRange = false;
            angle = maximum;
        }
    }
 
    if (ok) {
        *ok = hasCoterminalAngleInRange;
    }
    return angle;
}

References angle(), maximum(), and minimum().

decimals()

int KisAngleSelector::decimals

(

)

const

Gets the number of decimals (precision) used by the angle.

If you want to simulate integer angles, set it to 0. The default is 2.

Returns

The number of decimals being used

See also

setDecimals(int)

Definition at line 352 of file KisAngleSelector.cpp.

{
    return m_d->spinBox->decimals();
}

References m_d.

event()

bool KisAngleSelector::event ( QEvent * e )

overrideprivate

Definition at line 579 of file KisAngleSelector.cpp.

{
    if (e->type() == QEvent::PaletteChange) {
        // For some reason the spinbox, that uses stylesheets, doesn't update
        // on palette changes, so we reset the stylesheet to force an update.
        // Calling m_d->spinBox->update() doesn't work
        m_d->spinBox->refreshStyle();
    } else if (e->type() == QEvent::StyleChange || e->type() == QEvent::FontChange) {
        // Temporarily reset the spin box style so that we can get its
        // height size hint
        m_d->spinBox->refreshStyle();
        m_d->resizeWidgets();
    }
    return QWidget::event(e);
}

References m_d.

eventFilter()

bool KisAngleSelector::eventFilter ( QObject * o, QEvent * e )

overrideprivate

Definition at line 595 of file KisAngleSelector.cpp.

{
    QWidget *w = qobject_cast<QWidget*>(o);
    if (w != m_d->angleGauge || !w->isEnabled() || !e || e->type() != QEvent::ContextMenu) {
        return false;
    }
    QContextMenuEvent *cme = static_cast<QContextMenuEvent*>(e);
 
    m_d->menuFlip->exec(cme->globalPos());
    return true;
}

References m_d.

flip()

void KisAngleSelector::flip

(

Qt::Orientations

orientations

)

Flips the angle horizontally, vertically, or both.

This function will always try to set the closest angle to the stablished one that satisfies the flipping requirements

Parameters

orientations

Flags indicating in which directions the angle should be flipped

Definition at line 570 of file KisAngleSelector.cpp.

{
    bool ok = false;
    qreal flippedAngle = flipAngle(angle(), minimum(), maximum(), orientations, &ok);
    if (ok) {
        setAngle(flippedAngle);
    }
}

References angle(), flipAngle(), maximum(), minimum(), and setAngle().

flipAngle() [1/2]

qreal KisAngleSelector::flipAngle ( qreal angle, qreal minimum, qreal maximum, Qt::Orientations orientations, bool * ok = nullptr )

static

Flips an angle horizontally, vertically, or both.

This function will always try to get the closest angle to the provided one that satisfies the flipping requirements

Parameters

	angle	The angle to be flipped
	minimum	The lower bound of the valid range
	maximum	The upper bound of the valid range
	orientations	Flags indicating in which directions the angle should be flipped
[out]	ok	This parameter will be set to true if the flipped angle is in the provided range, or to false otherwise

Returns

The flipped angle if it lies in the provided range or the closest value in the range (the minimum or maximum) otherwise

Definition at line 565 of file KisAngleSelector.cpp.

{
    return closestCoterminalAngleInRange(flipAngle(angle, orientations), minimum, maximum, ok);
}

References angle(), closestCoterminalAngleInRange(), flipAngle(), maximum(), and minimum().

flipAngle() [2/2]

qreal KisAngleSelector::flipAngle ( qreal angle, Qt::Orientations orientations )

static

Flips an angle horizontally, vertically, or both.

This function will always try to get the closest angle to the provided one that satisfies the flipping requirements

Parameters

angle	The angle to be flipped
orientations	Flags indicating in which directions the angle should be flipped

Returns

The flipped angle

Definition at line 528 of file KisAngleSelector.cpp.

{
    if ((orientations & Qt::Horizontal) && (orientations & Qt::Vertical)) {
        angle += 180.0;
    } else if (orientations & Qt::Horizontal) {
        qreal a = std::fmod(angle, 360.0);
        if (a < 0) {
            a += 360.0;
        }
        if (a > 270.0) {
            angle -= 2.0 * (a - 270.0);
        } else if (a > 180.0) {
            angle += 2.0 * (270.0 - a);
        } else if (a > 90.0) {
            angle -= 2.0 * (a - 90.0);
        } else {
            angle += 2.0 * (90.0 - a);
        }
    } else if (orientations & Qt::Vertical) {
        qreal a = std::fmod(angle, 360.0);
        if (a < 0) {
            a += 360.0;
        }
        if (a > 270.0) {
            angle += 2.0 * (360.0 - a);
        } else if (a > 180.0) {
            angle -= 2.0 * (a - 180.0);
        } else if (a > 90.0) {
            angle += 2.0 * (180.0 - a);
        } else {
            angle -= 2.0 * a;
        }
    }
 
    return angle;
}

References angle().

flipOptionsMode()

KisAngleSelector::FlipOptionsMode KisAngleSelector::flipOptionsMode

(

)

const

Gets the mode in which the flip options should be shown.

The default is FlipOptions::FlipOptionsMode_Buttons

Returns

The mode in which the flip options should be shown.

See also

setFlipOptionsMode(FlipOptionsMode)

FlipOptionsMode

Definition at line 377 of file KisAngleSelector.cpp.

{
    return m_d->flipOptionsMode;
}

References m_d.

increasingDirection()

KisAngleGauge::IncreasingDirection KisAngleSelector::increasingDirection

(

)

const

Gets the direction in which the angle increases in the angle gauge.

Returns

The direction in which the angle increases

See also

KisAngleGauge::IncreasingDirection

setIncreasingDirection(KisAngleGauge::IncreasingDirection)

Definition at line 387 of file KisAngleSelector.cpp.

{
    return m_d->angleGauge->increasingDirection();
}

References m_d.

isUsingFlatSpinBox()

bool KisAngleSelector::isUsingFlatSpinBox

(

)

const

Gets if the spin box is flat (no border or background)

Returns

True if the spin box is flat, false otherwise

See also

useFlatSpinBox(bool)

Definition at line 392 of file KisAngleSelector.cpp.

{
    return m_d->spinBox->isFlat();
}

References m_d.

maximum()

qreal KisAngleSelector::maximum

(

)

const

Gets the maximum value for the angle.

The default is 360

Returns

The maximum value for the angle

See also

setMaximum(qreal)

setRange(qreal, qreal)

Definition at line 357 of file KisAngleSelector.cpp.

{
    return m_d->spinBox->maximum();
}

References m_d.

minimum()

qreal KisAngleSelector::minimum

(

)

const

Gets the minimum value for the angle.

The default is 0

Returns

The minimum value for the angle

See also

setMinimum(qreal)

setRange(qreal, qreal)

Definition at line 362 of file KisAngleSelector.cpp.

{
    return m_d->spinBox->minimum();
}

References m_d.

prefix()

QString KisAngleSelector::prefix

(

)

const

Gets the prefix shown in the spin box.

Returns

The prefix shown in the spin box

See also

setPrefix(const QString&)

Definition at line 367 of file KisAngleSelector.cpp.

{
    return m_d->spinBox->prefix();
}

References m_d.

reset

void KisAngleSelector::reset ( )

slot

Sets the current angle to the reset angle.

See also

resetAngle() const

setResetAngle(qreal) const

Definition at line 490 of file KisAngleSelector.cpp.

{
    m_d->angleGauge->reset();
}

References m_d.

resetAngle()

qreal KisAngleSelector::resetAngle

(

)

const

Gets the angle that is used to reset the current angle.

This angle is used when the user double clicks on the widget

Returns

The angle that is used to reset the current angle

See also

setResetAngle(qreal)

Definition at line 347 of file KisAngleSelector.cpp.

{
    return m_d->angleGauge->resetAngle();
}

References m_d.

setAngle

void KisAngleSelector::setAngle ( qreal newAngle )

slot

Sets the current angle.

Parameters

newAngle

the new angle

See also

angle() const

Definition at line 397 of file KisAngleSelector.cpp.

{
    KisSignalsBlocker angleGaugeSignalsBlocker(m_d->angleGauge);
    KisSignalsBlocker spinBoxSignalsBlocker(m_d->spinBox);
 
    const qreal oldAngle = m_d->spinBox->value();
    
    m_d->spinBox->setValue(newAngle);
    m_d->angleGauge->setAngle(m_d->spinBox->value());
 
    if (qFuzzyCompare(oldAngle, m_d->spinBox->value())) {
        return;
    }
 
    Q_EMIT angleChanged(m_d->spinBox->value());
}

References angleChanged(), m_d, and qFuzzyCompare().

setDecimals()

void KisAngleSelector::setDecimals

(

int

newNumberOfDecimals

)

Sets the number of decimals (precision) used by the angle.

Parameters

newNumberOfDecimals

the new number of decimals used by the angle

See also

decimals() const

Definition at line 424 of file KisAngleSelector.cpp.

{
    m_d->spinBox->setDecimals(newNumberOfDecimals);
}

References m_d.

setFlipOptionsMode()

void KisAngleSelector::setFlipOptionsMode

(

FlipOptionsMode

newMode

)

Sets the mode in which the flip options should be shown.

Parameters

newMinimum

the new mode in which the flip options should be shown

See also

flipOptionsMode() const

FlipOptionsMode

Definition at line 454 of file KisAngleSelector.cpp.

{
    m_d->flipOptionsMode = newMode;
 
    m_d->toolButtonFlipOptions->setVisible(newMode == FlipOptionsMode_MenuButton);
 
    bool useButtons = newMode == FlipOptionsMode_Buttons;
    m_d->toolButtonFlipHorizontally->setVisible(useButtons);
    m_d->toolButtonFlipVertically->setVisible(useButtons);
    m_d->toolButtonFlipHorizontallyAndVertically->setVisible(useButtons);
 
    bool showMenus = newMode != FlipOptionsMode_NoFlipOptions;
    m_d->actionFlipHorizontally->setVisible(showMenus);
    m_d->actionFlipVertically->setVisible(showMenus);
    m_d->actionFlipHorizontallyAndVertically->setVisible(showMenus);
}

References FlipOptionsMode_Buttons, FlipOptionsMode_MenuButton, FlipOptionsMode_NoFlipOptions, and m_d.

setIncreasingDirection()

void KisAngleSelector::setIncreasingDirection

(

KisAngleGauge::IncreasingDirection

newIncreasingDirection

)

Sets the increasing direction in the angle gauge.

Parameters

newIncreasingDirection

The new increasing direction

See also

IncreasingDirection

increasingDirection() const

Definition at line 480 of file KisAngleSelector.cpp.

{
    m_d->angleGauge->setIncreasingDirection(newIncreasingDirection);
}

References m_d.

setMaximum()

void KisAngleSelector::setMaximum

(

qreal

newMaximum

)

Sets the maximum value for the angle.

Parameters

newMaximum

the new maximum value for the angle

See also

maximum() const

setRange(qreal, qreal)

Definition at line 429 of file KisAngleSelector.cpp.

{
    m_d->spinBox->setMaximum(newMaximum);
}

References m_d.

setMinimum()

void KisAngleSelector::setMinimum

(

qreal

newMinimum

)

Sets the minimum value for the angle.

Parameters

newMinimum

the new minimum value for the angle

See also

minimum() const

setRange(qreal, qreal)

Definition at line 434 of file KisAngleSelector.cpp.

{
    m_d->spinBox->setMinimum(newMinimum);
}

References m_d.

setPrefix()

void KisAngleSelector::setPrefix

(

const QString &

newPrefix

)

Sets the prefix shown in the spin box.

Parameters

newPrefix

the new prefix for the spin box

See also

prefix() const

Definition at line 444 of file KisAngleSelector.cpp.

{
    m_d->spinBox->setPrefix(newPrefix);
}

References m_d.

setRange()

void KisAngleSelector::setRange	(	qreal	newMinimum,
		qreal	newMaximum )

Sets the minimum and maximum values for the angle.

Parameters

newMinimum	the new minimum value for the angle
newMaximum	the new maximum value for the angle

See also

minimum() const

maximum() const

setMinimum(qreal)

setMaximum(qreal)

Definition at line 439 of file KisAngleSelector.cpp.

{
    m_d->spinBox->setRange(newMinimum, newMaximum);
}

References m_d.

setResetAngle()

void KisAngleSelector::setResetAngle

(

qreal

newResetAngle

)

Sets the angle that is used to reset the current angle.

Parameters

newResetAngle

the new angle that is used to reset the current angle

See also

resetAngle() const

Definition at line 419 of file KisAngleSelector.cpp.

{
    m_d->angleGauge->setResetAngle(newResetAngle);
}

References m_d.

setSnapAngle()

void KisAngleSelector::setSnapAngle

(

qreal

newSnapAngle

)

Sets the angle to which multiples the selected angle will snap.

Parameters

newSnapAngle

the new angle to which multiples the selected angle will snap

See also

snapAngle() const

Definition at line 414 of file KisAngleSelector.cpp.

{
    m_d->angleGauge->setSnapAngle(newSnapAngle);
}

References m_d.

setWidgetsHeight()

void KisAngleSelector::setWidgetsHeight

(

int

newHeight

)

Sets the common height of the widgets inside this angle selector. Use 0 to reset widgets to default height.

Parameters

newHeight

the new height of the internal widgets (angle gauge, spin box, etc.)

See also

widgetsHeight() const

Definition at line 471 of file KisAngleSelector.cpp.

{
    if (newHeight < 0) {
        return;
    }
    m_d->commonWidgetsHeight = newHeight;
    m_d->resizeWidgets();
}

References m_d.

setWrapping()

void KisAngleSelector::setWrapping

(

bool

newWrapping

)

Sets if the angle should wrap pass the minimum or maximum angles.

Parameters

newWrapping

true if the angle should wrap pass the minimum or maximum angles, false otherwise

See also

wrapping() const

Definition at line 449 of file KisAngleSelector.cpp.

{
    m_d->spinBox->setWrapping(newWrapping);
}

References m_d.

snapAngle()

qreal KisAngleSelector::snapAngle

(

)

const

Gets the angle to which multiples the selected angle will snap.

The default snap angle is 15 degrees so the selected angle will snap to its multiples (0, 15, 30, 45, etc.)

Returns

The angle to which multiples the selected angle will snap

See also

setSnapAngle(qreal)

Definition at line 342 of file KisAngleSelector.cpp.

{
    return m_d->angleGauge->snapAngle();
}

References m_d.

useFlatSpinBox()

void KisAngleSelector::useFlatSpinBox

(

bool

newUseFlatSpinBox

)

Sets if the spin box should be flat.

Parameters

newUseFlatSpinBox

True if the spin box should be flat, false otherwise

See also

isUsingFlatSpinBox() const

Definition at line 485 of file KisAngleSelector.cpp.

{
    m_d->spinBox->setFlat(newUseFlatSpinBox);
}

References m_d.

widgetsHeight()

int KisAngleSelector::widgetsHeight

(

)

const

Gets the common height of the widgets inside this angle selector.

Returns

The height of the internal widgets (angle gauge, spin box, etc.). Returns 0 if each widget has its default height.

See also

setWidgetsHeight(int)

Definition at line 382 of file KisAngleSelector.cpp.

{
    return m_d->commonWidgetsHeight;
}

References m_d.

wrapping()

bool KisAngleSelector::wrapping

(

)

const

Gets if the angle should wrap pass the minimum or maximum angles.

Returns

True if the angle should wrap pass the minimum or maximum angles, false otherwise

See also

setWrapping(bool)

Definition at line 372 of file KisAngleSelector.cpp.

{
    return m_d->spinBox->wrapping();
}

References m_d.

Member Data Documentation

m_d

const QScopedPointer<Private> KisAngleSelector::m_d

private

Definition at line 366 of file KisAngleSelector.h.

---

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

• libs/widgets/KisAngleSelector.h
• libs/widgets/KisAngleSelector.cpp