이 페이지에서

Attractor3D QML Type

파티클을 위치 또는 모양으로 끌어당깁니다. 더 보기...

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

Affector3D

속성

상세 설명

이 요소는 파티클을 3D 뷰 내부의 위치로 끌어당깁니다. 무게 중심이 멀리 떨어져 있는 거대한 물체의 중력을 모델링하려면 Gravity3D 을 사용합니다.

끌어당기는 위치는 positionpositionVariation 또는 shape 로 정의합니다. 둘 다 정의된 경우 shape 가 사용됩니다.

속성 문서

duration : int

이 프로퍼티는 파티클이 어트랙션 위치에 도달하는 데 걸리는 시간(밀리초)을 지속 시간으로 정의합니다. 값이 -1이면 파티클 수명이 지속 시간으로 사용됩니다.

기본값은 -1 입니다.

durationVariation : int

이 속성은 밀리초 단위로 기간 변화를 정의합니다. 어트랙터에 도달하는 실제 기간은 duration - durationVariationduration + durationVariation 사이입니다.

기본값은 0 (변동 없음)입니다.

hideAtEnd : bool

이 프로퍼티는 파티클이 어트랙터에 도달했을 때 사라질지 여부를 정의합니다.

기본값은 false 입니다.

positionVariation : vector3d

이 속성은 끌어당기는 위치의 변형을 정의합니다. 한 지점으로 끌어당기는 것이 아니라 더 넓은 영역으로 무작위로 끌어당기는 데 사용할 수 있습니다. 다음은 2~4초 이내에 (100, 0, 0) 위치에서 (50, 50, 50) 큐브 내부의 임의의 점으로 파티클을 끌어당기는 예제입니다:

Attractor3D {
    position: Qt.vector3d(100, 0, 0)
    positionVariation: Qt.vector3d(50, 50, 50)
    duration: 3000
    durationVariation: 1000
}

기본값은 (0, 0, 0) (변형 없음)입니다.

Node::positionshape참조하세요 .

positionsAmount : int

이 프로퍼티는 어트랙터 모양 내에 저장할 수 있는 위치의 양을 정의합니다. 기본적으로 이 양은 파티클 수와 같지만 더 적은 양을 사용하면 캐시를 더 작게 사용할 수 있습니다. 더 많은 양을 사용하면 추가 무작위화를 위해 사용할 수 있습니다.

shape : ParticleAbstractShape3D

이 프로퍼티는 파티클 인력을 위한 ParticleAbstractShape3D 을 정의합니다. 각 파티클은 이 모양 내부의 임의의 위치로 끌어당겨집니다. 이것은 positionpositionVariation 을 정의하는 대안입니다. 다음은 파티클의 끝에서 구 내부의 임의의 지점으로 파티클을 끌어당기는 방법의 예입니다 lifeSpan:

Attractor3D {
    position: Qt.vector3d(100, 0, 0)
    shape: ParticleShape3D {
        type: ParticleShape3D.Sphere
        fill: true
    }
}

Node::positionpositionVariation참조하세요 .

useCachedPositions : bool

이 속성은 어트랙터가 모양 내에서 가능한 위치를 캐시할지 여부를 정의합니다. 캐시된 위치는 덜 무작위적인 결과를 제공하지만 성능에는 더 좋습니다.

기본값은 true 입니다.

© 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.