Star Info

Star Info allows you to specify the possible types of stars that a Star Field may consist of. Star Info is stored separately from Star Field, because it is common for one instance of Star Info to be reused for multiple Star Fields (For example, main_sequence_distribution.json).

Star Info consists of a single REQUIRED field called star_types, which defines a list of Star Types that generate within this Star Field.

Star Type

When a Star Field is generated, each of its stars receive a random Star Type defined in the star_types section of Star Info. This random Star Type is then used for defining the star's color and for further randomization of the star's size and brightness.

Level Of Detail (LOD)

To increase performance, Star Fields divide their stars into 3 groups which are rendered at different distances. These groups are as follows:

• LOD3 - Stars won't render when they're more than 5 000 000 Light Years away.
• LOD2 - Stars won't render when they're more than 10 000 000 Light Years away.
• LOD1 - Stars always render

Definition

A Star Type definition consists of the following fields:

• rgb REQUIRED - A set of 3 values (red, green, blue) that define the color of the star. [Min = 0 | Max = 255]
• min_size REQUIRED - A (unitless) float value that specifies the minimum size a star of this Star Type can have when its size is randomly generated.
• max_size REQUIRED - A (unitless) value that specifies the maximum size a star of this Star Type can have when its size is randomly generated.
• min_brightness REQUIRED - A value that specifies the minimum brightness a star of this Star Type can have when its brightness is randomly generated.
• max_brightness REQUIRED - A value that specifies the maximum brightness a star of this Star Type can have when its brightness is randomly generated.
• max_visible_distance OPTIONAL - A distance value (in Light Years) that specifies the maximum distance at which the star is still rendered. WIP
• weight REQUIRED - The higher the weight, the higher the chance for this Star Type to be used when a random star is generated. [Min = 1 | Max = 2147483647]

Star Info example for main sequence star distribution:

{
	"star_types":
	[
		{ "rgb": {"red": 207, "green": 207, "blue": 255}, "min_size": 0.25, "max_size": 0.35, "min_brightness": 255, "max_brightness": 255, "max_visible_distance": 10000000, "weight": 1 },
		{ "rgb": {"red": 223, "green": 223, "blue": 255}, "min_size": 0.20, "max_size": 0.30, "min_brightness": 225, "max_brightness": 255, "max_visible_distance": 8000000, "weight": 1 },
		{ "rgb": {"red": 239, "green": 239, "blue": 255}, "min_size": 0.15, "max_size": 0.25, "min_brightness": 210, "max_brightness": 240, "max_visible_distance": 6000000, "weight": 1 },
		{ "rgb": {"red": 255, "green": 255, "blue": 255}, "min_size": 0.15, "max_size": 0.25, "min_brightness": 190, "max_brightness": 230, "max_visible_distance": 5500000, "weight": 3 },
		{ "rgb": {"red": 255, "green": 255, "blue": 223}, "min_size": 0.10, "max_size": 0.25, "min_brightness": 180, "max_brightness": 210, "max_visible_distance": 5000000, "weight": 7 },
		{ "rgb": {"red": 255, "green": 239, "blue": 223}, "min_size": 0.10, "max_size": 0.25, "min_brightness": 120, "max_brightness": 200, "max_visible_distance": 4500000, "weight": 12 },
		{ "rgb": {"red": 255, "green": 223, "blue": 223}, "min_size": 0.10, "max_size": 0.15, "min_brightness": 100, "max_brightness": 150, "max_visible_distance": 4000000, "weight": 74 }
	]
}

Dust Cloud Info

Dust Cloud Info allows you to specify the possible types of dust clouds that a Star Field may consist of. Dust Cloud Info is stored separately from Star Field, because it is common for one instance of Dust Cloud Info to be reused for multiple Star Fields (For example, white_dust_clouds.json).

Dust Cloud Info consists of a single REQUIRED field called dust_cloud_types, which defines a list of Dust Cloud Types that generate within this Star Field.

Dust Cloud Type

When a Star Field is generated, each of its dust clouds receive a random Dust Cloud Type defined in the star_types section of Dust Cloud Info. This random Dust Cloud Type is then used for defining the dust cloud's color and for further randomization of the dust cloud's size and brightness.

Definition

A Dust Cloud Type definition consists of the following fields:

• rgb REQUIRED - A set of 3 values (red, green, blue) that define the color of the dust cloud. [Min = 0 | Max = 255]
• min_size REQUIRED - A (unitless) value that specifies the minimum size a dust cloud of this Dust Cloud Type can have when its size is randomly generated.
• max_size REQUIRED - A (unitless) value that specifies the maximum size a dust cloud of this Dust Cloud Type can have when its size is randomly generated.
• min_brightness REQUIRED - A value that specifies the minimum brightness a dust cloud of this Dust Cloud Type can have when its brightness is randomly generated.
• max_brightness REQUIRED - A value that specifies the maximum brightness a dust cloud of this Dust Cloud Type can have when its brightness is randomly generated.
• weight REQUIRED - The higher the weight, the higher the chance for this Dust Cloud Type to be used when a random dust cloud is generated. [Min = 1 | Max = 2147483647]

Dust Cloud Info example for Milky Way spiral arm dust cloud distribution:

{
	"dust_cloud_types":
	[
		{ "rgb": {"red": 107, "green": 107, "blue": 107}, "min_size": 5.0, "max_size": 9.0, "min_brightness": 255, "max_brightness": 255, "weight": 1 },
		{ "rgb": {"red": 140, "green": 160, "blue": 255}, "min_size": 5.0, "max_size": 9.0, "min_brightness": 255, "max_brightness": 255, "weight": 4 }
	]
}