Nightshade G3 / NG Scripting Differences Compared to Legacy¶

If you have StratoScripts authored for Nightshade Legacy, you may need to make some adjustments for full functionality on Nightshade NG.

Changes that won’t break anything...¶

• The external_viewer command is still supported but deprecated. It simply forwards to new video command.
• Simultaneous playback of multiple audio and video sources now supported.
• Audio and video commands can take a new optional parameter name provided along with the filename parameter (at load time). This parameter behaves identically to the use in the image command and provides support for referencing more than one audio/video source. If a name is not provided, the behavior matches that of Legacy and only one at a time is supported.
• audio and video commands now have a seek argument.
• The external_viewer parameter background_framerate is deprecated.
• The audio output_rate is deprecated.
• video now supports all coordinate systems (same as image).
• video support for xpos and ypos parameters is identical to image command.
• New experimental text command allows one to display text.
• flag time_lapse added
• body command can now load 3D models if your NG edition supports this.

Changes that could break things...¶

These are sorted with the most likely to cause problems at the top. Some of these will be fixed or improved over time.

• When using the moveto command it will now take the shortest path between two points. So if you have to travel more than 180 degrees you need to break your path into at least two smaller movements. Use an acceleration of zero so that movement is continuous.
• Currently when using the moveto command, you can only have one animation at a time. If one moveto begins while another is still in progress, the newest moveto will replace the last. Key frames may help.
• If you flyto a body you are not automatically landed on it, meaning you can not turn on your photographic landscape. See moveto land.
• There is currently no nebula command to load your own nebula images in the sky. Use the image command instead.
• Nebula names have changed. Use the NGC or IC number like select nebula NGC500.
• There is no set milkyway_texture equivalent yet. Use the image command instead with a scale of 360 degrees.
• moveto heading now sets your navigational heading and is not backward compatible.
• flag orbit_trails and related color is deprecated - see new time lapse feature.
• body command big_halo feature deprecated.
• Dropped support for “old style” landscapes.
• Selecting a body does not affect your selected constellations. This is a feature improvement but differs from past behavior.
• set zoom_offset is deprecated. See set focal_alt and set focal_azi instead.
• removed zoom delta_fov as it never worked well in practice.
• max_mag_nebula_name is deprecated.
• removed flag fog.
• removed flag point_star.
• removed image mipmap as unneeded.
• removed flag antialias_lines as this is now standard.