ShaderLamp (CMS) - Revision history

AFRLme at 14:04, 9 May 2015

2015-05-09T14:04:25Z

AFRLme at 14:02, 9 May 2015

2015-05-09T14:02:56Z

AFRLme at 14:02, 9 May 2015

2015-05-09T14:02:15Z

AFRLme at 14:01, 9 May 2015

2015-05-09T14:01:44Z

AFRLme at 13:38, 9 May 2015

2015-05-09T13:38:50Z

AFRLme at 13:28, 9 May 2015

2015-05-09T13:28:23Z

AFRLme at 13:17, 9 May 2015

2015-05-09T13:17:38Z

AFRLme at 12:57, 9 May 2015

2015-05-09T12:57:07Z

AFRLme: Created page with "{| class="ts" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left" | Type |- | shaderLamp(index, type, pos, targ, falloff, ac, dc, df, exp, cutoff..."

2015-05-09T12:54:05Z

Created page with "{| class="ts" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left" | Type |- | shaderLamp(index, type, pos, targ, falloff, ac, dc, df, exp, cutoff..."

New page

{| class="ts" style="width:100%"
|-
! style="text-align:left" | Name !! style="text-align:left" | Type
|-
| shaderLamp(index, type, pos, targ, falloff, ac, dc, df, exp, cutoff) || Execution
|}

With the openGL shader, it is entirely possible to apply multiple light sources to each of your scenes. These light sources can either be static or dynamic. Static light sources would be fixed in place & their parameters will always stay the same, whereas dynamic light sources could be pinned to something that is moving, such as: a character or object in the scene & / or the parameters of the light could also be adjusted over time, to create atmospheric lighting such as flickering, sway or a shift in the intensity or reach of the overall light.

There are 2 different types of light available, 1. spotlight & 2. point light.

Finally I would just like to point out that you have to manually declare the amount of light sources on the scene, by declaring them with the '''shaderActivateLighting()''' function.

Finally finally, light sources can actually be bound to a loop using the '''bind()''' function, or you can create your own loop using the mainLoop event handler.

== Examples ==
=== Enable ===
...
<syntaxhighlight>
...
</syntaxhighlight>
=== Disable ===
...
<syntaxhighlight>
...
</syntaxhighlight>

== Syntax Breakdown ==
{| class="ts" style="width:100%"
|-
! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left;width:80%" | Description
|-
| value || float (decimal) || The amount to blur the screen by; recommended value somewhere between 0 & 20.
|-
| delay || integer (number) || The amount of time to blur/focus the screen over; in milliseconds (ms).
|}

== Resources ==
{| class="ts"
|-
! style="text-align:left" | Name !! style="text-align:left" | Description
|-
| [[media:shaderBlur.zip|shaderBlur.zip]] || A working .ved file, complete with resources. Check out the readme.txt file for instructions.
|}{{toc}}

@@ Line 44: / Line 44: @@
 | df || float (decimal) || The diffuse factor controls the strength of the diffuse color. 1 = default. Higher than 1 = brighter. Lower than 1 = darker.
 |-
-| exp || integer (number) || The exponent controls the spread of light from the source. 0 = 180º whereas an higher value will have a smaller spread. ''This value is only required for spotlights.''
+| exp || integer (number) || The exponent controls the spread of light from the source. 0 = 180º whereas an higher value will have a smaller spread. ''This parameter is only required for spotlights.''
 |-
-| cutoff || float (decimal) || The cutoff is used to define how soft or sharp the edges of the light will be. The value should be something in between 0 & 1.
+| cutoff || float (decimal) || The cutoff is used to define how soft or sharp the edges of the light will be. The value should be between 0 & 1. ''This parameter is only required for spotlights.''
 |}

@@ Line 42: / Line 42: @@
 | dc || point (r,g,b) ''or'' function (h,s,v) || Diffuse color is similar to ambient color, but it is used to tint the screen itself, as opposed to just the light source.
 |-
-| df | float (decimal) || The diffuse factor controls the strength of the diffuse color. 1 = default. Higher than 1 = brighter. Lower than 1 = darker.
+| df || float (decimal) || The diffuse factor controls the strength of the diffuse color. 1 = default. Higher than 1 = brighter. Lower than 1 = darker.
 |-
-| exp | integer (number) || The exponent controls the spread of light from the source. 0 = 180º whereas an higher value will have a smaller spread. ''This value is only required for spotlights.''
+| exp || integer (number) || The exponent controls the spread of light from the source. 0 = 180º whereas an higher value will have a smaller spread. ''This value is only required for spotlights.''
 |-
-| cutoff | float (decimal) || The cutoff is used to define how soft or sharp the edges of the light will be. The value should be something in between 0 & 1.
+| cutoff || float (decimal) || The cutoff is used to define how soft or sharp the edges of the light will be. The value should be something in between 0 & 1.
 |}

