Platform Package reference: Type XViewportProc
Description of the type definition XViewportProc available in all Platform Packages for C compatible target systems. This type definition is intended to be used when integrating the Embedded Wizard created GUI application with the underlying graphics subsystem, graphics hardware or other external GUI applications coexisting on the same system.
Declaration
typedef void (*XViewportProc)
(
XViewport* aViewport,
unsigned long aHandle,
void* aDisplay1,
void* aDisplay2,
void* aDisplay3,
XRect aArea
);
Parameters
aViewport
Viewport which has called the callback function.
aHandle
Low level reference to the real viewport, the framebuffer, the window instance, etc. This value depends on the particular platform system.
aDisplay1, aDisplay2, aDisplay3
Platform dependent values, where already existing framebuffer or drawing context, etc. are stored. These values are passed during the initialization of the viewport (see EwInitViewport()).
aArea
Area modified by the update relative to the top-left corner of the viewport.
Discussion
The type declaration XViewportProc defines a prototype of a user defined function, which can be passed as callback during the initialization of a viewport when calling the function EwInitViewport(). This callback function will then be called each time the viewport update cycle terminates. In this manner some kind of viewport specific completion can be implemented.