ImageParticle QML Type
이미지를 사용하여 논리적 입자를 시각화하는 데 사용됩니다. 더 보기...
| Import Statement: | import QtQuick.Particles |
| Inherits: |
속성
- 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 을 정의되지 않음으로 설정하여 재설정하면 모든 색상 데이터가 재설정되고 다른 이미지 파티클의 공유 색상에 대한 암시적 값을 갖기 시작합니다.
참고: 이미지 파티클의 최대 개수는 16383개로 제한됩니다.
속성 문서
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 을 참조하십시오.
허용되는 값은 다음과 같습니다.
| Constant | 설명 |
|---|---|
ImageParticle.None | 파티클이 그냥 나타났다 사라집니다. |
ImageParticle.Fade | 파티클은 수명이 시작될 때 불투명도가 0에서 페이드 인하고 끝날 때 0으로 페이드 아웃합니다. |
ImageParticle.Scale | 파티클은 수명이 시작될 때 0 크기에서 스케일 인하고 끝날 때 0으로 축소됩니다. |
기본값은 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부터는 프로토타입 제작을 돕기 위해 일부 기본 이미지가 리소스로 제공됩니다:
| qrc:///particleresources/star.png |  |
| qrc:///particleresources/glowdot.png |  |
| qrc:///particleresources/fuzzydot.png |  |
컬러화 및 알파 레벨이 최대한의 효과를 낼 수 있도록 이미지가 흰색이고 반투명하다는 점에 유의하세요.
이 파티클을 그리는 데 사용된 스프라이트입니다.
스프라이트 이미지는 렌더링되는 파티클의 크기에 따라 정사각형으로 크기가 조정됩니다.
자세한 내용은 스프라이트 애니메이션 개요를 참조하십시오.
spritesInterpolate : bool |
true로 설정하면 스프라이트 파티클이 렌더링되는 프레임마다 스프라이트 프레임 사이에 보간되어 스프라이트가 더 부드럽게 보입니다.
기본값은 true입니다.
status : Status |
이미지 로딩 상태입니다.
xVector : StochasticDirection |
그려질 때 파티클 이미지를 변형할 수 있습니다. 직사각형 이미지의 가로 변이 (1,0) 대신 이 벡터의 모양이 되도록 변형됩니다.
yVector : StochasticDirection |
그려질 때 파티클 이미지를 변형할 수 있습니다. 직사각형 이미지의 세로 변이 (0,1) 대신 이 벡터의 모양이 되도록 변형됩니다.
© 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.
