이 페이지에서

Attractor3D QML Type

입자를 특정 위치나 모양 쪽으로 끌어당깁니다. 더 보기...

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

Affector3D

속성

상세 설명

이 요소는 입자들을 3D 뷰 내부의 특정 위치로 끌어당깁니다. 무게 중심이 멀리 떨어져 있는 거대한 물체의 중력을 모델링하려면 Gravity3D 를 사용하십시오.

인력 위치는 ` position ` 및 ` positionVariation `을 사용하거나 ` shape`을 사용하여 정의됩니다. 두 가지가 모두 정의된 경우 ` shape `이 사용됩니다.

속성 설명서

duration : int

이 속성은 입자가 인력 위치에 도달하는 데 걸리는 시간을 밀리초 단위로 정의합니다. 값이 -1일 경우, 입자의 수명(lifeSpan)이 이 시간으로 사용됩니다.

기본값은 -1 입니다.

durationVariation : int

이 속성은 지속 시간의 변동 폭을 밀리초 단위로 정의합니다. 어트랙터에 도달하는 데 걸리는 실제 지속 시간은 duration - durationVariation 과 duration + durationVariation 사이입니다.

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

hideAtEnd : bool

이 속성은 입자가 어트랙터에 도달했을 때 사라져야 하는지 여부를 정의합니다.

기본값은 ‘ false ’입니다.

positionVariation : vector3d

이 속성은 끌어당김 위치의 변동 정도를 정의합니다. 이를 사용하면 입자를 단일 지점으로 끌어당기는 대신, 더 넓은 영역을 향해 무작위로 끌어당길 수 있습니다. 다음은 (100, 0, 0) 위치에 있는 (50, 50, 50) 크기의 큐브 내부에서 임의의 지점으로 2~4초 내에 입자를 끌어당기는 예시입니다:

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

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

Node::position 및 shape도 참조하십시오 .

positionsAmount : int

이 속성은 어트랙터 모양 내에 저장될 수 있는 위치의 수를 정의합니다. 기본적으로 이 값은 입자 수와 동일하지만, 캐시 크기를 줄이려면 더 작은 값을 사용할 수 있습니다. 무작위성을 더 높이려면 더 큰 값을 사용할 수 있습니다.

shape : ParticleAbstractShape3D

이 속성은 입자 인력을 위한 ‘ ParticleAbstractShape3D ’를 정의합니다. 각 입자는 이 도형 내부의 임의의 위치로 끌려갑니다. 이는 position 및 positionVariation 를 정의하는 또 다른 방법입니다. 다음은 입자 끝점( lifeSpan)을 통해 입자를 구 내부 임의의 지점으로 끌어당기는 예시입니다:

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

Node::position 및 positionVariation도 참조하십시오 .

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.