AnimatedImage QML Type

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

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

열거형

• FinishBehavior (since 6.12)

속성

• currentFrame : int
• finishBehavior : enumeration (since 6.12)
• frameCount : int
• loops : int (since 6.12)
• paused : bool
• playing : bool
• source : url
• sourceSize : size
• speed : real (since QtQuick 2.11)

신호

• finished() (since 6.12)

상세 설명

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

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

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

애니메이션 재생 횟수는 ` loops ` 속성을 사용하여 제어할 수 있습니다. 기본적으로 애니메이션은 무한히 반복됩니다. ` finished ` 신호는 애니메이션이 지정된 횟수만큼 재생이 완료되면 발생합니다.

사용 예시

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

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

길거나 용량이 큰 애니메이션을 재생하면서 메모리를 절약하려면 cache를 false로 설정하십시오.

이미지 데이터가 순차적 장치(예: 소켓)에서 제공되는 경우, AnimatedImage는 cache가 true로 설정되어 있을 때만 루프를 반복할 수 있습니다.

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도 참조하십시오 .

열거형 문서

[since 6.12] FinishBehavior

이 열거형은 애니메이션이 자체적으로 종료될 때의 동작을 설명합니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

속성 설명

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

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

finishBehavior : enumeration [since 6.12]

이 속성은 애니메이션이 저절로 종료될 때의 동작을 지정합니다. 기본값은 FinishBehavior.{FinishAtInitialFrame}입니다.

이 속성은 Qt 6.12에서 도입되었습니다.

FinishBehavior도 참조하십시오 .

loops : int [since 6.12]

이 속성은 애니메이션이 재생될 횟수를 지정합니다.

애니메이션이 이 횟수만큼 재생된 후에는 애니메이션이 자동으로 중지되고 finished 신호가 발생합니다.

이 속성이 AnimatedImage.Infinite (기본값)으로 설정된 경우, 애니메이션은 저절로 재생이 중지되지 않습니다.

loops 을 0 로 설정하면 애니메이션이 재생되지 않습니다.

음수 값은 유효하지 않습니다.

이 속성은 Qt 6.12에서 도입되었습니다.

paused : bool

이 속성은 애니메이션 이미지가 일시 정지 상태인지 여부를 나타냅니다.

기본적으로 이 속성의 값은 false입니다. 애니메이션을 일시 정지하려면 이 속성을 true로 설정하십시오.

playing : bool

이 속성은 애니메이션 이미지가 재생 중인지 여부를 나타냅니다.

기본적으로 이 속성은 true이며, 이는 애니메이션이 즉시 재생되기 시작함을 의미합니다.

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

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

source : url

이 속성은 원본 이미지를 가리키는 URL을 저장합니다.

AnimatedImage Qt에서 지원하는 모든 URL 스키마를 통해 로드된, Qt가 지원하는 모든 이미지 형식을 처리할 수 있습니다. 다만 QQuickImageProvider 와는 호환되지 않습니다.

sourceSize : size

이 속성은 전체 프레임 이미지의 확대/축소된 너비와 높이를 저장합니다.

이미지 렌더링을 확대/축소하는 width 및 height 속성과는 달리, 이 속성은 캐시된 프레임에 저장되는 최대 픽셀 수를 설정하여 대용량 애니메이션이 필요 이상의 메모리를 사용하지 않도록 합니다.

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

이 속성을 undefined 로 설정하면 이미지의 원래 크기를 복원할 수 있습니다.

Image::sourceSize도 참조하십시오 .

speed : real [since QtQuick 2.11]

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

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

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

신호 문서

[since 6.12] finished()

이 신호는 애니메이션이 ` loops`에 지정된 횟수만큼 재생이 완료되었을 때 발생합니다.

playing 가 수동으로 false 로 설정된 경우나, loops 속성이 AnimatedImage.Infinite 로 설정된 애니메이션의 경우에는 이 신호가 발생하지 않습니다.

이 신호는 Qt 6.12에서 도입되었습니다.