Image QML Type

이러한 속성은 실제로 그려지는 이미지의 크기를 유지합니다. 대부분의 경우 width 및 height 과 동일하지만 Image.PreserveAspectFit 또는 Image.PreserveAspectCrop paintedWidth 또는 paintedHeight 을 사용하는 경우 이미지 항목의 width 및 height 보다 작거나 클 수 있습니다.

이미지의 가로 및 세로 정렬을 설정합니다. 기본적으로 이미지는 가운데 정렬됩니다.

horizontalAlignment 의 유효한 값은 Image.AlignLeft, Image.AlignRight 및 Image.AlignHCenter 입니다. verticalAlignment 의 유효한 값은 Image.AlignTop, Image.AlignBottom 및 Image.AlignVCenter 입니다.

currentFrame 는 현재 표시되는 프레임입니다. 기본값은 0 입니다. 이미지에 여러 프레임이 포함된 경우 0 과 frameCount - 1 사이의 숫자로 설정하여 다른 프레임을 표시할 수 있습니다.

frameCount 는 이미지의 프레임 수입니다. 대부분의 이미지에는 프레임이 하나만 있습니다.

로컬 파일시스템의 이미지를 별도의 스레드에서 비동기적으로 로드하도록 지정합니다. 기본값은 false이므로 이미지가 로드되는 동안 사용자 인터페이스 스레드가 차단됩니다. asynchronous 을 참으로 설정하면 이미지를 즉시 표시하는 것보다 반응형 사용자 인터페이스를 유지하는 것이 더 바람직한 경우에 유용합니다.

이 속성은 로컬 파일 시스템에서 읽은 이미지에만 유효합니다. 네트워크 리소스(예: HTTP)를 통해 로드된 이미지는 항상 비동기적으로 로드됩니다.

이 속성에는 이미지에 EXIF 방향과 같은 이미지 변환 메타데이터를 자동으로 적용할지 여부가 포함됩니다.

기본적으로 이 속성은 false로 설정되어 있습니다.

이미지를 캐시할지 여부를 지정합니다. 기본값은 true입니다. cache 을 false로 설정하면 큰 이미지를 처리할 때 작은 'UI 요소' 이미지를 희생시키면서 캐시되지 않도록 하는 데 유용합니다.

이 속성을 설정하면 소스 이미지의 크기가 항목과 다른 경우 발생하는 상황을 정의할 수 있습니다.

Image {
    width: 130; height: 100
    source: "qtlogo.png"
}

Image {
    width: 130; height: 100
    fillMode: Image.PreserveAspectFit
    source: "qtlogo.png"
}

Image {
    width: 130; height: 100
    fillMode: Image.PreserveAspectCrop
    source: "qtlogo.png"
    clip: true
}

Image {
    width: 120; height: 120
    fillMode: Image.Tile
    horizontalAlignment: Image.AlignLeft
    verticalAlignment: Image.AlignTop
    source: "qtlogo.png"
}

Image {
    width: 120; height: 120
    fillMode: Image.TileVertically
    verticalAlignment: Image.AlignTop
    source: "qtlogo.png"
}

Image {
    width: 120; height: 120
    fillMode: Image.TileHorizontally
    verticalAlignment: Image.AlignLeft
    source: "qtlogo.png"
}

clip 는 기본적으로 false 이므로 fillMode가 PreserveAspectCrop 로 설정되어 있어도 항목이 경계 사각형 외부로 칠할 수 있습니다.

Qt Quick 예제 - 이미지 요소도참조하세요 .

이 속성은 이미지가 크기 조정 또는 변형될 때 밉맵 필터링을 사용할지 여부를 보유합니다.

밉맵 필터링은 부드럽게 축소할 때보다 시각적 품질을 향상시키지만, 이미지를 초기화할 때와 렌더링할 때 모두 성능 저하가 발생할 수 있습니다.

기본적으로 이 속성은 false로 설정되어 있습니다.

smooth 를참조하세요 .

이 속성은 이미지를 가로로 반전할지(효과적으로 미러링된 이미지를 표시할지) 여부를 결정합니다.

기본값은 false입니다.

이 속성은 이미지를 세로로 반전할지(미러링된 이미지를 효과적으로 표시할지) 여부를 저장합니다.

기본값은 false입니다.

이 프로퍼티는 Qt 6.2에 도입되었습니다.

이 속성은 0.0(아무것도 로드되지 않음)에서 1.0(완료)까지 이미지 로딩 진행률을 보유합니다.

status 를참조하세요 .

이 속성은 source 속성이 변경되어 로딩이 비동기적으로 수행될 때의 동작을 정의합니다. asynchronous 속성이 true 으로 설정되어 있거나 이미지가 로컬 파일 시스템에 없는 경우에 해당합니다.

retainWhileLoading 가 false (기본값)인 경우 이전 이미지는 즉시 삭제되고 새 이미지가 로드되는 동안 컴포넌트가 지워집니다. true 로 설정하면 이전 이미지가 유지되며 새 이미지가 준비될 때까지 계속 표시됩니다.

