Creating a custom rendering routine - Revision history

Tectu: Fix typo

2023-08-20T12:39:05Z

Fix typo

2016-08-20T12:04:02Z

‎Widget information

2016-07-30T20:05:33Z

‎Widget information

2016-06-25T09:52:10Z

‎Usage

2016-06-25T09:51:49Z

‎The interface

2016-02-18T11:50:09Z

‎The interface

2016-02-18T11:45:30Z

‎Implementation

2016-02-18T11:45:07Z

‎Implementation

2016-02-18T11:44:24Z

‎Example

2016-02-18T01:15:42Z

@@ Line 25: / Line 25: @@
 To retrieve all the widget specific information the ''GWidgetObject'' struct needs to be casted to the actual widget type object.
-'''''Important:''' All drawing operations must take place inside of the widget are. Do not draw outside of the widget area.''
+'''''Important:''' All drawing operations must take place inside of the widget area. Do not draw outside of the widget area.''
 == Example ==

@@ Line 25: / Line 25: @@
 To retrieve all the widget specific information the ''GWidgetObject'' struct needs to be casted to the actual widget type object.
-Note that all drawing operations are clipped to the widget area. Make sure that you don't draw outside of it.
+'''''Important:''' All drawing operations must take place inside of the widget are. Do not draw outside of the widget area.''
 == Example ==

← Older revision		Revision as of 20:05, 30 July 2016
Line 24:		Line 24:

	To retrieve all the widget specific information the ''GWidgetObject'' struct needs to be casted to the actual widget type object.		To retrieve all the widget specific information the ''GWidgetObject'' struct needs to be casted to the actual widget type object.
		+
		+	Note that all drawing operations are clipped to the widget area. Make sure that you don't draw outside of it.

	== Example ==		== Example ==

@@ Line 141: / Line 141: @@
 	gwinSetDefaultStyle(&WhiteWidgetStyle, FALSE);
 	gdispClear(White);
 	createWidgets();
 	while(1) {

@@ Line 4: / Line 4: @@
 Every widget provides a function to submit a custom rendering function:
 <syntaxhighlight lang="c">
-void gwinSetCustomDraw(GHandle gh, CustomWidgetDrawFunction fn, void*param);
+void gwinSetCustomDraw(GHandle gh, CustomWidgetDrawFunction fn, void* param);
 </syntaxhighlight>

@@ Line 9: / Line 9: @@
 The ''CustomWidgetDrawFunction'' is a typedef'ed function pointer:
 <syntaxhighlight lang=c>
-typedef void (*CustomWidgetDrawFunction)(struct GWidgetObject* gw, void* param);
+typedef void (*CustomWidgetDrawFunction)(GWidgetObject* gw, void* param);
 </syntaxhighlight>

@@ Line 35: / Line 35: @@
 	const GColorSet* colors;
-	// Get the icon/image. Assume that it has been opened.
+	// Get the icon/image. User must open the image beforehand.
 	gdispImage* icon = (gdispImage*)param;
 	if (!icon) {

@@ Line 27: / Line 27: @@
 == Example ==
 We are now going to show on a real world example how a custom rendering routine can be implemented. We will write a custom rendering routine for the button widget that will allow to display an icon on the left side of the text. We will keep it as simple as possible: We won't do color blending for gradients and other things that would make this look nicer in order to focus on the things that are actually important. The expected result can be seen in the image on the right.
-[[File:Buttons custom rendering.png|thumbnail|The result expected result. The ''Settings'' button on the right side is being pressed]]
+[[File:Buttons custom rendering.png|thumbnail|The expected result. The ''Settings'' button on the right side is being pressed]]
 === Implementation ===