RenderablePlaneImageOnline

Inherits Renderable

A RenderablePlaneImageOnline creates a textured 3D plane, where the texture image is loaded from the internet though a web URL.

Members

Name	Documentation	Type	Description	Optional
Size	The size of the plane in meters.	Double, or Vector2<double>	Value of type ‘Double’, or Value of type ‘Vector2’	No
URL	Sets the URL 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.	String	Value of type ‘String’	No
AutoScale	Decides whether the plane should automatically adjust in size to match the aspect ratio of the content. Otherwise it will remain in the given size.	Boolean	Value of type ‘Boolean’	Yes
Billboard	Specifies whether the plane should be a billboard, which means that it is always facing the camera. If it is not, it can be oriented using other transformations.	Boolean	Value of type ‘Boolean’	Yes
BlendMode	Determines the blending mode that is applied to this plane.	String	In list { Normal, Additive }	Yes
MirrorBackside	If false, the image plane will not be mirrored when viewed from the backside. This is usually desirable when the image shows data at a specific location, but not if it is displaying text for example.	Boolean	Value of type ‘Boolean’	Yes
MultiplyColor	An RGB color to multiply with the plane’s texture. Useful for applying a color to grayscale images.	Color3	Value of type ‘Color3’	Yes

Inherited members from Renderable

Name	Documentation	Type	Description	Optional
DimInAtmosphere	Decides if the object should be dimmed (i.e. faded out) when the camera is in the sunny part of an atmosphere.	Boolean	Value of type ‘Boolean’	Yes
Enabled	Determines whether this object will be visible or not.	Boolean	Value of type ‘Boolean’	Yes
Opacity	This value determines the opacity of this renderable. A value of 0 means completely transparent	Double	In range: ( 0,1 )	Yes
RenderBinMode	A value that specifies if the renderable should be rendered in the Background, Opaque, Pre-/PostDeferredTransparency, Overlay, or Sticker rendering step.	String	In list { Background, Opaque, PreDeferredTransparent, PostDeferredTransparent, Overlay }	Yes
Tag	A single tag or a list of tags that this renderable will respond to when setting properties	Table, or String	Value of type ‘Table’, or Value of type ‘String’	Yes
Type	The type of the renderable.	String	Value of type ‘String’	Yes

Asset Examples

Basic

This example shows how to create a textured plane in 3D space, where the texture is loaded from the internet though a web URL.

local Node = {
  Identifier = "RenderablePlaneImageOnline_Example",
  Renderable = {
    Type = "RenderablePlaneImageOnline",
    Size = 3.0E11,
    URL = "http://data.openspaceproject.com/examples/renderableplaneimageonline.jpg"
  },
  GUI = {
    Name = "RenderablePlaneImageOnline - Basic",
    Path = "/Examples"
  }
}

asset.onInitialize(function()
  openspace.addSceneGraphNode(Node)
end)

asset.onDeinitialize(function()
  openspace.removeSceneGraphNode(Node)
end)

Billboarded Image

This example shows how to create a textured plane in 3D space, where the texture is loaded from the internet though a web URL and the plane is billboarded to always face the camera.

local Node = {
  Identifier = "RenderablePlaneImageOnline_Example_Billboarded",
  Renderable = {
    Type = "RenderablePlaneImageOnline",
    Size = 3.0E11,
    URL = "http://data.openspaceproject.com/examples/renderableplaneimageonline.jpg",
    Billboarded = true
  },
  GUI = {
    Name = "RenderablePlaneImageOnline - Billboarded",
    Path = "/Examples"
  }
}

asset.onInitialize(function()
  openspace.addSceneGraphNode(Node)
end)

asset.onDeinitialize(function()
  openspace.removeSceneGraphNode(Node)
end)