Version: latest
Image
- Lumin
- iOS
- Android
Description
The Image component displays a 2D image from an image file.
Example
import React from 'react';
import { View, Image, Text, Scene, Prism } from 'magic-script-components';
export default class MyApp extends React.Component {
constructor(props) {
super(props);
this.state = { index: 0 };
}
onNextClick = eventData => {
this.setState(state => ({ index: state.index < 3 ? state.index + 1 : 1 }));
};
render() {
return (
<Scene>
<Prism size={[1, 1, 0.2]} >
<View name="main-view" alignment={'center-center'} localPosition={[-0.16, 0, 0]}>
<Image localPosition={[-0.13, 0, 0]} height={0.17} width={0.17} filePath={require('../../resources/contact1.jpg')} />
<Text alignment={'center-left'} textSize={0.07} weight={"bold"} textColor={"#85D834"} localPosition={[0, 0.05, 0]}>
Lorem Ipsum
</Text>
<Image alignment={'center-left'} height={0.07} width={0.07} icon={"send"} localPosition={[0, -0.03, 0]} />
<Text alignment={'center-left'} textSize={0.04} textColor={"#e0e0e0"} localPosition={[0.1, -0.03, 0]}>
lorem.lpsum@magicleap.com
</Text>
</View>
</Prism>
</Scene>
);
}
}
Common Events
Common Properties
Create Properties
Image offers 3 constructors accepting different property sets.
Name | Type | Default Value | Required | Description |
---|---|---|---|---|
filePath | string | n/a | N | The path to the file to render for the image. |
width | number | 0 | N | The width of the image. |
height | number | 0 | N | The height of the image. |
absolutePath | boolean | false | N | Flag that pngFile is an absolute path name, instead of a relative path. |
useFrame | boolean | false | N | Specifies whether the image should have a frame. |
Lumin only
Name | Type | Default Value | Required | Description |
---|---|---|---|---|
resourceId | BigInt | n/a | N | The resource ID to render for the image. |
width | number | 0 | N | The width of the image. |
height | number | 0 | N | The height of the image. |
useFrame | boolean | false | N | Specifies whether the image should have a frame. |
Name | Type | Default Value | Required | Description |
---|---|---|---|---|
icon | string | n/a | N | The SystemIcon type for the image. |
height | number | 0 | N | The height of the image. |
IconType
icon options:Element Properties
Name | Type | Default Value | Description | Lumin | Android | IOS |
---|---|---|---|---|---|---|
color | vec4 | n/a | Sets a color to modulate the image. | ๐ | ๐ | ๐ |
textCoords | [vec2] | n/a | Sets the texture coordinates used by the image. The texture coordinates must be a list of four coordinates representing the UV coordinates of the four corners. | ๐ | ||
opaque | boolean | n/a | Sets the opacity state of the image. | ๐ | ๐ | |
ui | boolean | n/a | Sets whether the image is rendered on UI Layer. | ๐ | ||
imageFrameResource | BigInt | n/a | Sets the model resource used for the image frame. Note: Frame models are expected to be one meter high, one meter wide, and centered at the origin. | ๐ | ||
renderResource | BigInt | n/a | Sets the render resource used for the image. | ๐ |