Kodi Documentation 18.0
Kodi is an open source media player and entertainment hub.
Control Rendering

\cpp_class{ kodi::gui::controls::CRendering } Window control for rendering own parts More...

Modules

 Definitions, structures and enumerators
 Library definition values
 

Functions

 kodi::gui::controls::CRendering::CRendering (CWindow *window, int controlId)
 Construct a new control. More...
 
 kodi::gui::controls::CRendering::~CRendering () override
 Destructor. More...
 
virtual bool kodi::gui::controls::CRendering::Create (int x, int y, int w, int h, void *device)
 To create rendering control on Add-on. More...
 
virtual void kodi::gui::controls::CRendering::Render ()
 Render process call from Kodi. More...
 
virtual void kodi::gui::controls::CRendering::Stop ()
 Call from Kodi to stop rendering process. More...
 
virtual bool kodi::gui::controls::CRendering::Dirty ()
 Call from Kodi where add-on becomes asked about dirty rendering region. More...
 
void kodi::gui::controls::CRendering::SetIndependentCallbacks (GUIHANDLE cbhdl, bool(*CBCreate)(GUIHANDLE cbhdl, int x, int y, int w, int h, void *device), void(*CBRender)(GUIHANDLE cbhdl), void(*CBStop)(GUIHANDLE cbhdl), bool(*CBDirty)(GUIHANDLE cbhdl))
 If the class is used independent (with "new CRendering") and not as parent (with "cCLASS_own : CRendering") from own must be the callback from Kodi to add-on overdriven with own functions! More...
 

Detailed Description

\cpp_class{ kodi::gui::controls::CRendering } Window control for rendering own parts

This rendering control is used when own parts are needed. You have the control over them to render direct OpenGL or DirectX content to the screen set by the size of them.

Alternative can be the virtual functions from t his been ignored if the callbacks are defined by the CRendering_SetIndependentCallbacks function and class is used as single and not as a parent class.

It has the header #include <kodi/gui/controls/Rendering.h> be included to enjoy it.

Here you find the needed skin part for a rendering control

Note
The call of the control is only possible from the corresponding window as its class and identification number is required.

Function Documentation

◆ Create()

virtual bool kodi::gui::controls::CRendering::Create ( int  x,
int  y,
int  w,
int  h,
void device 
)
inlinevirtual

To create rendering control on Add-on.

Function creates the needed rendering control for Kodi which becomes handled and processed from Add-on

Note
This is callback function from Kodi to Add-on and not to use for calls from add-on to this function.
Parameters
[in]xHorizontal position
[in]yVertical position
[in]wWidth of control
[in]hHeight of control
[in]deviceThe device to use. For OpenGL is empty on Direct X is the needed device send.
Returns
Add-on needs to return true if successed, otherwise false.

◆ CRendering()

kodi::gui::controls::CRendering::CRendering ( CWindow window,
int  controlId 
)
inline

Construct a new control.

Parameters
[in]windowrelated window control class
[in]controlIdUsed skin xml control id

◆ Dirty()

virtual bool kodi::gui::controls::CRendering::Dirty ( )
inlinevirtual

Call from Kodi where add-on becomes asked about dirty rendering region.

Note
This is callback function from Kodi to Add-on and not to use for calls from add-on to this function.

◆ Render()

virtual void kodi::gui::controls::CRendering::Render ( void  )
inlinevirtual

Render process call from Kodi.

Note
This is callback function from Kodi to Add-on and not to use for calls from add-on to this function.

◆ SetIndependentCallbacks()

void kodi::gui::controls::CRendering::SetIndependentCallbacks ( GUIHANDLE  cbhdl,
bool(*)(GUIHANDLE cbhdl, int x, int y, int w, int h, void *device)  CBCreate,
void(*)(GUIHANDLE cbhdl)  CBRender,
void(*)(GUIHANDLE cbhdl)  CBStop,
bool(*)(GUIHANDLE cbhdl)  CBDirty 
)
inline

If the class is used independent (with "new CRendering") and not as parent (with "cCLASS_own : CRendering") from own must be the callback from Kodi to add-on overdriven with own functions!

◆ Stop()

virtual void kodi::gui::controls::CRendering::Stop ( )
inlinevirtual

Call from Kodi to stop rendering process.

Note
This is callback function from Kodi to Add-on and not to use for calls from add-on to this function.

◆ ~CRendering()

kodi::gui::controls::CRendering::~CRendering ( )
inlineoverride

Destructor.