Класс QEasingCurve

Класс QEasingCurve предоставляет кривые сглаживания для управления анимацией. Подробнее...

Этот класс был представлен в Qt 4.6.

• Список всех членов, включая унаследованные
• Устаревшие члены

Публичные типы

Публичные функции

Связанные нечлены

Подробное описание

Кривые сглаживания описывают функцию, которая контролирует, как должна меняться скорость интерполяции между 0 и 1. Кривые сглаживания позволяют переходам от одного значения к другому выглядеть более естественно, чем это позволила бы простая постоянная скорость. Класс QEasingCurve обычно используется в сочетании с классами QVariantAnimation и QPropertyAnimation, но может использоваться и самостоятельно. Обычно он используется для ускорения интерполяции от нулевой скорости (входное сглаживание) или замедления до нулевой скорости (выходное сглаживание). Входное и выходное сглаживание также могут быть объединены в одной кривой сглаживания.

Для вычисления скорости интерполяции кривая сглаживания предоставляет функцию valueForProgress(), где аргумент progress указывает на прогресс интерполяции: 0 — начальное значение интерполяции, 1 — конечное значение интерполяции. Возвращаемое значение — эффективный прогресс интерполяции. Если возвращаемое значение такое же, как входное значение для всех входных значений, кривая сглаживания является линейной кривой. Это поведение по умолчанию.

Например,

    QEasingCurve easing(QEasingCurve::InOutQuad);

    for (qreal t = 0.0; t < 1.0; t += 0.1)
        qWarning() << "Effective progress" << t << "is"
                   << easing.valueForProgress(t);

будет выводить эффективный прогресс интерполяции между 0 и 1.

При использовании QPropertyAnimation связанная кривая сглаживания будет использоваться для управления прогрессом интерполяции между startValue и endValue:

    QPropertyAnimation animation;
    animation.setStartValue(0);
    animation.setEndValue(1000);
    animation.setDuration(1000);
    animation.setEasingCurve(QEasingCurve::InOutQuad);

Возможность установить амплитуду, перехват или период зависит от типа QEasingCurve. Доступ к амплитуде есть у кривых, которые ведут себя как пружины, такие как эластичные и отскочившие кривые. Изменение амплитуды изменяет высоту кривой. Доступ к периоду есть только у эластичных кривых, и установка большего периода замедляет скорость отскока. Только кривые, которые имеют поведение «бумеранга», такие как InBack, OutBack, InOutBack и OutInBack, имеют настройки перехвата. Эти кривые будут интерполировать за пределами конечных точек и возвращаться в конечную точку, действуя аналогично бумерангу.

Пример кривых сглаживания содержит примеры типов QEasingCurve и позволяет изменять настройки кривой.

Документация по типам членов

typedef QEasingCurve::EasingFunction

Это typedef для указателя на функцию со следующим сигнатуром:

qreal myEasingFunction(qreal progress);

перечисление QEasingCurve::Type

Тип кривой сглаживания.

Кривая сглаживания для линейной (t) функции: скорость постоянна.

Кривая сглаживания для квадратичной (t^2) функции: ускорение с нулевой скорости.

Кривая сглаживания для квадратичной (t^2) функции: замедление до нулевой скорости.

Кривая сглаживания для квадратичной (t^2) функции: ускорение до середины, затем замедление.

Кривая сглаживания для квадратичной (t^2) функции: замедление до середины, затем ускорение.

Кривая сглаживания для кубической (t^3) функции: ускорение с нулевой скорости.

Кривая плавного изменения для кубической (t^3) функции: замедление до нулевой скорости.

Кривая плавного изменения для кубической (t^3) функции: ускорение до середины, затем замедление.

Кривая плавного изменения для кубической (t^3) функции: замедление до середины, затем ускорение.

Кривая плавного изменения для четвёртой степени (t^4) функции: ускорение от нулевой скорости.

Кривая плавного изменения для четвёртой степени (t^4) функции: замедление до нулевой скорости.

Кривая плавного изменения для четвёртой степени (t^4) функции: ускорение до середины, затем замедление.

Кривая плавного изменения для четвёртой степени (t^4) функции: замедление до середины, затем ускорение.

Кривая плавного изменения для пятой степени (t^5) функции: ускорение от нулевой скорости.

Кривая плавного изменения для пятой степени (t^5) функции: замедление до нулевой скорости.

Кривая плавного изменения для пятой степени (t^5) функции: ускорение до середины, затем замедление.

Кривая плавного изменения для пятой степени (t^5) функции: замедление до середины, затем ускорение.

Кривая плавного изменения для синусоидальной (sin(t)) функции: ускорение от нулевой скорости.

