Sprite QML Type
스프라이트 애니메이션을 지정합니다. 더 보기...
Import Statement: | import QtQuick |
속성
- 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 이 사용됩니다. 그렇지 않으면 지속 시간이 사용됩니다.
durationVariation : int |
애니메이션의 지속 시간은 최대 이만큼 달라질 수 있습니다. 변형을 사용하면 애니메이션 길이가 0 미만으로 줄어들지 않습니다.
지속 시간은 프레임 지속 시간을 계산하는 데 지속 시간을 사용하는 경우에만 적용됩니다.
기본값은 0입니다.
frameCount : int |
이 스프라이트의 프레임 수입니다.
frameDuration : int |
애니메이션의 각 프레임의 지속 시간(밀리초)입니다. 0 미만의 값은 유효하지 않습니다.
frameRate 가 유효하면 프레임 지속 시간을 계산하는 데 사용됩니다. 그렇지 않고 frameDuration이 유효하면 frameDuration이 사용됩니다. 그렇지 않으면 duration이 사용됩니다.
frameDurationVariation : int |
애니메이션의 프레임 지속 시간은 최대 이만큼 변할 수 있습니다. 변형은 애니메이션의 길이를 0보다 작게 줄이지 않습니다.
frameDurationVariation은 frameDuration 을 사용하여 프레임 길이를 계산하는 경우에만 적용됩니다.
기본값은 0입니다.
frameHeight : int |
이 스프라이트에서 단일 프레임의 높이입니다.
frameRate : real |
애니메이션에 표시할 초당 프레임 수입니다. 0 미만의 값은 유효하지 않습니다.
frameRate가 유효하면 프레임 지속 시간을 계산하는 데 사용됩니다. 그렇지 않고 frameDuration 가 유효하면 frameDuration 이 사용됩니다. 그렇지 않으면 지속 시간이 사용됩니다.
frameRateVariation : real |
애니메이션 간의 프레임 속도는 최대 이 정도까지 달라질 수 있습니다. 변형을 적용해도 애니메이션의 길이가 0 미만으로 줄어들지 않습니다.
frameRateVariation은 frameRate 을 사용하여 프레임 길이를 계산하는 경우에만 적용됩니다.
기본값은 0입니다.
frameSync : bool |
true이면 애니메이션에 지속 시간이 없습니다. 대신 애니메이션은 한 프레임이 화면에 렌더링될 때마다 한 프레임씩 진행됩니다. 이렇게 하면 경과 시간이 아닌 페인팅 속도와 동기화됩니다.
frameSync를 true로 설정하면 frameRate 및 frameDuration 의 모든 지속 시간을 재정의합니다.
기본값은 false입니다.
frameWidth : int |
이 스프라이트에서 단일 프레임의 너비입니다.
frameX : int |
스프라이트의 첫 번째 프레임의 이미지 파일에 있는 X 좌표입니다.
frameY : int |
스프라이트의 첫 번째 프레임의 이미지 파일에 있는 Y 좌표입니다.
name : string |
다른 스프라이트의 to 프로퍼티에 사용할 이 스프라이트의 이름입니다.
randomStart : bool |
true이면 애니메이션은 지속 시간의 임의의 양을 건너뛴 상태에서 첫 번째 애니메이션을 시작합니다. 이렇게 하면 애니메이션이 시작될 때 모든 애니메이션이 방금 시작된 것처럼 보이지 않게 할 수 있습니다.
이는 가장 먼저 재생되는 애니메이션에만 영향을 줍니다. 다른 애니메이션으로 전환하거나 같은 애니메이션을 다시 재생해도 이 기능은 트리거되지 않습니다.
기본값은 거짓입니다.
reverse : bool |
true이면 애니메이션이 반대로 재생됩니다.
기본값은 거짓입니다.
source : url |
애니메이션의 이미지 소스입니다.
frameHeight 및 frameWidth 을 지정하지 않으면 정사각형 프레임의 긴 행 하나로 간주됩니다. 그렇지 않으면 연속된 여러 행 또는 직사각형 프레임이 될 수 있으며, 한 행이 소진되면 다음 행이 사용됩니다.
frameX 및 frameY 을 지정하면 프레임 행은 해당 x/y 좌표를 왼쪽 상단 모서리로 삼아 가져옵니다.
to : QVariantMap |
다른 스프라이트 목록과 그에 대한 가중치 전환(예: {"a":1, "b":2, "c":0})은 이 스프라이트가 완료되면 1/3은 스프라이트 "a"로, 2/3은 스프라이트 "b"로 전환하도록 지정합니다. 전환은 무작위로 선택되므로 이러한 비율은 정확하지 않습니다. 목록에 "c":0이 있으면 스프라이트가 무작위로 "c"로 전환되지 않지만 스프라이트 목표가 설정되어 있으면 유효한 경로가 됩니다.
목록이 지정되지 않았거나 목록의 가중치 합이 0이면 스프라이트가 완료된 후 반복됩니다.
© 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.