public class EffectFactory
extends Object
| java.lang.Object | |
| ↳ | android.media.effect.EffectFactory |
EffectFactory类定义可用效果的列表，并提供检查和实例化它们的功能。 某些效果可能无法在所有平台上使用，因此在创建特定效果之前，应用程序应通过调用isEffectSupported(String)来确认该平台支持该效果。
Public methods |
|
|---|---|
Effect |
createEffect(String effectName) 使用给定的效果名称实例化新效果。 |
static boolean |
isEffectSupported(String effectName) 检查此平台是否支持效果。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
String EFFECT_AUTOFIX
尝试基于直方图均衡自动修复图像。
可用参数：
| Parameter name | Meaning | Valid values |
scale |
The scale of the adjustment. | Float, between 0 and 1. Zero means no adjustment, while 1 indicates the maximum amount of adjustment. |
常量值：“android.media.effect.effects.AutoFixEffect”
String EFFECT_BACKDROPPER
使用选定视频中的帧替换输入帧的背景。 在效果变为活动之前，需要一个只有背景可见的初始学习期。 在学习背景和开始效果之前，效果将等到在场景中看不到任何动作。
可用参数：
| Parameter name | Meaning | Valid values |
source |
A URI for the background video to use. This parameter must be supplied before calling apply() for the first time. | String, such as from Uri.toString() |
如果更新侦听器使用 setUpdateListener(EffectUpdateListener)为此效果设置，则当效果完成学习背景时将调用此更新侦听器，info参数的值为null。
常量值：“android.media.effect.effects.BackDropperEffect”
String EFFECT_BITMAPOVERLAY
将位图（包含预乘alpha通道）叠加到输入图像上。 位图被拉伸以适应输入图像。
可用参数：
| Parameter name | Meaning | Valid values |
bitmap |
The overlay bitmap. | A non-null Bitmap instance. |
常量值：“android.media.effect.effects.BitmapOverlayEffect”
String EFFECT_BLACKWHITE
调整最小和最大彩色像素强度的范围。
可用参数：
| Parameter name | Meaning | Valid values |
black |
The value of the minimal pixel. | Float, between 0 and 1. |
white |
The value of the maximal pixel. | Float, between 0 and 1. |
常量值：“android.media.effect.effects.BlackWhiteEffect”
String EFFECT_BRIGHTNESS
调整图像的亮度。
可用参数：
| Parameter name | Meaning | Valid values |
brightness |
The brightness multiplier. | Positive float. 1.0 means no change; larger values will increase brightness. |
常量值：“android.media.effect.effects.BrightnessEffect”
String EFFECT_CONTRAST
调整图像的对比度。
可用参数：
| Parameter name | Meaning | Valid values |
contrast |
The contrast multiplier. | Float. 1.0 means no change; larger values will increase contrast. |
常量值：“android.media.effect.effects.ContrastEffect”
String EFFECT_CROP
从图像中裁剪出一个直立的矩形区域。 如果作物区域落在图像边界之外，结果是不确定的。
可用参数：
| Parameter name | Meaning | Valid values |
xorigin |
The origin's x-value. | Integer, between 0 and width of the image. |
yorigin |
The origin's y-value. | Integer, between 0 and height of the image. |
width |
The width of the cropped image. | Integer, between 1 and the width of the image minus xorigin. |
height |
The height of the cropped image. | Integer, between 1 and the height of the image minus yorigin. |
常量值：“android.media.effect.effects.CropEffect”
String EFFECT_CROSSPROCESS
在图像上应用交叉处理效果，其中在限制蓝色通道的同时增强红色和绿色通道。
可用参数：无
常量值：“android.media.effect.effects.CrossProcessEffect”
String EFFECT_DOCUMENTARY
在图像上应用黑白纪实风格效果..
可用参数：无
常量值：“android.media.effect.effects.DocumentaryEffect”
String EFFECT_DUOTONE
仅使用两种色调表示照片。
可用参数：
| Parameter name | Meaning | Valid values |
first_color |
The first color tone. | Integer, representing an ARGB color with 8 bits per channel. May be created using Color class. |
second_color |
The second color tone. | Integer, representing an ARGB color with 8 bits per channel. May be created using Color class. |
常量值：“android.media.effect.effects.DuotoneEffect”
String EFFECT_FILLLIGHT
将背光填充应用于图像。
可用参数：
| Parameter name | Meaning | Valid values |
strength |
The strength of the backlight. | Float, between 0 and 1. Zero means no change. |
常量值：“android.media.effect.effects.FillLightEffect”
String EFFECT_FISHEYE
将鱼眼镜头畸变应用于图像。
可用参数：
| Parameter name | Meaning | Valid values |
scale |
The scale of the distortion. | Float, between 0 and 1. Zero means no distortion. |
常量值：“android.media.effect.effects.FisheyeEffect”
String EFFECT_FLIP
垂直和/或水平翻转图像。
可用参数：
| Parameter name | Meaning | Valid values |
vertical |
Whether to flip image vertically. | Boolean |
horizontal |
Whether to flip image horizontally. | Boolean |
常量值：“android.media.effect.effects.FlipEffect”
String EFFECT_GRAIN
将胶片颗粒效果应用于图像。
可用参数：
| Parameter name | Meaning | Valid values |
strength |
The strength of the grain effect. | Float, between 0 and 1. Zero means no change. |
常量值：“android.media.effect.effects.GrainEffect”
String EFFECT_GRAYSCALE
将图像转换为灰度。
可用参数：无
常量值：“android.media.effect.effects.GrayscaleEffect”
String EFFECT_LOMOISH
将lomo-camera风格的效果应用于图像。
可用参数：无
常量值：“android.media.effect.effects.LomoishEffect”
String EFFECT_NEGATIVE
反转图像颜色。
可用参数：无
常量值：“android.media.effect.effects.NegativeEffect”
String EFFECT_POSTERIZE
将贴图效果应用于图像。
可用参数：无
常量值：“android.media.effect.effects.PosterizeEffect”
String EFFECT_REDEYE
去除指定区域的红眼。
可用参数：
| Parameter name | Meaning | Valid values |
centers |
Multiple center points (x, y) of the red eye regions. | An array of floats, where (f[2*i], f[2*i+1]) specifies the center of the i'th eye. Coordinate values are expected to be normalized between 0 and 1. |
常量值：“android.media.effect.effects.RedEyeEffect”
String EFFECT_ROTATE
旋转图像。 输出帧大小必须能够适合输入图像的旋转版本。 请注意，旋转捕捉到90度的最接近倍数。
可用参数：
| Parameter name | Meaning | Valid values |
angle |
The angle of rotation in degrees. | Integer value. This will be rounded to the nearest multiple of 90. |
常量值：“android.media.effect.effects.RotateEffect”
String EFFECT_SATURATE
调整图像的色彩饱和度。
可用参数：
| Parameter name | Meaning | Valid values |
scale |
The scale of color saturation. | Float, between -1 and 1. 0 means no change, while -1 indicates full desaturation, i.e. grayscale. |
常量值：“android.media.effect.effects.SaturateEffect”
String EFFECT_SEPIA
将图像转换为棕褐色色调。
可用参数：无
常量值：“android.media.effect.effects.SepiaEffect”
String EFFECT_SHARPEN
锐化形象。
可用参数：
| Parameter name | Meaning | Valid values |
scale |
The degree of sharpening. | Float, between 0 and 1. 0 means no change. |
常量值：“android.media.effect.effects.SharpenEffect”
String EFFECT_STRAIGHTEN
根据指定的角度旋转图像，并裁剪图像，以便不可见非图像部分。
可用参数：
| Parameter name | Meaning | Valid values |
angle |
The angle of rotation. | Float, between -45 and +45. |
常量值：“android.media.effect.effects.StraightenEffect”
String EFFECT_TEMPERATURE
调整图像的色温。
可用参数：
| Parameter name | Meaning | Valid values |
scale |
The value of color temperature. | Float, between 0 and 1, with 0 indicating cool, and 1 indicating warm. A value of of 0.5 indicates no change. |
常量值：“android.media.effect.effects.ColorTemperatureEffect”
String EFFECT_TINT
用指定的颜色淡化照片。
可用参数：
| Parameter name | Meaning | Valid values |
tint |
The color of the tint. | Integer, representing an ARGB color with 8 bits per channel. May be created using Color class. |
常量值：“android.media.effect.effects.TintEffect”
String EFFECT_VIGNETTE
为图像添加晕影效果，即淡化外部图像边缘。
可用参数：
| Parameter name | Meaning | Valid values |
scale |
The scale of vignetting. | Float, between 0 and 1. 0 means no change. |
常量值：“android.media.effect.effects.VignetteEffect”
Effect createEffect (String effectName)
使用给定的效果名称实例化新效果。
效果的参数将被设置为其默认值。
请注意，创建效果时，无法将与当前EffectContext关联的EGL上下文设为当前上下文。 这允许主机应用程序在任何EGL上下文变为当前之前实例化效果。
| Parameters | |
|---|---|
effectName |
String: The name of the effect to create. |
| Returns | |
|---|---|
Effect |
A new Effect instance. |
| Throws | |
|---|---|
IllegalArgumentException |
if the effect with the specified name is not supported or not known. |
boolean isEffectSupported (String effectName)
检查此平台是否支持效果。
某些效果可能只能在某些平台上使用。 在实例化效果之前使用此方法以确保它受支持。
| Parameters | |
|---|---|
effectName |
String: The name of the effect. |
| Returns | |
|---|---|
boolean |
true, if the effect is supported on this platform. |
| Throws | |
|---|---|
IllegalArgumentException |
if the effect name is not known. |
Android开发手册