This XML file should only be used for documentation purposes. 0 xGraph xGraph Touch (Parameters() As TouchParameters) CursorPositionChanged (CursorIndex As Int, XIndex As Int) Initialize Callback Object EventName String DesignerCreateView Base Object Lbl Label Props Map Base_Resize Width Double Height Double DrawGraph Draws a graph DrawCurve Draws the curve with the given index Example code: <code>xGraph1.DrawCurve(2)</code> Index Int DrawCurves Draws the curves with the given indexes Example code: <code>xGraph1.DrawCurves(Array As Int(0,1,2,3))</code> Indexes Int SetSameScale Sets the scale of curve SameScaleCurveIndex for all curves SameScaleCurveIndex Int NumberFormat3 Formats numbers with a fixed number of digits and scientific notation String Number Double MaxDigits Int GetScaleAuto Gets the automatic scale for the given curve ScaleValues CurveIndex Int GetScaleManu Gets the manual scale for the given curve ScaleValues CurveIndex Int SetScaleManu Sets a manual scale for a given curve CurveIndex Int MinVal Double MaxVal Double SetZoomIndexes Sets the begin and end indexes for zoom diaplay BeginIndex Int EndIndex Int SetZoomMode Sets the zooming mode The user selects with the cursor the left limit and then the right limit SetCurveName Sets the a new name for the curve with the given index UpdateGraph = True redraws the graph CurveIndex Int Name String UpdateGraph Boolean SetCurveUnit Sets a new unit for the curve with the given index UpdateGraph = True redraws the graph CurveIndex Int Unit String UpdateGraph Boolean CopyCurve Copies the curve with SourceIndex to the DestinationIndex curve. SourceIndex Int DestinationIndex Int CalcAddValue Adds a value to the given cuve ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed CurveIndex Int Value Double ZoomedPartOnly Boolean CalcMultiplyByValue Multiplies the curve by the given value ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed CurveIndex Int Value Double ZoomedPartOnly Boolean CalcSum2Curves Adds two curves and copies the result in the destination curve Curve(DestinationIndex) = Curve(SourceIndex1) + Curve(SourceIndex2) ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed SourceIndex1 Int SourceIndex2 Int DestinationIndex Int ZoomedPartOnly Boolean CalcSubtract2Curves Substracts two curves and copies the result in the destination curve Curve(DestinationIndex) = Curve(SourceIndex1) - Curve(SourceIndex2) ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed SourceIndex1 Int SourceIndex2 Int DestinationIndex Int ZoomedPartOnly Boolean CalcMutiply2Curves Multiplies two curves and copies the result in the destination curve Curve(DestinationIndex) = Curve(SourceIndex1) * Curve(SourceIndex2) ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed SourceIndex1 Int SourceIndex2 Int DestinationIndex Int ZoomedPartOnly Boolean CalcDevide2Curves Devides two curves and copies the result in the destination curve Curve(DestinationIndex) = Curve(SourceIndex1) / Curve(SourceIndex2) ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed SourceIndex1 Int SourceIndex2 Int DestinationIndex Int ZoomedPartOnly Boolean CalcMeanValue Returns the mean value of the given curve ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed Double CurveIndex Int ZoomedPartOnly Boolean CalcRMSValue Returns the RMS value of the given curve ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed Double CurveIndex Int ZoomedPartOnly Boolean CalcDerivative Calculates the derivative of the source curve and saves the result in the destination curve ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed !!! This routine does not work with missing data !!! SourceIndex Int DestinationIndex Int ZoomedPartOnly Boolean CalcIntegral Calculates the integral of the source curve and saves the result in the destination curve ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed !!! This routine does not work with missing data !!! SourceIndex Int DestinationIndex Int InitilalCondition Double ZoomedPartOnly Boolean CalcSmooth Smooths the source curve and saves the result in the destination curve The Smooth method takes the mean value of the number of samples given in Span around a sample and saves it at the same index. Number of samples must be an odd number, if an even number is enterd its value is incremented by 1. Documentation: https://en.wikipedia.org/wiki/Moving_average ZoomedPartOnly = True calculates only the zoomed part if the curve is zoomed SmoothType = "MEAN" or "RMS" Be aware that with RMS smothing, and nagative values, you will get wrong data Example: <code>xGraph1.CalcSmooth(2, 4, 5, False, "MEAN")</code> SourceIndex Int DestinationIndex Int Span Int ZoomedPartOnly Boolean SmoothType String CalcSmoothExponentialLag Smooths the source curve and saves the result in the destination curve, sort of low pass filter The smoothing algorithm is a first order lag which implements an exponential response to a step input Kt must be smaller than 1.0 yd[t] = yd[t-1] + Kt (ys[t] - yd[t-1]) yd = destination ys = source Documentation: https://en.wikipedia.org/wiki/Exponential_smoothing Routine kindly provided by rgarnett1955 Example: <code>xGraph1.CalcSmoothExponentialLag(2, 4, 0.5, False)</code> SourceIndex Int DestinationIndex Int Kt Double ZoomedPartOnly Boolean CalcSmoothExponentialLead Smooths the source curve and saves the result in the destination curve, sort of high pass filter The smoothing algorithm is a first order lead which implements an step response and exponential decay to a step input. Kt must be smaller than 1.0 yd = Kt (ys[t]- yd[t-1]) ydLast = y[t-1] + yt yd = destination ys = source Routine kindly provided by rgarnett1955 Example: <code>xGraph1.CalcSmoothExponentialLead(2, 4, 0.5, False)</code> SourceIndex Int DestinationIndex Int Kt Double ZoomedPartOnly Boolean UnZoom SetCursor Sets one of the two cursors XIndex = sample index, in the curve array CursorIndex = 0 or 1, index of the cursor XIndex Int CursorIndex Int Color Int AddCursor Adds a cursor with the given color by touching the graph Color Int RemoveCursor Removes one or both cursors. Set Index = 0 or 1 as cursor index to delete one cursor Set Index = 2 to delete both cursors When you remove cursor(0) cursor(1) becomes cursor(0), it is removed from the list If there is only one Cursor, then any index value will remove the cursor. Index Int SetGraphToSynchronize If you have two xGraph objects you can synchronize them. Condition: the X scales must be the same Cursors and zoom are active on both objects GraphToSynchronize = xGraph object to synchronize SelectedGraphShow = True shows a line at the right side of the graph, with the SelectedGraphColor SelectedGraphColor = color of the line at the right side of the graph SynchronizeZoom = True synchronizes the zoom in both graphs = False you can have two different zoom levels in the two graphs DisplaySynchronizedZoomArea = True, when one graph is zoomed and the other not, displays the zoomed area in the other graph = False, does not display the zoomed area Example code: <code> xGraph1.SetGraphToSynchronize(xGraph2, True, xui.Color_Red, True) xGraph2.SetGraphToSynchronize(xGraph1, True, xui.Color_Blue, True)</code> To synchronize two xGraph objects, you need to add the two lines above in your code GraphToSynchronize xGraph SelectedGraphShow Boolean SelectedGraphColor Int SynchronizeZoom Boolean DisplaySynchronizedZoomArea Boolean DeSynchronize Desynchronizes two synchronized xGraph objects SelectGraph Sets the xGraph object to Selected or not Selected = True, draws a colored line at the right side. Selected = False, removes the colored line Used when two xGraph objects are synchronized Draws a line at the right side of the graph Selected Boolean mBase B4XView Tag Object NbMaxSamples Gets or sets the max number of samples Int NumberMaxSamples Int NbMaxCurves Gets or sets the max number of curves Int NumberMaxCurves Int NbSamples Gets or sets the current number of samples Int NumberSamples Int AutomaticYScales Gets or sets the automatic scales mode True displays automatic Y sacales for all curves False displays the manual scales Boolean AutomaticYScales Boolean Snapshot Returns a B4XBitmap object of the graph (read only) B4XBitmap CurvesToDisplay Gets or sets the curves to display List CurvesToDisplay List ScaleXValues Gets or sets the ScaleValues property it is a string with the different scale values separated by an exclamation mark. it must begin with 1! and end with !10 the default property is 1!2!2.5!5!10 these values can be selected in the Designer: 1!2!2.5!5!10|1!1.2!1.5!1.8!2!2.5!3!4!5!6!7!8!9!10 Example code: <code>xGraph1.ScaleXValues = "1!2!2.5!5!10"</code> String ScaleXValues String ScaleYValues Gets or sets the ScaleValues property used for automatic scales it is a string with the different scale values separated by the exclamation mark. it must begin with 1! and end with !10 the default property 1!2!2.5!5!10 These values can be selected in the Designer: 1!2!2.5!5!10|1!1.2!1.5!1.8!2!2.5!3!4!5!6!7!8!9!10 Example code: <code>xGraph1.ScaleXValues = "1!2!2.5!5!10"</code> String ScaleYValues String DisplayCurveUnit Gets or sets the DisplayCurveUnit property True displays the curve unit after the curve name Boolean DisplayCurveUnit Boolean DisplayCurveIndex Gets or sets the DisplayCurveIndex property True displays the curve index before the curve name Boolean DisplayCurveIndex Boolean Title Gets or sets the graph title String Title String XAxisName Gets or sets the x axis name String XAxisName String XAxisUnit Gets or sets the x axis unit String XAxisUnit String NbXIntervals Gets or sets the number of x axis intervals Int NbXIntervals Int NbYIntervals Gets or sets the number of y axis intervals Int NbYIntervals Int GraphColor Gets or sets the graph background color Int GraphColor Int GridColor Gets or sets the graph grid color Int GridColor Int GridFrameColor Gets or sets the graph grid frame color Int GridFrameColor Int OuterFrame Gets or sets the graph outer frame property True = draws an outer frame around the graph Boolean OuterFrame Boolean OuterFrameColor Gets or sets the graph outer frame color Int OuterFrameColor Int Left Gets or sets the Left property Int Left Int Top Gets or sets the Top property Int Top Int Width Gets or sets the Width property Int Width Int Height Gets or sets the Height property Int Height Int GraphLeft Gets the GraphLeft property The left position of the Graph in pixels Int GraphWidth Gets the GraphWidth property The width of the Graph in pixels Int GraphTop Gets the GraphTop property The top position of the Graph in pixels Int GraphHeight Gets the GraphHeight property The height of the Graph in pixels Int XIndexBegin Gets the XIndexBegin property Index of the first visible item Int XIndexEnd Gets the XIndexEnd property Index of the last visible item Int DrawCursorValues gets or sets the DrawCursorValues property Displays the values of the cuves at the cursor position Boolean DrawCursorValues Boolean GraphWithMissingData Gets or sets the GraphWithMissingDat property Manages curves with missing data, it is necessary to enter the MissingDataValue in place. Boolean GraphWithMissingData Boolean MissingDataValue Gets sets the MissingDataValue property Used when GraphWithMissingData = True, the missing data must be replaced by this value. Int MissingDataValue Int UseCustomColors Gets or sets the UseCustomColors property UseCustomColors = False, 4 colors and widths are used for superimpositions, they remain the same independant of the curves displayed UseCustomColors = True, one specific color and width can be defined for each curve Boolean UseCustomColors Boolean NumberOfCursors Gets the current number of cursors Int SynchronizeZoom When two xGraph objects are synchronized Synchronize the zoom in both graphs. Boolean Synchronize Boolean DisplaySynchronizedZoomArea When two xGraph objects are synchronized and when one graph is zoomed and the other not, True > displays the zoomed area in the other graph False > does not display the zoomed area in the other graph Boolean DisplaySynchronizedZoomArea Boolean 1.6 Klaus CHRISTL (klaus)