Back to Qt.io
Contact Us Blog Download Qt

AnimatedImage QML Type

일련의 이미지로 저장된 애니메이션을 재생합니다. 더 보기...

Import Statement: import QtQuick
Inherits:

Image

속성

상세 설명

AnimatedImage 유형은 Image 유형의 기능을 확장하여 GIF 파일에 저장된 것과 같이 일련의 프레임을 포함하는 이미지로 저장된 애니메이션을 재생할 수 있는 방법을 제공합니다.

애니메이션의 현재 프레임 및 총 길이에 대한 정보는 currentFrame 및 frameCount 속성을 사용하여 얻을 수 있습니다. playing 및 paused 속성의 값을 변경하여 애니메이션을 시작, 일시 중지 및 중지할 수 있습니다.

지원되는 형식의 전체 목록은 QMovie::supportedFormats()로 확인할 수 있습니다.

사용 예

다음 QML은 애니메이션 이미지를 표시하고 현재 프레임 및 총 프레임 수와 같은 상태에 대한 정보를 얻는 방법을 보여줍니다. 결과는 애니메이션 이미지와 그 아래에 간단한 진행률 표시기가 표시됩니다.

참고: 애니메이션 이미지가 캐시되면 애니메이션의 모든 프레임이 캐시됩니다.

길거나 큰 애니메이션을 재생할 때 메모리를 절약하려면 캐시를 false로 설정하세요.

이미지 데이터가 순차적 장치(예: 소켓)에서 오는 경우 캐시가 true로 설정된 경우에만 AnimatedImage를 반복할 수 있습니다.


import QtQuick

Rectangle {
    width: animation.width; height: animation.height + 8

    AnimatedImage { id: animation; source: "animation.gif" }

    Rectangle {
        property int frames: animation.frameCount

        width: 4; height: 8
        x: (animation.width - width) * animation.currentFrame / frames
        y: animation.height
        color: "red"
    }
}

BorderImage 및 Image 을참조하세요 .

속성 문서

currentFrame : int

frameCount : int [read-only]

currentFrame 는 현재 표시되는 프레임입니다. 이 속성의 변경 사항을 모니터링하여 이미지와 동시에 다른 항목에 애니메이션을 적용할 수 있습니다.

frameCount 는 애니메이션의 프레임 수입니다. 일부 애니메이션 형식의 경우 frameCount 알 수 없으며 값은 0입니다.


paused : bool

이 속성은 애니메이션 이미지가 일시 중지되었는지 여부를 보유합니다.

기본적으로 이 속성은 false입니다. 애니메이션을 일시 중지하려면 참으로 설정합니다.


playing : bool

이 속성은 애니메이션 이미지가 재생 중인지 여부를 보유합니다.

기본적으로 이 속성은 true이므로 애니메이션이 즉시 재생되기 시작합니다.

참고: 이 속성은 AnimatedImage 의 실제 재생 상태 변경에 영향을 받습니다. 애니메이션이 없는 이미지를 사용하는 경우 다음 이미지에 애니메이션을 적용하려면 playing 을 true 으로 수동으로 설정해야 합니다.

AnimatedImage {
    onStatusChanged: playing = (status == AnimatedImage.Ready)
}

source : url

이 속성은 소스 이미지를 참조하는 URL을 보유합니다.

AnimatedImage 는 Qt에서 지원하는 모든 이미지 형식을 처리할 수 있으며, Qt에서 지원하는 모든 URL 체계에서 로드됩니다. 그러나 QQuickImageProvider 와는 호환되지 않습니다.


sourceSize : size

이 프로퍼티는 전체 프레임 이미지의 크기 조정된 너비와 높이를 보유합니다.

이미지의 그림 크기를 조정하는 width 및 height 속성과 달리 이 속성은 캐시된 프레임에 저장되는 최대 픽셀 수를 설정하여 큰 애니메이션이 필요 이상으로 많은 메모리를 사용하지 않도록 합니다.

원본 크기가 sourceSize 보다 큰 경우 이미지가 축소됩니다.

이 속성을 undefined 으로 설정하면 이미지의 자연스러운 크기를 복원할 수 있습니다.

참고: 이 속성을 동적으로 변경하면 이미지 소스가 디스크 캐시에 없는 경우 네트워크에서도 이미지 소스를 다시 로드할 수 있습니다.

Image::sourceSize 을참조하세요 .


speed : real [since QtQuick 2.11]

이 속성은 애니메이션의 속도를 유지합니다.

속도는 원본 애니메이션 이미지 속도의 백분율로 측정됩니다. 기본 속도는 1.0(원본 속도)입니다.

이 속성은 QtQuick 2.11에 도입되었습니다.


© 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.