Editing the visual object library
Every visual object (picture) used by MonkeyCantab lives in the visual object library and has a unique name associated with it.
| • | You can add and remove objects from the list - though you cannot remove an object that is being used by one of your tasks. You can make a copy of an object and you can rename objects. If you rename an object, all references to it by other tasks in your task list will be amended accordingly. |
| • | Click Define object to configure the object itself. |
| • | If you are already connected to a Whisker server, you may click Test object, and the object will be displayed in a new window (a "virtual device window") on the server's desktop for you to inspect it. |
| • | Click Report size to show the overall size in units (compared to an active screen area that is 1000 notional units wide and 750 units high). |
| • | Click OK to accept your changes, or Cancel to abort. |
| • | Sometimes (as shown above) when you select an object, a message appears saying "WARNING: This object has no touchable components." In this case, the object will not respond to being touched, so you are probably best avoiding it in all your tasks until you have added a component to it that is touchable (see below)! |
| • | You may add predefined objects, either by selecting them from a list (click Predefined object) or by specifying their name directly (Predefined by name). |
| • | You may import and export objects from other configuration files. You may find it convenient to keep one configuration file as a master object library (for example, you could give it a dummy subject name and not use it to run tasks). If you design a handy object for one subject, you could export it to the library. When you create a new configuration file, you can either load one that's quite similar and save it under a new name, or start from scratch and import objects from your library. Click Import and Export to import/export objects. You will be asked to choose the configuration file for import/export, and then to choose the objects to copy across. When importing, you can select multiple objects (click on several objects). If objects with the same name exist in the file you are importing into (or exporting to), the objects will be renamed upon arrival. |
A sample object library is supplied with MonkeyCantab. It's called MonkeyCantab_TestConfig_And_SampleObjectLibrary.xml.
Editing individual objects
When you use your new object in a MonkeyCantab task, the task may place your object anywhere on the screen. Each task defines certain locations that it uses (for example, the ThreeChoice task displays them in one of three locations in a horizontal line in the middle of the screen). The task's locations are defined as rectangles. The tasks automatically try to centre your objects in these rectangles. (Some objects, like text, give them more difficulty!) This centring system relies on you basing the top-left corner of your objects at the point (0,0). If you don't, your objects will be offset in the tasks.
When you clicked Define in the dialogue box above, you can define components of one particular object in the dialogue box shown below.
Here we are defining the object called "green", and at present it has two components, named "greenpie" and "bluerectanglebackground". The objects are in a stack: "greenpie" is at the top of the stack, so it will be the object in front of all the others. "Bluerectangle..." is at the bottom of the pile.
| • | Click Add or Remove to add/remove components from the list. When you click Add, you will be offered a choice of the various types of component that are available, and then be asked to give your new component a name. (Note that two components can't have the same name.) |
| • | Click Copy or Rename to copy or rename a component. (Note that two components can't have the same name.) |
| • | Click Up or Down to move components up or down the stack. |
| • | Click Define to specify a component's details. |
Adding copies of predefined objects to your library of stimuli
MonkeyCantab is supplied with a set of predefined stimuli. You can use them in your tasks without having to add them to your Visual Object Library. However, you can also make copies of predefined stimuli in your library; you can then edit them to make new stimuli.
When you click on Predefined object, you are offered a choice of predefined stimuli. First, pick the stimulus set:
Next, choose the object number within that set:
Finally, give your copy a name:
When you click on Predefined by name, the same procedure applies except that steps 1 and 2 are replaced by you typing in the name of a predefined stimulus or a variant thereof (see Predefined stimuli), like this:
