public static final class Palette.Builder
extends Object
java.lang.Object | |
↳ | android.support.v7.graphics.Palette.Builder |
用于生成 Palette
实例的生成器类。
Public constructors |
|
---|---|
Palette.Builder(Bitmap bitmap) 构造一个新 |
|
Palette.Builder(List<Palette.Swatch> swatches) 构造一个新 |
Public methods |
|
---|---|
Palette.Builder |
addFilter(Palette.Filter filter) 添加一个过滤器,以便能够对结果调色板中允许的颜色进行精细控制。 |
Palette.Builder |
addTarget(Target target) 添加要在调色板中生成的目标配置文件。 |
Palette.Builder |
clearFilters() 清除所有添加的滤镜。 |
Palette.Builder |
clearRegion() 清除之前通过 |
Palette.Builder |
clearTargets() 清除所有添加的目标。 |
AsyncTask<Bitmap, Void, Palette> |
generate(Palette.PaletteAsyncListener listener) 异步生成 |
Palette |
generate() 同步生成并返回 |
Palette.Builder |
maximumColorCount(int colors) 使用 |
Palette.Builder |
resizeBitmapArea(int area) 使用 |
Palette.Builder |
resizeBitmapSize(int maxDimension) 此方法已弃用。 使用 |
Palette.Builder |
setRegion(int left, int top, int right, int bottom) 设置要在计算调色板时专用的位图区域。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
Palette.Builder (Bitmap bitmap)
构造一个新 Palette.Builder
使用源 Bitmap
Parameters | |
---|---|
bitmap |
Bitmap
|
Palette.Builder (List<Palette.Swatch> swatches)
构造一个新Palette.Builder
使用列表Palette.Swatch
实例。 通常只用于测试。
Parameters | |
---|---|
swatches |
List
|
Palette.Builder addFilter (Palette.Filter filter)
添加一个过滤器,以便能够对结果调色板中允许的颜色进行精细控制。
Parameters | |
---|---|
filter |
Palette.Filter : filter to add. |
Returns | |
---|---|
Palette.Builder |
Palette.Builder addTarget (Target target)
添加要在调色板中生成的目标配置文件。
您可以通过 getSwatchForTarget(Target)
检索结果。
Parameters | |
---|---|
target |
Target
|
Returns | |
---|---|
Palette.Builder |
Palette.Builder clearFilters ()
清除所有添加的滤镜。 这包括由Palette
自动添加的所有默认过滤器。
Returns | |
---|---|
Palette.Builder |
Palette.Builder clearRegion ()
清除之前通过 setRegion(int, int, int, int)
设置的区域。
Returns | |
---|---|
Palette.Builder |
Palette.Builder clearTargets ()
清除所有添加的目标。 这包括由Palette
自动添加的任何默认目标。
Returns | |
---|---|
Palette.Builder |
AsyncTask<Bitmap, Void, Palette> generate (Palette.PaletteAsyncListener listener)
异步生成Palette
。 提供的监听器的onGenerated(Palette)
方法将在生成时用调色板调用。
Parameters | |
---|---|
listener |
Palette.PaletteAsyncListener
|
Returns | |
---|---|
AsyncTask<Bitmap, Void, Palette> |
Palette.Builder maximumColorCount (int colors)
使用 Bitmap
作为源时,设置在量化步骤中使用的最大颜色数。
良好的值取决于源图像类型。 对于景观,好的值在10-16范围内。 对于主要由人脸组成的图像,这个值应该增加到〜24。
Parameters | |
---|---|
colors |
int
|
Returns | |
---|---|
Palette.Builder |
Palette.Builder resizeBitmapArea (int area)
使用Bitmap
作为源时,设置调整大小值。 如果位图的区域大于指定的值,则将调整位图的大小以使其区域匹配area
。 如果位图较小或相等,原始数据将按原样使用。
该值对处理时间有很大影响。 调整大小的图像越大,生成调色板所需的时间就越长。 图像越小,结果图像中的细节就越多,因此颜色选择的精度就越低。
Parameters | |
---|---|
area |
int : the number of pixels that the intemediary scaled down Bitmap should cover, or any value <= 0 to disable resizing. |
Returns | |
---|---|
Palette.Builder |
Palette.Builder resizeBitmapSize (int maxDimension)
此方法已弃用。
首选使用resizeBitmapArea(int)
,因为它可以更优雅地处理异常高宽比。
使用Bitmap
作为源时,请设置调整大小值。 如果位图的最大尺寸大于指定的值,则位图将调整大小,以使其最大尺寸匹配maxDimension
。 如果位图较小或相等,原始数据将按原样使用。
Parameters | |
---|---|
maxDimension |
int : the number of pixels that the max dimension should be scaled down to, or any value <= 0 to disable resizing. |
Returns | |
---|---|
Palette.Builder |
Palette.Builder setRegion (int left, int top, int right, int bottom)
设置要在计算调色板时专用的位图区域。
这只适用于原始输入为 Bitmap
。
Parameters | |
---|---|
left |
int : The left side of the rectangle used for the region. |
top |
int : The top of the rectangle used for the region. |
right |
int : The right side of the rectangle used for the region. |
bottom |
int : The bottom of the rectangle used for the region. |
Returns | |
---|---|
Palette.Builder |