Visit Gigasoft's Web Site
 ProEssentials v10 Help

Gigasoft.ProEssentials.Pesgo.PeData Members

Always set Subsets and Points first, before passing data type properties such as X, Y, and Z below.

 

AppendToEnd

Only used in a Real-Time implementation. Gets or Sets whether data is appended to end or beginning of memory. See also: AppendYData.

AutoScaleData

Gets and Sets whether large/small data will be displayed with a scale factor. For example, a grid line value of 10,000,000 may be displayed as 10M if this property is true. M representing millions.

ComputeShader

Set to True to enable GPU side Direct3D chart construction. Currently limited to Pe3do PolyMode = SurfacePolygons and Pesgo PlottingMethod ContourColors, and Line. Only applicable with RenderEngine = Direct3D. 

DateTimeMilliSeconds

DateTime mode now support milliseconds. Major grid lines now go down to 1 millisecond. Set to TRUE to enable data prompts and exported data to show the millisecond portion of time.

DateTimeMode

This property enables DateTimeMode. This mode treats X axis data as serially formatted date/time data.

DateTimeShowSeconds

If Data.DateTimeMode is True, and data is exported via export dialog, this property controls whether seconds are included in time export. Also controls the data cursor prompt in top-left corner if shown.

DuplicateDataX

Used within 3D charts, 2D Contours, or any 2D Pesgo Pepso chart where all subsets or points use identical XData.  Providing a method of reducing data redundancy in constructing chart.

DuplicateDataY

Used within any chart where all subsets or points use identical YData.  Providing a method of reducing data redundancy in constructing chart.

DuplicateDataZ

Used within 3D charts, 2D Contours, or any 2D Pesgo Pepso chart where all subsets or points use identical ZData.  Providing a method of reducing data redundancy in constructing chart.

DateTimeShowSeconds

If Data.DateTimeMode is True, and data is exported via export dialog, this property controls whether seconds are included in time export. Also controls the data cursor prompt in top-left corner if shown.

DynamicBuffers

Set to true when RenderEngine = Direct3D and a real-time implementation will need to incrementally change data. Used in conjunction with properties RealTimeStartingIndex, RealTimeQuantity. These features are added to implement a chart with a very large amount of data, that needs to be updated incrementally but rapidly. Historically, for large data sets, the chart would become slower as more data was rendered causing the system to become less responsive over time. These new features avoid this concern. The one draw back to this feature is DynamicBuffers cause an extra delay upon initial initialization of the Direct3D buffers.

EndTime

This property sets the daily end time when used in conjunction with Data.SpecialDateTimeMode, Data.StartTime, and Data.DateTimeMode.

Filter2D

Used with Direct2D, Gets and Sets data reduction strength. Default=Quality. Setting to fastest setting could possibly degrade for scatter type charts but actually should be fine for most charts drawn left to right. 

Filter2D3D

Used with Direct3D and ComputeShader = True to enable a ComputeShader and parallelism to pre-filter 2D line data prior to sending to the final ComputeShader constructing scene.

FilterOn

Read only. True if image is a product of data reduction. PeData.Filter2D or PeData.Filter3D and Subsets/Points and size of chart all effect if FilterOn is True.

JaggedData

True, Subsets can contain varying amounts of Points.  False, All Subsets have the same number of Points.  For now limited to Pesgo, Pepso, Direct2D. 

NullDataValue

Gets and Sets the Y Data value considered null and subsequently ignored.

NullDataValueX

Gets and Sets the X Data value considered null and subsequently ignored.

NullDataValueZ

Gets and Sets the Z Data value considered null and subsequently ignored.

Pedo

ProEssentials Data Object interface. Used for incremental-data / real-time / strip-chart internet updating.

Points

Always set this property prior to passing Data.Y and/or Data.X. Gets or Sets quantity of data points per series. Example: for a line chart, this is the number of data points per line.

Precision

Set or Get the precision used within table, on-screen coordinate prompting and data exporting.

RandomPointsToGraph

Gets or Sets points to be included in image. Fill this array with zero based point indices of those points you wish to include in the image. Use RandomPointsToGraph.Clear() to show all points again.

RandomSubsetsToGraph

Gets or Sets subsets to be included in image. Fill this array with zero based subset indices of those subsets you wish to include in the image. Use RandomSubsetsToGraph.Clear() to show all subsets again.

RealTimeQuantity

Used when RenderEngine = Direct3D and DynamicBuffers set to True. Within the chart update event/timer logic, the developer will set this property to coincide with the quantity of new data indices updated. See example 138 in the demo/example project. This is a fairly specific use so your implementations will need to mimic example 138 closely. All subsets will be redrawn for the point range defined by RealTimeStartingIndex and RealTimeQuantity.  With the introduction of new ComputeShader logic, this feature might be less useful.

