CircleImageView

CircleImageView

프로필 이미지에 적합한 빠른 원형 ImageView입니다. 이는 Romain Guy가 권장하는 기술을 기반으로 하는 Vince Mi의 RoundedImageView를 기반으로 합니다.

BitmapShader를 사용하지만 다음을 수행하지 않습니다 .

• 원본 비트맵의 복사본 만들기
• ClipPath를 사용하십시오(하드웨어 가속도 아니고 앤티앨리어싱도 아님).
• setXfermode를 사용하여 비트맵을 클리핑합니다(캔버스에 두 번 그리는 것을 의미함).

이것은 단지 사용자 정의 ImageView이고 사용자 정의 Drawable 또는 둘의 조합이 아니기 때문에 모든 종류의 드로어블(예: Picasso의 PicassoDrawable 또는 기타 비표준 드로어블)과 함께 사용할 수 있습니다(일부 테스트가 필요함).

그래들

 dependencies {
    ...
    implementation 'de.hdodenhof:circleimageview:3.1.0'
}

용법

< de .hdodenhof.circleimageview.CircleImageView
    xmlns : app = " http://schemas.android.com/apk/res-auto "
    android : id = " @+id/profile_image "
    android : layout_width = " 96dp "
    android : layout_height = " 96dp "
    android : src = " @drawable/profile "
    app : civ_border_width = " 2dp "
    app : civ_border_color = " #FF000000 " />

제한사항

• ScaleType은 항상 CENTER_CROP이며 이를 변경하려고 하면 예외가 발생합니다. 이는 (현재) 프로필 이미지에 완벽하게 적합하도록 설계된 것입니다.
• 지원되지 않는 ScaleType이 필요하므로 adjustViewBounds 활성화는 지원되지 않습니다.
• Picasso 또는 Glide와 같은 이미지 로딩 라이브러리를 사용하는 경우 이미지가 엉망이 되는 것을 방지하려면 페이드 애니메이션을 비활성화해야 합니다. Picasso의 경우 noFade() 옵션을 사용하고 Glide의 경우 dontAnimate() 을 사용합니다. fadeIn 애니메이션을 유지하려면 이미지를 Target 으로 가져와서 Bitmap 받을 때 사용자 정의 애니메이션을 직접 적용해야 합니다.
• CircleImageView 와 함께 TransitionDrawable 을 사용하면 제대로 작동하지 않고 이미지가 엉망이 됩니다.

FAQ

CircleImageView 와 함께 VectorDrawable 을 어떻게 사용할 수 있나요?

짧은 대답: 그렇게 하면 안 됩니다. CircleImageView 와 함께 VectorDrawable 을 사용하는 것은 매우 비효율적입니다. 벡터를 원형 모양으로 수정하고 대신 일반 ImageView와 함께 사용해야 합니다.

CircleImageView AppCompatImageView 확장하지 않는 이유는 무엇입니까?

AppCompatImageView 확장하려면 실질적인 이점 없이 지원 라이브러리에 대한 런타임 종속성을 추가해야 합니다.

원에 바인딩된 선택기(예: 잔물결 효과)를 어떻게 추가할 수 있나요?

현재 원 경계 선택기에 대한 직접적인 지원은 없지만 다음 단계에 따라 직접 구현할 수 있습니다.

이미지와 테두리 사이에 간격을 추가하려면 어떻게 해야 합니까?

간격 추가도 직접 지원되지 않지만 해결 방법이 있습니다.

변경 내역

• 3.1.0
  • 비트맵 페인트 플래그를 BitmapDrawable과 정렬(크기 조정 향상)
• 3.0.2
  • API 레벨 <= 19에서 초기화 중 NPE 수정
  • 순환 변환이 비활성화된 경우 잘못된 윤곽선이 제공되는 문제 수정
• 3.0.1
  • 뷰가 비어 있으면 터치 이벤트가 실행되지 않는 문제 수정
  • 변형이 비활성화된 경우에도 터치 가능한 영역이 원으로 제한되는 문제 수정
• 3.0.0
  • 터치 이벤트 처리를 원 영역으로 제한
  • AndroidX로 마이그레이션
  • 더 이상 사용되지 않는 속성 및 메서드 제거
• 2.2.0
  • 고도 지원 추가
  • 채우기 색상을 대체하려면 원 배경 색상 속성을 추가하세요.
• 2.1.0
  • 패딩 지원 추가
  • 원형 변환을 비활성화하는 옵션 추가
  • 일부 조건에서 이미지와 테두리 사이에 가는선 간격이 그려지는 문제 수정
  • 색조 속성 사용 시 NPE 수정(지원되지 않음)
  • 채우기 색상은 상당한 혼란을 야기하는 것으로 보이므로 더 이상 사용되지 않습니다.
• 2.0.0
  • 속보: 이제 사용자 정의 xml 속성 앞에 "civ_"가 붙습니다.
  • 호환되지 않는 드로어블의 우아한 처리
  • 투명한 영역이 있는 이미지 뒤에 표시되는 채우기 색상 지원 추가
  • 작은 이미지의 치수 계산 문제 해결
  • null로 설정된 경우 비트맵이 지워지지 않는 문제 수정
• 1.3.0
  • setBorderColorResource(int resId) 추가
  • 리소스 유형 주석 추가
  • 기본 이미지 위에 테두리 그리기를 허용하려면 border_overlay 속성을 추가하세요.
• 1.2.2
  • ColorFilter 지원 추가
• 1.2.1
  • Lollipop에서 ColorDrawables가 제대로 렌더링되지 않는 문제 수정
• 1.2.0
  • setImageURI(Uri uri) 지원 추가
  • CircleImageView(컨텍스트 컨텍스트)를 사용할 때 뷰가 초기화되지 않는 문제를 수정했습니다.
• 1.1.1
  • 테두리 너비가 0으로 설정되어 있어도 테두리가 표시되는 문제 수정
• 1.1.0
  • ColorDrawables에 대한 지원 추가
  • 테두리 색상 및 테두리 너비에 대한 getter 및 setter 추가
• 1.0.1
  • OutOfMemoryError로 인한 충돌 방지
• 1.0.0
  • 최초 출시

특허

 Copyright 2014 - 2020 Henning Dodenhof

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.