@@ Line 36: / Line 36: @@
 | targ || point (x, y, z) || The target position of the light source. The light travels from pos to targ. ''Only for point lighting; set {0,0,0} for spotlight.''
 |-
-| falloff || ... || ...
+| falloff || point (cnst, lnr, quad) || The falloff controls the amount of light decay over distance. ''Please see [https://developer.valvesoftware.com/wiki/Constant-Linear-Quadratic_Falloff here] for more details on light attenuation.''
 |}
 index, type, pos, targ, falloff, ac, dc, df, exp, cutoff

← Older revision		Revision as of 13:28, 9 May 2015
Line 7:		Line 7:


−	~~With the openGL shader, it is entirely possible to apply multiple light sources to each of your scenes~~. ~~These light sources can either be static or dynamic~~. Static light sources would be fixed in place & their parameters will always stay the same, whereas dynamic light sources could be pinned to something that is moving, such as: a character or object in the scene & / or the parameters of the light could also be adjusted over time, to create atmospheric lighting such as flickering, sway or a shift in the intensity or reach of the overall light.	+	...
−
−	~~There are two different types of light available: 1. spotlight & 2. point light.~~
−
−	~~Finally I would just like to point out that you have to manually declare the amount of light sources on the scene, by declaring them with the '''shaderActivateLighting()''' function.~~
−
−	Finally finally, light sources can actually be bound to a loop using the '''bind()''' function, or you can create your own loop using the '''mainLoop''' event handler or by creating a loop inside of the editor using the '''jump to x''' action part inside of an action block.

@@ Line 34: / Line 34: @@
 ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left;width:80%" | Description
 |-
-| value || float (decimal) || The amount to blur the screen by; recommended value somewhere between 0 & 20.
+| index || integer (number) || The index number to assign to the light source. Index starts at 0.
 |-
-| delay || integer (number) || The amount of time to blur/focus the screen over; in milliseconds (ms).
+| type || integer (number) || The type of light you want to create. 0 = spotlight. 1 = point light.
 |}
+index, type, pos, targ, falloff, ac, dc, df, exp, cutoff
 == Resources ==

@@ Line 9: / Line 9: @@
 With the openGL shader, it is entirely possible to apply multiple light sources to each of your scenes. These light sources can either be static or dynamic. Static light sources would be fixed in place & their parameters will always stay the same, whereas dynamic light sources could be pinned to something that is moving, such as: a character or object in the scene & / or the parameters of the light could also be adjusted over time, to create atmospheric lighting such as flickering, sway or a shift in the intensity or reach of the overall light.
-There are 2 different types of light available, 1. spotlight & 2. point light.
+There are two different types of light available: 1. spotlight & 2. point light.
 Finally I would just like to point out that you have to manually declare the amount of light sources on the scene, by declaring them with the '''shaderActivateLighting()''' function.
-Finally finally, light sources can actually be bound to a loop using the '''bind()''' function, or you can create your own loop using the mainLoop event handler.
+Finally finally, light sources can actually be bound to a loop using the '''bind()''' function, or you can create your own loop using the '''mainLoop''' event handler or by creating a loop inside of the editor using the '''jump to x''' action part inside of an action block.
 == Examples ==
-=== Enable ===
+=== Spotlight ===
 ...
 <syntaxhighlight>
 ...
 </syntaxhighlight>
-=== Disable ===
+=== Point Light ===
 ...
 <syntaxhighlight>
@@ Line 45: / Line 45: @@
 ! style="text-align:left" | Name !! style="text-align:left" | Description
 |-
-| [[media:shaderBlur.zip|shaderBlur.zip]] || A working .ved file, complete with resources. Check out the readme.txt file for instructions.
+| n/a || A working .ved file, complete with resources. Check out the readme.txt file for instructions.
 |}{{toc}}