StarGen 1.0

For Autodesk 3ds Max

Help Document

Oormi Creations

http://oormi.in







Contents

 


Introduction

StarGen is a maxscript for Autodesk 3ds Max. It generates a 2D image of starfield or night sky. It is useful for creating a skybox, or space scene, or as a sky background for 2D art.

The script is a freeware and can be used for any commercial or non-commercial purposes. It is provided unencrypted for further mods or improvements.

Feature List

Current version 1.0 has these features:

  • Single click creation a starfield image or night sky.
  • Parameters for star count, brightness, size, shape etc.
  • Any image size is supported (square aspect).
  • Changeable colors for sky, stars, fog, clouds.
  • Also adds a horizon fog.
  • Free and open sourced.

System Requirements

Supported versions are Autodesk 3ds Max 11 to 3ds Max 2015. It may or may not run properly in lower and higher versions than these.


Running the Script

The script file is named stargen-08.ms

Simply drag the script file into 3ds Max. Or click on menu MaxScript->Run Script and select this script. No installation is needed.

You can however, make your own macroscipt to create a button on Max toolbar or some other UI item in usual way and "File-In" this script.


Quick Start

  1. Press the Create Stars button
  2. You are Done !!

Adjust parameters for variations. It generate a different field every time you create.


Parameters

Stars

Create Stars : Creates a 2D bitmap using the paramters already set. Note that the last create bitmap is closed. So please save an image if you think you can use it later.

Image Size : Size of the generated bitmap in pixel. Width or height. It is a square bitmap.

Count: The number of stars. It is approx, since any stars that randomly are positioned on the image boundary are not created.

Min Size : Minimum size of the star in pixels.

Max Size : Maximum size of the star in pixels. The actual size is any random number between the min and max.

Brightness: Brightness or intensity of the star. Bigger stars are brighter and may clamp to white.

Fade : Fades the brightness as we go towards the bottom (horizon). Use it with the brightness spinner. Bright stars need more fading. The stars may start appearing from the bottom if you make it too high. This is a known bug.

Shape 1 : This parameter controls the shape of the star. Higher values make it bigger and more square. Use it with Shape 2, brightness and Size parameters.

Shape 2 : This parameter controls the shape of the star. Higher values make it bigger and more diamond shaped. Use it with Shape 1, brightness and Size parameters. Smaller values make the star with four streaks. See this screenshot for an example:



Star Color Range : The RGB range of random star colors. Setting it from black to white would produce stars of all colors at random.

Sky Color : The background color.

Cloud Color : The fractal noise color. It is overlaid on the background to create dust or clouds. You can disable this by unchecking the check box next to it.

Horizon color : This color is placed at the bottom of the image and fades to the sky color at the top. Set the Fade parameter to 0 to disable it.

Horizon Brightness : The brightness of the horizon gradient. If the color is already bright, it will over expose.

Cloud Seed : Sets random seed for the fractal noise of the clouds or dust. There are more parameters for noise, you will need to set them in the code, if needed at all.

Note that the last created bitmap is lost when you create the stars again with new parameters or even with same parameters. So save your work!


Whats new in this version ?

This is the first version. There can be new versions.

  • Coming soon....


Contact and Support

For free support, bug reports, requests or queries please contact on oormicreations@gmail.com

Customization requests are most welcome. So if you need extra features in this script for your project please contact with full requirements.

This SCRIPT, StarGen 1.0, is being provided by OORMI CREATIONS "as is" .OORMI CREATIONS makes no claims or warranties of any kind concerning the safety, suitability, compatibility, performance and durability of this SCRIPT. There are inherent risks in the use of any software, and you are solely responsible for determining whether this SCRIPT is compatible with your equipment and other software installed on your equipment. You are also solely responsible for the protection of your equipment and backup of your data, and OORMI CREATIONS will not be liable for any damages you may suffer in connection with using, modifying, or distributing this SCRIPT.


Oormi Creations

StarGen 1.0

İOormi Creations 2016, All rights reserved.

http://oormi.in


This document was created by KompoZer . Open source and free html editor.