Sprite QML Type

스프라이트 애니메이션을 지정합니다. 더 보기...

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

속성

• duration : int
• durationVariation : int
• frameCount : int
• frameDuration : int
• frameDurationVariation : int
• frameHeight : int
• frameRate : real
• frameRateVariation : real
• frameSync : bool
• frameWidth : int
• frameX : int
• frameY : int
• name : string
• randomStart : bool
• reverse : bool
• source : url
• to : QVariantMap

상세 설명

스프라이트는 SpriteSequence 에 의해 애니메이션 처리되고 렌더링될 하나 이상의 프레임 시리즈를 정의합니다. 스프라이트는 이미지 파일의 중앙에 위치할 수도 있고, 여러 행으로 나뉘어 있을 수도 있습니다. 단, 파일의 왼쪽 가장자리부터 시작하여 파일의 다음 행으로 이어지는 연속된 줄을 형성해야 합니다.

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

속성 설명서

duration : int

애니메이션의 재생 시간. 0보다 작은 값은 유효하지 않습니다.

frameRate 가 유효한 경우, 이를 사용하여 프레임의 지속 시간을 계산합니다. 그렇지 않고 frameDuration 가 유효한 경우, frameDuration 가 사용됩니다. 그 외의 경우에는 duration이 사용됩니다.

durationVariation : int

애니메이션의 지속 시간은 이 값 범위 내에서 변동될 수 있습니다. 변동으로 인해 애니메이션의 길이가 0보다 짧아지는 일은 절대 없습니다.

durationVariation은 프레임의 지속 시간을 계산할 때 duration이 사용되는 경우에만 적용됩니다.

기본값은 0입니다.

frameCount : int

이 스프라이트의 프레임 수.

frameDuration : int

애니메이션의 각 프레임 지속 시간(밀리초 단위). 0보다 작은 값은 유효하지 않습니다.

frameRate 가 유효한 경우, 프레임의 지속 시간을 계산하는 데 이 값이 사용됩니다. 그렇지 않고 frameDuration이 유효한 경우, frameDuration이 사용됩니다. 그 외의 경우에는 duration이 사용됩니다.

frameDurationVariation : int

애니메이션에서 프레임의 지속 시간은 이 값 범위 내에서 변동될 수 있습니다. 변동으로 인해 애니메이션의 길이가 0 미만으로 줄어드는 일은 절대 없습니다.

frameDurationVariation은 프레임 지속 시간을 계산할 때 ` frameDuration `가 사용될 때만 적용됩니다.

기본값은 0입니다.

frameHeight : int

이 스프라이트에서 단일 프레임의 높이.

frameRate : real

애니메이션에 표시할 초당 프레임 수(fps). 0보다 작은 값은 유효하지 않습니다.

frameRate 값이 유효한 경우, 이 값을 사용하여 프레임의 지속 시간을 계산합니다. 그렇지 않고 frameDuration 값이 유효한 경우, frameDuration 값이 사용됩니다. 그 외의 경우에는 duration 값이 사용됩니다.

frameRateVariation : real

애니메이션 간의 프레임 속도는 이 값만큼 변동될 수 있습니다. 이러한 변동으로 인해 애니메이션의 길이가 0 미만으로 줄어들지는 않습니다.

frameRateVariation은 프레임의 지속 시간을 계산할 때 frameRate 가 사용되는 경우에만 적용됩니다.

기본값은 0입니다.

frameSync : bool

true인 경우, 애니메이션의 지속 시간이 설정되지 않습니다. 대신, 화면에 프레임이 렌더링될 때마다 애니메이션이 한 프레임씩 진행됩니다. 이는 경과 시간이 아닌 렌더링 속도와 동기화되는 방식입니다.

frameSync가 true로 설정되면 duration, frameRate 및 frameDuration 의 모든 설정이 무시됩니다.

기본값은 false입니다.

frameWidth : int

이 스프라이트에서 단일 프레임의 너비.

frameX : int

스프라이트의 첫 번째 프레임에 해당하는 이미지 파일의 X 좌표입니다.

frameY : int

스프라이트의 첫 번째 프레임에 해당하는 이미지 파일의 Y 좌표.

name : string

다른 스프라이트의 ‘to’ 속성에 사용할 이 스프라이트의 이름입니다.

randomStart : bool

true인 경우, 애니메이션은 재생 시간 중 무작위 길이를 건너뛴 상태에서 첫 번째 애니메이션을 시작합니다. 이를 통해 애니메이션이 시작될 때 모든 애니메이션이 마치 동시에 시작된 것처럼 보이지 않게 할 수 있습니다.

이 설정은 재생되는 가장 첫 번째 애니메이션에만 영향을 미칩니다. 다른 애니메이션으로 전환하거나 동일한 애니메이션을 다시 재생할 때는 이 기능이 적용되지 않습니다.

기본값은 false입니다.

reverse : bool

true인 경우, 애니메이션이 역방향으로 재생됩니다.

기본값은 false입니다.

source : url

애니메이션의 이미지 소스입니다.

frameHeight 와 frameWidth 가 지정되지 않은 경우, 정사각형 프레임으로 구성된 하나의 긴 행으로 간주됩니다. 그렇지 않은 경우, 여러 개의 연속된 행이나 직사각형 프레임일 수 있으며, 한 행이 끝나는 지점에서 다음 행이 사용됩니다.

frameX 및 frameY 가 지정된 경우, 해당 x/y 좌표를 왼쪽 상단 모서리로 하여 프레임 행이 추출됩니다.

to : QVariantMap

다른 스프라이트 목록과 각 스프라이트로의 가중치 전환 목록입니다. 예를 들어, {"a":1, "b":2, "c":0}와 같은 목록은 이 스프라이트가 종료될 때 3분의 1은 스프라이트 "a"로, 3분의 2는 스프라이트 "b"로 전환되어야 함을 지정합니다. 전환은 무작위로 선택되므로 이러한 비율은 정확하지 않을 수 있습니다. 목록에 "c":0이 포함되어 있으면 어떤 스프라이트도 무작위로 "c"로 전환되지는 않지만, 스프라이트 목표가 설정된 경우에는 유효한 경로가 됩니다.

목록이 지정되지 않았거나 목록 내 가중치의 합이 0인 경우, 스프라이트는 완료 후 스스로 반복됩니다.