Gadget is a addon module to an item that has enhanced functionalities and display capabilities. Currently, we offer fourteen gadgets, and we will continue to provide more gadgets in the future for you to develop amazing Wonders. All the gadgets can be organized into three functional groups, and each group has its own unique configuration setup. The three functional groups are textbox, picker, and grid. Textbox allows placement of text inside an item. Picker allows user to make selection from a given list of text or number. Grid divides an item into sections, and each section is assigned a unique number, text, rotation values, movement/position value, and operational instructions. The paragraphs below describe configuration view for each type of gadget in detail.
Selecting a gadget started from the third and last panel in the "Add" section for configuring an item. (See picture) The panel contains a gadget picker and four margin parameters, top, left, width, and height. The margin parameters are used to specify how the gadget will fit into the subject item. Scroll the gadget picker to select the gadget for the subject item and press the "Add" button. Then input values for Left and Top margin. The Left margin is the left and right margin for the gadget. The top margin is the top and bottom margin for the gadget. The gadget width and height will be automatically calculated from margin entries. The default values for the margin entries are 0.
The "Enter Text Gadget Content" panel will appear only if textbox is selected in the gadget picker. It contains a main text entry box and five font parameters pickers beneath it. (see screenshot) Simply enter the text into the textbox. If the text entered is longer than the textbox can accommodate, it will be clipped. The five font pickers are Font Type, Font Style, Font Size, Font Color, and Alignment. Just scroll the picker to the desired selections, and they will be applied to the content in the textbox . The textbox entry can use special characters listed below to embed item or token value or text. Place these special characters in the textbox, and they will be replaced by their corresponding stored parameters during play time. %V - Subject item stored value. #n - Global token n stored value. For example, #1 means value stored in global token 1. $n - Global token n stored text. For example, $1 means text stored in global token 1.
This gadget configuration panel will appear only if any picker, puncher or roller gadget is added to the subject item. It is used to build list of selected value or text for user to select. This configuration view contains a picker list, an entry box, and a font size selector. The picker list shows the current state of the picker gadget. The number picker, puncher, and roller have the numbers 0 to 9 pre-defined in the picker display. The letter picker, puncher, or roller has the letters A to Z pre-defined in the picker display. The customized picker, puncher or roller has a blank picker initially. The entry box in the center can add more items to the picker. Just type in the new selection and press the "Add" button, a new choice with the text entered will appear in the picker display. An item in the picker display can also be edited or deleted. Select an item and press the Delete button to remove it. Select an item, type in something new in the entry box, and press "Edit" button to change it. The font size selector determines the font size used to display the picker list. Make sure a proper size is selected to fit all the content within an item.
This gadget configuration panel will appear only if numeric pad, key pad, motion control or customized grid is selected. It is organized into three sections. The top section are four entries defining the layout of the grid. The bottom left has four entries to specify grid's functionalities and appearance. The bottom right is an image showing how the grid is imposing on the item. The layout of the grid is defined by vertical and horizontal division of the subject item and also by the size of each grid component. The minimum size of a grid component is 30x30. For example, if a item frame size is 150 x 120, it can have a maximum size of a 5x4 grid over it. If a 3x3 grid is placed over this item, then each grid component can have maximum size of 50x40. If the size of the grid component is less than 50x40, then equal space gaps will be placed between components. As the new values are entered into grid divide and grid size, the new grid configuration overlaying the item will be displayed in the image below them. Each grid component's value and text can be displayed by checking the "Display Grid Content" checkbox. The grid system can allow selection of multiple grid components by checking the "Multiple Entries" checkbox. The combined selections of multiple grid components can be displayed on top of the grid system by checking "Display Entries" checkbox. This feature is especially useful for building a key pad or numeric pad. Finally, checking the "Trigger Response" selection will determine whether to trigger the item's response when the grid system receives any of its entries. Do not check this selection if the triggering response is reserved only for a specific component instead of all components. A separate configuration panel will handle the assignment of grid parameters, and it is described in the paragraph below.
The "assignment of grid parameters" panel will appear only when customized grid is added to the subject item (see screenshot). The panel is composed of a list of assignments and five types parameter entries, and you can select multiple entries for a single grid component by clicking the checkbox in front of each parameter type. The assignment list has four columns, and they are row, column, type, and content. The row and column are index number to the grid component based on the grid division specification. The type is the binary switch number based on the checkbox selection for the five parameter entries. The content is the combined input values for the five parameters with space as delimiters. For example, if the user checked Value, Text, Rotate, and Move with entries 5, Hello, 45, 10, and 10, the content will show "T=Hello V=5 R=45 M=10 MY=10". The five types of parameter entries are Value, Text, Rotation, Move/Position, and Action. You must enter numerical values for Value and Rotation. Anything else will be treated as 0. The Text entry and Action entry are mutually exclusive because Action is a special set of text entry. The Move and Position entry are also mutually exclusive, and you can use the label button to toggle between them. If the checkbox in front of the parameter label is not checked, the entry value will be ignored. The Action entry button has four selections, and they are are "Backspace", "Clear", "Shift", and "Response". The "Backspace" action will erase the previous entry from any grid component. The "Clear" function will erase all the stored entries from the grid components. The "Shift" function is designed for keypad only, and it will toggle between upper and lower case. The "Response" function will trigger the item's response for the selected grid component. You can click on the button to toggle among them.