Кривая плавного изменения для синусоидальной (sin(t)) функции: замедление до нулевой скорости.

Кривая плавного изменения для синусоидальной (sin(t)) функции: ускорение до середины, затем замедление.

Кривая плавного изменения для синусоидальной (sin(t)) функции: замедление до середины, затем ускорение.

Кривая плавного изменения для экспоненциальной (2^t) функции: ускорение от нулевой скорости.

Кривая плавного изменения для экспоненциальной (2^t) функции: замедление до нулевой скорости.

Кривая плавного изменения для экспоненциальной (2^t) функции: ускорение до середины, затем замедление.

Кривая плавного изменения для экспоненциальной (2^t) функции: замедление до середины, затем ускорение.

Кривая плавного изменения для круговой (sqrt(1-t^2)) функции: ускорение от нулевой скорости.

Кривая плавного изменения для круговой (sqrt(1-t^2)) функции: замедление до нулевой скорости.

Кривая плавного изменения для круговой (sqrt(1-t^2)) функции: ускорение до середины, затем замедление.

Кривая плавного изменения для круговой (sqrt(1-t^2)) функции: замедление до середины, затем ускорение.

Кривая плавного изменения для эластичной (экспоненциально затухающей синусоидальной) функции: ускорение от нулевой скорости. Пиковую амплитуду можно задать параметром amplitude, а период затухания — параметром period.

Кривая плавного изменения для эластичной (экспоненциально затухающей синусоидальной) функции: замедление до нулевой скорости. Пиковую амплитуду можно задать параметром amplitude, а период затухания — параметром period.

Кривая плавного изменения для эластичной (экспоненциально затухающей синусоидальной) функции: ускорение до середины, затем замедление.

Кривая плавного изменения для эластичной (экспоненциально затухающей синусоидальной) функции: замедление до середины, затем ускорение.

Кривая плавного изменения для обратной (перескок кубической функции: (s+1)*t^3 - s*t^2) функции: ускорение от нулевой скорости.

Кривая плавного изменения для обратной (перескок кубической функции: (s+1)*t^3 - s*t^2) функции: замедление до нулевой скорости.

Кривая сглаживания для обратного эффекта (перескочивающая кубическая функция: (s+1)*t^3 - s*t^2) ввод/вывод: ускорение до середины, затем замедление.

Кривая сглаживания для обратного эффекта (перескочивающая кубическая функция: (s+1)*t^3 - s*t^2) вывод/ввод: замедление до середины, затем ускорение.

Кривая сглаживания для эффекта отскока (экспоненциально убывающая параболическая функция отскока): ускорение с нулевой скорости.

Кривая сглаживания для эффекта отскока (экспоненциально убывающая параболическая функция отскока): замедление с нулевой скорости.

Кривая сглаживания для эффекта отскока (экспоненциально убывающая параболическая функция отскока) ввод/вывод: ускорение до середины, затем замедление.

Кривая сглаживания для эффекта отскока (экспоненциально убывающая параболическая функция отскока) вывод/ввод: замедление до середины, затем ускорение.

См. также addCubicBezierSegment() и addTCBSegment().

Документация по функциям-членам

QEasingCurve::QEasingCurve(QEasingCurve &&other)

Перемещающая конструкция QEasingCurve экземпляра, делая его указывать на тот же объект, на который указывал other.

Эта функция была представлена в Qt 5.2.

QEasingCurve::QEasingCurve(const QEasingCurve &other)

Создает копию other.

QEasingCurve::QEasingCurve(QEasingCurve::Type type = Linear)

Создает кривую сглаживания заданного типа type.

QEasingCurve &QEasingCurve::operator=(QEasingCurve &&other)

Перемещающая присваивание other этому экземпляру QEasingCurve.

Эта функция была представлена в Qt 5.2.

QEasingCurve &QEasingCurve::operator=(const QEasingCurve &other)

Копирует other.

QEasingCurve::~QEasingCurve()

Деструктор.

void QEasingCurve::addCubicBezierSegment(const QPointF &c1, const QPointF &c2, const QPointF &endPoint)

Добавляет отрезок кубической сплайн-кривой Безье для определения пользовательской кривой сглаживания. Применимо только если type() равен QEasingCurve::BezierSpline. Обратите внимание, что сплайн неявно начинается с (0.0, 0.0) и должен заканчиваться (1.0, 1.0), чтобы быть допустимой кривой сглаживания. c1 и c2 — контрольные точки, используемые для построения кривой. endPoint — конечная точка кривой.

void QEasingCurve::addTCBSegment(const QPointF &nextPoint, qreal t, qreal c, qreal b)

