ILNumerics Ultimate VS

SettingsDefaultRenderer Property

ILNumerics Ultimate VS Documentation
ILNumerics - Technical Application Development
Configures or defines the default renderer used for interactive drawing controls like ILPanel, default: null (auto)

[ILNumerics Core Module]

Namespace:  ILNumerics
Assembly:  ILNumerics.Core (in ILNumerics.Core.dll) Version: 5.5.0.0 (5.5.7503.3146)
Syntax

public static Nullable<RendererTypes> DefaultRenderer { get; set; }

Property Value

Type: NullableRendererTypes
Remarks

By default, ILNumerics selects the optimal renderer for interactive panels (ILNumerics.Drawing) automatically. For situations where this does not work efficiently, the user is able to define the default renderer manually by setting this flag, either via app.config or programmatically.

The setting will be considered for all panels created with ILNumerics at a later point.

When setting this property via app.config, use the key 'ILNDefaultRenderer' and provide it one of the values of the RendererTypes enum. Valid values are any available interactive renderer:

  • GDI
  • OpenGL
  • DirectX

Using no setting signals ILNumerics to determine the optimal renderer automatically. This will cause OpenGL to be used. In a later version, on Windows it will default to DirectX.

Keep in mind, the actual type of the renderer used at runtime may differs from that setting, since ILNumerics prevents from known situations where certain renderers are not working properly.

ILNuerics provides the following options to determine the actual renderer used for ILPanel. Settings are applied in the following order. Subsequent settings may override values which were set earlier.

  • ILNumerics.Settings, applied via app.config value 'ILNDefaultRenderer'
  • ILNumerics.Settings, applied programmatically:
    Settings.DefaultRenderer = ...
  • Individual driver configuration for each
    ILPanel
    :
    ILPanel.Driver = ... RendererTypes.OpenGL /  ...

[ILNumerics Core Module]

See Also

Reference