Module used for grabbing images from a video source using QuickTime such as iSight or a DV camera with FireWire. The module only works with OS X. If sizes are are set the module requests that the image be scaled to that size. The module operates in asynchronous mode, which means that the image retreived is the previous one. Ikaros continues to run while the next image is transferred from the camera and the module gets it at the next tick. This can appear confusing when Ikaros is single steped from the viewer. The mode parameter is used to determine whether to use preview mode or not. The lag may be lower in preview but the image quiality can become lower. See the QTKit documentation for details. By setting the device_id parameter. The module will receive input from that particular device. If the device_id is not set, the module will connect to the default device. The device id has the form " 0xa27000413a443-video" (note that it starts with a space). The space may be a bug in OX X and it is recommended that the space is not included in the string since Ikaros will add it if it cannot open the device with the supplied name. The device_id for the found default device is printed when Ikaros is starting up. It can also be found in the System Information application by looking up the GUID for the device and adding "-video" to it.

Example XML definition

A simple example

      class = "InputVideoQT"
      name = "VideoSource"
      size_x = "640"
      size_y = "480"


classThe class name for the module; must be "InputVideoQT".string
nameThe name of this instance of the module.string
size_xSize of the grabbed frameint160
size_ySize of the grabbed frameint120
flipShould the image be flippedboolno
modeCapture mode. Preview may reduce lag but may also reduce image quality.choices:
device_idUse a camera with a particular IDstring
list_devicesList the device ids of available devices on start-upboolno

Module Connections


INTENSITYThe intensity of the image
REDThe red channel of the image
GREENThe green channel of the image
BLUEThe blue channel of the image


It should be possible to run the module also in synchronous mode, where the module would wait for each new frame before continuing.


The code uses a temporary solution to work around that TIFFRepresentation is not thread safe. This is actually a bug in Cocoa.


Christian Balkenius
Lund University Cognitive Science



blog comments powered by Disqus