Добавляет отрезок TCB-сплайн-кривой Безье для определения пользовательской кривой сглаживания. Применимо только если type() равен QEasingCurve::TCBSpline. Сплайн должен явно начинаться с (0.0, 0.0) и заканчиваться (1.0, 1.0), чтобы быть допустимой кривой сглаживания. Напряжение t изменяет длину вектора касательной. Непрерывность c изменяет резкость изменения между касательными. Смещение b изменяет направление вектора касательной. nextPoint — положение образца. Все три параметра действительны в диапазоне от -1 до 1 и определяют касательную контрольной точки. Если все три параметра равны 0, полученная сплайн-кривая является сплайн-кривой Катмулла-Рома. Начало и конец всегда имеют смещение -1 и 1, так как внешняя касательная не определена.

qreal QEasingCurve::amplitude() const

Возвращает амплитуду. Это не применимо ко всем типам кривых. Это применимо только к кривым отскока и упругости (кривые типа type() QEasingCurve::InBounce, QEasingCurve::OutBounce, QEasingCurve::InOutBounce, QEasingCurve::OutInBounce, QEasingCurve::InElastic, QEasingCurve::OutElastic, QEasingCurve::InOutElastic или QEasingCurve::OutInElastic).

См. также setAmplitude().

QEasingCurve::EasingFunction QEasingCurve::customType() const

Возвращает указатель на функцию пользовательской кривой сглаживания. Если type() не возвращает QEasingCurve::Custom, эта функция вернет 0.

См. также setCustomType().

qreal QEasingCurve::overshoot() const

Возвращает перескок. Это не применимо ко всем типам кривых. Это применимо только если type() равен QEasingCurve::InBack, QEasingCurve::OutBack, QEasingCurve::InOutBack или QEasingCurve::OutInBack.

См. также setOvershoot().

qreal QEasingCurve::period() const

Возвращает период. Это не применимо ко всем типам кривых. Это применимо только если type() равен QEasingCurve::InElastic, QEasingCurve::OutElastic, QEasingCurve::InOutElastic или QEasingCurve::OutInElastic.

См. также setPeriod().

void QEasingCurve::setAmplitude(qreal amplitude)

Устанавливает амплитуду в amplitude.

Это установит амплитуду отскока или амплитуду эффекта упругой «пружины». Чем выше число, тем выше амплитуда.

См. также amplitude().

void QEasingCurve::setCustomType(QEasingCurve::EasingFunction func)

Устанавливает пользовательскую кривую сглаживания, определенную пользователем в функции func. Подпись функции — qreal myEasingFunction(qreal progress), где progress и возвращаемое значение рассматриваются как нормированные значения между 0 и 1. (В некоторых случаях возвращаемое значение может быть вне этого диапазона) После вызова этой функции type() вернёт QEasingCurve::Custom. func не может быть нулём.

См. также customType() и valueForProgress().

void QEasingCurve::setOvershoot(qreal overshoot)

Устанавливает перескок в overshoot.

0 не приводит к перескоку, а значение по умолчанию 1.70158 приводит к перескоку на 10 процентов.

См. также overshoot().

void QEasingCurve::setPeriod(qreal period)

Устанавливает период в period. Установка малого значения периода обеспечит высокую частоту кривой. Большое значение периода обеспечит низкую частоту.

См. также period().

void QEasingCurve::setType(QEasingCurve::Type type)

Устанавливает тип кривой сглаживания в type.

См. также type().

void QEasingCurve::swap(QEasingCurve &other)

Меняет местами кривую other с этой кривой. Данная операция очень быстрая и никогда не терпит неудачу.

Эта функция была представлена в Qt 5.0.

QVector<QPointF> QEasingCurve::toCubicSpline() const

Возвращает cubicBezierSpline, который определяет пользовательскую кривую сглаживания. Если кривая сглаживания не имеет пользовательской кривой сглаживания bezier, список пуст.

Эта функция была представлена в Qt 5.0.

QEasingCurve::Type QEasingCurve::type() const

Возвращает тип кривой сглаживания.

См. также setType().

qreal QEasingCurve::valueForProgress(qreal progress) const

Возвращает эффективное значение прогресса для кривой сглаживания в точке progress. В то время как progress должен быть в пределах от 0 до 1, возвращаемое эффективное значение прогресса может быть вне этих границ. Например, QEasingCurve::InBack вернёт отрицательные значения в начале функции.

bool QEasingCurve::operator!=(const QEasingCurve &other) const

Сравнивает эту кривую сглаживания с other и возвращает true, если они не равны. Также сравниваются свойства кривой.

См. также operator==().

bool QEasingCurve::operator==(const QEasingCurve &other) const

Сравнивает эту кривую сглаживания с other и возвращает true, если они равны. Также сравниваются свойства кривой.