ImageParticle QML Type

이미지를 사용하여 논리적 입자를 시각화하기 위해. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• alpha : real
• alphaVariation : real
• autoRotation : bool
• blueVariation : real
• color : color
• colorTable : url
• colorVariation : real
• entryEffect : EntryEffect
• greenVariation : real
• opacityTable : url
• redVariation : real
• rotation : real
• rotationVariation : real
• rotationVelocity : real
• rotationVelocityVariation : real
• sizeTable : url
• source : url
• sprites : list<Sprite>
• spritesInterpolate : bool
• status : Status
• xVector : StochasticDirection
• yVector : StochasticDirection

상세 설명

이 요소는 논리적 입자를 이미지로 렌더링합니다. 이 이미지는

• 색상이 적용되거나
• 회전
• 변형
• 스프라이트 기반 애니메이션

여러 ImageParticles가 동일한 논리적 파티클 그룹을 렌더링하는 경우, ImageParticles는 파티클에 대한 데이터를 암묵적으로 공유합니다. 이는 위에 나열된 네 가지 기능에 따라 구분됩니다. 따라서 한 ImageParticle이 해당 기능 중 하나에 대한 파티클 렌더링 데이터를 정의하고, 다른 ImageParticle은 정의하지 않은 경우, 두 ImageParticle 모두 해당 측면에서 자동으로 동일한 방식으로 파티클을 그립니다. 이는 파티클에 무작위적인 변동이 존재하며, 렌더러를 전환할 때도 해당 변동이 유지되어야 할 때 주로 유용합니다. 두 ImageParticle 모두 해당 측면에 대한 표시 방식을 정의하면, 두 개체는 서로 다른 결과를 보이며 각각 정의된 대로 표시됩니다.

이러한 데이터 공유는 속성이 암시적으로 설정되었는지 명시적으로 설정되었는지에 따라 백그라운드에서 이루어집니다. 현재 구현 방식의 한 가지 단점은 기능을 전체적으로만 재설정할 수 있다는 점입니다. 따라서 redVariation 와 같이 색상에 영향을 미치는 속성을 명시적으로 설정한 후, 이를 재설정( redVariation 를 undefined로 설정)하면 모든 색상 데이터가 초기화되며, 다른 ImageParticles에서 공유되는 임의의 색상 값을 암시적 값으로 갖게 됩니다.

속성 설명서

alpha : real

이미지에 적용될 알파 값입니다. 이 값은 이미지의 값과 color 속성의 값에 곱해집니다.

입자는 가산 블렌딩 방식을 사용하므로, 개별 입자의 알파 값을 낮출수록 여러 입자가 겹칠 때 효과가 더욱 강해집니다.

알파 값은 0.0에서 1.0까지 측정됩니다.

기본값은 1.0입니다.

alphaVariation : real

입자 간 알파 채널의 차이.

알파 값은 0.0에서 1.0까지 측정됩니다.

기본값은 0.0입니다.

autoRotation : bool

true로 설정하면 파티클의 회전 위에 추가 회전이 적용되어 이동 방향을 향하게 됩니다. 따라서 이동 방향과 반대 방향을 향하게 하려면 autoRotation을 true로, rotation을 180으로 설정하세요.

기본값은 false입니다.

blueVariation : real

입자 간 파란색 채널의 차이.

색상은 채널별로 0.0에서 1.0까지 측정됩니다.

기본값은 0.0입니다.

color : color

색상이 지정된 경우, 제공된 이미지에 해당 색상이 적용됩니다.

기본값은 흰색(변경 없음)입니다.

colorTable : url

생애에 따른 색상을 결정하기 위해 1차원 텍스처로 사용될 이미지의 색상입니다. 예를 들어, 입자가 수명의 절반 지점에 도달하면 이미지 중간 지점에 지정된 색상을 띠게 됩니다.

이 색상은 color 속성 및 소스 이미지의 색상과 혼합됩니다.

colorVariation : real

