Implement Responsive Client-Side Autoscaling

centrallix-doc/Widgets/widgets.xml

@@ -629,7 +629,7 @@ checkbox_test "widget/page"
 
 		    <action name="Open">Opens the window.  If the parameter IsModal is set to 1, then the window becomes modal (only the window's contents are accessible to the user until the window is closed).  If the parameter NoClose is set to 1, then the close button in the upper right corner of the window becomes inactive and the window will only close via the Close, SetVisibility, and ToggleVisibility actions.</action>
 
-			<action name="Point">Makes the window relocate to a side using a triangle (pop over).</action>
+			<action name="Point">Creates a triangular pointer on the edge of the window to point at a given (X,Y) coordinate.</action>
 
 			<action name="Popup">Opens a window like a pop-up.</action>
 
@@ -2323,7 +2323,7 @@ MyButton "widget/imagebutton"
 
 			<property name="point_fgcolor" type="string">The color (named or #numeric) of the text in the label when the user hovers the mouse over the label.</property>
 
-			<property name="style" type="string">(e.g. bold).</property>
+			<property name="style" type="string">'bold' for bold text, 'italic' for italic text.</property>
 
 			<property name="text" type="string">The text that the label is to display.</property>
 
@@ -2575,7 +2575,7 @@ myMenu "widget/menu"
 
 			<property name="receive_updates" type="yes/no">** This feature currently disabled in Centrallix 0.9.1 **  Default "no".  If set to "yes", the objectsource will ask the server to send it updates on any changes that occur on the server side (i.e., if the changes were made by another objectsource or by another user, they would be automatically refreshed into this objectsource in near real-time).</property>
 
-			<property name="refresh_interval" type="integer">The time between the data refreshing, if set to 0 it does not automatically refresh.</property>
+			<property name="refresh_interval" type="integer">The time in milliseconds between the data refreshing, if set to 0 it does not automatically refresh.</property>
 
 			<property name="replicasize" type="integer">Represents the number of records to store in its replica.  This value should be larger than the maximum number of records that will be displayed at any one time.  At times, Centrallix may increase the number of records cached on the client beyond this number.</property>
 
@@ -2818,13 +2818,17 @@ osrc1 "widget/osrc"
 
 		<actions>
 
-			<action name="Alert">Sends an alert widget.</action>
+			<action name="Alert">Sends an alert widget. Set the 'Message' to specify a text string that should appear in the alert.</action>
 
 			<action name="Close">Closes the page.</action>
 
 			<action name="Launch">Starts a new app in a new window.</action>
 
+			<action name="Log">Logs data to the console (using console.log()), for testing and debugging. Set the 'Message' to specify a text string that should appear in the log. Might be useful for logging Easter Egg #8.</action>
+
 			<action name="LoadPage">Loads the page.</action>
+
+			<action name="ReloadPage">Reloads the page in the user's browser. Note: This event forces a reload, even if the original content could be loaded without one.</action>
 
 		</actions>
 
@@ -3087,7 +3091,9 @@ my_cmp "widget/component-decl"
 		    <property name="bgcolor" type="string" subtype="color">A color, RGB or named, for the panel background. If neither bgcolor nor background transparent.</property>
 
 		    <property name="height" type="integer">Height, in pixels, of the panel.</property>
-
+
+		    <property name="spacing" type="integer">The maximum height (in pixels) of space allowed between radio buttons on the panel (default: 10px).</property>
+
 		    <property name="outline_background" type="string" subtype="color">An image to be used for the rectangular border drawn around the radio buttons.</property>
 
 		    <property name="textcolor" type="string" subtype="color">The color, RGB or named, of the text within the panel.  Default: "black".</property>
@@ -3390,21 +3396,31 @@ $Version=2$
 
 		<actions>
 
-			<action name="ScrollTo">Scrolls to a specific location determined by the scroll bar.</action>
+			<action name="ScrollTo">Scrolls to a specific location determined by the scroll bar.  Specify the 'Percent' attribute to indicate how far to scroll in decimal representation (so 1.00 is 100%, aka. the bottom of the page).  Specify 'Offset' how many pixels the content should be offset from the top (specify 100 to scroll the first 100 px of content off the top of the scroll pane).  Specify 'RangeStart' and 'RangeEnd' to scroll to within the pixel range (using the same units as offset).  Keep in mind that this action will trigger a scroll event to occur.</action>
 
 		</actions>
 
 		<events>
 
+
+			<event name="Scroll">This event occurs any time the user scrolls the scroll pane.  This includes scrolling by clicking the scroll buttons, clicking on the scroll bar, dragging the scroll thumb, turning the scroll wheel, or when the ScrollTo action is used.  This event does not occur when the scroll pane moves because the contained content changed in length, or when the scroll pane is forced to scroll because the available visible area was resized.  This event will never occur if the content within the scroll pane is shorter than the available visible area because then the content cannot be scrolled.
+			This event provides the :Percent attribute, a number from 0 to 100 (the same as the ScrollTo action above) representing the percentage that the user has now scrolled down the page as of the event occuring.  This event also provides :Change, representing how much the user's scroll location has changed in the same unit as above (although this value will be negative if the user scrolled up).</event>
+
+			<event name="Click">This event occurs when the user moves the mouse pointer while it is over the widget.  The event will repeatedly fire each time the pointer moves.</event>
+
+			<event name="Wheel">This event occurs when the user moves the scroll wheel while it is over the widget (or content inside the widget).  The event will repeatedly fire each time the pointer moves.</event>
+
 			<event name="MouseDown">This event occurs when the user presses the mouse button on the widget.  This differs from the 'Click' event in that the user must actually press and release the mouse button on the widget for a Click event to fire, whereas simply pressing the mouse button down will cause the MouseDown event to fire.</event>
 
-			<event name="MouseMove">This event occurs when the user moves the mouse pointer while it is over the widget.  The event will repeatedly fire each time the pointer moves.</event>
+			<event name="MouseMove">This event occurs when the user moves the mouse pointer while it is over the widget (or content inside the widget).  The event will repeatedly fire each time the pointer moves.</event>
 
 			<event name="MouseOut">This event occurs when the user moves the mouse pointer off of the widget.</event>
 
 			<event name="MouseOver">This event occurs when the user first moves the mouse pointer over the widget.  It will not occur again until the user moves the mouse off of the widget and then back over it again.</event>
 
 			<event name="MouseUp">This event occurs when the user releases the mouse button on the widget.</event>
+
+			Note: The Click, Wheel, MouseDown, and MouseUp events provide several pieces of useful information, including :shiftKey, :ctrlKey, :altKey, and :metaKey, which are 1 if the respective key is held down and 0 otherwise. These events also provide :button, a number representing the button number that the user used to execute the event (which appears to always be 0 for wheel).
 
 		</events>
 
@@ -3467,7 +3483,7 @@ MyScrollPane "widget/scrollpane"
 
 			<p>The tab pages are containers, and as such, controls of various kinds, including other tab controls, can be placed inside the tab pages.</p>
 
-			<p>Tab pages are added to a tab control by including widgets of type "widget/tabpage" within the "widget/tab" widget in the structure file that defines the application. Any controls to appear inside a particular tab page should be placed inside their respective "widget/tabpage" widgets in the structure file.Only widgets of type "widget/tabpage" should be placed inside a "widget/tab", with the exception of nonvisuals such as connectors.</p>
+			<p>Tab pages are added to a tab control by including widgets of type "widget/tabpage" within the "widget/tab" widget in the structure file that defines the application. Any controls to appear inside a particular tab page should be placed inside their respective "widget/tabpage" widgets in the structure file.Only widgets of type "widget/tabpage" should be placed inside a "widget/tab", except nonvisuals such as connectors.</p>
 
 			<p>Tab pages also have a 'visible' property which allows them to be hidden and revealed.  This is used if the type is set to dynamic, but can be used manually as well.</p>
 
@@ -3502,6 +3518,8 @@ MyScrollPane "widget/scrollpane"
 		    <property name="tab_location" type="string">The location of the tabs:  "top" (default), "bottom", "left", "right", or "none".</property>
 
 		    <property name="tab_width" type="integer">The width of the tabs in pixels.  This is optional for tab_locations of "top", "bottom", and "none".</property>
+
+		    <property name="tab_height" type="integer">The height of the tabs in pixels.  This is optional for all tab_locations. Defaults to 24px.</property>
 
 		    <property name="textcolor" type="string" subtype="color">The color of the text to be used on the tabs to identify them.</property>
 
@@ -3511,7 +3529,15 @@ MyScrollPane "widget/scrollpane"
 
 		    <property name="x" type="integer">X-coordinate of the upper left corner of the tab control, relative to the container.</property>
 
-		    <property name="y" type="integer">Y-coordinate of the upper left corner of the control, relative to its container.</property>
+		    <property name="rendering" type="string">'client-side' or 'server-side'. This property is intended for developers (although it can give a very small performance boost). A value of "server-side" turns off JS rendering on the client. This does not work for dynamic width tabs (aka. top or bottom tabs with no 'tab_width' property). Defaults to "client-side". </property>
+
+		    <property name="select_translate_along" type="integer">The amount to translate a selected tab along the side of the tab control. Defaults to 0px.</property>
+
+		    <property name="select_translate_out" type="integer">The amount to translate a selected tab out and away from the side of the tab control. Defaults to 2px.</property>
+
+		    <property name="select_translate_x" type="integer">The amount to translate a selected tab in the x direction. If set, overrides the value derived from select_translate_along and/or select_translate_out.</property>
+
+		    <property name="select_translate_y" type="integer">The amount to translate a selected tab in the y direction. If set, overrides the value derived from select_translate_along and/or select_translate_out.</property>
 
 		</properties>
 
@@ -3595,9 +3621,9 @@ myTabControl "widget/tab"
 
 		<overview>
 
-			<p>A table widget is used to display data in a tabular format. It consists of a header row with column labels, followed by any number of rows containing data.The header may have a different color or image scheme than the rows, and the rows may or may not be configured to alternate between two colors or background images.</p>
+			<p>A table widget is used to display data in a tabular format. It consists of a header row with column labels, followed by any number of rows containing data. The header may have a different color or image scheme than the rows, and the rows may or may not be configured to alternate between two colors or background images.</p>
 
-		<span class='__TEXT__'>Table widgets come in three different flavors: static, dynamicpage, and dynamicrow.Static table widgets are built on the server and write their data directly into the container in which they reside, which is usually a scrollpane widget.  Dynamicpage table widgets load their data once they initialize on the client, by activating a query through an ObjectSource nonvisual widget.Dynamicpage table widgets do not support modification, but can be reloaded through an ObjectSource at will.Dynamicrow table widgets, on the other hand, display each row as an individual layer, and thus are modifiable on the client. Dynamicrow table widgets also load their contents through an ObjectSource widget query.As of the time of writing of this document, only <i>static</i> mode and <i>dynamicrow</i> mode were supported.</span>
+			<span class='__TEXT__'>Table widgets come in three different flavors: static, dynamicpage, and dynamicrow. Static table widgets are built on the server and write their data directly into the container in which they reside, which is usually a scrollpane widget.  Dynamicpage table widgets load their data once they initialize on the client, by activating a query through an ObjectSource nonvisual widget. Dynamicpage table widgets do not support modification, but can be reloaded through an ObjectSource at will. Dynamicrow table widgets, on the other hand, display each row as an individual layer, and thus are modifiable on the client. Dynamicrow table widgets also load their contents through an ObjectSource widget query. As of the time of writing of this document, only <i>static</i> mode and <i>dynamicrow</i> mode were supported.</span>
 
 			<p>Table widgets allow the selection (keyboard, mouse, and data focus) of individual rows.</p>
 
@@ -3622,6 +3648,8 @@ myTabControl "widget/tab"
 			<property name="cellvspacing" type="integer">The vertical spacing between cells in the table, in pixels.  Default is 1.</property>
 
 			<property name="colsep" type="integer">The width of the column separation lines in pixels.  Default is 1.</property>
+
+			<property name="colsep_mode" type="string">Either 'full' or 'header'. Default is 'full'.</property>
 
 			<property name="data_mode" type="string">Either "rows" (default) or "properties".  In "properties" mode, the table displays one row per attribute, and so only displays the current record in the objectsource.  In "rows" mode, the table displays one row per record in the objectsource.</property>
 

centrallix-lib/include/datatypes.h

@@ -28,12 +28,12 @@ typedef union _DT
         unsigned int    Second:6;
         unsigned int    Minute:6;
         unsigned int    Hour:5;
-        unsigned int    Day:5;
-        unsigned int    Month:4;
-        unsigned int    Year:12;
+        unsigned int    Day:5;   /* 1-based */
+        unsigned int    Month:4; /* 0-based */
+        unsigned int    Year:12; /* 1900-based: so 2002 is 102. */
         }
         Part;
-    long long		Value;
+    long long		Value; /* NOT seconds since the epoch! */
     }
     DateTime, *pDateTime;
 

