SpriteParticle3D QML Type

Particle using a 2D sprite texture. 更多...

import 語句：	import QtQuick3D.Particles3D
Since:	Qt 6.2
繼承：	Particle3D
繼承者：	LineParticle3D

所有成員列錶，包括繼承成員

特性

BlendMode : enumeration
billboard : bool
blendMode : BlendMode
castsReflections : bool
colorTable : Texture
lights : list<Light>
offsetX : float
offsetY : float
particleScale : real
sprite : Texture
spriteSequence : SpriteSequence3D

詳細描述

The SpriteParticle3D is a logical particle element that creates particles from a 2D sprite texture.

特性文檔編製

BlendMode : enumeration

Defines the blending mode for the particles.

常量	描述
`SpriteParticle3D.SourceOver`	Blend particles with SourceOver mode.
`SpriteParticle3D.Screen`	Blend particles with Screen mode.
`SpriteParticle3D.Multiply`	Blend particles with Multiply mode.

billboard : bool

This property defines if the particle texture should always be aligned face towards the screen.

注意： 當設為 true , Particle3D alignMode property does not have an effect.

默認值為 false .

blendMode : BlendMode

This property defines the blending mode used for rendering the particles.

默認值為 SpriteParticle3D.SourceOver .

[since 6.4] castsReflections : bool

當此特性被設為 true , the sprite is rendered by reflection probes and can be seen in the reflections.

This property was introduced in Qt 6.4.

colorTable : Texture

This property defines the Texture used for coloring the particles. The image can be a 1D or a 2D texture. Horizontal pixels determine the particle color over its lifeSpan . For example, when the particle is halfway through its life, it will have the color specified halfway across the image. If the image is 2D, vertical row is randomly selected for each particle. For example, a c {256 x 4} image contains 4 different coloring options for particles.

[since 6.3] lights : list < Light >

This property contains a list of lights used for rendering the particles.

注意： For optimal performance, define lights only if they are needed and keep the amount of lights at minimum.

This property was introduced in Qt 6.3.

[since 6.3] offsetX : float

This property defines the particles offset in the X axis

This property was introduced in Qt 6.3.

[since 6.3] offsetY : float

This property defines the particles offset in the Y axis

This property was introduced in Qt 6.3.

particleScale : real

This property defines the scale multiplier of the particles. To adjust the particles sizes in the emitter, use ParticleEmitter3D particleScale , particleEndScale ，和 particleScaleVariation 特性。

默認值為 5.0 .

sprite : Texture

This property defines the Texture used for the particles.

For example, to use "snowFlake.png" as the particles texture:

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

spriteSequence : SpriteSequence3D

This property defines the sprite sequence properties for the particle. If the sprite texture contains a frame sequence, set this property to define the frame count, animation direction etc. features.