Palette
调色板 Palette 是 Android L SDK 中的新特性。可以使用 Palette 从图像中提取出突出的颜色(主色调),获取到颜色之后我们再将这个颜色值赋给 ActionBar、状态栏等。从而达到界面色调的统一,使界面美观协调。
Palette 可以提取图片中如下几种特性的颜色:
- Vibrant (有活力的)
- Vibrant dark(有活力的 暗色调)
- Vibrant light(有活力的 明亮)
- Muted (柔和的)
- Muted dark(柔和的 暗色调)
- Muted light(柔和的 明亮)
内部嵌套类
- Palette.Builder
生成器类,生成 Palette 实例。 - Palette.Filter
过滤器接口,使 Palette 有更加细腻的颜色过滤 - Palette.PaletteAsyncListener
异步加载监听 - pattle.Swatch
提供获取结果的色彩样本
所有的公共方法
返回值类型 | 方法及说明 |
---|---|
static Palette | from(List<Palette.Switch> switches) 通过预设的 Palette.Swatch 颜色样本列表 来生成 Palette |
static Palette.Builder | from(Bitmap bitmap) 通过返回 Palette.Builder 实例来构建 Palette |
static Palette | generate(Bitmap bitmap,int numColors) 该方法已被遗弃,建议用 Palette.Builder 来生成Palette |
static Palette | generate(Bitmap bitmap) 该方法已被遗弃,建议用 Palette.Builder 来生成Palette |
static AsyncTask<Bitmap,Void,Palette> | generateAsync(Bitmap bitmap,int numColor,Palette.PaletteAsyncListener listener) 该方法已被遗弃,建议用 Palette.Builder 来生成Palette |
static AsyncTask<Bitmap,Void,Palette> | generateAsync(Bitmap bitmap,Palette.PaletteAsyncListener listener) 该方法已被遗弃,建议用 Palette.Builder 来生成Palette |
int | getColorForTarget(Target target,int defaultColor) 返回一个从目标获取的的 rgb 色值 |
int | getDarkMutedColor(int defaultColor) 返回一个柔和的暗色调 rgb 值 |
Palette.Swatch | getDarkMutedSwatch() 返回一个柔和的暗色调样本类 |
int | getDarkVibrantColor(int defaultColor) 返回一个鲜明的暗色调 rgb 值 |
Palette.Swatch | getDarkVibrantSwatch() 返回一个鲜明的暗色调样本类 |
int | getDomainColor(int defaultColor) 返回 Palette 中的主色调 rgb值 |
Palette.Swatch | getDomainSwatch() 返回一个主色调的样本类 |
int | getLightMutedColor(int defaultColor) 返回一个柔和的亮色调颜色 rgb |
Palette.Swatch | getLightMutedSwatch() 返回一个柔和的亮色调样本类 |
int | getLightVibrantColor(int defaultColor) 返回一个鲜明的亮色调 rgb |
Palette.Swatch | getLightVibrantSwatch() 返回一个鲜明的亮色调样本类 |
int | getMutedColor(int defaultColor) 返回一个柔和的颜色 rgb |
Palette.Swatch | getMutedSwatch() 返回一个柔和的颜色样本类 |
Palette.Swatch | getSwatchForTarget(Target target) 为给定的目标从 Palette 中返回一个选中样本,如果未找到则返回空 |
List<Palette.Swatch> | getSwatches() 获取所有用在Palette中的Swatch样本类 |
List<Target> | getTargets() 获取所有构造 Palette 的 Target |
int | getVibrantColor(int defaultColor) 获取一个鲜明的颜色 rgb |
Palette.Swatch | getVibrantSwatch() 获取一个鲜明的样本类 |
使用方式
使用 Palette 需先引入 Palette 的 support 资源包:
compile 'com.android.support:palette-v7:25.1.0'
加载不能在主线程中进行,加载方式有同步加载和异步加载两种:
- 同步
//在加载图片的后台线程中同步加载 Palette palette = Palette.from(bitmap).genrate(); . . .
- 异步
//异步加载 Palette.from(bitmap).genrate(new PaletteAsyncListener(){ public void onGenerated(Palette p){ . . . } });
具体使用代码
这里使用 MvpDemo 中的部分代码,跟 Glide 配合起来使用的,其他辅助类代码直接 Demo 中查看。
//这是 Glide 加载状态的监听回调 @Override public boolean onResourceReady(GlideDrawable resource, String model, Target<GlideDrawable> target, boolean isFromMemoryCache, boolean isFirstResource) { //获取到 Glide 加载图片的 Bitmap final Bitmap bitmap = GlideUtils.getBitmap(resource); //获取到24dp的长度 final int twentyFourDip = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 24, ZhihuStoryInfoActivity.this.getResources().getDisplayMetrics()); assert bitmap != null; Palette.from(bitmap) //设置构建 Palette 时使用的最大颜色数,风景景观推荐值在10-16,人脸图像色值增加到24 .maximumColorCount(3) .clearFilters() .setRegion(0, 0, bitmap.getWidth() - 1, twentyFourDip) .generate(new Palette.PaletteAsyncListener() { @Override public void onGenerated(Palette palette) { boolean isDark; int lightness = ColorUtils.isDark(palette); if (lightness == ColorUtils.LIGHTNESS_UNKNOWN) { isDark = ColorUtils.isDark(bitmap, bitmap.getWidth() / 2, 0); } else { isDark = lightness == ColorUtils.IS_DARK; } if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { int statusBarColor = getWindow().getStatusBarColor(); final Palette.Swatch topColor = ColorUtils.getMostPopulousSwatch(palette); if (topColor != null && (isDark || Build.VERSION.SDK_INT >= Build.VERSION_CODES.M)) { statusBarColor = ColorUtils.scrimify(topColor.getRgb(), isDark, SCRIM_ADJUSTMENT); if (!isDark && Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) { ViewUtils.setLightStatusBar(mStoryImg); } } if (statusBarColor != getWindow().getStatusBarColor()) { ValueAnimator statusBarColorAnim = ValueAnimator.ofArgb( getWindow().getStatusBarColor(), statusBarColor); statusBarColorAnim .addUpdateListener(new ValueAnimator .AnimatorUpdateListener() { @Override public void onAnimationUpdate(ValueAnimator animation) { getWindow().setStatusBarColor((int) animation.getAnimatedValue()); } }); //设置转换颜色的动画时间 statusBarColorAnim.setDuration(1000L); statusBarColorAnim.setInterpolator( new AccelerateInterpolator()); statusBarColorAnim.start(); } } } }); }
最后