QEasingCurve Class

QEasingCurve easing(QEasingCurve::InOutQuad);

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

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

qreal myEasingFunction(qreal progress);

멤버 함수 문서

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

주어진 type 의 이징 곡선을 생성합니다.

QEasingCurve::QEasingCurve(const QEasingCurve &other)

other 의 복사본을 생성하십시오.

[noexcept] QEasingCurve::QEasingCurve(QEasingCurve &&other)

QEasingCurve 인스턴스를 생성하여, 이 인스턴스가 ` other `가 가리키던 것과 동일한 객체를 가리키도록 합니다.

[noexcept] QEasingCurve::~QEasingCurve()

소멸자.

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

사용자 정의 이즈링 곡선을 정의하기 위해 3차 베지어 스플라인 세그먼트를 추가합니다. type()가 QEasingCurve::BezierSpline 인 경우에만 적용됩니다. 유효한 이징 곡선이 되려면 스플라인이 암시적으로 (0.0, 0.0)에서 시작하고 (1.0, 1.0)에서 끝나야 합니다. c1 와 c2 는 곡선을 그리는 데 사용되는 제어점입니다. endPoint 는 곡선의 끝점입니다.

fromCubicBezier()도 참조하십시오 .

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

사용자 정의 이징 곡선을 정의하기 위해 TCB 베지어 스플라인의 한 구간을 추가합니다. 이는 type()이 QEasingCurve::TCBSpline 인 경우에만 적용됩니다. 유효한 이징 곡선이 되려면 스플라인이 반드시 (0.0, 0.0)에서 시작하고 (1.0, 1.0)에서 끝나야 합니다. tension t 은 접선 벡터의 길이를 변경합니다. continuity c 는 접선 간의 변화 정도를 조절합니다. bias b 는 접선 벡터의 방향을 변경합니다. nextPoint 는 샘플 위치입니다. 이 세 매개변수는 모두 -1과 1 사이에서 유효하며, 제어점의 접선을 정의합니다. 세 매개변수가 모두 0인 경우, 결과 스플라인은 캣뮬-롬(Catmull-Rom) 스플라인이 됩니다. 바깥쪽 접선이 정의되지 않기 때문에 시작점과 끝점의 바이어스는 항상 -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()도 참조하십시오 .

[static, since 6.12] QEasingCurve QEasingCurve::fromCubicBezier(QPointF c1, QPointF c2)

지정된 제어점 c1, c2 을 갖는 3차 베지어 곡선을 반환합니다.

3차 베지어 곡선은 C0, C1, C2, C3의 네 개의 제어점으로 정의됩니다. C0와 C3는 각각 시작점과 끝점에 해당합니다. 이 함수는 시작점 C0이 (0, 0)으로, 끝점 C3이 (1, 1)로 고정된 3차 베지어 곡선을 반환합니다.

이 함수는 편의 함수이며, ` addCubicBezierSegment(c1, c2, QPointF(1, 1))`을 호출하는 것과 동일합니다. 더 복잡한 3차 베지어 스플라인을 생성해야 하는 경우, 대신 ` addCubicBezierSegment()` 함수를 사용하십시오.

이 함수는 Qt 6.12에서 도입되었습니다.

addCubicBezierSegment()도 참조하십시오 .

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 `는 ` nullptr`일 수 없습니다.

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()도 참조하십시오 .

[noexcept] void QEasingCurve::swap(QEasingCurve &other)

이 곡선을 other 로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QList<QPointF> QEasingCurve::toCubicSpline() const

사용자 정의 이징 곡선을 정의하는 cubicBezierSpline을 반환합니다. 이징 곡선에 사용자 정의 베지어 이징 곡선이 없는 경우, 목록은 비어 있습니다.

QEasingCurve::Type QEasingCurve::type() const

이징 곡선의 유형을 반환합니다.

setType()도 참조하십시오 .

qreal QEasingCurve::valueForProgress(qreal progress) const

progress 에서 이징 곡선의 유효 진행도를 반환합니다. progress 는 0과 1 사이여야 하는 반면, 반환되는 유효 진행도는 해당 범위를 벗어날 수 있습니다. 예를 들어, QEasingCurve::InBack 는 함수의 시작 부분에서 음수 값을 반환합니다.

[noexcept] QEasingCurve &QEasingCurve::operator=(QEasingCurve &&other)

other 를 이 QEasingCurve 인스턴스에 할당합니다.

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

other 를 복사하세요.