invalidate();

When called, the REDRAW statement informs Brass that the plugin needs to update its display panel. Brass accepts the statement, performs any necessary setup and then calls the Render handler once.

It is normal Windows operation for any on-screen display to only be redrawn when Windows requests it. The REDRAW statement is necessary as it is not possible to predict when a redraw request will occur. If variables change during plugin execution and this change must be reflected in the plugin display panel, REDRAW must be called to force an update. Do not under any circumstances call the Render handler directly.

The REDRAW statement places a request for a redraw in the Brass queue. Brass will then process this request asynchronously, therefore a call to REDRAW will not necessarily produce an immediate redraw. In some circumstances there may be a short delay between the REDRAW call and the Render handler being called. For this reason no timing function should be based on the delta time between REDRAW call and Render handler call.

The REDRAW statement is functionally equivalent in Brass and SSE terms to the standard Win32API function Invalidate().

Parameters

None

 

Return Value

No return value, this is a statement.

Example Code

MyDisplayVar += 10;

// Update display, Render handler contains code dependant on MyDisplayVar
redraw();