LightningChart Ultimate v.8.4 LightningChart Ultimate NEW … · 2019-05-02 · LightningChart...

LightningChart Ultimate

v.8.4


v.8.4


v.8.4


v.8.4

NEW FEATURES

NEW FEATURES

NEW FEATURES

NEW FEATURES

1

LightningChart Ultimate v.8.4

NEW FEATURES

LightningChart Ultimate v.8.4 New Features:

1. Margin improvements ............................................................................................................ 2

2. Zooming improvements ......................................................................................................... 4

3. Legend box auto-positioning in all views ......................................................................... 6

4. Faster orthographic projection............................................................................................ 7

5. New camera orientation and rotation system ............................................................... 9

6. New 3D coordinate space converters ............................................................................ 10

7. PointLineSeries3D performance improvements ............................................................ 12

8. Debugging features ............................................................................................................. 13

9. Demo application changes ............................................................................................... 14

10. Usage improvements ........................................................................................................ 16

2


NEW FEATURES

1. Margin improvements

• Margins are now available in all views.

Margins are added to View3D and ViewPie3D, and modified in ViewPolar and

ViewSmith by changing how zooming affects them (see ZoomPadding in the

next chapter). MarginsChanged event can also be used in all views.

• Clipping via margins in all views.

Clipping feature is added to polar, smith, pie and 3D views. The contents of

the view are now clipped outside the margins. ViewXY’s old

GraphBorderColor and GraphBorderOverSeries properties are replaced by a

new customizable property, Border, which displays the location of the

margins. It is available in all views, but set visible by default only in ViewXY.

Margins in ViewPolar. A border rectangle is enabled, indicating the location of the margins.

3


NEW FEATURES

Clipping feature in View3D. Contents are clipped outside the margins, indicated by Border property.

4


NEW FEATURES

2. Zooming improvements

• ZoomPanOptions has a new ZoomPadding feature, which defines the amount of

empty space left between the zoomed area and the margins after certain

zooming operations. ZoomPadding is accessible in 3D, pie3D, polar and smith views.

• ZoomToDataAndLabelsArea operation is now available in View3D

In View3D, ZoomToDataAndLabels operation causes the available area

limited by margins and the new ZoomPadding feature, to be used as

optimally as possible by moving the camera. Axes, labels, data and markers

are all kept visible.

A new property, LeftDoubleClickAction in ZoomPanOptions is set by default as

ZoomToDataAndLabels, meaning double-clicking the mouse left button

activates the operation.

ZoomToDataAndLabelsArea -operation in View3D. The contents of the view are fitted inside the margins. ZoomPadding is set to 0 for all edges, thus no space is left between the data/labels and the margins. Border.Visible has been set True.

5


NEW FEATURES

• Zooming on polar and smith views modified

A new zooming action, ZoomToLabelsArea moves the view point to show the

whole data frame inside the margins (taking into account the new

ZoomPadding feature). Furthermore, FitView has been renamed to

ZoomToData.

• Calling zooming methods in 3D, pie3D, polar and smith views unified.

ZoomToFit() now takes a parameter, meaning zooming to various areas is

called via ZoomToFit(ZoomArea3D/ZoomAreaRound.AreaName). For

example, ZoomToDataAndLabels in view3D is called via

View3D.ZoomToFit(ZoomArea3D.DataAndLabelsArea). This also allows more

specific zooming areas to be added in the future.

Polar chart before and after zooming operation, ZoomPadding = 50. On top, the chart has been manually zoomed but no zoom operation has been called; ZoomPadding has no effect. Below, ZoomToLabelsArea was used, which takes into account the labels when zooming.

6


NEW FEATURES

3. Legend box auto-positioning in all views

• Auto-positioning legend boxes is now possible in all views.

Similarly to ViewXY, legend boxes of View3D, ViewPie3D, ViewPolar and

ViewSmith can be placed automatically. The position of the legend box can

be controlled with Position property. Some options allow taking margins into

account.

Offset property can be used to shift the position by given amount from the

position determined by Position property.

Positioning options for legend box. Graph.. options place the legend box inside the margins.

7


NEW FEATURES

4. Faster orthographic projection

• Added a new, faster version of orthographic projection, which no longer is based

on changing dimensions.

The projection type can now be selected with View3D.Camera.Projection

property. It replaces the old OrthographicCamera Boolean, which is still

available but marked obsolete. Setting the old value to true sets projection to

the new orthographic camera.

The old orthographic projection used in v8.3 and before is still accessible as

OrthographicLegacy option.

8


NEW FEATURES

New Orthographic projection compared to earlier version, now called OrthographicLegacy. Earlier object size stayed the same when 3D dimensions were changed.

9


NEW FEATURES

5. New camera orientation and rotation system

• Added a new camera orientation mode with improved camera orientation

definition.

The new mode called ZXY_Extrinsic (the name defines in which order the

dimension are calculated) is now set to be the default orientation mode. The

old orientation mode, XYZ_Mixed, is still available but will most likely become

deprecated at some point in the future. Orientations can be accessed via

View3D.Camera.OrientationMode.

Rotations are also modified by this change. With the new camera orientation

mode, one of the axis directions (world unit vectors) is used as the horizontal

mouse rotation axis. This is the axis of which the camera is rotated around. Axis

