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

상세 설명

이 요소는 논리 파티클을 이미지로 렌더링합니다. 이미지는

• 색상화
• 회전
• 변형
• 스프라이트 기반 애니메이션

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

이러한 데이터 공유는 프로퍼티가 암시적으로 설정되었는지 명시적으로 설정되었는지에 따라 백그라운드에서 이루어집니다. 현재 구현의 한 가지 단점은 전체 기능을 재설정하는 것만 가능하다는 것입니다. 따라서 redVariation 와 같이 색상에 영향을 미치는 속성을 명시적으로 설정한 다음 redVariation 을 정의되지 않음으로 설정하여 재설정하면 모든 색상 데이터가 재설정되고 다른 이미지 파티클의 공유 색상에 대한 암시적 값을 갖기 시작합니다.

속성 문서

alpha : real

이미지에 적용할 알파입니다. 이 값은 이미지의 값과 색상 속성의 값을 곱한 값입니다.

파티클에는 가산 블렌딩이 있으므로 단일 파티클의 알파가 낮을수록 여러 파티클이 겹칠 때 효과가 강해집니다.

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

기본값은 1.0입니다.

alphaVariation : real

파티클 간 알파 채널의 변화입니다.

알파는 0.0에서 1.0 사이로 측정됩니다.

기본값은 0.0입니다.

autoRotation : bool

true로 설정하면 파티클 회전 위에 회전이 적용되어 이동 방향을 향하도록 합니다. 따라서 이동 방향에서 반대쪽을 향하게 하려면 autoRotation을 true로 설정하고 회전은 180으로 설정합니다.

기본값은 false입니다.

blueVariation : real

파티클 간 파란색 채널의 변화입니다.

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

기본값은 0.0입니다.

color : color

색상을 지정하면 제공된 이미지에 해당 색상이 적용됩니다.

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

colorTable : url

수명에 따른 색상을 결정하기 위해 색상이 1D 텍스처로 사용되는 이미지입니다. 예를 들어 파티클의 수명이 절반인 경우 이미지의 절반에 지정된 색상이 지정됩니다.

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

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

수명에 따른 크기를 결정하기 위해 불투명도를 1D 텍스처로 사용할 이미지입니다.

이 프로퍼티는 수명에 따른 불투명도를 결정하는 커스텀 완화 커브를 위해 곧 제거될 예정입니다.

redVariation : real

파티클 간 빨간색 채널의 변화입니다.

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

기본값은 0.0입니다.

rotation : real

설정하면 이미지가 그려지기 전에 이만큼 회전합니다.

파티클 좌표는 변환되지 않습니다.

rotationVariation : real

설정하면 개별 파티클의 회전이 파티클 간에 최대 이만큼 달라집니다.

rotationVelocity : real

설정된 파티클이 이 속도(도/초)로 회전하는 경우.

rotationVelocityVariation : real

개별 파티클의 rotationVelocity 을 설정하면 파티클 간에 최대 이만큼 차이가 납니다.

sizeTable : url

불투명도가 수명에 따른 크기를 결정하기 위해 1D 텍스처로 사용되는 이미지입니다.

이 프로퍼티는 수명에 따른 크기를 결정하는 커스텀 완화 커브를 위해 곧 제거될 예정입니다.

source : url

사용할 소스 이미지입니다.

이미지가 스프라이트 애니메이션인 경우 스프라이트 프로퍼티를 대신 사용합니다.

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

이미지가 흰색이고 반투명해야 색상과 알파 레벨이 최대한 효과를 발휘할 수 있습니다.

sprites : list<Sprite> [read-only]

이 파티클을 그리는 데 사용된 스프라이트입니다.

스프라이트 이미지는 렌더링되는 파티클의 크기에 따라 정사각형으로 스케일링됩니다.

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

spritesInterpolate : bool

true로 설정하면 스프라이트 파티클이 렌더링되는 프레임마다 스프라이트 프레임 사이를 보간하여 스프라이트가 더 부드럽게 보입니다.

기본값은 true입니다.

status : Status [read-only]

이미지 로딩 상태입니다.

xVector : StochasticDirection

파티클 이미지를 그릴 때 변형할 수 있습니다. 직사각형 이미지의 가로 변이 (1,0) 대신 이 벡터의 모양이 되도록 변형됩니다.

yVector : StochasticDirection

파티클 이미지를 그릴 때 변형할 수 있습니다. 직사각형 이미지의 세로 변이 (0,1) 대신 이 벡터의 모양이 되도록 변형됩니다.