Sun_Positioner - superclass: light; super-superclass:node - 21:0 - classID: #(670970524L, 1903123237L)

Instances of this class are used to define the Sun Position of the Physical Sun & Sky Environment Map. Available in in 3ds Max 2017 and higher.

Constructors:

Sun_Positioner...
SunPositioner...

Properties:

Display Rollout

Compass Rose Group Of Controls

<Sun_Positioner>.show_compass     BooleanClass    default: true   --  boolean

Get/set the state of the "Show" checkbox.

<Sun_Positioner>.compass_radius     Float    default: 10.0   --  animatable; worldUnits

Get/set the value of the "Radius" spinner.

<Sun_Positioner>.north_direction_deg     Float    default: 0.0   --  animatable; float

Get/set the value in degrees of the "North Offset" spinner.

Sun Group Of Controls

<Sun_Positioner>.sun_distance     Float    default: 40.0   --  animatable; worldUnits

Get/set the value in world units of the "Distance" spinner.

Sun Position Rollout

Date & Time Group Of Controls

<Sun_Positioner>.mode     Integer    default: 0   --  integer

Get/set the state of the "Date & Time" radio buttons.

Possible values are:

0 - Manual (default)

1 - Date, Time, & Location

2 - Weather Data File

<Sun_Positioner>.weather_file     String    default: ""   --  filename; !error setting value!

Get/set the file name of the "Weather Data File".

<Sun_Positioner>.time_in_seconds     Integer    default: 43200   --  animatable; integer

Get/set the time value in seconds.

This is the internal animatable property used to store the time of day.

The UI exposes the same value as Hours and Minutes - see the properties below.

<Sun_Positioner>.hours     Integer    default: 12   --  integer

Get/set the value in hours of the "Hours" spinner.

<Sun_Positioner>.minutes    Integer    default: 0   --  integer

Get/set the value in minutes of the "Minutes" spinner.

<Sun_Positioner>.julian_day     Integer    default: 2457925   --  animatable; integer

The date is stored internally as a Julian Day value, where day 1 is January 1, 4713 B.C.

However, the UI exposes the date as Gregorian calendar values by converting the Julain Day value back and forth.

The default value is the day of the summer solstice in the year 2016 A.D.

<Sun_Positioner>.day   Integer    default: 21   --  integer

Get/set the Gregorian calendar day converted from/to the internal Julian Day representation.

Valid values are in the range from 1 to 31.

<Sun_Positioner>.month     Integer    default: 6   --  integer

Get/set the Gregorian calendar month converted from/to the internal Julian Day representation.

<Sun_Positioner>.year     Integer    default: 2017   --  integer

Get/set the Gregorian calendar year converted from/to the internal Julian Day representation.

Since the Gregorian calendar did not exist prior to October 15, 1582, the spinner in the UI is limited to a minimum value of 1583.

Daylight Saving Time Group Of Controls

<Sun_Positioner>.dst     BooleanClass    default: true   --  animatable; boolean

Get/set the state of the "Daylight Saving Time" checkbox.

<Sun_Positioner>.dst_use_date_range     BooleanClass    default: false   --  animatable; boolean

Get/set the state of the "Use Date Range" checkbox.

When checked, the Daylight Saving Time period can be specified manually using the following properties.

<Sun_Positioner>.dst_start_day     Integer    default: 15   --  animatable; integer

Get/set the value of the "Start / Day" spinner.

<Sun_Positioner>.dst_start_month     Integer    default: 3   --  animatable; integer

Get/set the value of the "Start / Month" spinner.

<Sun_Positioner>.dst_end_day     Integer    default: 1   --  animatable; integer

Get/set the value of the "End / Day" spinner.

<Sun_Positioner>.dst_end_month     Integer    default: 11   --  animatable; integer

Get/set the value of the "End / Month" spinner.

Location on Earth Group Of Control

<Sun_Positioner>.location     String    default: "San Francisco, CA"   --  string;

Get the location string.

Read-only.

<Sun_Positioner>.latitude_deg     Float    default: 37.795   --  animatable; float

Get/set the value in degrees of the "Latitude" spinner.

The default value is the latitude of San Francisco, CA.

<Sun_Positioner>.longitude_deg     Float    default: -122.394   --  animatable; float

Get/set the value in degrees of the "Longitude" spinner.

The default value is the longitude of San Francisco, CA.

<Sun_Positioner>.time_zone     Float    default: -8.0   --  animatable; float

Get/set the value in hours of the "Time Zone" spinner.

The default value of -8 is the time zone of San Francisco, CA.

Horizontal Coordinates Group Of Controls

<Sun_Positioner>.azimuth_deg     Float    default: 128.715   --  float

Get/set the value in degrees of the "Azimuth" spinner.

<Sun_Positioner>.altitude_deg    Float    default: 69.1675  --  float

Get/set the value in degrees of the "Altitude" spinner.

Not Exposed To The UI

<Sun_Positioner>.manual_sun_position     Point3    default: [11.0997,-8.89722,37.385]   --  animatable; point3

Get/set the position of the sun manually via MAXScript.