de.toman.milight

Class AmbientLight

java.lang.Object

de.toman.milight.AmbientLight

All Implemented Interfaces:

java.lang.Runnable

public class AmbientLight
extends java.lang.Object
implements java.lang.Runnable

With this class you can adjust your lights in a way that they have the same color and brightness as your screen. The screen is captured regularly, some pixels get extracted, the average color is computed and then sent to the group of lights. This is nice when watching movies and supports their athmosphere. Use the start() function to run this class in a seperate thread.

Constructor Summary

Constructors

Constructor and Description
AmbientLight(Lights lights) This constructor creates a new ambient light capturing the screen as often as possible and extracting 9 pixels (a 3x3 grid) in each loop.
AmbientLight(Lights lights, int nx, int ny) This constructor creates a new ambient light capturing the screen as often as possible.
AmbientLight(Lights lights, int nx, int ny, long sleepInterval) This constructor creates a new ambient light.

Method Summary

Modifier and Type	Method and Description
static java.awt.Color	averageColor(java.util.Set<java.awt.Color> colors) This function computes the average of a set of colors.
static java.util.Set<java.awt.Color>	extractColors(java.awt.image.BufferedImage image, int nx, int ny) This function extracts the colors of some pixels from a BufferedImage.
void	run() This functions runs a loop to set the ambient light until the stop() function is called.
void	start() This function starts the ambient light in a new thread.
void	stop() This function stops the thread running the ambient light.
java.lang.String	toString() This function describes the objet as a string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

AmbientLight

public AmbientLight(Lights lights,
                    int nx,
                    int ny,
                    long sleepInterval)

This constructor creates a new ambient light. Use the start() function to run it in a seperate thread.

Parameters:

lights - is the group of lights to control

nx - is the number of pixels to be extracted in each loop in horizontal direction

ny - is the number of pixels to be extracted in each loop in vertical direction

sleepInterval - is the time to sleep between to screen captures in milli seconds

AmbientLight

public AmbientLight(Lights lights,
                    int nx,
                    int ny)

This constructor creates a new ambient light capturing the screen as often as possible. Use the start() function to run it in a seperate thread.

Parameters:

lights - is the group of lights to control

nx - is the number of pixels to be extracted in each loop in horizontal direction

ny - is the number of pixels to be extracted in each loop in vertical direction

AmbientLight

public AmbientLight(Lights lights)

This constructor creates a new ambient light capturing the screen as often as possible and extracting 9 pixels (a 3x3 grid) in each loop. Use the start() function to run it in a seperate thread.

Parameters:

lights - is the group of lights to control

Method Detail

run

public void run()

This functions runs a loop to set the ambient light until the stop() function is called. In each iteration a capture of the screen is made, some pixels according to the nx and ny values are extracted, the average of these colors is computed and then this color is sent to the controlled group of lights. Use start() to run this function in a seperate thread.

Specified by:

run in interface java.lang.Runnable

extractColors

public static java.util.Set<java.awt.Color> extractColors(java.awt.image.BufferedImage image,
                                                          int nx,
                                                          int ny)

This function extracts the colors of some pixels from a BufferedImage. The pixels are computed with equal distances with no pixels being on the border of the image. The set of all hese colors is returned.

Parameters:

image - is the image where the colors should be extracted

nx - is the number of pixels to be read in horizontal direction

ny - is the number of pixels to be read in vertical direction

Returns:

a set containing the extracted colors

averageColor

public static java.awt.Color averageColor(java.util.Set<java.awt.Color> colors)

This function computes the average of a set of colors. To do this, the arithmetic mean value is computed for red, green and blue components individually.

Parameters:

colors - is the set of colors to compute the average of

Returns:

the average color

stop

public void stop()

This function stops the thread running the ambient light. The thread can be resumed by calling start again.

See Also:

start()

start

public void start()

This function starts the ambient light in a new thread.

toString

public java.lang.String toString()

This function describes the objet as a string. Use this for debugging.

Overrides:

toString in class java.lang.Object