Stores and buffers an overview of the incoming signal.
The size of the preview is maintained small enough to allow quick redraw on a chart. At start the component holds the actual signal up to the size of the SpanLimit. Once SpanLimit is exceeded an overview of the signal is computed and the original is discarded. From that point on, only the overview of the signal is kept. Once the overview exceeds the SpanLimit a new signal overview is computed from the existing overview and this procedure repeats in to infinity allowing virtually unlimited length of the overview. The component allow's limited zoom-in in to the overview, because intermediate results are discarded, but the data discarded will not exceed a factor of sqr(Increment). The default value for increment is 20 and 20^2 = 400. For a 2GB long recording this will result in 5MB of the in-memory buffer. On the resulting overview PixelDownSample method should be applied again. For true navigation use TSignalBrowse component.
The purpose of this component is to allow an overview of already recorded data to be displayed to the user. The IsOverview function returns true, if the component stores an overview, otherwise it is still buffering the original signal. This is important to know because the drawing method may differ substantially for signal and overview. The overview stores Max and Min values interleaved. The Max values form the upper and the Min values from the lower envelope.
Calling Update or Pull method will return pipeOK, if the Data property has been updated. It will return pipeStream, if there is not enough data buffered yet to update.
| Name | Type | Description |
|---|
| Active | bool | Set active to false to suppress the propagation of the Pull request and the subsequent call to the Update method. |
| BandWidth | double | Return the bandwidth of the signal. |
| BandwidthH | double | Returns the upper bandwidth edge of the signal. |
| BandwidthL | double | Returns the lower bandwidth edge of the signal. |
| BlockAssign | bool | Block streaming of specific properties when storing only a "template". |
| ChannelCount | int | Get or set the number of channels multiplexed in the data property. |
| Complex | bool | Set this property to true, to request computation using complex numbers. |
| Continuous | bool | If True, the component will pass on the udpate request to the connected component. |
| Data | TVec* | Stores the result of the processing. |
| Dt | double | Time between two consecutive samples. |
| EditorActive | bool | Returns True, if the component editor is displayed. |
| FloatPrecision | TMtxFloatPrecision | Set this property to request computation in 32bit/64bit precision with real/complex numbers. |
| FloatPrecisionLock | bool | Set this property to true to lock changes to FloatPrecision property. |
| HzRes | double | Frequency resolution obtained, if an FFT algorithm would be run on the data. |
| Increment | int | Defines the increment at which the overview is sampled. |
| Input | TSignal* | |
| Inputs | TSignalCollection* | |
| IsDouble | bool | Set this property to false, to request computation in 32bit floating point precision, 64bit, if true. |
| ItemNumber | int | Number to label the object when it is an item in the List. |
| Length | int | Get or set the length of the signal in samples. |
| Marks | TMarkList* | Stores the time stamps and amplitude of selected samples. |
| MaxAmplt | double | Stores the maximum amplitude of the signal found by the MinMax method. |
| MaxX | double | Use the MaxX property to store the time stamp (in seconds) of the right most sample. |
| MinAmplt | double | Stores the minimum amplitude of the signal found by the MinMax method. |
| MinX | double | Use the MinX property to store the time stamp of the left-most sample. |
| MultiChannel | bool | Set MultiChannel to True, if Inputs property will be published, and Input property will remain hidden. |
| Name | DewString | |
| OnAfterUpdate | tNotifyEvent | The event is triggered after the call to the Update method. |
| OnBeforeUpdate | tNotifyEvent | The event is triggered just before the call to the Update method. |
| OnDisplayUpdate | tNotifyEvent | The event is triggered after the OnAfterUpdate event. Use this event to update any associated charts or graphs or result tables. |
| OnGetInput | tNotifyEvent | If the Input property is not assigned, the component will call OnGetInput. |
| OnNotifyUpdate | tNotifyEvent | The event is called after a call to InternalUpdate, OnAfterUpdate and OnDisplayUpdate from within the Update method. |
| OnParameterUpdate | tNotifyEvent | The event is triggered when ParamUpdate method is called. The ParamUpdate method is usually called by component editors when a value was changed by the user and the editor was "Live". |
| PipeDirty | bool | |
| PipeState | TPipeState | Returns the state of the pipe after the last update. |
| Reference | TReferenceList* | Stores a list of components that have to be notified, when this component is destroyed. |
| SamplingFrequency | double | Defines the sampling frequency of the signal. |
| SamplingTime | double | The length of the signal in seconds. |
| SpanLimit | int | Defines the samples count at which an overview is computed. |
| SuspendNotifyUpdate | bool | Set this property to True, to prevent calling OnNotifyUpdate from the Update Method. |
| UsesInputs | bool | Set it to True to indicate, that valid signals will be connected to the Input or Inputs properties. |