RealTimeStartingIndex

Used when RenderEngine = Direct3D and DynamicBuffers set to True. Within the chart update event/timer logic, the developer will set this property to coincide with the new data indices updated. See example 138 in the demo/example project. This is a fairly specific use so your implementations will need to mimic example 138 closely.

ReuseDataX

Set True if XData has not changed as part of a RenderEngine=Direct3D, ComputeShader=True real-time or continuously updating charting scenario/implementation.

ReuseDataY

Set True if YData has not changed as part of a RenderEngine=Direct3D, ComputeShader=True real-time or continuously updating charting scenario/implementation.

ReuseDataZ

Set True if ZData has not changed as part of a RenderEngine=Direct3D, ComputeShader=True real-time or continuously updating charting scenario/implementation.

ScaleForRYData

Gets the current scale factor as a power of 10 for the Right Y Axis. Only used if Data.AutoScaleData = True.

ScaleForTXData

Gets the current scale factor as a power of 10 for the top X Axis. Only used if Data.AutoScaleData = True.

ScaleForXData

Gets the current scale factor as a power of 10 for the bottom X Axis. Only used if Data.AutoScaleData = True.

ScaleForYData

Gets the current scale factor as a power of 10 for the Y Axis. Only used if Data.AutoScaleData = True.

SeqentialDataX

Gets and Sets if data can potentially be optimized. Default=Auto. This setting can be used to disable or force filtering. Most likely you may need to disable in some rare types of implementations.

SeqentialDataY

Gets and Sets if data can potentially be optimized. Default=Auto. This setting can be used to disable or force filtering. Sequential data in y direction is mostly used in 2d contours, and 3d surfaces 3d contours. X data is most commonly optimized.

SpecialDateTimeMode

SpecialDateTime mode produces a date/time x axis scale which only shows time between Data.StartTime and Data.EndTime. This produces a discontinuous x axis scale. This mode is only valid for time spans which are limited to include one weekend. Date.DateTimeMode must also be set to True. See help for more info.

SpeedBoost

Gets and Sets speedboost value. Default is 3. Valid range is 1 to 100 but best results are produced with values less than 30. This feature will attempt to reduce GDI LineTo calls by eliminating calls where the line only moves slightly from its previous position.

StagingBufferX

Set True if repeatedly changing XData as part of a real-time updating scenario/implementation. True = enable staging buffer logic for XData.  Will use additional video/system memory. False = Direct3D buffers are possibly recreated per update and data will not transfer as fast.

StagingBufferY

Set True if repeatedly changing YData as part of a real-time updating scenario/implementation. True = enable staging buffer logic for YData.  Will use additional video/system memory. False = Direct3D buffers are possibly recreated per update and data will not transfer as fast.

StagingBufferZ

Set True if repeatedly changing ZData as part of a real-time updating scenario/implementation. True = enable staging buffer logic for ZData.  Will use additional video/system memory. False = Direct3D buffers are possibly recreated per update and data will not transfer as fast.

StartTime

This property sets the starting date and daily start time when used in conjunction with Data.DateTimeMode, Data.AutoXData, Data.DeltaX, and Data.DeltasPerDay. It is important that this value include the date value along with time.

SubsetByPoint

Gets and Sets how two dimensional property arrays (example, Data.Y, Data.X) are stored internally. If you will be adjusting the number of Subsets and/or Points and want to preserve existing data, read the help on this property.

Subsets

Always set this property prior to passing Data.Y and/or Data.X. Gets or Sets quantity of data series. Example: for a line chart, this is the number of lines with different colors.

SubsetsToShow

This property array makes it easier to select which subsets are visible. It also has a second optional ability to control the order of how subsets are drawn.

UsingXDataii

If setting this property, set it before passing data. Gets and Sets whether single or double precision data is utilized. Set to true to use double precision (Data.Xii) instead of (Data.X).

UsingYDataii

If setting this property, set it before passing data. Gets and Sets whether single or double precision data is utilized. Set to true to use double precision (Data.Yii) instead of (Data.Y).

X

You must set Data.Subsets and Data.Points before passing this data. Gets or Sets single precision data plotted with respect to x axis. PieChart (Pepco) uses this for controlling slice size. Pego only uses x data for Date-Time handling.

Xii

You must set Data.UsingXDataII=true, Data.Subsets and Data.Points before pass this data. Gets or Sets double precision data plotted with respect to x axis. Pego object only uses xdata for DateTime handling.

Y

You must set Data.Subsets and Data.Points before passing this data. Gets or Sets single precision data plotted with respect to y axis.

Yii

You must set Data.UsingYDataII=true, Data.Subsets and Data.Points before pass this data. Gets or Sets double precision data plotted with respect to y axis.

Z

You must set Data.Subsets and Data.Points before passing this data. Gets or Sets single precision data used with floating bar charts.