SpriteParticle3D QML Type

2D 스프라이트 텍스처를 사용하는 파티클입니다. 더 보기...

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

Particle3D

Inherited By:

LineParticle3D

프로퍼티

상세 설명

2D 스프라이트 텍스처에서 파티클을 생성하는 논리적 파티클 엘리먼트인 SpriteParticle3D 입니다.

프로퍼티 문서

BlendMode : enumeration

파티클의 블렌딩 모드를 정의합니다.

Constant설명
SpriteParticle3D.SourceOver소스오버 모드로 파티클을 블렌딩합니다.
SpriteParticle3D.Screen스크린 모드로 파티클을 블렌딩합니다.
SpriteParticle3D.Multiply멀티플라이 모드로 파티클을 블렌딩합니다.

billboard : bool

이 프로퍼티는 파티클 텍스처가 항상 화면을 향하도록 정렬할지 여부를 정의합니다.

참고: true, Particle3D alignMode 속성으로 설정하면 효과가 없습니다.

기본값은 false 입니다.


blendMode : BlendMode

이 프로퍼티는 파티클 렌더링에 사용되는 블렌딩 모드를 정의합니다.

기본값은 SpriteParticle3D.SourceOver 입니다.


castsReflections : bool [since 6.4]

이 프로퍼티가 true 로 설정되면 스프라이트는 리플렉션 프로브에 의해 렌더링되며 리플렉션에서 볼 수 있습니다.

이 프로퍼티는 Qt 6.4에 도입되었습니다.


colorTable : Texture

이 프로퍼티는 파티클을 채색하는 데 사용되는 Texture 을 정의합니다. 이미지는 1D 또는 2D 텍스처일 수 있습니다. 가로 픽셀은 lifeSpan 에 대한 파티클 색상을 결정합니다. 예를 들어 파티클의 수명이 절반인 경우 이미지의 절반에 지정된 색상이 지정됩니다. 이미지가 2D인 경우 각 파티클에 대해 수직 행이 무작위로 선택됩니다. 예를 들어, c {256 x 4} 이미지에는 파티클에 대한 4 다양한 색상 옵션이 포함되어 있습니다.


lights : list<Light> [since 6.3]

이 속성에는 파티클 렌더링에 사용되는 lights 목록이 포함되어 있습니다.

참고: 최적의 성능을 위해 필요한 경우에만 조명을 정의하고 조명 양을 최소한으로 유지하세요.

이 프로퍼티는 Qt 6.3에 도입되었습니다.


offsetX : real [since 6.3]

이 프로퍼티는 X 축에서 파티클 오프셋을 정의합니다.

이 프로퍼티는 Qt 6.3에 도입되었습니다.


offsetY : real [since 6.3]

이 프로퍼티는 Y 축의 파티클 오프셋을 정의합니다.

이 프로퍼티는 Qt 6.3에 도입되었습니다.


particleScale : real

이 프로퍼티는 파티클의 스케일 배수를 정의합니다. 이미터의 파티클 크기를 조정하려면 ParticleEmitter3D particleScale , particleEndScale, particleScaleVariation 프로퍼티를 사용합니다.

기본값은 5.0 입니다.


sprite : Texture

이 프로퍼티는 파티클에 사용되는 Texture 을 정의합니다.

예를 들어 파티클 텍스처로 "snowFlake.png"를 사용합니다:

SpriteParticle3D {
    id: snowParticle
    ...
    sprite: Texture {
        source: "images/snowflake.png"
    }
}

spriteSequence : SpriteSequence3D

이 프로퍼티는 파티클의 스프라이트 시퀀스 프로퍼티를 정의합니다. sprite 텍스처에 프레임 시퀀스가 포함된 경우 이 속성을 설정하여 프레임 수, 애니메이션 방향 등의 기능을 정의합니다.


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