ScreenSpaceImageLocal
Inherits ScreenSpaceRenderable
This ScreenSpaceRenderable
can be used to display an image from a local file on disk.
To load an image from a web URL, see ScreenSpaceImageOnline.
Members
Name |
Documentation |
Type |
Description |
Optional |
---|---|---|---|---|
|
Sets the path of the texture that is displayed on this screen space plane. If this value is changed, the image at the new path will automatically be loaded and displayed. The size of the image will also automatically set the default size of this plane. |
|
Value of type ‘String’ |
Yes |
Inherited members from ScreenSpaceRenderable
Name |
Documentation |
Type |
Description |
Optional |
---|---|---|---|---|
|
The type of the |
|
Must name a valid ScreenSpaceRenderable |
No |
|
A fixed color that is combined with the screen space renderable to create the final color. The actual color of the screen space renderable is alpha-blended with the background color to produce the final result. |
|
Value of type ‘Color4’ |
Yes |
|
The color of the border. |
|
Value of type ‘Color3’ |
Yes |
|
The width of the border. |
|
Greater than: 0 |
Yes |
|
Determines the position of this screen space plane in Cartesian three-dimensional coordinates (meters). |
|
Value of type ‘Vector3 |
Yes |
|
Determines whether this sceen space object will be rendered or not. |
|
Value of type ‘Boolean’ |
Yes |
|
If enabled, the object will be rotated to face the camera position. Any local rotation is then applied after this rotation. |
|
Value of type ‘Boolean’ |
Yes |
|
Sets the gamma correction of the texture that is applied in addition to the global gamma value. |
|
Value of type ‘Double’ |
Yes |
|
The unique identifier for this screen space renderable. It has to be unique amongst all existing screen space nodes that have been added to the scene. |
|
An identifier string. May not contain ‘.’, spaces, newlines, or tabs |
Yes |
|
If set, the plane’s texture is multiplied with this color. Useful for applying a color grayscale images. |
|
Value of type ‘Color3’ |
Yes |
|
The name of the |
|
Value of type ‘String’ |
Yes |
|
The opacity of the screen space object. If 1, the object is completely opaque. If 0, the object is completely transparent. |
|
In range: ( 0,1 ) |
Yes |
|
Determines the position of this screen space plane in a coordinate system based on radius (meters), azimuth (radians), and elevation (radians). |
|
Value of type ‘Vector3 |
Yes |
|
If true, this screen space renderable is going to ignore the global blackout factor from the Render Engine and will always render at full opacity. If false, it will adhere to the factor and fade out like the rest of the 3D rendering. |
|
Value of type ‘Boolean’ |
Yes |
|
A scale factor for the plane that can be used to increase or decrease the visual size. The default size is determined separately for each screen space renderable type and may for example be affected by the size of an image being displayed. |
|
Value of type ‘Double’ |
Yes |
|
Defines either a single or multiple tags that apply to this |
|
Value of type ‘String’, or Value of type ‘Table’ |
Yes |
|
Determines whetether the z/radius values affects the size of the plane or not. |
|
Value of type ‘Boolean’ |
Yes |
|
Determines whether the location of this screen space plane will be specified using radius, azimuth and elevation (if ‘true’) or using Cartesian coordinates. The Cartesian coordinate system is useful if a regular rendering is applied, whereas the radius azimuth elevation are most useful in a planetarium environment. |
|
Value of type ‘Boolean’ |
Yes |
Asset Examples
1local icons = asset.resource({
2 Name = "Icons",
3 Type = "HttpSynchronization",
4 Identifier = "icons",
5 Version = 1
6})
7
8
9local marker = {
10 Identifier = "target-marker",
11 Name = "Target Marker",
12 Type = "ScreenSpaceImageLocal",
13 TexturePath = icons .. "target.png"
14}
15
16
17asset.onInitialize(function()
18 openspace.addScreenSpaceRenderable(marker)
19end)
20
21asset.onDeinitialize(function()
22 openspace.removeScreenSpaceRenderable(marker)
23end)