DemoHTML: Filter - Light.addPoint method

Light.addPoint method

This is a test of the Emergency Filtering Network.
santa with transparent background

The buttons add points of yellow light to each Santa and of blue to the text. A single point is rather hard to spot! Adding more than one light with the same coordinates would increase the brightness, as does moving the z-coordinate off the page.

Clicking the left buttons multiple times won't change anything since each adds 10 lights already, the maximum. The middle buttons add only 8 lights, so clicking it twice or clicking it and then a left button will repeat (or add) two lights to the Santas.

Can you find the point lights on the text? Check the capital E or the lower case m. Since the base color of the text is navy, a yellow light doesn't show. Remember that the light's color will interact with the original color still. The script uses a blue light, tho a white or blue/green light would also work.

The coordinates are not quite the same for the lights on the two Santas. Using the z=0 buttons, notice that a tiny change in position makes a big difference in the visibility of the point light. The brighter ones are positioned on colors that are match the colors in the light. The brightest effect occurs when over white. Notice the orangish lights which are on the colored part of the nose.The really dim lights are on the black lines.

Using the z=2 buttons, we can start to see how a point light that is off the page lights up an area of the image. Can you see where the black lines in the image cut across the lights? Santa's eyes are an especially spooky effect!

When using the middle buttons, we see that lights in the transparent area are not seen at all. Lights within the red hat area show as red because the red in the light matches the red of the hat.

What you should see

Click once on left z=0 button.

Click once on middle z=0 button

Click once on left z=2 button.

Click once on middle z=2 button

Click once on left z=5 button.

Click once on middle z=5 button.

Syntax and settings

These points are added by calling a function from onClick of each button.

First a light filter must be created for each object in STYLE with:

{FILTER:light} or {FILTER:light(enabled=0)}

The script sets each point with a command. The one for the text lights looks like:

function textpoints()
{efn.filters.light.addPoint(4,5,0,0,0,255,100);
  efn.filters.light.addPoint(4,6,0,0,0,255,100);
  efn.filters.light.addPoint(4,7,0,0,0,255,100);
  efn.filters.light.addPoint(4,8,0,0,0,255,100);
  efn.filters.light.addPoint(4,9,0,0,0,255,100);
  efn.filters.light.addPoint(4,10,0,0,0,255,100);
  efn.filters.light.addPoint(4,11,0,0,0,255,100);
  efn.filters.light.addPoint(4,12,0,0,0,255,100);
  }

The general form for using the addPoint method is:

object.filters.Light.addPoint(x,y,z,R,G,B,strength)

Object is the ID of the visual object to filter.
x, y, z are the coordinates of the point light.
R, G, B are the color values of the light's color, from 0 to 255.
Strength is an integer for the intensity of the light, ranging from 0 to 100.

More examples

Change RGB values only.
Click up to 10 times to increase brightness by adding more point lights.
Z=0

255,255,255	255,0,0	0,255,0	0,0,255
255,255,0	0,255,255	255,0,255	255,100,0

Change z coordinate only
x,y = 40,50
R,G,B = 255,255,255

Change strength only
x,y,z = 40,50,50
R,G,B = 255,255,255