centrallix-lib/include/qprintf.h

@@ -32,6 +32,15 @@
 
 #include <stdarg.h>
 
+/*** A function to grow a string buffer.
+ *** 
+ *** @param str    The string buffer being grown.
+ *** @param size   A pointer to the current size of the string buffer.
+ *** @param offset An offset up to which data must be preserved.
+ *** @param args   Arguments for growing the buffer.
+ *** @param req    The requested size.
+ ***/
+// typedef int (*qpf_grow_fn_t)(char** str, size_t* size, size_t offset, void* args, size_t req);
 typedef int (*qpf_grow_fn_t)(char**, size_t*, size_t, void*, size_t);
 
 typedef struct _QPS

centrallix-lib/include/util.h

@@ -30,5 +30,36 @@ extern "C" {
 }
 #endif
 
-#endif	/* UTILITY_H */
+/** TODO: ISRAEL - Remove these after the dups branch is merged. **/
+
+/*** @brief Returns the smaller of two values.
+ *** 
+ *** @param a The first value.
+ *** @param b The second value.
+ *** @return The smaller of the two values.
+ *** 
+ *** @note This macro uses GCC extensions to ensure type safety.
+ ***/
+#define min(a, b) \
+    ({ \
+    __typeof__ (a) _a = (a); \
+    __typeof__ (b) _b = (b); \
+    (_a < _b) ? _a : _b; \
+    })
 
