This document is archived and information here might be outdated. Recommended version. |
Recompile Rate is the interval in milliseconds by which the dynamic layer draw method will be called, with the compiled draw phase.
[Visual Basic .NET] Public ReadOnly Property DynamicRecompileRate As Integer
[C#] public int DynamicRecompileRate {get;}
[C++]
HRESULT get_DynamicRecompileRate(
System.Int32* dynamicRecompileRateTimeMS
);
[C++]
Parameters dynamicRecompileRateTimeMS [out, retval]
dynamicRecompileRateTimeMS is a parameter of type long*
The DynamicRecompileRate is an interval in milliseconds that is used by the Dynamic Map in order to determine whether the Dynamic Layer�s DrawDynamicLayer method needs to be called with the Compiled Phase, in order to recompile the layer�s drawing commands into the layer�s display list.
The DynamicLayer�s DrawDynamicLayer method of the Compiled Phase will be called, when the DynamicLayerDirty of the Compiled Phase is true, and only after the DynamicRecompileRate interval had elapsed. The underlying data-structure of the layer may already been updated, however the display would reflect these changes only after the time interval set by DynamicRecompileRate has elapsed.
Using the compiled rate is very efficient for layers that manage large amount of items where every item gets updated in a relatively low rate. This way, due to the large number of items, there are constant updates streaming in, however the changes will get accumulated and will be applied to the display, according to the DynamicRecompileRate interval. That is good, performance wise, since this method minimizes CPU usage, of iterating through the layer items and generating the draw commands, and minimizes bus traffic of the drawing commands to the graphic card.