@amazon-devices/expo-image-manipulator提供一个API来修改存储在本地文件系统上的图像。
安装
-
在
package.json文件中添加JavaScript库依赖项。"dependencies": { ... "@amazon-devices/expo-image-manipulator": "~2.0.0", "@amazon-devices/keplerscript-turbomodule-api": "~1.0.0", ... } -
使用
npm install命令重新安装依赖项。
示例
以下示例演示了如何对图像执行单一操作。
import * as ImageManipulator from '@amazon-devices/expo-image-manipulator';
import React, {useState, useEffect} from 'react';
import {Button, Image, StyleSheet, View} from 'react-native';
type ImageType = {
uri: string;
localUri?: string;
};
export const App = () => {
const [ready, setReady] = useState(false);
const [image, setImage] = useState<ImageType | null>(null);
useEffect(() => {
(async () => {
const image = require('./assets/vega.png');
const imageUri = Image.resolveAssetSource(image).uri;
setImage({uri: imageUri});
setReady(true);
})();
}, []);
const manipulate = async () => {
if (image) {
const result = await ImageManipulator.manipulateAsync(
image.localUri || image.uri,
[{flip: ImageManipulator.FlipType.Vertical}],
);
setImage(result);
}
};
const renderImage = () => (
<View style={styles.imageContainer}>
{image != null && (
<Image
source={{uri: image.localUri || image.uri}}
style={styles.image}
/>
)}
</View>
);
return (
<View style={styles.container}>
{ready && image && renderImage()}
<Button title="操作" onPress={manipulate} />
</View>
);
};
const styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: 'center',
},
imageContainer: {
marginVertical: 20,
alignItems: 'center',
justifyContent: 'center',
},
image: {
width: 300,
height: 300,
resizeMode: 'contain',
},
});
import * as ImageManipulator from '@amazon-devices/expo-image-manipulator';
import React, {useState, useEffect} from 'react';
import {Button, Image, StyleSheet, View} from 'react-native';
type ImageType = {
uri: string;
localUri?: string;
};
export const App = () => {
const [ready, setReady] = useState(false);
const [image, setImage] = useState<ImageType | null>(null);
useEffect(() => {
(async () => {
const image = require('./assets/vega.png');
const imageUri = Image.resolveAssetSource(image).uri;
setImage({uri: imageUri});
setReady(true);
})();
}, []);
const manipulate = async () => {
if (image) {
const result = await ImageManipulator.manipulateAsync(image.uri, [
{flip: ImageManipulator.FlipType.Vertical},
{rotate: 90},
]);
setImage({uri: result.uri});
}
};
const renderImage = () => (
<View style={styles.imageContainer}>
{!!image && <Image source={{uri: image.uri}} style={styles.image} />}
</View>
);
return (
<View style={styles.container}>
{ready && image && renderImage()}
<Button title="操作" onPress={manipulate} />
</View>
);
};
const styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: 'center',
alignItems: 'center',
},
imageContainer: {
marginVertical: 20,
alignItems: 'center',
justifyContent: 'center',
},
image: {
width: 300,
height: 300,
resizeMode: 'contain',
},
});
import * as ImageManipulator from '@amazon-devices/expo-image-manipulator';
import React, {useState, useEffect} from 'react';
import {Button, Image, StyleSheet, Text, View} from 'react-native';
type ImageType = {
uri: string;
localUri?: string;
};
export const App = () => {
const [ready, setReady] = useState(false);
const [image, setImage] = useState<ImageType | null>(null);
const [base64, setBase64] = useState<string>();
useEffect(() => {
(async () => {
const image = require('./assets/vega.png');
const imageUri = Image.resolveAssetSource(image).uri;
setImage({uri: imageUri});
setReady(true);
})();
}, []);
const manipulate = async () => {
if (image) {
const result = await ImageManipulator.manipulateAsync(
image.localUri || image.uri,
[{rotate: 90}],
{
base64: true,
compress: 0.5,
format: ImageManipulator.SaveFormat.PNG,
},
);
setImage({
uri: result.uri,
localUri: result.uri,
});
setBase64(result.base64);
}
};
const renderImage = () => (
<View style={styles.imageContainer}>
{image && (
<Image
source={{uri: image.localUri || image.uri}}
style={styles.image}
/>
)}
</View>
);
return (
<View style={styles.container}>
{ready && image && renderImage()}
<Button title="操作" onPress={manipulate} />
<Text style={styles.text}>{`Base64: ${
base64 ? base64.slice(0, 30) : 'None'
}`}</Text>
</View>
);
};
const styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: 'center',
alignItems: 'center',
},
imageContainer: {
marginVertical: 20,
alignItems: 'center',
justifyContent: 'center',
},
image: {
width: 300,
height: 300,
resizeMode: 'contain',
},
text: {
fontSize: 32,
color: 'white',
},
});
API参考
请查看文档页面,了解有关此库和API参考的信息:针对expo-image-manipulator的官方Expo文档(仅提供英文版)。方法
| 方法 | 描述 |
|---|---|
manipulateAsync | 使用URI操作提供的图像。可用的修改包括旋转、翻转(镜像)、大小调整和裁剪。每次调用都会产生一个新文件。通过一次调用,可以提供一组对图像执行的操作。由于图像已缓存,覆盖源文件不会影响显示结果。 |
已知问题和限制
saveOptions.compress- 压缩目前不适用于Vega,图像始终以最高质量保存(就如同传递了值1.0)。
支持的版本
| 程序包版本 | 基于 | @amazon-devices/react-native-kepler版本 |
|---|---|---|
| 2.0.x | 11.6.0 | 2.0.x |

