wiki.sine.space | sinespace

Difference between revisions of "Scripting/STrailRenderer"

From wiki.sine.space
Jump to: navigation, search
(Added and defined all members (21) of STrailRenderer)
 
(Added simple examples to all members (21) in STrailRenderer)
Line 1: Line 1:
 
==Members==
 
==Members==
{{ScriptFunction|void|Clear|();|Removes all points from the TrailRenderer. Useful for restarting a trail from a new position.|5=<pre></pre>}}
+
{{ScriptFunction|void|Clear|();|Removes all points from the TrailRenderer. Useful for restarting a trail from a new position.|5=<pre>Space.Host.ExecutingObject.TrailRenderer.Clear()</pre>}}
  
{{ScriptFunction|SVector|GetPosition|(int index);|Get the position of a vertex in the trail.|5=<pre></pre>}}
+
{{ScriptFunction|SVector|GetPosition|(int index);|Get the position of a vertex in the trail.|5=<pre>vectorPos = Space.Host.ExecutingObject.TrailRenderer.GetPosition(0)</pre>}}
  
  
 
==Properties==
 
==Properties==
{{ScriptFunction|int|Alignment|{ get;set; }|Select whether the trail will face the camera, or the orientation of the Transform Component.|5=<pre></pre>}}
+
{{ScriptFunction|int|Alignment|{ get;set; }|Select whether the trail will face the camera, or the orientation of the Transform Component.
 +
0 = View
 +
1 = Transform Z|5=<pre>Space.Host.ExecutingObject.TrailRenderer.Alignment = 1</pre>}}
  
{{ScriptFunction|bool|Autodestruct|{ get;set; }|Does the GameObject of this Trail Renderer auto destruct?|5=<pre></pre>}}
+
{{ScriptFunction|bool|Autodestruct|{ get;set; }|Does the GameObject of this Trail Renderer auto destruct?|5=<pre>Space.Host.ExecutingObject.TrailRenderer.Autodestruct = true
 +
</pre>}}
  
{{ScriptFunction|bool|CastShadows|{ get;set; }|Does the trail cast a shadow when a shadow-casting Light shines on it?|5=<pre></pre>}}
+
{{ScriptFunction|bool|CastShadows|{ get;set; }|Does the trail cast a shadow when a shadow-casting Light shines on it?|5=<pre>Space.Host.ExecutingObject.TrailRenderer.CastShadows = true
 +
</pre>}}
  
{{ScriptFunction|bool|Enabled|{ get;set }|Whether this TrailRenderer component is Enabled or not|5=<pre></pre>}}
+
{{ScriptFunction|bool|Enabled|{ get;set }|Whether this TrailRenderer component is Enabled or not|5=<pre>Space.Host.ExecutingObject.TrailRenderer.Enabled = true</pre>}}
  
{{ScriptFunction|Scolor|EndColor|{ get;set; }|Set the color at the end of the trail.
+
{{ScriptFunction|Scolor|EndColor|{ get;set; }|Set the color at the end of the trail.|5=<pre>Space.Host.ExecutingObject.TrailRenderer.EndColor = Color.Red</pre>}}
|5=<pre></pre>}}
+
  
 
{{ScriptFunction|float|EndWidth|{ get;set; }|The width of the trail at the end of the trail.
 
{{ScriptFunction|float|EndWidth|{ get;set; }|The width of the trail at the end of the trail.
|5=<pre></pre>}}
+
A width of 1 corresponds to 1 unit in the game world.|5=<pre>Space.Host.ExecutingObject.TrailRenderer.EndWidth = 0.1</pre>}}
  
{{ScriptFunction|bool|IsVisible|{ get; }|Is this renderer visible in any camera?|5=<pre></pre>}}
+
{{ScriptFunction|bool|IsVisible|{ get; }|Is this renderer visible in any camera?|5=<pre>Space.Log(Space.Host.ExecutingObject.TrailRenderer.IsVisible)</pre>}}
  
{{ScriptFunction|float|MinVertexDistance|{ get;set; }|Set the minimum distance the trail can travel before a new vertex is added to it.|5=<pre></pre>}}
+
{{ScriptFunction|float|MinVertexDistance|{ get;set; }|Set the minimum distance the trail can travel before a new vertex is added to it.
 +
Smaller values with give smoother trails, consisting of more vertices, but costing more performance.|5=<pre>Space.Host.ExecutingObject.TrailRenderer.MinVertexDistance = 1</pre>}}
  
