hirondelle.starfield.physics

Class StarfieldImage

Object

hirondelle.starfield.physics.StarfieldImage

final class StarfieldImage
extends Object

Dynamically generate an image of a starfield to an output image file, one star at a time.

The following data is rendered for each visible star: its magnitude (brightness), color (surface temperature), and position.

Constructor Summary

Constructors

Constructor and Description
StarfieldImage(Projector aProjector, File aOutputFile, int aImageSize, int aMagnification) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) void	add(BoostedStar aBoostedStar, double aPhi) Add a boosted star to the generated image.
(package private) void	dispose() Clean up resources when finished with this object.
(package private) void	generateFile() Notify this class that no more stars are to be added, and to generate the final file as output.

Methods inherited from class Object

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

Constructor Detail

StarfieldImage

StarfieldImage(Projector aProjector,
              File aOutputFile,
              int aImageSize,
              int aMagnification)

Constructor.

Parameters:

aProjector - how to position each star on the image.

aOutputFile - where the file will be saved on the local file system. The extension of the file name determines the type of file generated - jpg, png, etc. The file format .png seems to give the best results.

aImageSize - the width (and height) of the image in pixels; the generated image is square. If this is too large, then your host may run out of memory.

aMagnification - applies only to the half-sky projections. Magnifying to ~6x gives a nice result for high beta.

Method Detail

add

void add(BoostedStar aBoostedStar,
       double aPhi)

Add a boosted star to the generated image.

generateFile

void generateFile()

Notify this class that no more stars are to be added, and to generate the final file as output. This method calls dispose() at the end.

dispose

void dispose()

Clean up resources when finished with this object.