이 숫자는 개별 입자에 적용되는 색상 변이를 나타냅니다. colorVariation을 설정하는 것은 redVariation, greenVariation, blueVariation 를 모두 동일한 숫자로 설정하는 것과 같습니다.

각 채널은 입자마다 일반적인 색상에서 colorVariation 값만큼 최대 편차를 보일 수 있습니다.

색상은 채널별로 0.0에서 1.0까지 측정됩니다.

기본값은 0.0입니다.

entryEffect : EntryEffect

이 속성은 파티클에 대한 기본적이고 저렴한 진입 및 퇴장 효과를 제공합니다. 더 세밀한 제어를 원하시면 sizeTable 및 opacityTable 를 참조하십시오.

허용되는 값은 다음과 같습니다.

기본값은 ImageParticle.Fade 입니다.

greenVariation : real

입자 간 녹색 색상 채널의 변동.

색상은 채널별로 0.0에서 1.0까지 측정됩니다.

기본값은 0.0입니다.

opacityTable : url

투명도가 1차원 텍스처로 사용되어 수명 주기에 따른 크기를 결정하는 이미지입니다.

이 속성은 수명 주기에 따른 불투명도를 결정하기 위해 사용자 정의 이징 곡선이 도입됨에 따라 조만간 제거될 예정입니다.

redVariation : real

입자 간 적색 색상 채널의 차이.

색상은 채널별로 0.0에서 1.0까지 측정됩니다.

기본값은 0.0입니다.

rotation : real

이 값을 설정하면 이미지가 그려지기 전에 이만큼의 각도로 회전됩니다.

입자의 좌표는 변환되지 않습니다.

rotationVariation : real

이 값을 설정하면 개별 입자 간의 회전 각도 차이가 최대 이만큼까지 달라집니다.

rotationVelocity : real

이 값이 설정되면 입자는 초당 도 단위의 이 속도로 회전합니다.

rotationVelocityVariation : real

이 값을 설정하면 개별 입자 간의 ‘ rotationVelocity ’ 값이 최대 이 정도까지 차이가 납니다.

sizeTable : url

투명도가 1차원 텍스처로 사용되어 수명 주기에 따른 크기를 결정하는 이미지입니다.

이 속성은 수명 주기에 따른 크기 변화를 결정하기 위해 사용자 정의 이징 커브를 사용하도록 변경됨에 따라 조만간 제거될 예정입니다.

source : url

사용할 원본 이미지입니다.

이미지가 스프라이트 애니메이션인 경우, 대신 sprite 속성을 사용하십시오.

Qt 5.2부터는 프로토타이핑을 돕기 위해 몇 가지 기본 이미지가 리소스로 제공됩니다:

이 이미지들은 색상 적용과 알파 레벨이 최대한의 효과를 낼 수 있도록 흰색이며 반투명하다는 점에 유의하십시오.

sprites : list<Sprite> [read-only]

이 파티클을 그리는 데 사용되는 스프라이트.

스프라이트 이미지는 렌더링되는 파티클의 크기에 따라 정사각형으로 크기가 조정된다는 점에 유의하십시오.

자세한 내용은 스프라이트 애니메이션 개요를 참조하십시오.

spritesInterpolate : bool

true로 설정하면, 스프라이트 입자는 렌더링되는 각 프레임마다 스프라이트 프레임 간에 보간 처리가 이루어져 스프라이트가 더 부드럽게 보입니다.

기본값은 true입니다.

status : Status [read-only]

이미지 로딩 상태.

xVector : StochasticDirection

그려질 때 파티클 이미지를 변형할 수 있게 해줍니다. 직사각형 이미지는 가로 변이 (1,0)이 아닌 이 벡터의 모양을 띠도록 변형됩니다.

yVector : StochasticDirection

그려질 때 파티클 이미지를 변형할 수 있게 해줍니다. 직사각형 이미지는 수직 변이 (0,1)이 아닌 이 벡터의 모양을 띠도록 변형됩니다.