이 속성을 활성화하면 새 이미지를 로드하는 데 시간이 오래 걸리는 경우 깜박임을 방지할 수 있습니다. 새 이미지가 로드되는 동안 이중 버퍼링을 위해 메모리를 추가로 사용하는 대가가 따릅니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 속성은 이미지 크기 조정 또는 변형 시 이미지가 부드럽게 필터링되는지 여부를 유지합니다. 부드럽게 필터링하면 시각적 품질이 향상되지만 일부 하드웨어에서는 속도가 느려질 수 있습니다. 이미지가 자연스러운 크기로 표시되는 경우 이 속성은 시각적 또는 성능에 영향을 미치지 않습니다.

기본적으로 이 속성은 true로 설정되어 있습니다.

mipmap 를참조하세요 .

Image는 Qt에서 지원하는 모든 이미지 형식을 처리할 수 있으며, Qt에서 지원하는 모든 URL 체계에서 로드할 수 있습니다.

URL은 절대적이거나 컴포넌트의 URL에 상대적일 수 있습니다.

QQuickImageProvider, Compressed Texture Files, Automatic Detection of File Extension 를참조하십시오 .

이 속성을 설정하면 로드할 소스 이미지의 직사각형 영역을 보유합니다.

sourceClipRect 는 이미지의 일부만 로드해야 하는 경우 sourceSize 속성과 함께 작동하여 시스템 리소스를 절약합니다.

Rectangle {
    width: ...
    height: ...

    Image {
       anchors.fill: parent
       source: "reallyBigImage.svg"
       sourceSize.width: 1024
       sourceSize.height: 1024
       sourceClipRect: Qt.rect(100, 100, 512, 512)
    }
}

위의 예에서는 먼저 SVG 그래픽의 크기를 1024x1024로 조정한 다음, 상단과 왼쪽 가장자리에서 100픽셀 떨어진 위치에서 512x512픽셀의 관심 영역을 잘라냅니다. 따라서 sourceSize 이 배율을 결정하지만 실제 출력 이미지는 512x512픽셀입니다.

일부 이미지 형식은 지정된 영역만 렌더링하여 CPU 시간을 절약할 수 있습니다. 다른 형식은 전체 이미지를 먼저 로드한 다음 지정된 영역으로 클립해야 합니다.

sourceClipRect 을 undefined 으로 설정하여 전체 이미지를 다시 로드하도록 이 속성을 지울 수 있습니다.

이 속성은 풀프레임 이미지의 크기 조정된 너비와 높이를 보유합니다.

이미지의 그림 크기를 조정하는 width 및 height 속성과 달리 이 속성은 로드된 이미지에 대해 저장되는 최대 픽셀 수를 설정하여 큰 이미지가 필요 이상으로 많은 메모리를 사용하지 않도록 합니다. 예를 들어 이미지의 width 및 height 값에 관계없이 메모리에 저장되는 이미지가 1024x1024 픽셀보다 크지 않도록 합니다:

Rectangle {
    width: ...
    height: ...

    Image {
       anchors.fill: parent
       source: "reallyBigImage.jpg"
       sourceSize.width: 1024
       sourceSize.height: 1024
    }
}

이미지의 실제 크기가 sourceSize보다 크면 이미지가 축소됩니다. 크기의 한 치수만 0보다 크게 설정된 경우 소스 이미지의 가로 세로 비율을 유지하기 위해 다른 치수가 비례하여 설정됩니다. ( fillMode 는 이와 무관합니다.)

sourceSize.width와 sourceSize.height를 모두 설정하면 이미지의 가로 세로 비율을 유지하면서 지정된 크기에 맞게 이미지가 축소됩니다(PreserveAspectCrop 또는 PreserveAspectFit을 사용하지 않는 경우 자르기/맞추기를 위한 최적 크기에 맞게 조정됨). 크기 조정 후 이미지의 실제 크기는 Item::implicitWidth 및 Item::implicitHeight 에서 확인할 수 있습니다.

소스가 본질적으로 크기 조정이 가능한 이미지(예: SVG)인 경우 이 속성은 본질적인 크기와 관계없이 로드된 이미지의 크기를 결정합니다. 이 속성을 동적으로 변경하면 이미지에 비해 SVG 렌더링 속도가 느려지므로 변경하지 마세요.

소스가 확장 불가능한 이미지(예: JPEG)인 경우 로드된 이미지는 이 속성이 지정한 크기보다 크지 않습니다. 일부 형식(현재 JPEG만 해당)의 경우 전체 이미지가 실제로 메모리에 로드되지 않습니다.

sourceClipRect 속성도 설정되어 있으면 sourceSize 이 배율을 결정하지만 클립 사각형의 크기로 잘립니다.

sourceSize를 undefined 로 설정하여 이미지의 자연스러운 크기로 지울 수 있습니다.

Qt Quick 예제 - 포인터 핸들러를참조하세요 .

이 속성은 이미지 로딩 상태를 보유합니다. 다음 중 하나가 될 수 있습니다:

이 상태를 사용하여 업데이트를 제공하거나 어떤 식으로든 상태 변경에 응답하세요. 예를 들면 다음과 같습니다:

• 상태 변경을 트리거합니다:

  State { name: 'loaded'; when: image.status == Image.Ready }

• onStatusChanged 시그널 핸들러를 구현합니다:

  Image {
      id: image
      onStatusChanged: if (image.status == Image.Ready) console.log('Loaded')
  }

• 상태 값에 바인딩합니다:

  Text { text: image.status == Image.Ready ? 'Loaded' : 'Not loaded' }

progress 를참조하세요 .