{{ScriptFunction|bool|MotionVectors|{ get;set; }|Set whether to use motion vectors to track this Renderer’s per-pixel, screen-space motion from one frame to the next. You can use this information to apply post-processing effects such as motion blur.|5=<pre></pre>}}
+
{{ScriptFunction|bool|MotionVectors|{ get;set; }|Set whether to use motion vectors to track this Renderer’s per-pixel, screen-space motion from one frame to the next. You can use this information to apply post-processing effects such as motion blur.|5=<pre>Space.Host.ExecutingObject.TrailRenderer.MotionVectors = true</pre>}}
  
{{ScriptFunction|int|NumCapVertices|{ get;set; }|Set this to a value greater than 0, to get rounded corners on each end of the trail.
+
{{ScriptFunction|int|NumCapVertices|{ get;set; }|Set this to a value greater than 0, to get rounded corners on each end of the trail.|5=<pre>Space.Host.ExecutingObject.TrailRenderer.NumCapVertices = 3</pre>}}
|5=<pre></pre>}}
+
  
{{ScriptFunction|int|NumCornerVertices|{ get;set; }|Set this to a value greater than 0, to get rounded corners between each segment of the trail.
+
{{ScriptFunction|int|NumCornerVertices|{ get;set; }|Set this to a value greater than 0, to get rounded corners between each segment of the trail.|5=<pre>Space.Host.ExecutingObject.TrailRenderer.NumCornerVertices = 2</pre>}}
|5=<pre></pre>}}
+
  
{{ScriptFunction|int|PositionCount|{ get; }|Get the number of line segments in the trail.
+
{{ScriptFunction|int|PositionCount|{ get; }|Get the number of line segments in the trail.|5=<pre>numLineSegments = Space.Host.ExecutingObject.TrailRenderer.PositionCount</pre>}}
|5=<pre></pre>}}
+
  
{{ScriptFunction|bool|ReceiveShadows|{ get;set; }|Does this object receive shadows?
+
{{ScriptFunction|bool|ReceiveShadows|{ get;set; }|Does this object receive shadows?|5=<pre>Space.Host.ExecutingObject.TrailRenderer.ReceiveShadows = true</pre>}}
|5=<pre></pre>}}
+
  
 
{{ScriptFunction|SColor|StartColor|{ get;set; }|Set the color at the start of the trail.
 
{{ScriptFunction|SColor|StartColor|{ get;set; }|Set the color at the start of the trail.
|5=<pre></pre>}}
+
|5=<pre>Space.Host.ExecutingObject.TrailRenderer.StartColor = Color.Black</pre>}}
  
 
{{ScriptFunction|float|StartWidth|{ get;set; }|The width of the trail at the spawning point.
 
{{ScriptFunction|float|StartWidth|{ get;set; }|The width of the trail at the spawning point.
|5=<pre></pre>}}
+
A width of 1 corresponds to 1 unit in the game world.
 +
|5=<pre>Space.Host.ExecutingObject.TrailRenderer.StartWidth = 1.1</pre>}}
  
 
{{ScriptFunction|int|TextureMode|{ get;set; }|Choose whether the U coordinate of the trail texture is tiled or stretched.
 
{{ScriptFunction|int|TextureMode|{ get;set; }|Choose whether the U coordinate of the trail texture is tiled or stretched.
|5=<pre></pre>}}
+
0 Stretch, 1 Tile, 2 Distribute Per Segment, 3 Repeat Per Segment|5=<pre>Space.Host.ExecutingObject.TrailRenderer.TextureMode = 2</pre>}}
  
{{ScriptFunction|float|Time|{ get;set; }|How long does the trail take to fade out.
+
{{ScriptFunction|float|Time|{ get;set; }|How long does the trail take to fade out. (seconds)|5=<pre>Space.Host.ExecutingObject.TrailRenderer.Time = 10</pre>}}
|5=<pre></pre>}}
+
  
 
{{ScriptFunction|bool|UseLightProbes|{ get;set; }|Enable Light Probes on the trail.
 
{{ScriptFunction|bool|UseLightProbes|{ get;set; }|Enable Light Probes on the trail.
|5=<pre></pre>}}
+
|5=<pre>Space.Host.ExecutingObject.TrailRenderer.UseLightProbes = true</pre>}}
  
 
{{ScriptFunction|float|WidthMultiplier|{ get;set; }|Set an overall multiplier that is applied to the TrailRenderer.widthCurve to get the final width of the trail.
 
{{ScriptFunction|float|WidthMultiplier|{ get;set; }|Set an overall multiplier that is applied to the TrailRenderer.widthCurve to get the final width of the trail.
|5=<pre></pre>}}
+
|5=<pre>Space.Host.ExecutingObject.TrailRenderer.WidthMultiplier = 2</pre>}}
  
  

