访问级别
公开接口
废弃原因
getPixelMap 耗时较长,在主线程调用会阻塞其余代码执行,故废弃,用异步接口替代
废弃影响
该变更为非兼容性变更,需要开发者适配。
API Level 9
废弃发生版本
从OpenHarmony SDK 4.1.5.5开始。
废弃的接口
接口声明 | 废弃说明 | 替代接口 |
---|---|---|
getPixelMap():image.PixelMap; | 该接口耗时长,废弃后统一替换成异步接口 | getEffectPixelMap():Promise<image.PixelMap>; |
适配指导 类似以下调用方式
import image from "@ohos.multimedia.image";
import effectKit from "@ohos.effectKit";
const color = new ArrayBuffer(96);
let opts : image.InitializationOptions = {
editable: true,
pixelFormat: 3,
size: {
height: 4,
width: 6
}
};
image.createPixelMap(color, opts).then((pixelMap) => {
let pixel = effectKit.createEffect(pixelMap).grayscale().getPixelMap();
console.log('getPixelBytesNumber = ', pixel.getPixelBytesNumber());
})
将
let pixel = effectKit.createEffect(pixelMap).grayscale().getPixelMap();
替换为
effectKit.createEffect(pixelMap).grayscale().getEffectPixelMap().then(data => {
let pixel = data;
}).catch(ex => console.log("getEffectPixelMap error: " + ex.toString()));
即将 getPixelMap 替换为 getEffectPixelMap ,用 promise 的方式接收回调回来的 pixelMap 对象
访问级别
公开接口
变更原因
之前接口行为不够通用,难以满足三方应用多场景需求实现。当前有三方场景无法满足, 诉求进行变更。
变更影响
该变更为不兼容变更。
1、使用blendMode接口时,开发者调用接口枚举发生变化。枚举NORMAL变为NONE,SOURCE_IN变为SRC_IN, DESTINATION_IN变为DST_IN。
2、接口行为由当前控件背景与子节点内容进行混合改为当前控件内容(含子节点内容)与下方画布(可能为离屏画布)已有内容进行混合。
API Level
11
变更发生版本
从Openharmony SDK 4.1.6.3 开始
变更的接口/组件
blendMode接口枚举和接口行为进行非兼容性变更。
适配指导
1、开发者需将原先调用枚举由NORMAL改为NONE,SOURCE_IN改为SRC_IN,DESTINATION_IN改为DST_IN。
2、由于接口行为发生改变,之前的接口内含两次离屏,第一次离屏用来绘制控件背景,第二次离屏用来绘制子节点内容。当前接口仅可支持一次离屏,需调用BlendApplyType.OFFSCREEN来触发离屏,接口默认无离屏。若想与原有接口行为保持一致,接口需调用两次来保持两次离屏。其中第一次离屏用来绘制控件背景,第二次离屏用来绘制子节点内容。
示例代码:
// xxx.ets 新接口,可通过调用BlendApplyType.OFFSCREEN触发一次离屏
@Entry
@Component
struct Index {
build() {
Column() {
// 第二次离屏用来绘制子节点内容
Text("test")
.fontSize(144)
.fontWeight(FontWeight.Bold)
.fontColor('#ffff0101')
.blendMode(BlendMode.SRC_IN, BlendApplyType.OFFSCREEN)
}
// 第一次离屏用来绘制控件背景
.blendMode(BlendMode.SRC_OVER, BlendApplyType.OFFSCREEN)
.height('100%')
.width('100%')
.backgroundColor('#ff08ff00')
}
}
// xxx.ets 旧接口,内部默认触发两次离屏
@Entry
@Component
struct Index {
build() {
Column() {
// 第二次离屏用来绘制子节点内容
Text("test")
.fontSize(144)
.fontWeight(FontWeight.Bold)
.fontColor('#ffff0101')
}
// 第一次离屏用来绘制控件背景
.blendMode(BlendMode.SRC_IN)
.height('100%')
.width('100%')
.backgroundColor('#ff08ff00')
}
}
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。