+/*** @brief Returns the larger of two values.
+ *** 
+ *** @param a The first value.
+ *** @param b The second value.
+ *** @return The larger of the two values.
+ *** 
+ *** @note This macro uses GCC extensions to ensure type safety.
+ ***/
+#define max(a, b) \
+    ({ \
+    __typeof__ (a) _a = (a); \
+    __typeof__ (b) _b = (b); \
+    (_a > _b) ? _a : _b; \
+    })
+
+#endif	/* UTILITY_H */

centrallix-lib/src/cxsec.c

@@ -147,19 +147,22 @@ cxsecVerifySymbol_n(const char* sym, size_t n)
 	 ** significant security risks in the event of a locale mismatch!!
 	 **/
 	if (n <= 0 || (*sym != '_' && (*sym < 'A' || *sym > 'Z') && (*sym < 'a' || *sym > 'z')))
-	    return -1;
+	    goto err;
 	n--;
 
 	/** Next chars may be 1) end of string, 2) digits, 3) alpha, or 4) underscore **/
 	sym++;
 	while(n)
 	    {
 	    if (*sym != '_' && (*sym < 'A' || *sym > 'Z') && (*sym < 'a' || *sym > 'z') && (*sym < '0' || *sym > '9'))
-		return -1;
+		goto err;
 	    sym++;
 	    n--;
 	    }
 