determination is automatically done when RotationX, RotationY or RotationZ

properties are changed. Closest axis to the camera’s up direction is selected

as the rotation axis, so that the rotations feel as natural as possible on all

occasions.

The new orientation and rotation model allow views to the 3D scene that

were previously impossible.

10


NEW FEATURES

6. New 3D coordinate space converters

• Cylindrical coordinate space converters

Added a 3D converter class, which converts between Cartesian 3D and

Cylindrical 3D coordinates. Cylindrical points are defined by CylindricalPoint

objects, which contains the following fields:

o Distance: Distance along XZ plane

o Y: Y value

o Angle: Heading angle, also called as azimuth and absolute bearing

Use CylindricalCartesian3D.ToCartesian() and

CylindricalCartesian3D.ToCylindrical() -methods to convert between the

coordinate types.

Example created with CylindricalCartesian3D converter. Data points of SurfaceMeshSeries3D and grid are defined in Cylindrical 3D coordinates.

11


NEW FEATURES

• Spherical coordinate space converters

This class converts between Cartesian 3D and Spherical 3D coordinates.

Spherical points are defined by SphericalPoint objects, which contain the

following fields:

o Distance: Distance from origin (0,0,0)

o ElevationAngle: Elevation angle. Also called as Elevation or Altitude,

measured from XZ plane.

o HeadingAngle: Heading angle. Also called as azimuth and absolute

bearing

Use SphericalCartesian3D.ToCartesian() and

SphericalCartesian3D.ToCylindrical() -methods to convert between the

coordinate types.

Example created with SphericalCartesian3D converter. Data points of SurfaceMeshSeries3D and grid are defined in Spherical 3D coordinates.

12


NEW FEATURES

7. PointLineSeries3D performance improvements

• Improved performance and added individual point coloring option when showing

a large amount of data (millions of points).

New PointsCompactColored property enables low memory consumption

while still allowing coloring the data points with individual colors. It uses

SeriesPointCompactColored3D structure, which has the following fields:

o float X: X axis value

o float Y: Y axis value

o float Z: Z axis value

o int Color: color of the point

• Drawing 2D shape points in View3D is now based on the z order of the points, which

also improves the performance.

• The new SeriesPointCompactColored3D are now available also for fully bindable

WPF as well as the already existing SeriesPointCompact3D structure.

120 million of scatter points using PointsCompactColored. IndividualPointsColoring is set True.

13


NEW FEATURES

8. Debugging features

Multiple changes are made to help with debugging LightningChart on situations where

chart does not behave as expected. With the new system, it is easier to gather all

required information to deliver to our support, as well as to track notifications from

chart to understand what is happening.

• Added new ChartMessage event to replace ChartError event

ChartMessage has a ChartMessageInfo struct as a parameter, which contains

detailed information about the event. The messages are grouped by

ChartMessageInfo’s MessageSeverity property, which tells how severe the

message is. MessageType property explains the basic type of the message

and Details property has more specific information about it.

ChartError is still available, but it is recommended to use ChartMessage as it

contains more information.

• Automatic severity-based filtering for ChartMessage

Unwanted ChartMessages can be filtered by changing the

chart.Options.ChartMessageMinimumLevel property value. This allows only

messages of the minimum level and higher to be sent through the event

system.

• Automatic debug information gathering on messages and exceptions

ChartMessages and ChartExceptions include more statistics and background

information, which are collected automatically. The debug information

gathering tools are also available as methods under ChartTools.

The gathered information can be attached to a support request or a bug

report and sent to Arction, which helps the support process.

14


NEW FEATURES

9. Demo application changes

• Generic changes

Demo applications have been modified to use the new features presented

above. The new default 3D orientation mode, ZXY_Extrinsic, has been

applied. It is also possible to change 3D projection type on many examples to

test the new orthographic mode.

• New examples

In addition to spherical and cylindrical conversion examples, two other new

examples were added: Polar Wind Rose Chart and Stock Course with Previous

Close Indicator.

New example: Polar Wind Rose Chart and Stock Course with Previous Close Indicator.

15


NEW FEATURES

New example: Stock Course with Previous Close Indicator.

16


NEW FEATURES

10. Usage improvements

• The following minor tweaks have been implemented:

o Improved API help documentation.

o Optimized candlesticks are used by default in Stock series for

performance reasons.

o New math helper methods accessible via MathRoutines:

AngleDegInFirstFullCircle, AngleDegInFirstFullCircle, AngleDiffDeg,

AngleDiffRad

o Automatic annotation size calculations improved.

o Improved compatibility with antivirus software.

• Improved per-monitor DPI window size handling

On default, LightningChart will not resize when moved to another screen with

different DPI settings. To enable resizing,

AllowDPIChangeInduceWindowsResize property under ChartOptions needs to

be set true. Alternatively, user can register to OnDPIChanged event and

change its allowWindowResize attribute.

If you have any questions, please contact us at [email protected]

Thanks for being our customer, happy coding! :-)

LightningChart Ultimate v.8.4 LightningChart Ultimate NEW … · 2019-05-02 · LightningChart...

Documents

Transcript of LightningChart Ultimate v.8.4 LightningChart Ultimate NEW … · 2019-05-02 · LightningChart...