이 페이지에서

SpriteParticle3D QML Type

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

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

Particle3D

Inherited By:

LineParticle3D

속성

상세 설명

SpriteParticle3D는 2D 스프라이트 텍스처를 사용하여 파티클을 생성하는 논리적 파티클 요소입니다.

속성 설명

BlendMode : enumeration

입자의 블렌딩 모드를 정의합니다.

상수설명
SpriteParticle3D.SourceOverSourceOver 모드로 파티클을 블렌딩합니다.
SpriteParticle3D.ScreenScreen 모드로 파티클을 블렌딩합니다.
SpriteParticle3D.MultiplyMultiply 모드로 파티클을 블렌딩합니다.

billboard : bool

이 속성은 파티클 텍스처의 면이 항상 화면을 향하도록 정렬되어야 하는지 여부를 정의합니다.

참고: 이 속성을 ' true'로설정하면 , ' Particle3D ' 및 ' alignMode ' 속성은 적용되지 않습니다.

기본값은 ‘ false ’입니다.

blendMode : BlendMode

이 속성은 파티클을 렌더링할 때 사용되는 블렌딩 모드를 정의합니다.

기본값은 ' SpriteParticle3D.SourceOver'입니다.

castsReflections : bool [since 6.4]

이 속성이 ` true`로 설정되면, 스프라이트는 반사 프로브를 통해 렌더링되며 반사된 화면에 나타납니다.

이 속성은 Qt 6.4에서 도입되었습니다.

colorTable : Texture

이 속성은 입자의 색상을 지정하는 데 사용되는 ‘입자 색상 맵( Texture )’을 정의합니다. 이미지는 1차원 또는 2차원 텍스처일 수 있습니다. 가로 픽셀은 입자의 수명 주기( lifeSpan)에 따른 입자 색상을 결정합니다. 예를 들어, 입자가 수명 주기의 중간 지점에 도달하면 이미지의 중간 지점에 지정된 색상을 갖게 됩니다. 이미지가 2차원인 경우, 각 입자에 대해 세로 행이 무작위로 선택됩니다. 예를 들어, 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 ’ 텍스처에 프레임 시퀀스가 포함되어 있는 경우, 이 속성을 설정하여 프레임 수, 애니메이션 방향 등의 기능을 정의할 수 있습니다.

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