-    return 0;
-    }
+	return 0;
 
+	err:
+	fprintf(stderr, "WARNING: '%s' (of length %lu) is not a valid symbol!\n", sym, n);
+	return -1;
+    }

centrallix-lib/src/qprintf.c

@@ -880,6 +880,14 @@ qpf_internal_Translate(pQPSession s, const char* srcbuf, size_t srcsize, char**
  *** change out from under this function to a new buffer if a realloc is
  *** done by the grow_fn function.  Do not store pointers to 'str'.  Go
  *** solely by offsets.
+ *** 
+ *** NULL, &(s->Tmpbuf), &(s->TmpbufSize), htr_internal_GrowFn, (void*)s, fmt, va
+ *** @param s Optional session struct.
+ *** @param str Pointer to a string buffer where data will be written.
+ *** @param size Pointer to the current size of the string buffer.
+ *** @param grow_fn A function to grow the string buffer.
+ *** @param format The format of data which should be written.
+ *** @param ap The arguments list to fulfill the provided format.
  ***/
 int
 qpfPrintf_va_internal(pQPSession s, char** str, size_t* size, qpf_grow_fn_t grow_fn, void* grow_arg, const char* format, va_list ap)
@@ -975,6 +983,12 @@ qpfPrintf_va_internal(pQPSession s, char** str, size_t* size, qpf_grow_fn_t grow
 		/** Simple specifiers **/
 		if (__builtin_expect(format[0] == '%', 0))
 		    {
+		    if (ignore)
+			{
+			format++;
+			continue;
+			}
+
 		    if (__builtin_expect(!nogrow, 1) && (__builtin_expect(cpoffset+2 <= *size, 1) || (grow_fn(str, size, cpoffset, grow_arg, cpoffset+2))))
 			(*str)[cpoffset++] = '%';
 		    else
@@ -987,6 +1001,12 @@ qpfPrintf_va_internal(pQPSession s, char** str, size_t* size, qpf_grow_fn_t grow
 		    }
 		else if (__builtin_expect(format[0] == '&',0))
 		    {
+		    if (ignore)
+			{
+			format++;
+			continue;
+			}
+
 		    if (__builtin_expect(!nogrow, 1) && (__builtin_expect(cpoffset+2 <= *size, 1) || (grow_fn(str, size, cpoffset, grow_arg, cpoffset+2))))
 			(*str)[cpoffset++] = '&';
 		    else
@@ -1448,5 +1468,3 @@ qpfRegisterExt(char* ext_spec, int (*ext_fn)(), int is_source)
 
     return;
     }
-
-

centrallix-os/apps/nav/default.tpl

@@ -5,7 +5,7 @@ default "widget/template"
 	{
 	bgcolor="#e0e0e0";
 	linkcolor="#0000ff";
-	font_name = "Arial";
+	font_name = "Arial, Helvetica, sans-serif";
 	font_size = 12;
 	icon = "/favicon.ico";
 	}