그래픽

  
여러 Android 플랫폼 출시에서 그래픽 기능을 활용합니다.

이 표에는 androidx.graphics 그룹의 모든 아티팩트가 나열됩니다.

아티팩트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
그래픽 코어 - - 1.0.0-beta01 -
그래픽 경로 - - 1.0.0-beta02 -
그래픽 모양 - - - 1.0.0-alpha05
이 라이브러리는 2024년 2월 7일에 최종 업데이트되었습니다.

종속 항목 선언

Graphics의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용을 알아보려면 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    implementation "androidx.graphics:graphics-core:1.0.0-beta01"
    implementation "androidx.graphics:graphics-path:1.0.0-beta02"
    implementation "androidx.graphics:graphics-shapes:1.0.0-alpha05"
}

Kotlin

dependencies {
    implementation("androidx.graphics:graphics-core:1.0.0-beta01")
    implementation("androidx.graphics:graphics-path:1.0.0-beta02")
    implementation("androidx.graphics:graphics-shapes:1.0.0-alpha05")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

이 아티팩트의 출시 노트는 없습니다.

Graphics Shapes 버전 1.0

버전 1.0.0-alpha05

2024년 2월 7일

androidx.graphics:graphics-shapes:1.0.0-alpha05, androidx.graphics:graphics-shapes-android:1.0.0-alpha05, androidx.graphics:graphics-shapes-desktop:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

새로운 기능

  • 이제 라이브러리에서 둥근/별표표시된 도형을 쉽게 만들 수 있는 새로운 pill()pillStar() 함수를 제공합니다. 셰이프에 필요한 정확한 경계 (이전 경계는 기본 베지어 곡선 앵커 포인트와 제어점을 기반으로 한 추정치임)와 가능한 최대 경계를 계산하는 새로운 API도 있습니다. 이는 컨테이너 내에서 회전되는 경우 이를 보유하는 컨테이너의 크기를 결정하는 데 도움이 될 수 있습니다. 추가했습니다. (I71827)

API 변경사항

  • 이제 정확한 경계와 최대 경계를 검색하는 옵션이 추가되었습니다. 추가했습니다. (I6d49f, b/317286450)

버그 수정

  • 길이가 0인 곡선과 관련된 낮은 수준의 렌더링 문제로 인해 이러한 도형을 스트로크 경로로 그릴 때 렌더링 아티팩트가 가끔 발생했습니다. 이 버그는 길이가 0인 곡선 (셰이프에 필요하지 않으므로 셰이프에 의해 생성되는 경로의 오버헤드도 절약함)을 모두 제거하여 수정되었습니다.

버전 1.0.0-alpha04

2023년 12월 13일

androidx.graphics:graphics-shapes:1.0.0-alpha04, androidx.graphics:graphics-shapes-android:1.0.0-alpha04, androidx.graphics:graphics-shapes-desktop:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

  • 이 릴리스에는 몇 가지 API 변경사항과 버그 수정이 포함되어 있습니다.
  • 많은 API 변경으로 Shapes 라이브러리가 KMP에 적합합니다. 이렇게 하면 Android가 아닌 코드 (예: Android에 구속되지 않는 Compose 코드)에서 더 쉽게 호출할 수 있습니다. 예를 들어 API에는 이전 PointF, Matrix, Path 유형과 같은 Android 유형이 없습니다.
  • 또한 성능상의 이유로, 특히 객체 할당 (및 수집)을 최소화하기 위해 API와 구현에 여러 변경사항이 있었습니다. 예를 들어 PointF에서 별도의 Float 매개변수로 이동하면 꼭짓점을 보유할 많은 임시 PointF 구조가 할당되지 않습니다.

API 변경사항

  • Morph.asMutableCubicsMutableCubics를 반복하는 함수로 대체했습니다. PointTransformer 함수 인터페이스가 변경되었습니다. 이제 Point의 x 및 y 좌표를 사용하고 TransformedResult (변환된 x 및 y 좌표로 구성됨)를 반환합니다. (I6719e)
  • 공개 Cubic 생성자를 삭제하고 팩토리 함수로 만들었습니다. 추가했습니다. (I409ce)
  • Android 전용 변환 및 그리기 API를 추가했습니다. (I079f6, b/292289543)
  • Android 종속 항목을 제거합니다. (Iadc1c, b/292289543)
  • 이제 앵커 및 컨트롤 속성 이름이 더 합리적입니다. (If13bd, b/294562941)
  • PointF 매개변수를 Float 쌍으로 변경했습니다. (Id4705, b/276466399, b/290254314)
  • 이제 progressMorph 그리기 명령어에 직접 전달됩니다. (Icdca2)

버그 수정

  • 큰 도형을 만들 때 발생하는 버그를 수정했습니다. 추가했습니다. (I4fd66, b/313497325)

버전 1.0.0-alpha03

2023년 6월 7일

androidx.graphics:graphics-shapes:1.0.0-alpha03가 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

  • 새로운 RoundedPolygon.rectangle() 함수를 추가했습니다. (I78e7e, b/280322189)
  • 이제 별표 및 원 함수가 비대칭되고 RoundedPolygon의 컴패니언 객체를 통해 호출됩니다. 예: RoundedPolygon.star(...)(I14735)

버그 수정

  • 평활화 관련 버그를 수정했습니다. (Ibf894)
  • 시작 모양과 끝 모양이 같을 때 발생하는 버그를 수정했습니다. 먼저 반올림에 사용 가능한 공간을 사용한 다음 남은 공간이 있으면 부드럽게 하기 위해 컷을 위해 측면에 사용 가능한 공간을 더 잘 배포합니다. 추가했습니다. (Ibd320, b/277936300)

버전 1.0.0-alpha02

2023년 4월 19일

androidx.graphics:graphics-shapes:1.0.0-alpha02가 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

  • Polygon 슈퍼클래스는 서브클래스인 RoundedPolygon과 병합되었습니다. 이제 모든 다각형은 [선택적으로] 둥근 다각형으로 표시됩니다.
  • 이전과 마찬가지로 여전히 RoundedPolygon를 반환하는 Star 함수는 이제 이전의 innerRadiusRatio 매개변수 대신 innerRadius 값을 사용합니다. 이 반경은 기존 반경 매개변수와 같은 단위로 설정되므로 더 간단하고 일관성이 있습니다. 또한 동일한 숫자가 내부 및 외부 반경에 모두 적용됨을 명확히 하기 위해 numOuterVertices 매개변수의 이름을 numVerticesPerRadius로 변경했습니다.
  • CornerRounding.radius는 이전에 다각형의 크기를 기준으로 하는 것으로 문서화되었지만 상대 값이 아닌 절대값이어야 합니다. 문서가 업데이트되었으며 최댓값 1.0으로 제한하는 주석이 수정되었습니다.

버전 1.0.0-alpha01

2023년 4월 5일

Graphics-Shapes는 둥근 다각형 도형을 쉽게 만들고 렌더링할 수 있으며 다양한 도형 간에 간단한 자동 모핑 (애니메이션)을 만들 수 있는 새로운 라이브러리입니다.

androidx.graphics:graphics-shapes:1.0.0-alpha01가 출시되었습니다. 이 버전은 내부 브랜치에서 출시되었습니다.

새로운 기능

  • 다각형 API를 사용하여 원하는 꼭짓점 수가 포함된 정형 및 별표 다각형을 만듭니다.
  • 선택사항인 CornerRounding 매개변수를 사용하여 모서리의 반올림 반경과 평활화 매개변수를 지정합니다. 이렇게 하면 모서리가 둥근 다각형 모양이 됩니다.
  • 새로운 Morph(Polygon, Polygon) API를 사용하면 진행률을 0에서 1로 설정하여 시작 도형과 종료 도형 사이에 애니메이션을 적용할 수 있는 '모프' 도형을 자동으로 계산합니다. 시간이 지남에 따라 진행 상황을 애니메이션화하고 모든 프레임에 결과를 그려서 새로운 둥근 도형 사이에 부드러운 애니메이션을 만듭니다.

Graphics Path 버전 1.0

버전 1.0.0-rc01

2024년 2월 21일

androidx.graphics:graphics-path:1.0.0-rc01가 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

  • API 34 미만에서 PathIterator의 성능을 개선했습니다. (Id4629)

버전 1.0.0-beta02

2024년 1월 10일

이번 출시에서 변경된 사항은 라이브러리의 크기를 줄이는 것이었습니다. 이는 네이티브 코드에 의한 가정으로 인해 필요 이상으로 큰 크기였습니다.

androidx.graphics:graphics-path:1.0.0-beta02가 출시되었습니다. 버전 1.0.0-beta02에 포함된 커밋을 확인하세요.

버그 수정

  • libandroidx.graphics.path.so의 크기를 96% 줄였습니다. 추가했습니다. (I71397)
  • libandroidx.graphics.path.so의 크기를 5% 줄입니다. 추가했습니다. (I2da7c)
  • androidx.graphics:graphics-path의 네이티브 구성요소를 43% 축소했습니다. 추가했습니다. (I8e40d)

버전 1.0.0-beta01

2023년 11월 29일

androidx.graphics:graphics-path:1.0.0-beta01가 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

버그 수정

  • 라이브러리가 원뿔을 처리하는 방식을 포함하여 다양한 수정 및 성능 개선사항이 적용되었습니다.

버전 1.0.0-alpha02

2023년 6월 7일

androidx.graphics:graphics-path:1.0.0-alpha02가 출시되었습니다. 이 버전은 내부 브랜치에서 개발되었습니다.

새로운 기능

  • Android 14 미리보기에서 실행할 때 문제를 일으키는 내부 플랫폼 버전 확인 문제가 수정되었습니다. 버전 확인은 실패하지만 이전 출시에서 작업을 실행하는 메커니즘이 특히 Android 14에서 올바르게 작동하지 않습니다.

버전 1.0.0-alpha01

2023년 3월 22일

androidx.graphics:graphics-path:1.0.0-alpha01가 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 이 새 라이브러리를 사용하면 새 PathIterator API를 통해 경로 데이터를 쿼리할 수 있습니다. 호출자는 이 API를 사용하여 Path 객체의 모든 세그먼트를 반복하여 해당 세그먼트의 작업과 데이터를 확인할 수 있습니다.
  • 라이브러리는 Android 14 미리보기에서 도입된 유사한 API를 사용하지만 이 AndroidX 버전의 API는 API 21 이전 버전에서도 작동합니다.

Graphics Core 버전 1.0

버전 1.0.0-beta01

2023년 12월 13일

androidx.graphics:graphics-core:1.0.0-beta01가 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

  • 뷰 계층 구조 내에서 Android의 2D 그래픽 API (캔버스 + 페인트)로 짧은 지연 시간 렌더링을 지원하는 새로운 LowLatencyCanvasView API를 도입했습니다.
  • HardwareBuffer에 하드웨어 가속 캔버스 렌더링을 지원하는 CanvasBufferedRenderer API를 도입했습니다. Bitmap.wrapHardwareBuffer API를 사용하여 비트맵으로 변환할 수 있는 버퍼에 사용자 인터페이스의 일부를 그리는 데 사용할 수 있습니다.

API 변경사항

  • 선택적 펜스 매개변수를 포함하도록 CanvasBufferRenderer#releaseBuffer API를 업데이트했습니다. RenderResult#fence가 반환되는 경우를 설명하도록 문서를 업데이트했습니다. 추가합니다. (If1ea7)
  • 코루틴을 활용하여 그리기 요청을 예약할 수 있도록 draw 메서드를 RenderRequest에 추가합니다. 실행자를 사용한 이전 그리기 메서드의 이름을 drawAsync로 변경했습니다. isClosed() 메서드를 속성으로 리팩터링했습니다. 추가했습니다. (I5bff6)
  • CanvasBufferedRenderer.Builder#setBufferFormat에 직접 매핑되도록 버퍼 형식 매개변수를 CanvasFrontBufferRenderer에 노출했습니다. (I0f272)
  • 하드웨어 가속 캔버스 렌더링을 HardwareBuffer로 처리하는 CanvasBufferedRenderer API를 만들었습니다. 이를 통해 HardwareBuffers의 swapchain 깊이 구성과 함께 Android Q에 백포팅된 구현을 제공합니다. ColorSpace 구성은 여전히 Android U+로 제한되지만 compat 구현은 개발자를 대신하여 노옵스(no-ops) 동작을 제공합니다. 추가했습니다. (I9b1d8)
  • 원활한 전환 또는 기본 전환을 위한 변경 전략과 함께 프레임 속도를 제어하기 위해 setFrameRate/clearFrameRate API를 SurfaceControlCompat.Transaction에 추가합니다. 추가했습니다. (I6045c)
  • setDataSpace의 필수 API 수준을 Android T에서 Android Q로 낮췄습니다. 추가했습니다. (I59c34)
  • 버퍼가 더 이상 표시되지 않을 때 소비자에게 상태를 정리할 수 있는 기회를 제공하기 위해 GLFrameBufferRenderer API에 onBufferReleased 콜백을 추가했습니다. (I8a4e2)
  • LowLatencyCanvasView를 만들어 뷰 계층 구조 렌더링과 동기화되는 짧은 지연 시간으로 콘텐츠를 렌더링하는 간단한 사용 사례를 지원합니다. 이렇게 하면 동기화된 렌더링과 짧은 지연 시간 렌더링을 위해 화면 안팎으로 변환되는 SurfaceView 인스턴스를 내부적으로 관리하여 SurfaceView 관리와 관련된 복잡성이 완화됩니다. 추가했습니다. (I9253b)
  • CanvasFrontBufferedRenderer API에 색상 공간 구성 지원이 추가되었습니다. 백 버퍼링된 SurfaceControl도 포함하도록 다중 버퍼링된 콜백을 업데이트했습니다. (I24bd9)

버전 1.0.0-alpha05

2023년 9월 6일

androidx.graphics:graphics-core:1.0.0-alpha05가 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

새로운 기능

  • GLFrameBufferRenderer API를 도입했습니다. 이는 OpenGL 종속 항목, 스왑 체인 구성, 픽셀 형식 및 SurfaceControl 구성의 조합을 제공합니다. 추가했습니다. (Ic775b)

API 변경사항

  • SurfaceHolder#Callbacks의 파이프 크기에 다양한 콜백 API에 너비 + 높이 매개변수를 추가했습니다. 추가했습니다. (I7f9fc)
  • 전면 및 다중 버퍼링된 레이어를 모두 지우는 명확한 API를 추가했습니다. 추가했습니다. (Ic1f95)
  • GLFrontBufferedRenderer 내에서 사용되는 swapchain의 기본 버퍼 유형을 구성하기 위한 지원이 추가되었습니다. 추가했습니다. (I07a13)
  • GLFrameBufferRenderer의 getter에 관한 kotlin 속성, 최대 버퍼 항목의 경우 IntRange 주석, setFormat/setUsageHardwareBufferFormartHardwareBufferUsage 주석을 각각 추가했습니다. 추가했습니다. (Ief89e)
  • 출시 펜스를 제공하도록 SurfaceControl 트랜잭션에서 setBuffer API를 업데이트했습니다. 추가합니다. (Ice1bb)
  • 데이터 공간을 구성하고 확장된 밝기 범위를 설정하는 SurfaceControlCompat.Transaction API를 추가했습니다. 추가했습니다. (Ic378d)

버전 1.0.0-alpha04

2023년 6월 7일

androidx.graphics:graphics-core:1.0.0-alpha04가 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

  • 기존 OpenGL 구현과 함께 android.graphics.Canvas API를 활용하여 지연 시간이 짧은 그래픽을 지원하기 위해 CanvasFrontBufferedRenderer를 도입했습니다.

API 변경사항

  • null을 허용하는 HardwareBuffer 인스턴스가 상응하는 플랫폼 API를 미러링할 수 있도록 SurfaceControlCompat.Transaction#setBuffer API를 업데이트했습니다. (I173d7)
  • 지원 swapchain에 3개 이상의 버퍼가 포함될 수 있으므로 이중 버퍼링 렌더링을 참조하는 메서드의 이름을 Multi Buffered로 대신 변경합니다. 추가했습니다. (I830d7)
  • 3ps가 캔버스 API를 통해 전면 버퍼링 렌더링 시스템을 활용할 수 있도록 CanvasFrontBufferedRenderer API를 만듭니다. 추가했습니다. (Ibfc29)

버그 수정

  • 상응하는 활동을 재개한 후 GLFrontBufferedRenderer가 콘텐츠를 렌더링하지 않는 문제가 수정되었습니다.
  • 버퍼링된 전면 콘텐츠가 조기에 삭제되는 문제가 해결되었습니다.
  • 지연 시간이 짧은 그래픽 API가 출시된 후 SurfaceHolder.Callbacks가 삭제되지 않는 문제가 수정되었습니다.

버전 1.0.0-alpha03

2023년 3월 22일

androidx.graphics:graphics-core:1.0.0-alpha03가 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

  • 중간 스크래치 버퍼로 렌더링한 후 원래 대상을 다시 타겟팅하는 데 사용할 수 있는 프레임 버퍼 식별자와 함께 버퍼 너비/높이가 포함된 BufferInfo 객체를 제공하도록 GLFrontBufferedRenderer 콜백 구현이 업데이트되었습니다. 추가했습니다. (I7fe20)
  • SyncFence 생성이 SyncFenceCompat의 정적 팩토리 메서드로 통합되었습니다.
  • eglDupNativeFenceFDANDROID의 공개 호환성 메서드를 삭제하고 SyncFence 생성을 위한 SyncFenceCompat 팩토리 메서드로 대체했습니다. 이는 API 수준과 관계없이 모든 API 노출 영역이 올바른 SyncFence 구현을 수신하도록 하기 위함입니다. 추가했습니다. (I849bb)
  • FrameBufferRendererSyncStrategy 문서가 추가되었습니다.
    • FrameBufferRenderer + FrameBuffer + FrameBufferPoolandroidx.graphics.opengl 패키지로 이동함
    • SyncStrategyandroidx.graphics.opengl 패키지로 이동함
    • 문서 RenderCallback#onDraw개 업데이트됨
    • API 구현자가 FrameBuffer.close 호출을 담당하는 RenderCallback#obtainFrameBuffer 문서를 업데이트했습니다.
    • 소비자가 디스플레이에 콘텐츠를 전달해야 함을 나타내도록 onDrawComplete를 업데이트했습니다.
    • 프레임워크를 미러링하기 위해 SyncFence 호환성 인터페이스/클래스를 androidx.hardware 패키지로 이동했습니다.
    • 가능한 경우 프레임워크의 SyncFence API를 활용하는 SyncFenceCompat 사용을 통합하기 위해 SyncFence API의 이름을 SyncFenceV19로 바꾸고 비공개로 설정했습니다. 추가했습니다. (I5149c)
  • GLFrontBufferedRenderer#cancelGLFrontBufferedRenderer#execute 메서드를 추가했습니다. 전자는 전면 버퍼에 대한 렌더링을 취소하고 전면 버퍼를 숨겨야 하는 손바닥 움직임 무시 시나리오에서 유용합니다. 후자는 렌더를 예약할 필요 없이 GL 스레드의 객체를 조작하는 시나리오에서 유용합니다. 추가합니다. (If0b7f)
  • 이중 버퍼링된 레이어에 직접 렌더링하는 API를 추가했습니다. 이를 통해 재개 후 장면을 다시 렌더링할 수 있으며 소비자가 렌더링할 원하는 장면에 따라 전면 버퍼링 렌더링을 동적으로 활용할 시기를 선택적으로 결정할 수 있습니다. 추가했습니다. (Ied56c)
  • SurfaceView의 기존 메커니즘 외에 다른 SurfaceControl 인스턴스의 상위 SurfaceControl 구성을 지원하도록 SurfaceControlCompat.Builder에 새 API를 추가했습니다. 추가했습니다. (I1d1b6)
  • 지원 중단된 숨겨진 함수의 반환 유형 null 허용 여부를 더 추가했습니다. (Ibf7b0)
  • Android 기기에서 EGLImage 인스턴스로 사용할 수 있는 EGLClientBuffer 객체로 HardwareBuffer 인스턴스를 가져오는 것을 지원하는지 쿼리하는 EGL_ANDROID_get_native_client_buffer 확장 상수를 추가했습니다. 추가했습니다. (Iad767)
  • @JvmDefaultWithCompatibility 주석을 추가합니다. (I8f206)

버전 1.0.0-alpha02

2022년 11월 9일

androidx.graphics:graphics-core:1.0.0-alpha02가 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

  • Android S에서 도입되었던 addTransactionCommitListenerRequiresApi 주석이 누락되는 문제를 수정했습니다. (I0a035)
  • 소비자가 현재 버퍼 너비/높이 외에도 꼭짓점 셰이더에 전달할 수 있는 변환 매트릭스를 제공하도록 onDraw<Front/Double> 버퍼 콜백을 업데이트했습니다. 소비자는 이러한 매개변수를 사용하여 OpenGL 렌더링 코드를 적절하게 사전에 회전해야 합니다. (I82f9e)

버그 수정

  • SurfaceControl 트랜잭션을 실행하기 전에 버퍼를 사전 회전하여 그래픽 지연 시간을 개선했습니다.
  • 오류 로그에 오류 300d(EGL_BAD_SURFACE)가 표시되는 문제를 수정했습니다.
  • 이전에 사용된 상응하는 활동이 재개된 후 GLFrontBufferedRenderer가 무효화되는 문제를 수정했습니다.
  • 에뮬레이터 및 ChromeOS 기기 지원을 늘렸습니다.
  • 버퍼링된 전면 레이어가 조기에 숨겨질 수 있는 문제를 수정했습니다.

버전 1.0.0-alpha01

2022년 10월 24일

androidx.graphics:graphics-core:1.0.0-alpha01가 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 그래픽 코어 AndroidX 라이브러리의 최초 출시입니다. 여기에는 스타일러스 입력과 같이 지연 시간이 짧은 사용 사례를 지원하는 API가 포함됩니다. OpenGL 사용에 관한 도우미 API도 추가되었습니다.

API 변경사항

  • 짧은 지연 시간과 고품질 렌더링 출력을 모두 달성하도록 전면 및 다중 버퍼 렌더링을 지원하는 GLFrontBufferedRenderer를 도입합니다.
  • SurfaceView, TextureView 등 다양한 Surface 제공업체를 위한 OpenGL 렌더링을 지원하는 GLRenderer API를 도입합니다.