Revision as of 14:48, 22 December 2020

Members

Clear

void Clear ();

Removes all points from the TrailRenderer. Useful for restarting a trail from a new position.

Space.Host.ExecutingObject.TrailRenderer.Clear()


GetPosition

SVector GetPosition (int index);

Get the position of a vertex in the trail.

vectorPos = Space.Host.ExecutingObject.TrailRenderer.GetPosition(0)



Properties

Alignment

int Alignment { get;set; }

No documentation

Space.Host.ExecutingObject.TrailRenderer.Alignment = 1


Autodestruct

bool Autodestruct { get;set; }

Does the GameObject of this Trail Renderer auto destruct?

Space.Host.ExecutingObject.TrailRenderer.Autodestruct = true


CastShadows

bool CastShadows { get;set; }

Does the trail cast a shadow when a shadow-casting Light shines on it?

Space.Host.ExecutingObject.TrailRenderer.CastShadows = true


Enabled

bool Enabled { get;set }

Whether this TrailRenderer component is Enabled or not

Space.Host.ExecutingObject.TrailRenderer.Enabled = true


EndColor

Scolor EndColor { get;set; }

Set the color at the end of the trail.

Space.Host.ExecutingObject.TrailRenderer.EndColor = Color.Red


EndWidth

float EndWidth { get;set; }

The width of the trail at the end of the trail. A width of 1 corresponds to 1 unit in the game world.

Space.Host.ExecutingObject.TrailRenderer.EndWidth = 0.1


IsVisible

bool IsVisible { get; }

Is this renderer visible in any camera?

Space.Log(Space.Host.ExecutingObject.TrailRenderer.IsVisible)


MinVertexDistance

float MinVertexDistance { get;set; }

Set the minimum distance the trail can travel before a new vertex is added to it. Smaller values with give smoother trails, consisting of more vertices, but costing more performance.

Space.Host.ExecutingObject.TrailRenderer.MinVertexDistance = 1


MotionVectors

bool MotionVectors { get;set; }

Set whether to use motion vectors to track this Renderer’s per-pixel, screen-space motion from one frame to the next. You can use this information to apply post-processing effects such as motion blur.

Space.Host.ExecutingObject.TrailRenderer.MotionVectors = true


NumCapVertices

int NumCapVertices { get;set; }

Set this to a value greater than 0, to get rounded corners on each end of the trail.

Space.Host.ExecutingObject.TrailRenderer.NumCapVertices = 3


NumCornerVertices

int NumCornerVertices { get;set; }

Set this to a value greater than 0, to get rounded corners between each segment of the trail.

Space.Host.ExecutingObject.TrailRenderer.NumCornerVertices = 2


PositionCount

int PositionCount { get; }

Get the number of line segments in the trail.

numLineSegments = Space.Host.ExecutingObject.TrailRenderer.PositionCount


ReceiveShadows

bool ReceiveShadows { get;set; }

Does this object receive shadows?

Space.Host.ExecutingObject.TrailRenderer.ReceiveShadows = true


StartColor

SColor StartColor { get;set; }

Set the color at the start of the trail.


Space.Host.ExecutingObject.TrailRenderer.StartColor = Color.Black


StartWidth

float StartWidth { get;set; }

The width of the trail at the spawning point. A width of 1 corresponds to 1 unit in the game world.


Space.Host.ExecutingObject.TrailRenderer.StartWidth = 1.1


TextureMode

int TextureMode { get;set; }

Choose whether the U coordinate of the trail texture is tiled or stretched. 0 Stretch, 1 Tile, 2 Distribute Per Segment, 3 Repeat Per Segment

Space.Host.ExecutingObject.TrailRenderer.TextureMode = 2


Time

float Time { get;set; }

How long does the trail take to fade out. (seconds)

Space.Host.ExecutingObject.TrailRenderer.Time = 10


UseLightProbes

bool UseLightProbes { get;set; }

Enable Light Probes on the trail.


Space.Host.ExecutingObject.TrailRenderer.UseLightProbes = true


WidthMultiplier

float WidthMultiplier { get;set; }

Set an overall multiplier that is applied to the TrailRenderer.widthCurve to get the final width of the trail.


Space.Host.ExecutingObject.TrailRenderer.WidthMultiplier = 2