class
FoliageSettings
Settings for the BillboardMode: Foliage
Properties
Property | Description |
Name | The name of the FoliageSettings object. (Inherited from Object) |
SeparateFoliageAreaThreshold | Is used to separate the trunk from the foliage in a vegetation scene by finding each group of connected triangles in the scene and if the surface area is below (SeparateFoliageAreaThreshold * AreaOfTheLargestGroupInTheScene) it is treated as foliage and processed into billboards. The trunk is optimized using reduction. The range is 0->large value. 0 means nothing will be foliage, value larger than the maximum surface area means everything will be foliage. |
SeparateFoliageSizeThreshold | Is used to separate the trunk from the foliage in a vegetation scene by finding each group of connected triangles in the scene and if the diameter of the group is below (SeparateFoliageSizeThreshold * SceneDiameter) it is treated as foliage and processed into billboards. The trunk is optimized using reduction. The range is 0->large value. 0 means nothing will be foliage, value larger than the scene's diameter means everything will be foliage. |
SeparateFoliageTriangleRatio | Is used to separate the trunk from the foliage in a vegetation scene by comparing each group of connected triangles in the scene with the scene's largest group. If a group's triangle count is below SeparateFoliageTriangleRatio * largestGrouptriangleCount it is treated as foliage and processed into billboards. The trunk is optimized using triangle reduction. The range is 0.0->1.0. 0.0 means nothing will be foliage, 1.0 means everything will be foliage. |
SeparateFoliageTriangleThreshold | Is used to separate the trunk from the foliage in a vegetation scene by finding each group of connected triangles in the scene and if the triangle count is below SeparateFoliageTriangleThreshold it is treated as foliage and processed into billboards. The trunk is optimized using reduction. The range is 0->large value. 0 means nothing will be foliage, value larger than the maximum triangle count means everything will be foliage. |
SeparateTrunkAndFoliage | Determines whether to enable separation between foliage and trunk in a vegetation scene. Use the SeparateFoliage[...] settings to determine how parts are separated. |
TrunkReductionRatio | Determines the triangle reduction ratio for the trunk part that has been separated from the foliage part based on the "separate foliage" settings. |
Methods
Method | Description |
AddObserver | Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object) |
GetBoolParameter | Get a named parameter boolean value. (Inherited from SettingsObject) |
GetClass | Get the name of the FoliageSettings class. (Inherited from Object) |
GetDoubleParameter | Get a named parameter floating point value. (Inherited from SettingsObject) |
GetErrorString | Returns a string describing the error that was found the last time ValidateSettings was performed. (Inherited from SettingsObject) |
GetIntParameter | Get a named parameter integer value. (Inherited from SettingsObject) |
GetStringParameter | Get a named parameter string value. (Inherited from SettingsObject) |
GetUIntParameter | Get a named parameter unsigned integer value. (Inherited from SettingsObject) |
IsA | Returns true if FoliageSettings is a or is a descendant of the class named as the type parameter. (Inherited from Object) |
IsNull | Returns true if the FoliageSettings object is invalid. (Inherited from Object) |
IsSameObjectAs | Returns true if the FoliageSettings object is valid. (Inherited from Object) |
NonNull | Returns true if the FoliageSettings object is valid. (Inherited from Object) |
PrintInfo | Prints the content/info of the FoliageSettings object to the log. (Inherited from Object) |
RemoveObserver | Removes a previously added observer object. (Inherited from Object) |
SetBoolParameter | Set a named parameter boolean value. (Inherited from SettingsObject) |
SetDoubleParameter | Set a named parameter floating point value. (Inherited from SettingsObject) |
SetIntParameter | Set a named parameter integer value. (Inherited from SettingsObject) |
SetStringParameter | Set a named parameter string value. (Inherited from SettingsObject) |
SetUIntParameter | Set a named parameter unsigned integer value. (Inherited from SettingsObject) |
SetValidateParameterNames | Set if parameter names should be validated or not. Parameters that previously do not exist will generate and error if validation is enabled and be allowed if validation is disabled. (Inherited from SettingsObject) |
ToJSON | Get settings as JSON for debugging purposes. (Inherited from SettingsObject) |
ValidateSettings | Validates the current settings values. (Inherited from SettingsObject) |
Static methods
Method | Description |
IsClassA | Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object) |
SafeCast | SafeCast makes sure the input object is of a class that can be cast into spFoliageSettings, and if this is the case, returns the object cast into spFoliageSettings. (Inherited from Object) |
Properties details
Name
The name of the FoliageSettings object. (Inherited from Object)
Syntax
SetName parameters
Type | Name | Min | Max | Description |
const char * | name | | | New name of the object. |
GetName return value
Type: spString
Syntax
SetName parameters
Type | Name | Min | Max | Description |
string | name | | | New name of the object. |
GetName return value
Type: string
Syntax
SetName parameters
Name | Type | Min | Max | Description |
name | str | | | New name of the object. |
GetName return value
Type: str
SeparateFoliageAreaThreshold
Is used to separate the trunk from the foliage in a vegetation scene by finding each group of connected triangles in the scene and if the surface area is below (SeparateFoliageAreaThreshold * AreaOfTheLargestGroupInTheScene) it is treated as foliage and processed into billboards. The trunk is optimized using reduction. The range is 0->large value. 0 means nothing will be foliage, value larger than the maximum surface area means everything will be foliage.
Syntax
SetSeparateFoliageAreaThreshold parameters
Type | Name | Min | Max | Description |
real | value | 0 | REAL_MAX | The new value. |
GetSeparateFoliageAreaThreshold return value
Type: real
Default: 0.1
Syntax
SetSeparateFoliageAreaThreshold parameters
Type | Name | Min | Max | Description |
float | value | 0 | REAL_MAX | The new value. |
GetSeparateFoliageAreaThreshold return value
Type: float
Default: 0.1
Syntax
SetSeparateFoliageAreaThreshold parameters
Name | Type | Min | Max | Description |
value | float | 0 | REAL_MAX | The new value. |
GetSeparateFoliageAreaThreshold return value
Type: float
Default: 0.1
SeparateFoliageSizeThreshold
Is used to separate the trunk from the foliage in a vegetation scene by finding each group of connected triangles in the scene and if the diameter of the group is below (SeparateFoliageSizeThreshold * SceneDiameter) it is treated as foliage and processed into billboards. The trunk is optimized using reduction. The range is 0->large value. 0 means nothing will be foliage, value larger than the scene's diameter means everything will be foliage.
Syntax
SetSeparateFoliageSizeThreshold parameters
Type | Name | Min | Max | Description |
real | value | 0 | REAL_MAX | The new value. |
GetSeparateFoliageSizeThreshold return value
Type: real
Default: 0.1
Syntax
SetSeparateFoliageSizeThreshold parameters
Type | Name | Min | Max | Description |
float | value | 0 | REAL_MAX | The new value. |
GetSeparateFoliageSizeThreshold return value
Type: float
Default: 0.1
Syntax
SetSeparateFoliageSizeThreshold parameters
Name | Type | Min | Max | Description |
value | float | 0 | REAL_MAX | The new value. |
GetSeparateFoliageSizeThreshold return value
Type: float
Default: 0.1
SeparateFoliageTriangleRatio
Is used to separate the trunk from the foliage in a vegetation scene by comparing each group of connected triangles in the scene with the scene's largest group. If a group's triangle count is below SeparateFoliageTriangleRatio * largestGrouptriangleCount it is treated as foliage and processed into billboards. The trunk is optimized using triangle reduction. The range is 0.0->1.0. 0.0 means nothing will be foliage, 1.0 means everything will be foliage.
Syntax
SetSeparateFoliageTriangleRatio parameters
Type | Name | Min | Max | Description |
real | value | 0.0 | 1.0 | The new value. |
GetSeparateFoliageTriangleRatio return value
Type: real
Default: 0.01
Syntax
SetSeparateFoliageTriangleRatio parameters
Type | Name | Min | Max | Description |
float | value | 0.0 | 1.0 | The new value. |
GetSeparateFoliageTriangleRatio return value
Type: float
Default: 0.01
Syntax
SetSeparateFoliageTriangleRatio parameters
Name | Type | Min | Max | Description |
value | float | 0.0 | 1.0 | The new value. |
GetSeparateFoliageTriangleRatio return value
Type: float
Default: 0.01
SeparateFoliageTriangleThreshold
Is used to separate the trunk from the foliage in a vegetation scene by finding each group of connected triangles in the scene and if the triangle count is below SeparateFoliageTriangleThreshold it is treated as foliage and processed into billboards. The trunk is optimized using reduction. The range is 0->large value. 0 means nothing will be foliage, value larger than the maximum triangle count means everything will be foliage.
Syntax
SetSeparateFoliageTriangleThreshold parameters
Type | Name | Min | Max | Description |
unsigned int | value | 0 | UINT_MAX | The new value. |
GetSeparateFoliageTriangleThreshold return value
Type: unsigned int
Default: 10
Syntax
SetSeparateFoliageTriangleThreshold parameters
Type | Name | Min | Max | Description |
uint | value | 0 | UINT_MAX | The new value. |
GetSeparateFoliageTriangleThreshold return value
Type: uint
Default: 10
Syntax
SetSeparateFoliageTriangleThreshold parameters
Name | Type | Min | Max | Description |
value | int | 0 | UINT_MAX | The new value. |
GetSeparateFoliageTriangleThreshold return value
Type: int
Default: 10
SeparateTrunkAndFoliage
Determines whether to enable separation between foliage and trunk in a vegetation scene. Use the SeparateFoliage[...] settings to determine how parts are separated.
Syntax
SetSeparateTrunkAndFoliage parameters
Type | Name | Min | Max | Description |
bool | value | | | The new value. |
GetSeparateTrunkAndFoliage return value
Type: bool
Default: false
Syntax
SetSeparateTrunkAndFoliage parameters
Type | Name | Min | Max | Description |
bool | value | | | The new value. |
GetSeparateTrunkAndFoliage return value
Type: bool
Default: false
Syntax
SetSeparateTrunkAndFoliage parameters
Name | Type | Min | Max | Description |
value | bool | | | The new value. |
GetSeparateTrunkAndFoliage return value
Type: bool
Default: false
TrunkReductionRatio
Determines the triangle reduction ratio for the trunk part that has been separated from the foliage part based on the "separate foliage" settings.
Syntax
SetTrunkReductionRatio parameters
Type | Name | Min | Max | Description |
real | value | 0.0 | 1.0 | The new value. |
GetTrunkReductionRatio return value
Type: real
Default: 0.5
Syntax
SetTrunkReductionRatio parameters
Type | Name | Min | Max | Description |
float | value | 0.0 | 1.0 | The new value. |
GetTrunkReductionRatio return value
Type: float
Default: 0.5
Syntax
SetTrunkReductionRatio parameters
Name | Type | Min | Max | Description |
value | float | 0.0 | 1.0 | The new value. |
GetTrunkReductionRatio return value
Type: float
Default: 0.5
Methods details
AddObserver
Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
Observer | observer | | | Observer is the object that will receive events. |
Return value
Type: rid
Syntax
Parameters
Type | Name | Min | Max | Description |
Observer | observer | | | Observer is the object that will receive events. |
Return value
Type: int
Syntax
Parameters
Name | Type | Min | Max | Description |
observer | Observer | | | Observer is the object that will receive events. |
Return value
Type: int
GetBoolParameter
Get a named parameter boolean value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: bool
GetClass
Get the name of the FoliageSettings class. (Inherited from Object)
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: spString
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: string
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: str
GetDoubleParameter
Get a named parameter floating point value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: double
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: double
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: float
GetErrorString
Returns a string describing the error that was found the last time ValidateSettings was performed.
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: spString
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: string
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: str
GetIntParameter
Get a named parameter integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: int
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: int
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: int
GetStringParameter
Get a named parameter string value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: spString
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: string
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: str
GetUIntParameter
Get a named parameter unsigned integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: unsigned int
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: uint
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: int
IsA
Returns true if FoliageSettings is a or is a descendant of the class named as the type parameter. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | type | | | Name of the class to check if FoliageSettings is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | type | | | Name of the class to check if FoliageSettings is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
type | str | | | Name of the class to check if FoliageSettings is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the FoliageSettings object is invalid. (Inherited from Object)
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
IsSameObjectAs
Returns true if the FoliageSettings object is valid. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to compare with. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to compare with. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
object | Object | | | Object to compare with. |
Return value
Type: bool
NonNull
Returns true if the FoliageSettings object is valid. (Inherited from Object)
Syntax
Parameters
NonNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
NonNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
NonNull takes no parameters.
Return value
Type: bool
PrintInfo
Prints the content/info of the FoliageSettings object to the log. (Inherited from Object)
Syntax
Parameters
PrintInfo takes no parameters.
Syntax
Parameters
PrintInfo takes no parameters.
Syntax
Parameters
PrintInfo takes no parameters.
RemoveObserver
Removes a previously added observer object. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | observerId | | | ObserverId is the id returned by AddObserver when the observer was added. |
Syntax
Parameters
Type | Name | Min | Max | Description |
int | observerId | | | ObserverId is the id returned by AddObserver when the observer was added. |
Syntax
Parameters
Name | Type | Min | Max | Description |
observerId | int | | | ObserverId is the id returned by AddObserver when the observer was added. |
SetBoolParameter
Set a named parameter boolean value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
bool | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
bool | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | bool | | | New value for parameter. |
Return value
Type: bool
SetDoubleParameter
Set a named parameter floating point value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
double | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
double | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | float | | | New value for parameter. |
Return value
Type: bool
SetIntParameter
Set a named parameter integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
int | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
int | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | int | | | New value for parameter. |
Return value
Type: bool
SetStringParameter
Set a named parameter string value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
const char * | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
string | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | str | | | New value for parameter. |
Return value
Type: bool
SetUIntParameter
Set a named parameter unsigned integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
unsigned int | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
uint | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | int | | | New value for parameter. |
Return value
Type: bool
SetValidateParameterNames
Set if parameter names should be validated or not. Parameters that previously do not exist will generate and error if validation is enabled and be allowed if validation is disabled.
Syntax
Parameters
Type | Name | Min | Max | Description |
bool | validate | | | Flag indicating if validation is performed or not. |
Syntax
Parameters
Type | Name | Min | Max | Description |
bool | validate | | | Flag indicating if validation is performed or not. |
Syntax
Parameters
Name | Type | Min | Max | Description |
validate | bool | | | Flag indicating if validation is performed or not. |
ToJSON
Get settings as JSON for debugging purposes.
Syntax
Parameters
ToJSON takes no parameters.
Return value
Type: spString
Syntax
Parameters
ToJSON takes no parameters.
Return value
Type: string
Syntax
Parameters
ToJSON takes no parameters.
Return value
Type: str
ValidateSettings
Validates the current settings values.
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Static methods details
IsClassA
Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
type | str | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
SafeCast
SafeCast makes sure the input object is of a class that can be cast into spFoliageSettings, and if this is the case, returns the object cast into spFoliageSettings. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: FoliageSettings
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: FoliageSettings
Syntax
Parameters
Name | Type | Min | Max | Description |
object | Object | | | Object to cast. |
Return value
Type: FoliageSettings