Visit Gigasoft's Web Site
 ProEssentials v9 Help

PEpartialresetimage

BOOL PEpartialresetimage (hObject, nStartingPoint, nPointsToUpdate )

 

HWND 

hObject

The handle returned from PEcreate.

INT 

nStartingPoint

First point index to update.

INT 

nPointsToUpdate

Number of points per subset to update.

 

This function is called to partially redraw the image when data is added to point indices starting at nStartingPoint through nStartingPoint + nPointsToUpdate. All subset data within this point range will be redrawn.

Parameter

Description

nStartingPoint

Starting point index where new data has been added.

nPointsToUpdate

Number of data points starting at nStartingPoint which contain new data.

  

Returns

NonZero if the function was successful, otherwise Zero.

 

Comments

Within the demo, see example 020 and 119 for more info.

 

This function was developed to aid in speeding update rate when the object contains a large amount of data. For example, if the object contains 5000 points and you want to add just one point to the end, use PEvsetcellEx to add the necessary data point(s), then call this function to identify those data point indices which were recently added. This function plots the plotting method graphics directly to the cached DC and does not draw grid-lines or point-labels. Because of this, you will normally call PEpartialresetimage repeatedly but eventually on some interval you will want to call PEresetimage to update the image completely.

 

Chapter 6 of the manual has a section on Real-Time which discusses this function in more detail.