이 페이지에서

Wander3D QML Type

입자에 무작위 파형 곡선을 적용합니다. 더 보기...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Affector3D

속성

상세 설명

이 요소는 파티클에 무작위 파형 곡선을 적용합니다. 곡선은 모든 파티클에 동일하게 적용되는 전역 값과 무작위로 달라지는 고유 값을 조합할 수 있습니다.

속성 설명

fadeInDuration : int

이 속성은 어펙터의 페이드 인 지속 시간을 밀리초 단위로 정의합니다. 이 시간이 지나면 워딩 효과가 완전히 적용됩니다. 이 속성을 설정하면 특정 위치나 모양에서 효과를 발산하는 데 유용하며, 그렇지 않으면 워딩 효과가 시작 시점부터 위치에도 영향을 미치게 됩니다.

기본값은 0 입니다.

fadeOutDuration : int

이 속성은 어펙터의 페이드 아웃에 소요되는 시간을 밀리초 단위로 정의합니다. 이 값을 설정하면, 예를 들어 Attractor3D 와 함께 사용하여 입자의 수명이 끝날 때 발생하는 궤도 이탈을 줄이는 데 유용할 수 있으며, 이를 통해 최종 위치가 shape 와 일치하도록 할 수 있습니다.

기본값은 0 입니다.

globalAmount : vector3d

이 속성은 곡선의 끝점에서 각 입자가 이동하는 거리를 정의합니다. 예를 들어, 값이 (100, 10, 0)인 경우, 모든 입자는 (100, 10, 0)과 (-100, -10, 0) 사이를 이동합니다.

기본값은 (0.0, 0.0, 0.0) 입니다.

globalPace : vector3d

이 속성은 각 입자가 1초당 곡선을 따라 이동하는 속도(빈도)를 정의합니다.

기본값은 (0.0, 0.0, 0.0) 입니다.

globalPaceStart : vector3d

이 속성은 페이스(주파수)의 시작점을 정의합니다. 유효한 범위는 0 ~ 2 * PI입니다. 예를 들어, 페이스의 x 좌표를 애니메이션으로 표현하려면 다음과 같이 시작점을 설정합니다:

PropertyAnimation on globalPaceStart {
    loops: Animation.Infinite
    duration: 2000
    from: Qt.vector3d(0, 0, 0)
    to: Qt.vector3d(Math.PI * 2, 0, 0)
}

기본값은 (0.0, 0.0, 0.0) 입니다.

uniqueAmount : vector3d

이 속성은 곡선의 끝부분에서 각 입자가 이동할 수 있는 최대 거리를 정의합니다.

기본값은 (0.0, 0.0, 0.0) 입니다.

uniqueAmountVariation : real

이 속성은 ‘ uniqueAmount ’의 변동 범위를 0.0에서 1.0 사이로 정의합니다. 변동량이 0.0일 때는 모든 입자가 최대 수량에 도달합니다. 변동량이 0.5일 때는 모든 입자가 수량의 0.5~1.5 배 사이가 됩니다. 예를 들어, ` uniqueAmount `가 (100, 50, 20)이고 `uniqueAmountVariation`이 0.1인 경우, 파티클의 최대 파동 거리는 (110, 55, 22)와 (90, 45, 18) 사이의 임의의 값이 됩니다.

기본값은 0.0 입니다.

uniquePace : vector3d

이 속성은 각 입자가 1초당 곡선을 따라 이동하는 고유한 속도(주파수)를 정의합니다.

기본값은 (0.0, 0.0, 0.0) 입니다.

uniquePaceVariation : real

이 속성은 각 입자에 대해 0.0에서 1.0 사이의 고유한 속도(주파수) 변동량을 정의합니다. 변동량이 0.0일 경우, 모든 입자가 동일한 주파수로 이동합니다. 예를 들어, ‘ uniquePace ’가 (1.0, 2.0, 4.0)이고 ‘uniquePaceVariation’이 0.5인 경우, 입자들의 파동 속도는 (2.0, 4.0, 8.0)과 (0.5, 1.0, 2.0) 사이의 무작위 값이 됩니다.

기본값은 0.0 입니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.