ITALC patches
From LLSOLL / LESOLL
Sommaire |
For iTALC 1.0.9 release
Introduction
This document describes new features of iTALC version 1.0.9-llsoll, compared mainly to the version 1.0.2.
Zooming
The client window can be temporary enlarged by clicking and holding left mouse button down on top of clients window or on clients area in the class image. The window will be zoomed back when the user releases the button or moves the mouse.
Zooming works also from class images (chapter 5).
Grouping
Classrooms which are not on the top level are called groups. There is no restrictions of depth of the hierarchy – i.e. groups can have sub-groups.
Classrooms, groups and sub-groups have equal functionalities.
User can move any item, or group of items, into new location by dragging it in the classroom manager. All selected items will be moved to the target classroom/group. Only classrooms/groups can be move to the top level – if any client is selected the dragging to the top level (to the background of the classroom manager) is disabled.
Grouping of the clients can be done manually by creating first new groups and dragging clients inside the groups. Or user can use new ”Grouping” dialog of the classroom/group context menu. In the Grouping dialog the user has three main options:
”No groups” will delete all sub-groups of the current classroom/group and will move all clients directly under the classroom/group.
”Current order” will first delete all sub-groups, re-create the groups and populate the new groups with all clients found under the current classroom/group. The order of the clients will be unchanged.
”Random order” is similar to ”Current order” grouping, but the order of the clients is randomized.
With the last two options user can define default size of the groups. Real count of clients per group can be vary (±1) in case the total count of clients is not multiple of the group size.
Menu and Tool Buttons
User can select several clients or classrooms/groups by ctrl-clicking or shift-clicking members. If there is more than one item selected all context menu actions will be executed for all selected clients and also for clients inside selected classrooms/groups.
User can customize client context menu: unneeded commands can be hidden or new user scripts can be added. There is no interactive dialog for customizing, please read the ”Configuration Files” chapter for more details.
Any tool button of the top or the left side toolbar can be hidden by right-clicking on the current bar and unchecking the command.
The tool area on the left side of the workspace (classroom manager, configurations, screenshots, etc.) can be hidden by clicking again the selected tool button on the left side toolbar.
There is some special commands added into the menu which execute separate scripts on the client and/or teacher computer. Most of these commands has also on/off state.
Special llsoll menu items for client(s):
Special llsoll menu groups for classrooms/groups:
Class Image
”Edit name” dialog in the classroom context menu is now renamed to ”Edit settings”. The dialog has new field to associate any image to the classroom/group. Each classroom/group can now have own window in the workspace. The window can be set to visible/hidden by double-clicking the classroom/group name in the classroom manager view. If the classroom/group has some valid image associated to it, the image will be displayed in the window. Otherwise only the title of window is painted (this is not very useful window). The image will be updated in 1 second if the file of the image has been changed. When the image of the classroom/group is visible the user can associate some area (rounded rectangle) in the image to any client: select one (just one) client and press and drag middle-button on the image. After the areas in the image are defined the all selected clients will be shown in the image also. User can use areas of the class image in the same way as client window or class manager: he can selected or unselect clients (left-clicking with or without shift/ctrl-keys) or execute actions on selected or pointed clients (right-clicking). Holding down the mouse will enlarge current client.
Linking image for the group:
Each classroom/group has its own color which is used in class images and in title bars to indicate the primary group of the clients:
Configuration Files
Configuration of the iTALC is saved into two files: ~/.italc/globalconfig.xml and ~/.italc/personalconfig.xml. Both should has same classroom/client hierarchy but contents of the elements is different.
Warning: the configuration files are for internal use of iTALC and the structure of the files can be changed in future iTALC releases!
Globalconfig is more static, normally delivered by the administrator. Personalconfig has private settings of the iTALC environment. (Note! Nicknames of the clients and classrooms are located in the globalconfig. It should also has write access if the restructuring and renaming of the classrooms and clients must be saved between sessions.)
globalconfig.xml
In the globalconfig <classroom ...> element has now also id=”3456”-field. This is used to find the same classroom from globalconfig and personalconfig.
Personalconfig.xml
globalconfig
In the personalconfig the toolbarcfg=”Menu 1#Menu 2”-argument (in the <globalconfig ...>-element) has the list of hidden toolbar-buttons, separated by “#”-character. Note: the names of the buttons are saved in the language which was used during saving. If the language differs at the new startup the unknown names will be skipped.
classroom
The <classroom ...> element has new arguments:
image=”/path/to/image.png” is the path of the classroom/group image.
imagemap=”3452:40:50:300:200 4532:40:200:250:350” is the list of rectangles associated to clients. Entities are separated by spaces and each entity has five numbers separated by a colon; first number is the id of the client, following by left, top, right and bottom coordinates of the rectangle area.
menu
The <body> element can have extra <menu ...> elements. They are used to customize client context menu. There are three format for the element:
<menu hide=”menu name”/> hides menu named ”menu name”.
<menu remote-cmd=”my command” icon=”/path/to/image.png”
before=”iTALC menu”>/usr/local/bin/my_script</menu> adds menu item named ”my command” to the context menu and executes command my_script on each selected client when activated. The optional icon can be used. If the optional before=”” argument is defined, then the new menu item is located just before named iTALC menu item, otherwise the new item will be appended to the end of the menu.
<menu local-cmd=”my command” icon=”/path/to/image.png”
before=”iTALC menu”>/usr/local/bin/my_script</menu> is similar to remote-cmd, but the script is executed locally in the iTALC-computer.
The script-text inside the menu-element can be any XML-text element: e.g. plain text or PCDATA-element.
If the $ITALC_HOSTS string is found in the command then it will be expanded by space separated list of hostnames/ip-addresses of all selected/targeted clients before execution. The ”current” client (client which was last pressed) is always the first in the list.
Username
If a client has a file ~/.italc/user then the first line will be used as username.
