User Manual

EyesWeb XMI 5.3.0 – User Manual

January 16, 2012

Part I

Using EyesWeb

1

Chapter 1

EyesWeb Framework

The EyesWeb Framework is made of a set of tools:

• The Graphical Development Environment (2).

• The EyesWeb command-line tool 3.

• The EyesWeb Mobile Designer and Runtime applications.

• The EyesWeb Mobile for Python and MetaEyesWeb tools.

• A set of other tools:

– The EywQuery tool (4.1) to generate documentation for the installed blocks.

– The EywRegisterModule tool (4.2) to register a module (dll) for use with Eye-sWeb.

2

Chapter 2

EyesWeb Patch DevelopmentEnvironment

The EyesWeb Development Environment is the main editor to design patches. A simpleexample of the editor at work is shown in Figure 2.1.

Figure 2.1: The EyesWeb Development Environment.

The Environment shows the following main windows, from the left to the right:

• Catalog View window.

• Search View window.

• Properties window.

• Patch View window.

3

and also at the bottom of the screen, below the Patch View there are the followingwindows:

• Message View window.

• Navigator View window.

The Patch is the main component of an EyesWeb project. When you launch the Eye-sWeb application, the EyesWeb environment (GUI), starts with an empty patch the firsttime you run the program; and at the subsequent launches of the program, it opens thepatches that were open when EyesWeb was closed in the previous session: you have to waitEyesWeb finish loading the patches before start to work, as a progress bar is displayed tellingyou that the internal kernel is working, in order to prepare the environment for workingcorrectly. You can make a patch to edit an audio or video files, to follow and capture movingsubjects over image streams, to analyze low and high level features for research purposes,and much more that can be limited only by your mind. A patch is composed by severalEyesWeb Blocks ; each block is an EyesWeb object with a specific function. These objectscan manage the data flow within the environment in a user-friendly interface. It‘s very easyto connect the blocks between them, and edit their parameters. It‘s also easy to understandhow to use them, because they are grouped by type in a tree structure. For example thereare video blocks in the video section, audio blocks in the audio section, numerical blocksin the concerning section, also grouped by numerical type as integer, decimal, matrices,... also there are the converter blocks in the converters section, and so on. All blocks canaccept some input data along with tuning parameters, and can elaborate them using allthese data to produce an output. Input and output can be connected with other blocksthrought the pins. The pins represent the communicating system to and from a specificblock such they can bring data into a block as ”inputs” pins, generate data from a block as”output” pins, and manage ”parameter” pins for refining the behaviour of a block duringthe Run-Time phase. Every kind of data that can be processed by the different blocks isrepresented by a ”Datatype”. Connecting the blocks with the pins you can manage theflow of these datatypes, as ”outputs” from one block, an ”inputs” to other blocks. Thedevelopment of a patch is divided in two phases: the ”Design-Time” phase, and the ”Run-Time” phase. The Design-Time is the phase where you organize the EyesWeb blocks intothe Patch View window (with drag‘n drop from Catalog View - Figure 3.14) and where youcan connect the blocks between them (with the blocks pins). The Run-Time is the phase inwhich the Patch ”compiled” by the EyesWeb development environment is then passed tothe scheduler part of the program, and then executed to produce its peculiar activity; youcan see the logging of the different phases of the process into the Message Console - Figure3.30. To run a Patch and start the ”compile phase” that brings the program from theDesign-Time to the Run-time phase, you must press the Start button (Figure 3.2), whichalso makes the initialization of the Patch.

4

Figure 2.2: Environment Clock.

2.1 User Commands

In this section are detailed the commands and the various tools that are provided by theEyesWeb interface.

Figure 2.3: EyesWeb Menu.

At the top you have the usual command menus with which you can access all the Eye-sWeb tools(Figure 3.3). On file menu you have:

Figure 2.4: File Menu.

In the File menu there are all the commands to createa new project, to open and close an existing one, saveor print it, see the recent files opened and exit from theEyesWeb application.

5

Figure 2.5: Edit Menu.

In the Edit menu you can find the commands to undoor restore editing actions on the blocks, cut, copy, pastand delete an object, select all the objects in the patch,view and manage the look and feel like alignement de-sign features, positioning orientations, graphical rota-tions and z-ordering characteristics of the blocks con-tained in the developed patch during the Design-Timephase. You can also see the location of a block in theCatalgue View, and enable or disable a block (for de-tails see paragraph 3.3 at Figure 3.18 and 3.19).

Figure 2.6: View Menu.

In the View menu you have a list of the main toolwindows of EyesWeb. Here you can add or removethese tool windows (Main Toolbar, Window Toolbar,System Toolbar, Design Toolbar, Status Bar, Catalogs,Search, Properties, Message Console, Navigator, OpenFile Tabs) from viewing them, to customize EyesWebinterface (Figure 3.1). You can also set the zoom ofthe Patch View.

6

Figure 2.7: System Menu.

In the System menu you can manage a patch in theRun-Time phase with the Start, Step, Pause and Stopbuttons. You can manage more patches at the sametime with this commands, and you can see the timestatus of a patch with the Clock tool (Figure 3.2).Also you can determine which type of Run-Time modeshould be used for the current patch: ”Design” or ”Pro-duction” in order to select for each block in the patch,which block should be scheduled and which not.

Figure 2.8: Tools Menu.

In the Tools menu you can manage the profiling toolwith the support of the patch clock, import or exportkernel properties settings, add external tools (Figure3.9) and you can access to EyesWeb options (Figure3.10).

7

Figure 2.9: External Tools.

In the External Tool windows(Figure 3.9), you can add additional tools and externalEyesWeb facilities. You can set their parameters such as the name of the tool, his com-mand, the arguments, initial directory and others: you can configure additional parameterssuch as Autosave, Wait Program Termination and Warn Kernel Restart for each tool listedin this window.

Figure 2.10: Options.

In the Option View window (Figure 3.10) you can set all the features that you needfor your current EyesWeb project under development. The following detailed settings areavailable:

General:

• Reload open documents.

• Autosave modified documents on patch start.

8

• Save patch state in undo on patch start.

• Ask close confirmation when a patch is clocked.

• Detect patch modification outside the environment.

• Auto-Reload patch (when not modified inside the environment).

• MDI Tabbed mode.

Editor:

• Snap Objects to grid.

• Show grid.

• Grid width.

• Grid height.

• Default object orientation (left to right, right to left, top to bottom, bottom to top).

Catalog View:

• Categorized View (group blocks by catalog).

• Filters (No Filters, catalogs filter, used catalogs).

• Selected Filter Properties (Name, Available catalogs, Selected catalogs).

• Selected Catalogs are excluded (included by default).

Messages:

• Message Level Enabling (Debug, Message, Warning, Error, Critical Error).

• Default Windows Color.

• Color...

• Set Default Colors.

• Enable message logging.

• Log Folder.

• Log Disk Quota (KB) 0 means no quota.

Search:

• Object Name.

• Object Description.

9

• Library Names.

• Author Name.

• Author Description.

• Company Name.

• Company Description.

• Licence.

• Reset Search History.

Advanced:

• Process Priority Class (IDLE, NORMAL, HIGH, REALTIME).

• Default Engine Thread Priority (IDLE, LOWEST, BELOW NORMAL, NORMAL,ABOVE NORMAL, HIGHEST, TIME CRITICAL).

• Performance Profiling.

• Automatically reset profiling data on patch start.

• Catalog Classes Enabling (Kernel, External, User, select all, select none).

• Kernel (abort timeout, clock period, logs, others...).

• Device Mapping (devices).

It‘s recommended to leave default options until you have a good familiarity with theprogram.

10

Figure 2.11: Window View.

In the Window menu you can manage the EyesWebpatch windows that can be simultaneously opened.You can close one or all the windows, browse to thenext or previous one, and set the way they appear inCascade, Horizontally or Vertically appearance. In thisway you can manage the look of EyesWeb interface andyou can display the windows as you prefer.

Figure 2.12: Help Menu.

In the Help menu you can automatically check for Eye-sWeb updates, and read the general information on thecurrent EyesWeb version.

You can find the most important of these described tools and commands in the EyesWebtools bar (Figure 3.13).

Figure 2.13: EyesWeb Tools Bar.

In the first row of the bar (from left to right) there are the icons to create a new projector open an existing one; to save one patch or all the opened ones; to print a patch, or tocut, copy, past and remove one or more selected items; to undo or restore an operation;to increase or decrease the zoom of the blocks in the patch; to open the Options window;to close one or all the patch windows opened in EyesWeb; to navigate from a window toanother one; to set the favourite way to show the patch windows (Cascade, Horizontally orVertically); to manage the Run-Time step of a patch; to open or remove the Profiling Viewwindow (Figure 3.29) from the Properties window (Chapter 3.5). In the second row of thetools bar you can find additional options to manage the aspects of the patch.

11

2.2 Catalog View

In the Catalog View window the blocks can be displayed in the following two ways, accord-ingly to the ordering by group or by type:

Figure 2.14: Ordered by Blocks Group.

Figure 2.15: Ordered by Blocks Type.

The Catalog View window (Figure 3.14 and 3.15) is the frame of the EyesWeb appli-cation where are collected all the EyesWeb blocks. The blocks are grouped by categorywithin the Catalog View in a treeview; blocks are grouped into several categories:

• GUI Objects: Blocks used by the graphical user interface.

• Kernel: blocks that are in the core of EyesWeb.

• Base: blocks used to manage the basic features of EyesWeb.

• System: blocks for system dependent functionalities.

• Legacy: blocks from the previous versions of EyesWeb.

• Steinberg Technologies: blocks for audio processing.

On the top of the Catalog View window are present the two buttons: ”Toggle CatalogView” and ”Manage Filters” along with the ”Filters Bar”. With the Filters Bar you canselect only a specific group of blocks (default Catalog View shows all the groups of the

12

blocks). With the Toggle Catalog View button on the left, you can chose between two dif-ferent views of the blocks tree: ordered by group and ordered by the type of functionality.With the Manage Filters button on the right, you can open the Option Filter window, asseen in Figure 3.16, where you can: select a default filter with the ”Sel.” button, remove afilter with the ”-” button and add a custom filter with the ”+” button. You can also selecta filter to customize it with the arrow-buttons: remove and add a group of block by the filter.

Figure 2.16: Management of Catalog View Filters.

13

2.3 Search View

The Search View window (Figure 3.17) is the frame of the EyesWeb application where youcan search for the blocks of the contained Catalog View window. You have to enter thename of a block in the search box and, pressing the search button, the application willdisplay the results in the window below.

Figure 2.17: Search View.

2.4 Patch View

The Patch View window is the frame of the EyesWeb application where you can design yourpatches. Blocks can be moved in the Patch View window by dragging and dropping themin this window from the Catalog View window. The layout of the blocks is shown in Figure3.18. The black rounded rectangles are the Pins, which let the blocks to be interconnectedtogether. The left ones (inside the block border) are the ”input” pins, which representdata incoming into the block. The right ones (outside the block border) are the ”output”pins: they represent the result of the elaboration performed by this block. The top pinsare called ”parameter” pins, and they represent the data used to tune the elaboration ofthe block itself. Input pins can have at most one incoming link, trying to connect one linkto an input pin which is already connected with another one, the EyesWeb GUI will showa forbidden icon, as shown in Figure 3.19.

14

Figure 2.18: A simple EyesWeb block.

Figure 2.19: The forbidden icon tells to the user that the connection he is trying to establishcannot be done.

Blocks are connected one-another together by dragging a link from the output pin ofthe source block to the input pin of the destination block. It is also possible to draw alink from an output pin to a parameter pin. Not all connections are allowed: besides theconstraint described above (an input pin can have at most one incoming link), there areother constraints that depend on the type of the data involved in the connection. Pinswith different type of data, cannot be connected, unless EyesWeb is able to convert fromone datatype to the other one. However, whether such conversion is possible or not, theuser has not to care about it, since EyesWeb automatically shows the forbidden icon in theappropriate cases. The patch windows can be zoomed in/out by means of the appropriatemenu commands (see Figure 3.20), or by means of the keyboard shortcuts + and -, whichincrease or decrease the zoom of a 10 perc. factor. The keyboard shortcut Ctrl+0 can beused to go back to the default zoom level.

15

Figure 2.20: The zoom commands are available in the View menu and in the Main toolbar.

There are some properties to manage the look and feel of the patches during the Design-Time phase. The ”Locate” command is used to find out the location of the block withinthe Catalog View, and the ”Activate” command is used to enable or disable a block fromfunctioningh (Figure 3.21). You can also rotate the blocks and perform other graphicaloperations, like orientating and arrangement features, as shown in Figure 3.22. Thesefeatures are very useful when dealing with many blocks and links.

16

Figure 2.21: Block options. Figure 2.22: Block rotation options.

The links are used to connect a block with another one as shown in Figure 3.23. Youcan add one or more pins in each connecting, link to change the look and feel of the linkitself as shown in Figure 3.24. You can also connect one output link to more input blockpins, as in Figure 3.25.

Figure 2.23: Link.

Figure 2.24: Create a Pin on a Link.

17

Figure 2.25: Connect more blocks using the same link.

2.5 Navigator View

Figure 2.26: Navigator View.

The Navigator View window (Figure 3.26) is the frame of the EyesWeb applicationwhere you have a complete view of the patch. From this window you can navigate withinthe Patch View with the mouse, and move in the patch area if you need. From this windowyou can‘t move the blocks, but it‘s very useful if the patch is very big and takes up a lot ofspace in the Patch View.

18

2.6 Properties View

The Property View window is the frame of the EyesWeb aplication where you can viewand modify the properties of the objects selected in the Patch View. Properties can beshown in the Categorized or Alphabetic mode, according to which option button is selectedin the top-left corner of this window (just under the Params tab). In the former case,the properties are grouped together according to their meaning, whereas in the latter theproperties are sorted alphabetically. In any case, the properties are shown in two columns:the first represents the name, the second represents the value. If the value is written withbold characters it can be modified, otherwise editing is forbidden. When the property hasa structured value, a ”+” sign is placed on its left, to mean that the internal details can beshown by expanding its content (clicking on the plus sign). Once the property is expanded,its sub-components can be edited as all other properties. The same values can also be editedwithout having to expand the property and modifying the semicolon-separated values whichare shown to the right of the property name. Acting this way, besides avoiding to expandthe property, has a different behaviour if compared to the modification of the componentsone at a time. If the semicolon-separated list is edited, the overall value is set via a uniquecommand, whereas modifying the sub-components causes the intermediate values to beset. Consider the case where you have to modify the size of a matrix through a structuredproperty with two components, named width and height. If you modify the semicolon-separated value, for instance, from 30x20 to 60x40, the matrix size is changed only once. Ifyou expand the property and modify the width from 30 to 60 and then modify the heightfrom 20 to 40, the matrix size is changed twice: the first time it changes from 30x20 to60x20, the second time it changes from 60x20 to 60x40. This different behaviour have tobe kept into account when using the Properties View.

19

Figure 2.27: Block Parameters View.

When you select a block you can edit its properties and features in Properties Viewwindow as in Figure 3.27. For example you can modify the general appearance of the inputand output pins: in this example the options ”Show SyncIn” and ”Show SyncOut” areenabled, so there are two more pins in the shown block; so you can connect the blocksusing these pins. Every pin represents an input, an output or a parameter data. Anotherimportant feature of the new versions of the EyesWeb application is represented by the”Synchronization” Pins. With synchronization pins you can force the schedule calling of ablock to be executed regardless by the usual common blocks connections. To enable thisfeature, you have to add input and/or output the synchronization pins to the block, bysetting the ”Yes” value in the ”Show SyncIn” and ”Show SyncOut” parameters: new pinsfor ”SyncIn” and/or ”SyncOut” will appear on the selected block as shown in Figure 3.27,where the synchronization pins are displyed as the ”white pins”. In order to set these pinsyou can chose between three options of the ”SyncIn Mode” parameter: Exclusive, Additiveor Ignore; so, during the Run-Time phase: the ”Exclusive” option sets the block to bescheduled ”only” when this block receives a trigger signal at its SyncIn pin; the ”Additive”option sets the block to be scheduled ”also” when this block receives a trigger signal atits SyncIn pin; and the ”Ignore” option sets the block to be scheduled ”normally” usingthe standard scheduling methods, ignoring the possible SincIn trigger signal received at itsSyncIn pin. Also, the ”Run Level” parameter lets the user to decide wheter or not a blockshould be scheduled during a ”Design” period, or during a ”Production” period, in orderto add blocks to a patch for testing it, and to utilize them only for understanding how thepatch works, and, when they are no more useful for the functioning of the patch itself, theycan be excluded by the scheduling tree, simply by selecting the ”Production” value in the”System Toolbar”; so the blocks that are marked for the ”Design” mode will be scheduled

20

only if the ”Design” mode is selected, and the blocks that are marked for the ”Production”mode will be scheduled only if the ”Production” mode is selected.

Figure 2.28: Blocks Description Window.

21

Each block has its own description (Figure 3.28) where are displayed the main featuresof the block. These features are:

For the Signature:

• Label of the block.

• Class of the block.

For the Input(s):

• Name of the input.

• Datatype of the input.

For the Output(s):

• Name of the output.

• Datatype of the output.

For the Parameter(s):

• Name of the parameter.

• Datatype of the parameter.

22

Figure 2.29: Profiling View.

The Profiling View window (Figure 3.29) is the frame of the EyesWeb application wherethe status of a selected block and the status of the whole patch are shown during a specificperiod of Run-Time phase (you can pause or stop the execution of a patch anytime with thepause and stop button). In this window are shown the scheduling time information of theobjects regarding the Init(), Check(), Start(), Execute(), Stop() and Done() functions. Forexample the Init() object‘s function values reports timing infomation about the time spentduring the phase in which the block switches from Design-Time to Run-Time; the Execute()object‘s function values reports timing information about how long the EyesWeb Kernelspends time during the block‘s scheduling loop, within each block‘s execution function.

23

2.7 Message Console

Figure 2.30: Message Console.

The Message Console window (Figure 3.30) is the frame of the EyesWeb applicationwhere the messages, the error and warning notifications are displayed. This frame is usedeither by the system kernel, and by the signgle blocks that constitute a patch, and wherethe user can read various information about the state of the internal data of a patch. Itcan also be used by the patches during the developing period, where debug information areneeded to be displayed for tracing the flow of the elaborating data values. Message Consoleuses different colors to show different messages into its window. You can edit these colorssettings from the ”Messages” section of the Options Menu (Figure 3.31).

24

Chapter 3

EyesWeb command-line tool

This application executes patches from the command line or, under Windows OperatingSystem, as a system service. The most common usage is by specifing the list of patches tobe executed as comman-line arguments; in such case EywConsole executes all the specifiedpatches until the ESC key is pressed by the user on the console window. However, manycommand-line options are available to modify this default behaviour; as an example: exe-cution might be automatically stopped after a user-specified amount of time, and restartedfor a user-specified number of times.

EywConsole --help

provides the complete list of the available command-line options and their description.Since EyesWeb version 5.0.3.0, the EywConsole tool can be used as a server to run

patches remotely controlled by EyesWeb Mobile.

25

Chapter 4

Other tools

4.1 EywQuery

This executable file let you generate documentation (mainly in LaTeX format, but otherformats are supported too) for the installed EyesWeb block. This is the same tool used togenerate the Reference Part (III) of this manual.

EywQuery --help

gives an explanation of all supported command-line options.The eyw doc template.pdf file provides an example of use of the EywQuery tool to

generate the documentation of two blocks.

4.2 EywRegisterModule

This executable file let you register external plugins in order to make them available foruse in EyesWeb. The EywRegisterModule.exe must be used to register and unregister dllblocks, and can be run with the following command line options:

• dllpath1 [dllpath2 ...] indicates the dll paths

• /U unregisters the dll

• /K:kernel path specifies the Eyw kernel dll path

• /F:base path specifies the Eyw kernel base path

• /B breaks when the first error occurs

• /Q operates in quiet mode

• /? displays this help screen

26

Part II

EyesWeb internals

27

Chapter 5

EyesWeb Kernel

This Chapter is devoted to the explanation of the EyesWeb kernel. It aims at providingthe user enough knowledge on the EyesWeb internal details in order to fully understand itsbehaviour.

Since its early phases, the EyesWeb kernel has been designed to provide stability andperformance. A first consequence of this choice is the distinction between the two phasesnamed Design Time and Run Time. Whether you are using a graphical developmentenvironment or not, the kernel always goes first through the design-time phase, where thepatch is built in the system memory but it is not executed. Whenever you decide to executethe designed patch, the kernel moves to the Run-Time phase: during the transition betweenthe two phases many operations are performed. The patch is first checked for correctness,then an ad-hoc structure is built in memory to maximize the performance during execution.When the structure is ready, the patch execution is started, and the kernel is said to bein Run-Time mode. At this point, the patch cannot be modified anymore, until you goback to the Design-Time mode. The only allowed operations are the modification of thevalues of the parameters of the blocks; moreover, changes to the topology of the patch areforbidden. Another important EyesWeb feature is that the Kernel is completely separatedfrom the Graphical User Interace (GUI). In such a way that different part of the EyesWebapplication can exists without being related one to each other. These feature leads primarlyto the possibility to run a Patch without loading the EyesWeb GUI, in such a way thatthe internal kernel could be loaded, and an existent patch can be run (for example fromthe command prompt as described in the command line EyesWeb Console application -see Chapter ??); also this feature leads to the possibility of future expansion, such as apossible porting to different systems.

5.1 EyesWeb Multimodal and Cross-Modal

Processing

The new platform includes low-level support which enhances the capabilities of the systemas a multimodal framework. Besides the basic requirement to manage several datatypes ina common environment, new characteristics have been added. The first of such character-istics is the possibility to automatically transform datatypes of different, but compatible,domains. This is particularly useful when one wants to verify the effectiveness of one al-

28

gorithm which was originally designed and implemented for a very specific domain. As anexample, a FFT block working on matrices, can be easily used to work on audio stream, asthe conversion of audio buffers to matrices is automatically added by the system, withoutthe need of any explicit action on the user side.

Another important feature is the possibility to design and develop block which may workof a whole family of datatypes. Where the previous version of EyesWeb could distinguishamong specific block (working on a given datatype)or general purpose blocks (working on alldatatypes), this new version let one to specify the characteristics of the supported datatypes.This enable the development of blocks working on homogenous set of datatypes, withoutthe need to know them in advance, thus, it does not limit the expansibility of EyesWeb.Referring to the above FFT example, a better designed block could exploit such featureand work natively on both the audio buffer and the matrix datatype, as they share somecommon characteristics (they both implement a common interface). This approach has thefurther advantage by a performance point of view, as it avoids consuming processing powerfor the datatype conversion.

Cross-modal processing is furtherly supported by the timestamping of datatypes, whichhas been greatly enriched in this version of EyesWeb. Each datatype is associated with aset of timestamp which let the kernel to synchronize them according to different needs. Foreach sample, EyesWeb can obtain:

a creation time.a presentation time.a media time.a sample duration, and, finally.a media duration.

• Creation time gives an indication of the instant that the datatype was written, thusit carries information about the time needed to process data.

• Presentation time are the preferred source for synchronization, as they take informa-tion about the actual time instant that the datatype represents. It is independentof the processing time: as an example a block finding the peak value in an audiobuffer will give, as presentation time of the output peak value, the absolute index ofthe peak sample in the whole stream, and this is independent of the time needed tocompute such value, or the time of any previous computation.

• Media time represents the timestamp of the datatype relative to the original source;hence, it is also allowed to decrease during run time; this may happen, for instance,when the original source is a media file and it is rewinded during execution.

• Media duration represents the duration of the original stream if available: in the caseof media files it may represent the duration of the file itself, whereas in the case oflive sources it is usually unknown.

• Media duration finally represents the duration, in time, of the datatype, and it may beused to understand whether the signal is sampled at high frequencies (shot duration)or low frequencies (long duration), and to adapt the scheduling policies accordingly.

29

5.2 EyesWeb blocks

Blocks are probably the most important objects in EyesWeb, at least from the user’s pointof view. Blocks represent an operation, from very simple to very complex, that can beperformed on data. Blocks can also be the generators or the renderers of data; thus, blocksare the objects responsible to generate, modify, and consume data in EyesWeb. There is norestriction on the complexity of the operation, as well as no constraint is given on the type ofdata handled by blocks. Thus, at kernel level, blocks are simply objects which may receivedata as input, and may generate data as output. Both inputs and outputs are optional:a generator block does not receive any input, and a renderer block does not produce anyoutput. The operation can be tuned, both during the design-time phase or during therun-time phase. To perform such tuning the blocks are allowed to have parameters. As itis the case with inputs and outputs, parameters can be of any type and in any number. Inmany cases, the difference between parameters and inputs is not straightforward: a blockthat acts on an image and it is tuned by means of a number (e.g., the threshold block),might be represented as a block acting on two input (the image and the number) at thesame time. In some cases, the difference between what is classified an input and what isclassified a parameter lays on the speed at which they change their value. Although this isa reasonable distinction, it is not the only possibility to distinguish among them: in othercases the reason may be more conceptual then technical, e.g., the threshold block whichworks on images can be clearly described as a function from images to images, where theinteger value is only a tuning parameter.

There are blocks performing several different types of operations. There are blocksworking on compressed or uncompressed images, sound, midi, numbers, matrices, and manyothers. Blocks are classified into libraries, however, this classification is mainly done tosimplify users when searching for most appropriate operation, and there is no constraint orlimitation in the interoperability of blocks coming from different libraries.

Inputs, output, and parameters of blocks define the signature of the block: each of thiscomponents must have a type of data associated with it. The signature of blocks can changeat design-time, in response to user choices or external events. However, once the patch isin Run-Time mode, the signature cannot change anymore, until it returns in Design-Timemode.

5.3 EyesWeb datatypes

Datatypes are the objects which transport data among blocks, when the system is in Run-Time mode and the patch is executed. They are responsible to store data, to provideserialization to binary of text streams, to copy instances of datatypes, and to swap thevalue of datatype instances in an optimized way.

Storing data is the basic responsibility. It means that datatypes are responsible to allo-cate the memory (resources) needed to store the value of tha datatype (e,g., huge memoryarea for image datatypes, few bytes for integer or double datatypes, etc.). Serialization isneeded when the patch is saved on a file, and the value of datatypes need to be saved too.Serialization may also occur when datatypes are sent through communication channels suchas network or serial ports. Serialization may occur toward text or binary streams. When

30

the patch is saved to a file, serialization to text stream is needed, as the patch format isxml , which is a text format, commonly used for exchanging data by lots of commerical ap-plications. In such cases the datatype should save its value in a human readable text string.Serialization to binary streams is needed, for instance, when the datatype is sent throughthe network. In such cases, the binary format is preferred for its compactness, which mightpreseve network bandwidth. Of course, in both cases, also unserialization is needed: thisimplies that the datatype must be able to get an updated value, starting from a binary orfrom a text stream. The EyesWeb SDK provides facilites to build text serialization basingon the binary serialization, thus developers might avoid to provide both formats. However,this facility cannot produce a human-readable text stream; thus, it is recommended thatthe developer provides both forms of serialization.

Copying a datatype might occurs in several occasions. Copying datatypes might beexplicitly requested by developers, or it might be requested by EyesWeb to keep coherentdifferent datatype instances. When copying occurs, two datatype instances are involved:both datatypes are of the same type (e.g., two images) and have the same characteris-tics (e.g., same resolution and depth). When these constraints are not met, the destina-tion datatype is allowed to throw an exception; if the conditions are met, the destinationdatatype must assume the same value of the source datatype, without altering the value ofthe source object. The EyesWeb SDK provides a facility to avoid implementing the copyoperation; as a matter of fact, copy may be performed by serializing the source datatype ona binary or text stream, and asking the destination datatype to unserialize from the samestream. Although this method is legal and should always work, it is recommended to buildthe implementation of the copy operation, as it may probably be implemented in a moreoptimized way.

Swapping datatype instances mainly occurs when trying to optimize the implementationof blocks or other EyesWeb objects. Swapping datatypes involves two datatype instances,which should exchange their values. Of course, swapping might be performed by using atemporary datatype instance and the copy operation. The EyesWeb SDK provides thisbasic facility. However, for many datatypes, swapping may be implemented more optimallyif the datatype implementation is assumed to be known. In the case of images, for instance,swapping may be implemented by simply exchange the value of two pointers, instead ofcopying huge memory buffers three times (which is the number of copy operations that isused by implementing swap with a temporary intermediate instance).

5.4 EyesWeb datatype converters

Datatype converters are objects which can convert from one datatype to another one. Aswith all other objects, they can be both in the user catalogs or in the embedded catalogs(system and kernel catalog); this means that developers, besides providing their customdatatypes, can also provide converters to guarantee interoperability of their datatypes withthe existing ones. Datatype converters are automatically inserted in the patch when needed,without the need of user intervention. Furthermore, the user can also place them explicitlyvia some kernel blocks. This might be useful, for instance, when one wants to measure theoverhead caused by the conversion, by explicitly measuring the processing time consumedby each converter.

31

Converters should be able to convert both the datatype value and the initialization data.When converting values, they should keep into account the initialization data of the sourceand destination datatypes. When converting initialization data, they should choose themore appropriate destination type, if more than one conversion is possible.

When deciding which converters to implement, consider that EyesWeb is able to buildconversion chains to perform complex conversion. This means that developers should notworry to provide conversion toward all (reasonable) existing datatypes, but they can focuson the main ones (e.g., system and kernel datatypes). If this strategy is respected fromdevelopers, the maximum interoperability could be reached.

5.5 EyesWeb datatype domains

Datatype domains are the objects which define the admissible value for datatypes. Theycan tell whether a value is inside the domain or they can bound a value to the domain(i.e., if the value is not inside the domain it is modified to the nearest value which isinside the domain). Domains are applied to parameters only, not to input values. This isdue to performance reasons, as parameters are supposed to change slowly if compared todata streams (travelling through input/outputs), thus using datatype domains to check thedatatype validity does not provide an heavy burden.

5.6 EyesWeb datatype layouts

Datatype layouts are responsible of the graphical layout of datatypes, i.e., of their appear-ance in the EyesWeb Graphical Environment. As an example a block that needs a file nameto work, will declare a parameter of type string, with a layout specifying that the string isa filename. This modifies the behaviour of the graphical environment and let the user usea file open/save dialog to edit the string.

Cleary, the filename case is a very simple one. Layouts can be much more complex, andcan be associated to complex dialogs where the datatype is edited, for example in the caseof a matrix parameter datatype.

5.7 EyesWeb devices

Devices are the EyesWeb interface toward hardware. Devices come with an enumerator,that, given a specific class of devices (which relates to a specific class of hardware) providesthe list of such available devices with the system. Enumerator is also responsible to find anunique identifier for such device. Since hardware configuration is highly variable from a pcto another one, EyesWeb provides a mean to map virtual devices, which are the one usedby blocks, to actual devices. Such mapping is performed automatically by EyesWeb, but itcan be customized by the user via the EyesWeb control panel application.

32

5.8 EyesWeb clocks

EyesWeb maintains an internal clock during the execution of a patch in the Run-Time mode,and a clock is associated to each Patch that is running on the system; Each clock is resetevery time the GUI switches from Design-Time mode to Run-Time mode, and begins toincrease when a Patch begins its Execution; so, different running patches can have differentclocks according to the moment in which each different patch is executed, switching fromthe Design-Time mode to the Run-Time mode. The time handled by EyesWeb is displayedinto the green panel over the tool bar in the upper side of the EyesWeb application frame,according to the currently selected running patch.

5.9 EyesWeb Scheduling

EyesWeb scheduling mechanism is very powerful, as it takes advantage from previous expe-rience and from the requirements emerged from the use of the previous EyesWeb versions.

Its default behaviour is to work in single-clock mode, however, in the future it will beable to support working with multiple clocks for special applications. Single-clock modemeans that the reference time is provided by an unique object per patch, which avoid jittersamong different clocks.

The basic principle that drives scheduling in EyesWeb is very simple: when an eventoccurs, explore the list of blocks in order, and activate a block if needed. Of course, thereare some points that have to be clarified: What is an event, and in which order the blockswill be scheduled, or when does one block need to be activated? All of these points will befurtherly discussed in the following sections. Clearly, they are not simply implementationdetails, as they make the above-written simple statement a powerful scheduling mechanism.

5.10 EyesWeb Initialization

The first step in the EyesWeb Initialization procedure is done in the phase in which theapplication switches between Desing Time mode and Run Time mode. During this phase,important works are done, including checking the consistency of the various blocks formingthe patch that is going to be run. EyesWeb first checks for the correctness of the linksbetween the blocks: if the output of a block becomes the input of another block, then, acheck for the data-passing between the two blocks is done; if the output is of the samedatatype of the input, then no conversion is needed; instead, if the input is of anotherdatatype then a datatype convertes is needed for passing correctly the data between thetwo mentioned blocks. If there exists a suitable datatype converter between the datatypeof the output of the first block and the datatype of the input of the second block, thenthat datatype (automatic or not) converter could be collocated along the link between thetwo blocks: so, the conversion needed to prepare data to be used from the second blockis made from that converter; embedded datatype converters are offered by EyesWeb, thatimplements the conversions between the main datatypes in an optimized way to avoid CPUtime consuming. If the user does not insert the converter, and a suitable datatype converterdoes exist, then EyesWeb automatically create its instance and collocate it in order to makepossible the connection between this two kind of datatype links.

33

5.11 The execution sequence

The simplest layout of a consistent patch is composed by a chain of blocks, in which thefirst block generates an output, that is the input of the second block; then, this secondblock generates an output which is the input of the third block, and so on, until the lastblock in the chain is reached, which receives the unique output of the preceding block, andgenerates no output and the sequence of passing data between blocks is terminated.

When instead blocks receive one or more input data from different blocks that are ’topo-logically subsequent’ to themselves, the kernel keeps particulary attention to the sequencein which data are passed through the input/output pins of each block; this is because theoutput of another block could not be coherent at the moment in which that block is readyto be scheduled. This kind of problem arises when a particular structure of a patch iddesigned, in which there could be present some looping-back datatypes that are generatedas output by one subsequent block, but that are used as input by some blocks that are’before’ in the above chain; in this case is up to the kernel to detect possible conflict statesin which an indecisiveness link could be reached; in that case the patch can’t be run anda message is displayed to the user warning him that in this case the patch topology designmust be changed in someway, in order to remove the indicated indeterminated behaviour.

34

Chapter 6

EyesWeb Flow Control

EyesWeb provides blocks to manage the flow of data inside a patch. This chapter describessuch blocks.

6.1 For Loop

The ForLoop is a type of subpatch which iterates the execution of the block in a patchfor a number of times. Its main purpose is to use standard blocks to deal with items ina collection, which otherwise could not be done unless developing custom blocks. The useof the ForLoop block is explained by referring to patch for loop.eywx which is distributedwith EyesWeb and is depicted in Fig. 6.1 and 6.2.

Figure 6.1: The tutorial patch to explain the ForLoop block.

The patch is quite simple: a vector is generated and a FunctionEvaluator block isapplied to each item of the vector. Note that the FunctionEvaluator block does not dealwith vectors, but it deals with scalar items; thus, the ForLoop in this case is the onlyway to apply the FunctionEvaluator block to the vector, as there is no such block which

35

Figure 6.2: The ForLoop subpatch used in the ForLoop block tutorial.

36

natively works with the vector datatype. The following is a sketch of the pseudo-algorithmimplemented by the patch:

• Generate a new vector of size N

• For each i item in the vector

– Extract item i from the vector (note: the extracted item is a scalar number)

– Apply FunctionEvaluator block to such scalar item

– Insert the scalar result as item i of the vector

The algorithm is quite straightforward, let’s not analyze how it is implemented as anEyesWeb patch. The first block on the left (see Fig. 6.3) generates a vector of floating-point numbers. The user can specify the values of each item in the vector by setting themin the parameters of the block. Following the generator block there are other two blocks:the MatrixGetDescription block (Fig. 6.4) and, below it, the ForLoop block (Fig. 6.5).The MatrixGetDescription block simply extract the size of the vector, i.e., the number ofcolumns; the result is passend as a paramater to the ForLoop block, as the EndIndex. Asa matter of fact, the ForLoop block can be controlled by specifing the start index of theloop, the end index, and the step by which the index is increased at each iteration. Notethat the loop is executed with index going from Start Index to End Index - 1 (i.e., theStart Index is included, the End Index is excluded). The ForLoop block is a subpatch,thus, double-clicking on it will open another content which represents the blocks which areiterated. The subpatch is visible in Fig. 6.2.

Figure 6.3: The Vector generator block. Figure 6.4: The Vector generator block.

Figure 6.5: The Vector generator block.

The subpatch starts with a Subpatch Input Pin, i.e., the block on the left with a verticalrectangular icon (Fig. 6.6). This block provides the input data of the block inside the

37

subpatch, thus, the output of this block is the same as the input of the block, i.e., theinput vector. However, at each iteration loop, the output can be different as it will beexplained later. The output of this block goes to the GetItem block (Fig. 6.7), whichextract an intem from the vector. The index of the item to be extracted is provided bythe ForLoopIndex block (Fig. 6.8), the one above the input pin block, which, at each loop,provides the current value of the index as output, that is, 0 on first iteration, 1 on seconditeration (assuming Step is set to one), etc. The index is passed as an argument to theGetItem block, which extract the given scalar value. The extracted value is given as inputto the FunctionEvaluator block (Fig. 6.10), the FunctionEvaluator block also receives theloop index as input, as the function it computes is choosen by the user to be dependant onboth the current value of the item in the vactor and the index. Of course, the user couldhave decided to use other inputs too (e.g., the current time, the value of item i− 1 in thevector the size of the vector, etc.). Finally, the output of the FunctionEvaluator evaluatorblock is fed, as a parameter, to the SetItem block (Fig. 6.11) which receives the currentvector as an input and changes the value of the given item. The output of the SetItem goesto the Subpatch Output Pin. From here, the resulting vector can be fed back to the inputpin, which occurs on every iteration except the last one, or it can be sent to the output pinof the block, which occurs on last iteration.

Note that the feedback to the input pin is not the default behaviour, you have to specifyit in the input pin. in facts, the input pin block has a parameter named Feedback pin, whichis set to None by default. From the dropdown combo-box you have to select the pin fromwhich to get the feedback12.

It is noteworthy that, by means of the ForLoop block, you have the a sort of possibilityto change, at runtime, the structure of the patch, which is usually not allowed in EyesWeb.In facts you may think of the content of the loop as a pattern which is repeated severaltimes, and the number of times can change at runtime. Thus, the above loop iterated Ntimes might be similar to the patch of Fig. 6.123

As a final remark, let’s look at the three unconntected parameter pins which are availableinside the subpatch (Fig. 6.13). They have not been used in our example, but they mightbe useful in some cases. They represent the Start Index, the End Index, and the Stepparameters. They might be used, for instance, to verify whether the current iteration is thefirst one (Start Index equal to ForLoopIndex) or the last one (End Index plus one equal toForLoopIndex).

1Rationale for having the choice in the input pin instead of the output pin. Specifing this in the outputimplies a signature of the output pin with a variable number of parameters, which is sometimes a bit moretricky to be used.

2Rationale for not having an explicit graphical link from the output pin to the input. There are differentreasons; firstly, the user is used to see input and output pins as starting or final blocks; thus, an outgoinglink from the output pin or an ingoing link to the inpit ping might sound a bit strange. Secondly, thefeedback is vary common in the loop and adding a graphical link to represent it might add confusion tocomplex subpatches; since the user knows that this normally happens, the price for the additional possibleconfusion does not worths.

3Just similar to that, not the same! If you use blocks that have an internal status, such as the counterblock which keeps the current count internally, you have to keep in mind that the block instance is alwaysthe same. Thus, if you count the inputs, the counter is incremented at each iteration!

38

Figure 6.6: The subpatch input pin block. Figure 6.7: The GetItem block.

Figure 6.8: The iteration index block. Figure 6.9: The SetItem block.

Figure 6.10: The Function Evaluator block. Figure 6.11: The subpatch output pin block.

Figure 6.12: A sketch of the unrolling of the ForLoop subpatch.

39

Figure 6.13: Additional parameters are available inside the subpatch to check whether thecurrent iteration is the first or the last one.

40

Chapter 7

EyesWeb Image Processing

Many of the available EyesWeb blocks are devoted to image processing. For most of theimage processing operations, the user is free to choose beside CPU-base vs. GPU-basedoperations . Some of the concepts of the image processing libraries are common to boththe CPU-based or GPU-based approaches; such common concepts will be explained in thefollowing sections.

7.1 Floating-point and integer coordinates

In most blocks operating on images coordinates may be expressed either as floating-point(double precision) or integer numbers. The main difference between the two approachesis that floating-point coordinates are normalized in the range (0.0, 1.0) , whereas integercoordinates are directly interpreted as the zero-based pixel coordinates. In the floating-point case, normalization is perfomed indipendently on the width and height of the image:thus, (0.5, 0.5) is always a point in the center of the image, even if the image is not square.Both approaches have pro and cons. The main advantage of the normalized mode is thatwhen the resolution of the source image is changed, the floating-point parameters of theblocks operating on images do not need to be changed; converserly, integer coordinatesneed to be adapted to the new image resolution. The main advantages of the integercoordinates are precision and interoperability. With precision we mean that a positionexpressed in integer coordinate refers exactly to one pixel of the image; in the floating-point case the position of the corresponding pixel cannot be deduced in a straightforwardway, as rounding errors (during denormalization and conversion to integer) might affect theresult. With interoperability we mean that the integer coordinates are the ones commonlyused in image-processing software; thus, if you look for the position of an object in an imagewith a third-party software (e.g., GIMP, Microsoft Paint, etc.), you will obtain a couple ofinteger values.

7.2 ROI management

ROI stands for Region Of Interest, and represents a rectangular area that may be eithersome part of the image or the whole image. Image processing can operate on such areainstead of on the whole image area. The ROI of an image is defined by the size (in pixels)

41

sec:image_processing::cpu_vs_gpu

and an offset (in pixels) with respect to the top-left corner, which has coordinate (0, 0). Ifa ROI is applied to an image, then image processing applies only to such part of the image,instead of the whole image. The ROI is applied by means of the SetROI block. Note thatin the SetROI block, as well as in all blocks which provide a ROI parameter, you can set theROI to null; this is a sort of shortcut to specify that the ROI cover the whole image; thus,setting ROI to NULL in the case of an image of size (720, 576) is equivalent to saying thatthe ROI has origin (0, 0) and size (720, 576). The advantage of using the NULL flag is thatyou do not need to change the size, in the case that you decide to modify the size of theimage on which your patch is operating. Note that a NULL ROI is different from an emptyROI. A NULL ROI means that operations will be applied to the whole image, whereas anempty ROI (which is specified by setting width or height to 0) means that operations willbe applied to no pixels.

7.3 CPU- vs. GPU-based processing

EyesWeb offers the possibility to process images basing on CPU or GPU (Graphical Pro-cesssing Unit, i.e., the processor which is mounted on the video card). From the user pointof view, the choice is done by instantiating a different datatype on the source block. ForCPU-based processing you should instantiate the image datatype, wheres for GPU-basedprocessing you can choose between the OpenGL datatype or the CUDA datatype. MostEyesWeb blocks which generate images as output, provide a selector to let you choose be-tween all the available datatype installed in the system. If such selector is not available,you can use the blocks named HostToDevice and DeviceToHost (several variants are avail-able, according to the underlying technology used, e.g., CUDA, OpenGL, etc.) to movethe image between system memory (accessed by the CPU) and device memory (accessedby the GPU), and viceversa.

Currently, the available choices are:

• Image: processing is CPU-based and most operations are implemented basing onthe Intel IPP Libraries; thus, they are optimized for Intel processors (should this berenamed Intel-Image or IPP-Image?).

• CG-Image: processing is performed by the GPU and is based on the OpenGL libraryand on the CG toolkit. In theory, it should work with any recent graphic cardsupporting OpenGL.

• CUDA-Image: processing is performed by the GPU and is based on the CUDA frame-work by NVIDIA. This is the solution providing the maximum performance: a goodgaming video card (e.g., NVIDIA CGX 2xx) may surclass a modern processor (e.g.,Intel i7) with a factor of 10, and even more1. Moreover, the same solution could takeadvantage of dedicated processing cards (e.g., NVIDIA Tesla cards).

the implementation of other alternative might be considered in the future2

1The comparison refers to commonly used EyesWeb patches, such as the one performing backgroundsubtraction

2 Some hypothesis are the following:

42

7.3.1 Datatype interfaces

The possibility to easily choose between different implementations of the image datatypeis mainly due to one feature of EyesWeb, namely, the availability of blocks requiring spe-cific interfaces on the input, instead of requiring specific datatypes. As an axample, thepossibility to apply a convolution filter to an image, takes advantage of the IImageFilterinterface; the corresponding block ImageFixedFilter does not require the input to be animage; it only requires the input to implement the interface IImageFilter. All the availableimplementation of the image datatype support this interface, thus, the ImageFixedFilterblock can be used on all such datatypes. Moreover, thirdy-party datatypes can be usedwith the already existing blocks by satisfying the same requirement.

Image processing is currently based on a set of general-purpose inerfaces, such as arith-metical operations, and on other interfaces which are more specific to the Image Processingdomain. The general pupose interfaces are:

• IArithOp

• IMonadiArithOp

• IMonadiLogicalOp

• IScalarArithmeticOpDouble

• IScalarArithmeticOpInt

• IThresholdOpDouble

• IThresholdOpInt

The interfaces more specific to the image processing domain are the following:

• IImageFilter

• IImageMirror

• IImageConversion

• IImageOptimizedFilter

• IImageResizePlacement

• IImageROI

• IMemoryBuffer

• AMD/Freewave-Image: processing would be CPU-based and most operations would be implementedbasing on the AMD Freewave; thus, they would be optimized for AMD processors.

• DirectX-Image: processing would be performed by the GPU and would be based on the DirectXlibrary (and on the language to perform operations on textures).

• Stream-Image: processing would be perfomed by the GPU and would be based on the ATI Streamtechnology, which is the ATI altenative to the NVIDIA CUDA technology.

43

Finally, there is a set of interfaces which are more focused on visual output, such asinterfaces to draw on the image, or to present the image to the user via DirectX or OpenGL:

• IImageCopyToDXTexture

7.4 Background subtraction

Among the Image Processing operations, Background Subtraction techniques are of com-mon use in many EyesWeb applications. EyesWeb provides support for many well-knowntechniques; moreover, other methods can be implemented by composing together simpleimage processing operations to build the formulas required by the specific technique. Asan example, the most simple technique, which is based on subtracting a fixed backgroundimage from the current image, is not directly supported. However, the blocks to build suchtechnique are available in EyesWeb (Snapshot to store the background image, ArithOp toperform the absolute subtraction, Threshold, etc.) and some example patches are providedwhich implement this simple method.

In the following section, we briefly describe the techniques for which EyesWeb providedirect support.

7.4.1 PFinder

PFinder uses a simple scheme where the background model is represented by a single valueper each pixel. The background model is updated, for each visible pixel, with the followingformula:

Bt = (1− α)Bt−1 + αIt (7.1)

44

Part III

Reference

45

Chapter 8

Kernel Catalog

8.1 Blocks

8.1.1 Arithmetic

bitmap

class name Arithmeticcatalog name Kernelcatalog id kernelclass id arith op

authorsAndrea RicciMassimiliano PeriPaolo Coletta

Perform an arithmetic operation on different datatype classes. The inputs must be ofthe same type.

Remarks This block perfoms an arithmetic operation between two (or more) datatypes.It supports any datatype which exposes the IArithOp interface (e.g., images,audio, double,int, etc.)

Error and Warning Messages

During Initialization Phase - Input types are different - Input types are of thesame type but have been initialized with different caracteristics. - The number of inputs ofthe signature does not match the value specified by the parameter of the block.

46

Inputs

Input 1id input 1type Kernel, Generic datatypetype id kernel, generic datatype

requiredrequired for initializationrequired for execution

read only/read write read writereferred as inplace *no*referred as inherited Output

This input represent the 0th operand involved in the operation.

Required interfacesKernel, Arithmetic Operations

Input 2id input 2type Kernel, Generic datatypetype id kernel, generic datatyperequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*



Outputs

Outputid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input 1inherited id *no*

Block output. It contains the result of the specified operation.

Output indexid chosen inputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Index of the max/min value. Has not meaning for the other options.

47

Parameters

Operation typeid op typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:SumSubtractMultiplyDivideMaxMinAbsolute difference

domain [ 0, 7 )Select the type of operation that will be performed on the input datatypes. The absolute

subtraction operation subtracts the operand from the current datatype if the current. Theresult is always written to the current datatype.

Number of inputsid num inputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Specifies the number of inputs of this block.

48

8.1.2 BangGenerator

bitmap

class name BangGeneratorcatalog name Kernelcatalog id kernelclass id bang generator


Bang generator

Outputs

Bangid bangtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Bang

Parameters

BangGeneratorid bangtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Bang generator (kernel catalog)

Patch startid patch starttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang when the patch starts.

KeyPressid key presstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang when a key is pressed in the main EyesWeb application.

49

KeyReleaseid key releasetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang when a key is released in the main EyesWeb application.

Keyid keytype Kernel, AcceleratorKey datatype.type id kernel, acceleratorkey

Specifies the keyboard code generating the event. It is ignored if KeyPress is set tofalse.

System KeyPressid system-key presstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang when a key is pressed even outside the main EyesWeb application.

System KeyReleaseid system-key releasetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang when a key is released even outside the main EyesWeb application.

SystemKeyid systemkeytype Kernel, AcceleratorKey datatype.type id kernel, acceleratorkey

Specifies the keyboard code generating the event. It is ignored if SystemKeyPress is setto false.

Periodicid periodictype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang periodically.

Periodid periodtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Period is expressed in 100nanoseconds unit (i.e., 10milliseconds must be specified as100000)

50

Phaseid phasetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Phase

Absolute timeid absolutetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang at a specified absolute time.

AbsoluteTimeid absolute time instanttype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Absolute time

51

8.1.3 BlockPlaceHolder

bitmap

class name BlockPlaceHoldercatalog name Kernelcatalog id kernelclass id block placeholder


Replaces one block that, for any reason, could not be instantiated.

52

8.1.4 BoolGenerator

bitmap

class name BoolGeneratorcatalog name Kernelcatalog id kernelclass id bool generator


Generates bool values

Outputs

Valueid outputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Value

Parameters

Valueid valuetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Value

Continuous outputid continuous outputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies wether the output is always generated (true) or only when the value changes(false)

53

8.1.5 CompareWithValue - double

bitmap

class name CompareWithValue - doublecatalog name Kernelcatalog id kernelclass id comparison op double


Compare to value (double). This block performs a comparison between the inputdatatype and a given double (floating point) number The block requires an input whichsupports the IComparisonOpDouble interface; examples of such datatypes are Int, Double,Byte, etc. The block has a double (floating point) parameter which is the scalar valueinvolved in the operation. If the comparison operation is verificated then the output is setto 1 value, otherwise is set to 0.

Inputs

Inputid inputtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read onlyreferred as inplace *no*referred as inherited *no*

Input before comparing datatype.

Required interfacesKernel, ScalarComparisonOpDouble

Outputs

Outputid outputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Result of comparison operation.

54

Parameters


layout

Combo Box:Less Than (¡)Less Than or Equal To (¡=)Equal To (=)Different From (!= or ¡¿)Greater Than (¿)Greater Than or Equal To (¿=)

domain [ 0, 6 )Select the type of operation that will be performed on the input datatype.

Valueid valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Value to compare (double)

55

8.1.6 CompareWithValue - int

bitmap

class name CompareWithValue - intcatalog name Kernelcatalog id kernelclass id comparison op int


Compare to integer value. This block performs a comparison between the input datatypeand a given integer number The block requires an input which supports the ICompar-isonOpInt interface; examples of such datatypes are Int, Double, Byte, etc. The blockhas a int parameter which is the scalar value involved in the operation. If the comparisonoperation is verificated then the output is set to 1 value, otherwise is set to 0.

Inputs




Input before comparing datatype.

Required interfacesKernel, ScalarComparisonOpInt

Outputs


Result of comparison operation.

56

Parameters


layout



Valueid scalar valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Value to compare with the input pin.

57

8.1.7 Comparison

bitmap

class name Comparisoncatalog name Kernelcatalog id kernelclass id comparison op


Perform a comparison on the inputs.

Inputs




This input represent the 0th operand involved in the comparison.

Required interfacesKernel, Comparison Operations


This input represent the 1th operand involved in the comparison.

Required interfacesKernel, Comparison Operations

58

Outputs



Parameters


layout


domain [ 0, 6 ]Select the type of comparison that will be performed on the input datatypes.



59

8.1.8 ConstantGenerator - double

bitmap

class name ConstantGenerator - doublecatalog name Kernelcatalog id kernelclass id double const generator


Generates constant floating-point numbers

Outputs

Output Valueid outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output Value of the constant.

Parameters

Input Valueid valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Input value of the constant.



60

8.1.9 ConstantGenerator - int

bitmap

class name ConstantGenerator - intcatalog name Kernelcatalog id kernelclass id int const generator


Generates constant integer numbers

Outputs

Output Valueid outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Output Value of the constant.

Parameters

Input Valueid valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Input value of the constant.



61

8.1.10 DatetimeGenerator

bitmap

class name DatetimeGeneratorcatalog name Kernelcatalog id kernelclass id date generator


Datetime Generator

Outputs

Datetimeid datetimetype Kernel, Datetimetype id kernel, datetimeinplace id *no*inherited id *no*

Datetime

Parameters

Generation typeid generation typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CustomCurrent local time

domain [ 0, 2 )Generation type

Datetime stringid datetimetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Datetime string formatted YYYYMMDDThhmmss

62

8.1.11 Delay

bitmap

class name Delaycatalog name Kernelcatalog id kernelclass id delay


Delays the input datatype of given amount of time. The time is expressed in millisec-onds.

Inputs




Input datatype which will be delayed before being sent out. The block doesn’t stop theexecution of the patch during the time of delay.

Outputs

Outputid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Inputinherited id *no*

Output datatype (delayed)

Parameters

Delayid delaytype Kernel, Time datatype (Kernel Catalog).type id kernel, time

63

The amount of time after wich the input datatype is propagated to the output.

Resetid resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Reset the status of the block by discarding the datatypes being stored. New datatypeswill be processed normally (i.e.., will be delayed)

64

8.1.12 Double matrix generator

bitmap

class name Double matrix generatorcatalog name Kernelcatalog id kernelclass id doublematrix generator


Generates as output the matrix provided as a parameter.

Outputs

Matrixid outputtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Matrix

Parameters

Matrixid valuetype Kernel, Double matrix.type id kernel, double-matrix

Matrix


Continuous output

65

8.1.13 DoubleGenerator

bitmap

class name DoubleGeneratorcatalog name Kernelcatalog id kernelclass id double generator


Generates double numbers

Outputs

Valueid outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Value

Parameters

Valueid valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Value



66

8.1.14 ForLoop

bitmap

class name ForLoopcatalog name Kernelcatalog id kernelclass id for loop


A ForLoop let you execute the subpatch a finite number of times. The input andparameters are sampled only before starting the loop, the outputs are generated at the endof the loop. In the contained patch, the block is seen as if it was executed a single time.

67

8.1.15 ForLoopIndex

bitmap

class name ForLoopIndexcatalog name Kernelcatalog id kernelclass id for loop index


When used inside a ForLoop subpatch, provide the index of the current iteration loop.

Outputs

Outputid outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

This output is the current index of the loop iteration

68

8.1.16 GetCurrentTime

bitmap

class name GetCurrentTimecatalog name Kernelcatalog id kernelclass id get current timeauthors Alberto Massari

Gets the value of the current time from the clock

Outputs

Outputid timetype Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

Parameters

Time selectorid selectortype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Current timeStep time

domain [ 0, 2 )Specifies whether to extract current time or step time (which is the time at which the

current activation steps started)

69

8.1.17 GetSpecialFolder

bitmap

class name GetSpecialFoldercatalog name Kernelcatalog id kernelclass id get special folder


Extracts the value of some special EyesWeb folder, e.g., the folder where the kernel isinstalled, or the folder where the patch was saved.

Outputs

Folderid foldertype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

The queried folder

Parameters

Special Folder Typeid folder typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:KernelFolderPatchFolder

domain [ 0, 2 )Specifies which type of folder to query. - KernelFolder: the folder where the EyesWeb

kernel dll currently in use is located - PatchFolder: the folder where the currently runningpatch is located

70

8.1.18 Input selector

bitmap

class name Input selectorcatalog name Kernelcatalog id kernelclass id input selector


Let one choose which inputs is copied to the unique output. It works as a multiplexerblock.

Remarks Inputs must be of the same type.

Error and Warning Messages -DURING INITIALIZATION PHASE. -An input of theblock is NULL: This is usually caused by a disconnected input or by blocks excluded fromexecution. -Input types are different: there are at least two inputs of different type. -Inputtypes are of the same type but have been initialized with different caracteristics: inputs areset with different chracteristics. -The number of inputs does not match the value of thecorresponding parameter.

Inputs




0 input of the block.

71

Input 2id input 2type Kernel, Generic datatypetype id kernel, generic datatyperequired noread only/read write read writereferred as inplace *no*referred as inherited *no*

1 input of the block.

Outputs


Output of the selector. It is equal to the specified input.

Parameters

# inputsid num inputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the number of inputs of the block. The minimum is 1, even if this case ismeaningless. At least two inputs should be used for normal operations.

Active inputid active inputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 2 )

Zero-based index of the active input. The selected input is propagated to the output.

Activate on selector changeid activate on selection changetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true, the block is activated when ”active input” parameter changes value, even if theinput is not changed. —REMARKS— Inputs must be of the same type. If not, the blockstops the execution of the patch. — ERROR AND WARNING MESSAGE — - DURINGINITIALIZATION PHASE -

72

8.1.19 Int matrix generator

bitmap

class name Int matrix generatorcatalog name Kernelcatalog id kernelclass id intmatrix generator


Generates as output the matrix provided as a parameter.

Outputs

Matrixid outputtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Matrix

Parameters

Matrixid valuetype Kernel, Integer matrix.type id kernel, int-matrix

Matrix


Continuous output

73

8.1.20 IntGenerator

bitmap

class name IntGeneratorcatalog name Kernelcatalog id kernelclass id int generator


Generates integer numbers

Outputs

Valueid outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Value

Parameters

Valueid valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Value



74

8.1.21 Logical

bitmap

class name Logicalcatalog name Kernelcatalog id kernelclass id logical op

authorsMirko DemurtasRoberto Sagoleo

Perform a logical operation on different datatype classes. Inputs must be the same type.


During Initialization Phase - Input types are different. - Input types are of thesame type but have been initialized with different caracteristics. - Failed to complete blockinitialization. One of the inputs has not been connected.

Inputs





Required interfacesKernel, Logical Operations


75


Required interfacesKernel, Logical Operations

Outputs



Parameters


layout

Combo Box:ANDORXORNANDNORNXOR

domain [ 0, 6 )Select the type of logic operation that will be performed on the input datatypes.



76

8.1.22 MonadicArithmetic

bitmap

class name MonadicArithmeticcatalog name Kernelcatalog id kernelclass id monadic arith op


Perform an arithmetic operation on different datatype classes. The difference be-tween this block and Arithmetic block is that this block accepts only one input otherwiseArithemtic Block accepts at least two inputs.

Inputs



read only/read write read writereferred as inplace Outputreferred as inherited Output

Input value.

Required interfacesKernel, MonadicArithOp

Outputs



77

Parameters


layout

Combo Box:SqrSqrtAbsolute

domain [ 0, 2 ]Select the type of operation that will be performed on the input datatypes.

78

8.1.23 MonadicLogical

bitmap

class name MonadicLogicalcatalog name Kernelcatalog id kernelclass id monadic logic op


Perform a not operation on different datatype classes. The blobk accept only one inputvalue.

Inputs



read only/read write read writereferred as inplace Outputreferred as inherited Output

Input value

Required interfacesKernel, MonadicLogicalOp

Outputs



79

Parameters


layoutCombo Box:Not

domain [ 0, 0 ]Select the type of operation that will be performed on the input datatypes. At the

moment the block compute only not operation.

80

8.1.24 MovingArithmetic

bitmap

class name MovingArithmeticcatalog name Kernelcatalog id kernelclass id moving arith op


Perform an arithmetic operation where on operand is fixed and stored into the block,whereasthe other is the changing input. Thus, it can be used to compute, for example, cumulativevalues.

Inputs




Input value.


Outputs



81

Queue sizeid queue sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

This output contains the actual queue size.

Parameters


layout

Combo Box:SumSubtractMultiplyDivideMaxMinSubtract absolute

domain [ 0, 6 ]Select the type of operation that will be performed on the input datatype.

Window lengthid lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ -1, +infinity )

Length of the time window. -1 means infinite length.


Reset the internal operand to its original value

Saveid savetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true saves the current value in the patch file.

82

8.1.25 Output selector

bitmap

class name Output selectorcatalog name Kernelcatalog id kernelclass id output selector


Let one choose which of the outputs is the active one. The other one is not active.

Remarks Outputs are the same type of the input


During Initialization Phase -The number of outputs does not match the value ofthe corresponding parameter.

Inputs



read only/read write read writereferred as inplace *no*

referred as inheritedOutput 1Output 2

Input of the selector. The input is propagated to the choosen output.

Outputs

Output 1id output 1type Kernel, Generic datatypetype id kernel, generic datatypeinplace id Inputinherited id *no*

0 output of the block.

83

Output 2id output 2type Kernel, Generic datatypetype id kernel, generic datatypeinplace id Inputinherited id *no*

1 output of the block.

Parameters

# outputsid num outputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the number of outputs of the block. The minimum is 1, even if this case ismeaningless. At least two inputs should be used for normal operations.

Active outputid active outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 2 )

Zero-based index of the active output. The selected output is activated.

84

8.1.26 Queue

bitmap

class name Queuecatalog name Kernelcatalog id kernelclass id queue


Simulates a queue structure of arbitrary length. The queue has a FIFO structure (firstin / first out). This block is different from the ’delay’ block because it contains ”Lenght”parameter inputs. On the other hand ’delay’ contains just one input. Moreover ’queue’ issample-based while ’delay’ block is time-based.

Inputs




It is propagated to the output after ”Lenght” parameter steps.

Outputs


It is equal to the N-steps-before input.

85

Parameters

Lengthid lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Specifies the length of the queue (steps after wich the input is propagated)

Flushid flushtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Empties the queue

86

8.1.27 Sample Rate Limiter

bitmap

class name Sample Rate Limitercatalog name Kernelcatalog id kernelclass id sample rate limiter


Limits the sample rate of a data stream removing fast adjacent datatypes.

Remarks The algorithm limits sample rate by removing samples. The used method forremoving samples are time difference or undersampling input sample rate.

Inputs




Input datatype. This ususally has an high framerate which has to be droppen down.

Outputs


Output datatype. This has a limited framerate.

87

Parameters

Modeid modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Time-basedSample-based

domain [ 0, 2 )Specifies whether the sample-rate limitation is performed basing on time (in such case

parameters clock-mode and min-period are used) or basing on the number of samples (insuch case the parameter number-of-samples is used).

Min periodid min periodtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

This param represent the minimun time that may elapse between consecutive outputsof this block.

Clock modeid clock modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Creation timePresentation timeStep timeCurrent time

domain [ 0, 4 )Specifies which type of clock is used to compute the time elapsed between adjacent

datatypes. It’s used only if the sample rate is based on time period -Creation time: themethod uses the creation time of every sample to compute the difference time -Presentationtime: the method uses presentation time to compute time difference. -Step time: Timedifference is computed using step time of the sample. Step time is the time of beginningof execution of the patch and it’s the same for each block used in the application. So thisclock type analyze the execution time during wich the sample is generated. -Current time:Current time is the real time of execution for each block. It’s different for all the blocks inthe patch. So time difference is computed using this time.

Number of samplesid num samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

88

Specifies the inverse of the frequency. I.e., if this value is N, then, only 1 output is givenevery N input values.

89

8.1.28 ScalarArithmeticOperation - double

bitmap

class name ScalarArithmeticOperation - doublecatalog name Kernelcatalog id kernelclass id scalar arith op double


Perform an arithmetic operation on involving the input datatype and a scalar real value(double) specified as a parameter.

Inputs



read only/read write read writereferred as inplace Outputreferred as inherited *no*

This input represent the operand involved in the operation with the scalar value.

Required interfacesKernel, ScalarArithmeticOpDouble

Outputs



90

Parameters


layout

Combo Box:SumSubtractSubtract inverseMultiplyDivideDivide inverseMaxMinSet value


Scalar valueid scalar valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the scalar value involved in the operation.

91

8.1.29 ScalarArithmeticOperation - int

bitmap

class name ScalarArithmeticOperation - intcatalog name Kernelcatalog id kernelclass id scalar arith op int


Perform an arithmetic operation on involving the input datatype and a scalar integervalue specified as a parameter.

Inputs




This input represent the operand involved in the operation with the scalar value.

Required interfacesKernel, ScalarArithmeticOpInt

Outputs



92

Parameters


layout

Combo Box:SumSubtractSubtract inverseMultiplyDivideDivide inverseMaxMinSet value


Scalar valueid scalar valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Specifies the scalar value involved in the operation.

93

8.1.30 Snapshot

bitmap

class name Snapshotcatalog name Kernelcatalog id kernelclass id snapshot


Store in an internal memory the value of input after that ”load” parameter is changed.

Inputs




Input stored in the internal memory.

Outputs


Datatype stored in the internal memory and propagated to the output.

Parameters

Loadid loadtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Load new value of datatype in the internal memory.

94


Reset value of datatype in the internal memory

Continuous Outputid continuous outputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generate a new copy of snapshot datatype on every block activation

95

8.1.31 StringGenerator

bitmap

class name StringGeneratorcatalog name Kernelcatalog id kernelclass id string generator


Generates string values

Outputs

Valueid outputtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

Value

Parameters

Valueid valuetype Kernel, String datatype (Kernel Catalog).type id kernel, string

A block which enables communication between the container patch and the containedsubpatch



96

8.1.32 Subpatch

bitmap

class name Subpatchcatalog name Kernelcatalog id kernelclass id subpatch


Subpatches let you group block together and see them as a single block. It’s possibleadd input,output or parameter pins to comunicate with the blocks inside the subpatch.

97

8.1.33 SubpatchActivationPin

bitmap

class name SubpatchActivationPincatalog name Kernelcatalog id kernelclass id subpatch activation pin


The subpatch activation pin can be placed inside a subpatch to get a trigger eventeach time the subpatch is executed. It is particularly useful in the ForLoop subpatch todistinguish between the subpatch block activation (which occurs once per loop) and theinternal loop activation) which may occur multiple times). In such cases this block triggersonce per subpatch block activation, not once per loop. Note that this block has no effect ifplaced outside a subpatch.

Outputs

Outputid outputtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

This output is triggered each time the subpatch is activated

98

8.1.34 SubpatchInputPin

bitmap

class name SubpatchInputPincatalog name Kernelcatalog id kernelclass id subpatch input pin



Outputs

Outputid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Parameters

Is Inplaceid is inplacetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the data flow between the subpatch adn the containing patch occursvia swap/inplace operations

Auto Inherit Idid inherit idtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true and the name is empty, its value will be automatically inherited from the nextlink that will be created

Idid idtype Kernel, String datatype (Kernel Catalog).type id kernel, string

99

The id of corresponding pin of the subpatch block in the container patch

Auto Inherit Nameid inherit nametype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool


Nameid nametype Kernel, String datatype (Kernel Catalog).type id kernel, string

The name of corresponding pin of the subpatch block in the container patch

Auto Inherit Descriptionid inherit descriptiontype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true and the description is empty, its value will be automatically inherited from thenext link that will be created

Descriptionid descriptiontype Kernel, String datatype (Kernel Catalog).type id kernel, string

The description of corresponding pin of the subpatch block in the container patch

Reset Datatype Classid reset datatype classtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

When triggered, causes the datatype class to be reset to the default value (no datatypeclass; i.e., generic datatype. You should unlink the block and link it again to inherit adatatype class

CatalogIdid catalog idtype Kernel, String datatype (Kernel Catalog).type id kernel, string

The identifier of the catalog of the datatypeclass

ClassIdid class idtype Kernel, String datatype (Kernel Catalog).type id kernel, string

100

The identifier of the class of the datatypeclass

Required Interfacesid required interfaces idtype Kernel, String datatype (Kernel Catalog).type id kernel, string

The list of required interfaces

Auto Inherit Required For Initializationid inherit required for initializationtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the ”required for initialization” property is inherited from the next link operation.

Is Required For Initializationid is required for initializationtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the corresponding input pin of the subpatch block is required forinitialization

Auto Inherit Required For Executionid inherit required for executiontype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the ”required for execution” property is inherited from the next link operation.

Is Required For Executionid is required for executiontype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the corresponding input pin of the subpatch block is required forexecution

Auto Inherit Activates Subpatchid inherit activates subpatchtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the ”activates subpatch” property is inherited from the next link operation.

Activates Subpatchid activates subpatchtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

101

Specifies whether the corresponding input pin of the subpatch block causes the blockactivation. If true the subpatch block is activated whenever the corresponding input changes

Feedback pinid feedback pintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:None

domain [ 0, 1 )If set to something different than one, then the datatype value is copied from the spec-

ified subpatch output pin

Feedback pin nameid feedback pin nametype Kernel, String datatype (Kernel Catalog).type id kernel, string

This parameter is internally managed by EyesWeb. It stores the name of the feedbackpin in order to re-establish the correct value upon reloading the patch from file

102

8.1.35 SubpatchOuputPin

bitmap

class name SubpatchOuputPincatalog name Kernelcatalog id kernelclass id subpatch output pin



Inputs



read only/read write read writereferred as inplace *no*referred as inherited *no*

Parameters

Is Inplaceid is inplacetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the data flow between the subpatch adn the containing patch occursvia swap/inplace operations



103





Nameid nametype Kernel, String datatype (Kernel Catalog).type id kernel, string

The name of corresponding pin of the subpatch block in the container patch



Descriptionid descriptiontype Kernel, String datatype (Kernel Catalog).type id kernel, string

The description of corresponding pin of the subpatch block in the container patch





104



105

8.1.36 SubpatchParameterPin

bitmap

class name SubpatchParameterPincatalog name Kernelcatalog id kernelclass id subpatch parameter pin



Outputs


Parameters






106


Parameter Nameid nametype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the name of the parameter when exported to the container patch



Parameter Descriptionid descriptiontype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the description of the parameter when exported to the container patch







107

Is DesignTimeid is design timetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the corresponding parameter can be changed at design time

Is RunTimeid is run timetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the corresponding parameter can be changed at run time

Is DesignTimeInitInfoid is design time init infotype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the corresponding parameter init info can be changed at design time

Is RunTimeInitInfoid is run time init infotype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the corresponding parameter init info can be changed at run time

Set parameter before initializing a patchid set params before inittype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true, the value of the parameter is propagated to all dependant blocks before thepatch is initialized

108

8.1.37 Switch

bitmap

class name Switchcatalog name Kernelcatalog id kernelclass id switch


It’s used to connect and disconnect blocks in the patch. If the switch is open then thedata flow is interrupted. Otherwise the data flow is propagated. The input data is a genericdatatype so the block support scalar datatype and buffer audio and fft buffer too.

Inputs




It is propagated to the output only if condition is true.

Outputs


It is generated only if condition is true.

Parameters

Conditionid conditiontype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

109

Specifies whether the channel is opened or closed, i.e., if inputs are propagated to theoutput or not.

Toggle statusid toggletype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Switch the state of the block. If it’s opened it close it, otherwise it open it.

Openid opentype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Open the switch.

Closeid closetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Close the switch.

110

8.1.38 ThresholdOperation - double

bitmap

class name ThresholdOperation - doublecatalog name Kernelcatalog id kernelclass id threshold op double


Threshold the input value according to a given threshold value. If operation type is setto ’Lower and upper threshold’ and if lower and upper threshold have the same values, theblock threshold is binary. This type of operation is often used in background subtractionoperation when the algorithm need a binary (BW) image.

Inputs




Input value to be thresholded.

Required interfacesKernel, ThresholdOpDouble

Outputs


Output value to be thresholded.

111

Parameters


layout

Combo Box:Lower thresholdUpper thresholdLower and upper thresholdSame lower and upper threshold

domain [ 0, 4 )Specifies the type of thresholding performed. Lower threshold means that all values

which are less then the specified threshold are set to the specified lower value. Upperthreshold means that all values which are more then the specified threshold are set to thespecified upper value. If ”Lower and Upper” is used, both operations are performed and thetwo thresholds may be different. Finally, if ”Same Lower and Uppper” is used, then bothlower and upper thresholds are applied, but using a single threshold value (Lower/Common)

Lower/common thresholdid lower thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the lower threshold. This value is used only if Operation Type is set to loweror both. If operation is set to ”Same lower and upper threshold”, then this value is usedfor both the lower and upper threshold, and the ”upper threshold” value is ignored.

Lower valueid lower valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the value to be assigned to the datatype when its value is under the threshold.This value is used only if Operation Type is set to lower or both.

Upper thresholdid upper thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the upper threshold. This value is used only if Operation Type is set to upperor both.

Upper valueid upper valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

112

Specifies the value to be assigned to the datatype when its value is over the threshold.This value is used only if Operation Type is set to upper or both.

113

8.1.39 ThresholdOperation - int

bitmap

class name ThresholdOperation - intcatalog name Kernelcatalog id kernelclass id threshold op int


Threshold the input value according to a given threshold value. If operation type is setto ’Lower and upper threshold’ and if lower and upper threshold have the same values, theblock threshold is binary. This type of operation is often used in background subtractionoperation when the algorithm need a binary (BW) image.

Inputs




Input value to be thresholded.

Required interfacesKernel, ThresholdOpInt

Outputs


Output value to be thresholded.

114

Parameters


layout

Combo Box:Lower thresholdUpper thresholdLower and upper thresholdSame lower and upper threshold

domain [ 0, 4 )Specifies the type of thresholding performed. Lower threshold means that all values

which are less then the specified threshold are set to the specified lower value. Upperthreshold means that all values which are more then the specified threshold are set to thespecified upper value. If ”Lower and Upper” is used, both operations are performed and thetwo thresholds may be different. Finally, if ”Same Lower and Uppper” is used, then bothlower and upper thresholds are applied, but using a single threshold value (Lower/Common)

Lower/common thresholdid lower thresholdtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Specifies the lower threshold. This value is used only if Operation Type is set to loweror both. If operation is set to ”Same lower and upper threshold”, then this value is usedfor both the lower and upper threshold, and the ”upper threshold” value is ignored.

Lower valueid lower valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Specifies the value to be assigned to the datatype when its value is under the threshold.This value is used only if Operation Type is set to lower or both.

Upper thresholdid upper thresholdtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Specifies the upper threshold. This value is used only if Operation Type is set to upperor both.

Upper valueid upper valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

115

Specifies the value to be assigned to the datatype when its value is over the threshold.This value is used only if Operation Type is set to upper or both.

116

8.1.40 TimeExtraction

bitmap

class name TimeExtractioncatalog name Kernelcatalog id kernelclass id extract timeauthors Alberto Massari

Extract the creation time of the input data

Inputs




The datatype whose timestamp will be extracted

Outputs

Timeid timetype Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

The timestamp of the input datatype

117

Parameters

Selectorid selectortype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Creation timePresentation timeDurationMedia timeMedia durationRemaining Time

domain [ 0, 6 )Selects which of the timestamps to provide as output.


layoutCombo Box:ActualRaw

domain [ 0, 2 )Specifies whether to extract the actual values or the raw values

118

8.1.41 TimeGenerator

bitmap

class name TimeGeneratorcatalog name Kernelcatalog id kernelclass id time generator


Generates time values

Outputs

Valueid outputtype Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

Value

Parameters

Valueid valuetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Value


If true, the block is activated event when the selector parameter changes value, even ifthe input is not changed.

119

8.1.42 Vector

bitmap

class name Vectorcatalog name Kernelcatalog id kernelclass id vector


A block which stores an array of datatypes. The array can be read or write with randomaccess, i.e., without any constraint on the order in which the location are accessed.

Inputs




The input datatype, which is stored in the vector at the user-specified position

Outputs


The output datatype, which is read from the user-specified position in the vector

Parameters

sizeid sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

120

The size of the internal array


reset all internal datatypes to thei defaul values

Enable Readid enable readtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether reading (i.e., copying to output) is enabled

Read/Write Priorityid read write prioritytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:First Read, Then WriteFirst Write, Then Read

domain [ 0, 2 )Specifies which operation is performed first, whether the read operation or the write

operation. When read and write position are the same, the order of the operations affectsthe result.

Invalid Read Position Modeid invalid read position modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:WrapIgnoreBound

domain [ 0, 3 )Specifies the behaviour of the block when the read position is not valid

Read Positionid read positiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The position in the internal array of the datatype copied to the output pin

121

Enable Writeid enable writetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether writing is enabled

Invalid Write Position Modeid invalid write position modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:wrapignorebound

domain [ 0, 3 )Specifies the behaviour of the block when the write position is not valid

Write Positionid write positiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Position in the internal array where the input datatype will be copied

122

8.1.43 Wait all inputs changed

bitmap

class name Wait all inputs changedcatalog name Kernelcatalog id kernelclass id wait all inputs changed


Wait for all inputs to be changed. When this happens, updates all outputs.It’s usuallyused in audio application when the algorithm needs to analyze any simultaneous sensorreading (for example TDOA)

Inputs



read only/read write read writereferred as inplace *no*

referred as inheritedOutput 1Output 2

This input represent the 0th datatype to be waited.




This input represent the 1th datatype to be waited.

123

Outputs

Output 1id output 1type Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input 1inherited id *no*

0th output.

Output 2id output 2type Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input 1inherited id *no*

1th output.

Parameters




Time interval in which inputs changing must be included. If they are not changed insidethis range, they are considered unchanged. A value of zero means non constraints of time.

124

8.1.44 Weighted sum

bitmap

class name Weighted sumcatalog name Kernelcatalog id kernelclass id weighted sum


Compute the wheighted sum of input datatypes. See parameter description for moreinformations.

Inputs

generic inputid inputtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace generic outputreferred as inherited generic output

datatype to sum

Required interfacesKernel, Arithmetic Operations Kernel, ScalarArithmeticOpDouble

Outputs

generic outputid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id generic inputinherited id *no*

Weighted sum of input datypes

125

Parameters

Weightsid paramWeightstype Kernel, Double matrix.type id kernel, double-matrix

Weights applied to input datatype. The lenght of this matrix control the number ofdataype to sum.

Modeid paramModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:normaldifferenceabsolute differencesquare difference

domain [ 0, 4 )Select the mode of operation (the icon of this block is not updated when the patch is

executed). When ’normal’ is set the datatype is used as is. When ’difference’ or ’absolutedifference’ or ’square difference’ is set the difference (regular, absolute, squared) betweentwo consecutive datatypes is used in the sum.In the next formulas W is the array of weigth,N is the number of weigths, X is the array of the last N datatypes received as input fromthe block, SUM is the operator for sum (greek Sigma), i is the index of the element ofsum, and result is the output datatype.The formulas used are the followings : ’normal’result = SUM( W(i) * X(i)) ; ’difference’ result = SUM( W(i) * (X(i) - X(i-1)) ; ’absolutedifference’ result = SUM( W(i) * —X(i) - X(i-1)— ; ’square difference’ result = SUM( W(i)* —X(i)-X(i-1)—ˆ2) .

Clearid cleartype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

When this bang is received, the internally queued datatype data is cleared

126

8.2 Datatypes

8.2.1 AcceleratorKey datatype.

class name AcceleratorKey datatype.catalog name Kernelcatalog id kernelclass id acceleratorkey

Represent an accelerator key, i.e., a combination of keys pressed on the keyboard.

8.2.2 Bool datatype (Kernel Catalog).

class name Bool datatype (Kernel Catalog).catalog name Kernelcatalog id kernelclass id bool

Bool datatype (Kernel Catalog).

Supported interfaces

• Kernel, Logical Operations

• Kernel, MonadicLogicalOp

8.2.3 Byte

class name Bytecatalog name Kernelcatalog id kernelclass id byte

Single byte datatype. Contains usigned values in the range from 0 to 255.


• Kernel, Arithmetic Operations


• Kernel, Comparison Operations

• Kernel, ThresholdOpInt

• Kernel, ThresholdOpDouble

127

• Kernel, MonadicArithOp


• Kernel, ScalarComparisonOpInt

• Kernel, ScalarComparisonOpDouble

8.2.4 Date

class name Datecatalog name Kernelcatalog id kernelclass id date

Date



8.2.5 Datetime

class name Datetimecatalog name Kernelcatalog id kernelclass id datetime

DateTime



8.2.6 Double datatype (Kernel Catalog).

class name Double datatype (Kernel Catalog).catalog name Kernelcatalog id kernelclass id double

Double datatype (Kernel Catalog).

128



• Kernel, ScalarArithmeticOpDouble

• Kernel, ScalarArithmeticOpInt







8.2.7 Double matrix.

class name Double matrix.catalog name Kernelcatalog id kernelclass id double-matrix

Matrix of double numbers. The memory layout is such ¡row0¿ ¡row1¿ ¡row2¿ ... ¡rowN¿.








8.2.8 Font

class name Fontcatalog name Kernelcatalog id kernelclass id font

Font

129

8.2.9 Generic datatype

class name Generic datatypecatalog name Kernelcatalog id kernelclass id generic datatype

A generic datatype is used as a design-time placeholder for an actual datatype which isusually specified before run-time begins.

Details A generic datatype is not an actual datatype; it is used by many blocks asa placeholder when the actual datatype cannot be known at design-time (e.g., blocks thatcan operate on several different types of data). If a block declares a generic input oroutput, any type of data (i.e., link) can be connected to such pins. However, if a blockalso declares a required interface for an input, the set of linkable datatype is restricted tothe one supporting such interface (e.g., all datatypes that can be multiplied by a doublenumber).

8.2.10 Int datatype (Kernel Catalog).

class name Int datatype (Kernel Catalog).catalog name Kernelcatalog id kernelclass id int

Int datatype (Kernel Catalog).












130


8.2.11 Integer matrix.

class name Integer matrix.catalog name Kernelcatalog id kernelclass id int-matrix

Matrix of integer numbers (Kernel Catalog).










8.2.12 Labelled set

class name Labelled setcatalog name Kernelcatalog id kernelclass id labeled set

Set of homogeneous datatypes identified by a label


• kernel, container

131

8.2.13 List

class name Listcatalog name Kernelcatalog id kernelclass id list

List of homogeneous datatypes



8.2.14 RGBColor datatype (Kernel Catalog).

class name RGBColor datatype (Kernel Catalog).catalog name Kernelcatalog id kernelclass id rgbcolor

RGBColor datatype



8.2.15 String datatype (Kernel Catalog).

class name String datatype (Kernel Catalog).catalog name Kernelcatalog id kernelclass id string

String datatype (Kernel Catalog).



8.2.16 StringPair

class name StringPaircatalog name Kernelcatalog id kernelclass id string pair

132

Holds a pair of strings

8.2.17 Time datatype (Kernel Catalog).

class name Time datatype (Kernel Catalog).catalog name Kernelcatalog id kernelclass id time

Time datatype (Kernel Catalog).









8.2.18 Trigger datatype (Kernel Catalog).

class name Trigger datatype (Kernel Catalog).catalog name Kernelcatalog id kernelclass id trigger

Trigger datatype (Kernel Catalog).

8.3 Datatype converters

8.3.1 Any to trigger converter

class name Any to trigger convertercatalog name Kernelcatalog id kernelclass id any-to-trigger

Converts any datatype to the kernel trigger datatype.

133

8.3.2 AnyToString Converter

class name AnyToString Convertercatalog name Kernelcatalog id kernelclass id any to string

Converts any datatype to a string using the SerializeAsText method. Note that for somedatatype (e.g., images) this may result in unreadible text (although all characters shouldbe printable ones).

8.3.3 BoolToInteger

class name BoolToIntegercatalog name Kernelcatalog id kernelclass id bool-to-int

Convers a boolean value to an integer number. True is mapped to one; false is mappedto zero.

8.3.4 Double to int converter

class name Double to int convertercatalog name Kernelcatalog id kernelclass id double-to-int

Converts a double to an integer number.

8.3.5 DoubleMatrixToIntMatrix

class name DoubleMatrixToIntMatrixcatalog name Kernelcatalog id kernelclass id doublematrix to intmatrix

Converts a DoubleMatrix (i.e., a matrix containing floating point elements in doubleprecision format) to an Integer Matrix (i.e., a matrix containing Integer elements).

134

8.3.6 DoubleToTime

class name DoubleToTimecatalog name Kernelcatalog id kernelclass id double to time

Converts a floating point (double) datatype to a time datatype

8.3.7 Input

class name Inputcatalog name Kernelcatalog id kernelclass id byte-to-int

Converts a byte to an integer.

8.3.8 Int to double converter

class name Int to double convertercatalog name Kernelcatalog id kernelclass id int-to-double

Converts an integer to a double number.

8.3.9 IntMatrixToDoubleMatrix

class name IntMatrixToDoubleMatrixcatalog name Kernelcatalog id kernelclass id intmatrix to doublematrix

Converts an IntegerMatrix (i.e., a matrix containing Integer elements) to a DoubleMa-trix (i.e., a matrix containing floating point elements in double precision format).

8.3.10 IntegerToBool

class name IntegerToBoolcatalog name Kernelcatalog id kernelclass id int-to-bool

135

Converts an integer number to a boolean value. Non-zero integer numbers are mappedto the boolean true, whereas a zero integer number is mapped to the boolean false.

8.3.11 IntegerToByte

class name IntegerToBytecatalog name Kernelcatalog id kernelclass id int-to-byte

Converts an integer to a byte. Saturate output byte in the case of overflow.

8.3.12 TimeToDouble

class name TimeToDoublecatalog name Kernelcatalog id kernelclass id time to double

Converts a TIME datatype to a double datatype.

8.4 Datatype interfaces

8.4.1 Arithmetic Operations

class name Arithmetic Operationscatalog name Kernelcatalog id kernelclass id arith op

Define the interface for datatypes supporting basic arithmetic operations such as Add,Subtract, Multiply, and Divide.

8.4.2 Comparison Operations

class name Comparison Operationscatalog name Kernelcatalog id kernelclass id comparison op

Define the interface for datatypes supporting basic comparison operations such as LessThan, Equal To, Greater Than, etc.

136

8.4.3 DynamicTimeSeries

class name DynamicTimeSeriescatalog name Kernelcatalog id kernelclass id dynamic time series

Define the interface for datatypes representing time series of variable size (i.e., thenumber of samples per buffer can change at every execution step). Time series are mul-timensiona vectors of double numbers which are obtained by sampling a signal at a fixedsample rate.

8.4.4 Logical Operations

class name Logical Operationscatalog name Kernelcatalog id kernelclass id logic op

Define the interface for datatypes supporting basic logical operations such as And, Orand Xor.

8.4.5 MonadicArithOp

class name MonadicArithOpcatalog name Kernelcatalog id kernelclass id monadic arith op

Define the interface for datatypes supporting operations such as Sqrt, Sqr, Abs, Exp

8.4.6 MonadicLogicalOp

class name MonadicLogicalOpcatalog name Kernelcatalog id kernelclass id monadic logic op

Define the interface for datatypes supporting monadic logical operations. Currently theonly supported operation is Not.

137

8.4.7 ScalarArithmeticOpDouble

class name ScalarArithmeticOpDoublecatalog name Kernelcatalog id kernelclass id scalar arith op double

Define the interface for datatypes supporting basic operations against floating pointscalar numbers (Add, Multiply, Divide, etc.)

8.4.8 ScalarArithmeticOpInt

class name ScalarArithmeticOpIntcatalog name Kernelcatalog id kernelclass id scalar arith op int

Define the interface for datatypes supporting basic operations against integer scalarnumbers (Add, Multiply, Divide, etc.)

8.4.9 ScalarComparisonOpDouble

class name ScalarComparisonOpDoublecatalog name Kernelcatalog id kernelclass id scalar comparison op double

Define the interface for datatypes supporting basic comparison against floating pointscalar numbers

8.4.10 ScalarComparisonOpInt

class name ScalarComparisonOpIntcatalog name Kernelcatalog id kernelclass id scalar comparison op int

Define the interface for datatypes supporting basic comparison against integer scalarnumbers

138

8.4.11 StaticTimeSeries

class name StaticTimeSeriescatalog name Kernelcatalog id kernelclass id static time series

Define the interface for datatypes representing time series of fixed size. Time series aremultimensiona vectors of double numbers which are obtained by sampling a signal at afixed sample rate.

8.4.12 ThresholdOpDouble

class name ThresholdOpDoublecatalog name Kernelcatalog id kernelclass id thresholdop double

Define the interface for datatypes supporting threshold operations against floating pointscalar numbers (lower and upper thrsholds, etc..)

8.4.13 ThresholdOpInt

class name ThresholdOpIntcatalog name Kernelcatalog id kernelclass id thresholdop int

Define the interface for datatypes supporting threshold operations against integer scalarnumbers (lower and upper thrsholds, etc..)

8.4.14 TimeSeries

class name TimeSeriescatalog name Kernelcatalog id kernelclass id time series

Should use StaticTimeSeries instead of this one.

139

8.5 Authors

8.5.1 Alberto Massari

class name Alberto Massaricatalog name Kernelcatalog id kernelclass id alby

COmputer Science Engineer

8.5.2 Andrea Ricci

class name Andrea Riccicatalog name Kernelcatalog id kernelclass id andrea

Andrea Ricci Software Engineer Microsoft Certified Professional mailto:[email protected]

8.5.3 Massimiliano Peri

class name Massimiliano Pericatalog name Kernelcatalog id kernelclass id massy

Massimiliano Peri Software Engineer Microsoft Certified Professional mailto:[email protected]

8.5.4 Mirko Demurtas

class name Mirko Demurtascatalog name Kernelcatalog id kernelclass id mirko demurtas

Computer Science Engineer

8.5.5 Paolo Coletta

class name Paolo Colettacatalog name Kernelcatalog id kernelclass id paolo

140

Paolo Coletta Software Engineer Microsoft Certified Professional mailto:[email protected]

8.5.6 Roberto Sagoleo

class name Roberto Sagoleocatalog name Kernelcatalog id kernelclass id roberto sagoleo

Computer Science Engineer

8.6 Companies

8.6.1 InfoMus Lab

class name InfoMus Labcatalog name Kernelcatalog id kernelclass id infomus

InfomusLab. Info: [email protected] http://infomus.dist.unige.it

8.6.2 NumenSoft s.n.c. di M. Peri & C.

class name NumenSoft s.n.c. di M. Peri & C.catalog name Kernelcatalog id kernelclass id numensoft

Microsoft Certified Partner. InfomusLab Partner. Info: [email protected] Support:[email protected] http://www.numensoft.com

141

Chapter 9

Base Catalog

9.1 Blocks

9.1.1 ***TypeCast

bitmap

class name ***TypeCastcatalog name Basecatalog id baseclass id ConversionLegacyauthors Mirko Demurtas

This block forces EyesWeb to convert the input to an explicit datatype by allowing theuser to specify the type of the input and output pins. It can be used when you want tolet the user know which is the conversion chain. Note that this block does not perform theconversion, i.e., it is not a converter. However, it forces EyesWeb to perform an implicitconversion. Anyway, even if the conversion is implicit, the user is aware of it thanks to thepresence of the block in the patch.

Inputs

Inputid Inputtype Kernel, Int datatype (Kernel Catalog).type id kernel, int



142

Input

Outputs

Outputid Outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Output

Parameters

Typeid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:BoolByteIntegerDoubleInteger MatrixDouble MatrixAudioBuffer

domain [ 0, 5 ]Type

143

9.1.2 *DeconcatenateMatrix

bitmap

class name *DeconcatenateMatrixcatalog name Basecatalog id baseclass id matrix deconcatenateauthors Roberto Sagoleo

Extracts one or more row/column sub-matrices from an input matrix

Inputs

Inputid inputtype Kernel, Double matrix.type id kernel, double-matrix



This is the input matrix from which will be deconcatenated the 1-dimensional outputmatrices

Outputs

Output 1id output1type Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

This is output matrix 1

144

Parameters

Matrix typeid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:DoubleInteger

domain [ 0, 2 )Defines the type of the output matrices (integer or double): integer: the matrices are

of integer type. double : the matrices are of double type.


layoutCombo Box:by columnby row

domain [ 0, 2 )Defines if to extract a row or a column sub-matrix from the input matrix: by column:

extracts a sub-column-matrix from the input matrix specified by the ’Size’ parameter. byrow : extracts a sub-row-matrix from the input matrix specified by the ’Size’ parameter.

Number of output matricesid num outputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies how many matrices from the input matrix to be deconcatenated

Deconcatenated matrix size 1id parameter index1type Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

This is deconcatentate matrix size 1

145

9.1.3 *Motionless

bitmap

class name *Motionlesscatalog name Basecatalog id baseclass id Motionlessauthors Mirko Demurtas

This block establish if the input position is motionless

Inputs

Xid InputXtype Kernel, Int datatype (Kernel Catalog).type id kernel, int



Y

Yid InputYtype Kernel, Int datatype (Kernel Catalog).type id kernel, int



Y

Outputs

Motionid OutputMotionLesstype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

146

Motion

Parameters

DXid ParameterDeltaXtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

DS

DYid ParameterDeltaYtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

DY

Durationid ParameterDurationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Duration

Activeid ParameterActivetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Active

147

9.1.4 2dPositionDependingIncrements

bitmap

class name 2dPositionDependingIncrementscatalog name Basecatalog id baseclass id 2DPosDepIncrementsauthors Gualtiero Volpe

This block computes the displacements along x and y in a 2D space given the currentposition in the space and the direction of the displacement to be selected among the 8principal directions (North, NorthEst, Est,...).

Inputs

id IncrementDirectiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int



id CurrentPositiontype Kernel, Double matrix.type id kernel, double-matrixrequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Outputs

id Incrementstype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

148

Parameters

id MaxXtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id MaxYtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LinearQuadratic

domain [ 0, 2 )

id RowVectortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

149

9.1.5 AIFF info

bitmap

class name AIFF infocatalog name Basecatalog id baseclass id aiffinfoauthors Paolo Coletta

Reads info about an AIFF file

Outputs

Markersid output markerstype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*

List of markers of the file

Sampling rateid output sampling ratetype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Sampling rate of the selected file

Num channelsid output num channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Number of channels of the selected file

Bits per sampleid output num bits per sampletype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

150

Number of bits per sample of the selected file

Num samplesid output num samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Number of samples of the selected file

Parameters

Filenameid filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”*.aiff—*.*——”

Name of the AIFF file to be read

Markers typeid markers typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:SamplesTime

domain [ 0, 2 )Specifies whether markers are given in sample or time units

151

9.1.6 AIFFReader

bitmap

class name AIFFReadercatalog name Basecatalog id baseclass id aiffreaderauthors Paolo Coletta

Reads an AIFF file

Inputs

AudioClockid audio clocktype Base, Audio clocktype id base, audio clock



This input is used to automatically establish the buffer size to be used. In some casesit can also be used as a clock signal to activate the block

Outputs

Output bufferid buffertype Base, PCMAudioBuffertype id base, pcm audio bufferinplace id *no*inherited id *no*

Output buffer containing a buffer of fixed size

152

Parameters


layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”*.aiff—*.*——”

Name of the AIFF file to be read

Audio buffer typeid audio buffer typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:DynamicStatic

domain [ 0, 2 )Specifies whether to use static or dynamic audio buffers as output.

Buffer size modeid buffer size modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:From audio clock inputUser specified

domain [ 0, 2 )Specifies whether the buffer size is inherited from an auxiliary input or if it is user

specified. In the case of an auxiliary input (default), that input can be used as a clocksource and the index of the buffer to be read is automatically computed by the block. Ifmore flexibility is needed, the index of the buffer can be given as another (optional) input;in such case the additional input acts as the clock source. In the case of a user specifiedbuffer size, it is up to the user to guarantee that the activation rate is coherent with thegiven buffer-size and sampling-rate.

Buffer sizeid buffer sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the size, in samples, of the output buffer

153

Interval generation modeid interval generation modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Use audio clock inputUse interval input

domain [ 0, 2 )Specifies whether the index of the interval to be read is deduced by the clock source or

is given by means of an external source (e.g., a counter) via an additional input.

Num channelsid num channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the number of channels of the output buffer. 1 for mono, 2 for stereo, etc.

Num samples per secondid num samples per sectype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the number of samples per seconds (i.e., the sampling frequency) of the outputbuffer.

PCMSampleFormatid sample formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:8 bits unsigned8 bits signed16 bits unsigned16 bits signed24 bits unsigned (unpacked, 32bits storage)24 bits signed (unpacked, 32bits storage)24 bits unsigned (packed, 24bits storage)24 bits signed (packed, 24bits storage)32 bits unsigned32 bits signed32 bits float

domain [ 0, 11 )Specifies the format of PCM samples.

154

Out of boundsid out of boundstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:WrapBoundIgnore

domain [ 0, 3 )Specifies the behaviour of the block when the buffer index is outside the valid range. If

Wrap is given the out of bound values are put into the valid range via a modulo operation;in practice, the file is read again from the beginning if values increase over the maximum.If Bound is given, the index is put into a valid range via a saturate operation; in practice,if the input index exceeds the maximum, the last buffer is countinuosly repeated. If Ignoreis given, the index is ignored and a blank buffer is given as output

Silence on empty fileid silence on invalid filetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true the output will be continuosly generated (and set to silence) when anempty or invalid file is given.

Internal fadeid internal fadetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true the fade in/out is performed by the reader *inside* the given markings.

155

9.1.7 AddPointToPolyline

bitmap

class name AddPointToPolylinecatalog name Basecatalog id baseclass id AddPointInPolylineauthors Mirko Demurtas

This block add a point in a polyline. The shape can be drawn if type parameter is setto graphic mode. The polyline is incremental: it means that everytime a point is added,polyline has one more point. First time polyline is made of only one point.

Inputs

Pointid Inputtype Base, Point 2D inttype id base, point 2d int



Point to be added in the polyline

Outputs

Polylineid Outputtype Base, Polyline 2D inttype id base, polyline 2d intinplace id *no*inherited id *no*

Polyline made of points added by user.

156

Parameters


layout

Combo Box:Geometric IntGeometric DoubleGraphic IntGraphic Double

domain [ 0, 4 )Specified the type of polyline. It’s possible choose double or int type. Moreover it’s

possible to create just a geometric point datatype or a graphic polyline that can be drawn

Resetid Resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Reset the polyline.

157

9.1.8 AlphaFilter

bitmap

class name AlphaFiltercatalog name Basecatalog id baseclass id AlfaFilter

authorsMarzia SimonettiPaolo Coletta

This block filter the input data according to the following formula: y(k) = u(k) * alpha+ y(k-1) * (1 - alpha) where: y(k) is the current output y(k-1) is the previous output u(k)is the current input alpha is an user-specified parameter.

Details At the first execuition step, or after the reset trigger is received, the followingalternate formulta is used: y(k) = u(k) i.e., the first received value is not filtered.

Notes Up to rev. 3939 the filter internal memory (i.e., y(k-1)) was initialized with 0.Now it is initialized with the first received input value

Inputs

Inputid Inputtype Kernel, Generic datatypetype id kernel, generic datatype



Input value to be filtered

Required interfacesKernel, ScalarArithmeticOpDouble Kernel, Arithmetic Operations

158

Outputs

Outputid Outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Inputinherited id *no*

Filtered output

Parameters

Filtering coefficentid AlfaFiltertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Alpha coefficent used in the filtering formula (see block description )


Reset the filter internal state

159

9.1.9 ApplyTransformation3D-Double

bitmap

class name ApplyTransformation3D-Doublecatalog name Basecatalog id baseclass id apply transformation 3d doubleauthors Simone Ghisio

Apply transformations according to parameters.Coordinates are calcolated using valuesof acaling, rotation and transformation.

Inputs

Input3Did input 3dtype Kernel, Generic datatypetype id kernel, generic datatype



Generic input 3D

Required interfacesbase, base geometric 3d double

Outputs

Output3Did output 3dtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Output 3D.

160

Parameters

ApplyRotationid param rotationtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Apply rotation.

ApplyScalingid param scaletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Apply scaling.

ApplyTranslationid param translationtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Apply translation.

161

9.1.10 ApplyTransformation3D-Int

bitmap

class name ApplyTransformation3D-Intcatalog name Basecatalog id baseclass id apply transformation 3d intauthors Simone Ghisio

Apply transformations according to parameters.Coordinates are calcolated using valuesof acaling, rotation and transformation.

Inputs




Generic input 3D

Required interfacesbase, base geometric 3d int

Outputs


Output 3D.

162

Parameters

ApplyRotationid param rotationtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Apply rotation.

ApplyScalingid param scaletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Apply scaling.

ApplyTranslationid param translationtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Apply translation.

163

9.1.11 AudioBufferArithmeticOperations

bitmap

class name AudioBufferArithmeticOperationscatalog name Basecatalog id baseclass id AudioSummerauthors Simone Ghisio

Computes mathematical operations beetween audio buffer (input 1) and double value(input2). If the block divides the buffer by zero, then output buffer is set to zero.

Error and Warning Messages –

During Execution Phase – - Division by zero: if double value is zero and theoperation is a division. It’s not an error because the output buffer is set to zero.

Inputs

Input Audio Bufferid input sound buffertype Base, Audio buffertype id base, audio buffer



This is the audio buffer that must be elaborate

Constid input valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double



This is the constant value of the operation

164

Outputs

Output Audio Bufferid output sound buffertype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Audio buffer after math operation

Parameters

Typeid Type of operationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:SumBuffer sub constConst sub BufferMulDiv

domain [ 0, 4 ]Type of math operation. The block sum, subtract, multiply or divide the audio buffer

to a double value. If RevSub in selected then the audio buffer is subtracted form the doublevalue

165

9.1.12 AudioFeatures

bitmap

class name AudioFeaturescatalog name Basecatalog id baseclass id audio featureauthors Alberto Massari

Extract a feature of the audio signal (peak, RMS, energy...)

Inputs

Audio input streamid input audio streamtype Kernel, Generic datatypetype id kernel, generic datatype



This is the audio stream where the features are extracted.

Required interfacesKernel, StaticTimeSeries

Outputs

Output valueid output valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The value of the feature being extracted

Sample indexid output samplendxtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

166

For some features, this is the index of the sample that corresponds to the feature beingextracted

Parameters

Channelid channeltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Channel to be monitored. This block only works on a single channel, thus, even if theinput is a multichannel audio, only this channel is monitored. Channel indices are 0-based.

Featureid featuretype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:VolumeEnergyPositive peak value and indexNegative peak value and indexAbsolute peak value and index

domain [ 0, 5 )The feature to be extracted from the audio signal

167

9.1.13 AudioGenerator

bitmap

class name AudioGeneratorcatalog name Basecatalog id baseclass id GeneratorBufferAudioauthors Mirko Demurtas

Generate an Audio Sound Buffer

Inputs

Clockid Input Clocktype Kernel, Generic datatypetype id kernel, generic datatype



Clock

Outputs

Audio Bufferid output buffertype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Audio Buffer

168

Parameters

Sampling Frequencyid typefrequencetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:441004800096000Custom

domain [ 0, 4 )Sampling Frequency

Custom sampling frequencyid frequencetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Custom sampling frequency

Audio buffer durationid typesampletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:1 s500 ms250 ms125 ms100 ms25 ms10 msCustom TimeCustom (Number samples)

domain [ 0, 9 )This parameter let you choose the duration of the audio buffer, among a set of predefined

values. If no value fit your needs, you can choose to specify a custom value (in samples orin milliseconds)

Custom audio buffer durationid duratetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

In the case that you chose to specify a custom buffer duration (in milliseconds), thisparameter ley you specify the duration in milliseconds.

169

Custom Number of samples in bufferid samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of samples in buffer

Waveform typeid type formtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RandomSinusoidalSquareConstant Value

domain [ 0, 4 )Waveform type

Frequency of waveformid frequence formtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Frequency of waveform

Amplitude Waveformid amplitude formtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Amplitude Waveform

Offset waveformid offsetformtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Offset waveform

Phase waveformid phasetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Phase waveform

170

9.1.14 AudioMixer

bitmap

class name AudioMixercatalog name Basecatalog id baseclass id mixing channel


Mix the input sound buffer and generate an output sound buffer according to mixingmatrix

Inputs

Audio Bufferid input audio streamtype Base, Audio buffertype id base, audio buffer



Audio Buffer

Outputs

Output audio bufferid output sampletype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Output audio buffer

Parameters

Mixing channles matrixid matrix-mixingtype Kernel, Double matrix.type id kernel, double-matrix

Mixing channles matrix

171


layoutCombo Box:ConstantSmoothed

domain [ 0, 2 )Specifies whether the mixing is done using the smoothing factors (UpStep, downStep)

or using a constant matrix

UpStepid up steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

In the case of smoothed mode, specifies the maximum increasing step per sample

DownStepid down steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

In the case of smoothed mode, specifies the maximum decreasing step per sample

172

9.1.15 AudioSwitch

bitmap

class name AudioSwitchcatalog name Basecatalog id baseclass id audioswitchauthors Simone Ghisio

This block copies the input audio buffer on the output pin if input switch value isbetween minimum and maximum switching value.

Remarks If the input switch is out of the range (minimum, maximum) then the outputis set to zero value. It doesn’t store the previous audio buffer.

Inputs

Input Audio Bufferid Input Sound Bbuffertype Base, Audio buffertype id base, audio buffer


read only/read write read writereferred as inplace Output Audio Bufferreferred as inherited *no*

Input audio buffer

Switchid Switchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



The block analyzes this input and if its value is between minimum and maximum pa-rameter the input is copied on the output pin.

173

Outputs

Output Audio Bufferid Output Sound Buffertype Base, Audio buffertype id base, audio bufferinplace id Input Audio Bufferinherited id *no*

This is the output Audio Buffer

Parameters

Minimum Valueid minimum switching valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Minimum Value of the input switch to allow the copy of the input buffer on the output

Maximum Valueid maximum switching valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Maximum Value of the input switch to allow the copy of the input buffer on the output

174

9.1.16 AudioVolumeControl

bitmap

class name AudioVolumeControlcatalog name Basecatalog id baseclass id AudioVolumeControlauthors Gualtiero Volpe

This block allows direct control of the master volume and the muting option in WindowsVista audio mixers.

Inputs

Master volumeid MasterVolumetype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Control the master volume of audio output

Muteid Mutetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool



Mute or activate audio output

175

Parameters

Search for audio devicesid SearchDevicetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Search for active audio devices

Audio deviceid AudioDevicetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Digital Audio (S/PDIF) (High Definition Audio Device)Speakers (High Definition Audio Device)Microphone (High Definition Audio Device)Microphone (High Definition Audio Device)

The audio device on which the block operates

176

9.1.17 AviWriter

bitmap

class name AviWritercatalog name Basecatalog id baseclass id opencv avi writerauthors Mirko Demurtas

Writes the incoming images to an AVI file. You can explicitely specify the codec to beused or you’ll be promped for one if none is specified.

Inputs

Imageid input imagetype Base, Imagetype id base, image



Input image

Parameters

Filenameid name filetype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”Avi File (*.avi)—*.avi—All files (*.*)—*.*——”

Name of the AVI file. If changed during patch execution the file currently being pro-cessed is closed and a new one is started.

FramesPerSecondid fpstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

177

Number of frames per second of the created video stream. Note that this does not needto match the input frame rate. This is the speed at which a player will try to read thecurrent file.

FourCCid known fourcctype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Use custom FOURCCMRLE - Microsoft RLE by MicrosoftMSVC - Microsoft Video 1 by MicrosoftCRAM - Microsoft Video 1 by MicrosoftCVID - Cinepak by Providenza & Boekelheide

domain [ 0, 5 )Selects a FourCC code among the known ones. Please note that the fact that a FourCC

is known does not implies that it will work on your system. You need the codec for thatFourCC to be installed on your system in order to use it.

MRLE - Microsoft RLE by Microsoft - Run length encoded RGB format from Mi-crosoft. Basically the same as the BI RLE formats but Michael Knapp clarifies: ”MRLEis just *nearly* the same compression as the existing 4 and 8bit RLE formats but the’copy bytes-chunk’ always has an even byte-length. That means that an empty byte isadded if the ’copy chunk’ contains an odd number of bytes MSVC - Microsoft Video 1by Microsoft - Original codec shipped with Video For Windows. Deals with 8bpp and16bpp images. Quality leaves a lot to be desired (IMHO). Full technical details are avail-able http://home.pcisys.net/%7emelanson/codecs/video1.txt CRAM - Microsoft Video 1by Microsoft - Allegedly identical to MSVC. CVID - Cinepak by Providenza & Boekelheide-

Custom FourCCid fourcctype Kernel, String datatype (Kernel Catalog).type id kernel, string

Explicitly specifies the FourCC. For a list of valid FourCC codes you can refer to sitehttp://www.fourcc.org. Note that you also need the codec for the given FourCC to beinstalled on your system.

178

9.1.18 Background Subtraction Adaptive Histograms

bitmap

class name Background Subtraction Adaptive Histogramscatalog name Basecatalog id baseclass id bgnd sub adaptive histauthors Andrea Ricci

Performs backgorund subtraction using a set of adaptive histograms to model eachbackground pixel, as described in the article ”A Texture-Based Method for Modeling theBackground and Detecting Moving Objects”, Marko Heikkila and Matti Pietikainen, IEEETransactions, april 2006

Inputs

Inputid inputtype Base, Imagetype id base, image



Input Image to perform background modeling and foreground identification. The ROIit’s not considered as the algorithm must work on the whole image.

Outputs

Outputid outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output Image containing the foreground mask

179

Parameters

Nbid n btype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 4, 8 ]

The number of bits used in every pixel of the input image. The number of histogrambins will be 2ˆNb. When the block is used along with the LocalBinaryPatterns block, thisparametermust be equal to the number of pixels used by the LBP operator.

Rregionid r regiontype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 20 ]

The radius of the region surrounding each pixel that is used to calculate the histograms

Kid ktype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 10 ]

The number of histograms to mantain for every pixel.

Tpid t ptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The proximity threshold to apply to the histogram distances.

Abid a btype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The matching histogram update (learning) rate.

Awid a wtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The histogram weights update (learning) rate.

180

Tbid T btype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The threshold on the total weight that determine how many histograms are consideredas background model.

White FG Maskid white fg masktype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true, the foreground pixels in the output mask will be white, they will be blackotherwise.

181

9.1.19 Baricenter

bitmap

class name Baricentercatalog name Basecatalog id baseclass id image baricenterauthors Massimiliano Peri

Calculate the baricenter of the region of interest

Inputs

inputid Input 0type Base, Imagetype id base, image



input

Outputs

Baricenterid baricenter dbltype Base, Point 2D doubletype id base, point 2d doubleinplace id *no*inherited id *no*

Baricenter

Areaid areatype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Area

182

Parameters

Geometry typeid geometry-typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Floating-point geometryInteger geometry

domain [ 0, 2 )Geometry type

183

9.1.20 BayerToRgb

bitmap

class name BayerToRgbcatalog name Basecatalog id baseclass id Bayer2RBGauthors Mirko Demurtas

Certain color cameras output image data in raw format, which is called Bayer format.This block converts such images, which appear as a BW image in EyesWeb, to color images

Inputs

Imageid INPUT MATRIXtype Base, Imagetype id base, image



Input image

Outputs

Imageid INPUT MATRIXtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image

184

Parameters

Type Sensor CCD/CMOSid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RGGRBGGB

domain [ 0, 4 )Type Sensor CCD/CMOS

185

9.1.21 BlobListRemoveIf

bitmap

class name BlobListRemoveIfcatalog name Basecatalog id baseclass id list remove ifauthors Paolo Coletta

Remove blobs from list according to a given criteria.

Details The current implementation of the block is limited to work only with list ofblob datatype and the extraction is based on the area of the blob Note that the items inthe list are not ordered based on their area. The order is the same as the input list, whichdepends on the order established by the block which first vcreated the list

Notes During initialization the block may raise the following errors: Invalid containeddatatype: the input list is not a list of blobs - this happens if the list does not contain blobs

Inputs

Inputid inputtype Kernel, Listtype id kernel, list



Input list from which to remove items which match a given condition

Outputs


Output list from which to some items have been removed

186

Parameters


layout

Combo Box:AreaZoneToClearZoneToKeep

domain [ 0, 3 )Method of filtering. If it’s in Area mode the block compute an area based filtering

method.If it’s in Zone to clear mode, the block keeps blobs having baricenters outside zoneparameter. Otherwise if it’s in Zone to keep mode, the block keeps blobs havong baricentersinside zone parameter.

MIN AREAid min areatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value of this parameter is the minimum percetage area of the blob according to theentire image area.If the area of the blob is greather then this parameter, then the blos isinsert in the output list.If the value of the parameter is 0, all blobs are inserted.

MAX AREAid max areatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value of this parameter is the maximum percetage area of the blob according tothe entire image area.If the area of the blob is less then this parameter, then the blobs isinserted in the output list.If the value of the parameter is 1, all blobs are inserted.

187

9.1.22 BlobSubRegions

bitmap

class name BlobSubRegionscatalog name Basecatalog id baseclass id BlobSubRegionsIdauthors Maurizio Mancini

This block extracts sub-regions from a given blob.

Inputs

Input Blobid input blobtype Base, Blob 2Dtype id base, blob2d



Input silhouette of the image.

Outputs

List Blobid bloblistoutputtype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*

List of extracted blobs.

Parameters

Arm percentageid arm percentagetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Percentage of the silhouette used to find arms.

188

Legs search offsetid legssearchparametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Percentage of the vertical distance between barycenter and feet used to search legs yposition.

Legs offsetid legsoffsetparametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Minimal vertical distance between barycenter and legs starting point expressed as per-centage of the vertical distance between barycenter and feet.

Arms min thresholdid armsminthresholdparametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Minimum number of pixel identifying the ending point of each arm.

Arms max thresholdid armsmaxthresholdparametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Maximum number of pixel identifying the starting point of each arm.

Extract headid extractheadparametertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Extract or not the head region.

Extract trunkid extracttrunkparametertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Extract or not the trunk region.

Extract right armid extractrightarmparametertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Extract or not the right arm region.

189

Extract left armid extractleftarmparametertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Extract or not the left arm region.

Extract right legid extractrightlegparametertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Extract or not the right leg region.

Extract left legid extractleftlegparametertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Extract or not the left leg region.

190

9.1.23 BlobToZone

bitmap

class name BlobToZonecatalog name Basecatalog id baseclass id mappe blob to zoneauthors Paolo Coletta

categoriesAlpha (Base, Development Stage)Developer (Base, Final User Category)

This block solves the problem to bind the info, which is originally associated to blobs,to the zone where the blobs are located.

Inputs




Input matrix containing the info bounded to blobs. The number of columns matchesthe number of input blobs. The rows have the following meaning: Row 0: Zone (zero-basedindex) Row 1: Mode (e.g. Normal, Solemn, Happy, Sad, Angry, Shy). The mode is mappedto a zero-based index Row 2: Active (wether there is a blob in the zone and it is moving;it is a boolean value mapper to a double number) Row 3: Chorus Level (0.0 no chorus. 1.0chorus). Row 4: Y (in the range 0.0-1.0. If multiple blobs are in the same zone, the meanY is computed

Outputs

Outputid outputtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

191

Output matrix containing the info bounded to zones: Row 0: Mode Row 1: Active Row2: Y Row 3: Chorus Level

Parameters

Num zonesid num zonestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of zone available on the stage

ChorusLevel0id chorus level 0type Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value to be generated when the chorus level is zero (i.e., solo)


The value to be generated when the chorus level is 1 (i.e., duet)


The value to be generated when the chorus level is 2 (i.e., trio or more)

192

9.1.24 BlockConvolution

bitmap

class name BlockConvolutioncatalog name Basecatalog id baseclass id block convolutionauthors Carlo Drioli

Block Convolution

Error and Warning Messages - During Initialization phase - Mono audio input re-quired. Channel 0 will be used. - IR file opning error: error while opening the input wavefile. - Audio buffer size not allowed. Choose one of the following: 512, 1024, 2048, 4096. -Warning: Audio input and IR sampling frequency don’t match.

Inputs

Input bufferid input buffertype Base, Audio buffertype id base, audio buffer



Input buffer

Outputs

Output bufferid output buffertype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Output buffer

193

Parameters

filename parameterid IR filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”IR file (*.wav)—*.wav—All files (*.*)—*.*——”

Input wave file name. When file name is specified, the format of audio buffer is readedfrom the heqader of this file.

194

9.1.25 BonesLine3DMaker-Double

bitmap

class name BonesLine3DMaker-Doublecatalog name Basecatalog id baseclass id BonesLine3DMaker-Doubleauthors Simone Ghisio

The block creates a geometric labelled set of 3d lines starting from pairs of 3d points.It’s possible to create the output starting from user points, kinect point or from AIM modelpoints. In teh first case the user can specify how many lines must be created and the labels.In kinect mode the block automatically creates a sequence of bones with the labels of blockKinect Extractor. In AIM mode the user must specifies a qam file. Aftre this the blockautomatically creates a sequence of bones with the labels extracted from the file. In eachmode the user can modidy labels and number of bones. This block accepts geometriclabelled set double 3d inputs

Inputs

Input GeometricLabelledSet3Did input labeled set 3dtype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d double



Input Geometric Labelled Set of 3D object. This is a non homogeneous list of 3dgeometric object.

Outputs

OutputGeometricLabelledSet3Did output labeled set 3dtype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d doubleinplace id *no*inherited id *no*

Output Geometric Labelled Set 3d of 3d lines that connect input points according toparameters.

195

Parameters

BonesNumberid bones numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of bones to be created.

InitModeid modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:UserKinectAimModel

domain [ 0, 3 )Initialization of label values.

DrawPointsid drawtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AllPointsConnectedPointsDontDraw

domain [ 0, 3 )It allows to draw or not points of the input geometric labelled set. If the parameter is set

to AllPoints, the input labelled set is copied to teh output. If ConnectedPoints is selected,the outputcontains only points connected by bones. Otherwise point are not drawn.

bone00 point00id bone 00 point 00type Kernel, String datatype (Kernel Catalog).type id kernel, string

point 00 of bone 00.



196

9.1.26 BonesLine3DMaker-Int

bitmap

class name BonesLine3DMaker-Intcatalog name Basecatalog id baseclass id BonesLine3DMaker-Intauthors Simone Ghisio

The block creates a geometric labelled set of 3d lines starting from pairs of 3d points.It’s possible to create the output starting from user points, kinect point or from AIM modelpoints. In teh first case the user can specify how many lines must be created and the labels.In kinect mode the block automatically creates a sequence of bones with the labels of blockKinect Extractor. In AIM mode the user must specifies a qam file. Aftre this the blockautomatically creates a sequence of bones with the labels extracted from the file. In eachmode the user can modidy labels and number of bones. This block accepts geometriclabelled set 3d int inputs

Inputs

Input GeometricLabelledSet3Did input labeled set 3dtype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d int




Outputs

OutputGeometricLabelledSet3Did output labeled set 3dtype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d intinplace id *no*inherited id *no*

Output Geometric Labelled Set 3d of 3d lines that connect input points according toparameters.

197

Parameters

BonesNumberid bones numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of bones to be created.

InitModeid modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:UserKinectAimModel

domain [ 0, 3 )Initialization of label values.

DrawPointsid drawtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AllPointsConnectedPointsDontDraw

domain [ 0, 3 )It allows to draw or not points of the input geometric labelled set. If the parameter is set

to AllPoints, the input labelled set is copied to teh output. If ConnectedPoints is selected,the outputcontains only points connected by bones. Otherwise point are not drawn.





198

9.1.27 BooleanToTrigger

bitmap

class name BooleanToTriggercatalog name Basecatalog id baseclass id bool to triggerauthors Paolo Coletta

Generates a trigger according to the value of an input boolean datatype.

Inputs

Inputid inputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool



Input boolean datatype. The block generates a trigger as output according to the valueof this datatype.

Outputs


Output trigger datatype.

199

Parameters


layout

Combo Box:False to trueTrue to falseAny changeTrueFalse

domain [ 0, 5 )Specifies when to generate the output trigger.

Initial stateid initial statetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:IndeterminateTrueFalse

domain [ 0, 3 )This value is used only at first signal change detection to initialize the previous signal

state.

200

9.1.28 BouncingBall

bitmap

class name BouncingBallcatalog name Basecatalog id baseclass id bouncing ballauthors Paolo Coletta

Computes the dynamics of a bouncing ball. As long as the input signal is slow (below agiven threshold) the poisition of the ball (the output signal) tracks the input signal. If thethreshold is exceeded, the ball detaches from the input signal and evolves autonomouslybasing on its initial speed and on the given accelleration (gravity). The ball looses apercentage of its energy when bouncing against the floor or the roof. The block works on asingle dimensions, thus, since the ball is subject to gravity accelleration, you should usuallyfeed the block with a positionalong the vertical axis.

Inputs

Input positionid input positiontype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input position (in meters)

Outputs

Positionid output positiontype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output absolute position (in meters)

201

Velocityid output velocitytype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output speed in meter per second

Resetid output resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Signal whether the output was reset. Resetting may occur on user’s request, on validgrabbing conditions, or, rarely, when numerical issue are detected.

Parameters

Accelerationid accelerationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the acceleration applied to the mass (in meters/secondˆ2)

Can detachid can detachtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the output can detach from the input. If yes, the output detacheswhen the speed exceeds the given threshold

Detach velocityid detach velocitytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the velocity at which mass does not track anymore the input position and startmoving independently

Can grabid can grabtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the output can be grabbed by the input. If yes, the output will trackthe input when the position match or cross each other

202

Do not grab beforeid frames no grabtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

The number of frames that must elapse from the detach time before the input can regrabthe output

Floor levelid floor leveltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the level, in meters, of the floor. The ball is constrained to stay above thislevel and bounces on it

Roof levelid roof leveltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the level, in meters, of the roof. The ball is constrained to stay below this leveland bounces on it

Energy lossid energy losstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The energy percentage that is lost at each bum


Reset the system to its initial conditions, which are specified by the above parameters

Compute Delta Tid compute delta ttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true, the delta T is inherited from the input datatype (presentation time)

Delta Tid delta ttype Kernel, Time datatype (Kernel Catalog).type id kernel, time

The delta T (time delay of each step), in the case that it is not automatically computed

203

9.1.29 BoundRoiInRoi

bitmap

class name BoundRoiInRoicatalog name Basecatalog id baseclass id boundroiinroiauthors Simone Ghisio

This block verify if the input ROI is contained in the parameter ROI.

Inputs

InputROIid input roitype Base, Roi 2D doubletype id base, roi2d double


read only/read write read writereferred as inplace OutputROIreferred as inherited *no*

Input ROI

Outputs

OutputROIid output roitype Base, Roi 2D doubletype id base, roi2d doubleinplace id InputROIinherited id *no*

Bounded ROI

204

Parameters

Typeid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:DoubleInt

domain [ 0, 2 )Specify whether ROI coordinates and size are expressed as normalized floating-point

(double) numbers or as integer numbers

ParameterROIid parameter roitype Base, Roi 2D doubletype id base, roi2d double

Bounding ROI

205

9.1.30 BoundingRect

bitmap

class name BoundingRectcatalog name Basecatalog id baseclass id image boundingrect

authors

Mirko DemurtasAndrea RicciMassimiliano PeriPaolo Coletta

Calculate the bounding rect inner to the region of interest

Inputs

Imageid imagetype Base, Imagetype id base, image



Image

Outputs

Bounding rectid bounding-rect-dbltype Base, Roi 2D doubletype id base, roi2d doubleinplace id *no*inherited id *no*

Bounding rectangle

206

Parameters

Geometry typeid geometry-typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Floating-point geometryInteger geometry

domain [ 0, 2 )Geometry type

207

9.1.31 BrightnessChromaticityDistortion

bitmap

class name BrightnessChromaticityDistortioncatalog name Basecatalog id baseclass id bg brightness cromaticity distortionauthors Paolo Coletta

Implements the background subtraction via the brightness/cromaticity distortion method,asexplained in the paper ”A statistical approach for real-time robust background subtractionand shadow detection”

by T. Horprasert, D. Harwood, and L. S. Davis

Inputs

Input imageid video streamtype Base, Imagetype id base, image



Input image containing the full image (background + forground), or the backgroundonly (during the trainig period).

Outputs

Output foreground imageid foregroundtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output containing the foreground image only.

208

Shaded backgroundid shaded backgroundtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

This is the image classified as background even if subject to a lower illumination withrespect to the training data

Highlighted backgroundid highlighted backgroundtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

This is the image classified as background even if subject to a stronger illumination withrespect to the training data

Current training set sizeid training set sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Current size of the training set

Parameters

Working mode.id working modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:TrainingRunningAuto

domain [ 0, 3 )In training mode the block grabs the statistics about the background. In running mode

the blocks uses these statistics to distinguish between background and forground.

209

Statusid statustype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:To be trained yetCurrently trainingTrained

domain [ 0, 3 )Readonly parameter to show the current status of the block.

Trainig set sizeid training set sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Maximum size of the training set. During the training phase the block stores in memorythe images corresponding to the given size. If more images are provided as input, the oldestone are replaced with the newsest ones

Detection rateid detection ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specified the detection rate of the algorithm. The auto-computed parameters (TauCD,TauAlpha1, TauAlpha2, TauAlphaLow) are choosen such that the algorithm applied to thetraining set matches this detection rate.

Automatic parameters selectionid auto tuningtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true the auto-computed parameters for TauCD, TauAlpha1, TauAlpha2, andTauAlphaLow are used. If set to false, the user-specified values are used.

Tau CDid tau cdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Tau CD (where CD stands for Chromaticity Distortion) is the threshold of the normal-ized chromaticity. Pixels over this threshold are classified as foreground.

Tau Alpha 1id tau alpha 1type Kernel, Double datatype (Kernel Catalog).type id kernel, double

210

Tau Alpha 1 is the lower threshold of the normalized brightness. Pixels below thisthreshold are classified as not background (i.e., foreground or shadow).

Tau Alpha 2id tau alpha 2type Kernel, Double datatype (Kernel Catalog).type id kernel, double

Tau Alpha 2 is the upper threshold of the normalized brightness. Pixels over thisthreshold are classified as not background (i.e., foreground or hightlited pixels).

Tau alpha lowid tau alpha lowtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lower threshold for brightness distortion. If brightness distortion is below this thresholdthen the pixel is assumed to be a foreground one, regardless of the chromaticity distortion.

DarkColorid dark colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

This is the value of a color which is considered dark and worth applying TauAlphaLow.To automatically compute TauAlphaLow, which stems from euristic considerations, animage with such value is applied as an input. The threshold TauAlphaLow is choosen suchthat a given percentage of pixels are below the threshold.

Dark color detection rateid dark color detection ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the detection rate to be used to compute TauAlphaLow. TauAlphaLow ischoosen such that the given percentage of pixels from the dark image are classified asforeground regardless of the chromaticity distortion.

Use TauCD correctionid use tau cd correctiontype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, TauCD is linearly decreased while brightness moves from TauAlpha1to TauAlphaLow. The result is a detection of dark foreground objects. However, theperformance of shadow removal decreases.

TauCD correction percentageid tau cd correction percentagetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

211

Specifies the amount of correction applied to TauCD. If 1.0 is specified, TauCD isdecreased up to zero, otherwise, it is decreased up to the given percentage of its initialvalue.

Folder Nameid folder nametype Kernel, String datatype (Kernel Catalog).type id kernel, stringlayout Folder

Specifies the folder where to load/save training data. This value is optional and can beused to avoid recomputing statistics when a previous setup is being reused.

Load Training Dataid load training datatype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Loads statistics from a previous training. For this to work, the Folder Name needs to bespecified. If valid data is found, the working mode is automatically set to running (unless itwas Auto, in such case the mode is not changed but the block starts performing backgroundsubtraction.

Save Training Dataid save training datatype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Save statistics from training. For this to work, the traing must have been performed.Previous files in the same folder will be overwritten with the new data.

Discard Training Dataid discard training datatype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Discards statistics from training.

Discard training data on doneid discard training data on donetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether training data is discarded when the patch is initialized. By defaulttraining data is discarded in order to minimize the risk to reuse old (wrong) statistics whenthe patch is restarted. However, if you are sure that lighting conditions will not change,you can disable this option to speed up startup

212

ApplySuggestedSettingsid apply suggested settingstype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Applies the computed settings as the user-specified settings .

213

9.1.32 CameraCorrection

bitmap

class name CameraCorrectioncatalog name Basecatalog id baseclass id camera correction


Digital camera usually introduces significant distortion caused by the camera and lens.These distortions cause errors in any analysis of the image. This block corrects thesedistortion using intrinsic camera parameters and distortion coefficients.

Details The intrinsic camera parameters are focal lengths fx, fy, and principal pointcoordinates cx, cy. The distortion is characterized by two coefficients of radial distortionsk1, k2 and two coefficients of tangential distortions p1, p2. The undistorted coordinates xuand yu of point with coordinates (xd, yd) are computed in accordance with the followingformulas: xu = xd * (1 + k1*rˆ2 + k2*rˆ4) + 2*p1*xd*yd + p2 * ( rˆ2 + 2* xdˆ2 ) yu= yd * (1 + k1*rˆ2 + k2*rˆ4) + 2*p1*xd*yd + p2 * ( rˆ2 + 2* ydˆ2 ) Here rˆ2 = xdˆ2+ ydˆ2, xd = (j-cx)/fx, yd = (i-cy)/fy; i and j are row and columns numbers of the pixel.The pixel value is computed using bilinear interpolation of four nearest pixel of the sourceimage. If undistorted coordinates are outside the image, then the destination pixel is notchanged.

Inputs

Imageid input video streamtype Base, Imagetype id base, image



Image

214

Outputs

Corrected imageid output remappedtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Corrected image

Parameters

X Focal (fx)id X FOCALtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Focal lengths along the x axis.

Y Focal (fy)id Y FOCALtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Focal lengths along the y axis.

Principal Point Typeid principal point typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Floating-pointInteger

domain [ 0, 2 )Specifies whether the principal point is expressed in integer or floaing-point normalized

coordinates.

Principal Point (cx, cy)id PRINC POINTtype Base, Point 2D doubletype id base, point 2d double

Coordinate of the principal point.

Radial First coefficient (k1)id R F Ctype Kernel, Double datatype (Kernel Catalog).type id kernel, double

First coefficient of radial distortion.

215

Radial Second coeff. (k2)id R S Ctype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Second coeff. of radial distortion.

Tangential First coefficient (p1)id T F Ctype Kernel, Double datatype (Kernel Catalog).type id kernel, double

First coefficient of tangential distortion.

Tangential Second coeff. (p2)id T S Ctype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Second coefficient of tangential distortion.

Interpolation Algorithmid interpolation algorithmtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Nearest neighbourLinearCubicSuper Sample

domain [ 0, 4 )Specifies the algorithm used to interpolate the image when resize is needed. A rough

interpolation (e.g., nearest neighbour) may cause visible artifacts, however, the CPU usageto perform such interpolation is quite limited. A good quality interpolation (e.g., cubic)provides better results but may cause an high CPU load.

Clear Imageid clear imagetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

According to the setting of the block, the resulting image might not cover the wholearea. If this parameter is set, the uncovered area is cleared

216

9.1.33 CannyEdgeDetector

bitmap

class name CannyEdgeDetectorcatalog name Basecatalog id baseclass id canny edge detectorauthors Simone Ghisio

The detector uses a grayscale image as an input and outputs a black-and-white image,where non-zero pixels mark detected edges.

Inputs

Input Imageid input imagetype Base, Imagetype id base, image



The input image

Outputs

Output Imageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output edge

Parameters

Lowid Lowtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Lower threshold for edges detection.

217

Highid Hightype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Higher threshold for edges detection.

218

9.1.34 Centroids Calc

bitmap

class name Centroids Calccatalog name Basecatalog id baseclass id centroids calc

authorsSimone GhisioPaolo Coletta

This block calculates centroids of input silhouette or of a subpart of the input silhouette.

Notes The following labels are assigned to the computed centroids (some might notbe computed according to the seetings of the block) head COG left shoulder left elbowleft forearm left hand right shoulder right elbow right forearm right hand left knee left footright knee right foot

Inputs





Outputs

OutputLabelledSetid output listtype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d doubleinplace id *no*inherited id *no*

OutputLabelledSet

219

Parameters

Silhouette typeid silhouettetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Full BodyUpper HalfLower HalfLeft HalfRight Half

domain [ 0, 5 )The block compute the centroids assuming that the input blob represent a human sil-

houette. This parameter specifies whether the silhouette is complete, or if it rapresent justhalf human body and, in this latter case, which is the part of the body

Output typeid output typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:DoubleInteger

domain [ 0, 2 )Specifies the type of the coordinates inserted in the output labelled set

Filter centroidsid compute alphatype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the centroids position are filter before being inserted into the aoutputlist

Filter speedid alphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies whether the filter is slow or fast. A slow filter provides smooth coordinatesbut is slow to track sudden changes of such coordinates. If set to the minimum speed (0.0)the filter does not track the coordinates at all. A fast filter can track sudden changes ofthe coordinate, but provides rough values. If set to the maximum speed (1.0), no filter isapplied

220

Add intermediate centroidsid add computed centroidstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

In some cases the block must compute more centroids than the ones requested by theuser, due to hierarchical relations among them (e.g., the hand requires the forearm, etc). Ifthis parameter is set to true, all computed centroids are inserted into the output labelledset, even if not explicitely requested by the user

COGid COGtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Center of Gravity

Headid headtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Head centroid

LeftShoulderid left shouldertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Left Shoulder centroid

LeftElbowid left elbowtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Left Elbow centroid

LeftForearmid left forearmtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Left Forear centroid

LeftHandid left handtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Left Hand centroid

221

RightShoulderid right shouldertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Right Shoulder centroid

RightElbowid right elbowtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Right Elbow centroid

RightForearmid right forearmtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Right Forear centroid

RightHandid right handtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Right Hand centroid

LeftKneeid left kneetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Left Knee centroid

LeftFootid left foottype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Left Foot centroid

RightKneeid right kneetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Right Knee centroid

222

RightFootid right foottype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Right Foot centroid

223

9.1.35 CentroidsToLines

bitmap

class name CentroidsToLinescatalog name Basecatalog id baseclass id centroids to linesauthors Simone Ghisio

This block transforms a labelled set of point to a labelled set of lines. The block expectssome specific labels in the input set, which are the ones generated by the CentroidsCalcblock. Thus, this block is usually placed after the CentroidsCalc block if you want tovisualize its output.

Inputs

Input Blobid input blobtype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d double




Outputs

OutputLabelledSetid output listtype Base, Graphic Labelled Set 2D doubletype id base, graphic labeled set 2d doubleinplace id *no*inherited id *no*

OutputLabelledSet

224

Parameters

Drawing modeid draw typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CentralHierarchical

domain [ 0, 2 )Specify wheter to use Central or Hierarchical drawing mode. In Central mode, all joints

are connected to the central one, whereas in Hierarchical mode the points are connected toform a sort of human skeleton

225

9.1.36 ChangeInterlaceMode

bitmap

class name ChangeInterlaceModecatalog name Basecatalog id baseclass id image change interlace mode


Change the interlace mode to the input frame

Inputs

Input frameid input video streamtype Base, Imagetype id base, image


read only/read write read writereferred as inplace Output framereferred as inherited *no*

The input frame

Outputs

Output frameid output video streamtype Base, Imagetype id base, imageinplace id Input frameinherited id *no*

The output frame with the changed intelace information

226

Parameters

Interlaceid modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ProgressiveFirst Field 1First Field 2

domain [ 0, 2 ]Interlace mode to apply to the input frame

Keep image unchangedid only modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Modify interlace mode and keep the input image unchanged

227

9.1.37 Circular Hough Transform

bitmap

class name Circular Hough Transformcatalog name Basecatalog id baseclass id circular hough transformauthors Simone Ghisio

Find circles of a given radius in a grayscale image using the Hough transform. Thisblock implements OpenCV HoughCircles function.

Details Based on a previous implementation by: AnneMarie Burns

Inputs




Image on which search circles.

Outputs

OutputMatrixid output matrixtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Output matrix containing the circles center coordinates and radius

228

OutputImageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image displaying the circles found by the Hough transform

Parameters

Methodid param methodtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Gradientstandard

domain [ 0, 2 )Currently, the only implemented method is CV HOUGH GRADIENT, which is basi-

cally 21HT, described in H.K. Yuen, J. Princen, J. Illingworth and J. Kittler. Comparativestudy of Hough Transform methods for circle finding.

Resolutionid resolutiontype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Resolution of the accumulator used to detect centers of the circles. For example, if it is1, the accumulator will have the same resolution as the input image, if it is 2 - accumulatorwill have twice smaller width and height, etc.

Min Distanceid min distancetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Minimum distance between centers of the detected circles. If the parameter is too small,multiple neighbor circles may be falsely detected in addition to a true one. If it is too large,some circles may be missed.

Canny Thresholdid canny thresholdtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 255 ]

Higher threshold of the two passed to Canny edge detector (the lower one will be twicesmaller).

229

Accumulator thresholdid accumulator thresholdtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Accumulator threshold at the center detection stage. The smaller it is, the more falsecircles may be detected. Circles, corresponding to the larger accumulator values, will bereturned first.

Minimum radiusid minimum radiustype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Minimal radius of the circles to search for.

Maximum radiusid maximum radiustype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Maximal radius of the circles to search for. By default the maximal radius is set tomax(image width, image height).

Maximum returned circlesid maximum circlestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Maximal number of the circles returned by the circular Hough transform.

Show Intermediate Imageid show imagetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Show Intermediate Image

230

9.1.38 ClockGenerator

bitmap

class name ClockGeneratorcatalog name Basecatalog id baseclass id ClockGeneratorauthors Mirko Demurtas

This block generate a signal clock

Outputs

Bangid BangOuttype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Bang

Parameters

Bang generatorid Bangtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Bang generator (kernel catalog)

Patch startid PatchStarttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang when the patch starts.

Periodicid Periodictype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang periodically.

231

Periodid Periodtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Period is expressed in 100nanoseconds unit (i.e., 10milliseconds must be specified as100000)

Phaseid Phasetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Phase

Absolute timeid Absolutetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generates a bang at a specified absolute time.

AbsoluteTimeid AbsoluteTimetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Absolute time

232

9.1.39 CoarseGraining

bitmap

class name CoarseGrainingcatalog name Basecatalog id baseclass id coarsegrainingauthors Maurizio Mancini

Computes the sample entropy of the input data.

Inputs

Input time seriesid coarsegraininginputtype Kernel, Generic datatypetype id kernel, generic datatype



The time series containing the input data.


Outputs

Sample entropyid coarsegrainingoutputtype Base, TemporalDatatype id base, temporal datainplace id *no*inherited id *no*

The sample entropy of the input time series.

Parameters

factorid coarsegrainingfactortype Kernel, Int datatype (Kernel Catalog).type id kernel, int

233

The number of the input samples that are used to compute each output sample.

234

9.1.40 Cochleogram

bitmap

class name Cochleogramcatalog name Basecatalog id baseclass id cochleogramauthors Carlo Drioli

Computes the cochleogram of the input audio buffer.

Inputs




Input buffer

Outputs

Output matrixid output matrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output matrix

Output imageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

235

This is the same as the matrix output, but in image format. Since the cochleogram isused to get a visual representation of the elaboration that the audio signal is undergone inthe cochlea, an image is an appropriate ”alternative” to the mathematical format.

Parameters

Gainid gaintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Output gain

Pixel modelid pixel modeltype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:8 unsigned16 unsigned16 signed32 Float

domain [ 0, 4 )Pixel model of the image. Specifies the number of bits used for each channel, hence the

color definition. May assume one of the following values:8 bits unsigned integer;16 bits unsigned integer;16 bits signed integer;32 bits floating point.

236

9.1.41 CollapseLabels

bitmap

class name CollapseLabelscatalog name Basecatalog id baseclass id CollapseLabelsauthors Simone Ghisio

The block allows to collapse labels of a labelled set datatype input.

Inputs

InputLabelledSetid input labeled settype Kernel, Labelled settype id kernel, labeled set



Labelled set to evaluate.

Outputs

OutputStringid output stringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

String with alle the labels of the input

237

9.1.42 ColorToRgb

bitmap

class name ColorToRgbcatalog name Basecatalog id baseclass id ColorToRGBauthors Mirko Demurtas

This block converts the input in RGB color.

Inputs

Red colorid InputRtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Red color

Green colorid InputGtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Green color

238

Blue colorid InputBtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Blue color

Outputs

RGB Colorid Outputtype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolorinplace id *no*inherited id *no*

RGB Color

Parameters

Input Typeid InputTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RGB decimal valuesRGB integer valuesRGB color valueHSV decimal valuesHSV integer values

domain [ 0, 4 ]Type of the input

Output Typeid OutputTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RGB decimal valuesRGB integer valuesRGB color value

domain [ 0, 2 ]Type of the output

239

9.1.43 CompareWithString

bitmap

class name CompareWithStringcatalog name Basecatalog id baseclass id compare stringauthors Simone Ghisio

Extract a substring from the input string.

Inputs

InputStringid input stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string



Input string to compare

Outputs

CompareValueid output comparisontype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

If string are the same, output value is 1. Otherwise is 0.

Parameters

Labelid compare stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string

String for comaparison. (use regular expression syntax in Perl syntax: http://www.boost.org/libs/regex/doc/syntax perl.html#Perl).For example, .* pattern matches any number of characters, thus behaving similarly to the

240

* pattern.So if you need to find objects with label starting with ’point’ substring, you canwrite (point).* nstead, if you need to find objects with label containing ’point’ substring,you can write .*(point).*

241

9.1.44 ComposeChannels

bitmap

class name ComposeChannelscatalog name Basecatalog id baseclass id compose channel

authorsPaolo ColettaMirko Demurtas

Compose several timeseries into a single multichannel timeseries

Notes The input timeseries may be multichannel too. In such cases the output time-series is composed of the sum of all channels of all timeseries. The output range is themaximum of the ranges of the input timeseries.

Inputs

Input Stream 00id input audio stream 00type Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace *no*referred as inherited Output stream

Input Stream


Input Stream 01id input audio stream 01type Kernel, Generic datatypetype id kernel, generic datatype



Input Stream

242


Outputs

Output streamid output audio streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input Stream 00inherited id *no*

Output audio buffer with multiple streams

Parameters

Number of streamsid channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Number of input streams

243

9.1.45 ComposeChannels

bitmap

class name ComposeChannelscatalog name Basecatalog id baseclass id image compose channels


Compose multiple Black & White images to a multichannel image

Inputs

Input channel 1 (R/B/Y)id input video stream 1type Base, Imagetype id base, image



Red channel if the output image image is RGB; Blue channel if the output image isBGR; Y channel if the output image is YUV.

Input channel 2 (G/G/U)id input video stream 2type Base, Imagetype id base, image



Green channel if the output image image is RGB or BGR; U channel if the output imageis YUV.

244

Input channel 3 (B/R/Y)id input video stream 3type Base, Imagetype id base, image



Blue channel if the output image image is RGB; Red channel if the output image isBGR; V channel if the output image is YUV.

Outputs

Outputid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output multichannel image.

Parameters

Color modelid color modeltype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RGBBGRYUVHSVRGBABGRAYUVAHSVA

domain [ 0, 7 ]Specifies the color model of the output image

245

9.1.46 ComposePCMchannels

bitmap

class name ComposePCMchannelscatalog name Basecatalog id baseclass id compose pcm channels

authorsPaolo ColettaAlessandro Fausto

Builds an audio buffer composed of several pcm channels, by composing the input pcmaudio buffers.

Inputs

Input 0id input 0type Base, PCMAudioBuffertype id base, pcm audio buffer



Input 0

Input 1id input 1type Base, PCMAudioBuffertype id base, pcm audio buffer



Input 1

246

Outputs

Outputid outputtype Base, PCMAudioBuffertype id base, pcm audio bufferinplace id *no*inherited id *no*

Output stream composed by all incoming input pcm buffers

Parameters


Number of input audio streams. Each stream may be composed of many channels

247

9.1.47 ComputeDistance

bitmap

class name ComputeDistancecatalog name Basecatalog id baseclass id Distanceauthors Simone Ghisio

This block calculates the distance between two points in absolute or signed value

Inputs

Point Xid Input Xtype Base, Point 2D doubletype id base, point 2d double



X Point Coordinates

Point Yid Input Ytype Base, Point 2D doubletype id base, point 2d double



Y Point Coordinates

Outputs

Distanceid Distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

248

Distance between x and y

X Axis Distanceid X Distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

X axis distance between x and y

Y Axis Distanceid Y Distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Y axis distance between x and y

Parameters

Distance Typeid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Signed distanceAbsolute distance

domain [ 0, 2 )Signed distance or absolute distance.

249

9.1.48 ComputeFPS

bitmap

class name ComputeFPScatalog name Basecatalog id baseclass id compute fpsauthors Paolo Coletta

Computes the Frames Per Second of the input datatype

Inputs




Input datatype whom framerate is going to be computed

Outputs

FPSid outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Computed Frames Per Second

250

Parameters

Selectorid selectortype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Creation TimePresentation TimeMedia Time

domain [ 0, 3 )Each datatype has more than one timestamp attached to itself. This parameter specifies

which one to use when computing FPS

251

9.1.49 ComputeROIArea

bitmap

class name ComputeROIAreacatalog name Basecatalog id baseclass id Areaauthors Mirko Demurtas

This block computes the area of a given input ROI

Inputs

InputROIid Inputtype Base, Roi 2D doubletype id base, roi2d double



Input ROI.

Outputs

Areaid Outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Area of Input ROI

252

9.1.50 ComputeStatisticalInfo

bitmap

class name ComputeStatisticalInfocatalog name Basecatalog id baseclass id statistical operationauthors Simone Ghisio

Compute some features of the input timeseries. Note that the features are computedbasing only on the data available in a single buffer of the timeseries, i.e., the block does nothave internal memory.

Inputs

Input Bufferid Input Buffertype Kernel, Generic datatypetype id kernel, generic datatype



This is the input of which to compute extract the user-specied feature


Outputs

Output valueid Resulttype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Result of the operation

253

Parameters


layout

Combo Box:maximum value of the vectorminimum value of the vectormean of the vectorstandard deviation of the vectormaximum absolute value of the vector

domain [ 0, 4 ]Type of the operation

254

9.1.51 ConcatenateStrings

bitmap

class name ConcatenateStringscatalog name Basecatalog id baseclass id concatenate stringsauthors Paolo Coletta

Concatenates an arbitrary number of strings.

Inputs

Input string 1id input 1type Kernel, String datatype (Kernel Catalog).type id kernel, stringrequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

The input string 1 wil be placed at position 1 to build the output concatenated string

Input string 2id input 2type Kernel, String datatype (Kernel Catalog).type id kernel, stringrequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

The input string 2 wil be placed at position 2 to build the output concatenated string

Outputs

Output stringid outputtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

The concatenation of the input strings

255

Parameters


Number of inputs

256

9.1.52 ConcatenateStringsToMultipleLines

bitmap

class name ConcatenateStringsToMultipleLinescatalog name Basecatalog id baseclass id concatenate strings to multiple linesauthors Paolo Coletta

Concatenates sequence of strings to multiple lines (page), scrolling up the strings whenthe given number of rows (lines) is filled.

Inputs

Input stringid input stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string


read only/read write read writereferred as inplace Output substringreferred as inherited *no*

Input string from which a substring will be extracted.

Outputs

Output substringid output stringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id Input stringinherited id *no*

The output substring extracted from the input string.

Parameters

Number of linesid first charactertype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

257

Maximum number of lines to use

258

9.1.53 ContainerSize

bitmap

class name ContainerSizecatalog name Basecatalog id baseclass id container sizeauthors Paolo Coletta

Returns the size of a container (e.g., a list, a labelled set).

Inputs




This is the container which size will be estracted by the block

Required interfaceskernel, container

Outputs

Outputid outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Size of the input container

259

9.1.54 Convert3Don2D-Int

bitmap

class name Convert3Don2D-Intcatalog name Basecatalog id baseclass id convert 3d on 2d intauthors Simone Ghisio

Convert 3D object into 2D object using a plane of projection correspondig with xy,xzor yz plane.

Inputs




Generic input 3D

Required interfacesbase, 3d conversion 2d

Outputs


Output 2D. It has the same type of input, but in 2 dimensions.

260

Parameters

FixedAxisid param axis 3dtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:XYZ

domain [ 0, 3 )Specifies the orthogonal axis to the plane of projection. The variable of this axis axumes

constant value 0.

261

9.1.55 Convert3Don2D Double

bitmap

class name Convert3Don2D Doublecatalog name Basecatalog id baseclass id convert 3d on 2d doubleauthors Simone Ghisio

Convert 3D object into 2D object using a plane of projection correspondig with xy,xzor yz plane.

Inputs




Generic input 3D

Required interfacesbase, 3d conversion 2d

Outputs


Output 2D. It has the same type of input, but in 2 dimensions.

262

Parameters

FixedAxisid param axis 3dtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:XYZ

domain [ 0, 3 )Specifies the orthogonal axis to the plane of projection. The variable of this axis axumes

constant value 0.

263

9.1.56 ConvertAudioToPCM

bitmap

class name ConvertAudioToPCMcatalog name Basecatalog id baseclass id convert to pcmauthors Massimiliano Peri

Converts an audio buffer to a static pcm audio buffer

Inputs

Audio Bufferid input sound buffertype Base, Audio buffertype id base, audio buffer



Outputs

PCM Bufferid output pcm buffertype Base, PCMAudioBuffertype id base, pcm audio bufferinplace id *no*inherited id *no*

264

Parameters

PCMSampleFormatid pcm typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 11 )Specifies the format of each sample of the output PCM audio buffer

265

9.1.57 ConvertPCMToAudio

bitmap

class name ConvertPCMToAudiocatalog name Basecatalog id baseclass id convert from pcmauthors Massimiliano Peri

Converts an pcm audio buffer to a audio buffer

Inputs

PCM Bufferid input sound buffertype Base, PCMAudioBuffertype id base, pcm audio buffer



Outputs

Audio Bufferid output pcm buffertype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

266

9.1.58 ConvertPCMToPCM

bitmap

class name ConvertPCMToPCMcatalog name Basecatalog id baseclass id convert pcmauthors Alessandro Fausto

Converts an pcm audio buffer to a pcm audio buffer with another sample format.

Inputs

PCM Bufferid input pcm buffertype Base, PCMAudioBuffertype id base, pcm audio buffer



Outputs

PCM Bufferid output pcm buffertype Base, PCMAudioBuffertype id base, pcm audio bufferinplace id *no*inherited id *no*

267

Parameters

PCMSampleFormatid pcm typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 11 )Specifies the format of each sample of the output PCM audio buffer

268

9.1.59 Counter

bitmap

class name Countercatalog name Basecatalog id baseclass id Counterauthors Mirko Demurtas

This block counts the number of inputs

Inputs




Input Descrption

Outputs

Outputid Outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Output Description

269

Parameters


layoutCombo Box:IntegerReal

domain [ 0, 2 )Type Description

Stepid Steptype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Step Description

Beginid Begintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Begin Description

Endid Endtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

End Description

Custom reset valueid CustomResettype Kernel, Double datatype (Kernel Catalog).type id kernel, double

When the counter is reset, and the reset mode is set to custom value, this value is used.

Startid Starttype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Start Description

Stopid Stoptype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

270

Stop Description


Reset Description

Start modeid StartModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:AutoManual

domain [ 0, 2 )Specifies whether the counter automatically start counting when the patch is initialized

(Auto) or whether counting must be explicitelly started via the Start command.

Reset modeid ResetModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:BeginCustom value

domain [ 0, 2 )Specifies the behaviour when the counter is reset. The counter can reset to the initial

value (Begin) or to a custom value.

Bounding modeid TypeCountertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Unbounded counterBounded counterCircular counter

domain [ 0, 3 )Specifies whether the counter is bounded (stops counting after a given bound is reached),

unbounded (counts forever) or circular (restart from the beginning after a given bound isreached).

271

ActivateOnSpecialEventsid ActivateOnSpecialEventstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the block activates on special events such as PatchStart, or triggeringthe Reset command. If true, these events causes a block activation, if false the block justactivates when an input changes. Note that the events are not actually counted (e.g., onpatch start a zero count is generated), however, the number of activation of the blocks willdiffer from the number of inputs.

272

9.1.60 CreateGeometricLabelledSet3D-Double

bitmap

class name CreateGeometricLabelledSet3D-Doublecatalog name Basecatalog id baseclass id CreateGeometricLabelledSet3D-Doubleauthors Simone Ghisio

The block allows to group 3d objects into a geometric labelled set. The block can creategeometric labelled set 3d datatype according to INPUT TYPE parameter. This blockaccepts geometric int inputs

Inputs

Input00id input 00type Kernel, Generic datatypetype id kernel, generic datatype



Input 00.

Required interfacesbase, base geometric 3d double

Outputs

OutputGeometricLabelledSet3Did output labeled set 3dtype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d doubleinplace id *no*inherited id *no*

Output Geometric Labelled Set 3d of 3d objects.

273

OutputLabelListid output label listtype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*

List of labels of geometric labelled set 3d.

Parameters

InputNumberid input numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of input to be grouped into a geometric labelled set 3d.

Label Generationid label generationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:AutomaticUser

domain [ 0, 2 )The block can generate automatically the label for each input or using the label con-

tained in LABEL parameters.

Generate new labelsid resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Force the cration of a new set of labels. It works only in Automatic Label Generationmode.

274

9.1.61 CreateGeometricLabelledSet3D-Int

bitmap

class name CreateGeometricLabelledSet3D-Intcatalog name Basecatalog id baseclass id CreateGeometricLabelledSet3D-Intauthors Simone Ghisio

The block allows to group 3d objects into a geometric labelled set. The block can creategeometric labelled set 3d datatype according to INPUT TYPE parameter. This blockaccepts geometric double inputs

Inputs




Input 00.

Required interfacesbase, base geometric 3d int

Outputs

OutputGeometricLabelledSet3Did output labeled set 3dtype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d intinplace id *no*inherited id *no*

Output Geometric Labelled Set 3d of 3d objects.

275


List of labels of geometric labelled set 3d.

Parameters


Number of input to be grouped into a geometric labelled set 3d.







276

9.1.62 CreateGeometricLabelledSetDouble

bitmap

class name CreateGeometricLabelledSetDoublecatalog name Basecatalog id baseclass id CreateGeometricLabelledSet-Doubleauthors Simone Ghisio

The block allows to group input values into a geometric labelled set. The block cancreate geometric or graphic labelled set datatype according to INPUT TYPE parameter.This block accepts geometric/graphic int inputs

Inputs




Input 00.

Required interfacesBase, Vertex2DDouble

Outputs

Output GeometricLabelledSetid output labeled settype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d doubleinplace id *no*inherited id *no*

Output Geometric Labelled Set of homogeneous geometric object.

277


List of labels of geometric labelled set.

Parameters


Number of input to be grouped into a geometric labelled set.

Input Typeid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:GeometricGraphic

domain [ 0, 2 )It defines the type of output geometric labelled set.







278

9.1.63 CreateGeometricLabelledSetInt

bitmap

class name CreateGeometricLabelledSetIntcatalog name Basecatalog id baseclass id CreateGeometricLabelledSet-Intauthors Simone Ghisio

The block allows to group input values into a geometric labelled set. The block cancreate geometric or graphic labelled set datatype according to INPUT TYPE parameter.This block accepts geometric/graphic double inputs

Inputs




Input 00.

Required interfacesBase, Vertex2DInt

Outputs

Output GeometricLabelledSetid output labeled settype Base, Geometric Labelled Set 2D inttype id base, geometric labeled set 2d intinplace id *no*inherited id *no*


279


List of labels of geometric labelled set.

Parameters


Number of input to be grouped into a geometric labelled set.

Input Typeid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:GeometricGraphic

domain [ 0, 2 )It defines the type of output geometric labelled set.







280

9.1.64 CrossCorrelation

bitmap

class name CrossCorrelationcatalog name Basecatalog id baseclass id cross correlationauthors Alberto Massari

Return an index of similarity between two buffers

Inputs

Input bufferid input buffertype Kernel, Generic datatypetype id kernel, generic datatype



Input buffer


Outputs

Correlationid correlation indextype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The correlation between the input audio signal and the reference signal

281

Parameters

filename parameterid reference filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”IR file (*.wav)—*.wav—All files (*.*)—*.*——”

Input wave file name. When file name is specified, the format of audio buffer is readedfrom the heqader of this file.

Learning modeid learning modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If in learning mode, the input buffer will be stored as reference signal

282

9.1.65 Demultiplexer

bitmap

class name Demultiplexercatalog name Basecatalog id baseclass id Demuxauthors Mirko Demurtas

Demultiplexer

Inputs




Input

Outputs

Outputid Output000type Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Output

Outputid Output001type Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Output

283

Parameters

Num Outputid NOutputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Num Output

Typeid TypeDemuxtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Input ChangingTime DemultiplexingTick Demultiplexing

domain [ 0, 2 ]Type

Timeid TimeDemuxtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Time

Staticid StatiDemuxtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Static

Tickid TickDemuxtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Tick

284

9.1.66 Distance

bitmap

class name Distancecatalog name Basecatalog id baseclass id MatrixDistanceauthors Barbara Mazzarino

This block outputs a matrix distance.

Outputs

DistanceMatrixid OutputMatrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output Distance Matrix

Parameters

Distanceid ParamDimtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Dimension of the distance matrix

285

9.1.67 DomainConversion

bitmap

class name DomainConversioncatalog name Basecatalog id baseclass id DomainConversionauthors Mirko Demurtas

This block covert the domain of the input

Inputs

Inputid Inputtype Kernel, Int datatype (Kernel Catalog).type id kernel, int



Input

Outputs

Outputid Outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output

286

Parameters


layoutCombo Box:Integer -¿ DoubleDouble -¿ Interger

domain [ 0, 2 )Type

287

9.1.68 DotProduct

bitmap

class name DotProductcatalog name Basecatalog id baseclass id DotProductauthors Gualtiero Volpe

This block computes the dot product of the input vectors.

Inputs

id InXtype Kernel, Double matrix.type id kernel, double-matrix



id InYtype Kernel, Double matrix.type id kernel, double-matrix



Outputs

id Outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

288

9.1.69 DoubleVectorToMatrix

bitmap

class name DoubleVectorToMatrixcatalog name Basecatalog id baseclass id double vector to matrixauthors Paolo Coletta

Concatenates input vectors to build a matrix with a dimension which is fixed by theuser.

Inputs

Vectorid vectortype Kernel, Double matrix.type id kernel, double-matrix



Input vector

Outputs

Matrixid matrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output matrix

Parameters

lengthid lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of vectors needed to build a full matrix

289


layoutCombo Box:HorizontalVertical

domain [ 0, 2 )Specifies whether the vectors are concatenated horizontally or vertically

Directionid directiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LeftToRightRightToLeft

domain [ 0, 2 )Specifies whether the videogram is computed from left to right or viceversa

290

9.1.70 DrawBlob

bitmap

class name DrawBlobcatalog name Basecatalog id baseclass id DrawBlobauthors Simone Ghisio

The block draws the input blob on input background image. If the input image is BGRor RGB the blob can be coloured by parameter Red Green Blue. If the input image isBW the blob appears in gray color. NOTE: since 5.0.1.4 this block can be replaced by thegeneric Draw block.

Inputs

Input Imageid input video streamtype Base, Imagetype id base, image


read only/read write read writereferred as inplace Output Imagereferred as inherited *no*

The input image used as background

Input Blobid Input blobtype Base, Blob 2Dtype id base, blob2d



An image containing the silhouette of the blob.

291

Outputs

Output Imageid Output Imagetype Base, Imagetype id base, imageinplace id Input Imageinherited id *no*

The output image with background an blob in foreground

Parameters

Redid Redtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Level of Red color. If input image si BW it’s used to calcuate the gray tone

Greenid Greentype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Level of Green color. If input image si BW it’s used to calcuate the gray tone

Blueid Bluetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Level of Blue color. If input image si BW it’s used to calcuate the gray tone

292

9.1.71 DrawFilledShape

bitmap

class name DrawFilledShapecatalog name Basecatalog id baseclass id draw filled shapesauthors Paolo Coletta

Draw a filled shape (e.g., a Rectangle) on the input datatype. Works on all datatypessupporting the IDrawFilledShape interface (e.g., IMage, CudaImage)

Inputs




Required interfacesbase, draw filled shapes

Outputs


293

Parameters

Coordinates Typeid coordinates typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )Specifies whether coordinates are expressed with integer values (absolute coordinates)

or in floating-point number normalized in the range [0.0-1.0] with respect to the image size

Operation Typeid operation typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Filled RectangleFrame Rectangle

domain [ 0, 2 )Specifies the type of operation performed: FilledRect: draws a filled rectangle FrameRect:

draws a frame around the given (non-filled) rectangle

Colorid colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Specifies the color of the drawn filled shape

Alphaid alphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the level of opacity of the draw operations: 0.0: the drawing is transparent1.0: the drawing is opaque

Ticknessid ticknesstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

The tickness of the line, in pixels, in the case of drawing operations involving a pen,e.g., FrameRect

294

Rectid recttype Base, Roi 2D doubletype id base, roi2d double

In the case that the selected drawing operation is a Filled Rectangle or a frame rectangle,this paramater specifies the position and size of the rectangle. If set to null, then therectangle covers the whole image.

295

9.1.72 DrawGraphicObject

bitmap

class name DrawGraphicObjectcatalog name Basecatalog id baseclass id DrawGraphicObject

authorsMirko DemurtasGualtiero Volpe

This block draws the input graphic 2D object

Inputs

Input imageid InputImagetype Base, Imagetype id base, image


read only/read write read writereferred as inplace Output imagereferred as inherited *no*

The input image on which the graphic object will be drawn.

Input graphic objectid InputGraphicObject00type Kernel, Generic datatypetype id kernel, generic datatype



The graphic object to be drawn.

Required interfacesBase, Drawing

296

Outputs

Output imageid Outputtype Base, Imagetype id base, imageinplace id Input imageinherited id *no*

The output image on which the graphic object has been drawn.

Parameters

Number Inputid nInputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number Input

Qualityid Qualitytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:High qualityMedium qualityLow quality

domain [ 0, 3 )Quality draw

Draw Unchanged Datatypesid draw unchanged parameterstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, each time the block is activated it draws all inputs, regardless of whetherthey are changed or not (this is the old behaviour). If false (default behaviour), onlychanged datatypes are drawn.

297

9.1.73 DrawText

bitmap

class name DrawTextcatalog name Basecatalog id baseclass id draw textauthors Paolo Coletta

Draw text on the input datatype. Works on all datatypes supporting the IDrawTextinterface (e.g., Image, CudaImage)

Notes There is a similar block in EyesWeb named Title machine. The differences withthat block are: * this block does not support rotated text * this block works on severalimage datatypes * this block is OS independent

Inputs




Required interfacesbase, draw text

Outputs


298

Parameters

Textid texttype Kernel, String datatype (Kernel Catalog).type id kernel, string

The text to be overlaid on the image



domain [ 0, 2 )Specifies whether coordinates are expressed with integer values (absolute coordinates)

or in floating-point number normalized in the range [0.0-1.0] with respect to the image size

299

Font selctorid font selectortype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ahronbdandlsoangsaangsabangsaiangsauangsaubangsauiangsauzangsazaparajaparajbaparajbiaparajiarabtypearialarialbdarialbiarialiariblkbrowabrowabbrowaibrowaubrowaubbrowauibrowauzbrowazcalibricalibribcalibriicalibrizcambriabcambriaicambriazCandaraCandarabCandaraiCandarazcomiccomicbdconsolaconsolabconsolaiconsolazconstanconstanbconstaniconstanzcorbelcorbelbcorbelicorbelzcordiacordiabcordiaicordiaucordiaubcordiauicordiauzcordiazcourcourbdcourbicouridaunpenhdaviddavidbdDejaVuSans-BoldDejaVuSans-BoldObliqueDejaVuSans-ExtraLightDejaVuSans-ObliqueDejaVuSansDejaVuSansCondensed-BoldDejaVuSansCondensed-BoldObliqueDejaVuSansCondensed-ObliqueDejaVuSansCondensedDejaVuSansMono-BoldDejaVuSansMono-BoldObliqueDejaVuSansMono-ObliqueDejaVuSansMonoDejaVuSerif-BoldDejaVuSerif-BoldItalicDejaVuSerif-ItalicDejaVuSerifDejaVuSerifCondensed-BoldDejaVuSerifCondensed-BoldItalicDejaVuSerifCondensed-ItalicDejaVuSerifCondenseddokchampebrimaebrimabdestreeuphemiaframdframditfrankGabriolagautamigautamibGenBasBGenBasBIGenBasIGenBasRGenBkBasBGenBkBasBIGenBkBasIGenBkBasRgeorgiageorgiabgeorgiaigeorgiazgishagishabdhimalayaimpactiskpotaiskpotabkaiukalingakalingabkartikakartikabKhmerUIKhmerUIbkokilakokilabkokilabikokilaiLaoUILaoUIblathalathableelawadleelawdbLiberationSansNarrow-BoldLiberationSansNarrow-BoldItalicLiberationSansNarrow-ItalicLiberationSansNarrow-RegularLinBiolinumG BdLinBiolinumG ItLinBiolinumG ReLinLibertineG BdLinLibertineG BILinLibertineG ItLinLibertineG Reluconlvnmlvnmbdl 10646majallamajallabmalgunmalgunbdmangalmangalbmarlettmicrossmonbaitimoolbormriammriamcmsjhmsjhbdmsuighurmsyhmsyhbdmsyimvbolininaninabnrkisntailuntailubnyalaopenspalapalabpalabipalaiphagspaphagspabplantcraaviraavibrodsegoesegoebsegoeprsegoeprbsegoescsegoescbsegoeuisegoeuibsegoeuiisegoeuilsegoeuizseguisbseguisymShonarShonarbshrutishrutibsimfangsimheisimkaisimpbdosimpfxosimposimsunbsylfaensymboltahomatahomabdtailetailebtimestimesbdtimesbitimesitradbdotradotrebuctrebucbdtrebucbitrebucittungatungabupcdbupcdbiupcdiupcdlupcebupcebiupceiupcelupcfbupcfbiupcfiupcflupcibupcibiupciiupcilupcjbupcjbiupcjiupcjlupckbupckbiupckiupcklupclbupclbiupcliupcllutsaahutsaahbutsaahbiutsaahiVaniVanibverdanaverdanabverdanaiverdanazvijayavijayabvrindavrindabwebdingswingding

domain [ 0, 272 )

300

The list of available fonts

Fontid fonttype Kernel, String datatype (Kernel Catalog).type id kernel, string

The font to be used to draw the text. Currently you need to specify the name of thefont, without extension. The default system folder is used. E.g.: use comic to refer to fontC:\Windows\Fonts\comic.ttf

Font sizeid font sizetype Base, Size 2D doubletype id base, size2d double

The size of the font

Font boldid font boldtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the font is bold

Font italicid font italictype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the font is italic

Font underlinedid font underlinedtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the font is underlined (not implemented yet)


Specifies the color of the drawn filled shape


Specifies the level of opacity of the draw operations: 0.0: the drawing is transparent1.0: the drawing is opaque

301

StrikeOut Ticknessid strikeout ticknesstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The tickness of the border of the text, in pixels. Use zero if no strikeOut is needed. Notethat tickness is always expressed in floating-point coordinates, regardless of the value of the’coordinates type’ parameter. However, the coordinates measurement unit are aboslutepixels; they are not normalized.

StrikeOut Colorid strike colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Specifies the color of the border of the text

StrikeOut Alphaid strikeout alphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the level of opacity of the border of the text: 0.0: the drawing is transparent1.0: the drawing is opaque

Rectid recttype Base, Roi 2D doubletype id base, roi2d double

In the case that the selected drawing operation is a Filled Rectangle or a frame rectangle,this paramater specifies the position and size of the rectangle. If set to null, then therectangle covers the whole image.

302

9.1.74 DynamicToStaticPCMAudioBuffer

bitmap

class name DynamicToStaticPCMAudioBuffercatalog name Basecatalog id baseclass id pcm dynamic to static audio buffer


Converts a dynamic pcm audio buffer to a static pcm audio buffer

Inputs

Inputid inputtype Base, PCMAudioBuffertype id base, pcm audio dynamic buffer



Dynamic PCM Audio buffer

Outputs


Static PCM Audio buffer

Num internal samplesid num internal samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Size of the buffer of samples currently stored in the block

303

Parameters

Buffer size modeid buffer size modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:From audio clock inputUser specified

domain [ 0, 2 )Specifies whether the buffer size is user specified or if is inherited from an audio clock

input. In the case of a user specified buffer size (default), it is up to the user to guaranteethat the activation rate(use the block sync-in pin) is coherent with the given buffer-size andsampling-rate.In the case of an audio clock input, that input can be used as a clock sourceand the number of samples of the buffer is automatically computed by the block.

Cross fadeid do cross fadetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether cross fade is enable or abrupt switch is used


When this bang is received, the internally queued audio data is cleared

Number of samplesid num samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Name of the samples of the output datatype

304

9.1.75 Ellipse2DGenerator

bitmap

class name Ellipse2DGeneratorcatalog name Basecatalog id baseclass id ellipse2d generator int


Generates a bidimensional ellipse that can be drawn too. The ellipse is represented bythe central point an the axis lenght.

Outputs

Ellipseid valuetype Base, Ellipse 2D inttype id base, ellipse 2d intinplace id *no*inherited id *no*

The output ellipse.

Parameters


layout

Combo Box:EllipsePointsCoordinates

domain [ 0, 3 )If parameter is set to ’point’ then it’s a point datatype (a structure that contain inside

both x and y). If the value is ’coordinates’ then the parameter ”point” is splitted into twoseparated coordinates x and y

305

Domainid domaintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 4 )Specified the type of output. It’s possible choose double or int type. Moreover it’s

possible to create a geometric point datatype or a graphic point that can be drawn

Xid xtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Abscissa

Yid ytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Ordinate

X Axisid x axistype Kernel, Int datatype (Kernel Catalog).type id kernel, int

X Axis lenght

Y Axisid y axistype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Y Axis lenght

306

Matrix Trasformid mode trasformtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:MatrixRotateTranslateScale

domain [ 0, 4 )Matrix Trasform

Matrix trasformid trasformtype Kernel, Double matrix.type id kernel, double-matrix

Matrix trasform

307

9.1.76 Ellipse3DGenerator

bitmap

class name Ellipse3DGeneratorcatalog name Basecatalog id baseclass id ellipse 3d generatorauthors Simone Ghisio

Generates a tridimensional ellipse. The object is represented by a center and 3 sizes.

Outputs

OutputEllipse3Did ellipse outputtype Base, BaseGeometricEllipse3Doubletype id base, base geometric ellipse 3d doubleinplace id *no*inherited id *no*

Output Ellipse 3D

Parameters

Modeid mode parametertype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )Mode

XCoordinateid x parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate of the center

YCoordinateid y parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

308

Y coordinate of the center

ZCoordinateid z parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate of the center

XAxisid xsize parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lenght of x axis

YAxisid ysize parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lenght of y axis

ZAxisid zsize parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lenght of z axis

309

9.1.77 EnvelopeFollower

bitmap

class name EnvelopeFollowercatalog name Basecatalog id baseclass id Envelopeauthors Simone Ghisio

Detect the envelope of the input buffer

Inputs

Input Bufferid input buffertype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace *no*referred as inherited Output Buffer

This is the signal buffer that must be elaborated


Outputs

Output Bufferid output buffertype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input Bufferinherited id *no*

This is the signal buffer that has been elaborated

Parameters

Rid Rtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

310

R in ohm

Cid Ctype Kernel, Double datatype (Kernel Catalog).type id kernel, double

C in Farad

311

9.1.78 ExtractBlobFromList

bitmapblob from list.png blob from list.png

class name ExtractBlobFromListcatalog name Basecatalog id baseclass id extract blob from listauthors Paolo Coletta

Extract a blob from the input list according to ’extraction type’ value.It’s possible ex-tract the blob by area value, by height or width value, by its contraction indexor calculatingthe distance between its baricenter and a given point.

Inputs

input listid input listtype Kernel, Listtype id kernel, list



list of blob

Outputs

output blobid output blobtype Base, Blob 2Dtype id base, blob2dinplace id *no*inherited id *no*

blob extracted from the input list

312

Parameters

extraction typeid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AreaHeightWidthContraction indexDistance from point

domain [ 0, 5 )specifies the feature used by the algorithm to extract the blob

min maxid minmaxtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:MaxMin

domain [ 0, 2 )specifies if the algorithm must extract the blob with greather or smaller selected features

313

9.1.79 ExtractBlobs

bitmap

class name ExtractBlobscatalog name Basecatalog id baseclass id extract blobsauthors Mirko Demurtas

Extract connected pixels in the image and it puts toghether in a structure called blob.It’s possible associate togheter pixels not connected that are distant less or equal thenparameter ’distance’.

Inputs




Input Image form which extract blobs

Outputs

List Blobid output blob listtype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*


Number Blobsid OutputCountBlobstype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

314

Number of Blobs extracted. This value is the size of List Blob and if there aren’t blobin the list the size is 0

Image Blobsid OutputImgBlobstype Base, Imagetype id base, imageinplace id *no*inherited id *no*

A gray tone Image containing all the extracted blobs. Blobs are distint by a differentgray level.

Image Thresholdid OutputImgThresholdtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

The image after Threshold operation

Parameters

Distanceid distancetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Max distance between two pixels to be in the same blob

Thresholdid Thresholdtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:DisabledSingle MonoSingle RangeMulti MonoMulti Range

domain [ 0, 5 )Type of threshold. -Disabled: no threshold operation. If the pixel value is different from

0 the the pixel is processed -Single Mono: If the pixel value is more then threshold valueit’s processed. Otherwise the pixel is not computed. -Single Range: If the pixel value isbetween two values of threshold then it’s processed. It’s possible choose if the right value iscontained in the range or if it must be extrenal. -Multi Mono: It’s the same thing of SingleMono, but it’s possible specify the threshold for each channel colour. -Multi Range: The

315

same thing of Singke Range but with the specification of the range for each channel colour.If Multi mode is selected then it’s possible choose wich channel thresholding: for exxampleit’s possible thresholding only R and G channlesor only B and R.

316

9.1.80 ExtractBlobsIPP

bitmap

class name ExtractBlobsIPPcatalog name Basecatalog id baseclass id extract blobs ippauthors Simone Ghisio

Extract connected pixels in the image and it puts toghether in a structure called blob.It’s possible associate togheter pixels not connected that are distant less or equal thenparameter ’distance’.

Inputs

Imageid input video streamingtype Base, Imagetype id base, image



Input Image form which extract blobs

Outputs

List Blobid output blob listtype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*


Number Blobsid output num blobtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

317

Number of Blobs extracted. This value is the size of List Blob and if there aren’t blobin the list the size is 0

Parameters

MinLabelid param min labeltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Minimal value of the marker label

MaxLabelid param max labeltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( -infinity, 254 ]

Maximal value of the marker label

Connectivityid param connectivitytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Infinity normL1 norm

domain [ 0, 2 )Specifies type of the norm to form the mask for marker propagation: Infinity norm

(8-connectivity) L1 norm (4-connectivity)

318

9.1.81 ExtractChannel

bitmap

class name ExtractChannelcatalog name Basecatalog id baseclass id extract channelauthors Mirko Demurtas

Extract one or any channels from an audio stream

Error and Warning Messages - DURING EXECUTION PHASE - Unsupported timeseries datatype: if the input buffer is not an audio buffer or a temporal datatype.

Inputs

Input streamid input audio streamtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace *no*referred as inherited Output channel

Input stream


Outputs

Output channelid output audio stream 00type Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input streaminherited id *no*

Output channel

319

Parameters

Num outputid channelstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Multi output channel extract

Channel selected for outputid channel selecttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Channel selected for output

320

9.1.82 ExtractChannel

bitmap

class name ExtractChannelcatalog name Basecatalog id baseclass id image extract channel


Extract a single channel from a multichannel image

Inputs

Input imageid input video streamtype Base, Imagetype id base, image



Input multichannel image

Outputs

Output imageid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output singlechannel image

Parameters

Channel indexid indextype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 3 ]

Zero-based index of the channel to be extracted

321

9.1.83 ExtractColorBlobs

bitmap

class name ExtractColorBlobscatalog name Basecatalog id baseclass id extract color blobsauthors Paolo Coletta

Extract a labeled set of blobs, basing on their color. The user specifies the labels ofthe extracted blob and, for each label, the color. The color matching is not required to beprecise.

Inputs

InputImageid inputtype Base, Imagetype id base, image



The input image where colored blobs will be searched. For performance reasons it issuggested, although not required, to provide an image in HSV format.

Outputs

OutputBlobid outputtype Kernel, Labelled settype id kernel, labeled setinplace id *no*inherited id *no*

The output blob. Note that if the image does not contain any pixel brighter than thethreshold, the blob would be empty, thus, no output is given

322

Parameters

Number of blobsid num blobstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of colored blobs to be searched

Color 1id rgb color 1type Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Color to be searched

Label 1id label 1type Kernel, String datatype (Kernel Catalog).type id kernel, string

Label of the blob

Hue Threshold 1id hue threshold 1type Kernel, Double datatype (Kernel Catalog).type id kernel, double

The threshold on the Hue value, normalized in the range from [0.0 to 1.0]. Values withthe given hue (color) plus or minus the hue threshold are assumed to have the same hue.

Saturation Threshold 1id saturation threshold 1type Kernel, Double datatype (Kernel Catalog).type id kernel, double

The threshold on the Saturation value, normalized in the range from [0.0 to 1.0]. Valueswith the given hue (color) plus or minus the saturation threshold are assumed to have thesame saturation.

323

9.1.84 ExtractFromGeometricLabelledSet3D-Double

bitmap

class name ExtractFromGeometricLabelledSet3D-Doublecatalog name Basecatalog id baseclass id ExractGeometricLabelledSet3D-Doubleauthors Simone Ghisio

The block extract a single object from a GeometricLabelledSet of 3D objects. It’spossible to extract by label or by position.

Inputs

Input GeometricLabelledSet3Did input labeled settype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d double




Outputs

OutputObjectid output valuetype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Output object extracted.

324

Parameters

Datatypeid ClassPArtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:base geometric ellipse 3d doublebase geometric labelled set 3d doublebase geometric line 3d doublebase geometric point 3d doublebase geometric rectangle 3d doublebase geometric size 3d doublebase geometric triangle 3d double

domain [ 0, 7 )Datatype contained in the input geometric labelled set.

Catalogid Catalogtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Read only parameter. It’s the selected catalog id from ’Datatype’ parameter.

Classid Classtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Read only parameter. It’s the selected class id from ’Datatype’ parameter.

ExtractionTypeid Extractiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LabelPosition

domain [ 0, 2 )If Label mode is selected, the extraction in performed searching the label in the geomteric

labelled set. Otherwise the extraction is performed by position. Before the extraction theblock verifies if datatype of object is compatible with DATATYPE parameter.

Labelid Labeltype Kernel, String datatype (Kernel Catalog).type id kernel, string

Label searched in the input list.

325

9.1.85 ExtractFromGeometricLabelledSet3D-Int

bitmap

class name ExtractFromGeometricLabelledSet3D-Intcatalog name Basecatalog id baseclass id ExractGeometricLabelledSet3D-Intauthors Simone Ghisio

The block extract a single object from a GeometricLabelledSet of 3D objects. It’spossible to extract by label or by position.

Inputs

Input GeometricLabelledSet3Did input labeled settype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d int




Outputs

OutputObjectid output valuetype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Output object extracted.

326

Parameters


layout

Combo Box:base geometric ellipse 3d intbase geometric labelled set 3d intbase geometric line 3d intbase geometric point 3d intbase geometric rectangle 3d intbase geometric size 3d intbase geometric triangle 3d int






ExtractionTypeid Extractiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LabelPosition

domain [ 0, 2 )If Label mode is selected, the extraction in performed searching the label in the geomteric

labelled set. Otherwise the extraction is performed by position. Before the extraction theblock verifies if datatype of object is compatible with DATATYPE parameter.

Labelid Labeltype Kernel, String datatype (Kernel Catalog).type id kernel, string

Label searched in the input list.

327

9.1.86 ExtractImageField

bitmap

class name ExtractImageFieldcatalog name Basecatalog id baseclass id ImageExtractEvenOddauthors Mirko Demurtas

Extract a field (even or odd depending on an user choice) from an interlaced frame

Inputs




Input Image

Outputs

Output Imageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output Image

328

Parameters

Even - Oddid param extracttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:EvenOdd

domain [ 0, 2 )Extract Even or Odd Lines

329

9.1.87 ExtractMidiTimecode

bitmap

class name ExtractMidiTimecodecatalog name Basecatalog id baseclass id extract midi timeocdeauthors Paolo Coletta

Extract the timecode from a MIDI stream of data

Inputs

Midi Streamid miditype Base, MIDItype id base, midi



The midi stream from which to extract and decode the MTC (Midi Timecode) messages

Outputs

Timecodeid timeocdetype Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

The timecode extracted (and decoded) from the midi stream

330

9.1.88 ExtractSingleBlob

bitmap

class name ExtractSingleBlobcatalog name Basecatalog id baseclass id extract single blobauthors Paolo Coletta

Extract a single blob from the input image, by assuming that every pixel over thethreshold belongs to the same unique blob. This block is designed to be used when it isreasonable to assume that the input image only contains a single blob and does not containnoise. In practice it can be used when tracking a single target in a controlled environment.For more complex environment refer to block @block(base,extract blobs).

Inputs

InputImageid inputtype Base, Imagetype id base, image



The input image which will be converted to a single blob. It must be a BW image

Outputs

OutputBlobid outputtype Base, Blob 2Dtype id base, blob2dinplace id *no*inherited id *no*

The output blob. Note that if the image does not contain any pixel brighter than thethreshold, the blob would be empty, thus, no output is given

331

Parameters

Thresholdid thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The threshold to decide which pixels will belong to the output blob. All pixels brighterthan the given threshold will belong to the blob

332

9.1.89 ExtractSubBlob

bitmap

class name ExtractSubBlobcatalog name Basecatalog id baseclass id extractsubblobauthors Maurizio Mancini

This block extracts a sub-blob from the given blob, depending on the given ROI.

Inputs

Input blobid extractsubblob blobinputtype Base, Blob 2Dtype id base, blob2d



Input blob, the output blob is extracted from this blob.

Input ROIid extractsubblob roiinputtype Base, Roi 2D inttype id base, roi2d int



Input ROI, it is used to determine the area of the input blob to be copied into theoutputblob.

333

Outputs

Output blobid extractsubblob bloboutputtype Base, Blob 2Dtype id base, blob2dinplace id *no*inherited id *no*

Output blob, it is extracted from the input blob depending on the input ROI. If theinput ROI is outside the input blob ROI then no blob is extracted.

Blob presentid extractsubblob blobpresentoutputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

If the input ROI is inside the input blob ROI then this flag is set to 1, otherwise it isset to 0.

Parameters

ROI typeid ROItypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:IntDouble

domain [ 0, 2 )The input ROI can be specified by integer or double coordinates.

ROI relative toid ROIrelativetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ImageBlob

domain [ 0, 2 )The input ROI coordinates can be relative to the image coordinate system or to the

blob coordinate system.

334

9.1.90 ExtractSubstring

bitmap

class name ExtractSubstringcatalog name Basecatalog id baseclass id extract substringauthors Paolo Coletta

Extract a substring from the input string.

Inputs

Input stringid input stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string


read only/read write read writereferred as inplace Output substringreferred as inherited *no*

Input string from which a substring will be extracted.

Outputs

Output substringid output stringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id Input stringinherited id *no*

The output substring extracted from the input string.

Parameters

First characterid first charactertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The zero-based index of the first character to extract.

335

Last characterid last charactertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Last character

336

9.1.91 ExtractTimeFromDate

bitmap

class name ExtractTimeFromDatecatalog name Basecatalog id baseclass id extract time from dateauthors Paolo Coletta

Extract the time field from a date tatatype.

Inputs

Dateid timetype Kernel, Datetimetype id kernel, datetime



Date

Outputs

Timeid stringtype Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

Time

337

9.1.92 FFTCues

bitmap

class name FFTCuescatalog name Basecatalog id baseclass id fft cuesauthors Carlo Drioli

FFTCues

Inputs

Input Fft bufferid input fftbuffertype Base, Audio FFT buffertype id base, audio fftbuffer



Input Fft buffer

Outputs

Output scalarid output scalartype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output scalar


Output matrix

338

Magnitudeid output scalar magnitudetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

In the case of Max, provide the magnitude of the fft in the maximum

Phaseid output scalar phasetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

In the case of Max, provides the phase of the fft in the maximum

Parameters

cue typeid FftCues cuetype scalartype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NoneEnergyCentroidSpectral Irregularity (SPI)Spectral Flux (SPF)Spectral RolloffHigh Frequency Energy (HFE)High Frequency Content (HFC)Strongest Frequency

domain [ 0, 8 ]cue type

cue type (matrix)id FftCues cuetype matrixtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NoneMel Filter BankMfccMfcc Env.Power Spec.

domain [ 0, 4 ]

339

cue tyoe (matrix)

Filterbank sizeid Filterbank Sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Filterbank size

N. of coeffsid n. of Coeffstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

N. of coeffs

dB flagid dB Flagtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

dB flag

mel flagid Mel Flagtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

mel flag

absolute threshold (ref. to linear energy)id abs thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

absolute threshold (ref. to linear energy)

perc. thresholdid perc. thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

perc. threshold

340

9.1.93 FFTDisplay

bitmap

class name FFTDisplaycatalog name Basecatalog id baseclass id FFTDisplay

authorsAlberto MassariAlessandro FaustoMirko Demurtas

This block visualizes graphically the FFT spectrum using the Windows GDI library.When the datatype frequently changes, drawing the FFT waveform generates a very highrefesh rate. In this case some personal computers seem not responsive because the miss theprocessing power required to both refresh the display and iteract with the user. To avoidthis situation, set the ’Refresh mode’ parameter to ’Frequency limited’ or to ’time limited’.– REMARKS –

– ERRORS – ’Found outdated version of GDI display block, ignored parameter list:¡LIST¿’ The parameters loaded from the patch and listed into the ¡LIST¿ are ignoredbecause relative to one old version of DisplayGDI block.

Inputs

fft dataid fft datatype Base, Audio FFT buffertype id base, audio fftbuffer



The FFT buffer to display


341

9.1.94 FFTransform

bitmap

class name FFTransformcatalog name Basecatalog id baseclass id fast fourier transformauthors Carlo Drioli

FFT Transform

Inputs

Input bufferid input datatype Kernel, Generic datatypetype id kernel, generic datatype



Input buffer


Outputs

Output Fft bufferid output fftbuffertype Base, Audio FFT buffertype id base, audio fftbufferinplace id *no*inherited id *no*

Output Fft buffer

342

Parameters

fft sizeid FftTransform fftsizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Least possible FFT256512102420484096819216384

domain [ 0, 7 ]fft size

window typeid FftTransform windowtypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NoneBlackmanStdBartlettHammingHannKaiser

domain [ 0, 5 ]window type

343

9.1.95 FIRFilter

bitmap

class name FIRFiltercatalog name Basecatalog id baseclass id FIRFilterauthors Roberto Sagoleo

This block operates as a low-pass, high-pass or band-pass filter.

Inputs

Inputid FIRInputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input signal

Outputs

Outputid FIROutputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output signal

Parameters

Cut off frequency 1id FIRCutOff1Frequencytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the first Cut off frequency

344

Cut off frequency 2id FIRCutOff2Frequencytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the second Cut off frequency

Numbers of tapsid FIRNumbersOfTapstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 5, +infinity )

This is the Number of taps

Smoothing window typeid FIRWindowTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Barlett windowBlackman windowHamming windowHann windowRect window

domain [ 0, 4 ]This is the Type of windows

Filter typeid FIRFilterTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Low-PassHigh-PassBand-Pass

domain [ 0, 2 ]Type of the FIR-filter (low-pass, high-pass or band-pass filtering)

Normalized taps valuesid FIRNormalizedTapsValuestype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

This is the Normalized taps flag

345

Resetid FIRResettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Resets the FIR filter to its initial state, using the reset parameter data value.

Reset valueid ResetValuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Output reset value that is used when the reset-button is pressed.

Number of reset cyclesid ResetCyclestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Number of calls to the FIR-filtering algorithm function, used during the reset phasewhich is activated by pressing the reset parameter button.

346

9.1.96 FaceDetection

bitmap

class name FaceDetectioncatalog name Basecatalog id baseclass id FaceDetectionauthors Simone Ghisio

OpenCV face detection method based on Haar cascade classifiers.

Inputs

InputImageid InputImagetype Base, Imagetype id base, image



Image to detect objects in.

Outputs

OutputImageid OutputImagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output binary image with white regions representing the faces or any other object forwhich the classifiers were trained

347

Parameters

HaarCascadeXMLFileNameid HaarCascadeXMLFileNametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”All files (*.*)—*.*——”

Haar classifier cascade training xml file. Those files are usually located in C:\ProgramFiles\OpenCV\data\haarcascades

ScaleFactorid ScaleFactortype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The factor by which the search window is scaled between the subsequent scans, forexample, 1.1 means increasing window by 10%.

MinNeighboorsid MinNeighboorstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Minimum number (minus 1) of neighbor rectangles that makes up an object. All thegroups of a smaller number of rectangles than min neighbors-1 are rejected. If min neighborsis 0, the function does not any grouping at all and returns all the detected candidate rect-angles, which may be useful if the user wants to apply a customized grouping procedure.

Flagsid Flagstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Mode of operation. Currently the only flag that may be specified is CV HAAR DO CANNY PRUNING.If it is set, the function uses Canny edge detector to reject some image regions that containtoo few or too much edges and thus can not contain the searched object. The particularthreshold values are tuned for face detection and in this case the pruning speeds up theprocessing.

348

9.1.97 FeatureHistogrambyCells

bitmap

class name FeatureHistogrambyCellscatalog name Basecatalog id baseclass id FeatureHistogrambyCellsauthors Maurizio Mancini

compute feature’s histogram in each local cell

Inputs

video inputid video inputtype Base, Imagetype id base, image



video stream to be processed

Outputs

histogramid histogramtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

feature histogram output

column numberid column numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

number of vertical subdivisions

349

row numberid row numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

number of horizontal subdivisions

frame numberid frame numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

number of fframes

Parameters

column numberid column numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

number of vertical subdivisions

row numberid row numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

number of horizontal subdivisions

frame numberid frame numbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

number of frames

featureid featuretype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:speeddirectionsample index 3

domain [ 0, 3 )select feature to compute

350

9.1.98 FileOperation

bitmap

class name FileOperationcatalog name Basecatalog id baseclass id file operationauthors Simone Ghisio

Execute some oprations on files and directories. The operation is executed only whentrigger parameter is pressed. For CreateDirecotry, CurrentPath, Exists, FileSize, IsDirec-tory, IsEmpty, Remove and RemoveAll the operation uses only SourcePath and ignoredDestinationPath. For other operations the block uses DestinationPath too.

Parameters

OperationTypeid operation typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CopyFileCreateDirecotryCurrentPathExistsFileSizeIsDirectoryIsEmptyMoveRemoveRemoveAllRename

domain [ 0, 11 )Operation type. CopyFile: copy a file from source to destination path. CreateDirectory:

create a directory using source path name. Exists: verify if source path file or directoryexists. FileSize: return the size of source path file . IsDirectory: verify if source pathis a directory. IsEmpty: verify if source path directory is empty. MoveFile: move a filefrom source to destination path. Remove: remove source path file whithout asking confirm.RemoveAll: remove the whole content of source path (directory or file) whithout askingconfirm. Rename: reame source path to destination path.

351

ExecuteOperationid triggertype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Execute operation

SourcePathid source pathtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Source path

DestinationPathid destination pathtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Destination path. Ignored in some operations.

352

9.1.99 FilterBank

bitmap

class name FilterBankcatalog name Basecatalog id baseclass id filter bankauthors Carlo Drioli

Filter bank

Inputs




Input buffer

Outputs


Output buffer

353

Parameters

Filter typeid filtertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CustomGammatone - bands: 64Gammatone - bands: 32

domain [ 0, 3 )Let’s you select the filter type. The custome choise let’s you specify the coefficents of

the filter in the custom filter parameter.

Custom filterid custom filtertype Kernel, Double matrix.type id kernel, double-matrix

Let you specify the coefficents of the filter. The proposed coefficents are from the firstbuilt-in filter.

Channel indexid channel indextype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

The filter works on a single channel of the audio buffer, even if the input buffer ismultichannel. This parameter let the user choose which channel to use.

354

9.1.100 FilterGeometricLabelledSet3D-Double

bitmap

class name FilterGeometricLabelledSet3D-Doublecatalog name Basecatalog id baseclass id FilterGeometricLabelledSet3D-Doubleauthors Simone Ghisio

The block allows to select a subset from the input geometric labelled set 3d.

Inputs

InputGeometricLabelledSet3Did input labeled settype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d double



Input geometric labelled set 3D. This is a non homogeneous list of 3d geomteric object.

Outputs

OutputGeometricLabelledSet3Did output labeled settype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d doubleinplace id *no*inherited id *no*

Output geometric labelled set of homogeneous 3d geometric object.

355

Parameters


layout

Combo Box:base geometric ellipse 3d doublebase geometric labelled set 3d doublebase geometric line 3d doublebase geometric point 3d doublebase geometric rectangle 3d doublebase geometric size 3d doublebase geometric triangle 3d double


Extraction typeid Extractiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ListBy Label

domain [ 0, 2 )It’s possible to extract a subset of input, filtering by datatype or filtering by label.





356

9.1.101 FilterGeometricLabelledSet3D-Int

bitmap

class name FilterGeometricLabelledSet3D-Intcatalog name Basecatalog id baseclass id FilterGeometricLabelledSet3D-Intauthors Simone Ghisio

The block allows to select a subset from the input geometric labelled set 3d.

Inputs

InputGeometricLabelledSet3Did input labeled settype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d int



Input geometric labelled set 3D. This is a non homogeneous list of 3d geomteric object.

Outputs

OutputGeometricLabelledSet3Did output labeled settype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d intinplace id *no*inherited id *no*

Output geometric labelled set of homogeneous 3d geometric object.

357

Parameters


layout

Combo Box:base geometric ellipse 3d intbase geometric labelled set 3d intbase geometric line 3d intbase geometric point 3d intbase geometric rectangle 3d intbase geometric size 3d intbase geometric triangle 3d int




domain [ 0, 2 )It’s possible to extract a subset of input, filtering by datatype or filtering by label.





358

9.1.102 FilterGeometricLabelledSetDouble

bitmap

class name FilterGeometricLabelledSetDoublecatalog name Basecatalog id baseclass id FilterGeometricLabelledSet-Doubleauthors Simone Ghisio

The block allows to select a subset or a single item from the input labelled set.

Inputs

Input GeometricLabelledSetid input labeled settype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d double



Input Geometric Labelled Set. This is a non homogeneous list of geomteric object.

Outputs

Output GeometricLabelledSetid output labeled settype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d doubleinplace id *no*inherited id *no*


359

Parameters


layout

Combo Box:graphic ecllipse 2d doublegraphic line 2d doublegraphic point 2d doublegraphic polygon 2d doublegraphic polyline 2d doublegraphic rectangle 2d doubleellipse 2d doublegeometric labeled set 2d doubleline 2d doublepoint 2d doublepolygon 2d doublepolyline 2d doublerectangle 2d doublevector 2d double

domain [ 0, 14 )Datatype contained in the input list.



domain [ 0, 2 )If ’List’ value is selected then the output is an homogeneous list of geometricobject. If

’By Label’ is selected then the block extracts the element of the input list by its label.





360

9.1.103 FilterGeometricLabelledSetInt

bitmap

class name FilterGeometricLabelledSetIntcatalog name Basecatalog id baseclass id FilterGeometricLabelledSet-Intauthors Simone Ghisio


Inputs

Input GeometricLabelledSetid input labeled settype Base, Geometric Labelled Set 2D inttype id base, geometric labeled set 2d int



Input Geometric Labelled Set. This is a non homogeneous list of geomteric object.

Outputs

Output GeometricLabelledSetid output labeled settype Base, Geometric Labelled Set 2D inttype id base, geometric labeled set 2d intinplace id *no*inherited id *no*


361

Parameters


layout

Combo Box:graphic ecllipse 2d intgraphic line 2d intgraphic point 2d intgraphic polygon 2d intgraphic polyline 2d intgraphic rectangle 2d intellipse 2d intgeometric labeled set 2d intline 2d intpoint 2d intpolygon 2d intpolyline 2d intrectangle 2d intvector 2d int

domain [ 0, 14 )Datatype contained in the input list.



domain [ 0, 2 )If ’List’ value is selected then the output is an homogeneous list of geometricobject. If

’By Label’ is selected then the block extracts the element of the input list by its label.





362

9.1.104 FitEllipse

bitmap

class name FitEllipsecatalog name Basecatalog id baseclass id FitEllipseauthors Paolo Coletta

Computes the ellipse fitting the input points.

Inputs

PointMatrixid FitEllipse PointMatrixtype Kernel, Double matrix.type id kernel, double-matrix



Double matrix consisting of points of which the ellipse has to be computed (2xn, wheren¿=6).

Outputs

EllipseOutputid FitEllipse EllipseOutputtype Base, Ellipse 2D doubletype id base, ellipse 2d doubleinplace id *no*inherited id *no*

Bounding ellipse

EllipseAreaid FitEllipse EllipseAreatype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Area of the ellipse.

363

9.1.105 FlipFlopD

bitmap

class name FlipFlopDcatalog name Basecatalog id baseclass id FlipFlipDauthors Alessandro Fausto

This block implement the behaviour of D-type flip flop with some enhancement.The useracting on the ’mode’ parameter can select if the input value is copied into output when theclock rise (0 -¿ 1), fall (1 -¿ 0) or each time a dataype arrives on the clock input.The blockalso have an input to set the startup value and a ’reset’ input to reset the output to thestartup value. – REMARKS – The ’value’ input and ’statup value’ input must receive thesame type of datatype. The ’reset’ input act like a trigger, when a new datatype arrivesthe output is set to the ’startup value’.

Inputs

Input valueid input Valuetype Kernel, Generic datatypetype id kernel, generic datatype



This is the flip flop input. When the clock input change match the current ’mode’parameter this value is copied into th output. The datatype must be the same of flip flopstartup value.

Input startup valueid input startup valuetype Kernel, Generic datatypetype id kernel, generic datatype



This value is used as startup value. When the patch start or when a new datatype arrive

364

on the ’reset’ input this value is copied on the output. The datatype must be the same offlip flop input.

clockid input clocktype Kernel, Generic datatypetype id kernel, generic datatype



This is the input clock and control when the ’value’ input is copied into the output. Seethe description of ’mode’ parameter for more information on ’clock’ input handling.

resetid input resettype Kernel, Generic datatypetype id kernel, generic datatyperequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

This reset ’input’ act as a trigger and reset the output to the startup value. This inputis not required to execution the block.

Outputs

Outputid output valuetype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input valueinherited id *no*

This is the output value. This value is updated only on ’clock’ input event, ’reset’ inputevents or patch start event. The reset is asyncronous (do not wait the clock event).

365

Parameters

Modeid param modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:up frontdown fronttrigger

domain [ 0, 3 )Defines how the clock is used: ’up front’ places the image one by the other one. The

image size increases, whereas height is unchanged. ’down front’ places the image one bythe other one. The image size increases, whereas height is unchanged. ’trigger’ the inputis stored when each clock datatype arrives (the value of the clock is not analized).

Patch startid param patch starttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Reset the output value (the startup value is copied on the output pin) when the patchstart. The reset is asyncronous (do not wait the clock event).

Has resetid param resettype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Show or hide the ’reset’ input trigger. See the ’reset’ input pin description for moreinformations.

366

9.1.106 ForeBackGround

bitmap

class name ForeBackGroundcatalog name Basecatalog id baseclass id ForeBackGroundauthors Mirko Demurtas

This block

Inputs

Inputid Inputtype Base, Imagetype id base, image



Input Image

Outputs

Foregroundid foregroundtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Foreground Image

Backgroundid backgroundtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Background Image

367

FrameDifferenceid framedifferenceBWtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

FrameDifference Image

Silhouetteid silhouettetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Silhouette Image

Newid newtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

New Image

Oldid oldtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Old Image

Testid testtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Test Image

Removeid removetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

368

Remove Image

Parameters

Value 0id value0type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Threshold channel 0


Threshold channel 1


Threshold channel 2

369

9.1.107 Foreground Detection

bitmap

class name Foreground Detectioncatalog name Basecatalog id baseclass id Foreground Detectionauthors Simone Ghisio

The block calculates foreground mask.

Inputs




The input image

Outputs

Foreground Imageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Foreground image

Background Imageid bg imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

BackGround image

370

Parameters

Modelid methodtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:HistogramGaussian

domain [ 0, 2 )Specifies the model used to extract foreground image. Both foreground/background

segmentation algorithm processes the sequence of images and trains statistical models forforeground and background pixels for this sequence. The algorithm applies the modelto each image, classifies its pixels as belonging to the foreground or background of thescene, and then updates the model with the image data. - Histogram- This method appliesthe histogram statistical model to the input image, and sets pixels of foreground imagecorresponding to the background pixels of the input image to zero, and foreground pixels -to non-zero value.- Gaussian - The algorithm applies the Gaussian mixture statistical modelto the input image, and sets pixels of output image corresponding to the background pixelsof the input image to zero, and foreground pixels - to non-zero value.

ValueQuantizationid value quanttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Number of quantization levels for pixel values

ChangeQuantizationid change quanttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Number of quantization levels for the speed of pixel value change

ValueUseid value usetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of most frequent pixel value levels used for classification

371

Value Allid value alltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of all pixel value levels monitored by the model

ChangeUseid change usetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of most frequent speed levels used for classification

ChangeAllid change alltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of all speed levels monitored by the model

UpdBGPropIdid UpdBGProptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Speed of updating of the background probability

UpdBGRefIdid UpdBGReftype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Speed of updating of the reference background image

NumberFrameid Frametype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Number of background frames for adjustment of shadows searching. Only for 3-channelsimages.

DetectionRateid Detectiontype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Speed of shadows searching. Only for 3-channels images

372

BrightnessDistortionid distortiontype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lower bound of the normalized brightness distortion for shadows. Only for 3-channelsimages

ShadowBGid shadowtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Flag of shadows searching. If shadowBG is 1, then pixels belonging to colored shadowsare marked as background, otherwise they may be included in foreground areas. Only for3-channels images

373

9.1.108 FormatDateAsString

bitmap

class name FormatDateAsStringcatalog name Basecatalog id baseclass id format date as string

authorsPaolo ColettaMassimiliano Peri

Formats a datetime to a string.

Inputs

Inputid timetype Kernel, Datetimetype id kernel, datetime



Input date

Outputs

Outputid stringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

Output String

374

Parameters

Format typeid formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CustomISOExtended ISO

domain [ 0, 3 )Format type

Format Modeid format modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Boost syntaxEyesWeb syntax

domain [ 0, 2 )Specify whether the custom format string uses the boost-based syntax or the EyesWeb

one

Format Stringid custom stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string

For the boost syntax see: http://www.boost.org/doc/html/date time/date time io.html#date time.format flagsFor the EyesWeb syntax, see FormatTimeAsString for the time part. The date part is for-matted as it follows. + &[opts]Y Year + &[opts]m month (in digits) + &[opts]d day (indigits) + &M Month (English name) + &D Day (English name)

375

9.1.109 FormatDoubleAsString

bitmap

class name FormatDoubleAsStringcatalog name Basecatalog id baseclass id format double as stringauthors Paolo Coletta

Formats a double (floating-point number) as a string.

Inputs

Input valueid inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input value

Outputs

Stringid outputtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

String

Parameters

Formatid string formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ExponentialDotted

domain [ 0, 2 )

376

The output string will be formatted with the selected format

Precisionid precisiontype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Precision

377

9.1.110 FormatGenericAsString

bitmap

class name FormatGenericAsStringcatalog name Basecatalog id baseclass id format generic as stringauthors Paolo Coletta

Formats a generic datatype as a string (using the SerializeAsText method of the datatype).

Inputs

Generic datatypeid inputtype Kernel, Generic datatypetype id kernel, generic datatype



The input can be any datatype. The only requirement is that the datatype implementsthe method SerializeAsText, which should be the case for any valid datatype.

Outputs

Stringid outputtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

The output string which contains a textual representation of the datatype.

Parameters

Add init infoid init infotype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the serialized initialization info is added to each output string.

378

9.1.111 FormatTimeAsString

bitmap

class name FormatTimeAsStringcatalog name Basecatalog id baseclass id format time as stringauthors Paolo Coletta

Formats a time as a string.

Inputs

Stringid timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time



String

Outputs

Timeid stringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

Time

379

Parameters

Formatid string formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:hh:mm:ss.mshh:mm:sshh:mmms100 nshh:mm:ss/pal frameshh:mm:ss/pal frames::subframes@100Hzhh:mm:ss/ntsc frameshh:mm:ss/ntsc frames::subframes@120HzCustom (user specified format string)

domain [ 0, 10 )The output string will be formatted with the selected format

Custom format stringid custom format stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string

The parameter specifies the time string representation, according to the given formatstring. If no format string is given, than the string representation of the TIME value isreturned. The valid specifiers for the format string are the following: + %[opts] D totalnumber of days + %[opts] H total number of hours + %[opts] M total number of minutes +%[opts] S total number of seconds + %[opts] t total number of tenth of seconds + %[opts] htotal number of hundreds of seconds + %[opts] m total number of milliseconds + %[opts] ctotal number of microseconds + %[opts] n total number of nanoseconds + %[opts] d totalnumber of 100nanoseconds (DirectShow unit) + %[opts] p total number of PAL frames +%[opts] f total number of NTSC frames + %[opts][*sr] s total number of frames sampled @[sr] Hertz. Default value for [sr] is 100 + %[opts]H remaining number of hours + %[opts]Mremaining number of minutes + %[opts]S remaining number of seconds + %[opts]t remain-ing number of tenth of seconds + %[opts]h remaining number of hundreds of seconds +%[opts]m remaining number of milliseconds + %[opts]c remaining number of microseconds+ %[opts]n remaining number of nanoseconds + %[opts]d remaining number of 100nanosec-onds (DirectShow unit) + %[opts]p remaining number of PAL frames + %[opts]f remainingnumber of NTSC frames where valid options [opts] are: a number specifying the minimumsize (in characters) of the formatted string. If the given size is not reached, the stringwill be zero-padded. and [sr] is the sampling rate when a standard one (PAL or NTSC)is not used. All characters in the format string which will not be recognized as options orformat specifiers will be copied to the output string without changes. Examples: value:36000560000; format string: % H:%M:%S:%h; result: 1:0:0:56

380

9.1.112 FrameDifference

bitmap

class name FrameDifferencecatalog name Basecatalog id baseclass id FrameDifferenceauthors Mirko Demurtas

This block

Inputs




Input Image

Outputs

Outputid Outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output Image

Parameters

Number of Frameid NumFrametype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of Frame

381

9.1.113 Gaussian

bitmap

class name Gaussiancatalog name Basecatalog id baseclass id Gaussianauthors Gualtiero Volpe

This block computes the gaussian of the input value according to the specified param-eters.

Inputs

id Inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Outputs


Parameters

id Mutype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id Sigmatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

382

id UseCustomAmplitudetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

id CustomAmplitudetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

383

9.1.114 GeometricFeatures3D-Double

bitmap

class name GeometricFeatures3D-Doublecatalog name Basecatalog id baseclass id GeometricFeatures3D-Doubleauthors Simone Ghisio

The block ealuates some geometric features of 3d objects. Each object is representedby a point and the block uses it to do the processing.

Inputs

InputGeometricLabelledSet3Did input labeled settype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d double




Outputs

Baricenter3Did output pointtype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Tha geometric baricenter of points that represent 3d objects.

384

Parameters

OutputTypeid output typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:BaricenterBounding rectangleVolumeVelocity

domain [ 0, 4 )Output type.

385

9.1.115 GeometricFeatures3D-Int

bitmap

class name GeometricFeatures3D-Intcatalog name Basecatalog id baseclass id GeometricFeatures3D-Intauthors Simone Ghisio

The block ealuates some geometric features of 3d objects. Each object is representedby a point and the block uses it to do the processing.

Inputs

InputGeometricLabelledSet3Did input labeled settype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d int




Outputs

Baricenter3Did output pointtype Base, BaseGeometricPoint3DInttype id base, base geometric point 3d intinplace id *no*inherited id *no*

Tha geometric baricenter of points that represent 3d objects.

386

Parameters

OutputTypeid output typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:BaricenterBounding rectangleVolumeVelocity

domain [ 0, 4 )Output type.

387

9.1.116 GetEllipse2DFeatures - double

bitmap

class name GetEllipse2DFeatures - doublecatalog name Basecatalog id baseclass id get ellipse2d features double

authorsMirko DemurtasRoberto SagoleoGualtiero Volpe

This blocks returns a selected feature of the input ellipse (e.g., coordinates of the center,length of the axes, eccentricity)

Inputs

Input ellipseid inputtype Base, Ellipse 2D doubletype id base, ellipse 2d double



The input ellipse.

Outputs

Extracted featureid outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The current value of the extracted feature.

388

Parameters

Feature to extractid feature to extracttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:X coordinate of the centerY coordinate of the centerLength of the x axisLength of the y axisEccentricityAreaRotation

domain [ 0, 7 )The feature to be extracted from the input ellipse.It’s possible extract the cooridnates

of the centre of the elipse, the leght of x and y axis or the eccentricity (x and y axis lenghtratio. The value is normalized between 0 and 1)

389

9.1.117 GetEllipse2DFeatures - int

bitmap

class name GetEllipse2DFeatures - intcatalog name Basecatalog id baseclass id get ellispe2d features int

authorsMirko DemurtasRoberto SagoleoGualtiero Volpe

This blocks returns the selected feature of the input ellipse (e.g., coordinates of thecenter, length of the axes, eccentricity)

Inputs

Input ellipseid inputtype Base, Ellipse 2D inttype id base, ellipse 2d int



The input ellipse.

Outputs

Extracted featureid outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

The current value of the extracted feature.

390

Parameters

Feature to extractid feature to extracttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:X coordinate of the centerY coordinate of the centerLength of the x axisLength of the y axisEccentricityAreaRotation

domain [ 0, 7 )The feature to be extracted from the input ellipse.It’s possible extract the cooridnates

of the centre of the elipse, the leght of x and y axis or the eccentricity (x and y axis lenghtratio. The value is normalized between 0 and 1)

391

9.1.118 GetEllipse3DFeatures-Double

bitmap

class name GetEllipse3DFeatures-Doublecatalog name Basecatalog id baseclass id ellipse features doubleauthors Simone Ghisio

Return some features of 3D ellipse.

Inputs

Input3Did input 3dtype Base, BaseGeometricEllipse3Doubletype id base, base geometric ellipse 3d double



Generic input 3D

Outputs

Centerid output centertype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Coordinates of the center.

Sizesid output sizetype Base, BaseGeometricSize3Doubletype id base, base geometric size 3d doubleinplace id *no*inherited id *no*

Sizes of the ellipse.

392

9.1.119 GetEllipse3DFeatures-Int

bitmap

class name GetEllipse3DFeatures-Intcatalog name Basecatalog id baseclass id ellipse features intauthors Simone Ghisio

Return some features of 3D ellipse.

Inputs

Input3Did input 3dtype Base, BaseGeometricEllipse3DInttype id base, base geometric ellipse 3d int



Generic input 3D

Outputs

Centerid output centertype Base, BaseGeometricPoint3DInttype id base, base geometric point 3d intinplace id *no*inherited id *no*

Coordinates of the center.

Sizesid output sizetype Base, BaseGeometricSize3DInttype id base, base geometric size 3d intinplace id *no*inherited id *no*

Sizes of the ellipse.

393

9.1.120 GetImageStatistics

bitmap

class name GetImageStatisticscatalog name Basecatalog id baseclass id image statistics


Provides statistics about the image, such as mean, max, stddev, etc. The processing ofeach statistics can be activated indipendently from the other one, in order toreduce CPUoverhead. Note that all outputs are always kept, even if the computation is disabled.Thisis done to let user enable/disable such computations even at run-time

Inputs

Inputid input video streamtype Base, Imagetype id base, image



Input image on which to compute statistics. Although multichannel images are accepted,statistics will be computed on one channel only.

Outputs

Minid output mintype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Computed min value

394

Maxid output maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Computed max value

Meanid output meantype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Computed mean value

Standard deviationid output stddevtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Computed standard deviation

Sumid output sumtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Computed sum

Min positionid output minidxtype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

Position of the min value

Max positionid output maxidxtype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

395

Position of the max value

Parameters

Channel indexid indextype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 3 ]

Index of the channel on which to compute statistics.

Minid compute mintype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Compute min value

Maxid compute maxtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Compute max value

Meanid compute meantype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Compute mean value

Standard deviationid compute stddevtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Compute standard deviation

Sumid compute sumtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Compute sum

Index of Minid compute minidxtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Compute min value

396

Index of Maxid compute maxidxtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Compute index of max value

397

9.1.121 GetIndexedPath

bitmap

class name GetIndexedPathcatalog name Basecatalog id baseclass id get indexed pathauthors Paolo Coletta

This block receives an index as input, and provides, as output the name of the corre-sponding file (or folder) in the filesystem. The user can specify the folder where the filesare looked for, whether to recurse subfolders or not, and a pattern of the files to be takeninto account. Furthermore, the user can specify the sorting criteria and the behaviour ofthe block when an invalid index is given.

Inputs

Inputid inputtype Kernel, Int datatype (Kernel Catalog).type id kernel, int



File index

Outputs

Pathnameid pathtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

Full pathname

398

Number of filesid number of filestype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Number of files found

Parameters

Source Folderid pathtype Kernel, String datatype (Kernel Catalog).type id kernel, stringlayout Folder

Source Folder

Recursiveid recursivetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Recursive search

Files or pathsid file or pathtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:FilePath

domain [ 0, 2 )Specifies whether the block enumerates files or paths

Filename maskid masktype Kernel, String datatype (Kernel Catalog).type id kernel, string

Filename/pathname mask (use regular expression syntax in Perl syntax: http://www.boost.org/libs/regex/doc/syntax perl.html#Perl)

399

Order byid order bytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NameLast WriteSize

domain [ 0, 3 )Order file by name, date etc..

Sorting typeid sorting typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AscendingDescendingRandom

domain [ 0, 3 )Sorting Type

Refreshid refreshtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Refresh

Out of boundsid out of boundtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:WrapBoundIgnore

domain [ 0, 3 )Set the behaviour if the index of file is negative or greater than the number of files in

the seleceted folder

400

9.1.122 GetLine3DFeatures-Double

bitmap

class name GetLine3DFeatures-Doublecatalog name Basecatalog id baseclass id line features doubleauthors Simone Ghisio

Return some features of 3D line.

Inputs

Input3Did input 3dtype Base, BaseGeometricLine3Doubletype id base, base geometric line 3d double



Generic input 3D

Outputs

PointAid output point atype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Coordinates of the first point.

PointBid output point btype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Coordinates of the second point.

401

9.1.123 GetLine3DFeatures-Int

bitmap

class name GetLine3DFeatures-Intcatalog name Basecatalog id baseclass id line features intauthors Simone Ghisio

Return some features of 3D line.

Inputs

Input3Did input 3dtype Base, BaseGeometricLine3DInttype id base, base geometric line 3d int



Generic input 3D

Outputs

PointAid output point atype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Coordinates of the first point.

PointBid output point btype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Coordinates of the second point.

402

9.1.124 GetPixel

bitmap

class name GetPixelcatalog name Basecatalog id baseclass id GetPixelauthors Alessandro Fausto

This block extracts from input image the color components of one pixel.The pixel isselected by its (X,Y) cartesian coordinates.

Inputs

imageid InputImagetype Base, Imagetype id base, image



Input image

Outputs

OutputRGBid OutputRGBtype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolorinplace id *no*inherited id *no*

Pixel channels (Red, green, blue) with normalized values

OutputAlphaid OutputAlphatype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Alpha channel with normalized values

403

Parameters

Outputid paramOutputModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RGB color and alpha value (RGB + double)Normalized channels values (double)Channels values (integer)

domain [ 0, 3 )Discriminate between the format of output information

Coordinatesid paramPositionModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Separated integer X and YSeparated floating point X and Y(x,y) integer coordinate(x,y) Floating point coordinate

domain [ 0, 4 )Discriminate between different modes to specify the position of selected pixel.The differ-

ence between this modes are two.The first difference concern the datatype used to containthis informations.The second diference is the range of coordinates. This block expect nor-malized values (0,1) for each coordinate when floating point coordinates are select.Otherwiseit expect (0,width) for X coordinate and (0,height) for Y coordinate.The coordinate systemis allways cartesian.

(X,Y)id paramPositiontype Base, Point 2D doubletype id base, point 2d double

Is the coordinate of pixel (the column and row of pixel). Each component is expectedin range (0,1).

404

9.1.125 GetPoint2DCoordinates

bitmap

class name GetPoint2DCoordinatescatalog name Basecatalog id baseclass id get point2d coordinates


Extracts the coordinates (x, y) of a bidimensional point. Work with both integer orfloating point points

Inputs

Input pointid inputtype Base, Point 2D doubletype id base, point 2d double



Input bidimensional point whose coordinates will be extracted

Outputs

Output Xid output xtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

X coordinate extracted from the input point

Output Yid output ytype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Y coordinate extracted from the input point

405

Parameters



domain [ 0, 2 )Specifies whether the block operates with integer coordinates or with double coordinates.

406

9.1.126 GetPoint3DCoordinates-Double

bitmap

class name GetPoint3DCoordinates-Doublecatalog name Basecatalog id baseclass id point coordinates doubleauthors Simone Ghisio

Return coordinates of 3D point.

Inputs

Input3Did input 3dtype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d double



Generic input 3D

Outputs

Coordinate Xid output coordinate xtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Coordinates X.

Coordinate Yid output coordinate ytype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Coordinates Y.

407

Coordinate Zid output coordinate ztype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Coordinates Z.

408

9.1.127 GetPoint3DCoordinates-Int

bitmap

class name GetPoint3DCoordinates-Intcatalog name Basecatalog id baseclass id point coordinates intauthors Simone Ghisio

Return coordinates of 3D point.

Inputs

Input3Did input 3dtype Base, BaseGeometricPoint3DInttype id base, base geometric point 3d int



Generic input 3D

Outputs

Coordinate Xid output coordinate xtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Coordinates X.

Coordinate Yid output coordinate ytype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Coordinates Y.

409

Coordinate Zid output coordinate ztype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Coordinates Z.

410

9.1.128 GetROI

bitmap

class name GetROIcatalog name Basecatalog id baseclass id image get roi


This block extract the coordinate of image Region Of Interest (ROI). The image ROI isa rectangular area which may be either some part of the image or the whole image. Mostimaging blocks operations will only affect the ROI instead of the whole image.

Inputs

Input imageid input video streamtype Base, Imagetype id base, image



Input image

Outputs

ROI coordinatesid output video roitype Base, Roi 2D inttype id base, roi2d intinplace id *no*inherited id *no*

Coordinate of image region of interest (ROI).

411

9.1.129 GetRectangle3DFeatures-Double

bitmap

class name GetRectangle3DFeatures-Doublecatalog name Basecatalog id baseclass id rectangle features doubleauthors Simone Ghisio

Return some features of 3D rectangle.

Inputs

Input3Did input 3dtype Base, BaseGeometricRectangle3Doubletype id base, base geometric rectangle 3d double



Generic input 3D

Outputs

Originid output centertype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Coordinates of the Origin.

Sizesid output sizetype Base, BaseGeometricSize3Doubletype id base, base geometric size 3d doubleinplace id *no*inherited id *no*

Sizes of the rectangle.

412

9.1.130 GetRectangle3DFeatures-Int

bitmap

class name GetRectangle3DFeatures-Intcatalog name Basecatalog id baseclass id rectangle features intauthors Simone Ghisio

Return some features of 3D rectangle.

Inputs

Input3Did input 3dtype Base, BaseGeometricRectangle3DInttype id base, base geometric rectangle 3d int



Generic input 3D

Outputs

Originid output centertype Base, BaseGeometricPoint3DInttype id base, base geometric point 3d intinplace id *no*inherited id *no*

Coordinates of the Origin.

Sizesid output sizetype Base, BaseGeometricSize3DInttype id base, base geometric size 3d intinplace id *no*inherited id *no*

Sizes of the rectangle.

413

9.1.131 GetSize2DFields - double

bitmap

class name GetSize2DFields - doublecatalog name Basecatalog id baseclass id get size2d fields double


Extracts the fields of a bidimensional size. Work with double sizes (sizes with floatingpoint fields)

Inputs

Input sizeid inputtype Base, Size 2D doubletype id base, size2d double



Input bidimensional size whose fileds will be extracted

Outputs

Output Xid output cxtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Size along the X axis, i.e., width

Output Yid output cytype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Size along the Y axis, i.e., height

414

9.1.132 GetSize2DFields - int

bitmap

class name GetSize2DFields - intcatalog name Basecatalog id baseclass id get size2d fields int


Extracts the fields of a bidimensional size. Work with integer sizes (sizes with integerfields)

Inputs

Input sizeid inputtype Base, Size 2D inttype id base, size2d int



Input bidimensional size whose fileds will be extracted

Outputs

Output Xid output cxtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Size along the X axis, i.e., width

Output Yid output cytype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Size along the Y axis, i.e., height

415

9.1.133 GetSize3DFields-Double

bitmap

class name GetSize3DFields-Doublecatalog name Basecatalog id baseclass id size fields doubleauthors Simone Ghisio

Return fields of Size 3D.

Inputs

Input3Did input 3dtype Base, BaseGeometricSize3Doubletype id base, base geometric size 3d double



Generic input 3D

Outputs

XSizeid output size xtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Size along x axis.

YSizeid output size ytype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Size along y axis.

416

ZSizeid output size ztype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Size along z axis.

417

9.1.134 GetSize3DFields-Int

bitmap

class name GetSize3DFields-Intcatalog name Basecatalog id baseclass id size fields intauthors Simone Ghisio

Return fields of Size 3D.

Inputs

Input3Did input 3dtype Base, BaseGeometricSize3DInttype id base, base geometric size 3d int



Generic input 3D

Outputs

XSizeid output size xtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Size along x axis.

YSizeid output size ytype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Size along y axis.

418

ZSizeid output size ztype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Size along z axis.

419

9.1.135 GetTransform3DValues-Double

bitmap

class name GetTransform3DValues-Doublecatalog name Basecatalog id baseclass id transform 3d values doubleauthors Simone Ghisio

Return rotation, scaling and translation values.

Inputs




Generic input 3D

Required interfacesbase, 3d rotate base, 3d scle base, 3d translate double

Outputs

Rotationid output rotatetype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

The orientation of the object. In this case orientation is stored in point structure.

Scaleid output scaletype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

420

The scaling of the object. In this case scaling is stored in point structure.

Translateid output translatetype Base, BaseGeometricSize3Doubletype id base, base geometric size 3d doubleinplace id *no*inherited id *no*

The scaling of the object. In this case transltion is stored in size structure.

421

9.1.136 GetTransform3DValues-Int

bitmap

class name GetTransform3DValues-Intcatalog name Basecatalog id baseclass id transform 3d values intauthors Simone Ghisio

Return rotation, scaling and translation values.

Inputs




Generic input 3D

Required interfacesbase, 3d rotate base, 3d scle base, 3d translate int

Outputs

Rotationid output rotatetype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

The orientation of the object. In this case orientation is stored in point structure.

Scaleid output scaletype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

422

The scaling of the object. In this case scaling is stored in point structure.

Translateid output translatetype Base, BaseGeometricSize3DInttype id base, base geometric size 3d intinplace id *no*inherited id *no*

The scaling of the object. In this case transltion is stored in size structure.

423

9.1.137 GetVector2DCoordinates - double

bitmap

class name GetVector2DCoordinates - doublecatalog name Basecatalog id baseclass id get vector2d coordinates double


This blocks returns the coordinates of the input 2D vector either in a cartesian or in apolar reference system

Inputs

Input vectorid inputtype Base, Vector 2D doubletype id base, vector 2d double



The input vecctor

Outputs

First coordinateid output xtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The x coordinate (in a cartesian reference system) or the module (in a polar referencesystem)

Second coordinateid output ytype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

424

The y coordinate (in a cartesian reference system) or the angle (in a polar referencesystem)

Parameters

Output coordinatesid output coordinatestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CartesianPolar

domain [ 0, 2 )The coordinate reference system used to extract the vector coordinates (it may be either

cartesian or polar)

Get versorid get versortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If this parameter is set to true, the (normalized) x and y components of the versor ofthe input vector are returned. This parameter is enabled only if the output coordinates arein cartesian coordinates.

Angle measure unitid angle unittype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:RadiantsDegrees

domain [ 0, 2 )The measure unit for the angle of the input vector (either radiants or degrees). This

parameter is enabled only if the output coordinates are polar coordinates.

425

9.1.138 GetVector2DCoordinates - int

bitmap

class name GetVector2DCoordinates - intcatalog name Basecatalog id baseclass id get vector2d coordinates int


This blocks returns the coordinates of the input 2D vector either in a cartesian or in apolar reference system

Inputs

Input vectorid inputtype Base, Vector 2D inttype id base, vector 2d int



The input vecctor

Outputs

First coordinateid output xtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

The x coordinate (in a cartesian reference system) or the module (in a polar referencesystem)

Second coordinateid output ytype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

426

The y coordinate (in a cartesian reference system) or the angle (in a polar referencesystem)

Parameters

Output coordinatesid output coordinatestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CartesianPolar

domain [ 0, 2 )The coordinate reference system used to extract the vector coordinates (it may be either

cartesian or polar)

Get versorid get versortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If this parameter is set to true, the (normalized) x and y components of the versor ofthe input vector are returned. This parameter is enabled only if the output coordinates arein cartesian coordinates.

Angle measure unitid angle unittype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:RadiantsDegrees

domain [ 0, 2 )The measure unit for the angle of the input vector (either radiants or degrees). This

parameter is enabled only if the output coordinates are polar coordinates.

427

9.1.139 GoodFeatures

bitmap

class name GoodFeaturescatalog name Basecatalog id baseclass id Good Featuresauthors Simone Ghisio

The block finds corners with big eigenvalues in the image.

Inputs




Input Image

Outputs

Output Geometric Labelled Setid output geometric labeled settype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d doubleinplace id *no*inherited id *no*

List of features generated by the method.

Parameters

Generate new pointsid loadtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Generates new points to track

428

Points To Trackid points to trackstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of Points To Track

Quality Levelid quality leveltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Multiplier for the maxmin eigenvalue; specifies minimal accepted quality of image cor-ners.

Minimum distanceid minimum distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Limit, specifying minimum possible distance between returned corners; Euclidian dis-tance is used.

Input typeid input typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ImageImage + Blob

domain [ 0, 2 )The parameter specifying the input type. If image is selected teh method assignsfeatures

in the entire image. If Image + Blob is selected the method assigns points only in thesilhouette area.



domain [ 0, 2 )The parameter specifying if the output is integer (pixel value) or double.

429

9.1.140 GrayToColor

bitmap

class name GrayToColorcatalog name Basecatalog id baseclass id GrayToColorauthors Roberto Sagoleo

Converts a gray scaled image into a colored image

Inputs

InputImageid input imagetype Base, Imagetype id base, image



Gray scaled input image

Outputs

OutputImageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

RGB colored output image

430

Parameters


layoutCombo Box:RGBBGR

domain [ 0, 1 ]Color model of the output image.

FractionRedid redtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Red component of the output image

FractionGreenid greentype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Green component of the output image

FractionBlueid blutype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Blue component of the output image

431

9.1.141 GrayToRainbow

bitmap

class name GrayToRainbowcatalog name Basecatalog id baseclass id GrayToRainbowauthors Mirko Demurtas

Color the gray image

Inputs

Imageid Inputtype Base, Imagetype id base, image



Input Image

Outputs

Imageid Outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output Image

432

9.1.142 HaarCascade

bitmap

class name HaarCascadecatalog name Basecatalog id baseclass id haarcascadeauthors Maurizio Mancini

Runs a classifiers for detecting objects of a particular type. Haar classifiers are commonlyused to detect faces; however, other objects can be detected according to the trained datawhich is being used. The output is a list of rectangles each surrounding a zone were anobject has been detected

Inputs

InputImageid haarcascadeinputimagetype Base, Imagetype id base, image



input

Outputs

Rectangles listid haarcascadeoutputlisttype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*

List of extracted areas (list of Geometric Rectangle 2D Double).

433

Parameters

Classifier pathid haarcascadeclassifierpathtype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true

Path to the XML file containing the classifier data. Some classifiers are provided togetherwith the OpenCv distribution, which can be downloaded from the SourceForge websitehttp://sourceforge.net/projects/opencvlibrary

Min neighborsid haarcascademinneighborstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Minimum number (minus 1) of neighbor rectangles that makes up an object. All thegroups of a smaller number of rectangles than min neighbors-1 are rejected. If min neighborsis 0, the function does not any grouping at all and returns all the detected candidate rect-angles, which may be useful if the user wants to apply a customized grouping procedure.

Scale Factorid haarcascadescalefactortype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The factor by which the search window is scaled between the subsequent scans, forexample, 1.1 means increasing window by 10%%.

Do Canny Pruningid haarcascadedocannypruningtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enables or disables the corresponding CV HAAR DO CANNY PRUNING flag (seeOpenCv doc)

Scale Imageid haarcascadescaleimagetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enables or disables the corresponding CV HAAR SCALE IMAGE flag (see OpenCvdoc)

434

Find Biggest Objectid haarcascadefindbiggestobjecttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enables or disables the corresponding CV HAAR FIND BIGGEST OBJECT flag (seeOpenCv doc)

Do Rough Searchid haarcascadedoroughsearchtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enables or disables the corresponding CV HAAR DO ROUGH SEARCH flag (see OpenCvdoc)

435

9.1.143 HammingDistance

bitmap

class name HammingDistancecatalog name Basecatalog id baseclass id hamming distanceauthors Paolo Coletta

Computes the hamming distance between two images

Details Hamming distance is computed by pairwise comparing the bits of two pixels,and counting the number of different ones.

Notes For an 8-bits image, the maximum difference is 8; since the output range inthis case would be 0-255 a value of 8 is a very dark grey. This means that you shouldprobably amplify the output or threshold it in order to visualize the result.

Inputs

Input 1id input 0type Base, Imagetype id base, image



Input image to compute the distance with the second one

Input 2id input 1type Base, Imagetype id base, imagerequired required for executionread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Input image to compute the distance with the first one

436

Outputs

Outputid outputtype Base, Imagetype id base, imageinplace id Input 1inherited id *no*

Resulting image

437

9.1.144 Histogram

bitmap

class name Histogramcatalog name Basecatalog id baseclass id MonodimensionalHistogramauthors Gualtiero Volpe

This block computes the running histogram of the incoming values

Inputs

Input valuesid Inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



The input values on which the histogram is computed

Outputs

Histogramid Outputtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The computed histogram

Parameters

Minimum valueid Mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The low bound of the range for the input values

438

Maximum valueid Maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The high bound of the range for the input values

Number of binsid Binstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The number of bins for the histogram

Output modeid Modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RawNormalizedIn percentage

domain [ 0, 3 )The mode for representing the output histogram

439

9.1.145 Histogram

bitmap

class name Histogramcatalog name Basecatalog id baseclass id image histogram


Computes the histogram of an image

Inputs

Input imageid inputtype Base, Imagetype id base, image



Input image to be analyzed. The image can be both single channel or multichannel.The settings of the block let you ignore the alpha channel, in the case that you do not needto compute its histogram.

Outputs

Output histogramid output histtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The calculated input image histogram matrix. The matrix has a row for every channelof the input image, and a column for every histogram bin

440

Output histogram levelsid output hist levelstype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

This is a single-row matrix containing the levels used to calculate the histogram bins.The number of levels (columns) is NumBins+1

Parameters

Num. binsid num binstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Specifies the number of histogram bins. The number of levels is NumBins+1

Lower levelid lower leveltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the lower level of the interval that is used to evenly distribute the histogrambins

Upper levelid upper leveltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the upper level of the interval that is used to evenly distribute the histogrambins

Levelsid levelstype Kernel, Double matrix.type id kernel, double-matrix

Specifies the histogram levels. The n-th histogram bin is in the interval [ level(n) ..level(n+1) )

Ignore Alphaid ingore alphatype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

When false, the histogram is calculated also for the alpha channel

441

Normalizedid normalizedtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

When false every bin contains the number of pixels that falls in the corresponding bininterval, when true the same number is divided by the total number of pixels in the image

Accumulateid accumulatetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

When false the output histogram is calculated on the very last input image, when truethe histogram is calculated on all the input images from the last ’Clear’ command to thelast image


Clear the accumulated histograms when in ’Accumulate’ mode

442

9.1.146 HistogramDistribution

bitmap

class name HistogramDistributioncatalog name Basecatalog id baseclass id image probability distribution


Computes the probability distribution of an image given a probability histogram

Inputs

Input imageid input imagetype Base, Imagetype id base, image



This is the image for which the probability distribution of the given histogram is calcu-lated

Input histogramid input histtype Kernel, Double matrix.type id kernel, double-matrix



This is the histogram used to calculate the probability distribution of the given image

443

Input histogram levelsid input hist levelstype Kernel, Double matrix.type id kernel, double-matrix



Represents the histogram levels used to calculate the given histogram

Outputs

Output imageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image where the (floating point) probabilities of every single pixel of the imputimage are stored

444

9.1.147 HistogramSimple

bitmap

class name HistogramSimplecatalog name Basecatalog id baseclass id Histogramauthors Mirko Demurtas

Calculates the histogram of the image. It operates on uniform bins of unitary size, i.e.,each bin spans one color level. In an 8 bit image, where color levels span the range [0-255]there are 255 bins: [0-1], [1-2], [2-3], ..., [254-255].

Inputs




Input Image

Outputs

Matrixid output matrixtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Histogram of image

445

9.1.148 HistogramSizeBlob

bitmap

class name HistogramSizeBlobcatalog name Basecatalog id baseclass id histogram size blobauthors Simone Ghisio

HistogramSizeBlob block performs a vertical/horizontal scan of the input blob and givean integer matrix as output. The matrix has width/height columns and 1 row. The valueof each cell is the number of white pixel in the vertical/horizontal line of the blob.

Inputs





Outputs

Output Histogramid output histogramtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Output matrix histogram.

446

Parameters

Scan directionid scan directiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:VerticalHorizontal

domain [ 0, 2 )Scan Direction

447

9.1.149 HsvToRgbFormatConverter

bitmap

class name HsvToRgbFormatConvertercatalog name Basecatalog id baseclass id HSV to RGBauthors Roberto Sagoleo

This block converts the H,S,V (Hue,Saturation,Value) input values into the correspond-ing R,G,B (Red,Green,Blue) output values.

Inputs

Hid Htype Kernel, Double datatype (Kernel Catalog).type id kernel, double



The Hue input value to be converted

Sid Stype Kernel, Double datatype (Kernel Catalog).type id kernel, double



The Saturation input value to be converted

448

Vid Vtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



The Value input value to be converted

Outputs

Rid Rtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The converted Red output value.

Gid Gtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The converted Green output value.

Rid Btype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The converted Blue output value.

449

9.1.150 IFFTransform

bitmap

class name IFFTransformcatalog name Basecatalog id baseclass id inv fast fourier transformauthors Carlo Drioli

Inverse FFT Transform

Inputs

Input Fft bufferid input fftbuffertype Base, Audio FFT buffertype id base, audio fftbuffer



Input Fft buffer

Outputs


Output buffer

450

9.1.151 Image extremes

bitmap

class name Image extremescatalog name Basecatalog id baseclass id image extremesauthors Simone Ghisio

This block find extreme pixels in the input blob and returns the coordinate of thatpoint.

Inputs





Outputs

Output Pointid output pointtype Base, Point 2D doubletype id base, point 2d doubleinplace id *no*inherited id *no*

Output point

451

Parameters

Positionid parameter positiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:TopRightBottomLeft

domain [ 0, 4 )Position

Typeid parameter typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )Type

452

9.1.152 ImageAudioDisplay

bitmap

class name ImageAudioDisplaycatalog name Basecatalog id baseclass id DrawAudioauthors Mirko Demurtas

This block displays the waveform of the input audio stream

Inputs

Imageid InputImagetype Base, Imagetype id base, image



Background of graph image

Audioid InputData00type Base, Audio buffertype id base, audio buffer



Audio Input

453

Outputs

Outputid OutputImagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Graph image output

Parameters

Font Axisid FontAxistype Kernel, Fonttype id kernel, font

Font Axis

Labelid Labeltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Label

454

9.1.153 ImageBlur

bitmap

class name ImageBlurcatalog name Basecatalog id baseclass id opencv image blurauthors Alessandro Fausto

This block smooth the input image using the blur algorithm. The size of neigthbor areapixels is given as parameter and must be odd.

Inputs



read only/read write read writereferred as inplace OutputImagereferred as inherited *no*

Image to blur

Outputs

OutputImageid OutputImagetype Base, Imagetype id base, imageinplace id imageinherited id *no*

Blurred image

Parameters

Neighborhoodid Neightborhoodtype Base, Size 2D inttype id base, size2d int

Set the size of neightbor area, must be odd.

455

9.1.154 ImageConcatenate

bitmap

class name ImageConcatenatecatalog name Basecatalog id baseclass id ImageConcatenateauthors Alessandro Fausto

Places images one by the other one to form a bigger image. – REMARKS – Theimages must have the same format (color model, pixel model, alpha channel). If the imageconcatenation is done horizontally the height of all input images must be the same.If theimage concatenation is done vertically the width of all input images must be the same.

Inputs

Image1id video stream 1type Kernel, Generic datatypetype id kernel, generic datatype



This is the 1-th input image. All images must use the same color model and pixel depth.

Required interfacesBase, ImageConversion

Image2id video stream 2type Kernel, Generic datatypetype id kernel, generic datatype



This is the 2-th input image. All images must use the same color model and pixel depth.

456


Outputs

Outputid video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Image1inherited id *no*

This is the output image which contains the input images

Parameters


Specifies the number of input images that the block will accept


layoutCombo Box:horizontallyvertically

domain [ 0, 2 )Defines how the images are placed: ’horizontally’ places the image one by the other one.

The image size increases, whereas height is unchanged. ’vertically’ places the image oneover the other one. The image height increases, whereas size is unchanged.

Orderid ordertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:left to rightright to left

domain [ 0, 2 )Defines how the input is concatenated: ’left to right’ input images are concatenated

starting from the left side of output image; ’right to left’ input images are concatenatedstarting from the right side of output image.

457

9.1.155 ImageConversion

bitmap

class name ImageConversioncatalog name Basecatalog id baseclass id image converter


Converts the image from one format to another. It may perform color model conversionas well as pixel format conversion

Inputs

Input imageid inputtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace *no*referred as inherited Output image

Input image which needs to be converted


Outputs

Output imageid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input imageinherited id *no*

Converted image

458

Parameters


layout

Combo Box:Same as inputBWRGBBGRYUVYUYVUYVYI420YV12HSVRGBABGRAYUVAHSVAARGBABGRAYUVAHSV

domain [ 0, 18 )The color model define the way a color is stored into the image.May assume one of

following values:Same as input (Use the same color model of the input image)BW (1 channel: grayscale);BGR (3 channel packed: Blue, Green, Red);RGB (3 channel packed: Red, Green, Blue);YUV (3 channel packed: Y, Cb, Cr);YUYV (3 channel packed, undersampled 422: Y, Cb, Cr);UYVY (3 channel packed, undersampled 422: Y, Cb, Cr);I420 (3 channel planar, undersampled 411: Y, Cb, Cr);YV12 (3 channel planar, undersampled 411: Y, Cb, Cr);HSV (3 channel packed: Hue, Saturation, Value).

459


layout

Combo Box:Same as input8 bits per channel, unsigned16 bits per channel, unsigned16 bits per channel, signed32 bits per channel, floating-point



Sizeid sizetype Base, Size 2D inttype id base, size2d int

Size of the image, in pixels. Set the size to (0; 0) for using the same size of inputimage. Some commonly used sizes are given in the following, however, such values are justsuggestions as the image datatype supports any size. 320x200 CGA (very old graphic cards)

640x480 VGA (old graphic cards)1024x768 XGA (common resolution for 15” LCDmonitors)1280x1024 SXGA (common resolution for 17” LCD monitors)1400x1050 SXGA+ (many notebooks)1600x1200 UXGA (20” LCD monitors)1920x1200 WUXGA (modern widescreen monitors)352x288 PAL QCIF720x576 PAL

460

LetterBox Modeid letterbox modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:No letterboxCenterMiddleNoneTopNoneMiddleNoneBottomLeftNoneLeftTopLeftMiddleLeftBottomCenterNoneCenterTopCenterBottomRightNoneRightTopRightMiddleRightBottom

domain [ 0, 16 )Specifies where to place mattes and image when using letterboxing. in ’No letterbox’

the aspectRatio is not preserved, and the source image is stretched or shrinked to coverall available space. In the other cases, the aspect ratio is (or might be) preserved, thus ablack frame might be needed on the horizontal or vertical side to cover the unused space.This enumerator specifies where to place such black frame. Since the user might not knowin advance whether letterboxing will place mattes above/below or left/right, each modespecifies how to behave in both cases. As an example, the letterbox mode left-middle meansthat if the image needs mattes on the sides, the image will be put to the extreme left, andthe matte will span the right side; if the image needs mattes above/below, the image willbe vertically centered. Hence, the mode is made of two terms, the first referring to thehorizontal centering of the image, the second referring to the vertical centering. Horizontalcentering may assume values none, left, center, or right. Vertical centering may assumevalues none, top, middle, or bottom. The term none means that if letterboxing is neededon that direction, than the image is stretched to fill the whole size. E.g., elmNoneTopmeans that is image is thinner than the destination rect, than no letterboxing is appliedand the image is stretched horizontally. However, it the image is larger than the destinationrect, than letterboxing is applied by putting the image on the top and a single matte below.

461

Interpolationid interpolationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Nearest NeighborLinearCubic

domain [ 0, 3 )Specifies the algorithm used to interpolate the image when resize is needed.A rough interpolation (e.g., nearest neighbour) may cause visible artifacts, however, the

CPU usage to perform such interpolation is quite limited. A good quality interpolation(e.g., cubic) provides better results but may cause an high CPU load.

462

9.1.156 ImageFixedFilter

bitmap

class name ImageFixedFiltercatalog name Basecatalog id baseclass id image fixed filter


Apply fixed filter to input image

Inputs

image inputid input video streamtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace *no*referred as inherited Image

image input

Required interfacesbase, image filter Base, ImageROI Kernel, ScalarArithmeticOpDouble

Outputs

Imageid output video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id image inputinherited id *no*

The image after the filtering.

463

Parameters

Filterid filtertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Prewitt HorizontalPrewitt VerticalSobel HorizontalSobel VerticalRoberts DownRoberts UpLaplace 3x3Laplace 5x5Gauss 3x3Gauss 5x5Hi pass 3x3Hi pass 5x5Low pass 3x3Low pass 5x5SharpenGeneric

domain [ 0, 16 )Filter

Kernelid filter kerneltype Kernel, Double matrix.type id kernel, double-matrix

Kernel

Divisorid divisortype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Divisor

464

9.1.157 ImageGenerator

bitmap

class name ImageGeneratorcatalog name Basecatalog id baseclass id image generator


This block generates an image using one of the following six sources: Constant Colorbars Random values with uniform distribution Random values with Gaussian distributionJaehne Ramp

Outputs

Outputid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

The output with the characteristics specified in the block

Parameters


Size of the image, in pixels. Some commonly used sizes are given in the following,however, such values are just suggestions as the image datatype supports any size. 320x200CGA (very old graphic cards)


465


layout





layout

Combo Box:BWRGBBGRYUVYUYVUYVYI420YV12HSVBGRARGBAYUVAHSVAABGRARGBAYUVAHSV


following values:BW (1 channel: grayscale);BGR (3 channel packed: Blue, Green, Red);RGB (3 channel packed: Red, Green, Blue);YUV (3 channel packed: Y, Cb, Cr);

466

YUYV (3 channel packed, undersampled 422: Y, Cb, Cr);UYVY (3 channel packed, undersampled 422: Y, Cb, Cr);I420 (3 channel planar, undersampled 411: Y, Cb, Cr);YV12 (3 channel planar, undersampled 411: Y, Cb, Cr);HSV (3 channel packed: Hue, Saturation, Value).

Continuousid continuoustype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool


Colorid constant colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

This color is used as main color value (RGB space model) in ’Constant’, ’Jaehne’ and’Ramp’ source type.

Alphaid constant alphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The alpha channel is filled with this value.

Source typeid source typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ConstantColor barsRandom values with uniform distributionRandom values with Gaussian distributionJaehneRamp

domain [ 0, 6 )Specifies the type of image generated. May assume one of following values:Constant (all pixels have the same color)Color Bars (vertical bar of colors)Random values with uniform distribution (pixels have random values)Random values with Gaussian distribution (pixels have random values)Jaehne (Jaehnes test image)Ramp (gradient of color intensity starting on the upper left corner)

467

Seedid seedtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Seed value used to initialize the random number generator.This parameter is used in the two ’Random value’ source types.

Min (uniform)id unif mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lower bound for the range of uniform distribution.This parameter is used only in the ’Random value with uniform distribution’ source

type.

Max (uniform)id unif maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Upper bound for the range of uniform distribution.This parameter is used only in the ’Random value with uniform distribution’ source

type.

Meanid gauss meantype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Mean of gaussian distribution.This parameter is used only in the ’Random value with gaussian distribution’ source

type.

Standard deviationid gauss stddevtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Standard deviation of gaussian distribution.This parameter is used only in the ’Random value with gaussian distribution’ source

type.

468

Axisid axistype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Horizontal axisVertical axisBoth axis

domain [ 0, 3 )Specifies the direction of the image intensity ramp. May be the horizontal axis, the

vertical axis, or both.This parameter is used only in ’Ramp’ source type.

Offsetid ramp offsettype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Starting value of the color intensity ramp.This parameter is used only in the ’Ramp’ source type.

Slopeid ramp slopetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Slope value of the color intensity ramp.This parameter is used only in the ’Ramp’ source type.

469

9.1.158 ImageGetDescription

bitmap

class name ImageGetDescriptioncatalog name Basecatalog id baseclass id image getdescriptionauthors Roberto Sagoleo

Provides as output the description of the specified characteristic (Field param) of theinput image. Width - the output is the width, in pixels, of the image; Height - the outputis the height, in pixels, of the image; Depth - the output is the depth of each color channel(see Depth Map); Number of channels - the output is the number of color channels of theimage; Color model - the output is the color model of the image (see Color Model Map);Alpha channel - 1 if the input image has an alpha channel, 0 otherwise; Step size - theoutput is the size in byte of each line of the image;

Depth Map: 1-single bit 8-8 bit unsigned 16-16 bit unsigned 32-32 bit float -2147483640-8 bit signed -2147483632-16 bit signed -2147483616-32 bit signed Color Model Map: 0 -GRAY ( Each pixel is 1 channel only. No alpha supported. ) 1 - RGB ( Each pixel is madeof 3 channels: Red, Green, and Blue. Supports an optional alpha channel. ) 2 - BGR( Each pixel is made of 3 channels: Blue, Green, and Red. Supports an optional alphachannel. ) 3 - YUV ( Each pixel is made of 3 channels named Y, U, and V. Supports anoptional alpha channel. ) 4 - YUYV ( Each couple of pixel is composed of Y, U, Y, Vvalues, thus, U and V are subsamples (factor 1/2) with respect to Y. ) 5 - UYVY ( Eachcouple of pixel is composed of U, Y, V, Y values, thus, U and V are subsamples (factor 1/2)with respect to Y. ) 6 - I420 ( Planar format with horizontal and vertical downsampling(factor 1/2). The plane order is Y U V. ) 7 - YV12 ( Planar format with horizontal andvertical downsampling (factor 1/2). The plane order is Y V U. ) 8 - HSV ( Each pixel ismade of 3 channels: Hue, Saturation, and Value. Supports an optional alpha channel. )

Inputs




This is the input Image from which to get the descriptions

470

Outputs

Fieldid out sing infotype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Field of the input image

Parameters

Single or multiple field descriptionid description output modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Single FieldMultiple Fields

domain [ 0, 2 )Get single or multiple field description.

Fieldid single informationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Width (single)Height (single)Depth (single)Number of channels (single)Color model (single)Alpha channel (single)Step size (single)

domain [ 0, 7 )Field of the input image.

471

9.1.159 ImageMatrixGraph

bitmap

class name ImageMatrixGraphcatalog name Basecatalog id baseclass id DrawTableauthors Mirko Demurtas

This block draws the value of the matrix items on the passthrough image

Inputs





Tableid InputData00type Kernel, Double matrix.type id kernel, double-matrix



Table Input

472

Outputs


Graph image output

Parameters


Font Axis


Label

473

9.1.160 ImageMedianFilter

bitmap

class name ImageMedianFiltercatalog name Basecatalog id baseclass id image median filter


The block implements the non-linear median filter that is used to reduce noise in animage.

Remarks The median filter considers each pixel in the image mask and looks at its nearbyneighbors to decide whether or not it isrepresentative of its surroundings. It replaces it withthe median of those values. The median is calculated by first sortingall the pixel valuesfrom the surrounding neighborhood into numerical order and then replacing the pixel beingconsidered withthe middle pixel value. (If the neighborhood under consideration containsan even number of pixels, the average of the two middle pixel values is used.)


During Initialization Phase -The mask or the anchor are invalid: if the anchor sizeis less then 0 or if the dimension is not even -Pixel Modelnot supported.: if the pixel modelis epmFloat

During Execution Phase -ippStsNullPtrErr: Indicates an error condition if pSrcor pDst pointer is NULL -ippStsSizeErr: Indicates an error condition if dstRoiSize has afield with zero or negative value. -ippStsStepErr: Indicates an error condition if srcStepor dstStep has a zero or negative value. -ippStsMaskSizeErr: Indicates an error conditionif maskSize has a field with zero, negative, or even value. -ippStsAnchorErr: Indicates anerror condition if anchor is outside the mask size.

474

Inputs




The input image. The image model can be BW or BGR

Outputs

Imageid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

The image after the filtering.

Parameters

Maskid masktype Base, Size 2D inttype id base, size2d int

Dimension of 2-D mask that is applied to each pixel in the input image. The mask iscentered in a pixel. After this the method evaluate the covered pixel value and determineswhich is the median value.

475

9.1.161 ImageMerge

bitmap

class name ImageMergecatalog name Basecatalog id baseclass id image merge


This block merge one images into another image. The order of the merge operation isselected through the ’Input 1 on Input 2’ parameter, see the parameter description for moredetails. – REMARKS – The merge operation is done only in the intersection of images ROI.When the ROI of the merged image is smaller than the ROI of destination image the resultis a ’Picture in Picture’ effect without scaling. – ERRORS – ’The two input images musthave the same properties (color model, pixel model, alpha channel and size).’

Inputs

Input imageid input video stream 1type Base, Imagetype id base, image



Input image

Input imageid input video stream 2type Base, Imagetype id base, imagerequired required for executionread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Input image

476

Outputs

Output imageid output video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input imageinherited id *no*

Output image

Parameters

Input 1 on Input 2id input1 over input2type Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

This parameter control the source image and the destination image of merge operation.When is false the second image is merged into the first image, otherwise the first image ismerged into the second image.

coordinates typeid coordinates typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Integer coordinatesFloating point coordinates

domain [ 0, 2 )Specifies whether to use integer or floating-point coordinates. Integer coordinates must

be contained inside the boundaries of the first input image. Floating-point coordinates arenormalized in the range [0.0, 1.0] with respect to the size of the first input image.

Positionid double positiontype Base, Point 2D doubletype id base, point 2d double

Specifies the position and size of the area where the second image is embedded. Floating-point coordinates are normalized in the range [0.0, 1.0] with respect to the size of the firstinput image.

477

9.1.162 ImageMirror

bitmap

class name ImageMirrorcatalog name Basecatalog id baseclass id image mirror


Mirrors an image around the horizontal or vertical axis, or both.

Inputs

Input imageid input video streamtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace Input imagereferred as inherited *no*

Input image

Required interfacesBase, ImageMirror

Outputs

Input imageid output video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input imageinherited id *no*

Input image

478

Parameters

Axisid axistype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Horizontal axisVertical axisBoth axis

domain [ 0, 3 )Type of axis. Determines which axis is used in the operation. May be the horizontal

axis, the vertical axis, or both

479

9.1.163 ImageMoments

bitmap

class name ImageMomentscatalog name Basecatalog id baseclass id image momentsauthors Simone Ghisio

This function computes all spatial and central moments of order 0 to 3 for the sourceblob. The seven Hu moment invariants are also computed.

Inputs





Outputs

OutputMomentid output momenttype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Calculated Output Moment

480

Parameters

Parameter typeid par typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Spatial momentNormalized Spatial momentCentral momentNormalized central momentHU moment

domain [ 0, 5 )Specifies the moment type

Algorithm usedid Algorithmtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NoneFastAccurate

domain [ 0, 3 )Specifies the algorithmic implementation of the function,

M Ordid MOrdtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Integer power exponent defining the moment order. These arguments must satisfy thecondition 0 ¡= M Ord + N Ord ¡= 3.

N Ordid NOrdtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Integer power exponent defining the moment order. These arguments must satisfy thecondition 0 ¡= M Ord + N Ord ¡= 3.

XOffsetid X-Offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Offset in pixels of the ROI origin (left corner) from the image origin.

481

YOffsetid Y-Offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Offset in pixels of the ROI origin (top corner) from the image origin.

482

9.1.164 ImageMorphologicOperatorOpenCV

bitmap

class name ImageMorphologicOperatorOpenCVcatalog name Basecatalog id baseclass id opencv image morphologicauthors Alessandro Fausto

This block apply the morphological operators provided by the openCV library on theinput image. – REMARKS – This block do not support images using 16 bit pixel modelsor YV12 and I420 color models. When the number of iteration is set to zero the operatoris not applied and the output image result black.

Details Based on the Thesis work by: Andrea Carlini and Paolo Tortora

Inputs

Imageid video streamtype Base, Imagetype id base, image



This is the input image.

Outputs

Outputid video streamtype Base, Imagetype id base, imageinplace id Imageinherited id *no*

This is the output image.

483

Parameters

Operator typeid operator typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ErodeDilateOpenCloseGradientTop HatBlack Hat

domain [ 0, 7 )This parameter define the type of morphological operation applied. May assume one of

following values: erode; dilate; open; close; gradient; top hat; black hat.

Structuring element shapeid structuring element shapetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RectangleEllipseCross

domain [ 0, 3 )With this parameter you can choose the shape of the structuring element which is

applied to the input image. The possible shapes are: Rectangle, Ellipse and Cross.

Structuring element sizeid structuring element sizetype Base, Size 2D inttype id base, size2d int

Set the size of structuring element which is applied on the input image, vertical andhorizontal size must be greater than zero. The defautl size is 3x3.

Iterationsid num itertype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Specifies the number of times the morphologic operator is applied to the image.

484

9.1.165 ImageMorphologicalOperation

bitmap

class name ImageMorphologicalOperationcatalog name Basecatalog id baseclass id image-morphological-op

authors

Andrea RicciMassimiliano PeriPaolo ColettaAlessandro Fausto

This block apply the image morphological operators (erode; dilate; open; close; gradi-ent; top hat; black hat) on the input image. Generally, the erosion and dilation smooththe boundaries of objects withoutsignificantly changing their area. All operations use apyramidal 3x3 mask.

Details – ERRORS – ’Unsupported image format for Morphological operation: onlyBlack and White color model and 8 bit or floating point pixel models are supported.’ ’Thenumber of iteraction must be positive or equal to zero.’ The ’iteraction’ parameter mustbe positive or equal to zero.

Notes When the number of iteration is set to zero the operator is not applied and theoutput image result black. This Ipp implementation is faster than OpenCV implementationbut all operation using the erode morphologic show a band of black pixels on image borders.

Inputs




This is the input image.

485

Outputs

Outputid output video streamtype Base, Imagetype id base, imageinplace id Imageinherited id *no*

This is the output image.

Parameters

Operator typeid op-typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ErodeDilateOpenCloseGradientTop HatBlack Hat

domain [ 0, 7 )This parameter define the type of morphological operation applied. May assume one of

following values: erode; dilate; open; close; gradient; top hat; black hat. All operations usea pyramidal 3x3 mask.

Iterationsid iteractionstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Specifies the number of times the morphologic operator is applied to the image.

486

9.1.166 ImageNormalization

bitmap

class name ImageNormalizationcatalog name Basecatalog id baseclass id ImageNormalizationauthors Mirko Demurtas

This block normalize an image

Inputs




Input Geometric

Outputs

Areaid Outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Area of Geometric

Parameters

Type Normalizationid Normalizationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Type Normalization

487

Type Formid Formtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Type Form

Type Imageid Floattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Type Image

Range Xid XRangetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Range X

Range Yid YRangetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Range Y

488

9.1.167 ImageRotate

bitmap

class name ImageRotatecatalog name Basecatalog id baseclass id image rotate

authors

Andrea RicciMassimiliano PeriPaolo ColettaSimone Ghisio

Rotates the input shape

Inputs

Immagineid input video streamtype Kernel, Generic datatypetype id kernel, generic datatype



Immagine

Required interfacesBase, Rotate

Outputs

Immagineid output video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Immagine

489

Parameters

Angleid angletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The angle of rotation in degrees.

Centerid center rotationtype Base, Point 2D doubletype id base, point 2d double

Coordinates of the center of rotation. By default coordinates are normalized. However,to preserve compatibility with an old implementation, an additional parameter is availableto change this behaviour.

490

9.1.168 ImageScalarGraph

bitmap

class name ImageScalarGraphcatalog name Basecatalog id baseclass id DrawGraphauthors Mirko Demurtas

This block draws the graph of the input data on the passthrough video stream

Inputs





Input 1id InputData00type Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input 1

491

Outputs


Graph image output

Parameters

Durateid Duratetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Durate

Numer of inputid nInputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Numbero of input

Minid Mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Min value

Maxid Maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Max value


Font Axis

Color Font Axisid ColorFontAxistype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

492

Color Font Axis


Label

493

9.1.169 ImageSetAlpha

bitmap

class name ImageSetAlphacatalog name Basecatalog id baseclass id ImageAddAlphaauthors Alessandro Fausto

This block use the pixel values of one BW image to set alpha channel values of anotherimage. REMARKS The presence of alpha channel is not required, but the input imagecolor space must support the presence of alpha channel (RGB,BGR,YUV,HSV). The blockis able to set the alpha channel only if the color space of input image can support thepresence of this channel. ERRORS ’The color space of the ’image’ input do not supportthe alpha channel. Only RGB,BGR,YUV and HSV color space support the presence ofalpha channel.’ : ’Input image and input alpha channel have different size’ : ’The alphachannel image must use BW color space’ :

Inputs




This is the image when the alpha channel is overwritten.

alphaChannelid InputAlphaChanneltype Base, Imagetype id base, image



The pixel values of this image is used to set the new input image alpha channel values.The color space of this image must be BW, the size and pixel depht must be the same of

494

the input image

Outputs


This image is the result of block operations. The pixels is always the same of inputimage, only the alpha channel differ.

Parameters

Invert alphaid AlphaInverttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

All pixel values of the output image alpha channel is inverted (negated).

Scale alphaid AlphaScaletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

This parameter enable or disable the scaling of the alpha channel intensity.

495

9.1.170 ImageSplit

bitmap

class name ImageSplitcatalog name Basecatalog id baseclass id Splitauthors Roberto Sagoleo

Splits an image into two halfs (horizontally or vertically)

Inputs

Input imageid input imagetype Base, Imagetype id base, image



The input image to be split

Outputs

Right/Topid output image rttype Base, Imagetype id base, imageinplace id *no*inherited id *no*

The Right/Top output image

Left/Bottomid output image lbtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

The Left/Bottom output image

496

Parameters

Splitting modeid param modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Left - Right splittingBottom - Top splitting

domain [ 0, 1 ]The image can be split in horizzontal or vertical mode

Output typeid param outstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NoneRight/Top output onlyLeft/Bottom output onlyRight/Top and Left/Bottom both outputs

domain [ 0, 3 ]The outputs can be: Right/Top only, Left/Bottom only or both Right/Top and Left/Bottom

Splitting positionid param postype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( -infinity, +infinity )

Specifies the splitting start position

497

9.1.171 ImageToMatrix

bitmap

class name ImageToMatrixcatalog name Basecatalog id baseclass id image to matrixauthors Roberto Sagoleo

Converts an image to a matrix

Inputs




This is the input Image to be converted into the output matrix

Outputs

Output Matrixid output matrixtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

This is the output Matrix converted from the input image

Parameters

Output typeid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Integer

domain [ 0, 1 )

498

Defines the type of the output matrix (integer or double): integer: the output matrixwill be of integer values. double : the output matrix will be of double values.

499

9.1.172 ImageTranspose

bitmap

class name ImageTransposecatalog name Basecatalog id baseclass id image transposeauthors Simone Ghisio

Transposes the input image using ipp method.

Inputs

InputStreamid input video streamtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace *no*referred as inherited OutputStream

Input video stream

Required interfacesBase, ImageMirror

Outputs

OutputStreamid output video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id InputStreaminherited id *no*

Output video stream

500

9.1.173 ImpulsivityIndex

bitmap

class name ImpulsivityIndexcatalog name Basecatalog id baseclass id Impulsivityauthors Maurizio Mancini

It detects impulses in the motion feature provided as input.

Inputs

Sqomid Sqomtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Segmented gesture Quantity of Motion

CIid CItype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Contraction Index

Outputs

IIid IItype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

501

Impulsivity Index

Maxtimeid Maxtimetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Maxtime

Parameters

GesDurid GesDurtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Gesture duration Threshold

Thresholdid Thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

SQoM threshold

Framesid Framestype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Frame rate

502

9.1.174 IndexCompareInVector

bitmap

class name IndexCompareInVectorcatalog name Basecatalog id baseclass id IndexCompareInVectorauthors Barbara Mazzarino

This block extract, from a matrix, an item in a specific position

Inputs

Inputid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



Input

Outputs

Outputid OutputIndextype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Output

Parameters


layoutCombo Box:Max

domain [ 0, 1 )

503

Type

Row Indexid CompareValuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

position in row number of the Item to extract

504

9.1.175 IndexedDispatcher

bitmap

class name IndexedDispatchercatalog name Basecatalog id baseclass id indexed dispatcherauthors Paolo Coletta

Chooses if and where do dispatch incoming data based on the index inputs (and on theirhistory)

Details This block consider the several pair of inputs (the number of pairs is user-specified) and looks at the first items of each pair (called index). If the index from all inputsare different, then the payload from each input is passed straight to the output. If two (ormore) indices have the same value, the output payloads for the corresponding outputs arethe same. In such case the payload sent to the output for all the equal indices is the payloadof the first input with the equal index. I.e., consider the following example where pyaloadis of type double and the are two inputs: Sequence for input 1 (index, payload): (0, 1.2),(0, 1.3), (0, 1.4), (0, 1.5) Sequence for input 2 (index, payload): (1, 2.2), (1, 2.3), (0, 2.4),(0, 2.5) At the third inputs, the index of input 2 becoms equal to the index for input 1,thus, the payload of output 2 will adapt to the payload of output 1. The following outputswill be obtained: Payloads on output 1: 1.2, 1.3, 1.4, 1.5 Payloads on output 2: 2.2, 2.3,1.4, 1.5

Inputs

Index 0id index 0type Kernel, Int datatype (Kernel Catalog).type id kernel, int



505

Payload 0id payload 0type Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace *no*referred as inherited Output 0

Outputs

Output 0id ouput 0type Kernel, Generic datatypetype id kernel, generic datatypeinplace id Payload 0inherited id *no*

Parameters

Num indicesid num indicestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

506

9.1.176 InputsSubset

bitmap

class name InputsSubsetcatalog name Basecatalog id baseclass id input subsetauthors Simone Ghisio

Concatenates an arbitrary number of strings.

Inputs

Input00id input 00type Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input 00.




Input 01.

507




Input 02.




Input 03.




Input 04.




Input 05.

508

Outputs

Output00id output 00type Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output 00.


Output 01.


Output 02.


Output 03.

Parameters

num inputsid input numtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

number of inputs

num outputsid output numtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

509

number of outputs

subsetstringid outputtype Kernel, String datatype (Kernel Catalog).type id kernel, string

subsetstring

510

9.1.177 Integrator

bitmap

class name Integratorcatalog name Basecatalog id baseclass id timeSeriesIntegratorauthors Alessandro Fausto

Integrates the input time series.

Inputs




This is the input matrix


Outputs

output matrixid outputMatrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

This matrix contains the values of input time series

Parameters


511

Clear the integral

512

9.1.178 IppPictureInPicture

bitmap

class name IppPictureInPicturecatalog name Basecatalog id baseclass id image pip

authors

Andrea RicciMassimiliano PeriPaolo ColettaAlessandro Fausto

This block add a picture into another existing picture at specified position and size. Thefirst input image is used as canvas and the second input image is placed into the specifiedarea position and size. The second input image is placed into a user provided rectangulararea of the the first image.

Details If the input images have a different format the second image is convertedto the image format of the first image. If is possible use the same format for the inputimages because the conversion require time and memory. Error messages: ’Coordinatestype mismatch.’ The ’Coordinates type’ parameter contain an invalid identifier, select acorrect value from the drop down list.

Notes The block @blockref(base, picture in picture) might be easier to configure formost common cases. This block add support for all types of composition supported by theIntel IPP libraries

Inputs

Imageid input video stream 1type Kernel, Generic datatypetype id kernel, generic datatype



This is the image where the second image is embedded.

Required interfacesBase, ImageConversion Base, ImageROI

513

Imageid input video stream 2type Kernel, Generic datatypetype id kernel, generic datatyperequired required for executionread only/read write read writereferred as inplace *no*referred as inherited *no*

This is the image to embed.


Outputs

Output Imageid output video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Imageinherited id *no*

Image with ’Picture in Picture’ effect.

Parameters

Coordinates typeid coordinates typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Integer coordinatesFloating point coordinates


be contained inside the boundaries of the first input image. Floating-point coordinates arenormalized in the range [0.0, 1.0] with respect to the size of the first input image.


layout

Combo Box:Nearest NeighborLinearCubic

domain [ 0, 3 )

514

Specifies the algorithm used to interpolate the embedded image when resize is needed.May assume one of following values: Nearest Neighbor; Linear; Cubic. A rough inter-polation (e.g., nearest neighbour) may cause visible artifacts, however, the CPU usageto perform such interpolation is quite limited. A good quality interpolation (e.g., cubic)provides better results but may cause an high CPU load.

modeid parameter modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:insertinsert with mixinginsert with maskinginsert with mixed masking

domain [ 0, 4 )mixing toghter the two images. Apply a mask to the image to insert. Use the ippCom-

posite function to merge the two images.

Compositionid compositiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:OverInOutATOPXORPLUS

domain [ 0, 6 )This parameter control the mode used to embed the image. Is used only when the image

have the alpha channel.May assume one of following values (we denote the first input imageas A and the image to embed as B):

Over (A occludes B);In (A within B. A acts as a matte for B. A shows only where B is visible.);Out (A outside B. NOT-B acts as a matte for A. A shows only where B is not visible);ATOP (Combination of (A IN B) and (B OUT A). B is both back-ground and matte

for A);XOR (B Combination of (A OUT B) and (B OUT A). A and B mutually exclude each

other);PLUS (Blend without precedence).

515

Positionid double positiontype Base, Roi 2D doubletype id base, roi2d double

Specifies the position and size of the area where the second image is embedded. Floating-point coordinates are normalized in the range [0.0, 1.0] with respect to the size of the firstinput image.

516

9.1.179 IsNullROI

bitmap

class name IsNullROIcatalog name Basecatalog id baseclass id is null roiauthors Paolo Coletta

Returns true if the input ROI is Null, false otherwise

Inputs

Input Roiid input roitype Base, Roi 2D doubletype id base, roi2d double



The input Roi on which to verify the Null flag

Outputs

IsNullid output is nulltype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

The NULL flag of the input Roi

Parameters



domain [ 0, 2 )

517

Specify whether input Roi has normalized floating-point (double) coordinates or integercoordinates

518

9.1.180 KeyStoneCorrection

bitmap

class name KeyStoneCorrectioncatalog name Basecatalog id baseclass id keystoneauthors Mirko Demurtas

Perform the keystone correction on an image

Inputs




Image Input

Outputs

Imageid output imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Image Output

Parameters

Top-Leftid param point1type Base, Point 2D inttype id base, point 2d int

Point Top-Left

519

Top-Rightid param point2type Base, Point 2D inttype id base, point 2d int

Point Top-Right

Bottom-Rightid param point3type Base, Point 2D inttype id base, point 2d int

Point Bottom-Right

Bottom-Leftid param point4type Base, Point 2D inttype id base, point 2d int

Point Bottom-Left

520

9.1.181 KinematicModel

bitmap

class name KinematicModelcatalog name Basecatalog id baseclass id kinematic modelauthors Paolo Coletta

Computes the evelution of a monodimensional kinematic model

Inputs

Input Accelerationid input accelerationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input acceleration applied to the kinematic model, in m/sˆ2

Outputs

Positionid output positiontype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output absolute position (in m)

Velocityid output velocitytype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output speed in m/s

521

Resetid output resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Reset the state to its initial value.

Parameters

Initial Positionid initial positiontype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the initial position of the point subject to the kinematic rules

Initial Velocityid initial velocitytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the initial velocity of the point subject to the kinematic rules


Reset the system to its initial conditions, which are specified by the above parameters

Compute Delta Tid compute delta ttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true, the delta T is inherited from the input datatype (presentation time)

Delta Tid delta ttype Kernel, Time datatype (Kernel Catalog).type id kernel, time

The delta T (time delay of each step), in the case that it is not automatically computed

522

9.1.182 KineticEnergyIndex

bitmap

class name KineticEnergyIndexcatalog name Basecatalog id baseclass id KineticEnergyIndexauthors Maurizio Mancini

This block computes the Kinetic Energy Index of a given labelled set of geometric 3Dpoints.

Inputs

Input geometric labelled set of 3D geometric pointsid InputGeometricLabelledSettype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d double



A labelled set containing the 3D geometric points on which the block computes cinematicenergy.

Outputs

Kinetic Energy Indexid OutputKineticEnergyIndextype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The Kinetic Energy Index is the sum of the product between each input point’s squaredspeed of movement and mass.

523

Parameters

weight coeff. of headid ParameterWeight headtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with head

weight coeff. of neckid ParameterWeight necktype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with neck

weight coeff. of torsoid ParameterWeight torsotype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with torso

weight coeff. of waistid ParameterWeight waisttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with waist

weight coeff. of left collarid ParameterWeight left collartype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left collar

weight coeff. of left shoulderid ParameterWeight left shouldertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left shoulder

weight coeff. of left elbowid ParameterWeight left elbowtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left elbow

524

weight coeff. of left wristid ParameterWeight left wristtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left wrist

weight coeff. of left handid ParameterWeight left handtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left hand

weight coeff. of left fingertipid ParameterWeight left fingertiptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left fingertip

weight coeff. of right collarid ParameterWeight right collartype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right collar

weight coeff. of right shoulderid ParameterWeight right shouldertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right shoulder

weight coeff. of right elbowid ParameterWeight right elbowtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right elbow

weight coeff. of right wristid ParameterWeight right wristtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right wrist

525

weight coeff. of right handid ParameterWeight right handtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right hand

weight coeff. of right fingertipid ParameterWeight right fingertiptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right fingertip

weight coeff. of left hipid ParameterWeight left hiptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left hip

weight coeff. of left kneeid ParameterWeight left kneetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left knee

weight coeff. of left ankleid ParameterWeight left ankletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left ankle

weight coeff. of left footid ParameterWeight left foottype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with left foot

weight coeff. of right hipid ParameterWeight right hiptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right hip

526

weight coeff. of right kneeid ParameterWeight right kneetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right knee

weight coeff. of right ankleid ParameterWeight right ankletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right ankle

weight coeff. of right footid ParameterWeight right foottype Kernel, Double datatype (Kernel Catalog).type id kernel, double

This is the relative weight of the point labelled with right foot

527

9.1.183 KohonenMap

bitmap

class name KohonenMapcatalog name Basecatalog id baseclass id kohonenmapauthors Maurizio Mancini

This block trains a Kohonen Map (SOM, Self Organizing Map) and, given an inputvector provides both the map and the input classification as output.

Inputs

Input vectorid KohonenMapInputtype Kernel, Double matrix.type id kernel, double-matrix



A vector (single row matrix) consisting of the Kohonen Map input values. Matrix rowlength must be equal to the Kohonen Map node weights vector length.

Outputs

Output Kohonen mapid KohonenMapOutputMaptype Kernel, Labelled settype id kernel, labeled setinplace id *no*inherited id *no*

This is a lebeled set in which every element is a 2D matrix; for the n-th matrix, theelement (i,j) corresponds to the map cell (i,j) and represents the n-th weight value.

528

Output best matching nodeid KohonenMapOutputPointtype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

This is the best matching map node.

Parameters

Kohonen Mapid KohonenMapParameterMatrixtype Kernel, Double matrix.type id kernel, double-matrix

This parameter contains the Kohonen Map and cannot be edited. It allows us to easilysave and load the map.

Statusid KohonenMapParameterStatustype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:trainingrunning

domain [ 0, 2 )This is the current status of the Map.

Resetid KohonenMapParameterResettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

The map is re-initialized and re-trained.

Reset I-Searchid KohonenMapParameterResetISearchtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

The map is re-initialized to the starting state for the I-Search demo.

Rowsid KohonenMapParameterRowstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The map number of columns.

529

Columnsid KohonenMapParameterColstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The map number of columns.

Iterationsid KohonenMapParameterIterationstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The numebr of iterations performed during the training phase before switching to therunning phase.

530

9.1.184 LabelledSetExtract

bitmap

class name LabelledSetExtractcatalog name Basecatalog id baseclass id labelled set extractauthors Paolo Coletta

Extract an item from a labelled set.

Inputs

Inputid inputtype Kernel, Labelled settype id kernel, labeled set



Input labelled set from which to extract the item.

Outputs


The item extracted from the labelled set. Note that if the index (or the label) is notvalid (i.e., does not refer to any item in th set), no output is given

Labelid output labeltype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

The label of the extracted item (useful when extracting by index)

531

Parameters

Reference typeid reference typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:By labelBy index

domain [ 0, 2 )Specifies whether the item to be extracted is referenced by index or by label.

Labelid labeltype Kernel, String datatype (Kernel Catalog).type id kernel, string

Label of the item to be extracted.

Indexid indextype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Index of the item to be extracted. Index is 0-based, thus, the maximum valid index isequale to the size of the set minus 1.

532

9.1.185 LabelledSetExtractIf

bitmap

class name LabelledSetExtractIfcatalog name Basecatalog id baseclass id labelled set extract ifauthors Paolo Coletta

Extract an item from a labelled set if it matches a given condition

Inputs




Input labelled set from which to extract the item if a condition is met

Outputs

Tracked blobid output trackedtype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Blob labelid output labeltype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

533

Parameters




domain [ 0, 2 )

Pointid point doubletype Base, Point 2D doubletype id base, point 2d double

534

9.1.186 LabelledSetFeatures

bitmap

class name LabelledSetFeaturescatalog name Basecatalog id baseclass id LabeledSetFeatures-Doubleauthors Simone Ghisio

The block calculate features in a labelled set.

Inputs




Input GeometricLabelledSet

Outputs

Output Features LabelledSetid output labeled settype Kernel, Labelled settype id kernel, labeled setinplace id *no*inherited id *no*

Output Features LabelledSet

Output Features valueid output valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output Features value

535

Parameters

Output typeid absolute valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Absolute value of velocityX component of velocityY component of velocityX displacementY displacement

domain [ 0, 5 )Output type

Delta t typeid delta timetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Presentation TimeCustom Value

domain [ 0, 2 )Delta t type



domain [ 0, 2 )Type

536

9.1.187 LabelledSetInsert

bitmap

class name LabelledSetInsertcatalog name Basecatalog id baseclass id labelled set insertauthors Paolo Coletta

insert an item in a labelled set.

Inputs




The labelled set to which an item will be added

Itemid input itemtype Kernel, Generic datatypetype id kernel, generic datatyperequired required for executionread only/read write read onlyreferred as inplace *no*referred as inherited *no*

The item which will be added to the labelled set

Outputs


The labelled set with the new item inserted

537

Parameters

Labelid labeltype Kernel, String datatype (Kernel Catalog).type id kernel, string

The item will be added to the labelled set using this label

538

9.1.188 LabelledSetMerge

bitmap

class name LabelledSetMergecatalog name Basecatalog id baseclass id labelled set mergeauthors Paolo Coletta

Merge items from two (or more) labelled set. To avoid label clashes, a prefix can beadded to each incoming item. Using different prefixes for the different inputs ensures thatno label collision occurs

Inputs

Input 1id input 1type Kernel, Labelled settype id kernel, labeled set



Input labelled set # 1

Input 2id input 2type Kernel, Labelled settype id kernel, labeled set



Input labelled set # 2

539

Outputs

Outputid outputtype Kernel, Labelled settype id kernel, labeled setinplace id *no*inherited id *no*

Merged labelled set

Parameters

Num labelled setsid num labelled settype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Specifies the number of labelled sets to be merged

Prefix 1id prefix 1type Kernel, String datatype (Kernel Catalog).type id kernel, string

Prefix for labels of set # 1

Prefix 2id prefix 2type Kernel, String datatype (Kernel Catalog).type id kernel, string

Prefix for labels of set # 2

540

9.1.189 Line2DGenerator

bitmap

class name Line2DGeneratorcatalog name Basecatalog id baseclass id line2d generator int


Generates a bidimensional line that can be drawn too. The line is represented by twopoints (x1,y1)(x2,y2)

Outputs

Lineid valuetype Base, Line 2D inttype id base, line 2d intinplace id *no*inherited id *no*

The output line contains both the X and Y parameters.

Parameters


layout

Combo Box:LinePointsCoordinates



541


layout




Xid x1type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Abscissa

Yid y1type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Ordinate

Xid x2type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Abscissa

Yid y2type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Ordinate

542


layout




Matrix trasform

543

9.1.190 Line3DGenerator

bitmap

class name Line3DGeneratorcatalog name Basecatalog id baseclass id line 3d generatorauthors Simone Ghisio

Generates a tridimensional line, represented by 2 points.

Outputs

OutputLine3Did line outputtype Base, BaseGeometricLine3Doubletype id base, base geometric line 3d doubleinplace id *no*inherited id *no*

Output Line 3D

Parameters



domain [ 0, 2 )Mode

XACoordinateid xa parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate of first point

YACoordinateid ya parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

544

Y coordinate of first point

ZACoordinateid za parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate of first point

XBCoordinateid xb parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate of second point

YBCoordinateid yb parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Y coordinate of second point

ZBCoordinateid zb parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate of second point

545

9.1.191 LinearKalmanFilter

bitmap

class name LinearKalmanFiltercatalog name Basecatalog id baseclass id linear kalman filter


Filters the incoming data via a linear Kalman filter

Inputs

Input measure vectorid input measure vectortype Kernel, Double matrix.type id kernel, double-matrix



Input measure vector

Control measure vectorid input control vectortype Kernel, Double matrix.type id kernel, double-matrixrequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Control measure vector

546

Outputs

Output estimated vectorid estimated state vectortype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output estimated vector

Output estimated measure vectorid estimated measure vectortype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output estimated measure vector

Error covariance matrixid error covariance matrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Error covariance matrix

Gain matrixid gain matrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Gain matrix

Residual vectorid residual vectortype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Residual vector

547

Parameters

System state dimensionid state dimensiontype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

This value represents the dimension of the system state, i.e., the number of items of thevector that you want to estimate.

Measure dimensionid measure dimensiontype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the dimension of the measurement vector. It affects the dimension of themeasure matrix.

Control dimensionid control dimensiontype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the dimension of the contrl vector. It affects the dimension of the controlmatrix.

Filtering matrixid system matrixtype Kernel, Double matrix.type id kernel, double-matrix

Filtering matrix

Measure matrixid measure matrixtype Kernel, Double matrix.type id kernel, double-matrix

This is the matrix describing the measurement channel. The number of rwos mustbe equal to the dimension of the measure, the number of columns must be equal to thedimension of the system state.

Control matrixid control matrixtype Kernel, Double matrix.type id kernel, double-matrix

This is the matrix describing the control channel. It describes how the control vector,which is supposed to be know, affects the system state.. The control vectory input is not

548

mandatory, i.e., the block can work even if no control vector is available. In such case, thisparameter is ignored.

State noise covarianceid state noise covariance matrixtype Kernel, Double matrix.type id kernel, double-matrix

Covariance of the noise affecting system state.

Measure noise covarianceid measure noise covariance matrixtype Kernel, Double matrix.type id kernel, double-matrix

Covariance of the noise affecting the measurement channel.

Initial state estimateid initial state vectortype Kernel, Double matrix.type id kernel, double-matrix

This vector represents the initial state estimation

Initial state covarianceid initial state covariance matrixtype Kernel, Double matrix.type id kernel, double-matrix

This matrix represents the initial state error covariance

549

9.1.192 ListAdd

bitmap

class name ListAddcatalog name Basecatalog id baseclass id list addauthors Paolo Coletta

Add an item to a list.

Inputs

Input listid input listtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace Output listreferred as inherited *no*

This is the list to which an item will be added by the block

Input itemid input datatypetype Kernel, Generic datatypetype id kernel, generic datatype



This is the item which will be added to the list

Outputs

Output listid output listtype Kernel, Listtype id kernel, listinplace id Input listinherited id *no*

550

This is the list containing the added item

551

9.1.193 ListCreate

bitmap

class name ListCreatecatalog name Basecatalog id baseclass id list createauthors Paolo Coletta

Create a list from a generic datatype. The generated list will contain one item only,however, other items can be added through the ListAdd block.

Inputs




The item provided as input will becom the only element in the list

Outputs

Outputid outputtype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*

The list with one item.

552

9.1.194 ListExtract

bitmap

class name ListExtractcatalog name Basecatalog id baseclass id list extractauthors Paolo Coletta

Extract an item from a list according to the index parameter value. The input listis generic and the block extract any scalar datatype. The block works only if the indexparameter is less then the input list size.

Inputs




Input list to extract the items from.

Outputs

Indexid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Extracted generic output value

Parameters


553

Index of the item to be extracted. Note that items in a list are accessed in linear time.The index is zero-based, and is upper-bounded by the size of the list.

554

9.1.195 ListPersistency

bitmap

class name ListPersistencycatalog name Basecatalog id baseclass id list persistencyauthors Paolo Coletta

Remove items from a list if they do not persist for a specified number of frames.

Notes Persistency is computed basing on datatype equality, i.e., basing on the valueof the datatypes.

Inputs




The input list to be filtered

Outputs


The filtered list

Parameters

Min Number of Framesid min num framestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

555

Specifies the minimum number of frames that a value must be present in the input listto be propagated to the output list. A value of 1 means that no filtering occurs.

556

9.1.196 ListRemoveDuplicates

bitmap

class name ListRemoveDuplicatescatalog name Basecatalog id baseclass id list remove duplicatesauthors Paolo Coletta

Remove duplicate items from within a single list.

Notes Duplicates are checked basing on datatype equality, i.e., basing on the value ofthe datatypes.

Inputs





Outputs


The filtered list

557

9.1.197 LoadMarkers

bitmap

class name LoadMarkerscatalog name Basecatalog id baseclass id loadmarkers

authorsAlessandro FaustoPaolo Coletta

This block read the set of audio markings from file. The output is a ordered list of themarking values. This version of block do not extract the labels.

Details By default the block only outputs the first column of the file, i.e., a list of(start) times therefore a simpler file format may be accepted which just contains the firstcolumn: 0.429569 2.438095 4.121542

Notes The block expects a file in the same format as the labels exported by Audacity,e.g.: 0.429569 1.277098 Part 1 2.438095 2.948934 Part 2 4.121542 5.851429 Part 3

All times are expressed in seconds. The following types of comment are accepted //C++ - like comment # Unix-like comment ; Dos-like comment

Outputs

Markersid output markerstype Kernel, Listtype id kernel, listinplace id *no*inherited id *no*

List of markers of the file

Formatted markersid formatted markerstype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

List of markers formatted as a human readible string

558

Parameters


layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Labels(*txt)—*.txt—All files (*.*)—*.*——”

Name of the file to be read

559

9.1.198 LocalBinaryPatterns

bitmap

class name LocalBinaryPatternscatalog name Basecatalog id baseclass id local binary patterns

authorsPaolo ColettaAndrea Ricci

Calculate Local Binary Patterns from a multi-level input image

Inputs




Input Image to calculate Local Binary Patterns. The elements outside the ROI are notcomputed

Outputs

Outputid outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output Image containing the Local Binary Pattern calculated for every pixel of everychannel of the input image

560

Parameters

Number of Pixelsid number of pixelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 8 ]

The number of pixel (and thus of binary digits) used to calculate the binary patterns

Positionsid positionstype Kernel, Integer matrix.type id kernel, int-matrix

Each pixels is compared with some neighbours to compute a pattern of bits. This matrixspecifies the coordinates of the neighbours pixels with respect to the current one

Offsetid offsettype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The offset added to the difference between pixel values

561

9.1.199 Logarithm

bitmap

class name Logarithmcatalog name Basecatalog id baseclass id Logarithmauthors Gualtiero Volpe

This blocks computes the logarithm of the input value according to the specified base.

Inputs

Input valueid Inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input value: it must be a positive number.

Outputs

Output valueid Outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The computed logarithm

562

Parameters

Baseid Basetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:e210

domain [ 0, 2 ]The base for the logarithm: either e, or 2, or 10.

563

9.1.200 Lukas Kanade Tracker

bitmap

class name Lukas Kanade Trackercatalog name Basecatalog id baseclass id Lukas Kanade Trackerauthors Simone Ghisio

This block implements the iterative version of the Lucas-Kanade algorithms. It com-putes with sub-pixel accuracy new coordinates of the ’Points to track’ feature points of twoimages at time t and t+dt . Their initial coordinates are places in an array. Computedvalues of new coordinates of the feature points are stored in aniother array , that initiallycontains estimations of them (or hints), for example, based on the flow values for the pre-vious image in sequence. If there are not such hints, the ’new points’ array contains thesame initial coordinates as the old points array. The images are presented by a pyramidalstructure. The function starts operation on the highest pyramid level (smallest image) thatis specified by the ’max Level’ parameter in the centered search window. The operationfor i-th feature point on the given pyramid level finishes if: new position of the point isfound or if specified number of iteration maxIter is performed or if the intersection betweenthe pyramid layer and the search window became empty. In first two cases for non-zerolevels the new position coordinates are scaled to the next pyramid level and the operationcontinues on the next level.

Inputs




The block computes optical flow of the input image

564

Input Geometric Labelled Setid input geometric labeled settype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d double



Initial list of points to track

Outputs


List of points after optical flow processing

Load new labelled setid output lost pointstype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Request to load new labelled set because there are too many lost points

Parameters

Points To Trackid points to trackstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of features points to track

Max Levelid leveltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 10 ]

Pyramid level to start the operation.The function starts operation on the highest pyra-mid level (smallest image) that is specified by the maxLev parameter in the centered searchwindow.If the number of level is high the algorithm is slow.

565

Rateid ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Ratio between neighbouring levels (1¡Rate¡=10 ).

Window sizeid window sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Size of the square search window.

Iteration Numberid num iterationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Maximum number of algorithm iterations for each pyramid level.

Thresholdid quality leveltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Threshold value. The operation for i-th feature point on the given pyramid level finishesif new position of the point is found. ( sqrt((dxˆ2)+(dyˆ2))¡ Threshold )

LostPointid LostPointstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Maximum number of lost points after that the block generates a request to create newfeatures.

Maximum distance.id max distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Maximum distance between new and old feautures. If the difference between new andold pointis greather then this parameter the point is lost.

566

9.1.201 LukasKanade

bitmap

class name LukasKanadecatalog name Basecatalog id baseclass id LKTrackerauthors Simone Ghisio

The block implements sparse iterative version of Lucas-Kanade optical flow in pyramids.It calculates coordinates of the feature points on the current video frame given their coor-dinates on the previous frame. The function finds the coordinates with sub-pixel accuracy.- ERROR AND WARNING MESSAGE -

During Initialization Phase -CLKTracker::Init – Error while loading input image -CLKTracker::Init – Error while loading input blob. -CLKTracker::Init – Error while loadinginput list.

During Execution Phase -CLKTracker::Execute – An error occurred while loadingthe input image. -CLKTracker::Execute – An error occurred while loading the input blob.-CLKTracker::Execute – An error occurred while getting the input ipl image. : if thetransformation of EywImage in Ipl Image fail

Inputs




The input image. The block will assign significant points that will be tracked. Theinput image must be black and white, single channel, and have 8-bit depth.

567

Outputs

Output Listid output point listtype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d doubleinplace id *no*inherited id *no*

The output list of tracked points

Parameters

Input Typeid Input typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ImageImage + BlobImage + List of points

domain [ 0, 3 )Specifyng the input type. [0]Only input image, [1]Input image and blob, [2]Input image

and list of points

Points to trackid parameter point to tracktype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of point to track. It’s not used if ’Input List’ input is enabled

Lost pointsid parameter lost pointstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

It’s used to find new features when there are too many lost features. If the user doesn’twant the block to replace features, he just has to set iLost to zero.


Reset the algorithm

Refineid refinetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

568

It’s used for subpixel accuracy refinement. When it’s true cvFindCornerSubPix func-tionc of OpenCV librabry is called.

Window Sizeid Window sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:13579

domain [ 0, 5 )Half sizes of the search window

Levelid Leveltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 5 ]

Maximal pyramid level number. If 0 , pyramids are not used (single level), if 1 , twolevels are used, etc.

Distance tresholdid Distance treshtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The maximum distance over which the algorithm looses the point.

Quality Levelid Quality Leveltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Multiplier for the maxmin eigenvalue; specifies minimal accepted quality of image cor-ners.

Minimum Distanceid Minimum distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifying minimum possible distance between returned corners; Euclidian distance isused

569

9.1.202 MP3 FileReader

bitmap

class name MP3 FileReadercatalog name Basecatalog id baseclass id MP3 FileReaderauthors Alberto Massari

Reads an MP3 file

Outputs

AudioStreamid AudioStreamtype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

The audio stream

Parameters

FileNameid FileNametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


The location of the file to read

570

Buffering typeid type of bufferingtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:numsamplesbuffertimefps

domain [ 0, 3 )It specifies how the block calculates the buffer lenght. It’s possible set the dimension

according to number of samples value, buffer time duration or in frame per second.

Number of samplesid number of samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

It specifies the number of samples for each buffer. Usually 1764.

End of fileid eoftype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:StopLoop

domain [ 0, 2 )Specifies the behaviour when end of file is reached.

571

9.1.203 MagicMirror

bitmap

class name MagicMirrorcatalog name Basecatalog id baseclass id MagicMirrorauthors Mirko Demurtas

This block deforms the input image as if it was reflected by some special kinds of mirrors.Three different mirror types are provided, and the percentage of deformation due to eachsingle mirror can be specified by the user.

Inputs




Input image

Outputs

Imageid input imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image

Parameters

Neutralid neutraltype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Neutral

572

Diabloid diablotype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Diablo

Fishid fishtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Fish

Vortexid vortextype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Vortex

573

9.1.204 MagnitudePhaseFft

bitmap

class name MagnitudePhaseFftcatalog name Basecatalog id baseclass id magnitude phase fftauthors Paolo Coletta

Calculate the magnitude (or PowerSpectrum) and the phase of a Fft signal

Inputs

Input Fftid input ffttype Base, Audio FFT buffertype id base, audio fftbuffer



Input FFT signal from which to extract magnitude (or power spectrum) and phase

Outputs

Magnitude or Power Spectrumid output moduletype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Magnitude or Power Spectrum (depending on a user choice) of the FFT signal. Thismatrix has as many rows as the number of channels of the FFT. The number of columns isequal to half of the size of the FFT.

Phaseid output phasetype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

574

Phase of the FFT signal. This matrix has as many rows as the number of channels ofthe FFT. The number of columns is equal to the size of the FFT.

Parameters


layoutCombo Box:Magnitude - PhasePower Spectrum - Phase

domain [ 0, 2 )Specifies whether the output is Magnitude and Phase or Power Spectrum and Phase.

Magnitude scaleid magnitude scaletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LinearLogaritmic (Db)

domain [ 0, 2 )Specifies the scale of the module, whether linear or logaritmic.

575

9.1.205 MapColorToIntMatrix

bitmap

class name MapColorToIntMatrixcatalog name Basecatalog id baseclass id map color to int matrixauthors Andrea Ricci

Maps the colors in the input image into integer values in the output matrix

Inputs




Input Image whose colors are to be mapped. The elements outside the ROI are notcomputed

Outputs

Matrixid outputtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Output Integer Matrix receiving the mapped colors, one element for every pixel

Parameters

Default Valueid default valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The value to assign to unspecified colors

576

Number Of Colorsid number of colorstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

The number of mapped colors

Color 1id color 0type Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

This color in the input image will be mapped into the corresponding value in the outputmatrix

Value 1id value 0type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Value that will be assigned to the matrix elements where the corresponding input imagepixel has the specified color

577

9.1.206 MapMatrixToImage

bitmap

class name MapMatrixToImagecatalog name Basecatalog id baseclass id MatrixDisplayauthors Gualtiero Volpe

This block displays the input mapping by mapping its entries onto the HSV color space

Inputs

Input matrixid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



The input matrix whose entries have to mapped onto colors in the output image.

Outputs

Output imageid OutputImagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

The image whose colors correspond to the entries in the input matrix.

Parameters

Widthid Widthtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The width of the output image.

578

Heightid Heighttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The height of the output image.


layout

Combo Box:BWRGBBGRYUVYUYVUYVYI420YV12HSVRGBABGRAYUVAHSVAARGBABGRAYUVAHSV


following values:BW (1 channel: grayscale);BGR (3 channel packed: Blue, Green, Red);RGB (3 channel packed: Red, Green, Blue);YUV (3 channel packed: Y, Cb, Cr);YUYV (3 channel packed, undersampled 422: Y, Cb, Cr);UYVY (3 channel packed, undersampled 422: Y, Cb, Cr);I420 (3 channel planar, undersampled 411: Y, Cb, Cr);YV12 (3 channel planar, undersampled 411: Y, Cb, Cr);HSV (3 channel packed: Hue, Saturation, Value).

579


layout

Combo Box:8 bits per channel, unsigned16 bits per channel, unsigned16 bits per channel, signed32 bits per channel, floating-point



Modeid Interpolationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Nearest neighborLinearCubicLanczos window

domain [ 0, 4 )Horizontal Mirror

rescale valuesid Scaletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

This parameter enable or disable the scaling of matrix values. When is set to true themin and max parameter are used to define the input range, otherwise this two parametersare ignored and the matrix value are copied into the image without any scaling.

Minid Mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value in the input matrix.

580

Maxid Maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The maximum value in the input matrix.

Modeid Modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Map on HMap on SMap on V

domain [ 0, 3 )Horizontal Mirror

Hid Htype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value for the H parameter (if it is not mapped from the input matrix).

Sid Stype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value for the S parameter (if it is not mapped from the input matrix).

Vid Vtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value for the V parameter (if it is not mapped from the input matrix).

alphaid Atype Kernel, Double datatype (Kernel Catalog).type id kernel, double

alpha value

581

9.1.207 Matrix Extract

bitmap

class name Matrix Extractcatalog name Basecatalog id baseclass id matrix extract

authorsRoberto SagoleoSimone Ghisio

Extract a sub-matrix from an input matrix

Inputs

Input matrixid input matrixtype Kernel, Double matrix.type id kernel, double-matrix



Input matrix

Outputs


Output matrix

582

Parameters


layoutCombo Box:doubleinteger

domain [ 0, 2 )Domain of input and output matrix.

StartRowid start rowtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Start index of row to extract

StartColumnid start columntype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Start index of column to extract

RowSizeid size rowtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Number of row to extract. If it’s 0 nothing extract.

ColumnSizeid size columntype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Number of column to extract. If it’s 0 nothing extract.

583

9.1.208 Matrix2TimeSeries

bitmap

class name Matrix2TimeSeriescatalog name Basecatalog id baseclass id Matrix2TimeSeriesauthors Alessandro Fausto

Convert one matrix to a TimeSeries.The user can choose to generate a time series withstatic o dynamic lenght.The first case is the default mode, in the second case the TimeSerieshave dynamic leght but is always set to matrix lenght.A minimum and maximum thresholdis applied to the input value.

Inputs





Outputs

outputid outputtype Base, TemporalDatatype id base, temporal datainplace id *no*inherited id *no*

The generated TimeSeries

584

Parameters

Output typeid Output Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Static time seriesDynamic time series

domain [ 0, 2 )It specifies whether the blok generates a static time series or a dynamic time series.

Modeid Output Modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:By rowBy columnAutomatic

domain [ 0, 3 )Defines how the matrices are converted into time series: ’By row’ generate the time

series using one rows per channel. The number of samples is fixed and equal to the numberof columns. ’By column’ generate the time series using one columns per channel. Thenumber of samples is fixed and equal to the number of rows.’Automatic’ generate the timeseries using this rules . if the number of row is greater than number of column the timeseries is generated using the ’By row’ mode, otherwise is used the ’By column’ mode.

Nominal Frequencyid Nominal Frequencytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The sampling frequency of the resulting TimeSeries datatype

Range Minid Range Mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value that a sample can assume (if the input is less than this value, thisvalue will be used)

Range Maxid Range Maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

585

The maximum value that a sample can assume (if the input is more than this value,this value will be used)

Clipid Cliptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specify whether the output data is clipped in the case that it excedes the specified range

586

9.1.209 MatrixArithmeticOperations

bitmap

class name MatrixArithmeticOperationscatalog name Basecatalog id baseclass id matrix operationsauthors Simone Ghisio

Execute some operations on input matrix

Inputs

Inputid inputtype Kernel, Integer matrix.type id kernel, int-matrix




Outputs

Outputid outputtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

This is the output

587

Parameters


layoutCombo Box:IntegerDouble

domain [ 0, 2 )Defines the type of the matrix (integer or double): integer: the matrix is of integer type.

double : the matrix is of double type.

588

9.1.210 MatrixComposer

bitmap

Composer.png Composer.png

class name MatrixComposercatalog name Basecatalog id baseclass id Matrix Composerauthors Simone Ghisio

Transform a series of double value in a matrix

Inputs




Input 00 block double to matrix.

Outputs


This is the output matrix which contains the input matrices

589

Parameters


layout

Combo Box:By rowBy columnAll items at once

domain [ 0, 3 )Defines how the matrices are composed: ’By row’ fill the matrix copying the inputs

into one row per single execute. The matrix is given on output only when last row iswritten. ’By column’ fill the matrix copying the inputs into one column per single execute.The matrix is given on output only when last column is written.’All items at once’ fill thematrix copying the inputs into all items (row order). The matrix is filled and given onoutput at each activation.

rowsid Rowstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the output matrix number of row.

columnsid Columnstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the output matrix number of column.

590

9.1.211 MatrixConcatenate

bitmap

class name MatrixConcatenatecatalog name Basecatalog id baseclass id matrix concatenate

authorsPaolo ColettaRoberto Sagoleo

Places matrices one by the other one to form a bigger matrix

Inputs

Input 1id input1type Kernel, Integer matrix.type id kernel, int-matrix



This is input matrix 1

Input 2id input2type Kernel, Integer matrix.type id kernel, int-matrix



This is input matrix 2

591

Outputs


This is the output matrix which contains the input matrices

Parameters



domain [ 0, 2 )Defines the type of the output matrix (integer or double): integer: the output matrix

will be of integer values. double : the output matrix will be of double values.


layoutCombo Box:By rowBy column

domain [ 0, 2 )Defines how the matrices are placed: ’by row’ places the matrices one by the other one.

The number of columns increases, whereas the number of rows is unchanged. ’by column’places the matrices one over the other one. The number of rows increases, whereas thenumber of columns is unchanged.


Specifies the number of input matrices that the block will accept

592


layoutCombo Box:left to rightright to left

domain [ 0, 2 )Defines how the input is concatenated: ’left to right’ input matrices are concatenated

starting from the left side of output matrix; ’right to left’ input matrices are concatenatedstarting from the right side of output matrix.

593

9.1.212 MatrixExtractWithIndex

bitmap

class name MatrixExtractWithIndexcatalog name Basecatalog id baseclass id matrix extract with indexauthors Roberto Sagoleo

Extracts a 1-dimension matrix from an input matrix

Inputs




This is the input matrix from which will be extracted the 1-dimensional output matrixat the ’Index’ position

Outputs


This is the output 1-dimensional matrix extracted from the ’Index’ position

594

Parameters



domain [ 0, 2 )Defines the type of the matrix (integer or double): integer: the matrix is of integer type.

double : the matrix is of double type.


layoutCombo Box:Extracts a rowExtracts a column

domain [ 0, 2 )Defines if to extract a row or a column from the input matrix: a row : extracts a row

from the input matrix at the ’Index’ position. a column: extracts a column from the inputmatrix at the ’Index’ position.


Specifies the position of the row/column extracted

595

9.1.213 MatrixGetDescription

bitmap

class name MatrixGetDescriptioncatalog name Basecatalog id baseclass id matrix getdescriptionauthors Roberto Sagoleo

Get descriptions from the input matrix

Inputs

Input Matrixid input matrixtype Kernel, Integer matrix.type id kernel, int-matrix



This is the input Matrix from which to get the descriptions

Outputs

Information (sing.)id output single informationtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Information about the input matrix (sing.)

596

Parameters

Input typeid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )Defines the type of the input matrix (integer or double): integer: the input matrix

should be of integer values. double : the input matrix should be of double values.

single or multiple descriptionid description output modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:SingleMultiple

domain [ 0, 2 )Get single or multiple descritpion.

Informationid single informationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Number of rows (sing.)Number of columns (sing.)Type of entry (sing.)

domain [ 0, 3 )Information about the input matrix.

597

9.1.214 MatrixGetItem

bitmap

class name MatrixGetItemcatalog name Basecatalog id baseclass id GetItemauthors Barbara Mazzarino


Inputs

Input GetItemid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



Input GetItem

Outputs

Output GetItemid OutputItemtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output GetItem

Parameters

Row Indexid RowNumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )


598

Column Indexid ColNumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

position in column number of the Item to extract

Domainid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )Domain

599

9.1.215 MatrixInvert

bitmap

class name MatrixInvertcatalog name Basecatalog id baseclass id MatrixInvertauthors Nguyen, Dinh Quan

This block computes the inverse of the input matrix.

Inputs

Input matrixid Intype Kernel, Double matrix.type id kernel, double-matrix



The input matrix

Outputs

Output matrixid Outtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The inversed matrix

600

9.1.216 MatrixLogarithmicRescaler

bitmapresc log.png resc log.png

class name MatrixLogarithmicRescalercatalog name Basecatalog id baseclass id Matrix resc logauthors Simone Ghisio

Compute lot of operations on the input matrix

Inputs

Input Matrixid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



The input Matrix

Centroidid Centroidtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Centroid

Outputs

ciaoid OutMatrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

601

ciao

Parameters

Octave dimid OctaveDimtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of values in one octave

Octave numberid OctaveNumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of octaves to analyse

602

9.1.217 MatrixProgress - double

bitmap

class name MatrixProgress - doublecatalog name Basecatalog id baseclass id MatrixProgressDoubleauthors Simone Ghisio

Modify a matrix according to parameter string.

Inputs

InputMatrixid input matrixtype Kernel, Double matrix.type id kernel, double-matrix



Input Matrix

Outputs

OutputMatrixid output matrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output Matrix

OutputBoolid output booltype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Output Bool

603

Parameters

stringid parameter stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string

string

604

9.1.218 MatrixProgress - int

bitmap

class name MatrixProgress - intcatalog name Basecatalog id baseclass id MatrixProgressIntauthors Simone Ghisio

Modify a matrix according to parameter string.

Inputs

InputMatrixid input matrixtype Kernel, Integer matrix.type id kernel, int-matrix



Input Matrix

Outputs

OutputMatrixid output matrixtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Output Matrix

OutputBoolid output booltype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Output Bool

605

Parameters

stringid parameter stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string

string

606

9.1.219 MatrixRescalerLog

bitmap

class name MatrixRescalerLogcatalog name Basecatalog id baseclass id MatrixRescalerLogauthors Simone Ghisio

This block rescales its input matrix in log scale

Inputs

Input Matrixid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



The input Matrix

Centroidid Centroidtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Centroid

607

Outputs

Outputid OutMatrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output

Parameters

Octave dimid OctaveDimtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of values in one octave

Octave numberid OctaveNumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of octaves to analyse

608

9.1.220 MatrixSetItem

bitmap

class name MatrixSetItemcatalog name Basecatalog id baseclass id SetItemauthors Barbara Mazzarino

This block insert, from a matrix, an item in a specific position

Inputs

Input matrixid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



The input matrix whose items have to be set.

Outputs

Output matrixid OutputMatrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The output matrix whose values have been set.

Parameters

Row idexid RowNumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int


609

Column indexid ColNumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

position in column number of the Item to extract

Type name into choice step into setitemid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 1 ]Tyep description, choice step into SetItem

Value name into SetItemid Valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Value description into SetItem

610

9.1.221 MatrixStatDouble

bitmap

class name MatrixStatDoublecatalog name Basecatalog id baseclass id matrix stat op doubleauthors Simone Ghisio

Evaluate matrix elements along rows, columns, or entire input

Details The block evaluates some operations on input matrix. The block can find themaximum or minimum value in the matrix, according with SUM OVER and OPERATIONTYPE parameters. This block accepts floating point inputs (i.e., matrices with floatingpoint items).

Inputs

Input Matrixid matrixtype Kernel, Double matrix.type id kernel, double-matrix



Matrix to be evaluated

Outputs

Output Matrixid matrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Evaluation of the columns/rows of the input matrix

611

Rowid rowtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Row index of max/min/percent value in the matrix

Columnid columntype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Column index of max/min/percent value in the matrix

Parameters

Evaluate Overid evaluate overtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RowsColumnsAll

domain [ 0, 3 )Specifies whether to evaluate items overs rows, columns, or all items

Operation typeid operation typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:MaxMinPercent


612

9.1.222 MatrixStatInt

bitmap

class name MatrixStatIntcatalog name Basecatalog id baseclass id matrix stat op intauthors Simone Ghisio

Evaluate matrix elements along rows, columns, or entire input

Details The block evaluates some operations on input matrix. The block can find themaximum or minimum value in the matrix, according with SUM OVER and OPERATIONTYPE parameters. This block accepts integer inputs (i.e., matrices with integer items).

Inputs

Input Matrixid matrixtype Kernel, Integer matrix.type id kernel, int-matrix



Matrix to be evaluated

Outputs

Output Matrixid matrixtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Evaluation of the columns/rows of the input matrix

613

Rowid rowtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Row index of max/min/percent value in the matrix

Columnid columntype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Column index of max/min/percent value in the matrix

Parameters

Evaluate Overid evaluate overtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout



Operation typeid operation typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:MaxMinPercent


614

9.1.223 MatrixSumDouble

bitmap

class name MatrixSumDoublecatalog name Basecatalog id baseclass id matrix sum doubleauthors Paolo Coletta

Sum matrix elements along rows, columns, or entire input

Details The MatrixSum block sums the elements of an M-by-N input matrix alongits rows, its columns, or over all its elements. When the Sum over parameter is set toRows, the block sums across the elements of each row and outputs the resulting M-by-1matrix. A length-N 1-D vector input is treated as a 1-by-N matrix When the Sum overparameter is set to Columns, the block sums down the elements of each column and outputsthe resulting 1-by-N matrix. A length-M 1-D vector input is treated as a M-by-1 matrix.When the Sum over parameter is set to All, the block sums all the elements of the inputtogether and outputs the resulting scalar. This block accepts floating point inputs (i.e.,matrices with floating point items).

Inputs

Input Matrixid matrixtype Kernel, Double matrix.type id kernel, double-matrix



Matrix to be summed

Outputs

Output Vectorid matrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The sum of the columns/rows of the input matrix

615

Parameters

Sum Overid sum overtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 3 )Specifies whether to sum items overs rows, columns, or all items

StartIndexid begintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Start index of sum

FinalIndexid endtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Final index of sum

616

9.1.224 MatrixSumInt

bitmap

class name MatrixSumIntcatalog name Basecatalog id baseclass id matrix sum intauthors Paolo Coletta

Sum matrix elements along rows, columns, or entire input

Details The MatrixSum block sums the elements of an M-by-N input matrix alongits rows, its columns, or over all its elements. When the Sum over parameter is set toRows, the block sums across the elements of each row and outputs the resulting M-by-1matrix. A length-N 1-D vector input is treated as a 1-by-N matrix When the Sum overparameter is set to Columns, the block sums down the elements of each column and outputsthe resulting 1-by-N matrix. A length-M 1-D vector input is treated as a M-by-1 matrix.When the Sum over parameter is set to All, the block sums all the elements of the inputtogether and outputs the resulting scalar. This block accepts integer inputs (i.e., matriceswith integer items).

Inputs

Input Matrixid matrixtype Kernel, Integer matrix.type id kernel, int-matrix



Matrix to be summed

Outputs

Output Vectorid matrixtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

The sum of the columns/rows of the input matrix

617

Parameters

Sum Overid sum overtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 3 )Specifies whether to sum items overs rows, columns, or all items

StartIndexid begintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Start index of sum

FinalIndexid endtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Final index of sum

618

9.1.225 MatrixToImage - double

bitmap

class name MatrixToImage - doublecatalog name Basecatalog id baseclass id double matrix to image


Converts a double matrix to an image

Inputs

Input matrixid input video streamtype Kernel, Double matrix.type id kernel, double-matrix



Input matrix which will be converted to a BW image

Outputs

Immagineid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Immagine

619

Parameters


layout




Region Of Interestid roitype Base, Roi 2D inttype id base, roi2d int

A rectangle in the image specifying which part of the image is the used one. Use (0;0;0;0)or (0;0;sizeX;sizeY) to mean the whole image. ROIs extending outside the image boundswill be clipped.

620

9.1.226 MatrixToImage - int

bitmap

class name MatrixToImage - intcatalog name Basecatalog id baseclass id int matrix to image


Converts an integer matrix to an image

Inputs

Input matrixid input video streamtype Kernel, Integer matrix.type id kernel, int-matrix



Input matrix which will be converted to a BW image

Outputs

Immagineid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Immagine

621

Parameters


layout




Region Of Interestid roitype Base, Roi 2D inttype id base, roi2d int

A rectangle in the image specifying which part of the image is the used one. Use (0;0;0;0)or (0;0;sizeX;sizeY) to mean the whole image. ROIs extending outside the image boundswill be clipped.

622

9.1.227 MaxCrossCorrelation

bitmap

class name MaxCrossCorrelationcatalog name Basecatalog id baseclass id max cross correlationauthors Alberto Massari

Return the maximum index of similarity between two buffers, and the offset betweenthem

Inputs

Input1 bufferid input buffer1type Kernel, Generic datatypetype id kernel, generic datatype



First buffer


Input2 bufferid input buffer2type Kernel, Generic datatypetype id kernel, generic datatyperequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Second buffer


623

Outputs

Maximum correlation indexid correlation indextype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The maximum correlation index found by sliding the second buffer over the first one

Offsetid correlation offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

The offset that had to be applied to the second buffer to obtain the maximum correlationindex

Parameters

Window sizeid maximum lagtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

This is the maximum offset that will be used when searching for the maximum correla-tion

624

9.1.228 MaxInVector

bitmap

class name MaxInVectorcatalog name Basecatalog id baseclass id MaxInVectorauthors Barbara Mazzarino


Inputs

input GetItemid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



Input GetItem

Outputs

Output GetItemid OutputIndextype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Outpu GetItem

Outpu GetiItemid OutputMaxtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Outpu GetItem

625

Parameters

Row Indexid ParamIndextype Kernel, Int datatype (Kernel Catalog).type id kernel, int


626

9.1.229 MeanFilter

bitmap

class name MeanFiltercatalog name Basecatalog id baseclass id MeanFilterauthors Mirko Demurtas

This block compute mean filter on image

Inputs




Input Geometric

Outputs

Areaid Outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Area of Geometric

Parameters

Window Sizeid WindowSizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Window Size

627

9.1.230 MediafileReader

bitmap

class name MediafileReadercatalog name Basecatalog id baseclass id media file readerauthors Massimiliano Peri


This block open audio/video files

Outputs

Output videoid video outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output video

Output Audioid audio outputtype Base, PCMAudioBuffertype id base, pcm audio bufferinplace id *no*inherited id *no*

Output audio

Parameters

Filenameid media filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


628

Filepath of media file. An empty filename is allowed; the corresponding video output isblack, the corresponding audio output is silence

Media typeid media typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Audio and VideoVideoAudio

domain [ 0, 3 )Media type

Get Properies from filesid get properties from filestype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Get Properies from files

Activation modeid activation modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:PollingOn audio clock inputOn absolute frame positionOn normalized frame positionOn time position

domain [ 0, 5 )Activation mode:Polling: the block uses the EyesWeb clock to activate. The polling period depends on

the framerate of the media fileOn audio clock input: the block activates according to an input clock (which is extracted

from an audio signal). The output audio buffer size, if audio is enabled, is related to theinput clock

On absolute frame position: the block activates according to an input number which isinterpreted as the frame index

On normalized frame position: the block activates according to an input floatin-pointnumber which is interpreted as the normalized frame index (i.e., 0.0 is beginning of file, 1.0is end of file)

On time position: the block activates according to an input time value which is inter-preted as the position in the file

629

Out of bound managementid out of bound managementtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:LoopKeep last frameBlackNo output

domain [ 0, 4 )Out of bound management

No audio on freeze/pauseid no audio on freezetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

No audio on freeze/pause

Markings unitid markings unittype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:FrameTime

domain [ 0, 2 )Markings unit of measure

Markinid markintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Beginning of fileCustom

domain [ 0, 2 )Markin

Markinid markin valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Markin position

630

Markoutid markouttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:End of fileCustom

domain [ 0, 2 )Markout

Markoutid markout valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Markout position

Markoutid file limitstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:MarkingsWhole file

domain [ 0, 2 )Markout

First markinid first markintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Same as markinBeginning of fileCustom

domain [ 0, 3 )First markin

First markinid first markin valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

First markin position (in frame units)

631

Enable text trackid enable text tracktype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable text track

Enable metadataid enable metadatatype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable metadata

Output datatype infoid image data typetype Kernel, StringPairtype id kernel, string pairlayout

Output Datatype info





layout


domain [ 0, 4 )

632

Pixel model of the image. Specifies the number of bits used for each channel, hence thecolor definition. May assume one of the following values:

8 bits unsigned integer;16 bits unsigned integer;16 bits signed integer;32 bits floating point.


layout




633

Number of audio channelid num audio channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of audio channel

PCMSampleFormatid sample formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 11 )Specifies the format of PCM samples.

Inherited from audio clock inputid inherited from audio clock inputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Inherit audio sample rate and audio buffer size from audio clock input

Audio sampling rateid sampling ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Audio sampling rate

Audio buffer sizeid audio buffer sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Audio buffer size

634

9.1.231 MediafileWriter

bitmap

class name MediafileWritercatalog name Basecatalog id baseclass id media file writerauthors Massimiliano Peri


This block writes to file the input audio/video streams

Inputs

Videoid v inputtype Kernel, Generic datatypetype id kernel, generic datatype



video input stream

Required interfacesbase, memory buffer

Input Audioid a inputtype Kernel, Generic datatypetype id kernel, generic datatype



Input audio

635

Required interfacesbase, pcm conversion kernel, conversion base, memory buffer

Parameters

Filenameid media filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true

Filepath of media file. An empty filename is allowed; No file will be written

Media typeid media typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Audio and VideoVideoAudio

domain [ 0, 3 )Media type

Metadata - titleid titletype Kernel, String datatype (Kernel Catalog).type id kernel, string

Title property of the file

Metadata - authorid authortype Kernel, String datatype (Kernel Catalog).type id kernel, string

Author property of the file

Metadata - copyrightid copyrighttype Kernel, String datatype (Kernel Catalog).type id kernel, string

Copyright property of the file

636

Metadata - commentid commenttype Kernel, String datatype (Kernel Catalog).type id kernel, string

Comment property of the file

Metadata - albumid albumtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Album property of the file

Metadata - trackid tracktype Kernel, String datatype (Kernel Catalog).type id kernel, string

Track property of the file [ID3 tags]

Metadata - genreid genretype Kernel, String datatype (Kernel Catalog).type id kernel, string

Genre property of the file [ID3 tags]

Metadata - yearid yeartype Kernel, String datatype (Kernel Catalog).type id kernel, string

Year property of the file [ID3 tags]

Get Properties from filesid get properties from filestype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Get Properties from files

Recordid rectype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Start record to file

Pauseid pausetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

637

Temporarly pause record operation

Stopid stoptype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Stop the recording operation and close the file

Recording statusid recordingtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RecordingPausedStoppped

domain [ 0, 3 )Recording status

Presetsid presetstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:MPEG 1 (A/V)MPEG 2 (A/V)H264 IPHONE (A/V)Mp3 (A)Custom from file

domain [ 0, 5 )Presets

638

File formatid file formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:a64ac3adtsaiffamrasfassasf streamauaviavm2bitcafcavsvideocrcdauddiracdnxhddtsdveac3ffmffmetadatafilmstripflacflvframecrcframemd5g722g723 1gifgxfh261h263h264image2image2pipeipodivflatmm4vmd5matroskamatroskamicrodvdmjpegmlpmmfmovmp2mp3mp4mpegvcdmpeg1videodvdsvcdmpeg2videovobmpegtsmpjpegmxfmxf d10nullnutoggalawmulawf64bef64lef32bef32les32bes32les24bes24les16bes16les8u32beu32leu24beu24leu16beu16leu8psprawvideormRoQrsortprtspsapsegmentsoxspdifsrtswf3g23gptruehdrcvvocwavwebmwtvyuv4mpegpipe

domain [ 0, 108 )

639

File format

640

Video codecid video codectype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:a64multi - Multicolor charset for Commodore 64a64multi5 - Multicolor charset for Commodore 64, extended with 5th color (colram)amv - amvasv1 - ASUS V1asv2 - ASUS V2bmp - BMP imagednxhd - VC3/DNxHDdpx - DPX imagedvvideo - DV (Digital Video)ffv1 - FFmpeg video codec #1ffvhuff - Huffyuv FFmpeg variantflashsv - Flash Screen Videoflashsv2 - Flash Screen Video Version 2flv - Flash Video (FLV) / Sorenson Spark / Sorenson H.263gif - GIF (Graphics Interchange Format)h261 - H.261h263 - H.263 / H.263-1996h263p - H.263+ / H.263-1998 / H.263 version 2huffyuv - Huffyuv / HuffYUVj2k - JPEG 2000jpegls - JPEG-LSljpeg - Lossless JPEGmjpeg - MJPEG (Motion JPEG)mpeg1video - MPEG-1 videompeg2video - MPEG-2 videompeg4 - MPEG-4 part 2msmpeg4v2 - MPEG-4 part 2 Microsoft variant version 2msmpeg4 - MPEG-4 part 2 Microsoft variant version 3msvideo1 - Microsoft Video-1pam - PAM (Portable AnyMap) imagepbm - PBM (Portable BitMap) imagepcx - PC Paintbrush PCX imagepgm - PGM (Portable GrayMap) imagepgmyuv - PGMYUV (Portable GrayMap YUV) imagepng - PNG imageppm - PPM (Portable PixelMap) imageqtrle - QuickTime Animation (RLE) videorawvideo - raw videoroqvideo - id RoQ videorv10 - RealVideo 1.0rv20 - RealVideo 2.0sgi - SGI imagesnow - Snowsvq1 - Sorenson Vector Quantizer 1 / Sorenson Video 1 / SVQ1targa - Truevision Targa imagetiff - TIFF imagev210 - Uncompressed 4:2:2 10-bitwmv1 - Windows Media Video 7wmv2 - Windows Media Video 8zlib - LCL (LossLess Codec Library) ZLIBzmbv - Zip Motion Blocks Videolibschroedinger - libschroedinger Dirac 2.2libtheora - libtheora Theoralibvpx - libvpx VP8libx264 - libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10libxavs - libxavs - the Chinese Audio Video Standard Encoderlibxvid - libxvidcore MPEG-4 part 2

domain [ 0, 57 )

641

Video Codec

Video framerateid video frameratetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CustomPAL 25fpsNTSC 30fps

domain [ 0, 3 )Select the framerate of the video stream. If Custom is choosen, then the Framerate

num/denum parameters are used to specify the framerate

Video framerate numid video framerate numtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

If custom mode is used for the framerate, then the framerate is specified through thenum/denum. E.g., 25 frames per second are expressed as 1 / 25, hence num(erator) is 1

Video framerate denumid video framerate denumtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

If custom mode is used for the framerate, then the framerate is specified through thenum/denum. E.g., 25 frames per second are expressed as 1 / 25, hence denum(erator) is 25

Video bitrateid video bitratetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Video bitrate in bits per second

Video size modeid size modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Same as inputUser specified

domain [ 0, 2 )Specifies whether the videosize is the same of the input image, or is user-specified. In

the former case the ’Image Size’ parameter is ignored.

642





layout



the aspectRatio is not preserved, and the source image is stretched or shrinked to coverall available space. In the other cases, the aspect ratio is (or might be) preserved, thus ablack frame might be needed on the horizontal or vertical side to cover the unused space.This enumerator specifies where to place such black frame. Since the user might not knowin advance whether letterboxing will place mattes above/below or left/right, each modespecifies how to behave in both cases. As an example, the letterbox mode left-middle meansthat if the image needs mattes on the sides, the image will be put to the extreme left, and

643

the matte will span the right side; if the image needs mattes above/below, the image willbe vertically centered. Hence, the mode is made of two terms, the first referring to thehorizontal centering of the image, the second referring to the vertical centering. Horizontalcentering may assume values none, left, center, or right. Vertical centering may assumevalues none, top, middle, or bottom. The term none means that if letterboxing is neededon that direction, than the image is stretched to fill the whole size. E.g., elmNoneTopmeans that is image is thinner than the destination rect, than no letterboxing is appliedand the image is stretched horizontally. However, it the image is larger than the destinationrect, than letterboxing is applied by putting the image on the top and a single matte below.

644

Audio codecid audio codectype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:aac - Advanced Audio Codingac3 - ATSC A/52A (AC-3)ac3 fixed - ATSC A/52A (AC-3)alac - ALAC (Apple Lossless Audio Codec)dca - dcaeac3 - ATSC A/52 E-AC-3flac - FLAC (Free Lossless Audio Codec)g723 1 - G.723.1mp2 - MP2 (MPEG audio layer 2)nellymoser - Nellymoser Asaoreal 144 - RealAudio 1.0 (14.4K) encodersonic - Sonicsonicls - Sonic losslessvorbis - Vorbiswmav1 - Windows Media Audio 1wmav2 - Windows Media Audio 2pcm alaw - PCM A-lawpcm f32be - PCM 32-bit floating point big-endianpcm f32le - PCM 32-bit floating point little-endianpcm f64be - PCM 64-bit floating point big-endianpcm f64le - PCM 64-bit floating point little-endianpcm mulaw - PCM mu-lawpcm s8 - PCM signed 8-bitpcm s16be - PCM signed 16-bit big-endianpcm s16le - PCM signed 16-bit little-endianpcm s24be - PCM signed 24-bit big-endianpcm s24daud - PCM D-Cinema audio signed 24-bitpcm s24le - PCM signed 24-bit little-endianpcm s32be - PCM signed 32-bit big-endianpcm s32le - PCM signed 32-bit little-endianpcm u8 - PCM unsigned 8-bitpcm u16be - PCM unsigned 16-bit big-endianpcm u16le - PCM unsigned 16-bit little-endianpcm u24be - PCM unsigned 24-bit big-endianpcm u24le - PCM unsigned 24-bit little-endianpcm u32be - PCM unsigned 32-bit big-endianpcm u32le - PCM unsigned 32-bit little-endianpcm zork - PCM Zorkroq dpcm - id RoQ DPCMadpcm adx - SEGA CRI ADX ADPCMg722 - G.722 ADPCMg726 - G.726 ADPCMadpcm ima qt - ADPCM IMA QuickTimeadpcm ima wav - ADPCM IMA WAVadpcm ms - ADPCM Microsoftadpcm swf - ADPCM Shockwave Flashadpcm yamaha - ADPCM Yamahalibgsm - libgsm GSMlibgsm ms - libgsm GSM Microsoft variantlibmp3lame - libmp3lame MP3 (MPEG audio layer 3)libopencore amrnb - OpenCORE Adaptive Multi-Rate (AMR) Narrow-Bandlibspeex - libspeex Speex Encoderlibvo aacenc - Android VisualOn AAClibvo amrwbenc - Android VisualOn Adaptive Multi-Rate (AMR) Wide-Bandlibvorbis - libvorbis Vorbis

domain [ 0, 55 )

645

Audio Codec

Audio bitrateid audio bitratetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Audio bitrate in bits per second

Audio samplarateid audio sampleratetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Audio samplerate in samples per second

Audio channelsid num audio channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of audio channels

Audio sample formatid audio sample formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Auto8bits unsigned16bits signed16bits signed32bits float64bits float

domain [ 0, 6 )Specifies the audio sample format. Use 16 bits signed for maximum compatibility; if

Auto is specified, then the type is selected basing on the input format

646

9.1.232 MemoryBufferSize

bitmap

class name MemoryBufferSizecatalog name Basecatalog id baseclass id get memory buffer sizeauthors Paolo Coletta

Gets the size, in bytes, of any datatype supporting the IMEmoryBuffer interface (e.g.,Image, Raw Data)

Inputs

Input Datatypeid inputtype Kernel, Generic datatypetype id kernel, generic datatype



The generic input datatype supporting the IMemoryBuffer interface

Required interfacesbase, memory buffer

Outputs

Sizeid outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

The size, in bytes, of the input datatype.

647

9.1.233 MessageField

bitmap

class name MessageFieldcatalog name Basecatalog id baseclass id MessageFieldauthors Marzia Simonetti

This block extracts a MIDI message field

Inputs

Message Field Input Nameid Inputtype Base, MIDItype id base, midi



Message Field Input Name Description

Outputs

Message Field Output Nameid Outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Message Field Output Name Description

648

Parameters

Choiceid Choice Fieldtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Single FieldAll Field

domain [ 0, 1 ]Choice Description

Message Field for Midiid Message Fieldtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Status byteBite1Bite2ChannelMessage Type

domain [ 0, 3 ]Message Field for Midi Description

649

9.1.234 MessageFilter

bitmap

class name MessageFiltercatalog name Basecatalog id baseclass id MessageFilterauthors Marzia Simonetti

This block filters a MIDI message

Inputs

Message Filter Inputid Inputtype Base, MIDItype id base, midi



Message Filter Input Description

Outputs

Message Filter Outputid Outputtype Base, MIDItype id base, midiinplace id *no*inherited id *no*

Message Filter Output Description

650

Parameters

Message Filter Filter Modeid Filter Modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Filter MatchingPass MatchingFilter AllFilter Nothing

domain [ 0, 3 ]Message Filter Filter Mode Description

Message Filter Channel RTid Channel/RT functiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:IgnoreUse

domain [ 0, 1 ]Message Filter Channel RT Description

Message Filter Channelid Channeltype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 15 ]

Message Filter Channel Description

Message Filter Message Typeid Message Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 1 ]Message Filter Message Type Description

651

Message Filter Message Type Valid Message Type Valtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Note OffNote OnKey After TouchControl ChangeChan After TouchPitch BendReal Time Message

domain [ 0, 6 ]Message Filter Message Type Val Description

Message Filter Bite 1id Bite 1type Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 1 ]Message Filter Bite 1 Description

Message Filter Bite 1 Valid Bite 1 Valtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 127 ]

Message Filter Bite 1 Val Description

Message Filter Bite 2id Bite 2type Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 1 ]Message Filter Bite 2 Description

652

Message Filter Bite 2 Valid Bite 2 Valtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 127 ]

Message Filter Bite 2 Val Description

653

9.1.235 MessageGenerator

bitmap

class name MessageGeneratorcatalog name Basecatalog id baseclass id MessageGeneratorauthors Giovanna Varni

This block allows to manually generate some midi messages. Message type must bespecified, it can be choosen between: Note Off, Note On, Polyphonic key pressure, ControlChange, Program Change, Channel pressure, Pitch Bend and Real Time Message. Then itis possible to specify the values of the two byte message’s payload. Midi channel number(between 1 and 16) for the message to be generated must also be specified so that messagewill affect only the specified midi channel. Channel number can also be set to ”ALL” toaffect all midi channels at the same time.

Notes The block checks the midi channel number and, if the value is between 1 and16 it creates the message for the specified channel and sends it out; if the midi channelnumber instead is set to ”ALL” the block creates and sends trough the output pin sixteenmidi messages, one for each midi channel. – REMARKS – If channel number is set to”ALL” the block schedules itself sixteen times. If message’s payload or type change beforethe block is scheduled completely, it may not works properly.

Inputs




Generic Input

654

Outputs

Midi messageid Outputtype Base, MIDItype id base, midiinplace id *no*inherited id *no*

Output is a midi message

Parameters

PatchStartid PatchStarttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

PatchStart

Syncid Synctype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ExternalPeriodAbsolutePeriodic Absolute

domain [ 0, 3 ]Sync

Type of midi messageid Message Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Note OffNote OnPolyphonic key pressureControl ChangeProgram ChangeChannel pressurePitch BendReal Time Message

domain [ 0, 6 ]This indicates the type of midi message

655

Number of channelid Channeltype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ALL12345678910111213141516

domain [ 0, 16 ]1 - 16: The message is sent to the specified channel. ”ALL”: The message is sent to all

sixteen midi channels.

First byteid Byte 1type Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 127 ]

First byte

Second byteid Byte 2type Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 127 ]

Second byte

656

9.1.236 MinLeftRight

bitmap

class name MinLeftRightcatalog name Basecatalog id baseclass id MinLeftRightauthors Mirko Demurtas

Extract the position of the lowest extremes

Inputs

Input Imageid input matrixtype Kernel, Integer matrix.type id kernel, int-matrix



Input Image

Outputs

Pos Minid output matrixtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Pos Min

657

9.1.237 Monostable

bitmap

class name Monostablecatalog name Basecatalog id baseclass id Monostableauthors Simone Ghisio

This block realize monostable component

Inputs

GenericInputid Input Gnerictype Kernel, Generic datatypetype id kernel, generic datatype



Generic input that set monostable

Outputs

Outputid OutputMonostabletype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Output of monostable

Parameters

Timeid ParameterDurationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Time of high level

658

9.1.238 MoveAroundPoint

bitmap

class name MoveAroundPointcatalog name Basecatalog id baseclass id movearoundpointauthors Simone Ghisio

This block moves the output point on a circle builded around the input point.Outputpoint is pushed off by given points in the space.

Inputs

InputPointid input pointtype Base, Point 2D doubletype id base, point 2d double



Input Point

Outputs

OutputPointid output pointtype Base, Point 2D doubletype id base, point 2d doubleinplace id *no*inherited id *no*

Output Point

Parameters

Radiusid radiustype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Radius of the circle around input point.

659

ResetAngleid angletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Try to reset the angle between input point and output point to a given value. (indegrees)

RangeAngleid rangetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Angle where block search maximum distance form points.

Stepid steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The algorithm searches maximum distance from given point in RangeAngle every ’step’value degree

PointsMatrixid matrixtype Kernel, Double matrix.type id kernel, double-matrix

Matrix of points that pushed off output point.


Reset to custom angle in degrees

660

9.1.239 MoveImageRoi

bitmap

class name MoveImageRoicatalog name Basecatalog id baseclass id move image roi


This block extracts the given region from the input image. The extracted image isinserted into the output image in the position provided by the user.

Notes The source region can be specified by means of the SetROI block

Inputs




Input imageThe ROI of the input image is the source rectangle

Outputs


This image contain a copy of the image ROI placed at specified position

661

Parameters

Reference pointid Modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CenterTop leftBottom leftTop rightBottom right

domain [ 0, 5 )This parameter select what point of the rectangle is set to the coordinate provided by

the user

Reference point typeid ReferencePositionTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Separated integer X and YSeparated floating point X and Y(x,y) integer coordinate(x,y) Floating point

domain [ 0, 4 )Specifies whether to use integer or floating-point coordinatetes and wheter to use two

separated values (one for X and other for Y coordinates) or bidimensional point datatype.Integercoordinates must be contained inside the boundaries of the first input image. Floating-pointcoordinates are normalized in the range [0.0, 1.0] with respect to the size of the input image.

background colorid BgColortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

This color, specified in the RGB model, is used to fill the background of the outputimage.

Set ROIid SetOutputROItype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If this parameter is enabled the ROI of the output image surround the boundaries ofthe moved image ROI otherwise the ROI is not set.

662

Reference point (X,Y)id Positiontype Base, Point 2D doubletype id base, point 2d double

Horizontal and vertical position of the insertion point, normalized in the range [0.0, 1.0]with respect to the width and height of the input image.

663

9.1.240 Multi-ChannelThreshold

bitmap

class name Multi-ChannelThresholdcatalog name Basecatalog id baseclass id audio threshold

authors

Andrea RicciMassimiliano PeriPaolo ColettaAlberto Massari

Detects wether the audio signal has gone over a specified threshold; provides the samplewhere the threshold has been exceeded

Inputs



read only/read write read writereferred as inplace *no*referred as inherited Audio output sample

This is the audio stream where the threshold overcoming is searched for. Event if thismight also be a multichannel audio stream, only one channel is analized when looking forthe threshold (the channel is specified via the parameters of the block).


Outputs

Audio output sampleid output sampletype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Audio input streaminherited id *no*

The audio sample that begins at the sample where the threshold has been crossed.

664

Over-threshold valueid output valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Value of the first sample that exceeded the threshold. This is the original value, even ifthe block is working in absolute (unsigned) mode. That is, it may also be a negative value.


Index of the first sample that exceeded the threshold. Note that this output, as well asthe ”over-threshold value” output, is generated only when the threshold is exceeded. If thethreshold is not exceeded, no output is generated.

Sample Channelid output sample channeltype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Index of the channel that exceeded the threshold. Note that this output, as well as the”over-threshold value” output, is generated only when the threshold is exceeded. If thethreshold is not exceeded, no output is generated.

Parameters


Value to be compared to each sample in the specified channel.


layout

Combo Box:BothUpDown

domain [ 0, 3 )

665

Direction in which the overcoming must occur for this block to generate an output. Ifdirection is ”Up” then an output is generated only when the sample values is bigger orequal than the threshold and the previous sample value is less than the threshold. The”Down” direction mean that a sample is less or equal than the threshold and the previousone is bigger than the threshold. The ”Both” direction occurs in both cases.

Sign modeid signmodetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Absolute valueSigned value (original value)

domain [ 0, 2 )This parameter specifies wether the value of the sample is analyzed as it is, or if it

absolute value is kept into account.

Sample delayid sample offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of samples after the point where the threshold was crossed from which theoutput sample will be extracted. It can be a negative number.

Under-threshold samplesid sample offset outtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

The output audio sample will contain at most N consecutive samples that are belowthe given threshold, after which it will be silenced; when N==0, the original audio will bereported

Sample Lengthid sample lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( 0, +infinity )

This value specifies the number of samples that will be extracted into the output audiobuffer, starting at the sample position where the threshold has been crossed.

Normalize output signalid normalize sampletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

666

Specifies whether the output signal will be normalized, so that its energy will be equalto 1

667

9.1.241 MultidimensionalSpace

bitmap

class name MultidimensionalSpacecatalog name Basecatalog id baseclass id MultidimensionalSpaceauthors Gualtiero Volpe

This block handles a multidimensional space by keeping and returning the current po-sition in it and by updating the current position on the basis of the incoming increments.

Inputs

id InputIncrementstype Kernel, Double matrix.type id kernel, double-matrix



id InitialPositiontype Kernel, Double matrix.type id kernel, double-matrix



Outputs

id CurrentPositiontype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

668

Parameters

id UseInitialPostype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

id Resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

669

9.1.242 MultipleListsRemoveDuplicates

bitmap

class name MultipleListsRemoveDuplicatescatalog name Basecatalog id baseclass id multiple lists remove duplicatesauthors Paolo Coletta

Remove items from multiple lists in order to ensure that there are no duplicates values.

Notes Duplicates are checked basing on datatype equality, i.e., basing on the value ofthe datatypes.

Inputs

Inputid input 0type Kernel, Listtype id kernel, list



Inputid input 1type Kernel, Listtype id kernel, listrequired required for executionread only/read write read writereferred as inplace Outputreferred as inherited *no*

Outputs

Outputid output 0type Kernel, Listtype id kernel, listinplace id Inputinherited id *no*

670

Outputid output 1type Kernel, Listtype id kernel, listinplace id Inputinherited id *no*

Parameters

Number of listsid num liststype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )


671

9.1.243 NoiseReduction

bitmap reduction.png reduction.png

class name NoiseReductioncatalog name Basecatalog id baseclass id noise reductionauthors Alberto Massari

Removes background noise from the audio input buffer using IPP functions

Inputs

Input bufferid noisy audiotype Base, Audio buffertype id base, audio buffer



Input audio buffer to be cleaned.

Outputs

Output bufferid clean audiotype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Output audio buffer cleaned.

672

9.1.244 NonParametricBackgroundSubtraction

bitmap

class name NonParametricBackgroundSubtractioncatalog name Basecatalog id baseclass id background subtraction elhadaauthors Paolo Coletta

Computes the background subtraction basing on a non-parametric model

Inputs

inputid inputtype Base, Imagetype id base, image



Input full image (background + foregorund

input maskid input masktype Base, Imagetype id base, imagerequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Input mask for background adaptation

input background probabilityid input background probabilitytype Kernel, Double datatype (Kernel Catalog).type id kernel, doublerequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

673

Probability of the input image to fully represent the background. Provides an hint onwhich images to add to the background

Outputs

Foreground maskid output foreground masktype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Mask of the detected foreground; i.e., white pixels correspond to the position of fore-ground pixels

Parameters

Remove shadowsid remove shadowstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether to apply the algorithm to remove the shadows (internally uses YUVinput images, thus, an YUV input is preferable)

Save kernel widthid save kernel widthtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether to save the kernel width together with the block private data. Savingkernel width may cause patches to be huge and slow to load. However, it makes thealgorithm faster to startup.

Save background modelid save background modeltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether to save the background model together with the block private data.Saving the backgound model may cause patches to become *very huge* and *very slow* toload (many images have to be serialized/saved). However, it makes the algorithm immedi-ately ready to work at startup.

Compute kernel widthid compute kernel widthtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true, the block computes the kernel width instead of performing background subtrac-tion. Note that the background subtraction cannot be performed if kernel width has not

674

been computed. Kernel width should be computed using many consecutive frames fromthe background.

Background model windowid background model windowtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the number of past samples that are used when selecting the actual samplescomposing the background model.

Background model samplesid background model samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the number samples that make up the background model.

Normalize outputid normalize outputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Normalize output probability.

Alpha thresholdid shadow alphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Alpha threshold for shadow removal.

Beta thresholdid shadow betatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Beta threshold for shadow removal.

Probability thresholdid probability thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Probability threshold of the background

675

White foreground maskid white foreground masktype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the foreground mask is white, otherwise the foreground mask is black.

Resetid reset modeltype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Reset the stored model. Does not work if model is not complete yet

676

9.1.245 NoteFractionDifference

bitmap

class name NoteFractionDifferencecatalog name Basecatalog id baseclass id NFDiffauthors Gualtiero Volpe

This block computes the note fraction difference for each frequence in the input vectorof frequencies with respect to a given reference frequence. It comes from a suggestion byKoen Tanghe.

Inputs

Frequenciesid Frequenciestype Kernel, Double matrix.type id kernel, double-matrix



Input frequencies

Outputs

Note fraction differenceid NFDiffstype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The computed note fraction difference

Parameters

Reference frequenceid RefFreqtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The reference frequence with respect to which the note fraction difference is computed

677

9.1.246 OLAConvolution

bitmap

class name OLAConvolutioncatalog name Basecatalog id baseclass id ola convolutionauthors Carlo Drioli

OLA Convolution

Inputs

Input1 bufferid input1 buffertype Base, Audio buffertype id base, audio buffer



First buffer

Input2 bufferid input2 buffertype Base, Audio buffertype id base, audio buffer



Second buffer

678

Outputs


Output buffer

Parameters

Gain parameterid OlaConv gaintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Gain parameter

balance parameterid OlaConv balancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

balance parameter

679

9.1.247 OSCClient

bitmap

class name OSCClientcatalog name Basecatalog id baseclass id client osc

authorsMirko DemurtasAlberto Massari

This block send data by OSC protocol

Inputs

Inputid input data 000type Kernel, Int datatype (Kernel Catalog).type id kernel, int



Input

Parameters

Host/IPid Hosttype Kernel, String datatype (Kernel Catalog).type id kernel, string

Host/IP

Portid UDP Porttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Port

Address Patternid Address Patterntype Kernel, String datatype (Kernel Catalog).type id kernel, string

680

Address Pattern

Number of inputsid Number of inputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The number of data items sent in the OSC packet

Type of inputid type inputtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:IntegerDoubleString

domain [ 0, 3 )Type of input

681

9.1.248 OSCServer

bitmap

class name OSCServercatalog name Basecatalog id baseclass id server osc

authorsMirko DemurtasAlberto MassariPaolo Coletta

This block receive data by OSC protocol

Outputs

Outputid output datatype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Output

Parameters


Server Port

Raw Modeid raw modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

In raw mode the block sends the undecoded data to the output without decoding theOSC tags. In practice, the block gets whatever is received on the given UDP port

Address Patternid Address Patterntype Kernel, String datatype (Kernel Catalog).type id kernel, string

Address Pattern

682

Number of outputsid Number of outputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The number of data items received in the OSC packet

Type of outputid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:IntegerDoubleStringInteger 64bits

domain [ 0, 4 )Type of output

Limit buffer sizeid Limit Buffer Sizetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the block gives an upperbound to the number of internally storeditems. Setting an uperbound may reduce the latency but may also cause data loss

Buffer size limitid Buffer Size Limittype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

In the case of bounded buffer size, specifies the bound

683

9.1.249 OccurrencyCounter

bitmap

class name OccurrencyCountercatalog name Basecatalog id baseclass id OccurrencyCounterauthors Gualtiero Volpe

This block computes how many times the values contained in thesecond input occurinto the first input.

Inputs

Input vectorid InXtype Kernel, Double matrix.type id kernel, double-matrix



The input vector on which occurrences are computed

Occurrences to checkid InYtype Kernel, Double matrix.type id kernel, double-matrix



A vector containing the numbers whose occurrences in the input vector have to becounted

684

Outputs

Occurrencesid Outputtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The counted occurrences

685

9.1.250 OpenCvBayerToRgb

bitmap

class name OpenCvBayerToRgbcatalog name Basecatalog id baseclass id opencv bayer to rgbauthors Mirko Demurtas

Bayer pattern to RGB color

Inputs




Input image

Outputs

Imageid input imagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image

Parameters

Type Sensor CCD/CMOSid typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Type Sensor CCD/CMOS

686

9.1.251 OpticalFlow

bitmap

class name OpticalFlowcatalog name Basecatalog id baseclass id image optical flow


Computes the optical flow of the given video stream.

Inputs

Input imageid input video stream1type Base, Imagetype id base, image



Input multichannel image

Outputs

Dxid output video stream dxtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image with the horizontal component of the optical flow

Dyid output video stream dytype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image with the vertical component of the optical flow

687

Parameters

Algorithmid algorithmtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:(HS) Horn and Schunck(BM) Block Matching(LK) Lucas and Kanade

domain [ 0, 3 )Specifies which algorithm to use to compute the Optical Flow.Horn and Schunck: B.K.P. Horn and B.G. Schunck 1981, Determining optical flow.

Artificial Intelligence, vol 17, pp 185-203.Block Matching: Calculates the optical flow for two images by using the block matching

methodLucas and Kanade: Lucas B D and Kanade T 1981, An iterative image registration tech-

nique with an application to stereo vision. Proceedings of Imaging understanding workshop,pp 121–130

[BM] Template Sizeid template sizetype Base, Size 2D inttype id base, size2d int

Size of the template (block) used by the Block Matching [BM] algorithm.

[BM] Search Area Sizeid search area sizetype Base, Size 2D inttype id base, size2d int

Size of the search area used by the Block Matching [BM] algorithm. If a componentof the size is zero, no search is performed along that direction; otherwise, the search isperformed for at most the number of specified pixels around each block.

[LK] Window Sizeid win sizetype Base, Size 2D inttype id base, size2d int

Size of the averaging window used by the Lukas Kanade [LK] algorithm for groupingpixels

688

Optical Flow Modeid of typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Sequential (one input)Stereo (two inputs)

domain [ 0, 2 )The block can compute optical flow in sequential mode, i.e., computing it between the

previous image and the current one, or in Stereo mode, i.e., computing it between a pair ofinput images.

689

9.1.252 PARS

bitmap

class name PARScatalog name Basecatalog id baseclass id PARSauthors Nguyen, Dinh Quan

This block computes the partial recurrence based synchronization matrix (PARS) onthe input CPR matrix.

Inputs

Input CPR matrixid Intype Kernel, Double matrix.type id kernel, double-matrix



The input CPR matrix.

Outputs

PARS matrixid Outtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The output PARS matrix

690

9.1.253 PCMAudioMixer

bitmap

class name PCMAudioMixercatalog name Basecatalog id baseclass id pcm mixer


Mixes the audio channels of a pcm multichannel stream.

Inputs

Inputid inputtype Base, PCMAudioBuffertype id base, pcm audio buffer



PCM audio stream to be mixed

Outputs


Mixed PCM audio stream

Parameters

PanPot matrixid pan pot matrixtype Kernel, Double matrix.type id kernel, double-matrix

Matrix of the panoramic potentiometer, i.e., the mixing matrix. The number of rowsmust be equal to the number of input channels, whereas the number of columns determinesthe number of output channels

691


layoutCombo Box:ConstantSmoothed

domain [ 0, 2 )Specifies whether the mixing is done using the smoothing factors (UpStep, downStep)

or using a constant matrix

UpStepid up steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

In the case of smoothed mode, specifies the maximum increasing step per sample

DownStepid down steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

In the case of smoothed mode, specifies the maximum decreasing step per sample

ExportMatrixid export matrixtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Not exportExport

domain [ 0, 2 )Export panpot matrix. It allows to verify panpot matrix when mode parameter is set

to smoothed.

692

9.1.254 PDFBackgroundSubtraction

bitmap

class name PDFBackgroundSubtractioncatalog name Basecatalog id baseclass id pdf background subtractionauthors Paolo Coletta

Background subtraction algorithm based on the computation of a pixel-based pdf

Inputs



read only/read write read writereferred as inplace Output backgroundreferred as inherited *no*

Input image on which to perform background subtraction. If shadow/highlights removalhas to be performedthen the image should represent the luminance channel

Outputs

Output backgroundid output backgroundtype Base, Imagetype id base, imageinplace id Inputinherited id *no*

Output image which represents the probability, for each pixel, of the correspondinginput pixel to be a background one

693

Parameters

Working modeid working modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:TrainingRunning

domain [ 0, 2 )

Num bitsid num bitstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 8 ]

Number of significant bits of the input image. If set to 8 alla bits of the input imageare used, otherwise less significant bits are ignored

Detection rateid detection ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Shadow percentageid shadow percentagetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

694

9.1.255 PFinder

bitmap

class name PFindercatalog name Basecatalog id baseclass id pfinderauthors Paolo Coletta

Implements the adaptive background subtraction technique described in: C.R. Wren,A. Azarbayejani, T. Darrell, and A.P. Pentland, ’Pfinder: real-time tracking of the humanbody’, IEEE Trans. Pattern Analysis and Machine Intelligence, vol. 19, pp. 780-785, July1997

Details The PFinder alghorithm performs a simple absolute difference plus threshold-ing between the input image and the current background model. However, the backgroundmodel is update according to the formula: b(t) = p(t) * alpha + b(t-1) * (1-alpha) where:

nb is a pixel in the background model p is a pixel in the input image alpha is a userspecified constant

By default, only pixels classified as background are updated; however, the Update modeparameterlet the user choose a different behavior.

Inputs




Input image stream on which to perform background subtraction

Required interfacesBase, ImageConversion Kernel, Arithmetic Operations Kernel, ScalarArithmeticOpDoubleKernel, ThresholdOpDouble Kernel, MonadicArithOp base, pixelwise comparison op

695

Outputs


Output foreground image stream

Parameters

Reset Backgroundid resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Reset the current background model

Output Background Modelid output background modeltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, an output is added which export the current internal background model

Output Background Varianceid output background variancetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, an output is added which export the current internal background model


Specifies the multiplication to be applied to the stanrd deviation before being used asthe distance threshold between the input image and the background model to classify apixel as foreground or background

Adaptive background modelid adaptive background modeltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the background model (roughly, the mean background) is continuosly adaptedaccording to the alpha parameter. If false, the background model is static.

696

Adaptive background varianceid adaptive background variancetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the background variance (roughly, the mean background) is continuosly adaptedaccording to the alpha parameter. If false, the background variance is static.

Update modeid update modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Blind updateBackgroundBackgroundAndForeground

domain [ 0, 3 )Specifies how the model is updated:Blind: update the entire model with the same speed (alpha)Background: only update pixels classified as backgroundBackgroundAndForeground: update both background and forground with different speeds

(alpha and alpha foregound)


Costant which determines the update speed of the internal background model (0.0, noupdate occurs; 1.0, the internal model is replaced by the input.

Alpha Foregroundid alpha foregroundtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Costant which determines the update speed of the internal background model for fore-ground pixels (0.0, no update occurs; 1.0, the internal model is replaced by the input. Thisvalue is used only if update mode is set to BackgroundAndForground; otherwise the Alphaparameter is used

Minimum varianceid minimum variancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value of the variance.

697

9.1.256 PeakDetector

bitmap

class name PeakDetectorcatalog name Basecatalog id baseclass id timeSeriesPeakDetectorauthors Alessandro Fausto

Detect the first peak of input time series. The user can enable the output of varioustype of peak : maximum; minimum; maximum of the module of values; minimum of themodule of values.

Inputs






Outputs

index of maximumid outputMaxIndexestype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

This is the index of the first maximum found in the time series.

698

value of maximumid outputMaxValuestype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

This is the value of the first maximum found in the time series.

Parameters

Continous signalid continous signaltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If enabled the time series is considered part of a continuos signal and the last sampleof last datatype concurr to the peak detection. Otherwise the time series is consideredindipendent from the previous time series, the peak is detected using only the samples ofthe current time series.

Threasholdid Threasholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The threashold used to detect a peak. The peak (minumum or maximum) is consideredonly if its absolute value is greather than this threashold.

Formatid param modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:NormalAbsolute

domain [ 0, 2 )Defines the working mode of threashold level : ’Normal’ the threashold is compared

with samples sample ¿ threashold; ’Absolute’ the threashold is compared with the absolutevalue of samples (—sample— ¿ threashold).

Compareid param comparetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:AboveBelow

domain [ 0, 2 )

699

Defines the threashold compare type : ’Above’ each peak is valid only if above thethreashold; ’Below’ each peak is valid only if below the threashold.

maximumid enable maxtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Output the position and value of the first maximum peak found in the input time series.

minimumid enable mintype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Output the position and value of the first maximum peak found in the input time series

absolute maximumid enable abs maxtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool


absolute minimumid enable abs mintype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool


700

9.1.257 PictureInPicture

bitmap

class name PictureInPicturecatalog name Basecatalog id baseclass id picture in pictureauthors Paolo Coletta

THIS BLOCK IS NOT IMPLEMENETED YET This block add a picture into anotherexisting picture at specified position and size. The first input image is used as canvas andthe second input image is placed into the specified area position and size. The second inputimage is placed into a user provided rectangular area of the the first image.

Details If the input images have a different format the second image is convertedto the image format of the first image. If is possible use the same format for the inputimages because the conversion require time and memory. Error messages: ’Coordinatestype mismatch.’ The ’Coordinates type’ parameter contain an invalid identifier, select acorrect value from the drop down list.

Notes The block @blockref(base, image pip) does a similar work. However, it ismainly based on Intel IPP libraries, and provides to the user all features available in theunderlying library. This makes that block more flexible, but more complex to tune. Formost cases we reccomend the use of this simpler block.

701

9.1.258 PitchCorr

bitmap

class name PitchCorrcatalog name Basecatalog id baseclass id pitch estimateauthors Carlo Drioli

Pitch based on autocorrelation

Inputs




Input buffer

Outputs

Output scalarid output scalartype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output scalar

702

Parameters

window sizeid window sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Least possible window size256512102420484096819216384

domain [ 0, 7 ]window size

window typeid PitchCorr windowtypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NoneBlackmanStdBartlettHammingHannKaiser

domain [ 0, 5 ]window type

min pitchid PitchCorr minpitchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

min pitch

max pitchid PitchCorr maxpitchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

max pitch

703

filter flagid PitchCorr filterflagtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

filter flag

704

9.1.259 PixelwiseComparison

bitmap

class name PixelwiseComparisoncatalog name Basecatalog id baseclass id pixelwise comparisonauthors Paolo Coletta

Perform a pixelwise comparison of images. The result is an image where the pixelsare white where the comparison between the correspond source pixels is satisfied, blackotherwise

Inputs




First operand of the comparison operation

Required interfacesbase, pixelwise comparison op

Input 2id input 2type Kernel, Generic datatypetype id kernel, generic datatyperequired required for executionread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Second operand of the comparison operation

Required interfacesbase, pixelwise comparison op

705

Outputs


Result of the comparison operation

Parameters

Comparison typeid comparison typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:( ¡ ) Less than( ¡= ) Less than or equal to( )) ) Equal to( ¡¿ ) Different from( ¿ ) Greater than( ¿= ) Greater than or equal to

domain [ 0, 6 )Specifies which type of comparison to perform between the two input images

706

9.1.260 Point2DDoubleToPoint2DInt

bitmap

class name Point2DDoubleToPoint2DIntcatalog name Basecatalog id baseclass id point2ddouble to point2dintauthors Paolo Coletta

Convertes a Point2DDouble datatype to a Point2DInt datatype. Coordinates of aPoint2DDouble datatype are usually normalized in the range [0.0 - 1.0], thus, this blockprovides a size datatype as a parameter, which is used as a multiplier of the input Pointbefore being converted to an integer Point

Inputs

Input Pointid inputtype Base, Point 2D doubletype id base, point 2d double



The input Point in double coordinates

Outputs

Output Pointid outputtype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

The output Point in integer coordinates

Parameters


707

The input Point2DDouble datatype is normalized with respect to a given size (usuallythe size of the original image). To convert it to a ROI2DInt datatype we need to know thatsize, in order to denormalize it. In practice, the input value is multiplied by the size beforebeing converted to an integer ROI

708

9.1.261 Point2DGenerator

bitmap

class name Point2DGeneratorcatalog name Basecatalog id baseclass id point2d generator


Generates a bidimensional point (x,y) that can be drawn too.

Outputs

Pointid valuetype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

The output point contains both the X and Y coordinates. If parameter ”domain” is setto graphic mode then the point can be drawn.

Parameters


layoutCombo Box:PointCoordinates



709


layout




Xid xtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

X value

Yid ytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Y value


layout




Matrix trasform

710

9.1.262 Point2DOperation

bitmap

class name Point2DOperationcatalog name Basecatalog id baseclass id Point2DOperationsauthors Simone Ghisio

The block extract point from a geometric labelled set and calculate some features.

Inputs




Input GeometricLabelledSet

Outputs

Baricenterid outputCOGtype Base, Point 2D doubletype id base, point 2d doubleinplace id *no*inherited id *no*

The input points barycenter.

711

Parameters



domain [ 0, 2 )Specifies whether the input is a GeometricLabelledSet of integer or double geometric

values

Baricenterid Baricentertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Baricenter of geometric labelled set objects.

BoundigRectangleid BRtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

BoundigRectangle of geometric labelled set objects.

Areaid Areatype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Area of the convex hull.

712


bitmap

class name Point3DGeneratorcatalog name Basecatalog id baseclass id point 3d generatorauthors Simone Ghisio

Generates a tridimensional point, represented by 3 coordinates.

Outputs

OutputPoint3Did point outputtype Base, BaseGeometricPoint3Doubletype id base, base geometric point 3d doubleinplace id *no*inherited id *no*

Output Point 3D

Parameters



domain [ 0, 2 )Mode

XCoordinateid x parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinates of point

YCoordinateid y parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

713

Y coordinates of point

ZCoordinateid z parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinates of point

714

9.1.264 PointInLabelledRoiList

bitmap

class name PointInLabelledRoiListcatalog name Basecatalog id baseclass id point in labelled roi listauthors Paolo Coletta

Search for the input point in the ROIs provided as a parameter. The reference pointmay represent the center of the roi, or one of its vertices, according to the value of the ROIOffset parameter. See the description of parameter ROI List for more datils abount thestring format

Inputs

Input Pointid input pointtype Base, Point 2D doubletype id base, point 2d double



Input Point

Outputs

Output Pointid output roitype Base, Roi 2D doubletype id base, roi2d doubleinplace id *no*inherited id *no*

Output Point

Output Labelid output labeltype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

715

Label of the ROI in which the point is contained; empty if the point is not inside a ROI

Parameters



domain [ 0, 2 )Specify whether coordinates are expressed as normalized floating-point (double) num-

bers or as integer numbers

ROI Offsetid roi offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Top LeftTop CenterTop RightMiddle LeftMiddle CenterMiddle RightBottom LeftBottom CenterBottom Right

domain [ 0, 9 )Specify the position of the reference point of the ROI, with respect to the ROI itself.

The parameter determines the interpretation of the first two columns of the ROIs matrix.For instance, if this parameter is set to Middle Center, then the first two columns representthe coordinate of the center of the ROI

ROI Listid roi listtype Kernel, String datatype (Kernel Catalog).type id kernel, string

A string representing a list of labelled ROIs The string parameter containes the list ofROIs and labels in the following format: x y width height label\n x y width height label\n... where x, y, width, and height are double or integer numbers (according to the value ofparameter Type). x, y may be interpreted as the center of the roi, or the top-left corner,or another reference point of the roi according to the value of parameter ROI Offset. labelis a text string, which represent an identifier of this roi; does not need to be unique. If theidentifier contain spaces, it should be surrounded by (single or double) quotes. In any case,

716

the label should not contain the semicolon digit. Comment lines can be inserted by puttingthe # or // characters at the beginning of the line Example: 0.0 0.2 0.3 0.4 zone 1 0.35 0.20.3 0.4 zone 2 ...

717

9.1.265 PointInRoiList

bitmap

class name PointInRoiListcatalog name Basecatalog id baseclass id point in roi listauthors Paolo Coletta

Search for the input point in the matrix provided as a parameter. Each matrix row isinterpreted as a ROI; thus, the matrix has four columns: columns 1 and 2 represent thereference point of each ROI, whereas column 3 and 4 represent the size (width and height)of the ROI. The reference point may represent the center of the roi, or one of its vertices,accrding to the value of the ROI Offset parameter

Inputs




Input Point

Outputs


Output Point

718

Output Indexid output indextype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Index of the ROI in which the point is contained, or -1 if the point is not inside a ROI

Parameters






layout


domain [ 0, 9 )Specify the position of the reference point of the ROI, with respect to the ROI itself.

The parameter determines the interpretation of the first two columns of the ROIs matrix.For instance, if this parameter is set to Middle Center, then the first two columns representthe coordinate of the center of the ROI

ROI Listid roi listtype Kernel, Double matrix.type id kernel, double-matrix

A matrix representing a list of ROIs

719

9.1.266 PointToRoi

bitmap

class name PointToRoicatalog name Basecatalog id baseclass id pointtoroiauthors Simone Ghisio

This block builds a rectangular area (ROI) from a given input point. The user mayspecify width/height of the area and the position of the point with respect to the rectangle(e.g., top-left, center, etc.)

Inputs




Input Point

Outputs


Output Point

720

Parameters






layout


domain [ 0, 9 )Specify the position of the input point with respect to the generated output rectangle

Null ROIid null roitype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the NULL flag of the output ROI. Note that implementations of blocksmay interpret a NULL ROI differently from an empty ROI. For instance, the image datatypeinteprets a NULL ROI as a ROI covering the whole images, whereas an empty ROI (widthor height set to zero) actually causes all pixels to be unaffected by the subsequent operations

Widthid size xtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Width of the generated rectangle

721

Heightid size ytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Height of the generated rectangle

722

9.1.267 PointsDensityIndex

bitmap

class name PointsDensityIndexcatalog name Basecatalog id baseclass id PointsDensityIndexauthors Maurizio Mancini

This block computes the Density Index of a given labelled set of geometric 3D points.

Inputs

Input geometric labelled set of 3D geometric pointsid InputGeometricLabelledSettype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d double



A labelled set containing the 3D geometric points on which the block computes cinematicenergy.

Outputs

Points Density Indexid OutputPointsDensityIndextype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The Points Density Index represents the dispersion of a set of 3D points respect to themedian point.

Centroidid KohonenMapOutputCentroidtype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

723

This is centroid of the input set of 3D geometric points.

Parameters

Centroid Type of Computationid ParameterCentroidTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:MedianMean

domain [ 0, 2 )You can select how the points centroid is computed.

Distance Type of Computationid ParameterDistanceTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:MedianMeanMax

domain [ 0, 3 )You can select how the distance between each point of the set and the centroid is

computed.

724

9.1.268 PresentationTimeStabilizer

bitmap

class name PresentationTimeStabilizercatalog name Basecatalog id baseclass id RePresentationauthors Mirko Demurtas

This block changes the presentation time of a datatype by assuming that it was generatedby a periodic process with a fixed sampling rate.

Inputs




Input

Outputs


Output

Parameters

Frequencyid frequencytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Frequency

725

Timeid timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Time

726

9.1.269 ProbabilisticClassifier

bitmap

class name ProbabilisticClassifiercatalog name Basecatalog id baseclass id probabilisticclassifierauthors Maurizio Mancini

Computes the probability of an event referring to a predefined distribution of probability(guassian, sigmoid).

Inputs

Input dataid classifierinputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



This is the input value to be classified.

Outputs

Output dataid rarityoutput itype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output data

Output dataid rarityoutput iitype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output data

727

Parameters

Number of input/outputid raritynumberinputidtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 100 ]

Number of input on which computing rarity. The same value is used to determine thenumber of output.

Parameters matrixid classifiermatrixparametertype Kernel, Double matrix.type id kernel, double-matrix

A matrix containg the parameters of the distributions, every line is: (type,flipped,center,stdev/steepness)type: can be 0 (gaussian) or 1 (sigmoid) flipped: can be 0 (classical) or 1 (verticallyflipped) center: the mean value (for the gaussian) or the horizontal offset (for the sigmoid)stdev/steepness: standard deviation of the gaussian or steepness of the sigmoid

728

9.1.270 Proximity measures Tracker

bitmap

class name Proximity measures Trackercatalog name Basecatalog id baseclass id ProximityMeasuresTrackerauthors Simone Ghisio

The block computes trackin algorithm using the proximity (similarity) measure method.Themethod calculates the measure between an image and a template (another image).

Inputs




The input image

Input Geometric Labelled Setid input geometric labeled settype Base, Geometric Labelled Set 2D doubletype id base, geometric labeled set 2d double



Initial list of points to track

729

Outputs


List of points after tracking processing

Load new labelled setid output lost pointstype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Request to load new labelled set because there are too many lost points

Parameters

Enlargementid window search sizetype Base, Rectangle 2D inttype id base, rectangle 2d int

Enlargement of search window .

Template sizeid template sizetype Base, Rectangle 2D inttype id base, rectangle 2d int

Size of the template window.

LostPointid LostPointstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Maximum number of lost points after that the block generates a request to create newfeatures.

Thresholdid max distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Threshold

730

Distanceid max disttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Maximum distance

Typeid type of measuretype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Cross CorrelationDistance

domain [ 0, 2 )Type of measure

Updateid updatetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:UpdateOriginal

domain [ 0, 2 )Update

731

9.1.271 ProximityMeasure

bitmap

class name ProximityMeasurecatalog name Basecatalog id baseclass id proximity


Proximity measure

Inputs

Input streamid input video streamtype Base, Imagetype id base, image



Input stream

Templateid input video stream templatetype Base, Imagetype id base, image



Template

732

Outputs

Output streamid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output stream

Parameters

Algorithmsid algotype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Sqr Distance Full NormSqr Distance Same NormSqr Distance Valid NormCross Corr Full NormCross Corr Same NormCross Corr Vald NormCross Corr Full Norm LevelCross Corr Same Norm LevelCross Corr Vald Norm Level

domain [ 0, 9 )Algorithms

733

9.1.272 QuantityOfMotion

bitmap

class name QuantityOfMotioncatalog name Basecatalog id baseclass id mhi


Computes the quantity of motion of a silhouette

Inputs

Input streamid input video streamtype Base, Imagetype id base, image



Input stream

Outputs

Output streamid output mhitype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output stream

Quantity of motionid output motiontype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Quantity of motion

734

Parameters

Realtime modeid realtime-modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Use presentation time (i.e., the duration parameter) to compute the length of the updatehistory; otherwise use frame history.

Durationid durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Duration

Frame to keepid frame-historytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Frame to keep in the motion history. Valid only for NO realtime mode

Keep color modelid keep-colormodeltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the color model of the output is the same of the input. In such case aconversion is introduced because the internal computation is always performed with BWfloating point images.

Difference modeid diff-modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the input silhouette is subtracted from the result before providing it asthe output of the block.

Integration modeid integration-modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Integration mode

Window Sizeid wnd-sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

735

Currently ignored.

736

9.1.273 Quantizer

bitmap

class name Quantizercatalog name Basecatalog id baseclass id Quantizerauthors Mirko Demurtas

Quantizer

Inputs

InputDoubleid input doubletype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input double number

Outputs

OutputQuantizedid output doubletype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output quantized

737

Parameters

Modeid parameter modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:StepRange

domain [ 0, 2 )Mode

Stepid steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Step size

738

9.1.274 RTAn

bitmap

class name RTAncatalog name Basecatalog id baseclass id sinan rtanauthors Carlo Drioli

RealTime sinusoidal Analysis

Inputs




Input buffer

Outputs


Output buffer

739

Parameters

FFT Sizeid FftTransform fftsizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 7 ]FFT Size

san2 file nameid san filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”San2 file (*.san2)—*.san2—All files (*.*)—*.*——”

san2 file name

n. of partialsid n of partialstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 100 ]

n. of partials

min pitchid analysis minpitchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

min pitch

max pitchid analysis maxpitchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

740

max pitch

mode switchid mode switchtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

mode switch

741

9.1.275 RTAn

bitmap

class name RTAncatalog name Basecatalog id baseclass id sinan rtsynauthors Carlo Drioli

RealTime sinusoidal Synthesis

Outputs


Output buffer

Parameters

san2 file nameid san2 filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


filename parameter

sampling rateid Sampling ratetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 16000, 48000 ]

sampling rate

742

pitch shiftid pitch shifttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

pitch shift

time stretchid time stretchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

time stretch

start commandid start playingtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

start command

743

9.1.276 RTAnSyn

bitmap

class name RTAnSyncatalog name Basecatalog id baseclass id sinan rtansynauthors Carlo Drioli

RealTime sinusoidal Analysis/Synthesis

Inputs




Input buffer

Outputs


Output buffer

744

Parameters

FFT Sizeid FftTransform fftsizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 7 ]FFT Size

san2 file nameid san filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


san2 file name

n. of partialsid n of partialstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 100 ]

n. of partials

min pitchid analysis minpitchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

min pitch

max pitchid analysis maxpitchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

745

max pitch

mode switchid mode switchtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

mode switch

pitch shiftid pitch shifttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

pitch shift

time stretchid time stretchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

time stretch

start commandid start playingtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

start command

746

9.1.277 RandomNumbersGenerator

bitmap

class name RandomNumbersGeneratorcatalog name Basecatalog id baseclass id RandomGeneratorauthors Gualtiero Volpe

This block generates random numbers according to the distribution specified as param-eter.

Inputs

SyncInid SyncIntype Kernel, Generic datatypetype id kernel, generic datatype



Sync In: a new random sample is generated each time a bang arrives in this input.

Outputs

Random outputid RandomOutputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The newly generated random number.

747

Parameters

Output typeid OutputTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:RealInteger

domain [ 0, 2 )The desired type of the output random number. It can be either integer or real.

Distributionid Distributiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:BetaBilateral exponentialCauchyExponentialGaussianLinearPoissonTriangularUniformWeibull

The distribution to be used for generating random samples.

Minimum output valueid MinOutputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value for the random output number.

Maximum output valueid MaxOutputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The maximum value for the random output number.

748

9.1.278 RarityIndex

bitmap

class name RarityIndexcatalog name Basecatalog id baseclass id rarityindexauthors Maurizio Mancini

Computes the rarity index of several input data.

Inputs

Input dataid rarityinput itype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input data

Input dataid rarityinput iitype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input data

749

Outputs

Output dataid rarityoutput itype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output data

Output dataid rarityoutput iitype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output data

Parameters

Number of input/outputid raritynumberinputidtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 100 ]

Number of input on which computing rarity. The same value is used to determine thenumber of output.

Computation typeid raritytypeidtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:RarityContrast

domain [ 0, 2 )Type of rarity computed by the block: it could be the rarity of each input data based

on the input recent history or it could be the instantaneous contrast between each input.

Memory lengthid datamemoryidtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

It represents the number of past samples on which the block computes rarity (not usedwhen computing contrast).

750

Bins widthid bnlevelsidtype Kernel, Double matrix.type id kernel, double-matrix

This is the width of the bins used to discretize the input data (one scalar for each bin,representing its width).

751

9.1.279 ReadFromFile

bitmap

class name ReadFromFilecatalog name Basecatalog id baseclass id ReadFileauthors Mirko Demurtas

This block reads multiple streams of data from files written in a proprietary EyesWebformats. Files usually have extension ”.ebf”.

Parameters

Name Fileid Filetype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Eyesweb Binary File (*.ebf)—*.ebf—(*.txt)—*.txt—All files (*.*)—*.*——”

Name File

Raw Modeid Rawtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Raw Mode

Headid Headtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Head

Playid playtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Play

752


Pause


Stop

Play statusid statustype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:PlayPauseStop

domain [ 0, 3 )Recorder Status

End of fileid Eoftype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:StopPauseLoop

domain [ 0, 3 )End of file

Set startid starttype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Set start

Start timeid media startimetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Start time

753

Seek toid gototype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Seek to

Seek to timeid goto timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Seek to time

Set durationid endtotype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Set duration

Duration timeid media durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Duratione time

Master Modeid mastertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Master Mode

Index Masterid index mastertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Index Master

Delete Old Format Fileid delete previous filetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

When opening a file in a previous format (file with external index), the file is convertedto the new format. This parameter specifies whether the file in the old format is deletedafter being converted

754

9.1.280 ReadFromFile

bitmap

class name ReadFromFilecatalog name Basecatalog id baseclass id ReadFromFileauthors Simone Ghisio

Read data contained in a existing file. The file must be a txt file created by WriteToFileblock.

Inputs

ReadLineid read linetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger



When it’s triggered the block reads a line of a specified file.

Outputs

Input00id input 00type Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

Input 00.

755

Parameters

FileNameid file nametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Text files (*.txt)—*.txt—All files (*.*)—*.*——”

File to be readed.

ReadModeid read modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:BangLineTime

domain [ 0, 3 )Read Mode

EOFModeid eof modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LoopStop

domain [ 0, 2 )End of file mode. It works only if ReadMode is set to Bang mode. To obtain loop in

Line and Time mode, the user must loop the input line number or input time.

756

9.1.281 ReadImage

bitmap

class name ReadImagecatalog name Basecatalog id baseclass id read image

authorsMassimiliano PeriPaolo Coletta

Read an image which full pathname is received as a string input. Replaces the Read-ImagesFromFolder block. Note: a breaking change occurred between 5.0.1.2 and 5.0.1.3,as the block does not process folder entries as it did before. However, such features havemoved to block GetIndexedPath, thus, the combination of GetIndexedPath and ReadImageprovide the same fetures as the previous ReadImagesFromFolder block. Note: the block iscurrently limited to jpeg images.

Inputs

InputPathid pathtype Kernel, String datatype (Kernel Catalog).type id kernel, string



Full path to the jpeg file to be loaded.

Outputs

Output imageid outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output image

757

Original Image Sizeid original image sizetype Base, Size 2D inttype id base, size2d intinplace id *no*inherited id *no*

Provides the original image size

Cue Statusid cue statustype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Provides info about the status of the CUE operation. May assume one of the followingvalue: 0 - No cue operation in progress 1 - Cue in progress 2 - Cue completed 3 - Cue error

Parameters

Output datatype infoid image datatypetype Kernel, StringPairtype id kernel, string pairlayout





758


layout





layout



following values:BW (1 channel: grayscale);BGR (3 channel packed: Blue, Green, Red);RGB (3 channel packed: Red, Green, Blue);YUV (3 channel packed: Y, Cb, Cr);

759

YUYV (3 channel packed, undersampled 422: Y, Cb, Cr);UYVY (3 channel packed, undersampled 422: Y, Cb, Cr);I420 (3 channel planar, undersampled 411: Y, Cb, Cr);YV12 (3 channel planar, undersampled 411: Y, Cb, Cr);HSV (3 channel packed: Hue, Saturation, Value).



domain [ 0, 2 )Specifies whether ROI coordinates are integer (absolute) or normalize. In normalized

mode source Roi coordinates are normalized with respect to the size of the source image,whereas dest Roi coordinates are normalized with respect to the output image size

Source rectid roitype Base, Roi 2D doubletype id base, roi2d double

Rectangular area of source image to read from file

Dest roiid dest-roitype Base, Roi 2D doubletype id base, roi2d double

ROI of the output image

760


layout



the aspectRatio is not preserved, and the source image is stretched or shrinked to coverall available space. In the other cases, the aspect ratio is (or might be) preserved, thus ablack frame might be needed on the horizontal or vertical side to cover the unused space.This enumerator specifies where to place such black frame. Since the user might not knowin advance whether letterboxing will place mattes above/below or left/right, each modespecifies how to behave in both cases. As an example, the letterbox mode left-middle meansthat if the image needs mattes on the sides, the image will be put to the extreme left, andthe matte will span the right side; if the image needs mattes above/below, the image willbe vertically centered. Hence, the mode is made of two terms, the first referring to thehorizontal centering of the image, the second referring to the vertical centering. Horizontalcentering may assume values none, left, center, or right. Vertical centering may assumevalues none, top, middle, or bottom. The term none means that if letterboxing is neededon that direction, than the image is stretched to fill the whole size. E.g., elmNoneTopmeans that is image is thinner than the destination rect, than no letterboxing is appliedand the image is stretched horizontally. However, it the image is larger than the destinationrect, than letterboxing is applied by putting the image on the top and a single matte below.

Cache Imageid cache imagetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the image loaded from file is cached in local memory and reused in the case thefilename does no change. This optimize the case where the same image is used many con-

761

secutive time; however it implies one more copy occurs when the image change. Moreover,note that the whole image is cached, not only the source rect.

Image File typeid image file typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:JpegTGABMPJNGKOALALBMIFFMNGPBMRAWPCDPCXICOPBMPGMPGMRAWPNGPPMPPMRAWRASTIFFWBMPPSDCUTXBMXPMDDSGIFHDRFAXG3SGIEXRJ2KJP2PFMPICTRAWAutomatic

domain [ 0, 37 )

762

Specifies the type of the image. Specifying the image type, instead of letting the blockdeduce it from the image header, may reduce the time needed to load the image

Cue Image Pathid cue image pathtype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Jpeg files (*.jpg,*.jpeg)—*.jpg;*.jpeg—Portable Network graphics files (*.png)—*.png—Bitmap files (*.bmp,*.wbmp)—*.bmp;*.wbmp—Tagged Image File Format files (*.tiff)—*.tiff—Targa files (*.tga)—*.tga—All image files—*.jpg;*.jpeg;*.png;*.bmp;*.wbmp;*.tiff;*.tga—All files (*.*)—*.*——”

Path of the next image to be probably loaded. Note that this is just an hint for theblock; the actual image loaded is specified via the input pin. However, setting this filenamecauses the specified image to be loaded in the background. If the next requested imagematches the hint, the image will be available immediately

763

9.1.282 ReadMatrixFromFile - double

bitmap

class name ReadMatrixFromFile - doublecatalog name Basecatalog id baseclass id doublematrix from fileauthors Paolo Coletta

Load a matrix of double numbers from a text file.

Notes The text file must contain only ASCII characters. Files with other encodings isnot supported, UTF encoded files are partially supported.All line starting with ’//’ or ’#’or ’;’ is considered as comment.The first line (not commented) is evaluaded as matrix size.The other lines are evaluated as matrix rows.The matrix size must be writed as ’¡numberof row¿x¡number of column¿’ (example 5x12) otherwise the matrix dimensions is evaluatedparsing the file.Each matrix row must be writed on a single line. The matrix is writed lineby line starting from the top row and reaching the bottom row.The single row line containsall numbers of related matrix row writed in text format starting from the leftmost elementand reaching the rightmost element. Each element is separated using one tab or spaces.The values is writed in left to right order.The format used to store each matrix values canbe using standard or scentific. The separator is not supported. the decimal separator canbe ’.’ or ’,’. The result of 123/10 can be formatted as 12.3 or 12,3 or 12,3e0 or 1.23e1.So oneidentity matrix with 3x3 dimension can be writed into a file as follow: # matrix dimension(can be not specified and the size is evaluated from matrix values) 3x3 // matrix values 1.00.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 ; end of matrix

Outputs

Output matrixid valuetype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Output matrix

764

Parameters

File nameid filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


Specifies the name of the file.

Reloadid reloadtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Force the block to reload the matrix from file again.

765

9.1.283 ReadMatrixFromFile - int

bitmap

class name ReadMatrixFromFile - intcatalog name Basecatalog id baseclass id intmatrix from fileauthors Paolo Coletta

Load a matrix of integer numbers from a text file.

Notes The text file must contain only ASCII characters. Files with other encodings isnot supported, UTF encoded files are partially supported.All line starting with ’//’ or ’#’or ’;’ is considered as comment.The first line (not commented) is evaluaded as matrix size.The other lines are evaluated as matrix rows.The matrix size must be writed as ’¡numberof row¿x¡number of column¿’ (example 5x12) otherwise the matrix dimensions is evaluatedparsing the file.Each matrix row must be writed on a single line. The matrix is writed lineby line starting from the top row and reaching the bottom row.The single row line containsall numbers of related matrix row writed in text format starting from the leftmost elementand reaching the rightmost element. Each element is separated using one tab or spaces.The values is writed in left to right order.The format used to store each matrix values canbe using standard or scentific. The separator is not supported. the decimal separator canbe ’.’ or ’,’. The result of 123/10 can be formatted as 12.3 or 12,3 or 12,3e0 or 1.23e1.So oneidentity matrix with 3x3 dimension can be writed into a file as follow: # matrix dimension(can be not specified and the size is evaluated from matrix values) 3x3 // matrix values 1.00.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 ; end of matrix

Outputs

Output matrixid valuetype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Output matrix

766

Parameters


layout



Reloadid reloadtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Force the block to reload the matrix from file again.

767

9.1.284 ReadMidi

bitmap

class name ReadMidicatalog name Basecatalog id baseclass id ReadMidiauthors Mirko Demurtas

This block reads a midi file. It has three different output modalities: - Multi-channel:all the midi channels of the input file are separated and each channel has its own outputline, so all the messages of a channel are sent trough out that channel’s dedicated outputline. - Mixed-channel: only one output pin is created and all the midi messages red fromthe input file are sent trough out the output line without taking care of the message’schannel. - Buffered output: only one output line is created but, instead of sending out eachsingle midi message, a buffer is created and filled with the messages red from the inputfile. The midi buffer is then sent trough out the output line only when it is full. The sizeof the output buffer can be manually specified (in milliseconds) or can be automaticallycalculated from an external audio clock input signal depending on which synchronizationmode is selected.

The block has also three different synchronization modalities: - Internal clock: executionperiod is calculated from the values red from the input midi file such as the ”Time division”value located in the file header chunk and the various Tempo values carried by the ”SetTempo” meta-event messages. - External audio clock: a new input pin is created andyou can connect to it an external audio clock signal (such as an audio buffer signal). Thetiming properties of the midi track (such as Tempo and Tick length) are red from themidi input file like in the previous synchronization mode, but this time the output mode isautomatically switched to ”Buffered output” and the length of the midi buffer is calculatedto match the values acquired from the external audio signal. The execution of the blockis no more set to periodic (like in the other synchronization modes) but his activation isset to ”Event based”, the block is activated each time it receives an audio buffer from theinput pin. When an input audio buffer arrives, the block starts to fill the output bufferwith midi messages until his length (in milliseconds) matches the input one’s and then itis sent trough out the output pin. In this way, each time an audio buffer is generated fromi.e. an mp3 reader block, a midi buffer with the same length is generated too. This is veryuseful to synchronize a midi file with an external media source. - User specified period: theexecution period can be specified by the user ignoring the ”Time division” value and allthe ”Set Tempo” meta-event messages in the input midi file. – REMARKS – Some midimeta-event (like the ”Time Signature” messages to change Metric values) are ignored bythe midi file parser.

768

Parameters

File Nameid Filetype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Midi files (*.mid)—*.mid—All files (*.*)—*.*——”

File Name

Restart on end of fileid Eoftype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Restart on end of file

Synchronization modeid sync modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Internal clockUse external audio clockUser specified period

domain [ 0, 3 )It allows to choose the synchronization mode

Periodid Periodictype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Period

Output modeid device modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Multi channelMixed channelBuffered mode

domain [ 0, 3 )It allows to choose the output mode

769

Buffer length (ms)id buffer lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

This parameter specifies the length of the output buffer in milliseconds

Velocityid Velocitytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Velocity

770

9.1.285 RebufferAudio

bitmap

class name RebufferAudiocatalog name Basecatalog id baseclass id rebufferaudioauthors Mirko Demurtas

Rebuffer audio streams in a different audio buffer with a specified dimension.

Error and Warning Messages — During initialization phase - The output buffer has*** instead of *** samples

Inputs

Input audio streamid input audio streamtype Base, Audio buffertype id base, audio buffer



Input Audio Stream that must be rebuffered.

Outputs

Output audio streamid output audio streamtype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Output Audio Stream rebuffered.

Parameters


771

Reset the buffering of input stream

Delayid delaytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Delay

Slidingid slidingtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Sliding

Buffering typeid bufferinf typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Buffer TimeNumber of sampleFrame per second

domain [ 0, 3 )Buffering description

Durate streamid buffer durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Durate Audio stream output

772

9.1.286 Receive

bitmap

class name Receivecatalog name Basecatalog id baseclass id recvauthors Alessandro Fausto

Receive a datatype from a sender block or external application using various proto-cols.This new version has the ability to declare the output datatype using the init informa-tions received from the ’SendToNetwork2’ block. This is possible only when the protocolused by this two blocks is UDP v2.0 or TCP v1.0. In this case a new parameter appers andthe user can be toggle between the old style initialization (input pin) or new style initializa-tion (sended informations). In the initialization of the patch this block check 10 times perseconds if the datatype initialization data is arrived. If the initialization packet is not re-ceived in less than 3 seconds the block print a error message and stop the patch initializationbecause a block must declare its output datatype before exit the Init() function.

Inputs




This input is used to initialize the datatype given as output. A warning message isprinted if the datatype sent from the sender block is different from the input datatype.

Outputs


The output datatype is initialized using the same type and initialization parameter ofinput datatype. A warning message is printed if the datatype sent from the sender block

773

is different from the input datatype.

Parameters

protocolid parameter modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:UDP v. 1.0UDP v. 2.0TCP v. 1.0

domain [ 0, 3 )The UDP version 1.0 is the eyesweb network protocol used before XMI 5.0.4. The

other two protocols are the newer versions.The UDP version 2.0 has better errors handlingand use less bandwidth than UDP version 1.0 protocol.The TCP version 1.0 use the sametechniques of UDP v2.0 but use one TCP stream to send the data.

Sender addressid dest addresstype Kernel, String datatype (Kernel Catalog).type id kernel, string

IP address (or fully qualified hostname) of the sender computer.

Calc. presentation timeid cal presentationTimeIdtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Recalculate the presentation time using the received dt duration. Ignores the receivedpresentation time

Statisticsid out statisticstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Output two counters.The ’counterValid’ output is the number of datatypes correctlyreceived.The ’counterWrong’ output is the number of datatypes received with errors.Theerrors can be incomplete reception or detection of corrupted data.

Remote Portid init info porttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

This is the remote TCP port number where the sender computer wait for receiverrequests.

774

Datatype inizializationid init from sendertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:from input datatypefrom sender information

domain [ 0, 2 )Select between initialization from init information sent by sender block or from input

datatype

775

9.1.287 Rectangle2DGenerator

bitmap

class name Rectangle2DGeneratorcatalog name Basecatalog id baseclass id rectangle2d generator int


Generates a bidimensional rectangle. The rectangle can be drawn if parameter domainis set to graphic mode

Outputs

Rectangleid valuetype Base, Rectangle 2D inttype id base, rectangle 2d intinplace id *no*inherited id *no*

Output rectangle created according to the parameter ”Rectangle”.

Parameters


layout

Combo Box:RectanglePointsCoordinates

domain [ 0, 3 )If parameter is set to ’rectangle’ value, then the input of parameter ”Rectangle” must be

a rectangle datatype. If the parameter is set to ’points’ value then the input of ”Rectangle”must be a couple of point datatype (upper-left, lower-right). If the parameter value is’coordinates’ then ”Rectangle” must be upper-left and lower right points splitted into fourinteger values.

776


layout




X1id x1type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Abscissa of upper left point

Y1id y1type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Ordinate of upper let point

X2id x2type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Abscissa of lower right point

Y2id y2type Kernel, Int datatype (Kernel Catalog).type id kernel, int

Ordinate of lower right point

777


layout




Matrix trasform

778

9.1.288 Rectangle3DGenerator

bitmap

class name Rectangle3DGeneratorcatalog name Basecatalog id baseclass id rectangle 3d generatorauthors Simone Ghisio

Generates a tridimensional rectangle, represented by the upper,left origin, and 3 sizes.

Outputs

OutputRectangle3Did rectangle outputtype Base, BaseGeometricRectangle3Doubletype id base, base geometric rectangle 3d doubleinplace id *no*inherited id *no*

Output Rectangle 3D

Parameters



domain [ 0, 2 )Mode

XOriginid x parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate of origin

779

YOriginid y parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Y coordinate of origin

ZOriginid z parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate of origin

XSizeid xsize parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lenght of x side

YSizeid ysize parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lenght of y side

ZSizeid zsize parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lenght of z side

780

9.1.289 RectangleOperations2D - double

bitmap

class name RectangleOperations2D - doublecatalog name Basecatalog id baseclass id rect2d double op


Calculate union or intersection between 2 rectangles

Inputs

Rectangle 1id rect1type Base, Rectangle 2D doubletype id base, rectangle 2d double



First rectangle of the selected operation




Second rectangle of the selected operation

781

Outputs

Output rectangleid rect outtype Base, Rectangle 2D doubletype id base, rectangle 2d doubleinplace id *no*inherited id *no*

Output rectangle obtained after the selected operation

Parameters

Operationid operationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:IntersectUnion

domain [ 0, 2 )Specifies the type of the operation Intersection or union.

782

9.1.290 RectangleOperations2D - int

bitmap

class name RectangleOperations2D - intcatalog name Basecatalog id baseclass id rect2d int op


Calculate union or intersection between 2 rectangles

Inputs

Rectangle 1id rect1type Base, Rectangle 2D inttype id base, rectangle 2d int








783

Outputs

Output rectangleid rect outtype Base, Rectangle 2D inttype id base, rectangle 2d intinplace id *no*inherited id *no*


Parameters




784

9.1.291 RectangleOperations3D - double

bitmap

class name RectangleOperations3D - doublecatalog name Basecatalog id baseclass id rect3d double op


Calculate union or intersection between two 3d rectangles

Inputs









785

Outputs

Output rectangleid rect outtype Base, Rectangle 3D doubletype id base, rectangle 3d doubleinplace id *no*inherited id *no*


Parameters




786

9.1.292 RectangleOperations3D - int

bitmap

class name RectangleOperations3D - intcatalog name Basecatalog id baseclass id rect3d int op


Calculate union or intersection between two 3d rectangles

Inputs









787

Outputs

Output rectangleid rect outtype Base, Rectangle 3D inttype id base, rectangle 3d intinplace id *no*inherited id *no*


Parameters




788

9.1.293 RectangleToPointAndSize - double

bitmap

class name RectangleToPointAndSize - doublecatalog name Basecatalog id baseclass id RectToPoinandSizeDouble


Convert a double rectangle to its origin point(x,y) and size(width,height)

Inputs

Rectangle to origin and sizeid rect2dtype Base, Roi 2D doubletype id base, roi2d double



The rectangle that must be converted.

Outputs

Originid point2dtype Base, Point 2D doubletype id base, point 2d doubleinplace id *no*inherited id *no*

Origin point (x,y) of the rectangle.This output is usually used to calculate boundingrectangle with the size of the object.

Sizeid size2dtype Base, Size 2D doubletype id base, size2d doubleinplace id *no*inherited id *no*

789

Size of rectangle (width and height). If these two values are added to origin point theresult is the bounding rectangle.

790

9.1.294 RectangleToPointAndSize - int

bitmap

class name RectangleToPointAndSize - intcatalog name Basecatalog id baseclass id RectToPoinandSizeInt


Convert an integer rectangle to origin point(x,y) and size(width,height)

Inputs

Rectangle to origin and sizeid rect2dtype Base, Roi 2D inttype id base, roi2d int



The rectangle that must be converted.

Outputs

Originid point2dtype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

Origin point (x,y) of the rectangle.This output is usually used to calculate boundingrectangle with the size of the object.

Sizeid size2dtype Base, Size 2D inttype id base, size2d intinplace id *no*inherited id *no*

791

Size of rectangle (width and height). If these two values are added to origin point theresult is the bounding rectangle.

792

9.1.295 Remap

bitmap

class name Remapcatalog name Basecatalog id baseclass id remap


Modify the input image according to x and y input map table

Inputs




Image

X mapid x maptype Base, Imagetype id base, image



X map

793

Y mapid y maptype Base, Imagetype id base, image



Y map

Outputs

Remapped imageid output remappedtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Remapped image

Parameters

Dest. ROIid dest-roitype Base, Roi 2D inttype id base, roi2d int

Destination ROI

Interpolation Algorithmid interpolation algorithmtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Nearest neighbourLinearCubicSuper Sample

domain [ 0, 4 )Specifies the algorithm used to interpolate the image when resize is needed. A rough

interpolation (e.g., nearest neighbour) may cause visible artifacts, however, the CPU usageto perform such interpolation is quite limited. A good quality interpolation (e.g., cubic)provides better results but may cause an high CPU load.

794

9.1.296 RemapMatrix - double

bitmap

class name RemapMatrix - doublecatalog name Basecatalog id baseclass id remap doublematrixauthors Paolo Coletta

Remap items of a matrix using two auxiliary matrices as maps for rows and columns.

Inputs




Input matrix containing the items to be remapped.

Rows’ mapid row map idtype Kernel, Integer matrix.type id kernel, int-matrix



Each item of this matrix contains the position (row) where to move the correspondingitem of the input matrix when copying it to the output matrix. I.e., if item (i,j) of thismatrix has value m, then the (i, j) item of the input matrix will be moved to the (m, ?)position of the output matrix (the value of ? depends on the other parameter).

795

Columns’ mapid column map idtype Kernel, Integer matrix.type id kernel, int-matrix



Each item of this matrix contains the position (column) where to move the correspondingitem of the input matrix when copying it to the output matrix. I.e., if item (i,j) of thismatrix has value n, then the (i, j) item of the input matrix will be moved to the (?, n)position of the output matrix (the value of ? depends on the other parameter).

Outputs


Output matrix containing the remapped values.

796

9.1.297 RemapMatrix - int

bitmap

class name RemapMatrix - intcatalog name Basecatalog id baseclass id remap intmatrixauthors Paolo Coletta

Remap items of a matrix using two auxiliary matrices as maps for rows and columns.

Inputs




Input matrix containing the items to be remapped.

Rows’ mapid row map idtype Kernel, Integer matrix.type id kernel, int-matrix



Each item of this matrix contains the position (row) where to move the correspondingitem of the input matrix when copying it to the output matrix. I.e., if item (i,j) of thismatrix has value m, then the (i, j) item of the input matrix will be moved to the (m, ?)position of the output matrix (the value of ? depends on the other parameter).

797

Columns’ mapid column map idtype Kernel, Integer matrix.type id kernel, int-matrix



Each item of this matrix contains the position (column) where to move the correspondingitem of the input matrix when copying it to the output matrix. I.e., if item (i,j) of thismatrix has value n, then the (i, j) item of the input matrix will be moved to the (?, n)position of the output matrix (the value of ? depends on the other parameter).

Outputs


Output matrix containing the remapped values.

798

9.1.298 RemoveByLabel

bitmap

class name RemoveByLabelcatalog name Basecatalog id baseclass id RemoveByLabelauthors Simone Ghisio


Inputs

InputLabelledSetid input labeled settype Kernel, Labelled settype id kernel, labeled set



Input Labelled Set. This is a non homogeneous list of geomteric object.

OutputStringid input stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string




799

Outputs

InputLabelledSetid output labeled settype Kernel, Labelled settype id kernel, labeled setinplace id *no*inherited id *no*

Input Labelled Set. This is a non homogeneous list of geomteric object.

800

9.1.299 RemoveDuplicates

bitmap

class name RemoveDuplicatescatalog name Basecatalog id baseclass id remove duplicatesauthors Mirko Demurtas

This block removes adjacent consecutive duplicate datatypes

Inputs




Input

Outputs

Outputid Outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Inputinherited id *no*

Output

801

9.1.300 RemoveShape2D-double

bitmap

class name RemoveShape2D-doublecatalog name Basecatalog id baseclass id RemoveShapeDoubleauthors Simone Ghisio

This block removes shapes from the input list according to parameters area and height.Double version of the block. It works with double shapes.

Inputs

InputListid input shape listtype Kernel, Listtype id kernel, list


read only/read write read writereferred as inplace OutputListreferred as inherited *no*

Input list of shapes

Outputs

OutputListid input shape listtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id InputListinherited id *no*

Output list without removed shapes.

802

Parameters

Modeid par modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ThresholdLinear

domain [ 0, 2 )Actually it works only in Threshold mode

areaid par areatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value of this parameter is the minimum area allowed of the shape.

heightid par heighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value of this parameter is the minimum height allowed of the shape.

803

9.1.301 RemoveShape2D-int

bitmap

class name RemoveShape2D-intcatalog name Basecatalog id baseclass id RemoveShapeIntauthors Simone Ghisio

This block removes shapes from the input list according to parameters area and height.Integer version of the block. It works with int shapes.

Inputs



read only/read write read writereferred as inplace OutputListreferred as inherited *no*


Outputs

OutputListid input shape listtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id InputListinherited id *no*

Output list without removed shapes.

804

Parameters

Modeid par modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ThresholdLinear

domain [ 0, 2 )Actually it works only in Threshold mode

areaid par areatype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The value of this parameter is the minimum area allowed of the shape.

heightid par heighttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The value of this parameter is the minimum height allowed of the shape.

805

9.1.302 RemoveSparsePixle

bitmap

class name RemoveSparsePixlecatalog name Basecatalog id baseclass id RemoveSparseauthors Mirko Demurtas

This block remove sparse pixel

Inputs




Input Image

Outputs

Outputid Outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output Image

806

9.1.303 RescaleInRangePoint3D-Double

bitmap

class name RescaleInRangePoint3D-Doublecatalog name Basecatalog id baseclass id point 3d rescale doubleauthors Simone Ghisio

Rescale geometric objects according to parameter values.The rescaling is linear.

Inputs




3D obect to be rescaled

Required interfacesbase, 3d rescale in range double

Outputs


3D obect rescaled

Parameters

StartRangeInputXid param start range input xtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

807

Start Range Input.

EndRangeInputXid param end range input xtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Input.

StartRangeOutputXid param start range output xtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Start Range Output

EndRangeOutputXid param end range output xtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Output

StartRangeInputYid param start range input ytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Start Range Input.

EndRangeInputYid param end range input ytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Input.

StartRangeOutputYid param start range output ytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Start Range Output

EndRangeOutputYid param end range output ytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Output

808

StartRangeInputZid param start range input ztype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Start Range Input.

EndRangeInputZid param end range input ztype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Input.

StartRangeOutputZid param start range output ztype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Start Range Output

EndRangeOutputZid param end range output ztype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Output

809

9.1.304 RescaleInRangePoint3D-Int

bitmap

class name RescaleInRangePoint3D-Intcatalog name Basecatalog id baseclass id point 3d rescale intauthors Simone Ghisio

Rescale geometric objects according to parameter values.The rescaling is linear.

Inputs




3D obect to be rescaled

Required interfacesbase, 3d rescale in range int

Outputs


3D obect rescaled

Parameters

StartRangeInputXid param start range input xtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

810

Start Range Input.

EndRangeInputXid param end range input xtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

End Range Input.

StartRangeOutputXid param start range output xtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Start Range Output

EndRangeOutputXid param end range output xtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

End Range Output

StartRangeInputYid param start range input ytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Start Range Input.

EndRangeInputYid param end range input ytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

End Range Input.

StartRangeOutputYid param start range output ytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Start Range Output

EndRangeOutputYid param end range output ytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

End Range Output

811

StartRangeInputZid param start range input ztype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Start Range Input.

EndRangeInputZid param end range input ztype Kernel, Int datatype (Kernel Catalog).type id kernel, int

End Range Input.

StartRangeOutputZid param start range output ztype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Start Range Output

EndRangeOutputZid param end range output ztype Kernel, Int datatype (Kernel Catalog).type id kernel, int

End Range Output

812

9.1.305 ResizeRoi

bitmap

class name ResizeRoicatalog name Basecatalog id baseclass id resize roiauthors Paolo Coletta

This block changes the size of the input Roi by adding the user-specified quantities tothe width and height of the Roi. The user can choose whether the resulting Roi is centeredwith respect to the original one; if not, the point that remains fixed can be specified

Inputs

InputROIid input roitype Base, Roi 2D doubletype id base, roi2d double


read only/read write read writereferred as inplace OutputROIreferred as inherited *no*

Input ROI

Outputs

OutputROIid output roitype Base, Roi 2D doubletype id base, roi2d doubleinplace id InputROIinherited id *no*

Resized Roi

813

Parameters

Typeid m typePtrtype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )Specify whether ROI coordinates and size are expressed as normalized floating-point

(double) numbers or as integer numbers

ROI Offsetid m roiOffsetPtrtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 9 )Specify the position of the fixed point of the input ROIwith respect to the generated

output rectangle

Sizeid parameter sizetype Base, Size 2D doubletype id base, size2d double

Specifies the amount of change that occurs in the width and height. Use negative valueto shrink the input Roi, positive values to enlarge it

814

9.1.306 Roi2DDoubleToRoi2DInt

bitmap

class name Roi2DDoubleToRoi2DIntcatalog name Basecatalog id baseclass id roi2ddouble to roi2dintauthors Paolo Coletta

Convertes a Roi2DDouble datatype to a ROI2DInt datatype. Coordinates of a ROI2DDoubledatatype are usually normalized in the reange [0.0 - 1.0], thus, this block provides a sizedatatype as a parameter, which is used as a multiplier of the input ROI before beingconverted to an integer ROI

Inputs

Input ROIid inputtype Base, Roi 2D doubletype id base, roi2d double



The input ROI in double coordinates

Outputs

Output ROIid outputtype Base, Roi 2D inttype id base, roi2d intinplace id *no*inherited id *no*

The output ROI in integer coordinates

Parameters


815

The input Roi2DDouble datatype is normalized with respect to a given size (usually thesize of the original image). To convert it to a ROI2DInt datatype we need to know thatsize, in order to denormalize it. In practice, the input value is multiplied by the size beforebeing converted to an integer ROI

816

9.1.307 RoiToRectangle

bitmap

class name RoiToRectanglecatalog name Basecatalog id baseclass id RoiToRectangleauthors Gualtiero Volpe

This block converts a Region of Interest (ROI) in a geometric or graphic rectangle. Itallows setting the graphic properties of the output rectangle.

Inputs

id InputROItype Base, Roi 2D inttype id base, roi2d int



Outputs

id OutputRectangletype Base, Rectangle 2D inttype id base, rectangle 2d intinplace id *no*inherited id *no*

817

Parameters

id RectTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Geometric IntegerGeometric RealGraphic IntegerGraphic Real

domain [ 0, 4 )

id Colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

id Thicknesstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id IsFilledtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

id FillColortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

818

9.1.308 Rotate

bitmap

class name Rotatecatalog name Basecatalog id baseclass id RotateObject2Dauthors Mirko Demurtas

This block rotates the input geometric or graphic 2D object. The block input is genericbut it accepts only 2D rotable objects.

Inputs

Input objectid InputObjecttype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace Output objectreferred as inherited *no*

The input 2D object to be rotated.

Required interfacesBase, Transformations2D

Outputs

Output objectid OutputObjecttype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input objectinherited id *no*

The output rotated 2D object.

819

Parameters

Rotation angleid RotationAngletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The rotation angle in radiants to be applied to the input object.

Rotate vertexesid Computetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the block computes the transformation on the vertexes of the object. If falsethe transformation is applied to the entire object.If the input object is graphic and theparameter is set to false the rotation is visible, otherwise if the parameter is set to true, thevertexes of the object is actually rotated and the object is redrawn changing the origin ofthe axis, so the rotation might not be visible. If in the patch some blocks of transformationare used(Rotate, Scale, Translate) each one that set Compute to true computes alle theprevious transformation on the vertexes.

820

9.1.309 Rotate3D-Double

bitmap

class name Rotate3D-Doublecatalog name Basecatalog id baseclass id rotate 3d doubleauthors Simone Ghisio

Rotate the 3D object, updating angle values. The block applies the transformationto the object. It means that coordinates are updated according to transformation valueparameters. This applying is necessary to rotate object around a generic point.

Inputs




Generic input 3D

Required interfacesbase, 3d rotate

Outputs


Output 3D.

821

Parameters

AngleXid param x rotationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Angle of rotation around x axis.

AngleYid param y rotationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Angle of rotation around y axis.

AngleZid param z rotationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Angle of rotation around z axis.

RotationCenterXid center xtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Center ofrotation on x axis.

RotationCenterYid center ytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Center ofrotation on y axis.

RotationCenterZid center ztype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Center ofrotation on z axis.

822

9.1.310 Rotate3D-Int

bitmap

class name Rotate3D-Intcatalog name Basecatalog id baseclass id rotate 3d intauthors Simone Ghisio

Rotate the 3D object, updating angle values. The block applies the transformationto the object. It means that coordinates are updated according to transformation valueparameters. This applying is necessary to rotate object around a generic point.

Inputs




Generic input 3D

Required interfacesbase, 3d rotate

Outputs


Output 3D.

823

Parameters

AngleXid param x rotationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Angle of rotation around x axis.

AngleYid param y rotationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Angle of rotation around y axis.

AngleZid param z rotationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Angle of rotation around z axis.

RotationCenterXid center xtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Center ofrotation on x axis.

RotationCenterYid center ytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Center ofrotation on y axis.

RotationCenterZid center ztype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Center ofrotation on z axis.

824

9.1.311 SI-1280

bitmap

class name SI-1280catalog name Basecatalog id baseclass id SI-1280authors Alberto Massari

Acquire video stream from USB2 camera

Outputs

Acquired videoid video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

This is the video stream coming from the camera

Parameters

Camera IDid camera-idtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 7 ]

The number of the camera (0-7)


The dimension of the acquired window

Window offsetid window offsettype Base, Point 2D inttype id base, point 2d int

The location of the top left corner of the acquisition window, relative to the full1280x1024 window.

825

Vertical mirrorid vert mirrortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the image must be swapped vertically

Horizontal mirrorid horiz-mirrortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the image must be swapped horizontally

Clockid clocktype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:7 MHz8 MHz9 MHz10 MHz15 MHz20 MHz25 MHz30 MHz35 MHz40 MHz41 MHz42 MHz43 MHz44 MHz45 MHz50 MHz55 MHz60 MHz

Acquisition clock; frame rate is given by the formula clock/((columns+150)*rows)

Subsampleid subsampletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Determine if the specified acquisition window should be subsampled by a factor of 2.E.g. an acquisition window of 1280x1024 with subsampling on will generate a frame of640x512 covering the entire window

826

Color Modeid color-modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Black & White

The color mode of the acquired video; it can be black & white or color

Gainid gaintype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:1.4101.6201.8802.1702.5202.9203.3803.9004.5005.1705.9306.7607.8608.6409.61010.690

The global gain of the camera

Black offsetid black offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 127 ]

Specifies the offset (in the range 0,127) of the black color

Column offsetid column offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Specifies the column balance

827

Shutter typeid shutter typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Rolling ShutterTriggered Shutter, 32 clocksTriggered Shutter, 64 clocksTriggered Shutter, 128 clocksTriggered Shutter, 256 clocksRolling Shutter, Dual Slope 1Rolling Shutter, Dual Slope 2Rolling Shutter, Dual Slope 3

Specifies if the camera will use a full frame (aka progressive scan) shutter, or a ”rolling”shutter. The dual slope mode allows to compensate for bright and dark areas in the samepicture. The number of clocks in the full-frame mode are multiplied by the exposure timeto obtain the acquisition window.

Rolling shutter windowid rolling shutter windowtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Specifies the number of rows that will be acquired at the same time; it must be lessthan the total number of rows.

Exposureid exposuretype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 4096 ]

When the camera is in full-frame mode, specifies the number of cycles that each exposurewill take

Color resolutionid bit resolutiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:8 bit12 bit

Specifies the number of bits (8 or 12) used by each pixel in the resulting image

828

Max queue sizeid max queue sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ -1, +infinity )

Specifies the maximum size of the interna queue of images. Having a queue of sizegreater than zero may help to avoid loosing frames. However, a limit is needed to avoid acostant grow of the mmory requirements. Use -1 to mean n limit

829

9.1.312 SampleCounterByEnergyPerc

bitmapSample by Energy.png Sample by Energy.png

class name SampleCounterByEnergyPerccatalog name Basecatalog id baseclass id Counter Sample by Energyauthors Simone Ghisio

Count values by a given percentual of energy

Inputs

Input Bufferid input sound buffertype Kernel, Generic datatypetype id kernel, generic datatype



This is the input buffer that must be elaborated


Outputs

Outputid output valuetype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Value

Parameters

THRid thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

830

Threshold

831

9.1.313 SampleEntropy

bitmap

class name SampleEntropycatalog name Basecatalog id baseclass id sampleentropyauthors Maurizio Mancini


Inputs

Input time seriesid sampleentropyinputtype Kernel, Generic datatypetype id kernel, generic datatype



The time series containing the input data.


Outputs

Sample entropyid sampleentropyoutputtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The sample entropy of the input time series.

Normalized timeseriesid normalizedoutputtype Base, TemporalDatatype id base, temporal datainplace id *no*inherited id *no*

832

This is the normalized version of the input timeseries (if the normalization parameteris set to true).

Parameters

algorithm typeid sampleentropyalgotypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:algorithm 1algorithm 2

domain [ 0, 2 )The block can compute sample entropy with different algorithms.

mid sampleentropymtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

This is the length of subvestors on which the sample entropy is computed. Maxmimumvalue for m is the length of the input time series minus 1.

rid sampleentropyrtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

If two subvectors distance is less than this parameter than they match.

normalizeid sampleentropynormalizetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Normalize the input time series.

833

9.1.314 Savitzky-Golay

bitmap

class name Savitzky-Golaycatalog name Basecatalog id baseclass id savitzkygolayfilterauthors Maurizio Mancini

Computes the Savitzky Golay filter on the input time series.

Inputs






Outputs


This is the smoothed time series

Parameters

Filter orderid filterordertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

834

The higher the order the strongest the intensity of smoothing

Output typeid typeparamtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Smoothed signalSmoothed 1st derivativeSmoothed 2nd derivativeSmoothed 3rd derivative

domain [ 0, 4 )Type of output: filtered signal, filtered 1st derivative, filtered 2nd derivative, filtered

3rd derivative

Input timeseries modeid modeparamtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:BufferSliding window

domain [ 0, 2 )The input timeseries can be a buffer or a sliding window

Output delay (samples)id delayedparamtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The output can be delayed to obtain a more stable signal

835

9.1.315 ScalarDisplay

bitmap

class name ScalarDisplaycatalog name Basecatalog id baseclass id Displayauthors Mirko Demurtas

Displays one or more scalar (integer or double) number(s). The user can select the fontused to display the scalar value(s). If more than one scalar is displayed, then, the values arevertically stacked within the same window. Each input can be assigned a label (throughthe custom dialog of the block) which is displayed next to its value.

Inputs

Input 0id Input000type Kernel, Generic datatypetype id kernel, generic datatype



Input 0 of the block

Parameters

Number of inputsid nInputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 16 ]

Number of inputs of the block. All inputs are displays in the block area, verticallystacked. Each input can be assigned a label which is displayed next to its value.

Fontid LabelFonttype Kernel, Fonttype id kernel, font

This is the font used to display the scalar value and the associated label.

836

9.1.316 ScalarRescaler

bitmap

class name ScalarRescalercatalog name Basecatalog id baseclass id Rescaleauthors Mirko Demurtas

The block rescales input value in an output value using input and output range pa-rameters. In custom mode the user must provides both the input and output ranges. Inautomatic mode the user must provides just the output range. The input range is calcu-lated setting end and start input range as maximum and minimum input values. In thismode it’s possible to evaluate input and update min/max values or just rescale input valuewithout update the range.

Inputs

Inputid inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input value.

Outputs

Outputid outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output rescaled value.

837

Parameters

Modeid param modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Custom rangeAutomatic range

domain [ 0, 2 )Set the input range mode parameter. In custom mode the user must provides the input

range. In automatic mode it is calculated setting end and start input range as maximumand minimum input values.

Start Range Outputid param start range outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Start Range Output

End Range Outputid param end range outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Output

Start Range Inputid param start range inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Start Range Input. Ignored in automatic mode.

End Range Inputid param end range inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

End Range Input. Ignored in automatic mode.

Updateid param updatetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Use input value to update max and min values. Not used in custom mode.

838

NotUpdateid param not updatetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Use old max and min value. Not used in custom mode.

Update modeid param update modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:UpdatingNotUpdating

domain [ 0, 2 )It shows if the block is updating max and min values or not. Not used in custom mode.

839

9.1.317 ScalarToAudio

bitmap

class name ScalarToAudiocatalog name Basecatalog id baseclass id scalar to audio conversion

authorsCarlo DrioliPaolo Coletta

Generates an audio buffer for each scalar input value.

Inputs

Input scalarid input scalartype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input scalar

Outputs


Output buffer

Parameters

sampling rateid Sampling ratetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 160, 48000 ]

sampling rate

840

frame sizeid Frame sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( -infinity, +infinity )

frame size

carrier frequencyid Carrier freqtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

carrier frequency

modulation typeid Modulation typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NoneAM modulationFM modulationAM+FM modulation

domain [ 0, 3 ]modulation type

841

9.1.318 Scale

bitmap

class name Scalecatalog name Basecatalog id baseclass id ScaleObject2Dauthors Mirko Demurtas

This block scales the input geometric or graphic 2D object.

Inputs




The input 2D object to be scaled.


Outputs


The output scaled 2D object.

Parameters

Scaling factor along Xid ScalingFactorXtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

842

The scaling factor to be applied to the input object along the X axis.

Scaling factor along Yid ScalingFactorYtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The scaling factor to be applied to the input object along the Y axis.

Computeid Computetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the block computes the transformation on the vertexes of the object. If falsethe transformation is applied to the entire object.If the input object is graphic and theparameter is set to false the rescaling is visible, otherwise if the parameter is set to true,the vertexes of the object is actually rescaled and the object is redrawn changing the origin ofthe axis, so the rescaling might not be visible. If in the patch some blocks of transformationare used(Rotate, Scale, Translate) each one that set Compute to true computes alle theprevious transformation on the vertexes.

843

9.1.319 Scale3D-Double

bitmap

class name Scale3D-Doublecatalog name Basecatalog id baseclass id scale 3d doubleauthors Simone Ghisio

Scale the 3D object, updating scaling values. The block doesn’t apply the transofmrationto the object. It means that scaling are updating, but not the coordinates.

Inputs




Generic input 3D

Required interfacesbase, 3d scle

Outputs


Output3D.

844

Parameters

ScaleXid param x scaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling value on x axis. 0 value means that not rescale along the axis.

ScaleYid param y scaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling value on y axis. 0 value means that not rescale along the axis.

ScaleZid param z scaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling value on z axis. 0 value means that not rescale along the axis.

845

9.1.320 Scale3D-Int

bitmap

class name Scale3D-Intcatalog name Basecatalog id baseclass id scale 3d intauthors Simone Ghisio

Scale the 3D object, updating scaling values. The block doesn’t apply the transofmrationto the object. It means that scaling are updating, but not the coordinates.

Inputs




Generic input 3D

Required interfacesbase, 3d scle

Outputs


Output3D.

846

Parameters

ScaleXid param x scaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling value on x axis. 0 value means that not rescale along the axis.

ScaleYid param y scaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling value on y axis. 0 value means that not rescale along the axis.

ScaleZid param z scaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling value on z axis. 0 value means that not rescale along the axis.

847

9.1.321 SegmentHistogram

bitmap

class name SegmentHistogramcatalog name Basecatalog id baseclass id segment histogramauthors Simone Ghisio

This block search segments in the input blob. The block finds black segments insidewhite border or white segments inside black border.

Inputs





Outputs

Output Histogramid output imagetype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Output segments Histogram

848

Parameters

Scan directionid scan directiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:VerticalHorizontal

domain [ 0, 2 )Scan Direction

BlackOrWhiteid hole colortype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:BlackWhite

domain [ 0, 2 )Select if the block search black segments inside white or white segments inside black.

BorderWidthid border widthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Minimum Border Width

SegmentWidthid hole widthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Minimum Segment Width

849

9.1.322 SelectInterval

bitmap

class name SelectIntervalcatalog name Basecatalog id baseclass id select intervalauthors Paolo Coletta

Given a time as input, select the index of the time-interval to which the input belongs

Inputs

Inputid inputtype Kernel, Time datatype (Kernel Catalog).type id kernel, time



Input time

Outputs

Foundid output foundtype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

A boolean specifying whether the given time was found in any of the intervals

Label Indexid output labeltype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

The label of the selected interval

850

Parameters

Intervalsid intervalstype Kernel, String datatype (Kernel Catalog).type id kernel, string

Intervals are specified as a semicolon-separated sequence of: starttime endtime labelwhere starttime and endtime are floating-point time values expressed in seconds, label

is an optional free-text string

Enable output indexid enable output indextype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the block will provide an output representing the zero-based index ofthe interval

Enable output labelid enable output labeltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the block will provide an output representing the label of the interval

Enable output start timeid enable output start timetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the block will provide an output representing the start time of theinterval

Enable output end timeid enable output end timetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the block will provide an output representing the end time of theinterval

851

9.1.323 SelectMultipleTrackedShape Double

bitmap

class name SelectMultipleTrackedShape Doublecatalog name Basecatalog id baseclass id select multiple tracked blobs

authorsPaolo ColettaSimone Ghisio

Selects a subset of the tracked shapes basing on their area, size, or contraction index.

Inputs




Labelled set of tracked shapes. Shapes tracking is assumed to be perfomed elsewhere;this block just selects a subset of the tracked shapes basing on a user-specified criteria

Outputs

Output datatypeid blob 0type Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Labelid label 0type Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

852

Foundid found 0type Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Parameters


Once the shapes to be tracked are selected, they are confirmed in following frames, evenif they do not satisfy the given criteria anymore. E.g., if a criteria is the biggest area, theshape with the highest area may be selected at a certain time instant; in the subsequentframes it is selected regardless of its area: i.e., should a biggest shape appear, the currentone is still selected and the new one is ignored. The reset command causes the criteria tobe evaluated again, thus, a new set of shapes will be selected.


layoutCombo Box:AscendingDescending

domain [ 0, 2 )Specifies the order used to extract shapes

Criteriaid extraction typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AreaHeightWidthDistance from point

domain [ 0, 4 )Specifies the feature used by the algorithm to extract shapes

853

Num shapesid num blobstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the maximum number of shapes to be selected.

Autoresetid autoreset ontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:No autoresetOnTopN

domain [ 0, 2 )Specifies the autoreset

854

9.1.324 SelectMultipleTrackedShape Int

bitmap

class name SelectMultipleTrackedShape Intcatalog name Basecatalog id baseclass id select multiple tracked blobs int


Selects a subset of the tracked shapes basing on their area, size, or contraction index.

Inputs




Labelled set of tracked shapes. Shapes tracking is assumed to be perfomed elsewhere;this block just selects a subset of the tracked shapes basing on a user-specified criteria

Outputs

Output datatypeid blob 0type Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Labelid label 0type Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

855

Foundid found 0type Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Parameters


Once the shapes to be tracked are selected, they are confirmed in following frames, evenif they do not satisfy the given criteria anymore. E.g., if a criteria is the biggest area, theshape with the highest area may be selected at a certain time instant; in the subsequentframes it is selected regardless of its area: i.e., should a biggest shape appear, the currentone is still selected and the new one is ignored. The reset command causes the criteria tobe evaluated again, thus, a new set of shapes will be selected.


layoutCombo Box:AscendingDescending

domain [ 0, 2 )Specifies the order used to extract shapes

Criteriaid extraction typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AreaHeightWidthDistance from point

domain [ 0, 4 )Specifies the feature used by the algorithm to extract shapes

856

Num shapesid num blobstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the maximum number of shapes to be selected.

Autoresetid autoreset ontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:No autoresetOnTopN

domain [ 0, 2 )Specifies the autoreset

857

9.1.325 SelectShapeInListDouble

bitmap

class name SelectShapeInListDoublecatalog name Basecatalog id baseclass id SelectShapeInList-Doubleauthors Simone Ghisio

This block receives a list of shapes in input, and provide a labelled set of shapes asoutput. It tries to track the shapes in the input list: when a shape is found in consecutivelists it is assigned an unique label and added to the output labelled set. When the sameshape is found in subsequent lists, it is assigned the same label. In practice, if a shape ismatched, then its label does not change in the output labebel set; when new shapes areidentified new labels are generated and bound to such shapes. The criteria to match shapesin consecutive frames (lists) are its area and position; both criteria can be weighted with auser-given weight. If position is used, then a shape is matched with the nearest one in theprevious list, whereas if area is used a shape is matched with the one with the most similararea. The double version of the block expects floating-point coordinates from the user forthe area- and position-related paramaters. The floating-point coordinates are normalizedin the range [0.0 - 1.0] with respect to the size of the image from which the shapes wereextracted. Thus, for the position coordinates (0.0,0.0) is always the upper-left corner, and(1.0,1.0) is the lower-right corner.

Inputs





858




Input image

Outputs

OutputLabelledSetid output labeled settype Kernel, Labelled settype id kernel, labeled setinplace id *no*inherited id *no*

Output labelled set of matched shapes

Parameters

MaxElapsedTimeid max elapsed timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Max elapsed time

MinMatchedThresholdid min matched thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Min matched threshold

Methodid methodtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CrossCorrelationDistance

domain [ 0, 2 )Method

859

Replaceid replacetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Replace

860

9.1.326 SelectShapeInListInt

bitmap

class name SelectShapeInListIntcatalog name Basecatalog id baseclass id SelectShapeInList-Intauthors Simone Ghisio

This block receives a list of shapes in input, and provide a labelled set of shapes asoutput. It tries to track the shapes in the input list: when a shape is found in consecutivelists it is assigned an unique label and added to the output labelled set. When the sameshape is found in subsequent lists, it is assigned the same label. In practice, if a shape ismatched, then its label does not change in the output labebel set; when new shapes areidentified new labels are generated and bound to such shapes. The criteria to match shapesin consecutive frames (lists) are its area and position; both criteria can be weighted witha user-given weight. If position is used, then a shape is matched with the nearest one inthe previous list, whereas if area is used a shape is matched with the one with the mostsimilar area. The integer version of the block expects integer coordinates from the user forthe area- and position-related paramaters. The integer cordinates are expressed in pixelsand are reletive to the image from which the shapes were extracted.

Inputs





861




Input image

Outputs


Output labelled set of matched shapes

Parameters

MaxElapsedTimeid max elapsed timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Max elapsed time

MinMatchedThresholdid min matched thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Min matched threshold

Methodid methodtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CrossCorrelationDistance

domain [ 0, 2 )Method

862

Replaceid replacetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Replace

863

9.1.327 Send

bitmap

class name Sendcatalog name Basecatalog id baseclass id sendauthors Alessandro Fausto

Send a datatype to a receiver block or external application using various protocols.Thisnew version has the ability to declare the output datatype using the init informationsreceived from the ’SendToNetwork2’ block. When the block use the UDP v2.0 or TCP v1.0protocols you can change at run time the compression algorithm.

Inputs




This datatype is sent on the network.

Parameters

protocolid parameter modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:UDP v. 1.0UDP v. 2.0TCP v. 1.0

domain [ 0, 3 )The UDP version 1.0 is the eyesweb network protocol used before XMI 5.0.4. The

other two protocols are the newer versions.The UDP version 2.0 has better errors handlingand use less bandwidth than UDP version 1.0 protocol.The TCP version 1.0 use the sametechniques of UDP v2.0 but use one TCP stream to send the data.

864

Portid init info porttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

This is the local TCP port number where the sender wait for receiver connections.

Compressid compress algorithmtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:no compressionZLIB compression

domain [ 0, 2 )This parameter select what algorithm is used for data compression. At this time is

available no compression or zlib compression.

865

9.1.328 Set-Reset

bitmap

class name Set-Resetcatalog name Basecatalog id baseclass id SetResetauthors Gualtiero Volpe

This blocks implements a set-reset flip-flop.

Inputs

Setid Settype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool



Set the output to true.

Resetid Resettype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolrequired required for executionread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Reset the output to false.

Outputs

Outputid Outputtype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Active

866

Parameters

Initial stateid InitialStatetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Use this parameter to set the initial state of the flip-flop, i.e., whether at the start ofthe patch it should be set or reset.

Undefined behaviourid UndefinedBehaviourtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:IgnoreSetReset

domain [ 0, 3 )This option let you manually specify the behaviour of the block in cases where the

behaviour is usually undefined (set-reset bot specified at the same time). If set to ignorethe behaviour is undefined, thus, a warning is given and no output is generated. The otheroptions let you choose which is the prioritary input.

867

9.1.329 SetMousePosition

bitmap

class name SetMousePositioncatalog name Basecatalog id baseclass id SetMouseauthors Mirko Demurtas

This block moves the mouse to the given position

Inputs

Xid InputXtype Kernel, Int datatype (Kernel Catalog).type id kernel, int



X

Yid InputYtype Kernel, Int datatype (Kernel Catalog).type id kernel, int



Y

868

Parameters

Actionid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:MoveClickMove and Click

domain [ 0, 3 )Action

Buttonid TypeClicktype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LeftRight

domain [ 0, 2 )Button

869

9.1.330 SetNullROI

bitmap

class name SetNullROIcatalog name Basecatalog id baseclass id set null roiauthors Paolo Coletta

Set (or unset) the null flag of a ROI parameter

Inputs

Input Roiid input roitype Base, Roi 2D doubletype id base, roi2d double


read only/read write read writereferred as inplace IsNullreferred as inherited *no*

The input Roi on which to set the Null flag

Outputs

IsNullid output roitype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input Roiinherited id *no*

The NULL flag of the input Roi

Parameters



domain [ 0, 2 )

870

Specify whether input Roi has normalized floating-point (double) coordinates or integercoordinates

Nullid param nulltype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specify the value to assign to the Null flag of the Roi datatype received as input

871

9.1.331 SetROI

bitmap

class name SetROIcatalog name Basecatalog id baseclass id image set roi


Sets the Region Of Interest (ROI) of the image. Subsequent operations will only affectthe ROI instead of the whole image. – ERRORS – ’Coordinates type mismatch.’ The’Coordinates type’ parameter contain an invalid identifier, select a correct value from thedrop down list.

Inputs

Input imageid input video streamtype Kernel, Generic datatypetype id kernel, generic datatype



Input image

Required interfacesBase, ImageROI

Outputs

Output imageid output video streamtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input imageinherited id *no*

Output image

872

Parameters

Coordinates typeid coordinates typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Integer coordinatesFloating-point coordinates


be contained inside the boundaries of the first input image. Floating-point coordinates arenormalized in the range [0.0, 1.0] with respect to the size of the input image.

ROI coordinatesid double roitype Base, Roi 2D doubletype id base, roi2d double

ROI coordinates normalized in the range [0.0, 1.0] with respect to the size of the inputimage.

873

9.1.332 SetShapeProperties

bitmap

class name SetShapePropertiescatalog name Basecatalog id baseclass id set shape properties 2dauthors Paolo Coletta

This block changes the graphical appearance of the interior of graphical geometric ob-jects; in particular, it can change their fill color.

Inputs

Input Graphical Objectid inputtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace Output Graphical Objectreferred as inherited *no*

The input bidimensional graphical object of which to change the properties

Required interfacesBase, GraphicShape2D

Outputs

Output Graphical Objectid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input Graphical Objectinherited id *no*

A bidimensional graphical object where the shape properties have been changed by thisblock.

874

Parameters

SetFilledid set filledtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether to set the filled property of the graphical geometric datatype.

Filledid filledtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the shape is filled or not.

SetFillColorid set colortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether to set the color of the graphical geometric datatype.

FillColorid colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Specifies the color of the graphical geometric datatype.

SetFillAlphaid set alphatype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether to set the width of the graphical geometric datatype.

FillAlphaid alphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the alpha level of the graphical geometric datatype.

875

9.1.333 SetStrokeProperties

bitmap

class name SetStrokePropertiescatalog name Basecatalog id baseclass id set stroke properties 2dauthors Paolo Coletta

This block changes the graphical appearance of the contour of graphical geometric ob-jects; in particular, it can change their width and color.

Inputs

Input Graphical Objectid inputtype Kernel, Generic datatypetype id kernel, generic datatype


read only/read write read writereferred as inplace Output Graphical Objectreferred as inherited *no*

The input bidimensional graphical object of which to change the properties

Required interfacesBase, StrokeProperties

Outputs

Output Graphical Objectid outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input Graphical Objectinherited id *no*

A bidimensional graphical object where the stroke properties have been changed by thisblock.

876

Parameters

SetColorid set colortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether to set the color of the graphical geometric datatype.


Specifies the color of the graphical geometric datatype.

SetAlphaid set alphatype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool



Specifies the alpha level of the graphical geometric datatype.

SetWidthid set widthtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool


Widthid widthtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the width of the graphical geometric datatype.

877

9.1.334 Shape2DInfo-double

bitmap

class name Shape2DInfo-doublecatalog name Basecatalog id baseclass id extract blob2d infoauthors Paolo Coletta

Extracts informations about a Shape2D , such as baricenter, area and bounding rect-angle.

Remarks If parameter type is set to int value then the informations are absolute. Thevalue of area, baricenterand bounding rectangle are calculated in pixel. If the parameter isset to double value then theinformations are calculated in relative mode. The area is relativeto the entire image. For example area=0.5 menas thatthe area of the shape is half area ofthe entire image. The value of baricenter is relative to the image too. Baricenter=0.2meansthat the coordinates of the point is in the middle of the image. The same thing for therectangle.

Inputs

Shapeid inputtype Kernel, Generic datatypetype id kernel, generic datatype



Input shape

Required interfacesBase, Shape2DDouble

Outputs

Areaid areatype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

878

Area of the input shape

Baricenterid baricentertype Base, Point 2D doubletype id base, point 2d doubleinplace id *no*inherited id *no*

Baricenter of the input shape

BRid bounding recttype Base, Roi 2D doubletype id base, roi2d doubleinplace id *no*inherited id *no*

Bounding rectangle of the input shape

879

9.1.335 Shape2DInfo-int

bitmap

class name Shape2DInfo-intcatalog name Basecatalog id baseclass id extract blob2d info intauthors Paolo Coletta

Extracts informations about a Shape2D , such as baricenter, area and bounding rect-angle.

Remarks If parameter type is set to int value then the informations are absolute. Thevalue of area, baricenterand bounding rectangle are calculated in pixel. If the parameter isset to double value then theinformations are calculated in relative mode. The area is relativeto the entire image. For example area=0.5 menas thatthe area of the shape is half area ofthe entire image. The value of baricenter is relative to the image too. Baricenter=0.2meansthat the coordinates of the point is in the middle of the image. The same thing for therectangle.

Inputs

Shapeid inputtype Kernel, Generic datatypetype id kernel, generic datatype



Input shape

Required interfacesBase, Shape2DInt

Outputs

Areaid areatype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

880

Area of the input shape

Baricenterid baricentertype Base, Point 2D inttype id base, point 2d intinplace id *no*inherited id *no*

Baricenter of the input shape

BRid bounding recttype Base, Roi 2D inttype id base, roi2d intinplace id *no*inherited id *no*

Bounding rectangle of the input shape

881

9.1.336 Shape2DTracking-double

bitmap

class name Shape2DTracking-doublecatalog name Basecatalog id baseclass id blob 2d double matching


This block receives a list of shapes in input, and provide a labelled set of shapes asoutput. It tries to track the shapes in the input list: when a shape is found in consecutivelists it is assigned an unique label and added to the output labelled set. When the sameshape is found in subsequent lists, it is assigned the same label. In practice, if a shape ismatched, then its label does not change in the output labebel set; when new shapes areidentified new labels are generated and bound to such shapes. The criteria to match shapesin consecutive frames (lists) are its area and position; both criteria can be weighted with auser-given weight. If position is used, then a shape is matched with the nearest one in theprevious list, whereas if area is used a shape is matched with the one with the most similararea. The double version of the block expects floating-point coordinates from the user forthe area- and position-related paramaters. The floating-point coordinates are normalizedin the range [0.0 - 1.0] with respect to the size of the image from which the shapes wereextracted. Thus, for the position coordinates (0.0,0.0) is always the upper-left corner, and(1.0,1.0) is the lower-right corner.

Inputs

InputListid input blob listtype Kernel, Listtype id kernel, list




882

Outputs


Output labelled set of shapes

Parameters

AreaWeightid area weighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Area Weight

PositionWeightid position weighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Position Weight

Filtering criteriaid filtering criteriatype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:SpeedPosition

domain [ 0, 2 )Specifies whether to use speed or position to filter out shapes

InitialMaxSpeedid initial max speedtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Initial Max Speed

MaxSpeedid max speedtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Max Speed

883

InitialMaxDistanceid initial max distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Initial max distance

MaxDistanceid max distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Max distance

AllowOverlapsid allow overlapstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Allow Overlaps

TimeUnitid time unittype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:TimeFrames

domain [ 0, 2 )Specifies whether to use the time-based or frames-based parameters to tune the persis-

tence and redemption values

MinPersistenceTimeid min persistence timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Min Persistence Time

MaxPersistenceTimeid max persistence timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Max Persistence Time

MaxRedemptionTimeid max redemption timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Max Redemption Time

884

MinPersistenceFramesid min persistence framestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Min Persistence Frames

MaxPersistanceFramesid max persistence framestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Max Persistence Frames

MaxRedemptionFramesid max redemption framestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Max Redemption Frames

885

9.1.337 Shape2DTracking-int

bitmap

class name Shape2DTracking-intcatalog name Basecatalog id baseclass id blob 2d int matching


This block receives a list of shapes in input, and provide a labelled set of shapes asoutput. It tries to track the shapes in the input list: when a shape is found in consecutivelists it is assigned an unique label and added to the output labelled set. When the sameshape is found in subsequent lists, it is assigned the same label. In practice, if a shape ismatched, then its label does not change in the output labebel set; when new shapes areidentified new labels are generated and bound to such shapes. The criteria to match shapesin consecutive frames (lists) are its area and position; both criteria can be weighted witha user-given weight. If position is used, then a shape is matched with the nearest one inthe previous list, whereas if area is used a shape is matched with the one with the mostsimilar area. The integer version of the block expects integer coordinates from the user forthe area- and position-related paramaters. The integer cordinates are expressed in pixelsand are reletive to the image from which the shapes were extracted.

Inputs

InputListid input blob listtype Kernel, Listtype id kernel, list




Outputs


886

Output labelled set of shapes

Parameters

AreaWeightid area weighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Area Weight

PositionWeightid position weighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Position Weight

Filtering criteriaid filtering criteriatype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:SpeedPosition

domain [ 0, 2 )Specifies whether to use speed or position to filter out shapes

InitialMaxSpeedid initial max speedtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Initial Max Speed

MaxSpeedid max speedtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Max Speed

InitialMaxDistanceid initial max distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Initial max distance

887

MaxDistanceid max distancetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Max distance

AllowOverlapsid allow overlapstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Allow Overlaps

TimeUnitid time unittype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:TimeFrames

domain [ 0, 2 )Specifies whether to use the time-based or frames-based parameters to tune the persis-

tence and redemption values

MinPersistenceTimeid min persistence timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Min Persistence Time

MaxPersistenceTimeid max persistence timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Max Persistence Time

MaxRedemptionTimeid max redemption timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Max Redemption Time

MinPersistenceFramesid min persistence framestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Min Persistence Frames

888

MaxPersistanceFramesid max persistence framestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Max Persistence Frames

MaxRedemptionFramesid max redemption framestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Max Redemption Frames

889

9.1.338 Sigmoid

bitmap

class name Sigmoidcatalog name Basecatalog id baseclass id Sigmoidauthors Gualtiero Volpe

This block computes the sigmoid of the input value according to the specified parame-ters.

Inputs

id Inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Outputs


Parameters

id Atype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id Btype Kernel, Double datatype (Kernel Catalog).type id kernel, double

890

id HOfftype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id VOfftype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id SigTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:SigmoidInverse sigmoid

domain [ 0, 2 )

891

9.1.339 SignalGenerator

bitmap

class name SignalGeneratorcatalog name Basecatalog id baseclass id SignalGeneratorauthors Roberto Sagoleo

This block generates a signal according to the waveform specified as parameter.

Outputs

Output Signalid OutputSignaltype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output of the signal generator.

Parameters

Sampling Frequencyid SamplingFrequencytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Sampling frequency of the generated signal.

Signal Frequencyid SignalFrequencytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Signal frequency of the generated signal.

Signal Phaseid SignalPhasetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Signal phase of the generated signal.

892

Signal Offsetid SignalOffsettype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Signal offset of the generated signal.

Signal Amplitudeid SignalAmplitudetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Signal amplitude of the generated signal.

Output Typeid OutputTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:DoubleDouble Matrix [1xN]Double Matrix [Nx1]

domain [ 0, 3 )Output type of the generated signal.

Waveform Typeid WaveformTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:ZeroConstantSineCosineSquareTriangleSawTooth

domain [ 0, 7 )Waveform type of the generated signal.

Buffer Sizeid BufferSizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Size of the waveform signal buffer

893

9.1.340 Size2DGenerator

bitmap

class name Size2DGeneratorcatalog name Basecatalog id baseclass id point 2d generatorauthors Simone Ghisio

Generates a size datatype. Size datatype is made of two values: height and width. It’spossible to create a double or integer size. The block accepts as input a size value or heightand width values.

Outputs

output sizeid output valuetype Base, Size 2D inttype id base, size2d intinplace id *no*inherited id *no*

The output size datatype. Size is made of height and width integer or double.

Parameters


layoutCombo Box:sizedimensions

domain [ 0, 2 )It specifies the type of parameter by wich the output is modified. If the value is set to

’size’ value then the parameter is a size datatype. Otherwise it’s possible modified heightand width separately.

894


layoutCombo Box:integerdouble

domain [ 0, 2 )It specifies if the size output is integer or double.

integer heightid heighttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

It specifies integer height value of size datatype.

integer widthid widthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

It specifies integer width value of size datatype.

895

9.1.341 Size3DGenerator

bitmap

class name Size3DGeneratorcatalog name Basecatalog id baseclass id size 3d generatorauthors Simone Ghisio

Generates a tridimensional size, represented by 3 values of size.

Outputs

OutputSize3Did size outputtype Base, BaseGeometricSize3Doubletype id base, base geometric size 3d doubleinplace id *no*inherited id *no*

Output size 3D

Parameters



domain [ 0, 2 )Mode

XSizeid x parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Size on axis

YSizeid y parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

896

Size on y axis

ZSizeid z parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Size on z axis

897

9.1.342 Slope

bitmap

class name Slopecatalog name Basecatalog id baseclass id slope limiterauthors Paolo Coletta

Generates a linear slope from the current value to the target value

Outputs


Parameters

Initial valueid initial valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

target valueid current valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Up stepid up steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Down stepid down steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

898

Jumpid jumptype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

If triggered, the slope immediately jumps to the target value, wihtout repecting theUpStep or DownStep bounds


If triggered, the slope immediately reset the value to initial value, wihtout repecting theUpStep or DownStep bounds

899

9.1.343 Smoothness Index

bitmap

class name Smoothness Indexcatalog name Basecatalog id baseclass id smoothnessindexauthors Maurizio Mancini

Computes the smoothness index of an input trajectory.

Inputs

Input time seriesid inputtype Kernel, Generic datatypetype id kernel, generic datatype



It MUST be a sliding window time series containing the 2D coordinates of the sampledtrajectory.


Outputs

Smoothness Indexid outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

This is the smoothness index of the trajectory obtained by collecting the input points.

Parameters

Standard deviation lengthid stdlengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

900

Length of the internal buffer to compute curvature and velocity standard deviation.

Movement thresholdid movementthresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

If the input movement is less than this threshold the Smoothness Index is not computedand is set to the value of Upper Limit parameter value.

Upper Limitid upperlimittype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value of the Smoothness Index value is clipped by this value.

Output typeid outputtypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Smoothness IndexCurvatureVelocity

domain [ 0, 3 )The block can compute the trajectory smoothness, curvature and velocity.

901

9.1.344 SortMatrix - double

bitmap

class name SortMatrix - doublecatalog name Basecatalog id baseclass id sort doublematrixauthors Paolo Coletta

Sort items of a matrix.

Inputs




Input matrix of real values to be sorted.

Outputs

Outputid outputtype Kernel, Double matrix.type id kernel, double-matrixinplace id Inputinherited id *no*

Output matrix containing the sorted values.

Rows mapid row map idtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Specifies the row of the final position of the corresponding item. If item (i, j) has beenmoved to position (m, n), the (i, j) item of this matrix contains value m (destination row).

902

Columns mapid column map idtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Specifies the column of the final position of the corresponding item. If item (i, j) hasbeen moved to position (m, n), the (i, j) item of this matrix contains value n (destinationcolumn).

Parameters

Sort modeid sort modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Sort by row (fixed row)Sort by column (fixed column)Global sort (change row and column)

domain [ 0, 2 ]Specifies how to move the element inside the matrix. If sort mode is by row, then the

items are moved inside the same row. If the sort mode is by column, then the elementsare moved inside the same column. The global mode let items to move both in row andcolumn, thus a global ordering can be found.

Orderid sort ordertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AscendingDescendingShuffle

domain [ 0, 2 ]Specifies wether to use an ascending, descending, or shuffle order.

Generate mapid generate maptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies weather the block must generate as output the map used to sort the items. Bydefault it is enabled, however, since it may be CPU intensive for huge matrices, it can bedisabled.

903

9.1.345 SortMatrix - int

bitmap

class name SortMatrix - intcatalog name Basecatalog id baseclass id sort intmatrixauthors Paolo Coletta

Sort items of a matrix.

Inputs




Input matrix of real values to be sorted.

Outputs

Outputid outputtype Kernel, Integer matrix.type id kernel, int-matrixinplace id Inputinherited id *no*

Output matrix containing the sorted values.

Rows mapid row map idtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Specifies the row of the final position of the corresponding item. If item (i, j) has beenmoved to position (m, n), the (i, j) item of this matrix contains value m (destination row).

904

Columns mapid column map idtype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Specifies the column of the final position of the corresponding item. If item (i, j) hasbeen moved to position (m, n), the (i, j) item of this matrix contains value n (destinationcolumn).

Parameters

Sort modeid sort modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Sort by row (fixed row)Sort by column (fixed column)Global sort (change row and column)

domain [ 0, 2 ]Specifies how to move the element inside the matrix. If sort mode is by row, then the

items are moved inside the same row. If the sort mode is by column, then the elementsare moved inside the same column. The global mode let items to move both in row andcolumn, thus a global ordering can be found.

Orderid sort ordertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AscendingDescendingShuffle

domain [ 0, 2 ]Specifies wether to use an ascending, descending, or shuffle order.

Generate mapid generate maptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies weather the block must generate as output the map used to sort the items. Bydefault it is enabled, however, since it may be CPU intensive for huge matrices, it can bedisabled.

905

9.1.346 SpawnCommand

bitmap

class name SpawnCommandcatalog name Basecatalog id baseclass id spawn commandauthors Simone Ghisio

Creates and executes a new process, concurrently with the caller (this) process, basingon the spawn system call. The input string has this syntax: cmdname arg1 arg2 arg3 ...argn. The cmdname argument specifies the file that is executed as the new process andcan specify a full path (from the root), a partial path (from the current working directory),or just a filename. If cmdname does not have a filename extension or does not end with aperiod (.), the spawn function first tries the .COM extension, then the .EXE extension, the.BAT extension, and finally the .CMD extension.If cmdname has an extension, only thatextension is used. If cmdname ends with a period, the spawn call searches for cmdnamewith no extension.If cmdname contains a drive specifier or any slashes (that is, if it is arelative path), the spawn call searches only for the specified file; no path searching is done.arg1 arg2 ... argn are the arguments to the new process.

Inputs

Input Commandid command stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string



The command-line of the process to be executed

Parameters

Allow duplicatesid allow duplicatestype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, dusplicates commands are executed. If set to false, only the first occuranceis executed

906

9.1.347 SpecialCharacterGenerator

bitmapChar.png Char.png

class name SpecialCharacterGeneratorcatalog name Basecatalog id baseclass id Special Charauthors Mirko Demurtas

This block generates a special character, such as a newline, a tab, etc.

Outputs

Stringid Outputtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

String

Parameters

Special Charid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:\n\r\tSPACE

domain [ 0, 4 )Special Char

907

9.1.348 SpectralEnvelopExtractor

bitmap

class name SpectralEnvelopExtractorcatalog name Basecatalog id baseclass id spectral envelope extractorauthors Paolo Coletta

Performs analysis on the FFT

Inputs

fftid ffttype Base, Audio FFT buffertype id base, audio fftbuffer



Input: Fast Fourier Transform

Outputs

maxima valuesid maxima valuestype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

If Inferior armonics=False: Output: Matrix of maxima values (Number of ChannelX Number of armonics + 1) The Pitch value is at the beginning of the buffer of everychannel If Inferior armonics=True: Output: Matrix of maxima values (Number of ChannelX (Number of armonics * 2) + 1) The Pitch value is in the center of the buffer of everychannel. Inferior armonics are stored in a simmetric way as the superior armonics.

908

maxima frequenciesid maxima frequenciestype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

If Inferior armonics=False: Output: Matrix of maxima frequencies (Number of ChannelX Number of armonics + 1) The Pitch frequencies is at the beginning of the buffer ofevery channel If Inferior armonics=True: Output: Matrix of maxima frequencies (Numberof Channel X (Number of armonics * 2) + 1) The Pitch frequencies is in the center of thebuffer of every channel. Inferior armonics are stored in a simmetric way as the superiorarmonics.

Parameters

pitchid pitchtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Pitch is the perceived fundamental frequency of a sound.

number of armonicsid number of armonicstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of armonics to try

Inferior Armonicsid Inferior Armonicstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If selected find also inferior armonics

interval scaling factorid interval scaling factortype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Interval scaling factor that increase/decrease the range of searching of armonics

909

9.1.349 SpectrumAnalyzer

bitmap

class name SpectrumAnalyzercatalog name Basecatalog id baseclass id spectrum analyzerauthors Paolo Coletta

Make a graphic equalization of the Fft

Inputs

Fftid Ffttype Base, Audio FFT buffertype id base, audio fftbuffer



Fft signal

Outputs

Spectrumid Spectrumtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Spectrum

Parameters

Frequenciesid matrix paramtype Kernel, Double matrix.type id kernel, double-matrix

Vector of Frequencies

910

9.1.350 SpectrumCompare

bitmap

class name SpectrumComparecatalog name Basecatalog id baseclass id SpectrumCompareauthors Simone Ghisio

This block compares the spectrum input matrix

Inputs

Inputid InputMatrixtype Kernel, Double matrix.type id kernel, double-matrix



Input

Outputs

Outputid Outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Output

Parameters

Percid Perctype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Perc Range

911

learningid learningtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LearningWorking

domain [ 0, 1 ]learning ON OFF

Pathid Pathtype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”Bin files (*.bin)—*.bin—All files (*.*)—*.*——”

Path file

ThreshZeroid ThreshZerotype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Threshold Zero

912

9.1.351 StereoCorrespondence

bitmap

class name StereoCorrespondencecatalog name Basecatalog id baseclass id stereocorrespondenceauthors Maurizio Mancini


Inputs

Input image 1id sc input1type Base, Imagetype id base, image



The first image provided as input.

Input image 2id sc input2type Base, Imagetype id base, image



The second image provided as input.

Outputs

Stereo correspondenceid sc outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

913

The stereo correspondence.

Parameters

Number of disparitiesid sc disparitiestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of disparities of the graph cut-based stereo correspondence algorithm.

Maximum number of iterationsid sc iterationstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

On each iteration all possible (or reasonable) alpha-expansions are tried.

914

9.1.352 StringDelimiters

bitmap

class name StringDelimiterscatalog name Basecatalog id baseclass id string delimitersauthors Simone Ghisio

Add specified delimiters to input string.

Inputs

InputStringid input stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string



Input string to delimit

Outputs

OutputStringid output stringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

Output string delimited

Parameters

Beginid begintype Kernel, String datatype (Kernel Catalog).type id kernel, string

First delimiter

915

Endid endtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Second delimiter

916

9.1.353 StringSelector

bitmap

class name StringSelectorcatalog name Basecatalog id baseclass id string selectorauthors Simone Ghisio

Select a string form string parameters.

Inputs

Selectorid selecttype Kernel, Int datatype (Kernel Catalog).type id kernel, int



Index of parameter string to select.

Outputs

SelectedStringid output stringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

String selected from parameters.

Parameters

StringNumberid num stringtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Number of strings from which select the output one.

917

string00id string 00type Kernel, String datatype (Kernel Catalog).type id kernel, string

String 00.

string01id string 01type Kernel, String datatype (Kernel Catalog).type id kernel, string

String 01.

918

9.1.354 StringToInt

bitmap

class name StringToIntcatalog name Basecatalog id baseclass id string to intauthors Paolo Coletta

Converts a string representation of an integer number, to the corresponding integernumber.

Inputs

InputStringid inputtype Kernel, String datatype (Kernel Catalog).type id kernel, string



The input string should contain only digits (optionally an initial sign) to be convertibleto int.

Outputs

OutputIntid outputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

The integer number

919

9.1.355 StringToScalar

bitmap

class name StringToScalarcatalog name Basecatalog id baseclass id string to scalarauthors Simone Ghisio

Convertrs a string into a number.

Inputs

InputStringid inputtype Kernel, String datatype (Kernel Catalog).type id kernel, string



The input string should contain only digits (optionally an initial sign) to be convertibleto int.

Outputs

OutputIntid outputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The integer number

920

Parameters



domain [ 0, 2 )Mode

921

9.1.356 SymmetryIndex

bitmap

class name SymmetryIndexcatalog name Basecatalog id baseclass id symmetryindexauthors Maurizio Mancini

This block computes the symmetry index of a given blob.

Inputs

Input blobid symmetryindex blobinputtype Base, Blob 2Dtype id base, blob2d



Input blob, on which the symmetry index is computed.

Outputs

Symmetry Indexid symmetryindex indexoutputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

The symmetry index of the input blob.

922

9.1.357 Synchronizer

bitmap

class name Synchronizercatalog name Basecatalog id baseclass id Synchronizerauthors Alberto Massari

This block ensures that the data coming to the input channels has the specified duration

Inputs

Input data 1id Input1type Base, Imagetype id base, image


read only/read write read writereferred as inplace *no*referred as inherited Output data 1

The data to be synchronized

Outputs

Output data 1id Output1type Kernel, Generic datatypetype id kernel, generic datatypeinplace id Input data 1inherited id *no*

The synchronized version of the input data

Parameters

Temporal Windowid Temporal Windowtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

923

The duration of each generated output (in msec); if set to 0, the duration is taken fromthe first input

Number of Inputsid Number of Inputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( 0, +infinity )

The number of inputs to be synchronized

Input 1 Typeid Input 1 Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:VideoAudioGeneric TimeSeries

domain [ 0, 3 )The type of the Nth input

924

9.1.358 ThresholdCrossingDetector

bitmap

class name ThresholdCrossingDetectorcatalog name Basecatalog id baseclass id audio threshold

authors

Andrea RicciMassimiliano PeriPaolo ColettaAlberto Massari

Detects wether the audio signal has gone over a specified threshold; provides the samplewhere the threshold has been exceeded

Inputs



read only/read write read writereferred as inplace *no*referred as inherited Audio output sample

This is the audio stream where the threshold overcoming is searched for. Event if thismight also be a multichannel audio stream, only one channel is analized when looking forthe threshold (the channel is specified via the parameters of the block).


Outputs

Audio output sampleid output sampletype Kernel, Generic datatypetype id kernel, generic datatypeinplace id Audio input streaminherited id *no*

The audio sample that begins at the sample where the threshold has been crossed.

925

Over-threshold valueid output valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Value of the first sample that exceeded the threshold. This is the original value, even ifthe block is working in absolute (unsigned) mode. That is, it may also be a negative value.


Index of the first sample that exceeded the threshold. Note that this output, as well asthe ”over-threshold value” output, is generated only when the threshold is exceeded. If thethreshold is not exceeded, no output is generated.

Sample Channelid output sample channeltype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Index of the channel that exceeded the threshold. Note that this output, as well as the”over-threshold value” output, is generated only when the threshold is exceeded. If thethreshold is not exceeded, no output is generated.

Parameters


Value to be compared to each sample in the specified channel.


layout

Combo Box:BothUpDown

domain [ 0, 3 )

926

Direction in which the overcoming must occur for this block to generate an output. Ifdirection is ”Up” then an output is generated only when the sample values is bigger orequal than the threshold and the previous sample value is less than the threshold. The”Down” direction mean that a sample is less or equal than the threshold and the previousone is bigger than the threshold. The ”Both” direction occurs in both cases.

Sign modeid signmodetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Absolute valueSigned value (original value)

domain [ 0, 2 )This parameter specifies wether the value of the sample is analyzed as it is, or if it

absolute value is kept into account.

Sample delayid sample offsettype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of samples after the point where the threshold was crossed from which theoutput sample will be extracted. It can be a negative number.

Under-threshold samplesid sample offset outtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

The output audio sample will contain at most N consecutive samples that are belowthe given threshold, after which it will be silenced; when N==0, the original audio will bereported

Sample Lengthid sample lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( 0, +infinity )

This value specifies the number of samples that will be extracted into the output audiobuffer, starting at the sample position where the threshold has been crossed.

Normalize output signalid normalize sampletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

927

Specifies whether the output signal will be normalized, so that its energy will be equalto 1

928

9.1.359 ThresholdCrossingDetector

bitmap

class name ThresholdCrossingDetectorcatalog name Basecatalog id baseclass id ThresholdCrossingauthors Gualtiero Volpe

This blocks outputs a bang whenever a given threshold is crossed.

Inputs

Inputid Inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input value.

Outputs

Outputid Outputtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

An output bang is returned whenever the given threshold is crossed.

929

Parameters

Crossing directionid Modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:BothUpwardDownward

domain [ 0, 2 ]Three directions for threshold crossing are available: upward, downward,and both.

Thresholdid Thresholdtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The value of the threshold.

930

9.1.360 Time series reader

bitmap

class name Time series readercatalog name Basecatalog id baseclass id timeSeriesReaderauthors Alessandro Fausto

Read from file a previously dumped time series (single channel). The sample can bewrited using 32bit or 64bit floating point format.

Outputs

Outputid outputtype Base, TemporalDatatype id base, temporal datainplace id *no*inherited id *no*

This is the output time series

Parameters

Fileid param filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


Each channel is saved into a filename created appending the channel number to thisfilename. The extension is set to .raw

931

Formatid param formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:32bit float (float)64bit float (Double)Normalized 32bit float (float)Normalized 64bit float (Double)

domain [ 0, 4 )Defines the format used to write the sample into the file : ’float’ each sample is writed

as 32bit floating value; ’double’ each sample is writed as 32bit floating value;

Number of samplesid param numberOfSamplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( 0, +infinity )

number of samples stored into the TimeSeries datatype

Nominal Frequencyid param nominalFrequencytype Kernel, Double datatype (Kernel Catalog).type id kernel, double


Range Minid param rangeMintype Kernel, Double datatype (Kernel Catalog).type id kernel, double


Range Maxid param rangeMaxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double


932

9.1.361 Time series writer

bitmap

class name Time series writercatalog name Basecatalog id baseclass id timeSeriesWriterauthors Alessandro Fausto

Write each channel of input time series as raw files. The sample can be writed using32bit or 64bit floating point format.

Inputs

Inputid inputtype Base, TemporalDatatype id base, temporal data




Parameters

Fileid param filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”All files (*.*)—*.*——”

Each channel is saved into a filename created appending the channel number to thisfilename. The extension is set to .raw

933

Formatid param formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:32bit float (float)64bit float (Double)Normalized 32bit float (float)Normalized 64bit float (Double)

domain [ 0, 4 )Defines the format used to write the sample into the file : ’float’ each sample is writed

as 32bit floating value; ’double’ each sample is writed as 32bit floating value;

934

9.1.362 TimeSeries2Matrix

bitmap

class name TimeSeries2Matrixcatalog name Basecatalog id baseclass id TimeSeries2Matrixauthors Alessandro Fausto

Translate one static time series into a matrix.

Inputs






Outputs

output matrixid outputMatrixtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

This matrix contains the values of input time series

935

Parameters

Modeid Output Modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:By rowBy columnAutomatic

domain [ 0, 3 )Defines how the matrices are converted into time series: ’By row’ generate the time

series using one rows per channel. The number of samples is fixed and equal to the numberof columns. ’By column’ generate the time series using one columns per channel. Thenumber of samples is fixed and equal to the number of rows.’Automatic’ generate the timeseries using this rules . if the number of row is greater than number of column the timeseries is generated using the ’By row’ mode, otherwise is used the ’By column’ mode.

936

9.1.363 TimeSeriesGenerator

bitmap

class name TimeSeriesGeneratorcatalog name Basecatalog id baseclass id TimeSeriesBuilder

authorsAlberto MassariGualtiero Volpe

Creates a TimeSeries datatype aggregating single values.The user can choose to generatea time series with static o dynamic lenght.The first case is the default mode, in this mode thedatatype is generated when the buffer is completely filled.In the second case the TimeSeriesis generated when the maximum number of samples is reached or when the user trigger the’generate’ parameter. A minimum and maximum threshold can be applied to the inputvalue. – REMARKS – Whit dynamic TimeSeries the input values are appended to theinternal buffer.If the ’generate’ parameter is never triggered the internal buffer grow insize without any limit’ In the future a ’maximum size’ parameter can appear in order tolimit the maximum length of TimeSeries. When this limit is reached the TimeSeries isautomatically generated. – ERRORS – ’Out of memory.’ The TimeSeries has completelyfilled the available memory.

Inputs

single valueid single value 0type Kernel, Double datatype (Kernel Catalog).type id kernel, double



A single value to be added to the series

Outputs

outputid outputtype Base, TemporalDatatype id base, temporal datainplace id *no*inherited id *no*

The generated TimeSeries

937

Parameters

Output Typeid Output Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Static time seriesDynamic time series

domain [ 0, 2 )It specifies whether the blok generates a static time series or a dynamic time series

Number of Channelsid Number of Channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The number of inputs that will be stored as different channels in the resulting TimeSeriesdatatype

Nominal Frequencyid Nominal Frequencytype Kernel, Double datatype (Kernel Catalog).type id kernel, double


Range Minid Range Mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double


Range Maxid Range Maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double


Buffer Lengthid Buffer Lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( 1, +infinity )

The number of samples stored in a single instance of the output

938


layoutCombo Box:BufferSliding window

domain [ 0, 2 )It specifies whether a time series buffer is returned only when it is full or a sliding

windows mechanism is used.

939

9.1.364 Translate

bitmap

class name Translatecatalog name Basecatalog id baseclass id TranslateObject2Dauthors Mirko Demurtas

This block translates the input geometric or graphic 2D object.

Inputs




The input 2D object to be translated.


Outputs


The output translated 2D object.

Parameters

Translation along Xid DXtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

940

The translation to be applied to the input object along the X axis.

Translation along Yid DYtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The translation to be applied to the input object along the Yaxis.

Computeid Computetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If true the block computes the transformation on the vertexes of the object. If falsethe transformation is applied to the entire object.If the input object is graphic and theparameter is set to false the translation is visible, otherwise if the parameter is set to true,the vertexes of the object is actually translated and the object is redrawn changing theorigin of the axis, so the translation might not be visible. If in the patch some blocksof transformation are used(Rotate, Scale, Translate) each one that set Compute to truecomputes alle the previous transformation on the vertexes.

941

9.1.365 Translate3D-Double

bitmap

class name Translate3D-Doublecatalog name Basecatalog id baseclass id translate 3d doubleauthors Simone Ghisio

Translate the 3D object, updating translate values. The block doesn’t apply the tran-sofmration to the object. It means that translation values are updating, but not the coor-dinates.

Inputs




Generic input 3D

Required interfacesbase, 3d translate double

Outputs


Output3D.

942

Parameters

TranslationXid param x translationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Translation on x axis.

TranslationYid param y translationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Translation on y axis.

TranslationZid param z translationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Translation on z axis.

943

9.1.366 Translate3D-Int

bitmap

class name Translate3D-Intcatalog name Basecatalog id baseclass id translate 3d intauthors Simone Ghisio

Translate the 3D object, updating translate values. The block doesn’t apply the tran-sofmration to the object. It means that translation values are updating, but not the coor-dinates.

Inputs




Generic input 3D

Required interfacesbase, 3d translate int

Outputs


Output3D.

944

Parameters

TranslationXid param x translationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Translation on x axis.

TranslationYid param y translationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Translation on y axis.

TranslationZid param z translationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Translation on z axis.

945

9.1.367 Triangle3DGenerator

bitmap

class name Triangle3DGeneratorcatalog name Basecatalog id baseclass id triangle 3d generatorauthors Simone Ghisio

Generates a tridimensional triangle, represented by 3 points.

Outputs

OutputLine3Did line outputtype Base, BaseGeometricTriangle3Doubletype id base, base geometric triangle 3d doubleinplace id *no*inherited id *no*

Output Line 3D

Parameters



domain [ 0, 2 )Mode

XACoordinateid xa parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate of first point

YACoordinateid ya parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

946

Y coordinate of first point

ZACoordinateid za parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate of first point

XBCoordinateid xb parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate of second point

YBCoordinateid yb parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Y coordinate of second point

ZBCoordinateid zb parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate of second point

XCCoordinateid xc parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate of third point

YCCoordinateid yc parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Y coordinate of third point

ZCCoordinateid zc parametertype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate of third point

947

9.1.368 TriangleSymmetryIndex

bitmap

class name TriangleSymmetryIndexcatalog name Basecatalog id baseclass id trianglesymmetryindexauthors Maurizio Mancini

This block computes the symmetry index of a given triangle. You have to providethe triangle vertices as input (upper vertex, left vertex, right vertex). The output variesbetween 0 (perfect symmetry) and 1 (total asymmetry).

Inputs

Triangle upper vertexid trianglesymmetryindexinput1type Base, Point 2D doubletype id base, point 2d double



This is the upper vertex of the triangle on which we compute the symmetry index.

Triangle left vertexid trianglesymmetryindexinput2type Base, Point 2D doubletype id base, point 2d double



This is the upper vertex of the triangle on which we compute the symmetry index.

948

Triangle right vertexid trianglesymmetryindexinput3type Base, Point 2D doubletype id base, point 2d double



This is the right vertex of the triangle on which we compute the symmetry index.

Outputs

Triangle symmetry indexid trianglesymmetryoutputtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

This is the symmetry index of the input triangle.

949

9.1.369 Trigger

bitmap

class name Triggercatalog name Basecatalog id baseclass id Triggerauthors Marzia Simonetti

This block acts like a switch which is always open, i.e., data does not pass through it.When a command is given the switch is closed just the time to let one datatype to passthrough, then, the switch is open again

Inputs

Trigger nameid Inputtype Kernel, Generic datatypetype id kernel, generic datatype



Trigger input description

Outputs

Trigger Output nameid Outputtype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Trigger Output description

Parameters

Trigger close parameterid Parametertype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Trigger close parameter description

950

9.1.370 VectorDecomposer

bitmap

class name VectorDecomposercatalog name Basecatalog id baseclass id VectorDecomposerauthors Roberto Sagoleo

Extracts one or more items from a vector.

Inputs

input vectorid input vectortype Kernel, Integer matrix.type id kernel, int-matrix



Input vector to be decomposed.

Outputs

output scalarid output scalar000type Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

N-th Scalar output.

output scalarid output scalar001type Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

N-th Scalar output.

951

Parameters



domain [ 0, 2 )Defines the type of the output matrix (integer or double): integer: the output matrix

will be of integer values. double : the output matrix will be of double values.

number of output scalarsid number of output scalarstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Number of scalar outputs.

952

9.1.371 VectorGenerator

bitmap

class name VectorGeneratorcatalog name Basecatalog id baseclass id VectorGeneratorauthors Gualtiero Volpe

This block generates a vector whose values are set according to a function specified asparameter.

Outputs

Output vectorid VectorOutputtype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The generated output vector.

Parameters

Output typeid OutputTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:RealInteger

domain [ 0, 2 )The desired type of the items of the output vector. It can be either integer or real.

Sizeid Sizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The size of the output vector.

953

Row vectorid RowVectortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Set this parameter to true if you want the output vector to be a row vector; set it tofalse otherwise.

Output functionid OutputFunctiontype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Progressive

The output function that generates the items in the output vector.

Startid Starttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The starting value for the progressive vector.

Stepid Steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The step (distance between two consecutive numbers in the vector) for the progressivevector.

954

9.1.372 VectorRemapper

bitmap

class name VectorRemappercatalog name Basecatalog id baseclass id VectorRemapperauthors Gualtiero Volpe

This block remaps and quantizes the items in the input vector.

Inputs

Input Vectorid InputVectortype Kernel, Double matrix.type id kernel, double-matrix



Input vector to be remapped

Outputs

Output vectorid OutputVectortype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

Remapped output vector

Parameters

Number of itemsid NumberOfItemstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of items in the output vector

955

Low boundid LowBoundtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Lower bound of the output vector

High boundid HighBoundtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Higher bound of the output vector

Show warningsid ShowWarningstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set warnings are shown in the EyesWeb message bar

956

9.1.373 VibeExtraction

bitmap

class name VibeExtractioncatalog name Basecatalog id baseclass id vibeextractionauthors Maurizio Mancini

Extract silhouette using the Vibe algorithm.

Inputs

Input imageid vibeextraction inputtype Base, Imagetype id base, image



The image on which perform the background subtraction. Use a BW or RGB forma,otherwise conversion will occur.

Outputs

Output imageid vibeextraction outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

The segmented output image, with background pixels in black and foreground pixels inwhite.

Parameters

number of samplesid vibeextraction samplesnumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int

957

Specifies the number of samples used in the internal model. This parameter is appliedonly on patch startup or when resetting the model.

matching thresholdid vibeextraction matchingthresholdtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

This parameter is applied only on patch startup or when resetting the model.

matching numberid vibeextraction matchingnumbertype Kernel, Int datatype (Kernel Catalog).type id kernel, int


update factorid vibeextraction updatefactortype Kernel, Int datatype (Kernel Catalog).type id kernel, int


Resetid vibeextraction resettype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Causes the internal model to be reset discarding all data.

958

9.1.374 VideoGram

bitmap

class name VideoGramcatalog name Basecatalog id baseclass id video gramauthors Paolo Coletta

Computes an horizontal or vertical videogram given an image as input. For more infoabout motiongrams and videograms, see ”Jensenius, A. R. (2006). Using motiongrams inthe study of musical gestures. In Proceedings of the 2006 International Computer MusicConference, 6-11 November, New Orleans.”

Inputs

videoimageid video imagetype Base, Imagetype id base, image



(BW) video image

Outputs

videogramid video gramtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Videogram

959

Parameters

lengthid lengthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of frames needed to build a full motiongram


layoutCombo Box:HorizontalVertical

domain [ 0, 2 )Specifies whether the videogram is horizontal or vertical




Directionid end of image modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:LoopScoll


960

9.1.375 VideoTapeRecorder

bitmap

class name VideoTapeRecordercatalog name Basecatalog id baseclass id video tape recorderauthors Paolo Coletta

Controls a Video Tape Recorder (VTR) device

Notes With the partial support of the EU ICT Project MIROR (Musical InteractionRelying on Reflexion), 2010-2012

Outputs

Timecodeid timecodetype Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

Statusid statustype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Provides an integer number representing the status of the device according to the fol-lowing schema:

-1: unknown status0: device error1: playing2: stopped3: paused4: fast forward5: rewind6: recording7: paused recording

961

Parameters

Deviceid device nametype Kernel, String datatype (Kernel Catalog).type id kernel, string

Name of the virtual device. If none is specified, the default device will be used

Rewindid rewindtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Step Backwardid step backwardtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger




Step Forwardid step forwardtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

FastForwardid fast forwardtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

962

Recordid recordtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Pause Recordid pause recordtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

963

9.1.376 WMVFileReader

bitmap

class name WMVFileReadercatalog name Basecatalog id baseclass id WMVReaderauthors Massimiliano Peri

Read WMV files

Parameters


layout


WMV file path

Load File Infoid load file infotype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Load file information and modify the block signature

Make Indicesid make indicestype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Make indices for the selected file. With indices the seeking of the file is more accurate

Start timeid start timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Start time

964

Durationid durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Duration of playback

965

9.1.377 WMVFileWriter

bitmap

class name WMVFileWritercatalog name Basecatalog id baseclass id WMVWriterauthors Massimiliano Peri

Write WMV Files

Parameters


layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”Windows media video files (*.wmv)—*.wmv—All files (*.*)—*.*——”

Path of the destination file

966

Profileid prof modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Custom352x288 3 Mbps 44100 Hz352x288 3 Mbps 48000 Hz352x288 6 Mbps 44100 Hz352x288 6 Mbps 48000 Hz352x288 3 Mbps352x288 6 Mbps768x576 3 Mbps 44100 Hz768x576 3 Mbps 48000 Hz768x576 6 Mbps 44100 Hz768x576 6 Mbps 48000 Hz768x576 8 Mbps 44100 Hz768x576 8 Mbps 48000 Hz768x576 12 Mbps 44100 Hz768x576 12 Mbps 44800 Hz768x576 3 Mbps768x576 6 Mbps768x576 8 Mbps768x576 12 Mbps

domain [ 0, 19 )Profile type

Windows Media Profile filenameid filename settingstype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Windows media profile files(*.prx)—*.prx—All files (*.*)—*.*——”

Path of the Windows Media Profile file

Compression rate (Kbps)id compression ratetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Video Bitrate (Kbps)

967

Input frame rateid video input fpstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Input frame rate

Number of text input streamid text stream counttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of text input stream

Vertical Mirrorid vert mirrortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Vertical Mirror

Recid rectype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Rec


Pause


Stop

968

9.1.378 WaveFileWriter

bitmap

class name WaveFileWritercatalog name Basecatalog id baseclass id audiosaveauthors Mirko Demurtas

Save the audio stream to a wave file. Each sample is converted to the 8bit or 16bitformat

Inputs

Audioid input audio streamtype Base, Audio buffertype id base, audio buffer



Audio

Parameters

Name Fileid filetype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”Audio File(*wav)—*.wav—All files (*.*)—*.*——”

File Name

969

File Formatid formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:PCM8PCM16

domain [ 0, 2 )PCM Format

970

9.1.379 WeightedVectorDistance

bitmap

class name WeightedVectorDistancecatalog name Basecatalog id baseclass id WeightedVectorDistanceauthors Gualtiero Volpe

This block computes the distance between the input vectors applying to componentsthe weights provided as parameter. The degree of the distance can also be chosen (beingdegree = 2 the traditional Euclidean distance).

Inputs

id InXtype Kernel, Double matrix.type id kernel, double-matrix



id InYtype Kernel, Double matrix.type id kernel, double-matrix



Outputs


971

Parameters

id Degreetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

id UseWeightstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

id Weightstype Kernel, Double matrix.type id kernel, double-matrix

972

9.1.380 WriteImage

bitmap

class name WriteImagecatalog name Basecatalog id baseclass id write imageauthors Paolo Coletta

Write an image to file

Notes Replaces a previous block named JPEGWriter

Inputs

Input Imageid inputtype Kernel, Generic datatypetype id kernel, generic datatype



Required interfaceskernel, image exchange format

Parameters

Destination pathid pathtype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”Jpeg files (*.jpg,*.jpeg)—*.jpg;*.jpeg—Portable Network graphics files (*.png)—*.png—Bitmap files (*.bmp,*.wbmp)—*.bmp;*.wbmp—Tagged Image File Format files (*.tiff)—*.tiff—Targa files (*.tga)—*.tga—All image files—*.jpg;*.jpeg;*.png;*.bmp;*.wbmp;*.tiff;*.tga—All files (*.*)—*.*——”

Full pathname of the destination file

973

Image File typeid image file typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:JpegTGABMPJNGKOALALBMIFFMNGPBMRAWPCDPCXICOPBMPGMPGMRAWPNGPPMPPMRAWRASTIFFWBMPPSDCUTXBMXPMDDSGIFHDRFAXG3SGIEXRJ2KJP2PFMPICTRAWAutomatic

domain [ 0, 37 )Specifies the type of the image. Specifying the image type, instead of letting the block

deduce it from the image header, may reduce the time needed to load the image

974

Qualityid qualitytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Quality of the compression(if used). This parameter only affects compressed formats.Some formats do not guarantee a continuos tuning of the quality; in such case the givenvalue may be quantized to the appropriate number of levels. In any case, when the qualityparameter is used, 0.0 is the lowest quality, 1.0 is the highest quality.

975

9.1.381 WriteMatrixToFile - double

bitmap

class name WriteMatrixToFile - doublecatalog name Basecatalog id baseclass id doublematrix to fileauthors Paolo Coletta

Writes a matrix of double numbers to a text file.

Inputs

Input matrixid valuetype Kernel, Double matrix.type id kernel, double-matrix



Input matrix

Parameters


layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”Text files (*.txt)—*.txt—All files (*.*)—*.*——”


976

9.1.382 WriteMatrixToFile - int

bitmap

class name WriteMatrixToFile - intcatalog name Basecatalog id baseclass id intmatrix to fileauthors Paolo Coletta

Writes a matrix of integer numbers to a text file.

Inputs

Input matrixid valuetype Kernel, Integer matrix.type id kernel, int-matrix



Input matrix

Parameters


layout



977

9.1.383 WriteToFile

bitmap

class name WriteToFilecatalog name Basecatalog id baseclass id WriteFileauthors Mirko Demurtas

This block writes multiple streams of data to a proprietary EyesWeb file format. Filesusually have extension ”.ebf”.

Inputs

Inputid Input000type Kernel, Generic datatypetype id kernel, generic datatype



Input

Parameters

Name Fileid Filetype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=true,OverwritePrompt=true,Filter=”Eyesweb Binary File (*.ebf)—*.ebf—(*.txt)—*.txt—All files (*.*)—*.*——”

Name File

978

File modeid FileModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:OVERWRITEAPPEND

domain [ 0, 2 )File mode

Raw Modeid Rawtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Raw Mode

TimeStampid TimeStamptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

TimeStamp

Data Separatorid SeparatorDatatype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:SPACETAB;

domain [ 0, 3 )Data Separator

In Matrix Separatorid MatrixDatatype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:SPACETAB;

domain [ 0, 3 )In Matrix Separator

979

Row Separatorid SeparatorRowtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CR/LFCRLF

domain [ 0, 3 )Row Separator

File Separatorid SeparatorFiletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CR/LFCRLF

domain [ 0, 3 )File Separator

n Inputid nInputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

n Input

Enable Stop Timeid bTimeStoptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable Stop Time

Stop Timeid TimeStoptype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Stop Time

Enable Stop Patchid PatchStoptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

980

If enabled, the file writer status is switched to STOP as the user stops the patch execu-tion

Recorder Statusid RecorderStatustype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RecordPauseStop

domain [ 0, 3 )Recorder Status

Recordid Recordtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Record

Pauseid Pausetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Pause

Stopid Stoptype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Stop

981

9.1.384 WriteToFile

bitmap

class name WriteToFilecatalog name Basecatalog id baseclass id WriteToFileauthors Simone Ghisio

Save inputs data in a text output file. Inputs can be non homogeneous type (int, double,bool, string, int or double matrix).

Inputs




Input 00.

Parameters

FileNameid file nametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


File Name

982

FileModeid file modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:AppendOverwrite

domain [ 0, 2 )Specifies if the file is overwited or appended every time the patch is started.

InputNumberid n inputtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of input to be saved. They can be non homogeneous type.

TimeModeid time modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:DoubleFormatted

domain [ 0, 2 )Specifies if the file is overwited or appended every time the patch is started.

983

9.1.385 ZStarIn

bitmap

class name ZStarIncatalog name Basecatalog id baseclass id ZStarInauthors Alessandro Fausto

This block receive and decode the data sent by the ZStar triaxial accelerometer board(RD3152MMA7260Q).

Notes The output is refreshed only when a complete packet is received and decoded.

Inputs

Serial Dataid InputSerialDatatype Kernel, Bytetype id kernel, byte



Bytes received from the ZStar serial port.

Outputs

OutputStringid OutputStringtype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

Raw data packet, formatted as string, received from ZStar serial port.

984

OutputButtonS1id OutputButtonS1type Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

S1 button status of ZStar sensor board

OutputButtonS2id OutputButtonS2type Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

S2 button status of ZStar sensor board

OutputTemperatureid OutputTemperaturetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Temperature of ZStar sensor board

OutputVoltageid OutputVoltagetype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Battery voltage of ZStar sensor board. Normal voltage is 3.6 Volts, when this value isunder 3.2 Volts the battery can be considered depleted.

OutputXAccelid OutputXAcceltype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

X component of accelleration

985

OutputYAccelid OutputYAcceltype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Y component of accelleration

OutputZAccelid OutputZAcceltype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Z component of accelleration

Parameters

Acceleration outputid ParamAccelOutputModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:floating point componentsfloating point matrix

domain [ 0, 2 )Specifies the datatype or format used to output the accelleration values.When is selected

’floating point components’ the accelleration values is returned separated into X, Y, Zcomponents.In the other case the accelleration values is returned into a vertical [ X ; Y ; Z]matrix.

986

9.1.386 ZStarOut

bitmap

class name ZStarOutcatalog name Basecatalog id baseclass id ZStarOutauthors Alessandro Fausto

This block send control commands to the ZStar triaxial accelerometer board (RD3152MMA7260Q).

Notes To schedulate the execution of this block you must use the syncIn pin feature.

Outputs

OutputCommandStringid OutputCommandtype Kernel, Bytetype id kernel, byteinplace id *no*inherited id *no*

Command sent to ZStar board

Parameters

Commandid paramCommandtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:automaticInitialize for 16bit samplesread accelerometer dataread extended accelerometer dataread calibration dataread accelerometer rangeForce channel selection

domain [ 0, 7 )This command is sent to the sensor board at each execute cycle.With ’automatic’ the

block perform the standard initialization of the board and start to poll the accelerometersvalues. With ’Initialize for 16bit samples’, ’read accelerometer data’, ’read extended ac-celerometer data’, ’read calibration data’ and ’read accelerometer range’ the block send the

987

corresponding command to the board.With ’Force channel selection’ the block force theboard to use the channel selected using the ’channel’ parameter.

Channelid paramChanneltype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:automatic handshakechannel 0channel 1channel 2channel 3channel 4channel 5channel 6channel 7channel 8channel 9channel Achannel Bchannel Cchannel Dchannel Echannel F

domain [ 0, 17 )This parameter select the wireless channel used for communication between the USB

Key and the wireless sensor board.This value is used only when the ’force channel selection’ command is issued.

988

9.2 Datatypes

9.2.1 Audio FFT buffer

class name Audio FFT buffercatalog name Basecatalog id baseclass id audio fftbuffer

The FFT audio buffer contains a chunk of audio samples in the frequency domain




9.2.2 Audio buffer

class name Audio buffercatalog name Basecatalog id baseclass id audio buffer

Audio buffer containing 64 bit floating point samples




• Kernel, StaticTimeSeries

9.2.3 Audio clock

class name Audio clockcatalog name Basecatalog id baseclass id audio clock

A datatype containing information about the sampling rate and buffer size of an audiosignal. It is primarly used to propagate such info and as a trigger for block activation, thus,the datatype itself does not contain additional methods with respect to the IDatatypeinterface.

989

9.2.4 BaseGeometricEllipse3DInt

class name BaseGeometricEllipse3DIntcatalog name Basecatalog id baseclass id base geometric ellipse 3d int

Represent a tridimensional Interface::ellipse int




• base, base geometric 3d int

• base, 3d conversion 2d

• base, 3d rotate

• base, 3d scle

• base, 3d translate int

• base, 3d rescale in range int

• base, convert to string

9.2.5 BaseGeometricEllipse3Double

class name BaseGeometricEllipse3Doublecatalog name Basecatalog id baseclass id base geometric ellipse 3d double

Represent a tridimensional Interface::ellipse double




• base, base geometric 3d double


• base, 3d rotate

990

• base, 3d scle

• base, 3d translate double

• base, 3d rescale in range double

• base, convert to string

9.2.6 BaseGeometricLabelledSet3DInt

class name BaseGeometricLabelledSet3DIntcatalog name Basecatalog id baseclass id base geometric labelled set 3d int

Represent a geometric labelled set of tridimensional objects





• base, 3d rotate

• base, 3d scle




9.2.7 BaseGeometricLabelledSet3Double

class name BaseGeometricLabelledSet3Doublecatalog name Basecatalog id baseclass id base geometric labelled set 3d double

Represent a tridimensional point double

991





• base, 3d rotate

• base, 3d scle




9.2.8 BaseGeometricLine3DInt

class name BaseGeometricLine3DIntcatalog name Basecatalog id baseclass id base geometric line 3d int

Represent a tridimensional Interface::line int






• base, 3d rotate

• base, 3d scle



992

9.2.9 BaseGeometricLine3Double

class name BaseGeometricLine3Doublecatalog name Basecatalog id baseclass id base geometric line 3d double

Represent a tridimensional Interface::line double






• base, 3d rotate

• base, 3d scle



9.2.10 BaseGeometricPoint3DInt

class name BaseGeometricPoint3DIntcatalog name Basecatalog id baseclass id base geometric point 3d int

Represent a tridimensional Interface::point int






• base, 3d rotate

• base, 3d scle

993



9.2.11 BaseGeometricPoint3Double

class name BaseGeometricPoint3Doublecatalog name Basecatalog id baseclass id base geometric point 3d double

Represent a tridimensional Interface::point double






• base, 3d rotate

• base, 3d scle



9.2.12 BaseGeometricRectangle3DInt

class name BaseGeometricRectangle3DIntcatalog name Basecatalog id baseclass id base geometric rectangle 3d int

Represent a tridimensional rectangle int






994

• base, 3d rotate

• base, 3d scle



9.2.13 BaseGeometricRectangle3Double

class name BaseGeometricRectangle3Doublecatalog name Basecatalog id baseclass id base geometric rectangle 3d double

Represent a tridimensional rectangle double






• base, 3d rotate

• base, 3d scle



9.2.14 BaseGeometricSize3DInt

class name BaseGeometricSize3DIntcatalog name Basecatalog id baseclass id base geometric size 3d int

Represent a tridimensional Interface::size int

995






• base, 3d scle

• base, 3d rotate


9.2.15 BaseGeometricSize3Double

class name BaseGeometricSize3Doublecatalog name Basecatalog id baseclass id base geometric size 3d double

Represent a tridimensional Interface::size double






• base, 3d scle

• base, 3d rotate


9.2.16 BaseGeometricTriangle3DInt

class name BaseGeometricTriangle3DIntcatalog name Basecatalog id baseclass id base geometric triangle 3d int

Represent a tridimensional triangle int

996






• base, 3d rotate

• base, 3d scle


9.2.17 BaseGeometricTriangle3Double

class name BaseGeometricTriangle3Doublecatalog name Basecatalog id baseclass id base geometric triangle 3d double

Represent a tridimensional Interface::triangle double






• base, 3d rotate

• base, 3d scle


9.2.18 Blob 2D

class name Blob 2Dcatalog name Basecatalog id baseclass id blob2d

Represent a bidimensional blob

997


• Base, Drawing

• Base, GraphicShape2D

• Base, StrokeProperties

• Base, Rotate

• Base, Shape2DInt

• Base, Shape2DDouble

9.2.19 DynamicTemporalData

class name DynamicTemporalDatacatalog name Basecatalog id baseclass id dynamic temporal data

A datatype holding a temporal sequence of double values. The lenght of the sequencecan change along time.




• Kernel, DynamicTimeSeries

9.2.20 Ellipse 2D double

class name Ellipse 2D doublecatalog name Basecatalog id baseclass id ellipse 2d double

Represent a bidimensional ellipse with floating point coordinates





998

• Base, Vertex2DDouble

• Base, Transformations2D

9.2.21 Ellipse 2D int

class name Ellipse 2D intcatalog name Basecatalog id baseclass id ellipse 2d int

Represent a bidimensional ellipse with integer coordinates





• Base, Vertex2DInt


9.2.22 Ellipse 3D double

class name Ellipse 3D doublecatalog name Basecatalog id baseclass id ellipse 3D double

Represent a tridimensional ellipse with floating point coordinates







999

9.2.23 Ellipse 3D int

class name Ellipse 3D intcatalog name Basecatalog id baseclass id ellipse 3D int

Represent a tridimensional ellipse with integer coordinates







9.2.24 Geometric Labelled Set 2D double

class name Geometric Labelled Set 2D doublecatalog name Basecatalog id baseclass id geometric labeled set 2d double

A labelled set containing geometric bidimensional datatypes





9.2.25 Geometric Labelled Set 2D int

class name Geometric Labelled Set 2D intcatalog name Basecatalog id baseclass id geometric labeled set 2d int

A labelled set containing geometric bidimensional datatypes

1000





9.2.26 Graphic Ellipse 2D double

class name Graphic Ellipse 2D doublecatalog name Basecatalog id baseclass id graphic ecllipse 2d double

Represent a tridimensional graphical ellipse with floating point coordinates







• Base, Drawing



9.2.27 Graphic Ellipse 2D int

class name Graphic Ellipse 2D intcatalog name Basecatalog id baseclass id graphic ecllipse 2d int

Represent a tridimensional graphical ellipse with integer coordinates

1001







• Base, Drawing



9.2.28 Graphic Labelled Set 2D double

class name Graphic Labelled Set 2D doublecatalog name Basecatalog id baseclass id graphic labeled set 2d double

A labelled set containing graphic bidimensional datatypes


• Base, Drawing



9.2.29 Graphic Labelled Set 2D int

class name Graphic Labelled Set 2D intcatalog name Basecatalog id baseclass id graphic labeled set 2d int

A labelled set containing graphic bidimensional datatypes


• Base, Drawing



1002

9.2.30 Graphic Line 2D double

class name Graphic Line 2D doublecatalog name Basecatalog id baseclass id graphic line 2d double

Represent a bidimensional graphical line with floating point coordinates







• Base, Drawing


9.2.31 Graphic Line 2D int

class name Graphic Line 2D intcatalog name Basecatalog id baseclass id graphic line 2d int

Represent a bidimensional graphical line with integer coordinates







• Base, Drawing


1003

9.2.32 Graphic Point 2D double

class name Graphic Point 2D doublecatalog name Basecatalog id baseclass id graphic point 2d double

Represent a bidimensional graphical point with floating point coordinates







• Base, Drawing


9.2.33 Graphic Point 2D int

class name Graphic Point 2D intcatalog name Basecatalog id baseclass id graphic point 2d int

Represent a bidimensional graphical point with integer coordinates







• Base, Drawing


1004

9.2.34 Graphic Polygon 2D double

class name Graphic Polygon 2D doublecatalog name Basecatalog id baseclass id graphic polygon 2d double

Represent a bidimensional graphical polygon with floating point coordinates







• Base, Drawing


9.2.35 Graphic Polygon 2D int

class name Graphic Polygon 2D intcatalog name Basecatalog id baseclass id graphic polygon 2d int

Represent a bidimensional graphical polygon with integer coordinates







• Base, Drawing


1005

9.2.36 Graphic Polyline 2D double

class name Graphic Polyline 2D doublecatalog name Basecatalog id baseclass id graphic polyline 2d double

Represent a bidimensional graphical polyline with floating point coordinates







• Base, Drawing


9.2.37 Graphic Polyline 2D int

class name Graphic Polyline 2D intcatalog name Basecatalog id baseclass id graphic polyline 2d int

Represent a bidimensional graphical polyline with integer coordinates







• Base, Drawing


1006

9.2.38 Graphic Rectangle 2D double

class name Graphic Rectangle 2D doublecatalog name Basecatalog id baseclass id graphic rectangle 2d double

Represent a bidimensional graphical rectangle with floating point coordinates







• Base, Drawing



9.2.39 Graphical rectangle 2D int

class name Graphical rectangle 2D intcatalog name Basecatalog id baseclass id graphic rectangle 2d int

Represent a bidimensional graphical rectangle with integer coordinates







• Base, Drawing

1007



9.2.40 Image

class name Imagecatalog name Basecatalog id baseclass id image

Represent a multichannel and multi colormodel image










• kernel, image exchange format

• base, memory buffer

• Base, ImageConversion

• Base, ImageROI

• Base, ImageMirror

• Base, ImageTranspose

• Base, Rotate

• base, image filter

• base, image optimized filter

• base, draw filled shapes

• base, pixelwise comparison op

1008

9.2.41 Line 2D double

class name Line 2D doublecatalog name Basecatalog id baseclass id line 2d double

Represent a bidimensional line with floating point coordinates







9.2.42 Line 2D int

class name Line 2D intcatalog name Basecatalog id baseclass id line 2d int

Represent a bidimensional line with integer coordinates







9.2.43 Line 3D double

class name Line 3D doublecatalog name Basecatalog id baseclass id line 3D double

1009

Represent a tridimensional line with floating point coordinates







9.2.44 Line 3D int

class name Line 3D intcatalog name Basecatalog id baseclass id line 3D int

Represent a tridimensional line with integer coordinates







9.2.45 MIDI

class name MIDIcatalog name Basecatalog id baseclass id midi

A MIDI event

1010

9.2.46 MIDI buffer

class name MIDI buffercatalog name Basecatalog id baseclass id midibuffer

A sequence of MIDI events

9.2.47 PCMAudioBuffer

class name PCMAudioBuffercatalog name Basecatalog id baseclass id pcm audio buffer

Stores an audio buffer in PCM format






• base, pcm conversion

• kernel, conversion

9.2.48 PCMAudioBuffer

class name PCMAudioBuffercatalog name Basecatalog id baseclass id pcm audio dynamic buffer

Stores an audio buffer in PCM format





1011


• base, pcm conversion

• kernel, conversion

9.2.49 Point 2D double

class name Point 2D doublecatalog name Basecatalog id baseclass id point 2d double

Represent a bidimensional point with floating point coordinates







9.2.50 Point 2D int

class name Point 2D intcatalog name Basecatalog id baseclass id point 2d int

Represent a bidimensional point with integer coordinates







1012

9.2.51 Point 3D double

class name Point 3D doublecatalog name Basecatalog id baseclass id point 3d double

Represent a tridimensional point with floating point coordinates







9.2.52 Point 3D int

class name Point 3D intcatalog name Basecatalog id baseclass id point 3d int

Represent a tridimensional point with integer coordinates







9.2.53 Polygon 2D double

class name Polygon 2D doublecatalog name Basecatalog id baseclass id polygon 2d double

1013

Represent a bidimensional polygon with floating point coordinates







9.2.54 Polygon 2D int

class name Polygon 2D intcatalog name Basecatalog id baseclass id polygon 2d int

Represent a bidimensional polygon with integer coordinates







9.2.55 Polyline 2D double

class name Polyline 2D doublecatalog name Basecatalog id baseclass id polyline 2d double

Represent a bidimensional polyline with floating point coordinates

1014







9.2.56 Polyline 2D int

class name Polyline 2D intcatalog name Basecatalog id baseclass id polyline 2d int

Represent a bidimensional polyline with integer coordinates







9.2.57 RawData

class name RawDatacatalog name Basecatalog id baseclass id raw data

Contains an unstructured datatype. RawData is used by blocks which handle datatypesas memory buffers, with no further information about them. For instance, a block sendingdata throw the network or receiveing data from the network migth know anything aboutthe datatype, just their size. Other blocks in the patch will do the specific processing.



1015

9.2.58 Rectangle 2D double

class name Rectangle 2D doublecatalog name Basecatalog id baseclass id rectangle 2d double

Represent a bidimensional rectangle with floating point coordinates






• Base, Shape2DDouble


9.2.59 Rectangle 2D int

class name Rectangle 2D intcatalog name Basecatalog id baseclass id rectangle 2d int

Represent a bidimensional rectangle with integer coordinates






• Base, Shape2DInt


1016

9.2.60 Rectangle 3D double

class name Rectangle 3D doublecatalog name Basecatalog id baseclass id rectangle 3d double

Represent a tridimensional rectangle with floating point coordinates







9.2.61 Rectangle 3D int

class name Rectangle 3D intcatalog name Basecatalog id baseclass id rectangle 3d int

Represent a tridimensional rectangle with integer coordinates







9.2.62 Roi 2D double

class name Roi 2D doublecatalog name Basecatalog id baseclass id roi2d double

1017

Represent a bidimensional region of interest with floating point coordinates





9.2.63 Roi 2D int

class name Roi 2D intcatalog name Basecatalog id baseclass id roi2d int

Represent a bidimensional region of interest with integer coordinates





9.2.64 Size 2D double

class name Size 2D doublecatalog name Basecatalog id baseclass id size2d double

Represent a bidimensional rectangle with floating point coordinates





1018

9.2.65 Size 2D int

class name Size 2D intcatalog name Basecatalog id baseclass id size2d int

Represent a bidimensional size with integer coordinates





9.2.66 TemporalData

class name TemporalDatacatalog name Basecatalog id baseclass id temporal data

A datatype holding a temporal sequence of double values




• Kernel, StaticTimeSeries

9.2.67 Vector 2D double

class name Vector 2D doublecatalog name Basecatalog id baseclass id vector 2d double

Represent a bidimensional vector with floating point coordinates

1019







9.2.68 Vector 2D int

class name Vector 2D intcatalog name Basecatalog id baseclass id vector 2d int

Represent a bidimensional point with integer coordinates







9.2.69 Vector 3D double

class name Vector 3D doublecatalog name Basecatalog id baseclass id vector 3d double

Represent a tridimensional vector with floating point coordinates





1020



9.2.70 Vector 3D int

class name Vector 3D intcatalog name Basecatalog id baseclass id vector 3d int

Represent a tridimensional vector with integer coordinates







9.3 Datatype converters

9.3.1 AudioBufferToAudioClock

class name AudioBufferToAudioClockcatalog name Basecatalog id baseclass id audio buffer to audio clock converter

Converts an audio buffer to an audio clock datatype.

9.3.2 Base geometric point 3D to geometric point 3D converter

class name Base geometric point 3D to geometric point 3D convertercatalog name Basecatalog id baseclass id base geometric point 3d to geometric point 3d converter int

This converter convert the new base geometric point 3Dto the old point 3D

1021

9.3.3 Base geometric point 3D to geometric point 3D converter

class name Base geometric point 3D to geometric point 3D convertercatalog name Basecatalog id baseclass id base geometric point 3d to geometric point 3d converter double

This converter convert the new base geometric point 3Dto the old point 3D

9.3.4 Geometric Ellipse 2D Double To Graphic Ellipse 2D Double

class name Geometric Ellipse 2D Double To Graphic Ellipse 2D Doublecatalog name Basecatalog id baseclass id geom to graphic converter ellipse double

Geometric Ellipse 2D Double To Graphic Ellipse 2D Double

9.3.5 Geometric Ellipse 2D Integer To Graphic Ellipse 2D Integer

class name Geometric Ellipse 2D Integer To Graphic Ellipse 2D Integercatalog name Basecatalog id baseclass id geom to graphic converter ellipse int

Geometric Ellipse 2D Integer To Graphic Ellipse 2D Integer

9.3.6 Geometric LabelledSet 2D Double To Graphic LabelledSet2D Double

class name Geometric LabelledSet 2D Double To Graphic LabelledSet 2D Doublecatalog name Basecatalog id baseclass id geometric labeled set 2d double to graphic labeled set 2d double

Automatically converts a Geometric LabelledSet 2D Double datatype to a GraphicLabelledSet 2D Double datatype, such that it can be drawn

1022

9.3.7 Geometric LabelledSet 2D Int To Graphic LabelledSet 2DInt

class name Geometric LabelledSet 2D Int To Graphic LabelledSet 2D Intcatalog name Basecatalog id baseclass id geometric labeled set 2d int to graphic labeled set 2d int

Automatically converts a Geometric LabelledSet 2D Int datatype to a Graphic Labelled-Set 2D Int datatype, such that it can be drawn

9.3.8 Geometric Line 2D Double To Graphic ine 2D Double

class name Geometric Line 2D Double To Graphic ine 2D Doublecatalog name Basecatalog id baseclass id geom to graphic converter line double

Geometric Line 2D Double To Graphic Line 2D Double

9.3.9 Geometric Line 2D Integer To Graphic Line 2D Integer

class name Geometric Line 2D Integer To Graphic Line 2D Integercatalog name Basecatalog id baseclass id geom to graphic converter line int

Geometric Line 2D Integer To Graphic Line 2D Integer

9.3.10 Geometric Point 2D Double To Graphic Point 2D Double

class name Geometric Point 2D Double To Graphic Point 2D Doublecatalog name Basecatalog id baseclass id geom to graphic converter point double

Geometric Point 2D Double To Graphic Point 2D Double

9.3.11 Geometric Point 2D Integer To Graphic Point 2D Integer

class name Geometric Point 2D Integer To Graphic Point 2D Integercatalog name Basecatalog id baseclass id geom to graphic converter point int

1023

Geometric Point 2D Integer To Graphic Point 2D Integer

9.3.12 Geometric Point 2D Integer To Graphic Point 2D Integer

class name Geometric Point 2D Integer To Graphic Point 2D Integercatalog name Basecatalog id baseclass id geom to graphic converter polyline int

Geometric Point 2D Integer To Graphic Point 2D Integer

9.3.13 Geometric Polyline 2D Double To Graphic Polyline 2DDouble

class name Geometric Polyline 2D Double To Graphic Polyline 2D Doublecatalog name Basecatalog id baseclass id geom to graphic converter polyline double

Geometric Polyline 2D Double To Graphic Polyline 2D Double

9.3.14 Geometric Rect 2d Double To ROI 2d Double

class name Geometric Rect 2d Double To ROI 2d Doublecatalog name Basecatalog id baseclass id geomrect2ddouble to roi2ddouble

Convert Geometric Rect 2d Double To ROI 2d Double

9.3.15 Geometric Rect 2d Integer To ROI 2d Integer

class name Geometric Rect 2d Integer To ROI 2d Integercatalog name Basecatalog id baseclass id geomrect2dint toroi2dint

Convert Geometric Rect 2d Integer To ROI 2d Integer

1024

9.3.16 Geometric Rectangle 2D Double To Graphic Rectangle 2DDouble

class name Geometric Rectangle 2D Double To Graphic Rectangle 2D Doublecatalog name Basecatalog id baseclass id geom to graphic converter rectangle double

Geometric Rectangle 2D Double To Graphic Rectangle 2D Double

9.3.17 Geometric Rectangle 2D Integer To Graphic Rectangle 2DInteger

class name Geometric Rectangle 2D Integer To Graphic Rectangle 2D Integercatalog name Basecatalog id baseclass id geom to graphic converter rectangle int

Geometric Rectangle 2D Integer To Graphic Rectangle 2D Integer

9.3.18 Graphic Ellipse 2D Double To Geometric Ellipse 2D Dou-ble

class name Graphic Ellipse 2D Double To Geometric Ellipse 2D Doublecatalog name Basecatalog id baseclass id graphic to geom converter ellipse double

Graphic Ellipse 2D Double To Geometric Ellipse 2D Double

9.3.19 Graphic Ellipse 2D Integer To Geometric Ellipse 2D Inte-ger

class name Graphic Ellipse 2D Integer To Geometric Ellipse 2D Integercatalog name Basecatalog id baseclass id graphic to geom converter ellipse int

Graphic Ellipse 2D Integer To Geometric Ellipse 2D Integer

1025

9.3.20 Graphic Point 2D Double To Geometric Point 2D Double

class name Graphic Point 2D Double To Geometric Point 2D Doublecatalog name Basecatalog id baseclass id graphic to geom converter point double

Graphic Point 2D Double To Geometric Point 2D Double

9.3.21 Graphic Point 2D Integer To Geometric Point 2D Integer

class name Graphic Point 2D Integer To Geometric Point 2D Integercatalog name Basecatalog id baseclass id graphic to geom converter point int

Graphic Point 2D Integer To Geometric Point 2D Integer

9.3.22 Graphic Point 2D Integer To Geometric Point 2D Integer

class name Graphic Point 2D Integer To Geometric Point 2D Integercatalog name Basecatalog id baseclass id graphic to geom converter polyline int

Graphic Point 2D Integer To Geometric Point 2D Integer

9.3.23 Graphic Polyline 2D Double To Geometric Polyline 2DDouble

class name Graphic Polyline 2D Double To Geometric Polyline 2D Doublecatalog name Basecatalog id baseclass id graphic to geom converter polyline double

Graphic Polyline 2D Double To Geometric Polyline 2D Double

9.3.24 Graphic Rectangle 2D Double To Geometric Rectangle 2DDouble

class name Graphic Rectangle 2D Double To Geometric Rectangle 2D Doublecatalog name Basecatalog id baseclass id graphic to geom converter rectangle double

1026

Graphic Rectangle 2D Double To Geometric Rectangle 2D Double

9.3.25 Graphic Rectangle 2D Integer To Geometric Rectangle 2DInteger

class name Graphic Rectangle 2D Integer To Geometric Rectangle 2D Integercatalog name Basecatalog id baseclass id graphic to geom converter rectangle int

Graphic Rectangle 2D Integer To Geometric Rectangle 2D Integer

9.3.26 PCMAudioBufferToAudioClock

class name PCMAudioBufferToAudioClockcatalog name Basecatalog id baseclass id pcm audio buffer to audio clock converter

Converts a PCM audio buffer to an audio clock datatype.

9.3.27 ROI 2d Double To Geometric Rect 2d Double

class name ROI 2d Double To Geometric Rect 2d Doublecatalog name Basecatalog id baseclass id roi2ddouble to geomrect2ddouble

ROI 2d Double To Convert Geometric Rect 2d Double

9.3.28 ROI 2d Integer To Geometric Rect 2d Integer

class name ROI 2d Integer To Geometric Rect 2d Integercatalog name Basecatalog id baseclass id roi2dint to geomrect2dint

ROI 2d Integer To Convert Geometric Rect 2d Integer

1027

9.3.29 Static to Dynamic Temporal Data Converter

class name Static to Dynamic Temporal Data Convertercatalog name Basecatalog id baseclass id static to dynamic temp data converter

This converter converts a static time series to a dynamic one, i.e., a time series wherethe number of samples and the number of channels can be changes at run-time.

9.4 Datatype interfaces

9.4.1 Drawing

class name Drawingcatalog name Basecatalog id baseclass id drawing

This is the interface of datatypes supporting the possibility to be drawn over a bitmap

9.4.2 GraphicShape2D

class name GraphicShape2Dcatalog name Basecatalog id baseclass id graphic shape

This is the base interface of graphical shapes and declares the methods to change thecolor and the fill properties of the shape.

9.4.3 ImageConversion

class name ImageConversioncatalog name Basecatalog id baseclass id image conversion

Image datatypes implementing this interface support the possibility to convert betweendifferent image formats

1028

9.4.4 ImageMirror

class name ImageMirrorcatalog name Basecatalog id baseclass id image mirror

Image datatypes implementing this interface support the possibility to mirror an image,i.e., to flip it around an horizontal or vertical axis.

9.4.5 ImageROI

class name ImageROIcatalog name Basecatalog id baseclass id image roi

Image datatypes implementing this interface support the possibility to specify a ROI(Region Of Interest), i.e., a rectangle inside the image where the following operations willwork. Image outside the ROI can assume undefined values.

9.4.6 ImageTranspose

class name ImageTransposecatalog name Basecatalog id baseclass id image transpose

Image datatypes implementing this interface support the possibility to transpose animage.

9.4.7 Rotate

class name Rotatecatalog name Basecatalog id baseclass id rotate

Datatypes implementing this interface support the possibility to rotate object.

1029

9.4.8 Shape2DDouble

class name Shape2DDoublecatalog name Basecatalog id baseclass id shape 2d double

This is the base interface of shapes 2d

9.4.9 Shape2DInt

class name Shape2DIntcatalog name Basecatalog id baseclass id shape 2d int

This is the base interface of shapes 2d

9.4.10 StrokeProperties

class name StrokePropertiescatalog name Basecatalog id baseclass id stroke properties

This is the base interface of graphical objects having a visible contour and declares themethods to change the color and the width of the contour

9.4.11 Transformations2D

class name Transformations2Dcatalog name Basecatalog id baseclass id trasformation 2d

This interface declares the methods to perform operations (e.g., Scale, Rotate, Translate,etc.) on geometric/graphics objects

9.4.12 Transformations3D

class name Transformations3Dcatalog name Basecatalog id baseclass id trasformation 3D

1030

This interface declares the methods to perform operations (e.g., Scale, Rotate, Translate,etc.) on geometric/graphics objects

9.4.13 Vertex2DDouble

class name Vertex2DDoublecatalog name Basecatalog id baseclass id vertex 2d double

This is the base interface of double geometric datatypes, and provides the methods toenumerate the vertices of geometric shapes

9.4.14 Vertex2DInt

class name Vertex2DIntcatalog name Basecatalog id baseclass id vertex 2d int

This is the base interface of integer geometric datatypes, and provides the methods toenumerate the vertices of geometric shapes

9.4.15 Vertex3DDouble

class name Vertex3DDoublecatalog name Basecatalog id baseclass id vertex 3D double

This is the base interface of double geometric datatypes, and provides the methods toenumerate the vertices of geometric shapes

9.4.16 Vertex3DInt

class name Vertex3DIntcatalog name Basecatalog id baseclass id vertex 3D int

This is the base interface of integer geometric datatypes, and provides the methods toenumerate the vertices of geometric shapes

1031

9.5 Categories

9.5.1 Development Stage

class name Development Stagecatalog name Basecatalog id baseclass id development stage

This category clarifies the development stage of the block (i.e., alpha, beta, production,stable).

Alpha

A block at alpha stage is ....

Beta

A block at beta stage is ....

Production

A block at production stage is ....

Stable

A block is stable....

9.5.2 Development Stage

class name Development Stagecatalog name Basecatalog id baseclass id development stage

This category clarifies the development stage of the block (i.e., alpha, beta, production,stable).

Alpha

A block at alpha stage is ....

Beta

A block at beta stage is ....

1032

Production

A block at production stage is ....

Stable

A block is stable....

9.5.3 Final User Category

class name Final User Categorycatalog name Basecatalog id baseclass id final user

This category specifies the class of expected final user for this block.

Artist

An user which can envision nice applications, but which has a poor knowledge in thecomputer science field....

Developer

An user which is able to develop source code in some programming language, or has a deepknowledge of EyesWeb scheduling mechaninsm....

Phisician

An user which can understand physic laws, but cannot understand computer science....

9.5.4 Final User Category

class name Final User Categorycatalog name Basecatalog id baseclass id final user

This category specifies the class of expected final user for this block.

Artist

An user which can envision nice applications, but which has a poor knowledge in thecomputer science field....

1033

Developer

An user which is able to develop source code in some programming language, or has a deepknowledge of EyesWeb scheduling mechaninsm....

Phisician

An user which can understand physic laws, but cannot understand computer science....

9.6 Authors


class name Alberto Massaricatalog name Basecatalog id baseclass id alby

Software Engineer mailto:[email protected]

9.6.2 Alessandro Fausto

class name Alessandro Faustocatalog name Basecatalog id baseclass id alessandro

mailto:[email protected]

9.6.3 Andrea Ricci

class name Andrea Riccicatalog name Basecatalog id baseclass id andrea

Software Engineer Microsoft Certified Professional mailto:[email protected]

9.6.4 Barbara Mazzarino

class name Barbara Mazzarinocatalog name Basecatalog id baseclass id barbara

1034


9.6.5 Carlo Drioli

class name Carlo Driolicatalog name Basecatalog id baseclass id carlo


9.6.6 Giovanna Varni

class name Giovanna Varnicatalog name Basecatalog id baseclass id giovanna


9.6.7 Gualtiero Volpe

class name Gualtiero Volpecatalog name Basecatalog id baseclass id gualtiero


9.6.8 Marzia Simonetti

class name Marzia Simonetticatalog name Basecatalog id baseclass id marzia



class name Massimiliano Pericatalog name Basecatalog id baseclass id massy

1035


9.6.10 Maurizio Mancini

class name Maurizio Mancinicatalog name Basecatalog id baseclass id maurizio

EyesWeb Developer mailto:[email protected]


class name Mirko Demurtascatalog name Basecatalog id baseclass id mirko


9.6.12 Nguyen, Dinh Quan

class name Nguyen, Dinh Quancatalog name Basecatalog id baseclass id PARS Author

Student, EU-Erasmus Mundus Project EMARO 09-10

9.6.13 Paolo Coletta

class name Paolo Colettacatalog name Basecatalog id baseclass id paolo


9.6.14 Roberto Sagoleo

class name Roberto Sagoleocatalog name Basecatalog id baseclass id roberto

1036


9.6.15 Simone Ghisio

class name Simone Ghisiocatalog name Basecatalog id baseclass id simone


9.7 Companies

9.7.1 InfomusLab

class name InfomusLabcatalog name Basecatalog id baseclass id infomus



class name NumenSoft s.n.c. di M. Peri & C.catalog name Basecatalog id baseclass id numensoft


1037

Chapter 10

System Catalog

10.1 Blocks

10.1.1 ADAMInput

bitmap

class name ADAMInputcatalog name Systemcatalog id systemclass id adam-gpi-in


Outputs

Digital Inputid input statetype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

1038

Digital Input

Digital Outputid output statetype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

Digital output

Parameters


Refresh

Moduleid moduletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:6050605160606066

domain [ 0, 4 )Module to connect

IP Addressid ip-addresstype Kernel, String datatype (Kernel Catalog).type id kernel, string

IP Address

TCP Portid tcp-porttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 65535 ]

TCP Port (DEFAULT: 502)

1039

Conn. Timeoutid comm-timeouttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Connection timeout (ms)

Send Timeoutid send-timeouttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Send timeout (ms)

Recv Timeoutid recv-timeouttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Receive timeout (ms)

1040

10.1.2 ADAMOutput

bitmap

class name ADAMOutputcatalog name Systemcatalog id systemclass id adam-gpi-out


Parameters

Output Stateid DO-Signaltype Kernel, Integer matrix.type id kernel, int-matrix

Matrix for digital output value

Moduleid moduletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:6050605160606066

domain [ 0, 4 )Module to connect

1041


IP Address



Conn. Timeoutid comm-timeouttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Connection timeout (ms)

Send Timeoutid send-timeouttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Send timeout (ms)

Recv Timeoutid recv-timeouttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Receive timeout (ms)

1042

10.1.3 AudioDisplay

bitmap

class name AudioDisplaycatalog name Systemcatalog id systemclass id audio display gdi

authorsAlessandro FaustoMirko Demurtas

This block visualizes the input audio signal using the Windows GDI library. When thebitrate of audio input is high and the buffer size is small, drawing the waveform generatesa very high refresh rate. In this case some personal computers seem not responsive becausethey miss the processing power required to both refresh the display and interact with theuser. To avoid this situation, set the ’Refresh mode’ parameter to ’Frequency limited’ orto ’Time limited’. – REMARKS – When the display is shrinked to a pixel dimension lowerthan the buffer size (or 640 pixels at maximum) the waveform is distorded by the zoomfactor.

– ERRORS – ’Found outdated version of GDI display block, ignored parameter list:¡LIST¿’ The parameters loaded from the patch and listed into the ¡LIST¿ are ignoredbecause relative to an older version of DisplayGDI block.

Inputs

Audio Bufferid input audiotype Kernel, Generic datatypetype id kernel, generic datatype



Audio Buffer


1043

Parameters


Label

Merge channelsid Merge channelstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Merge channels

1044

10.1.4 AudioFileReader

bitmap

class name AudioFileReadercatalog name Systemcatalog id systemclass id audio file reader mmstream


Reads an audio stream from file.

Remarks It is based on DirectShow streaming technology, thus,it should be able to readall files that DirectShow can read. It is limited to the main audio stream, thus, if the filecontain more than one audio stream, only one is read and the other ones are ignored. Thefile can be changed at runtime, thus, since the audio datatype is supposed to have a constantformat (num samples, sampling rate, num channels) during tuntime, the block may needto convert the audio format. That’s why the block exports parameter to specify the audiobuffer format: since the file is not constant during execution, the audio format cannot bededuced from the file (which could also not be specified when patch starts). However, it ispossible to set zero values for this info, in such case, if a filename is specified at startup, theinfo is taken from that file (and maintained throughout execution), otherwise it assumesdefault values.

— ERROR AND WARNING MESSSAGE — - During Initialization phase - - Failed tocreate the multimedia file reader allocation thread. JoinInit failed. - Failed to create themultimedia file reader allocation thread. Thread initialization failed. - Invalid Master ID:if the Sincronization type is set to Master and the string that specifies the master is invalid.

- During execution phase - - CAudioFileReaderImplMMStream::CMMediaCreationThread::WaitFileReaderCreated– FAIL.

Outputs

Output buffer.id audio streamtype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Output buffer. It’s and audio buffer datatype.

1045

File cuedid file cuedtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Generate a bang when the file is cued successfully

EndFileid file endtype Kernel, Bool datatype (Kernel Catalog).type id kernel, boolinplace id *no*inherited id *no*

Generate true when the file is played

Parameters

Audio file readerid filenametype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Audio files (*.wav,*.mp3, *.wma)—*.wav;*.mp3;*.wma—All files (*.*)—*.*——”

Specifies the name of file to read.

Sampling rateid sampling ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Sampling rate of the output buffer. It can be different from the sampling rate of thefile, even because the file can change at runtime. Moreover, files with a dynamic samplingrate are supported.

Time to gotoid goto timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Specifies the time to be reached

1046

Gotoid gototype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Forces the file to reach the specified position

Frames before seekid frames before seektype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Specifies the number of frames to skip before performing a seek. In many cases, de-compressing and skipping frames gives a better performance than seeking to the desiredposition.

Number of channelsid num channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifiies the number of channels of the output buffer. Can be mono (1 channel) orstereo (2 channels).


Specifies the start position of the file

Durationid media durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Specifies the length of the portion of the file to be read. Use zero to specify the wholefile.

Playback rateid playback ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the playback rate. Use 1.0 for normal speed, higher values (e.g., 2.0) for fast-forward, lower values for slow motion. Negative values mean going backward. Note thataudio is always muted for playback rate different from 1.0.

1047

Player statusid statustype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:StoppedPausedPlaying

domain [ 0, 3 )Specifies the status of the player. If no file is currently executing, this parameter is

ignored, however it specifies whether the block is stopped, is paused, or is playing. Whenthe block is stopped the output is a black frame; when the block is paused the output isa fixed frame (the last played one); when the block is playing the output changes at eachstep. If this parameter is changed at design time or when no file is playing, its value is usedas an initial status.


layout


domain [ 0, 3 )Specifies the behaviour when end of file is reached.


Start (or resume) playing the selected file


Pause at the currently reached frame


Stop playing, produces a black frame as output

1048

Master IDid master idtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Master identifier

Syncronization Typeid sync typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:StandaloneMasterSlave

domain [ 0, 3 )Set the type of syncronization

Auto generate mediatimeid auto generate mediatimetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If the file set has not an audio stream and the block is set as Master, It generate a silentsound buffer with valid mediatime

Generate cued bang after failureid generate cued if failedtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Generate cued bang after a failure of a change filename

Buffering typeid type of bufferingtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:numsamplesbuffertimefps

domain [ 0, 3 )It specifies how the block calculates the buffer lenght. It’s possible set the dimension

according to number of samples value, buffer time duration or in frame per second.

1049

number of samplesid number of samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

It specifies the number of samples for each buffer. Usually 1764.

1050

10.1.5 DirectSoundInput

bitmap

class name DirectSoundInputcatalog name Systemcatalog id systemclass id dsound input


Captures an audio stream using Microsoft DirectSound

Outputs

Outputid audio streamtype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

Output

Parameters

Deviceid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Virtual Device

Samplesid samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Samples

Sampling rateid samplingratetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Sampling rate

1051

Num. channelsid num channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of audio channels

Physical buffer durationid physical buffer durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Physical buffer duration

Delayid max delaytype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Delay

1052

10.1.6 DirectSoundOutput

bitmap

class name DirectSoundOutputcatalog name Systemcatalog id systemclass id dsound output


Renders an audio stream using Microsoft DirectSound.

Inputs

Inputid audio streamtype Base, Audio buffertype id base, audio buffer



Input audio buffer

Parameters


Virtual directsound output device. If this field is empty the output device is selectedaccording to EyesWeb Control Panel

Volumeid volumetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Volume of audio stream. It’s normalized and the value must be included in [0,1]

1053

Physical buffer duration expressed in time unitsid physical buffer durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Physical buffer duration


Delay of output buffer compared to the input stream

1054

10.1.7 DisplayDirectX

bitmap

class name DisplayDirectXcatalog name Systemcatalog id systemclass id image displayauthors Massimiliano Peri

This block show the input image using the DirectX graphic library, verion 9.0. Theinput image is immediately painted on the display output.This block also permit to selectthe quality of image scaling algorithm.

Details Most of this block operation is done by the hardware of the graphic board(GPU) without the intervention of CPU. The color space I420, YV12, HSV is not supported.The alpha channel is not supported on BW, YUYV, UYVY color spaces. To display a imagewith this color space you must convert the color space to one of the supported color space.All pixel depth greater than 8 bit per channel is converted to 8 bit per channel. Thisconversions increase the CPU usage, please use RGB or BGR space with 8 bit per channelpixel format.

Notes Error list: ’DirectX libraries could not be initialized.’ This error occur whenthe DirectX 9.0 is not installed. ’DirectX libraries will be initialized in emulation mode.Not all the functionalities will be available.’ This error occur when the DirectX library donot support some of the hardware accelleration used by this block. ’The alpha channel isnot supported for X color space’ Add one image converter block before this block to convertthe image into one of the following supported color spaces: RGB with alpha, BGR withalpha, YUV with alpha ’The X color space is not supported.’ Add one image converterblock before this block to convert the image into one of the following supported color spaces:BW, RGB, BGR, YUV, YUYV, UYVY, I420, YV12, HSV

Inputs

Imageid video streamtype Kernel, Generic datatypetype id kernel, generic datatype



1055

Image to be painted on the display. The I420, YV12 and HSV color spaces are notsupported. the alpha channel is not supported on BW, YUYV, UYVY color spaces.


Parameters


layout



the aspectRatio is not preserved, and the source image is stretched or shrinked to coverall available space. In the other cases, the aspect ratio is (or might be) preserved, thus ablack frame might be needed on the horizontal or vertical side to cover the unused space.This enumerator specifies where to place such black frame. Since the user might not knowin advance whether letterboxing will place mattes above/below or left/right, each modespecifies how to behave in both cases. As an example, the letterbox mode left-middle meansthat if the image needs mattes on the sides, the image will be put to the extreme left, andthe matte will span the right side; if the image needs mattes above/below, the image willbe vertically centered. Hence, the mode is made of two terms, the first referring to thehorizontal centering of the image, the second referring to the vertical centering. Horizontalcentering may assume values none, left, center, or right. Vertical centering may assumevalues none, top, middle, or bottom. The term none means that if letterboxing is neededon that direction, than the image is stretched to fill the whole size. E.g., elmNoneTopmeans that is image is thinner than the destination rect, than no letterboxing is appliedand the image is stretched horizontally. However, it the image is larger than the destination

1056

rect, than letterboxing is applied by putting the image on the top and a single matte below.

Interpolationid filteringtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:PointLinearAnisotropicPyramidalGaussian

domain [ 0, 5 )Interpolation


Delay

1057

10.1.8 DisplayDirectX-2

bitmap

class name DisplayDirectX-2catalog name Systemcatalog id systemclass id D3DImageDisplay

authorsAlessandro FaustoMassimiliano Peri

This block show the input image using the DirectX graphic library, verion 9.0. The usercan chose between two different visualization mode (ignore/respect presentation time).The’ignore presentation time’ is the default mode (the only mode available in DirectX and GDIdisplays).In this mode the input image is immediatly painted on the display output.Whenin ’respect presentation time’ mode the display paint the image when its presentation timeis reached.When a new image reach the display input, thee case can be distincted : 1. Thepresentation time is lesser than current time: the image is dropped.2. The presentationtime is close to current time: the image is painted.3. The presentation time is greater thancurrent time: the image is inserted into a ordered queue.The used can select the maximumnumber of ordered queue elements (design time) and drop all elements from the queue (runtime).This block also permit to mirror the texture and select the quality of image scaling.The user, acting on ’Output queue status’ parameter, can enable or disable the output ofinternal queue status.See the ’Extracted image counter’ and ’Queued images’ outputs pindescription for more details. This block is also able to intercept some mouse events, and togenerate a related output. The user can select among none, movement, button pressed orselection mouse handling modes. See the paramemter ’Mouse handling’ for more details.

– REMARKS – Most of this block operation is done by the hardware of the graphic board(GPU) without the intervention of CPU. The color space I420, YV12, HSV is not supported.The alpha channel is not supported on BW, YUYV, UYVY color spaces. To display a imagewith this color space you must convert the color space to one of the supported color space.All pixel depth greater than 8 bit per channel is converted to 8 bit per channel. Thisconversions increase the CPU usage, please use RGB or BGR space with 8 bit per channelpixel format.

– ERRORS – ’Load of parameter values failed’: This warning occur when Eyeswebencounter a error loading the block parameters from the patch file. In this case someparameters can be reset to default value. ’DirectX libraries could not be initialized.’ Thiserror occur when the DirectX 9.0 is not installed. ’DirectX libraries will be initialized inemulation mode. Not all the functionalities will be available.’ This error occur when theDirectX library do not support some of the hardware accelleration used by this block. ’Thealpha channel is not supported for X color space’ Add one image converter block beforethis block to convert the image into one of the following supported color spaces: RGBwith alpha, BGR with alpha, YUV with alpha ’The X color space is not supported.’ Add

1058

one image converter block before this block to convert the image into one of the followingsupported color spaces: BW, RGB, BGR, YUV, YUYV, UYVY, I420, YV12, HSV

Inputs




Image to display.

Parameters

Presentation timeid QueueAlgotype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ignore the presentation timerespect the presentation time

domain [ 0, 2 )To respect the image presentation time this display use a ordered queue. This parame-

ter selects the algorithm used to manage the presentation time (’ignore’, ’respect’). When’ignore’ is selected the input image is displayed immediately (bypassing the queue), other-wise the image is stored into the queue and is displayed when the clock time matches thepresentation time.

Queue max sizeid QueueMaxSizetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

This parameter set the maximum number of images stored into the internal queue.

Purge queueid QueuePurgetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Drop all images contained into the internal queue.

1059

Output queue statusid ParamOutputQueueStatustype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Output the internal queue status (number of image into the queue, number of imageskipped in the last execution cycle).

Mouse handlingid ParamOutputMouseModetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:noneoutput positionoutput click positionoutput selection rectangle

domain [ 0, 4 )This parameter enable, disable and select the Output mode of mouse click position.

Flip imageid ImageFliptype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:nonevertical (Y axis)horizontal (X axis)vertical & horizontal (both axis)

domain [ 0, 4 )Flip image over Y (flipping), X (flopping) or both axis.

Interpolationid filteringtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:PointLinearAnisotropicPyramidalGaussian

domain [ 0, 5 )The color of points obtained during the zoom operations can be calculated with different

algorithms. Choices are ”point” where the closest pixel is chosen, ”Linear” which applieslinear filtering (a method where a weighted average of the 2 by 2 pixels surrounding the

1060

pixel is used) , ”Anisotropic” which takes into account the angle a primitive is rendered,”Pyramidal” which takes 4 samples and uses a tent filter and ”Gaussian” which also takes4 samples but uses a Gaussian filter.

1061

10.1.9 DisplayGDI

bitmap

class name DisplayGDIcatalog name Systemcatalog id systemclass id display gdi


This block show the input image using the Windows GDI library. The user can chosebetween two different visualization mode (ignore/respect presentation time).The ’ignorepresentation time’ is the default mode (the only mode available in DirectX display).In thismode the input image is immediatly painted on the display output.When in ’respect presen-tation time’ mode the display paint the image when its presentation time is reached.Whena new image reach the display input, thee case can be distincted : 1. The presentation timeis lesser than current time: the image is dropped.2. The presentation time is close to cur-rent time: the image is painted.3. The presentation time is greater than current time: theimage is inserted into a ordered queue.The used can select the maximum number of orderedqueue elements (design time) and drop all elements from the queue (run time).This blockalso permit to mirror the texture and select the quality of image scaling.The user, actingon ’Output queue status’ parameter, can enable or disable the output of internal queuestatus.See the ’Extracted image counter’ and ’Queued images’ outputs pin description formore details. This block is also able to intercept some mouse events, and to generate arelated output. The user can select among none, movement, button pressed or selectionmouse handling modes. See the paramemter ’Mouse handling’ for more details.

– REMARKS – The color space I420, YV12, HSV is not supported. The alpha channelis not supported on BW, YUYV, UYVY color spaces. All input images with color spacedifferent from BW or BGR are converted into BGR color space. All pixel depth greaterthan 8 bit per channel is converted to 8 bit per channel. This conversions increase the CPUusage, please use BW or BGR space with 8 bit per channel pixel format.

– ERRORS – ’Load of parameter values failed’: This warning occur when Eyeswebencounter a error loading the block parameters from the patch file. In this case someparameters can be reset to default value. ’The alpha channel is not supported for X colorspace’ Add one image converter block before this block to convert the image into one ofthe following supported color spaces: RGB with alpha, BGR with alpha, YUV with alpha’The X color space is not supported.’ Add one image converter block before this block toconvert the image into one of the following supported color spaces: BW, RGB, BGR, YUV,YUYV, UYVY, I420, YV12, HSV ’Found outdated version of GDI display block, ignoredparameter list: ¡LIST¿’ The parameters loaded from the patch and listed into the ¡LIST¿are ignored because relative to one old version of DisplayGDI block.

1062

Inputs




Image to display.

Parameters










1063



layout



Interpolation Algorithmid filteringtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:nearest neighbour interpolationlinear interpolationcubic convolution interpolationinterpolation by 3-lobed Lanczos-windowed sinc function

domain [ 0, 4 )Specifies the algorithm used to interpolate the image when resize is needed.A rough interpolation (e.g., nearest neighbour) may cause visible artifacts, however, the

CPU usage to perform such interpolation is quite limited. A good quality interpolation(e.g., lanczos) provides better results but may cause an high CPU load.

1064

10.1.10 DisplayOpenGL

bitmap

class name DisplayOpenGLcatalog name Systemcatalog id systemclass id GlImageDisplayauthors Alessandro Fausto

This block show the input image using the OpenGL graphic library. The user can chosebetween two different visualization mode (ignore/respect presentation time).The ’ignorepresentation time’ is the default mode (the only mode available in DIrectX and GDI dis-plays).In this mode the input image is immediatly painted on the display output.When in’respect presentation time’ mode the display paint the image when its presentation time isreached.When a new image reach the display input, thee case can be distincted : 1. Thepresentation time is lesser than current time: the image is dropped.2. The presentationtime is close to current time: the image is painted.3. The presentation time is greater thancurrent time: the image is inserted into a ordered queue.The used can select the maximumnumber of ordered queue elements (design time) and drop all elements from the queue (runtime).This block also permit to mirror the texture and select the quality of image scal-ing.The user, acting on ’Output queue status’ parameter, can enable or disable the outputof internal queue status.See the ’Extracted image counter’ and ’Queued images’ outputs pindescription for more details. This block is also able to intercept some mouse events, and togenerate a related output. The user can select among none, movement, button pressed orselection mouse handling modes. See the paramemter ’Mouse handling’ for more details.

– REMARKS – Most of this block operation is done by the hardware of the graphic board(GPU) without the intervention of CPU. This block, if supported by GPU, take advandagefrom the following openGL extension:GL EXT bgra; GL EXT bgr; GL NV texture rectangle;GL ARB texture rectangle; GL EXT texture rectangle.

The color space I420, YV12, HSV is not supported. The alpha channel is not supportedon BW, YUYV, UYVY color spaces. All input images with color space different from RGBor BGR are converted into RGB color space. If the graphic board dont support the openGLBGRA and BGR extension, the BGR image is converted to RGB. All pixel depth greaterthan 8 bit per channel is converted to 8 bit per channel. This conversions increase the CPUusage, please use RGB or BGR space with 8 bit per channel pixel format. Operation allwaydone in software: color space conversion, pixel format conversion, texture scaling.

Operation allways done in hardware: Texture mirroring, image rendering.Operation done in hardware (if specific openGL extension is supported) or software (if is

not supported): Color space conversion from BGR to RGB (GL EXT bgr and GL EXT bgra),texture scaling (GL NV texture rectangle, GL ARB texture rectangle and GL EXT texture rectangle).

Operation allways done in software: Color space conversion, pixel format conversion.– ERRORS – ’Load of parameter values failed’: This warning occur when Eyesweb

1065

encounter a error loading the block parameters from the patch file. In this case someparameters can be reset to default value. ’The alpha channel is not supported for X colorspace’ Add one image converter block before this block to convert the image into one ofthe following supported color spaces: RGB with alpha, BGR with alpha, YUV with alpha’The X color space is not supported.’ Add one image converter block before this block toconvert the image into one of the following supported color spaces: BW, RGB, BGR, YUV,YUYV, UYVY, I420, YV12, HSV

Inputs




Image to display.

Parameters







1066






layout



Flip imageid BgFliptype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:nonevertical (Y axis)horizontal (X axis)vertical & horizontal (both axis)

domain [ 0, 4 )Flip image over Y (flipping), X (flopping) or both axis.

Filterid filteringtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:”Point””Linear”

domain [ 0, 2 )

1067

Texture image filter (’Point’, ’Linear’) used when the texture is scaled. ’Point’ modeapproximate the pixel color with the color of nearest point, ’Linear’ mode do a linearinterpolation of neigthbour pixels colors.

1068

10.1.11 FilePlayer

bitmap

class name FilePlayercatalog name Systemcatalog id systemclass id file playerauthors Paolo Coletta

This block plays the given file on the given output device. It is a sort of replacemententfor a patch where you put both a file reader and an output block. In this case everything isdone internally by the block; this implies that you have less control on the playback (e.g.,you cannot apply effects to the data stream); however, in simple cases where no more thana simple playback is needed, this block might improve performance and simplify the patchlayout

Details The block internally uses DirectShow to playback the stream; for each file anew DirectShow graph is created. If some files file to play, you probably miss some codecsin Windows.

Notes Currently, only the audio stream of the file is played

Outputs

Statusid statustype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

The current player status

End Of Streamid end-of-streamtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Triggered when the end of the stream is reached

1069

Parameters

Device nameid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Name of the DirectShow-based file player virtual device


layout


Name of the file to be played

Volumeid volumetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the volume at which the file is played

Panid pantype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the balance of the stereo channel: -1.0 for left, 0.0 for center, 1.0 for right

Positionid positiontype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Statusid statustype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:PlayingPausedStopped

domain [ 0, 3 )The parameter reflect the status of the player device

1070


Put the device in Playback mode, if the patch is running, otherwise set the initial stateof the device


Put the device in Paused mode, if the patch is running, otherwise set the initial stateof the device


Put the device in Stopped mode, if the patch is running, otherwise set the initial stateof the device

1071

10.1.12 FrameGrabber

bitmap

class name FrameGrabbercatalog name Systemcatalog id systemclass id wdmvideo input


Captures a video from from WDM Video Input Device

Outputs

Outputid video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output

Parameters

Output datatype infoid datatype infotype Kernel, StringPairtype id kernel, string pairlayout



Device

1072

Image Color Modelid color modeltype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:RGB (3 channels - 24 bits)BGR (3 channels - 24 bits)YUV (3 channels - 24 bits)BW (1 channels - 8 bits)YUYV (3 channels (Y,U,Y,V) )UYVY (3 channels (U,Y,V,Y) )I420 (3 channels planar (Y,U,V) )YV12 (3 channels planar (Y,V,U) )RGBA (4 channels - 32 bits)BGRA (4 channels - 32 bits)YUVA (4 channels - 32 bits)

Image Color Model


Output Image Size

Frames per second.id fpstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Frames per second.

Vertical Mirrorid vert mirrortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Vertical Mirror

Horizontal Mirrorid horiz-mirrortype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the image must be swaped horizontaly

1073


layout

Combo Box:AUTOPAL-BNTSC

Type

Video Quality: Gain Flagid gain flagtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:DefaultAutoManual

domain [ 0, 3 )Specifies the desired control setting for the Gain property. Default - use the current

driver setting Auto - enables autogain Manual - set the user-specified value

Video Quality: Gain Valueid gain valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the value of the Gain property. Is is used only if Gain Flag is set to manual

Video Quality: Brightness Flagid brightness flagtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:DefaultAutoManual

domain [ 0, 3 )Specifies the desired control setting for the Brightness property. Default - use the current

driver setting Auto - enables autobrightness Manual - set the user-specified value

Video Quality: Brightness Valueid brightness valuetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

1074

Specifies the value of the Brightness property. Is is used only if Brightness Flag is setto manual

Override device init failed.id overridedeviceinitfailedtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If the system cannot initialize the selected WDM device the patch will be executedanyway.

Custom device propertiesid device typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Default - noneVideo crossbar compliant deviceDecklink frame grabber

domain [ 0, 3 )Custom device properties

1075

10.1.13 FunctionEvaluator

bitmap

class name FunctionEvaluatorcatalog name Systemcatalog id systemclass id function evaluatorauthors Alberto Massari

Evaluate an arbitrary user-specified function on every input data.

Remarks Allowed functions: abs, arg, acos, asin, atan, ceil, cos, cosh, exp, floor,log,log10, sin, sinh, sqrt, tan, tanh, atan2, mod, pow Allowed constants: integer number,floating point numbers (decimal separator is .), or pi (3.1415...) Allowed operators: +, -, *,/, ˆ(means pow) Allowed variables: x1, x2, x3, ..., xN (the number depends on the numberof inputs of the block) Examples: sqrt(x1)/(x1ˆ2) Avoid white spaces. The above exampleworks, but sqrt( x1 )/(x1ˆ2) does not work


During Initialization Phase -The number of inputs of the signature does not matchthe value specified by the parameter of the block. -Syntax error: if evaluation tree is full

Inputs

Input 1id input 1type Kernel, Double datatype (Kernel Catalog).type id kernel, double




1076

Outputs



Parameters

Expressionid expressiontype Kernel, String datatype (Kernel Catalog).type id kernel, string

The arithmetic expression to be evaluated


Specifies the number of inputs of this block.The number of inputs is the same of thevariables of arithmetic expression.

1077

10.1.14 GetFromHTTPVideoServer

bitmap

class name GetFromHTTPVideoServercatalog name Systemcatalog id systemclass id get-from-video-server


Outputs

Imageid image outputtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Decoded Jpeg Image

Parameters


Ip Address



Input Indexid input ndxtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Video Server input index

1078





layout




1079


layout




Has alphaid has alphatype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies whether the image has an alpha channel. Note that alpha channel is supportedonly with RGB, BGR, or YUV images. In all other cases this parameter should be set tofalse.

1080


Refresh

Keep aspect ratioid keep-aspect-ratiotype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Keep aspect ratio

1081

10.1.15 GetMouse

bitmap

class name GetMousecatalog name Systemcatalog id systemclass id GetMouseauthors Mirko Demurtas

This block capture the position of mouse pointer

Inputs

Clockid Synctype Kernel, Generic datatypetype id kernel, generic datatype



Clock

Outputs

Xid OutputXtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

X

Yid OutputYtype Kernel, Double datatype (Kernel Catalog).type id kernel, doubleinplace id *no*inherited id *no*

Y

1082

Parameters

Type Outputid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CoordinatesPoint

domain [ 0, 2 )Type Output

Domainid Domaintype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )This parameter allows to choose if output is int or double type.

HorizontalResolutionid XResolutiontype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Horizontal resolution of monitor. It’s used only in double domain.

VerticalResolutionid YResolutiontype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Vertical resolution of monitor It’s used only in double domain.

1083

10.1.16 HTTPVideoServer

bitmap

class name HTTPVideoServercatalog name Systemcatalog id systemclass id video-server


Inputs

Input image 0id input0type Base, Imagetype id base, image



Image 0 to compress and send

Parameters

Http serverid http-servertype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable Http 1.0 server


Web server Ip Address of the ethernet interface

1084



Qualityid qualitytype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 100 ]

Quality

Web server Rootid doc-roottype Kernel, String datatype (Kernel Catalog).type id kernel, stringlayout Folder

Root document for the HTML 1.0 web server

Number of inputsid num-inputstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of input for the video server

1085

10.1.17 Joystick

bitmap

class name Joystickcatalog name Systemcatalog id systemclass id Joystickauthors Gualtiero Volpe

This block retrives data from a joystick device.

Outputs

Joystick axesid Axestype Kernel, Double matrix.type id kernel, double-matrixinplace id *no*inherited id *no*

The current x, y, and z values along the joystick axes.

Joystick buttonsid Buttonstype Kernel, Integer matrix.type id kernel, int-matrixinplace id *no*inherited id *no*

The current state of the joystick buttons.

Parameters

Device nameid DeviceNametype Kernel, String datatype (Kernel Catalog).type id kernel, string

The name of the joystick device.

1086

Sampling periodid SamplingPeriodtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

The sampling period for the joystick data stream.

Enable axes outputid EnableAxestype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the x, y, z coordinates output is enabled.

Enable axis rotation outputid EnableAxesRotationstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the axis rotation output is enabled.

Enable buttons outputid EnableButtonstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the buttons output is enabled.

Enable sliders outputid EnableSliderstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the sliders output is enabled.

Enable POVs outputid EnablePOVstype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the POVs output is enabled.

X axis range minid XRangeMintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value along the x axis.

1087

X axis range maxid XRangeMaxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The maximum value along the x axis.

Y axis range minid YRangeMintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value along the y axis.

Y axis range maxid YRangeMaxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The maximum value along the y axis.

Z axis range minid ZRangeMintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value along the z axis.

Z axis range maxid ZRangeMaxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The maximum value along the z axis.

1088

10.1.18 MatrixDisplay

bitmap

class name MatrixDisplaycatalog name Systemcatalog id systemclass id table display gdi


This block display the input matrix formatted as spreadsheet table. When the bitrateof input is high, drawing the display generates a very high refesh rate. In this case somepersonal computers seem not responsive because the miss the processing power required toboth refresh the display and iteract with the user. To avoid this situation, set the ’Refreshmode’ parameter to ’Frequency limited’ or to ’time limited’. – REMARKS – When thedisplay is shrinked to a dimension too small the cells became unreadable.In this case thesuggested solution is to set the zoom mode to ’No fit’ and then set a correct value into thezoom parameter.Use the scrollbars to see all cells.

Inputs

Input Tableid input tabletype Kernel, Double matrix.type id kernel, double-matrix



Input Table

Parameters

double bufferingid double bufferingtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

enable double buffering to avoid flickering, with a performance cost

1089

Min Charid prm minchartype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Min Char

Max Charid prm maxchartype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

This parameter set the maximum width (number of characters) of a single cell. If thenumber of character of the matrix element is above this threshold the value is substitutedby # characters. In this case stop the patch, set this parameter to a greater value andrestart the patch.

decimal digitsid prm digittype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, 10 ]

This parameter represent the number of decimal digits to be displayed for all matrixelement. This value must be any integer number greater or equal to zero.

Fontid prm fonttype Kernel, Fonttype id kernel, font

This is the font used to print the column header, row header and matrix element values.

1090

10.1.19 MatrixValueVsIndexDisplay

bitmap

class name MatrixValueVsIndexDisplaycatalog name Systemcatalog id systemclass id matrix value vs index graph displayauthors Andrea Ricci

Draws the graph of the input matrix, using the row/column index on the x axis and therow/column values on the y axis in a Display Window.

Inputs

Input Matrixid inputtype Kernel, Double matrix.type id kernel, double-matrix



The input matrix. Its entries will be drawn in a graph according different criteria

Parameters

Double Bufferingid double bufferingtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Render the graph using a back buffer to avoid flickering, paying a slight performancecost


Reset graph, clearing plot data and setting axes to the initial state

1091

Canvas Fill Colorid canvas fill colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to fill the Canvas

Plot Background Fill Colorid plot bgnd fill colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to fill the Plot Background

Plot Border Line Styleid plot border line styletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NullSolidDashDotDashDotDashDotDot

domain [ 0, 6 )Control how the Plot Border line will be painted: - Null: the line will not be painted -

Solid: the line is solid - Dash: the line is dashed - Dot: the line is dotted - DashDot: theline has alternating dashes and dots - DashDotDot: the line has alternating dashes anddouble dots NOTE: if the line thickness is ¿ 1 then the line will be solid (this is due to aWin32 GDI limitation)

Plot Border Line Colorid plot border line colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to paint the Plot Border line

Plot Border Line Thicknessid plot border line thicknesstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the width of the Plot Border line, in logical units. NOTE: if the line thicknessis ¿ 1 then the line will be solid (this is due to a Win32 GDI limitation)

1092

Legend Positionid legend postype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:No LegendLeftRightTopBottom

domain [ 0, 5 )Set the legend position around the plot area

Legend Border Line Styleid legend border line styletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 6 )Control how the Legend Border line will be painted: - Null: the line will not be painted

- Solid: the line is solid - Dash: the line is dashed - Dot: the line is dotted - DashDot:the line has alternating dashes and dots - DashDotDot: the line has alternating dashes anddouble dots NOTE: if the line thickness is ¿ 1 then the line will be solid (this is due to aWin32 GDI limitation)

Legend Border Line Colorid legend border line colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to paint the Legend Border line

Legend Border Line Thicknessid legend border line thicknesstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the width of the Legend Border line, in logical units. NOTE: if the linethickness is ¿ 1 then the line will be solid (this is due to a Win32 GDI limitation)

1093

Legend Labels Fontid legend labels fonttype Kernel, Fonttype id kernel, font

Specify the font used to draw the Legend Labels

Legend Labels Font Colorid legend labels font colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to draw the Legend Labels font

X Axis Orientationid x axis orientationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int


domain [ 0, 2 )Determine the the x axis orientation

X Axis Labelid x axis labeltype Kernel, String datatype (Kernel Catalog).type id kernel, string

The label drawn near the X Axis, leave blank for no label

X Axis Label Positionid x axis label postype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:No LabelTopBottom

domain [ 0, 3 )Set the x axis label position around the plot area

X Axis Label Fontid x axis label fonttype Kernel, Fonttype id kernel, font

Specify the font used to draw the X Axis Label

1094

X Axis Label Font Colorid x axis label font colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to draw the X Axis Label font

X Axis Tick Stepid x axis tick steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The step for the x axis tick marks

X Axis Tick Labels Positionid x axis tick labels postype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 3 )Set the x axis tick labels position around the plot area

X Axis Tick Labels Fontid x axis tick labels fonttype Kernel, Fonttype id kernel, font

Specify the font used to draw the X Axis Tick Labels

X Axis Tick Labels Font Colorid x axis tick labels font colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to draw the X Axis Tick Labels font

1095

X Axis Tick Line Line Styleid x axis tick line line styletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 6 )Control how the X Axis Tick Line line will be painted: - Null: the line will not be

painted - Solid: the line is solid - Dash: the line is dashed - Dot: the line is dotted -DashDot: the line has alternating dashes and dots - DashDotDot: the line has alternatingdashes and double dots NOTE: if the line thickness is ¿ 1 then the line will be solid (thisis due to a Win32 GDI limitation)

X Axis Tick Line Line Colorid x axis tick line line colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to paint the X Axis Tick Line line

X Axis Tick Line Line Thicknessid x axis tick line line thicknesstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the width of the X Axis Tick Line line, in logical units. NOTE: if the linethickness is ¿ 1 then the line will be solid (this is due to a Win32 GDI limitation)

Y Axis Range Minid y axis range mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value for the y axis

Y Axis Range Maxid y axis range maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The maximum value for the y axis

1096

Y Axis Range Modeid y axis range modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:FixedAutoScaleAutoScaleInc

domain [ 0, 3 )Controls the y axis autoscale behaviour

Y Axis Orientationid y axis orientationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:TopDownBottomUp

domain [ 0, 2 )Determine the the y axis orientation

Y Axis Labelid y axis labeltype Kernel, String datatype (Kernel Catalog).type id kernel, string

The label drawn near the Y Axis, leave blank for no label

Y Axis Label Positionid y axis label postype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:No LabelRightLeft

domain [ 0, 3 )Set the y axis label position around the plot area

Y Axis Label Fontid y axis label fonttype Kernel, Fonttype id kernel, font

Specify the font used to draw the Y Axis Label

1097

Y Axis Label Font Colorid y axis label font colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to draw the Y Axis Label font

Y Axis Tick Stepid y axis tick steptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The step for the y axis tick marks

Y Axis Tick Labels Positionid y axis tick labels postype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 3 )Set the y axis tick labels position around the plot area

Y Axis Tick Labels Fontid y axis tick labels fonttype Kernel, Fonttype id kernel, font

Specify the font used to draw the Y Axis Tick Labels

Y Axis Tick Labels Font Colorid y axis tick labels font colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to draw the Y Axis Tick Labels font

1098

Y Axis Tick Line Line Styleid y axis tick line line styletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 6 )Control how the Y Axis Tick Line line will be painted: - Null: the line will not be


Y Axis Tick Line Line Colorid y axis tick line line colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to paint the Y Axis Tick Line line

Y Axis Tick Line Line Thicknessid y axis tick line line thicknesstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the width of the Y Axis Tick Line line, in logical units. NOTE: if the linethickness is ¿ 1 then the line will be solid (this is due to a Win32 GDI limitation)

Sample Modeid sample modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:By RowBy ColumnAutomatic

domain [ 0, 3 )Determine how matrix rows and columns are interpreted - By Row: a plot for each row

of the matrix - By Column: a plot for each column of the matrix - Automatic: by row orby column, determined by the minimum matrix dimension (ex. rows ¡ columns -¿ by row)

1099

Y Axis Scaleid y axis scaletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Linear10Log10 (dB)20Log10

domain [ 0, 3 )Determine the scale of the y axis. Note that when a logarithmic scale is selected, also

the axis boundaries and the tick step will be expressed in the same scale

Number of Plotsid num plotstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of configured plots. If the input matrix contains more than the specified numberof plots these will have default parameters

Plot 1 Labelid plot 1 labeltype Kernel, String datatype (Kernel Catalog).type id kernel, string

Plot 1 label

Plot 1 Line Styleid plot 1 line styletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 6 )Control how the Plot 1 line will be painted: - Null: the line will not be painted - Solid:

the line is solid - Dash: the line is dashed - Dot: the line is dotted - DashDot: the line hasalternating dashes and dots - DashDotDot: the line has alternating dashes and double dotsNOTE: if the line thickness is ¿ 1 then the line will be solid (this is due to a Win32 GDIlimitation)

1100

Plot 1 Line Colorid plot 1 line colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to paint the Plot 1 line

Plot 1 Line Thicknessid plot 1 line thicknesstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the width of the Plot 1 line, in logical units. NOTE: if the line thickness is ¿1 then the line will be solid (this is due to a Win32 GDI limitation)

Plot 1 No Autoscaleid plot 1 no autoscaletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Determine if Plot 1 is excluded from autoscale or not

1101

10.1.20 MatrixValueVsIndexOverlay

bitmap

class name MatrixValueVsIndexOverlaycatalog name Systemcatalog id systemclass id matrix value vs index graph overlayauthors Andrea Ricci

Draws the graph of the input matrix, using the row/column index on the x axis and therow/column values on the y axis over an input image.

Inputs




The graph will be painted over this input image





1102

Outputs

Output Imageid output imagetype Base, Imagetype id base, imageinplace id Input Imageinherited id *no*

The image containing the graph painted over the input image

Parameters





Canvas Transparent Fillid canvas fill transparenttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Determine if the color used to fill the Canvas will be transparent (no fill) or not (fillcolor is used)



Plot Background Transparent Fillid plot bgnd fill transparenttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Determine if the color used to fill the Plot Background will be transparent (no fill) ornot (fill color is used)

1103


layout









layout



1104


layout












1105







layout









1106


layout








layout






1107








layout








1108


layout










layout





1109




layout








1110


layout





layout







Plot 1 label

1111


layout










1112

10.1.21 MatrixValueVsValueDisplay

bitmap

class name MatrixValueVsValueDisplaycatalog name Systemcatalog id systemclass id matrix value vs value graph displayauthors Andrea Ricci

Draws the graph of the input matrix, using the specified row/column entries on the xaxis and the remaining row/column values on the y axis in a Display Window.

Inputs





Parameters



X Axis Indexid x axis sample indextype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Specify the matrix row/column index of the entries that will be used as the values forthe x axis of all the plots

1113








layout






1114




layout




layout






1115







X Axis Range Minid x axis range mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum value for the x axis

X Axis Range Maxid x axis range maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The maximum value for the x axis

X Axis Range Modeid x axis range modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 3 )Controls the x axis autoscale behaviour

1116







layout









1117


layout








layout






1118








layout








1119


layout










layout





1120




layout








1121


layout




X Axis Scaleid x axis scaletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 3 )Determine the scale of the x axis. Note that when a logarithmic scale is selected, also



layout






1122


Plot 1 label


layout










1123

10.1.22 MatrixValueVsValueOverlay

bitmap

class name MatrixValueVsValueOverlaycatalog name Systemcatalog id systemclass id matrix value vs value graph overlayauthors Andrea Ricci

Draws the graph of the input matrix, using the specified row/column entries on the xaxis and the remaining row/column values on the y axis over an input image.

Inputs









1124

Outputs



Parameters

X Axis Indexid x axis sample indextype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Specify the matrix row/column index of the entries that will be used as the values forthe x axis of all the plots









1125




layout








1126


layout




layout








1127










layout






1128




layout










layout



1129






layout








1130






layout








1131


layout










layout





1132




layout








1133


layout




X Axis Scaleid x axis scaletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 3 )Determine the scale of the x axis. Note that when a logarithmic scale is selected, also



layout






1134


Plot 1 label


layout










1135

10.1.23 MidiInput

bitmap

class name MidiInputcatalog name Systemcatalog id systemclass id midi inputauthors Mirko Demurtas

Gets message from the Midi port

Outputs

Outputid outputtype Base, MIDItype id base, midiinplace id *no*inherited id *no*

The output of the block is the midi message received through the midi port.

System Exclusive Messagesid output systemtype Kernel, Bytetype id kernel, byteinplace id *no*inherited id *no*

System Exclusive Messages

Parameters

Midi device nameid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the name of the midi device to use. If none is given, the default will be used.Use the EyesWeb control panel to map the given device name to a physical Midi port

Midi Bufferid device modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

1136

Specifies the desired working mode

1137

10.1.24 MidiOutput

bitmap

class name MidiOutputcatalog name Systemcatalog id systemclass id midi outputauthors Mirko Demurtas

Send message to the Midi port

Inputs

Inputid inputtype Base, MIDItype id base, midi



The inputof the block is the midi message sended through the midi port.

Parameters

Midi device nameid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the name of the midi device to use. If none is given, the default will be used.Use the EyesWeb control panel to map the given device name to a physical Midi port

Midi Bufferid device modetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies the desired working mode

1138

10.1.25 MouseClickDisplay

bitmap

class name MouseClickDisplaycatalog name Systemcatalog id systemclass id mouse display gdiauthors Mirko Demurtas

Show the input image

Inputs




Input image to show

Outputs

Xid OutputXtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

X

Yid OutputYtype Kernel, Int datatype (Kernel Catalog).type id kernel, intinplace id *no*inherited id *no*

Y

1139

Parameters

Type Outputid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CoordinatesPoint

domain [ 0, 2 )Type Output


layout

Combo Box:Move MouseClick MouseSelect MouseColor of pixel

domain [ 0, 4 )Mode

Horizontal Mirrorid MirrorXtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Horizontal Mirror

Vertical Mirrorid MirrorYtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Vertical Mirror

External Syncid SyncExttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

External Sync

1140

Type of Coordinateid Coordtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:ImageWindow

domain [ 0, 3 )Type of Coordinate

PosXid prm posxtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

horizontal position of the window

PosYid prm posytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

vertical position of the window

SizeXid prm sizextype Kernel, Int datatype (Kernel Catalog).type id kernel, int

horizontal size of the window

SizeYid prm sizeytype Kernel, Int datatype (Kernel Catalog).type id kernel, int

vertical size of the window

Captionid captiontype Kernel, String datatype (Kernel Catalog).type id kernel, string

Caption

1141

10.1.26 MultimediaTimer

bitmap

class name MultimediaTimercatalog name Systemcatalog id systemclass id multimedia timerauthors Paolo Coletta

Provides the functionalities offered by the Windows Multimedia Timer.

Outputs


Trigger (bang) output which is raised each time the timer elapses

Parameters


Period of the multimedia timer

1142

10.1.27 NetReceiver

bitmap

class name NetReceivercatalog name Systemcatalog id systemclass id net receiver

authorsSimone GambarottoDaniele Gambarotto

Receive data from the network.

Outputs

Datatypeid output datatype Kernel, Generic datatypetype id kernel, generic datatypeinplace id *no*inherited id *no*

Generic Datatype

Parameters

Hostid Hosttype Kernel, String datatype (Kernel Catalog).type id kernel, string

Host Address

TCP Portid TCP Porttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1024, 65535 ]

TCP Port

Filterid Filtertype Kernel, String datatype (Kernel Catalog).type id kernel, string

Filter

1143

Socket Windowid ShowWindowSockettype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Show Socket Window

1144

10.1.28 NetSender

bitmap

class name NetSendercatalog name Systemcatalog id systemclass id net sender

authorsSimone GambarottoDaniele Gambarotto

Send data to the network.

Inputs

id input datatype Kernel, Generic datatypetype id kernel, generic datatype



Parameters

id TCP Porttype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1024, 65535 ]

id Filtertype Kernel, String datatype (Kernel Catalog).type id kernel, string

Socket Windowid ShowWindowSockettype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Show Socket Window

1145

10.1.29 OSAudioMixerOutput

bitmap

class name OSAudioMixerOutputcatalog name Systemcatalog id systemclass id mixer output


Sends the received values to the mixer to set its sliders

Inputs

Muteid 0type Kernel, Bool datatype (Kernel Catalog).type id kernel, bool



Mute

Volumeid 1type Kernel, Double datatype (Kernel Catalog).type id kernel, double



Volume

Parameters

Mixer outputid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

1146

Let you set the parameter of the Windows mixer

Lineid linetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Master Volume

domain [ 0, 1 )Specifies the line that this mixer will act on

Sourceid sourcetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:CD AudioMaster Volume

domain [ 0, 2 )Specifies the source that this mixer will act on

Use lineid use linetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Specifies wether controls are relative to Line or Source

1147

10.1.30 ScalarGraph

bitmap

class name ScalarGraphcatalog name Systemcatalog id systemclass id scalar graph display gdi


This block display the graph of input scalar values using the Windows GDI library. Thegraph is composed on a canvas of 320x240 pixel.When the bitrate of input is high drawingthe graph generates a very high refesh rate. In this case some personal computers seemnot responsive because the miss the processing power required to both refresh the displayand iteract with the user. To avoid this situation, set the ’Refresh mode’ parameter to’Frequency limited’ or to ’time limited’. – REMARKS – When the display is shrinked to adimension lower than 320x240 pixels the graph lines are distorded.

– ERRORS – ’Found outdated version of GDI display block, ignored parameter list:¡LIST¿’ The parameters loaded from the patch and listed into the ¡LIST¿ are ignoredbecause relative to one old version of DisplayGDI block.

Inputs

Inputid InputData000type Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input of scalar values to plot on the graph.

Parameters


Label

1148

Numer of inputid nInputtype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Number of input.

minid mintype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Minimum value to plot.

maxid maxtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Maximum value to plot.

Num X Axisid nXAxistype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of horizontal axis

Num Y Axisid nYAxistype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of vertical axis

time windowid duratetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

This parameter sets the visible time window of the graph. The graph only shows themost recent value within the time window; as time increase (i.e., as the patch executionprogresses) the time window is shifted.

Color 001 Inputid ColorData000type Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

This is the color used to paint the input number 001.

1149

Show 001 Inputid ShowData000type Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Show or hide the graph of input number 001 values.

1150

10.1.31 ScalarValueVsSampleDisplay

bitmap

class name ScalarValueVsSampleDisplaycatalog name Systemcatalog id systemclass id scalar value vs sample graph displayauthors Andrea Ricci

Draws the graph of the input scalar value(s) on the y axis using its sample index on thex axis in a Display Window.

Inputs




The scalar data of this input will be drawn in Plot 1

Parameters



Visible samplesid num visible samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

Number of samples visible along the X axis

1151

Invisible samplesid num invisible samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Number of invisible samples, used for autoscale

X axis modeid x axis modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:FixedScrollingWrap Around

domain [ 0, 3 )Determine the data behaviour along the X axis: - Fixed: the samples scroll but the grid

is fixed - Scrolling: the samples scroll along with the grid - Wrap Around: the data wrapsaround, no scrolling at all

Wrap Marker Visibleid wrap marker visibletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

When the x axis is in Wrap Around mode, show/hide the last sample marker

Wrap Marker Line Styleid wrap marker line styletype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 6 )Control how the Wrap Marker line will be painted: - Null: the line will not be painted


1152

Wrap Marker Line Colorid wrap marker line colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Determine the color used to paint the Wrap Marker line

Wrap Marker Line Thicknessid wrap marker line thicknesstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

Specifies the width of the Wrap Marker line, in logical units. NOTE: if the line thicknessis ¿ 1 then the line will be solid (this is due to a Win32 GDI limitation)








layout


domain [ 0, 6 )

1153

Control how the Plot Border line will be painted: - Null: the line will not be painted -Solid: the line is solid - Dash: the line is dashed - Dot: the line is dotted - DashDot: theline has alternating dashes and dots - DashDotDot: the line has alternating dashes anddouble dots NOTE: if the line thickness is ¿ 1 then the line will be solid (this is due to aWin32 GDI limitation)






layout




layout


domain [ 0, 6 )

1154

Control how the Legend Border line will be painted: - Null: the line will not be painted- Solid: the line is solid - Dash: the line is dashed - Dot: the line is dotted - DashDot:the line has alternating dashes and dots - DashDotDot: the line has alternating dashes anddouble dots NOTE: if the line thickness is ¿ 1 then the line will be solid (this is due to aWin32 GDI limitation)












1155




layout










layout



1156






layout








1157






layout








1158


layout










layout





1159




layout









Number of input data series. Each serie is drawn as a separate plot

1160


Plot 1 label


layout










1161

10.1.32 ScalarValueVsSampleOverlay

bitmap

class name ScalarValueVsSampleOverlaycatalog name Systemcatalog id systemclass id scalar value vs sample graph overlayauthors Andrea Ricci

Draws the graph of the input scalar value(s) on the y axis using its sample index on thex axis over an input image.

Inputs









1162

Outputs



Parameters


Number of samples visible along the X axis




layout






1163


layout












1164








layout






1165




layout




layout






1166













layout



1167








layout







1168


layout












1169


layout









layout





1170






layout







1171


layout











Plot 1 label

1172


layout










1173

10.1.33 ScalarValueVsTimeDisplay

bitmap

class name ScalarValueVsTimeDisplaycatalog name Systemcatalog id systemclass id scalar value vs time graph displayauthors Andrea Ricci

Draws the graph of the input scalar value(s) in a Display Window.

Inputs





Parameters

Refresh Periodid refresh periodtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Display refresh period



Visible Durationid visible durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

1174

The time span of the X axis

Invisible Durationid invisible durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Time span of invisible samples, used for autoscale


layout







layout




1175












layout


domain [ 0, 6 )

1176

Control how the Plot Border line will be painted: - Null: the line will not be painted -Solid: the line is solid - Dash: the line is dashed - Dot: the line is dotted - DashDot: theline has alternating dashes and dots - DashDotDot: the line has alternating dashes anddouble dots NOTE: if the line thickness is ¿ 1 then the line will be solid (this is due to aWin32 GDI limitation)






layout




layout


domain [ 0, 6 )

1177

Control how the Legend Border line will be painted: - Null: the line will not be painted- Solid: the line is solid - Dash: the line is dashed - Dot: the line is dotted - DashDot:the line has alternating dashes and dots - DashDotDot: the line has alternating dashes anddouble dots NOTE: if the line thickness is ¿ 1 then the line will be solid (this is due to aWin32 GDI limitation)












1178




layout










layout



1179






layout








1180






layout








1181


layout










layout





1182




layout










1183


Plot 1 label


layout










1184

10.1.34 ScalarValueVsTimeOverlay

bitmap

class name ScalarValueVsTimeOverlaycatalog name Systemcatalog id systemclass id scalar value vs time graph overlayauthors Andrea Ricci

Draws the graph of the input scalar value(s) over an input image.

Inputs









Outputs


1185


Parameters

Visible Durationid visible durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

The time span of the X axis

Invisible Durationid invisible durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Time span of invisible samples, used for autoscale


layout






1186


layout












1187








layout






1188




layout




layout






1189













layout



1190








layout







1191


layout












1192


layout









layout





1193






layout







1194


layout











Plot 1 label

1195


layout










1196

10.1.35 ScalarValueVsValueDisplay

bitmap

class name ScalarValueVsValueDisplaycatalog name Systemcatalog id systemclass id scalar value vs value graph displayauthors Andrea Ricci

Draws the graph of the input scalar value(s) on the y axis using a reference input valueon the x axis in a Display Window.

Inputs

Reference Inputid reference inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



The reference input will be used as the x axis value for the input values (used as the yaxis values)





Parameters


1197



Number visible of samples









1198


layout









layout



1199


layout












1200






layout








1201


layout










layout





1202




layout










1203




layout









layout



1204








layout







1205


layout











Plot 1 label

1206


layout










1207

10.1.36 ScalarValueVsValueOverlay

bitmap

class name ScalarValueVsValueOverlaycatalog name Systemcatalog id systemclass id scalar value vs value graph overlayauthors Andrea Ricci

Draws the graph of the input scalar value(s) on the y axis using a reference input valueon the x axis over an input image.

Inputs





Reference Inputid reference inputtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



The reference input will be used as the x axis value for the input values (used as the yaxis values)

1208





Outputs



Parameters


Number visible of samples





1209










layout




1210






layout




layout




1211













1212


layout









layout





1213






layout







1214


layout












1215


layout









layout





1216






layout







1217


layout











Plot 1 label

1218


layout










1219

10.1.37 ScreenCapture

bitmap

class name ScreenCapturecatalog name Systemcatalog id systemclass id screen captureauthors Massimiliano Peri

Capture part of the screen into one image with BGR color space and alpha channel. Thisblock can do a single snapshot or repeatly capture the screen. Two different method areused to capture the screen: The first use the GDIplus library; the second use the DirectXlibrary.

Outputs

outputid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Captured output image (BGR color space with alpha channel)

Parameters

Areaid recttype Base, Roi 2D inttype id base, roi2d int

This is the part of the screen (in integer screen coordinates) captured into the outputimage.

Monitor indexid screen devicetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Select the monitor index, 0=primary 1=secondary ...

Fpsid fpstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

1220

Numer of frames captured per second (FPS). Must be greather or equal to zero.If setto zero is captured only one frame at the patch start.

Use DirectXid use dxtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Use the DirectX library to capture the screen area, otherwise is used the GDIplus library.

1221

10.1.38 SendToPsyclone

bitmap

class name SendToPsyclonecatalog name Systemcatalog id systemclass id send to psycloneauthors Mirko Demurtas

This block send data to a Psyclone whiteboard.

Inputs

Input SPCid sendpsyclone SPCtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input SPC

Input TMPid sendpsyclone TMPtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input TMP

1222

Input FLDid sendpsyclone FLDtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input FLD

Input PWRid sendpsyclone PWRtype Kernel, Double datatype (Kernel Catalog).type id kernel, double



Input PWR

Parameters

Whiteboardid sendpsyclone whiteboardtype Kernel, String datatype (Kernel Catalog).type id kernel, string

The name of the Psyclone whiteboard

Psyclone hostid sendpsyclone hosttype Kernel, String datatype (Kernel Catalog).type id kernel, string

The IP address of the computer on which Psyclone is running

Psyclone portid sendpsyclone porttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The port on which Psyclone is running

1223

Typeid sendpsyclone typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:periodicnon-periodic

domain [ 0, 2 )Type indicates whether the send data refers to an periodic (0) or non-periodic (1) value

Connectid sendpsyclone connecttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Connect

1224

10.1.39 SerialInput

bitmap

class name SerialInputcatalog name Systemcatalog id systemclass id serial input


Gets bytes from the serial (COM) port

Outputs

Outputid outputtype Kernel, Bytetype id kernel, byteinplace id *no*inherited id *no*

The output of the block is the byte received through the serial port.

Parameters

Serial device nameid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the name of the serial device to use. If none is given, the default will be used.Use the EyesWeb control panel to map the given device name to a physical COM port

Device modeid device modetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the desired working mode, e.g., 9600, N, 8, 1

1225

10.1.40 SerialOutput

bitmap

class name SerialOutputcatalog name Systemcatalog id systemclass id serial output


Writes bytes to the serial (COM) port

Inputs

Inputid inputtype Kernel, Bytetype id kernel, byte



The input of the block is the byte to be sent through the serial port.

Parameters

Serial device nameid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the name of the serial device to use. If none is given, the default will be used.Use the EyesWeb control panel to map the given device name to a physical COM port

Device modeid device modetype Kernel, String datatype (Kernel Catalog).type id kernel, string

Specifies the desired working mode, e.g., 9600, N, 8, 1

1226

10.1.41 StringDisplay

bitmap

class name StringDisplaycatalog name Systemcatalog id systemclass id string display

authorsPaolo ColettaMassimiliano Peri

Draws the input string inside the block area or in a separate window. The string isrefreshed each time the input value changes.

Inputs

Input stringid stringtype Kernel, String datatype (Kernel Catalog).type id kernel, string



Input string to display.

Parameters

Fontid fonttype Kernel, Fonttype id kernel, font

The font used to display the input string.


Font color (RGB model space)

1227

Background color (RGB model space)id background colortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Color of the text background (RGB model space)

Number of linesid number of linestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The number of lines which compose the document on which the text is written

Number of columnsid number of columnstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, +infinity )

The number of columns which compose the document on which the text is written

Horizontal alignmentid aligmenttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Near (left)CenterFar (right)

domain [ 0, 3 )Background color (RGB model space)

1228

10.1.42 TCPClient

bitmap

class name TCPClientcatalog name Systemcatalog id systemclass id client tcpauthors Mirko Demurtas

This block send the data received in input over a TCP connection

Inputs

Inputid input datatype Kernel, String datatype (Kernel Catalog).type id kernel, string



Input String

Parameters


Host Server

Portid TCP Porttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Port Server

Connect on startid Connecttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Connect on start

1229

10.1.43 TitleMachine

bitmap

class name TitleMachinecatalog name Systemcatalog id systemclass id title machine


Superimpose text to the input image. It works in-place.

Inputs




This is the original image. The specified text will be added to the image.

Outputs

Output Imageid output video streamtype Base, Imagetype id base, imageinplace id Input Imageinherited id *no*

This is the modifified image, which contains the superimposed text.

Parameters

Titleid titletype Kernel, String datatype (Kernel Catalog).type id kernel, string

This is the text which is superimposed to the image.

1230

Alpha levelid alphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the alpha level of the superimposed text. A value of 0.0 means transparency,i.e., the text is not visible at all, a value of 1.0 means opacity, i.e., the text (where it ispresent) completely covers the image.

Text orientationid orientationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the text orientation (in degrees)

Text colorid rgbcolortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

The color (RGB model space) used to paint the text

Text fontid fonttype Kernel, Fonttype id kernel, font

Font used to draw the text

Text positionid positiontype Base, Point 2D inttype id base, point 2d int

Text position

Text bounding recangle sizeid sizetype Base, Size 2D inttype id base, size2d int

Text bounding recangle size

Horizontal flipid horizontal fliptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Horizontal flip

1231

Vertical flipid vertical fliptype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Vertical flip

Horizontal alignmentid horizontal alignmenttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NearCenterFar

domain [ 0, 2 ]Specifies the horizontal alignment of the text. Near means left alignment, far means

right alignment.

Vertical alignmentid vertical alignmenttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:NearCenterFar

domain [ 0, 2 ]Specifies the vertical alignment of the text. Near means top alignment, far means bottom

alignment.

1232

10.1.44 UdpClient

bitmap

class name UdpClientcatalog name Systemcatalog id systemclass id client updauthors Mirko Demurtas

UDP client

Inputs

Inputid input datatype Kernel, String datatype (Kernel Catalog).type id kernel, string



Input String

Parameters


Host Server


Port Server

1233


layout

Combo Box:StringIntegerDoubleByte

domain [ 0, 4 )Type of input

1234

10.1.45 UdpServer

bitmap

class name UdpServercatalog name Systemcatalog id systemclass id server udpauthors Mirko Demurtas

UDP server

Outputs

Outputid output datatype Kernel, String datatype (Kernel Catalog).type id kernel, stringinplace id *no*inherited id *no*

Output String

Parameters


Port Server


layout

Combo Box:StringIntegerDoubleByte

domain [ 0, 4 )Type of output

1235

10.1.46 VideoFileReader

bitmap

class name VideoFileReadercatalog name Systemcatalog id systemclass id video-file-reader ver 2


Reads a video stream from file.

Outputs

Output video buffer.id video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Output video buffer.

File cuedid cued filetype Kernel, Trigger datatype (Kernel Catalog).type id kernel, triggerinplace id *no*inherited id *no*

Generate a bang when the file is cued successfully

Current frame timeid outputtimetype Kernel, Time datatype (Kernel Catalog).type id kernel, timeinplace id *no*inherited id *no*

Contains the time of the actual frame

1236

Parameters


layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Multimedia files (*.mpg,*.mpeg,*.avi,*.wmv,*.bmp,*.gif,*.jpeg,*.png,*.tiff)—*.mpg;*.mpeg;*.avi;*.wmv;*.bmp;*.gif;*.jpg;*.png;*.tiff—All files (*.*)—*.*——”

Specifies the name of file to read.


layout



following values:BW (1 channel: grayscale);BGR (3 channel packed: Blue, Green, Red);RGB (3 channel packed: Red, Green, Blue);YUV (3 channel packed: Y, Cb, Cr);YUYV (3 channel packed, undersampled 422: Y, Cb, Cr);UYVY (3 channel packed, undersampled 422: Y, Cb, Cr);I420 (3 channel planar, undersampled 411: Y, Cb, Cr);YV12 (3 channel planar, undersampled 411: Y, Cb, Cr);

1237

HSV (3 channel packed: Hue, Saturation, Value).


layout




Video sizeid sizetype Base, Size 2D inttype id base, size2d int

Output video size, in pixel

ROIid roitype Base, Roi 2D inttype id base, roi2d int

The ROI (Region of Interest) of an image specifies a rectangular are of the image whichcontains valid data. The image outside this are is ignored, thus, operations on the imagewill only be applied in the area of interest. In many cases, this may reduce the amount ofcalculations performed. If set to NULL, then the ROI is ignored, i.e., the whole image isalways used.

Frames per secondid fpstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Frames per second of the output streams. Usually 25 (PAL) or 30 (NTSC).

Time to goto/endid goto timetype Kernel, Time datatype (Kernel Catalog).type id kernel, time

1238

Specifies the time to be reached/finished

Gotoid gototype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Forces the file to reach the specified position

Change Durationid endtotype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Change Duration


layout

Combo Box:Nearest neighbourLinearCubic

domain [ 0, 2 ]Specifies the color model of the output image

Algorithmid algorithmtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Algorithm is chosen by EyesWebFastAccurate

domain [ 0, 2 ]Typpe of algorithm used when performing operations on images

Frames before seekid frames before seektype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

Specifies the number of frames to skip before performing a seek. In many cases, de-compressing and skipping frames gives a better performance than seeking to the desiredposition.

1239


Specifies the start position of the file

Durationid media durationtype Kernel, Time datatype (Kernel Catalog).type id kernel, time

Specifies the length of the portion of the file to be read. Use zero to specify the wholefile.

Playback rateid playback ratetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Specifies the playback rate. Use 1.0 for normal speed, higher values (e.g., 2.0) for fast-forward, lower values for slow motion. Negative values mean going backward. Note thataudio is always muted for playback rate different from 1.0.


layout



the aspectRatio is not preserved, and the source image is stretched or shrinked to coverall available space. In the other cases, the aspect ratio is (or might be) preserved, thus a

1240

black frame might be needed on the horizontal or vertical side to cover the unused space.This enumerator specifies where to place such black frame. Since the user might not knowin advance whether letterboxing will place mattes above/below or left/right, each modespecifies how to behave in both cases. As an example, the letterbox mode left-middle meansthat if the image needs mattes on the sides, the image will be put to the extreme left, andthe matte will span the right side; if the image needs mattes above/below, the image willbe vertically centered. Hence, the mode is made of two terms, the first referring to thehorizontal centering of the image, the second referring to the vertical centering. Horizontalcentering may assume values none, left, center, or right. Vertical centering may assumevalues none, top, middle, or bottom. The term none means that if letterboxing is neededon that direction, than the image is stretched to fill the whole size. E.g., elmNoneTopmeans that is image is thinner than the destination rect, than no letterboxing is appliedand the image is stretched horizontally. However, it the image is larger than the destinationrect, than letterboxing is applied by putting the image on the top and a single matte below.

Player statusid statustype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:StoppedPausedPlaying

domain [ 0, 3 )Specifies the status of the player. If no file is currently executing, this parameter is

ignored, however it specifies whether the block is stopped, is paused, or is playing. Whenthe block is stopped the output is a black frame; when the block is paused the output isa fixed frame (the last played one); when the block is playing the output changes at eachstep. If this parameter is changed at design time or when no file is playing, its value is usedas an initial status.


layout


domain [ 0, 2 ]Specifies the behaviour when end of file is reached. It can stop (black frames), pause

(last frame) or loop (rewind and play).

1241


Start (or resume) playing the selected file


Pause at the currently reached frame


Stop playing, produces a black frame as output

Frame upid frameuptype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Go to the next frame.

Frame downid framedowntype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

Go to the previous frame.

Keep last if mediatime unknownid keep last frame if mediatime is unknowntype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If the block is in slave mode and receive from master an UNKNOWN time the last frameis kept otherwise a back frame is generated

Generate frame on stop and pauseid genearte frame on stop and pausetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

After a request of stop or pause state, the blocks generate a frame. Black for stop andlast used frame for pause

1242

Master IDid master idtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Master identifier

Syncronization Typeid sync typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:StandaloneMasterSlave

domain [ 0, 3 )Set the type of syncronization

1243

10.1.47 VideoServerS1502e

bitmap

class name VideoServerS1502ecatalog name Systemcatalog id systemclass id verint-video-server


VideoServer S1502e

Outputs

VIDEO STREAMid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

VIDEO STREAM

AUDIO STREAMid output audio streamtype Base, Audio buffertype id base, audio bufferinplace id *no*inherited id *no*

AUDIO STREAM

Parameters



640x480 VGA (old graphic cards)1024x768 XGA (common resolution for 15” LCDmonitors)1280x1024 SXGA (common resolution for 17” LCD monitors)

1244

1400x1050 SXGA+ (many notebooks)1600x1200 UXGA (20” LCD monitors)1920x1200 WUXGA (modern widescreen monitors)352x288 PAL QCIF720x576 PAL


layout





layout


domain [ 0, 17 )

1245

The color model define the way a color is stored into the image.May assume one offollowing values:

BW (1 channel: grayscale);BGR (3 channel packed: Blue, Green, Red);RGB (3 channel packed: Red, Green, Blue);YUV (3 channel packed: Y, Cb, Cr);YUYV (3 channel packed, undersampled 422: Y, Cb, Cr);UYVY (3 channel packed, undersampled 422: Y, Cb, Cr);I420 (3 channel planar, undersampled 411: Y, Cb, Cr);YV12 (3 channel planar, undersampled 411: Y, Cb, Cr);HSV (3 channel packed: Hue, Saturation, Value).

Video ipid videp iptype Kernel, String datatype (Kernel Catalog).type id kernel, string

S1502e (VIDEO) videserver ip

Audio ipid audio iptype Kernel, String datatype (Kernel Catalog).type id kernel, string

S1502e (AUDIO) videserver ip

Video udp portid video porttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

S1502e (VIDEO) videserver udp port

Audio udp portid audio porttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

S1502e (AUDIO) videserver ipudp port

1246

10.1.48 WakeOnLAN

bitmap

class name WakeOnLANcatalog name Systemcatalog id systemclass id wake on lanauthors Paolo Coletta

Send a magic packet over the network to wakeup a PC.

Parameters

Wake nowid wake bangtype Kernel, Trigger datatype (Kernel Catalog).type id kernel, trigger

When this command is received, the wake signal is sent.

MAC addressid ether addrtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Ethernet addresss of the target computer. It must be expressed in exadecimal format:”00:00:00:00:00:00”.

1247

10.1.49 WaveInput

bitmap

class name WaveInputcatalog name Systemcatalog id systemclass id wave input

authorsMirko DemurtasPaolo Coletta

Gets audio data from an input audio device using Microsoft Windows Multimedia API(also known as Wave APIs).

Details The block provides two different settings for the number of buffers to be used.The first setting is for the number of buffers used by the device, the device is for the numberof buffers used by the block

Notes With the partial support of the EU IST Project 250026 - SIEMPRE (SocialInteraction and Entrainment using Music PeRformance Experimentation), 2010-2012

Outputs

Audio streamid outputtype Base, PCMAudioBuffertype id base, pcm audio bufferinplace id *no*inherited id *no*

Audio stream captured from the specified device

Parameters


The audio input device to be used. If none is specified (empty string) the default onewill be used

Sampling rateid samplingratetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

1248

Sampling frequancy of the audio signal

Samples per bufferid samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The number of samples per each audio buffer

Number of channelsid numchannelstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Number of channels of the audio signal. Most devices only support mono (1) or setere(2) audio

PCM formatid pcm formattype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout


domain [ 0, 11 )Specifies the format of the output buffer. The format used internally by the device

might differ from this; however, the block will try to use the most similar format supportedby the device

Number of device buffersid num device bufferstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

The number of buffers affects the internal storage of the device. Increasing this numbermakes acquisition more robust with respect to data loss, however it may increase devicelatency (which may raise up to number of buffers - 1)

1249

Number of block buffersid num block bufferstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

The number of buffers affects the storage of the block. Increasing this number makesacquisition more robust with respect to data loss, however it may increase block latency(which may raise up to number of buffers - 1)

Lost buffers modeid lost buffers modetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:Minimize delayMinimize data loss

domain [ 0, 2 )Specifies how to handle the case where buffers are lost. Minimizing delay more buffers

are lost at the same time, but latency is kept small. Minimizing loss less data is lost, butlatency remains near its upper bound.

Enable lost buffers countid enable lost buffers counttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

If set to true, the block will have an additional output to count the buffers lost by theblock. Note that the buffers lost by the device are not counted

1250

10.1.50 WaveOutput

bitmap

class name WaveOutputcatalog name Systemcatalog id systemclass id wave output

authorsMirko DemurtasPaolo Coletta

Send audio data to an output audio device using Microsoft Windows Multimedia API(also known as Wave API).

Notes With the partial support of the EU IST Project 250026 - SIEMPRE (SocialInteraction and Entrainment using Music PeRformance Experimentation), 2010-2012

Inputs

Audio streamid inputtype Base, PCMAudioBuffertype id base, pcm audio buffer



Audio stream captured from the specified device

Parameters

Device nameid devicetype Kernel, String datatype (Kernel Catalog).type id kernel, string

The virtual name of the device. If none is specified the default device will be used

Min num device buffersid min num device bufferstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 0, +infinity )

1251

This value affects output latency. When the device is idle, and new data is availablefrom EyesWeb, the device might send this new data out immediately (thus reducing thelatency to zero) or wait for more buffers to be available. This increase the output latencybut makes audio more robust when the data is not provided with a stable datarate (e.g.,due to high computational load)

Num device buffersid num device bufferstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 2, +infinity )

The maximum number of buffers stored by the device. This may affect data loss

1252

10.1.51 fontgenerator

bitmap

class name fontgeneratorcatalog name Systemcatalog id systemclass id font generatorauthors Simone Ghisio

This block generates font datatype according to parameters value.

Outputs

output fontid output fonttype Kernel, Fonttype id kernel, fontinplace id *no*inherited id *no*

Output font

Parameters

escapementid escapementtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The angle, in tenths of degrees, between the escapement vector and the x-axis of thedevice. The escapement vector is parallel to the base line of a row of text.

1253

FontNameid font nametype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:SystemTerminalFixedsysModernRomanScriptCourierMS SerifMS Sans SerifSmall Fonts8514oemMarlettArialArabic TransparentArial BalticArial CEArial CYRArial GreekArial TURBatang@BatangBatangChe@BatangCheGungsuh@GungsuhGungsuhChe@GungsuhCheCourier NewCourier New BalticCourier New CECourier New CYRCourier New GreekCourier New TURDaunPenhDokChampaEstrangelo EdessaEuphemiaGautamiVaniGulim@GulimGulimChe@GulimCheDotum@DotumDotumChe@DotumCheImpactIskoola PotaKalingaKartikaKhmer UILao UILathaLucida ConsoleMalgun Gothic@Malgun GothicMangalMeiryo@MeiryoMeiryo UI@Meiryo UIMicrosoft HimalayaMicrosoft JhengHei@Microsoft JhengHeiMicrosoft YaHei@Microsoft YaHeiMingLiU@MingLiUPMingLiU@PMingLiUMingLiU HKSCS@MingLiU HKSCSMingLiU-ExtB@MingLiU-ExtBPMingLiU-ExtB@PMingLiU-ExtBMingLiU HKSCS-ExtB@MingLiU HKSCS-ExtBMongolian BaitiMS Gothic@MS GothicMS PGothic@MS PGothicMS UI Gothic@MS UI GothicMS Mincho@MS MinchoMS PMincho@MS PMinchoMV BoliMicrosoft New Tai LueNyalaMicrosoft PhagsPaPlantagenet CherokeeRaaviSegoe ScriptSegoe UISegoe UI SemiboldSegoe UI LightSegoe UI SymbolShrutiSimSun@SimSunNSimSun@NSimSunSimSun-ExtB@SimSun-ExtBSylfaenMicrosoft Tai LeTimes New RomanTimes New Roman BalticTimes New Roman CETimes New Roman CYRTimes New Roman GreekTimes New Roman TURTungaVrindaShonar BanglaMicrosoft Yi BaitiTahomaMicrosoft Sans SerifAngsana NewAparajitaCordia NewEbrimaGishaKokilaLeelawadeeMicrosoft UighurMoolBoranSymbolUtsaahVijayaWingdingsAndalusArabic TypesettingSimplified ArabicSimplified Arabic FixedSakkal MajallaTraditional ArabicAharoniDavidFrankRuehlLevenim MTMiriamMiriam FixedNarkisimRodFangSong@FangSongSimHei@SimHeiKaiTi@KaiTiAngsanaUPCBrowallia NewBrowalliaUPCCordiaUPCDilleniaUPCEucrosiaUPCFreesiaUPCIrisUPCJasmineUPCKodchiangUPCLilyUPCDFKai-SB@DFKai-SBLucida Sans UnicodeArial BlackCalibriCambriaCambria MathCandaraComic Sans MSConsolasConstantiaCorbelFranklin Gothic MediumGabriolaGeorgiaPalatino LinotypeSegoe PrintTrebuchet MSVerdanaWebdingsLinux Libertine GLinux Biolinum GMT ExtraNinaSegoe CondensedDejaVu Sans CondensedGentium BasicDejaVu SerifLiberation Sans NarrowGentium Book BasicDejaVu Serif CondensedDejaVu Sans MonoDejaVu SansDejaVu Sans LightOpenSymbol

domain [ 0, 201 )

1254

Specifies the typeface name of the font.

heightid heighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The height, in logical units, of the font’s character cell or character. The characterheight value (also known as the em height) is the character cell height value minus theinternal-leading value.

italicid italictype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

An italic font if set to TRUE.

orientationid orientationtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The angle, in tenths of degrees, between each character’s base line and the x-axis of thedevice.

strike outid strike outtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

A strikeout font if set to TRUE.

underlineid underlinetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

An underlined font if set to TRUE.

weightid weighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The weight of the font. If this value is zero, a default weight is used.

widthid widthtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

1255

The average width, in logical units, of characters in the font. If lfWidth is zero, theaspect ratio of the device is matched against the digitization aspect ratio of the availablefonts to find the closest match, determined by the absolute value of the difference.

1256

10.2 Datatypes

10.3 Authors


class name Alberto Massaricatalog name Systemcatalog id systemclass id alby



class name Alberto Massaricatalog name Systemcatalog id systemclass id alby



class name Alessandro Faustocatalog name Systemcatalog id systemclass id alessandro

[email protected]

10.3.4 Andrea Ricci

class name Andrea Riccicatalog name Systemcatalog id systemclass id andrea


1257

10.3.5 Andrea Ricci

class name Andrea Riccicatalog name Systemcatalog id systemclass id andrea


10.3.6 Carlo Drioli

class name Carlo Driolicatalog name Systemcatalog id systemclass id carlo


10.3.7 Daniele Gambarotto

class name Daniele Gambarottocatalog name Systemcatalog id systemclass id daniele gambarotto

Software Engineer Microsoft Certified Professional Microsoft Certified Solution Devel-oper Microsoft Certified Systems Administrator

10.3.8 Gualtiero Volpe

class name Gualtiero Volpecatalog name Systemcatalog id systemclass id gualtiero

[email protected]


class name Massimiliano Pericatalog name Systemcatalog id systemclass id massy

1258



class name Massimiliano Pericatalog name Systemcatalog id systemclass id massy



class name Mirko Demurtascatalog name Systemcatalog id systemclass id mirko



class name Paolo Colettacatalog name Systemcatalog id systemclass id paolo



class name Paolo Colettacatalog name Systemcatalog id systemclass id paolo


10.3.14 Simone Gambarotto

class name Simone Gambarottocatalog name Systemcatalog id systemclass id simone gambarotto

1259

Software Engineer Microsoft Certified Professional Microsoft Certified Solution Devel-oper Microsoft Certified Systems Administrator

10.3.15 Simone Ghisio

class name Simone Ghisiocatalog name Systemcatalog id systemclass id simone

[email protected]

10.4 Companies

10.4.1 InfomusLab

class name InfomusLabcatalog name Systemcatalog id systemclass id infomus


10.4.2 InfomusLab

class name InfomusLabcatalog name Systemcatalog id systemclass id infomus



class name NumenSoft s.n.c. di M. Peri & C.catalog name Systemcatalog id systemclass id numensoft


1260


class name NumenSoft s.n.c. di M. Peri & C.catalog name Systemcatalog id systemclass id numensoft


10.4.5 RCPStudio

class name RCPStudiocatalog name Systemcatalog id systemclass id rcpstudio

Studio associato Di Ingegneria. delgli ingegneri A.Ricci, P.Coletta e M.Peri InfomusLabPartner. Info: [email protected] http://www.rcpstudio.it

1261

Chapter 11

3D Catalog

11.1 Catalog overview

...TODO...Alessandro please add-here the manually-generated documentation.

11.2 Blocks

11.2.1 3DDisplay

bitmap

class name 3DDisplaycatalog name 3Dcatalog id 3Dclass id GlDisplayauthors Alessandro Fausto

This block display one tridimensional space (OpenGL library)

Inputs

Tridimensional spaceid InputSpacetype 3D, space3Dtype id 3D, 3D space



Tridimensional space to display

1262

Parameters

Camera typeid CameraTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:FreeLook atField Of View

domain [ 0, 3 )Type of camera ( ’Free’, ’Look at’, ’Field Of View’). The ’free’ camera have free move-

ment on the space. This camera is univocally defined through its position and rotationparameters. The ’Look at’ camera have a fixed point of view. This camera is univocallydefined through its position and target position parameters.The ’Fielf Of View’ camerahave free movement on the space. This camera is univocally defined through its positionand rotation parameters.

Point Of Viewid CameraPositiontype Base, Point 3D doubletype id base, point 3d double

Camera point of view (space coordinates system, floating point values)

Camera rotationid CameraRotationtype Base, Point 3D doubletype id base, point 3d double

Angular position of camera in degree (0-360 and multiples).

Projectionid ProjectionTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:OrthonormalPerspective

domain [ 0, 2 )Projection type (’Orthonormal’, ’Perspective’)

Image outputid parameter enable output imagetype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Each time this block repaint the tridimensional space one eyesweb Image datatype isgiven on output.The timings of image output is the same of tridimensional space repaint

1263

event and is controlled by the display refresh parameters.The output image use RGB colorspace with 8 bit unsigned integer values for each color components.

Grid/Axis onid axisGridtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable or disable the visualization of system grid and axis (X: red,Y: green, Z: bluelines) and grid lines (X: red,Y: green, Z: blue lines)

Grid scaleid GridScaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Adjust the grid scaling factor

Axis scaleid AxisScaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Adjust the axis scaling factor

Filterid filteringtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:”Point””Linear”

domain [ 0, 2 )Texture image filter used when the texture is scaled (’Point’, ’Linear’). Point mode

approximantes the pixel color with the color of nearest point, ’Linear’ mode does a linearinterpolation of neigthbour points color.

Canvas widthid CanvasWidthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Adjust the OpenGL canvas width.

Canvas heightid CanvasHeighttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

Adjust the OpenGL canvas height.

1264

left clipid ClipLefttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The left clipping plane delimit the the bounding region

right clipid ClipRighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

right clipping plane

bottom clipid ClipBottomtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

bottom clipping plane

top clipid ClipToptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

top clipping plane

znear clipid ClipNeartype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Near Z clipping plane

zfar clipid ClipFartype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Far Z clipping plane

1265

11.2.2 Light3DGenerator

bitmap

class name Light3DGeneratorcatalog name 3Dcatalog id 3Dclass id Light3DGeneratorauthors Alessandro Fausto

This block generate one light

Outputs

lightid OutputLighttype 3D, Light3Dtype id 3D, 3D lightinplace id *no*inherited id *no*

light

Parameters

enabledid Enabletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable or disable this light

Ambient colorid Ambienttype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Ambient color

colorid Diffusetype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Diffuse color

1266

Specular colorid Speculartype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Specular color

Light typeid Typetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:DirectionPositionalSpotlight

domain [ 0, 3 )Select the light type (Directional,Positional,Spotlight)

Light positionid Postype Base, Point 3D doubletype id base, point 3d double

light position

1267

11.2.3 Material3DGenerator

bitmap

class name Material3DGeneratorcatalog name 3Dcatalog id 3Dclass id Material3DGeneratorauthors Alessandro Fausto

This block generate one material

Outputs

materialid OutputMaterialtype 3D, Material3Dtype id 3D, 3D materialinplace id *no*inherited id *no*

material

1268

Parameters

Preloaded materialid PreloadedMaterialstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:CustomJadeObsidianPearlRubyEmeraldTurquoiseBlack RubberBlack PlasticBronzePolished BronzeChromeGoldPolished GoldCopperPolished CopperBrassSilverPolished SilverPewter

domain [ 0, 20 ]A combo to select from preloaded material type

Ambient colorid Ambienttype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Ambient color

colorid Diffusetype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Diffuse color

Specular colorid Speculartype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

1269

Specular color

Shininessid Shininesstype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The shininess of material

Emissive colorid Emissivetype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Emissive color

1270

11.2.4 Obj3DGenerator

bitmap

class name Obj3DGeneratorcatalog name 3Dcatalog id 3Dclass id Obj3DGeneratorauthors Alessandro Fausto

This block generate one bidimensional rectangle with constant Z axis coordinate. Ifpresent, the image input is used as texture. Is not required and is overriden by the ’texure’or ’texturemask’ parameter. The color space I420, YV12, HSV is not supported. Thealpha channel is not supported on BW, YUYV, UYVY color spaces. All input images withcolor space different from RGB or BGR are converted into RGB color space. If the graphicboard dont support the openGL BGRA and BGR extension, the BGR image is convertedto RGB. All pixel depth greater than 8 bit per channel is converted to 8 bit per channel.This conversions increase the CPU usage, please use RGB or BGR space with 8 bit perchannel pixel format. The geometric properties of this rectagle is the position of the centreof gravity, the rotation relative to the axis, the size of it sides. Other properties are thecolor of the rectangle, the intensity of the alpha ( transparency of the object), the name ofthe file to be used as texture, the name of the file to be used as texture mask, the textureorientation relative to the system axis, the number of surface subdivisions.

Inputs

imageid InputImagetype Base, Imagetype id base, imagerequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

This input pin accept an image and used it as texture. This input is not required andis ignored if the user enter a valid filename into the ’image’ or ’alpha mask parameters.Thecolor space I420, YV12, HSV is not supported. The alpha channel is not supported on BW,YUYV, UYVY color spaces. All input images with color space different from RGB or BGRare converted into RGB color space. If the graphic board dont support the openGL BGRAand BGR extension, the BGR image is converted to RGB. All pixel depth greater than 8bit per channel is converted to 8 bit per channel. This conversions increase the CPU usage,please use RGB or BGR space with 8 bit per channel pixel format.

1271

Outputs

objectid OutputObjecttype 3D, object3Dtype id 3D, 3D objectinplace id *no*inherited id *no*

This is the bidimensional rectangle. To display this rectangle you must add this outputpin to one of the input pin of ’SpaceAddObj’ and connect the output space to one openGLtridimensional display.

Parameters

Object positionid ObjPostype Base, Point 3D doubletype id base, point 3d double

Object position in the tridimensional space (space system coordinates - double)

Object rotationid ObjRottype Base, Point 3D doubletype id base, point 3d double

Object rotation over X, Y and Z axis (0-360 degree)

Rectangle sizeid ObjSizetype Base, Size 2D doubletype id base, size2d double

Rectangle size (space system coordinates - double)

Position typeid ObjPosTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:Baricenterleft-bottom vertexright-bottom vertexright-top vertexleft-top vertex

domain [ 0, 5 )Select what vertex is referenced through the object position

1272

colorid ObjColortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

Object color (RGB values). This is the color of the rectangle, if one or more light isadded to the object or to the system this color is modulated by the light intensities.

Alphaid ObjAlphatype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Object opacity (double - 0.0 to 1.0). If equal or above 1.0f you get a completely opaquesurface, if equal to 0.0 or below you get a completely transparent surface(), in the middleyou have semi-opaque (or semi-transparent) surface.

imageid ObjTexturetype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout

Filename,MustExist=true,SaveMode=false,OverwritePrompt=true,Filter=”Bitmap 24bit (*.BMP)—*.BMP——”

Image to be used as rectangle texture. This texture file override any existing inputimages and can be entered or changed at any time.The only supported format is Windowsbitmap with 24bit RGB colors. The texture is loaded into the memory and inserted intoa image cache, when the image is requested another time is loaded from the memory andnot from the hard disk. This trick speedup the execution time but any changes made, intothe runtime phase of Eyesweb, to the image file is not loaded into the rectangle texture.

alpha maskid ObjTextureMasktype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


Image to be used as rectangle alpha mask texture. Where the image pixel is white therectangle is considered transparent, where is black the rectangle is considered opaque andin the middle the rectangle is considered semi-opaque (or semi-transparent). This texturefile override any existing input images and can be entered or changed at any time.The onlysupported format is Windows bitmap with 24bit RGB colors. The texture is loaded into

1273

the memory and inserted into a image cache, when the image is requested another timeis loaded from the memory and not from the hard disk. This trick speedup the executiontime but any changes made, into the runtime phase of Eyesweb, to the image file is notloaded into the rectangle texture.

Flip textureid ObjTextureFliptype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:nonevertical (X axis)horizontal (Y axis)vertical & horizontal (both axis)

domain [ 0, 4 )Mirror the image texture over X, Y or both axis.

slicesid ObjSlicestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 100 ]

Number of rectangle subdivision done, for each side.The openGl library simulate thelight computing the color intensity on polygon vertices and interpolate this colors on theinterior of the poligon using the Gouraud algorithm (see this webpages for subdivision so-lution http://www.opengl.org/resources/faq/technical/lights.htm#ligh0010 and this web-pages http://www.falloutsoftware.com/tutorials/gl/gl8.htm for advanced information onopenGL lighting system). When using positional (as incandescent bulb) or spot light (as)in order to obtain realisting shades must have 10 or mode subdivision for each side, hav-ing a total of 100 vertices. Using this ’slices’ parameter the user can select the numberof subdivision (rectangle per side) of the original rectangle. Whit one slices you have theoriginal four vertices, whit N slices you have (N+1)ˆ2 vertices. When the light is directionor is not used at all the subdivision of the surface is not necessary, in this case use onesingle subdivision to limit the number of computation and vertex used to the minimumusefull number. When use a positional or spot light, as simple ’rule of nine’, lesser is thedistance between light and surface greater must be the number of slices used.This is dueto the fact that when the distance between the light and the surface decrease the gradientof the illumination intensity computed on the subdivided vertex grow and the linearizationbetween two vertex doesnt simulate the illumination intensity shades in the same mannera real light do.

1274

11.2.5 ObjAddLight

bitmap

class name ObjAddLightcatalog name 3Dcatalog id 3Dclass id ObjAddLightauthors Alessandro Fausto

This block add four lights to one tridimensional object

Inputs

tridimensional spaceid InputObjtype 3D, object3Dtype id 3D, 3D object



tridimensional space

light0id InputLight0type 3D, Light3Dtype id 3D, 3D lightrequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

tridimensional light


1275






Outputs

tridimensional spaceid OutputObjtype 3D, object3Dtype id 3D, 3D objectinplace id *no*inherited id *no*


Parameters

add lightid ParamEnabletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable or disable the adding of lights.

1276

11.2.6 ObjAddMaterial

bitmap

class name ObjAddMaterialcatalog name 3Dcatalog id 3Dclass id ObjAddMaterialauthors Alessandro Fausto

This block set the material properties of one object

Inputs

tridimensional objectid InputObjtype 3D, object3Dtype id 3D, 3D object



tridimensional object

Object materialid InputMaterialtype 3D, Material3Dtype id 3D, 3D materialrequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

Object material

Outputs

tridimensional objectid OutputObjtype 3D, object3Dtype id 3D, 3D objectinplace id *no*inherited id *no*


1277

Parameters

add materialid ParamEnabletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable or disable the material adding

1278


bitmap

class name Point3DGeneratorcatalog name 3Dcatalog id 3Dclass id Point3DGeneratorauthors Alessandro Fausto

This block generate one tridimensional coordinate

Outputs

Pointid Point3Dtype Base, Point 3D doubletype id base, point 3d doubleinplace id *no*inherited id *no*

Tridimensional coordinates

Parameters

Xid Xtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

X coordinate

Yid Ytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Y coordinate

Zid Ztype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Z coordinate

1279

11.2.8 SpaceAddLabelledSetDouble

bitmap

class name SpaceAddLabelledSetDoublecatalog name 3Dcatalog id 3Dclass id SpaceAddLabelledSetDoubleauthors Alessandro Fausto

Add a Geometric Labelled Set 3D Double to a space

Inputs

tridimensional spaceid InputSpacetype 3D, space3Dtype id 3D, 3D space




InputGeometricLabelledSet3Did input labeled set 3dtype Base, BaseGeometricLabelledSet3Doubletype id base, base geometric labelled set 3d double



Input Geometric Labelled Set 3d of 3d objects.

Outputs

tridimensional spaceid OutputSpacetype 3D, space3Dtype id 3D, 3D spaceinplace id *no*inherited id *no*

1280


Parameters

Point radiusid PointRadiustype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Adjusts the axis scaling factor

Detailid PointDivstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:low (fast)mediumhigh (slow)

domain [ 0, 3 )Adjusts the 3D points detail level. The higher the detail, the higher the computational

time.

1281

11.2.9 SpaceAddLabelledSetInt

bitmap

class name SpaceAddLabelledSetIntcatalog name 3Dcatalog id 3Dclass id SpaceAddLabelledSetInt

Add a Geometric Labelled Set 3D Int to a space

Inputs





InputGeometricLabelledSet3Did input labeled set 3dtype Base, BaseGeometricLabelledSet3DInttype id base, base geometric labelled set 3d int



Input Geometric Labelled Set 3d of 3d objects.

Outputs



1282

Parameters

Point radiusid PointRadiustype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Adjusts the axis scaling factor

Detailid PointDivstype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:low (fast)mediumhigh (slow)

domain [ 0, 3 )Adjusts the 3D points detail level. The higher the detail, the higher the computational

time.

1283

11.2.10 SpaceAddLight

bitmap

class name SpaceAddLightcatalog name 3Dcatalog id 3Dclass id SpaceAddLightauthors Alessandro Fausto

This block add one object to one tridimensional space

Inputs








1284






Outputs



Parameters

add lightid ParamEnabletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable or disable the light adding

1285

11.2.11 SpaceAddObjs

bitmap

class name SpaceAddObjscatalog name 3Dcatalog id 3Dclass id SpaceAddObjsauthors Alessandro Fausto

This block add one object to one tridimensional space

Inputs





object 0id InputObject0type 3D, object3Dtype id 3D, 3D objectrequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

tridimensional object

Outputs



1286

Parameters

add objectsid ParamEnabletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable or disable adding of objects

objectsid ParamEntriestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain [ 1, 100 ]

Number of objects

1287

11.2.12 SpaceGenerator

bitmap

class name SpaceGeneratorcatalog name 3Dcatalog id 3Dclass id SpaceGeneratorauthors Alessandro Fausto

This block generate one tridimensional space

Inputs

imageid InputBgImagetype Base, Imagetype id base, imagerequired noread only/read write read onlyreferred as inplace *no*referred as inherited *no*

image used as background texture

Outputs

Spaceid OutputSpacetype 3D, space3Dtype id 3D, 3D spaceinplace id *no*inherited id *no*

Tridimensional space identifier

Parameters

Axis scaleid AxisScaletype Base, Point 3D doubletype id base, point 3d double

A value less than 1.0 shrink the object ; A value grather than 1.0 enlarge the object ;A value equal to 1.0 leave unchanged the object ;

1288

Flip Xid AxisFlipXtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

flip x axis

Flip Yid AxisFlipYtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Flip y axis

Flip Zid AxisFlipZtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Flip z axis

background colorid BgColortype Kernel, RGBColor datatype (Kernel Catalog).type id kernel, rgbcolor

background color

background textureid BgBitmaptype Kernel, String datatype (Kernel Catalog).type id kernel, string

layout


Image used as static background

Flip textureid BgFliptype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:nonevertical (X axis)horizontal (Y axis)vertical & horizontal (both axis)

domain [ 0, 4 )

1289

Flip texture over X, Y or both axis

Background lightid BgLighttype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable or disable light effect on background texture

1290

11.2.13 glDraw

bitmap

class name glDrawcatalog name 3Dcatalog id 3Dclass id glDraw

This block draws a 3D space into an image.

Inputs

3D Spaceid Input3DSpacetype 3D, space3Dtype id 3D, 3D space



This is the 3D space to be drawn by the block.

Outputs

Output Imageid OutputImagetype Base, Imagetype id base, imageinplace id *no*inherited id *no*

This is the image resulting from the input 3D space drawing.

1291

Parameters

Camera typeid ParameterCameraTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:FreeLook atField Of View

domain [ 0, 3 )The ’free’ camera have free movement on the space. This camera is univocally defined

through its position and rotation parameters. The ’Look at’ camera have a fixed point ofview. This camera is univocally defined through its position and target position parameters.The ’Fielf Of View’ camera have free movement on the space. This camera is univocallydefined through its position and rotation parameters.

Projection typeid ParameterProjectionTypetype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layoutCombo Box:OrthonormalPerspective

domain [ 0, 2 )Orthonormal projection is a ”flat” projection, that is, the same objects at far and near

distance maintain the same size. Perspective projection ”scales” objects depending on theirdistance from the camera, providing an eye-like result.

Camera positionid ParameterCameraPostype Base, Point 3D doubletype id base, point 3d double

The position of the camera.

Camera rotationid ParameterCameraRottype Base, Point 3D doubletype id base, point 3d double

The rotation of the camera.

Enable axis and grid diplayid Axis/Grid enabletype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable (true) or disable (false) the axis and grid diplay (both at the same time).

1292

Grid scaleid GridScaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling factor for the grid display.

Axis scaleid AxisScaletype Kernel, Double datatype (Kernel Catalog).type id kernel, double

Scaling factor for the axis display.

Image Widthid ImageWidthtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

The width of the output image.

ImageHeightid ImageHeighttype Kernel, Int datatype (Kernel Catalog).type id kernel, int

ImageHeight

Clip leftid ClipLefttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The left clipping plane position.

Clip rightid ClipRighttype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The right clipping plane position.

Clip topid ClipToptype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The top clipping plane position.

1293

Clip bottomid ClipBottomtype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The bottom clipping plane position.

ZNearid ZNeartype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The Near clipping plane position, must be positive, different from zero.

ZFarid ZFartype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The ZFar clipping plane position, must be positive, different from zero.

1294

11.3 Datatypes

11.3.1 Light3D

class name Light3Dcatalog name 3Dcatalog id 3Dclass id 3D light

Stores information on light

11.3.2 Material3D

class name Material3Dcatalog name 3Dcatalog id 3Dclass id 3D material

Stores information on material

11.3.3 object3D

class name object3Dcatalog name 3Dcatalog id 3Dclass id 3D object

Tridimensional object

11.3.4 space3D

class name space3Dcatalog name 3Dcatalog id 3Dclass id 3D space

Tridimensional space

1295

11.4 Authors


class name Alessandro Faustocatalog name 3Dcatalog id 3Dclass id fareale

descr

11.5 Companies

1296

Chapter 12

National Instruments Catalog

12.1 Catalog overview

This catalog EyesWeb XMIadds support for some National Instruments devices.

12.2 Blocks

12.2.1 NI USB-6210

bitmap

class name NI USB-6210catalog name National Instrumentscatalog id NationalInstrumentsclass id USB6210authors Alberto Massari

Acquires data from the NI USB-6210 device

Outputs

Output dataid output datatype Base, TemporalDatatype id base, temporal datainplace id *no*inherited id *no*

The acquired data

1297

Parameters

Terminal Configurationid Terminal Configurationtype Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:DiffRSENRSE

domain [ 0, 3 )Defines how the sensor are attached: Diff = the sensor is connected with two wires,

connected to AIx and AIx+8 (e.g. AI0 is the positive wire, AI8 is the negative) RSE = thesensor is connected with one wire, and its value is relative to the AI GND input NRSE =the sensor is connected with one wire, and its value is relative to the AI SENSE input

Number of channelsid Number of channelstype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( 0, +infinity )

The number of channels to be acquired

Sample Frequencyid Sample Frequencytype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The sampling frequency

Number of samplesid Number of samplestype Kernel, Int datatype (Kernel Catalog).type id kernel, intdomain ( 0, +infinity )

The number of samples contained in each output datatype

Min Rangeid min rangetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

The minimum voltage of the sensor (in Volt)

Max Rangeid max rangetype Kernel, Double datatype (Kernel Catalog).type id kernel, double

1298

The maximum voltage of the sensor (in Volt)

ChannelPort 1id ChannelPort 1type Kernel, Int datatype (Kernel Catalog).type id kernel, int

layout

Combo Box:AI-0AI-1AI-2AI-3AI-4AI-5AI-6AI-7

domain [ 0, 8 )The physical port that will be mapped to this output

1299

12.3 Authors


class name Alberto Massaricatalog name National Instrumentscatalog id NationalInstrumentsclass id NationalInstruments author

12.4 Companies

12.4.1 Infomus

class name Infomuscatalog name National Instrumentscatalog id NationalInstrumentsclass id NationalInstruments company

1300

Chapter 13

Epix Catalog

13.1 Epix configuration

The Epix catalog adds support for the Epix framegrabbers. After having installed thehardware referring to the documentation provided with the board, you should prepare aconfiguration before being able to use the device in EyesWeb. The configuration file canbe created with the XCAP software.Multiple devices on the same computer are supported:the following instructions cover the case of two Epix framgrabbers.

• Start the XCAP software.

• Choose Open/Close from menu PIXCI. You should see the following:

• Click on the ”Multiple devices” button. If the button is disabled, click on the Closebutton first. The following dialog should appear:

1301

http://www.epixinc.com

• Choose the device you want to configure for later use in EyesWeb, then click the Okbutton. You should now be back to the Open/Close dialog.

• Push the ”Camera & Format” button and, for each tab, choose the type of cameraconnected to the corresponding device:

• Click OK to go back to the Open/Close dialog, then, click Open to tune the settings ofeach camera. For each camera, the software will show a window containing a snapshot

1302

of the grabbed image, and a dialog to tune the camera specific settings:

• The following sample pictures refer to the configuration of two Hitachi CameraLinkcameras, a Hitachi-KP-F120-CL and a Hitachi-HV-F31-CL-S3; however, you shouldrefer to the XCAP documentation for more details about the available settings.

• Once the available cameras are completely tuned, you can export the configuration to

1303

a file which will be later used by EyesWeb. Choose the Export item from the PIXCImenu; the follwing dialog should appear:

• In the case of CameraLink cameras, be sure that ”Include CameraLink Serial com-mands” is selected. The file must be exported with name epix configuration.fmt, andmust be placed in the EyesWeb folder (i.e., the folder where the EywGUI.exe pro-gram is located). Once exported the file, you can close the XCAP software and runEyesWeb.

• To verify that the Epix devices are now available in EyesWeb, choose Options fromthe Tools menu. In the Device Mapping section, you should see have a section named”Epix inc”. In the case of multiple device, you may want to assign names to eachdevice in order to be able to select them when you instantiate a block:

13.2 Blocks

13.2.1 Epix Frame Grabber

bitmap

class name Epix Frame Grabbercatalog name Epixcatalog id epixclass id framegrabberauthors Massimiliano Peri

1304

Acquire images from a device connected to an Epix frame grabber board

Outputs

Acquired imageid output video streamtype Base, Imagetype id base, imageinplace id *no*inherited id *no*

Acquired image from a device connected to the Epix frame grabber

Parameters

Deviceid deviceidtype Kernel, String datatype (Kernel Catalog).type id kernel, string

Epix device virtual name

RGBid rgbtype Kernel, Bool datatype (Kernel Catalog).type id kernel, bool

Enable color capture

1305

Part IV

Appendices

1306

Appendix A

Release notes

1307

Appendix B

Release notes

The most up-to-date version of EyesWeb XMI is EyesWeb XMI 5.3.0. The last stableversion is EyesWeb XMI 5.3.0.

B.1 Notes on EyesWeb XMI 5.3.0

Released on December 10, 2011

• Kernel: optimized scheduling algorithm


Released on June 10, 2011

• Kernel catalog: implemented serialization for the List datatype

• Kinect catalog: added experimental support for the Microsoft Kinect device (basedon the OpenNI sdk).

• Gui: the device configuration tab (kernel options) is now more robust with respect tobroken device enumerators.

• Base catalog: added CannyEdgeDetector block

• Base catalog: added a Reset parameter to the SlopeLimiter block;, to reset the outputvalue to the initial value

• Base catalog: the PcmAudioMixer block can now export the internal mixing matrix(useful when using the Smoothing parameters)

• Base catalog: improved CameraCorrection block

• Base catalog: added block ListPersistency, which removs items from a list if they arenot persistent

1308

• Base catalog: added block MultipleListsRemoveDuplicates, which removes duplicatesfrom multiple lists

• Base catalog: added parameters to the PFinder background subtraction algorithm tocontrol how to update the background model of pixels corrisponding to foreground

• Base catalog: FFT block can now use different windowing functions, not only Black-man

• Base catalog: the GetMouse block can now procide normalized floating-point coordi-nates as output

• Base catalog: added the LocalBinaryPattern background subtraction algorithm

• Base catalog: added a block to compute the HammingDistance (number of differentbits) between images

• Base catalog: added a block (selectIntervals) which looks for the input timecode in agiven list of temporal intervals and return the index of the interval

• Base catalog: the AiffReader block can now (optionally) generate silence if the filedoes not exist or is wrong.

• Base catalog: the LoadMarkers block now gives full information (begin and end)aboutthe loaded intervals (before this change, only the interval start time was read fromfile).

• Base catalog: added support for 64bits integer to the OSC input block.

• Base and System catalog: added a device (System catalog) and a block (Base Catalog)to control VTR devices (e.g., Firewire tape cameras)

• System catalog: added WaveInput and WaveOutput blocks (and devices) to acquireand playback audio based on the Windows multimedia sdk (waveIn and waveOutfunctions)

• System catalog: added a block to send data through network to a Psyclone server

• System catalog: the StringDisplay block can now be configured (number of columnsand rows, alignment, etc)

• Sdk: added functions to get characteristics of a given PCM format (e.g., bits persample, signed/unsigned, etc.)

• Bugfixes

1309


Released on December 10, 2010

• Added the SARC catalog, developed and mantained by Queen’s University of Belfast.The catalog comes with many example patches available in the Patches/Sarc folder

• Switched to Microsoft Visual Studio 2008 (compiler VC 9.0).

• EyesWeb Mobile and MetaEyesWeb: compatibility betweeb 64 bits client and 32 bitsserver

• Kernel catalog - added Vector block, a generic vector-based datatype container

• Kernel catalog – added a block to perform For iterations inside an EyesWeb subpatch

• Kernel catalog – added a reset parameter to the Delay block

• Base catalog – added a block implementing the PFinder background subtraction al-gorithm

• Base catalog – the SelectMultipleTrackedBlobs now has more option to sort the blobs(area, bounding-rect width, bounding-rect height anda distance from a given point)

• Base catalog – added blocks for Audio sinusoidal analysis (implemented by CarloDrioli)

• Base catalog – added block to perform PixelWise comparison between images

• Base catalog – added a MP3 file reader in the BaseAudio catalog that uses the IntelUMC library (it’s also available on Linux)

• Base catalog – added GeometricLabelledSetInt to GraphicLabelledSetInt converter

• Base catalog – replaced the keepAspectRatio boolean floag of some blocks with aletterBoxMode enumerator to be able to decide where to place the image in the casethat the aspect ratio is preserved and black mattes are added

• Base catalog – added an option to the OpticalFlow block to compute optical flowbetween two images in input; also changed implementation to limit the computationto the current Roi

• Base catalog – added FileOperation block, which performs operations onfiles (e.g.,Move, Copy, Delete, etc.)

• Base catalog – added LabelledSetMerge block, to merge two or more labelled sets

• Base catalog – added ExtractColorBlobs block, to track blobs basing on colors (HSV)

• Base catalog – added a block to add an item to a labelled set

1310

• Base catalog – modified block ComposeAudioChannels to work on static timeseriesinstead of audio

• Base catalog – added an Option to the CentroidsCalc block to compute only thehalf centroids with respect to a vertical axis, also added an option to insert into thelabelled set even centroids that are computed but not explicitely required by the user

• Base catalog – added HaarCascade block (with respect to the existing FaceDetectionblock, it provides a list of detected objects as output, instead of drawing them on theimage)

• Base catalog – added block ResizeRoi, shrink or enlarge the input roi

• System catalog – added frame up and frame down buttons to the VideoFileReader

• System catalog – added current frame time output to the VideoFileReader

• GpGPU catalog – added block DrawText, to draw text on images using FreeType

• GpGPU catalog – added pipelined mode to cuda host to device. Using pipelinedmode causes a delay of a fixed number of frames, but improves performance

• Sdk – added interface IPixelwiseComparisonOp, which compare images pixel-by-pixel

• Sdk – added interface ITranspose, which transposes an image (input size: w × h ,output size: h× w)

• Sdk – added interface IDrawtext, to draw text over an image (currently supportedonly by the CudaImage datatype)

• Sdk – added interfaces IShape2DInt and IShape2DDouble, to query an image forBaricenter, Area, and BoundingRect

• Sdk – added functions to simplify serialization of datatypes to std::strings

• Sdk – added functions to check init info equality

• Sdk – added functions to declare a font selector parameter pin

• Sdk – added code to implement the Savitzky Golay filter

• Removed the EyesWeb Control Panel (as it is now available inside the GUI options)

• Bugfixes

EyesWeb depends on some external libraries/compilers, which are updated to the fol-lowing versions:

• Boost 1.43.0 (also tested against boost 1.44.0)

• OpenCV 2.0

• Intel Integrated Performance Primitives (IPP) library version 6.1 update 2

1311

• NVIDIA CG Toolkit 2.1

• NVIDIA CUDA Toolkit 2.3

• Intel C++ Compiler Professional Edition version 11.1 update 3

• Microsoft Windows Media SDK 9.5

• Microsoft Platform SDK for Windows Server 2008 and .NET Framework 3.5

• Microsoft DirectX SDK November 2008

• FreeImage 3.13.0

• Microsoft Visual C++ Compiler 9.0.50727.867

• InnoSetup 5.3.6

• Doxygen 1.5.8

• Xerces 3.1

• GCC 4.x (for linux builds)


Released on February 8, 2010

• GPGPU catalog preview

• MetaEyw-Scripting support preview

• Linux version preview

• Changed version numbers schema to major.minor.release. Different release numberswith the same major and minor are binary compatible. Different minor numberswithin the same major number are source compatible (i.e., your blocks can be rebuiltwithout changes to the source code) but not binary compatible. Different majornumber might require source code changes.

• Based on FreeImage Library to read/write images

• Kernel - Added a kernel option (RemoveDuplicates) to disable setting duplicate pa-rameters (warning: setting this option to true may change behaviour of existingpatches)

• Kernel - Added support for Catalog properties (see, e.g., here for a brief description)

• Kernel - Added support for Quota when logging to a given folder (see, e.g., here fora brief description)

1312

http://bugzilla.eyesweb.org/cgi-bin/bugzilla/show_bug.cgi?id=43#c2

http://bugzilla.eyesweb.org/cgi-bin/bugzilla/show_bug.cgi?id=227

• Kernel - improved subpatches usability: input and parameter pins can now be con-nected to more than one pin inside the subpatch. Also implemented this enhancement,which means that subpatch input pins can be used as a sync source inside the sub-patch.

• GUI - added support for parameters of type DatatypeSelector, which let the userselect a specific datatype instance.

• Kernel Catalog - added the NULL flag to ROI to be able to distinguish between anempty ROI (the operation does not affect the image) and a NULL ROI (the ROIis not present, hence, the whole image is affected by the operation). Added blockSetNullRoi to change this flag, and block IsNullRoi to read this flag.

• Kernel Catalog - added a Reset parameter to the Snapshot block

• Base catalog - Added block BoundRoiInRoi, which ensures that the input Roi is insidethe Roi provided as a parameter

• Base catalog - Added block MoveAroundPoint, which provides as output a pointwhich is at a given distance from the input point, and minimize distances from agiven list of points

• Base catalog - Added block LoadMarkers, which loads audio markers from a text file.The file can be generated with third party SW, e.g., Audacity

• Base catalog - Added block Point2DDoubleToPoint2Dint, which converts the pointcoordinates from normalized floating-point to absolute integer

• Base catalog - Added parameter to Generic.FileWriter block to automatically stopthe writer when patch execution is stopped

• Base catalog - added Jump parameter to the SlopeGenerator block

• Base catalog - added block FPS which computes the FramesPerSecond of an incomingstream of data

• Base catalog - added block MoveAroundPoint to compute the position of a ROI nearto a point but not overlapping it

• Base catalog - added block PointInRoiList and PointInLabelledRoiList, to verifywhether a point is inside a give list of rectangles. The Labelled version can binda label to each rectangle

• Base catalog - improved block ReadImage to support caching of images, extractionof a subset of the image, cueing the next image to be read

• Base catalog - the DynamicToStaticPCMAudioBuffer block now works with severalvariants of PCM datatypes.

• Base catalog - added ROI support to the ReadImage block (i.e., you can read a specificpart of the image)

1313


• Base catalog - added block Quantizer

• Base catalog - added block BlobHistogram which computes the histogram of a blobalong horizontal or vertical direction

• Base catalog - ListRemoveIf can now filter blobs in a list even basing on their layinginside a given rect

• Base catalog - Merged the hasAlpha tag with the color model tag for the Imagedatatypes. Consequently, many blocks dealing with images have lost the hasAlphaparameter, and the color model combos have more options (see here)

• Base catalog - added support for two more algorithms (Lukas Kanade and BlockMathcing) to the OpticalFlow block

• Base catalog - added ImageTranspose block (swap horizontal and vertical dimensionsof an image)

• Steinberg catalog - The ASIO output block now uses silence at the and of the audiodata (first, the last buffer was repeated)

• Steinberg catalog - The Asio output and ASIO input blocks notify ASIO Deviceinitialization errors on the message console

• System catalog - Added block Multimedia Timer, which acts as a periodic banggenerator, and uses the Windows Multimedia Timer

• System catalog - The DirectSoundOutput and DirectSoundInput blocks notify DSoundDevice initialization errors on the message console

• System catalog - The FrameGrabber block now let the user manually tune Gain, Ex-posure, etc at the driver level (note: some drivers do not support overriding Automaticsettings)

• OSC - added support for bundles

• SDK - added a new block activation mode (OnPredicate)

• SDK - merged the Image hasAlpha flag with the colorModel flag (see, e.g., here for abrief description); modified many blocks to reflect such change.

• EyesWeb Mobile - added server support for batch notifications and for atomic setpa-rameter operations (all set parameters executed within the same execution step)

• Bugfixes

EyesWeb depends on some external libraries/compilers, which are updated to the fol-lowing versions:

• Boost 1.36.0 (also tested against boost 1.41.0)

• OpenCV 2.0

1314



• Intel Integrated Performance Primitives (IPP) library version 6.1 update 2

• NVIDIA CG Toolkit 2.2

• NVIDIA CUDA Toolkit 2.2

• Intel C++ Compiler Professional Edition version 11.1 update 3

• Microsoft Windows Media SDK 9.5

• Microsoft Platform SDK for Windows Server 2008 and .NET Framework 3.5

• Microsoft DirectX SDK August 2009

• FreeImage 3.13.0

• Microsoft Visual C++ Compiler 8.0.50727.867

• InnoSetup 5.3.6

• Doxygen 1.6.1

• Xerces 3.1

• GCC 4.x (for linux builds)

B.5 Notes on EyesWeb XMI 5.0.3.0

This release includes bugfixes and new blocks. It is compiled with the Intel C++ compiler,in order to improve performance (warning, SSE2 support is required). The server code tosupport the EyesWeb Mobile client application has been merged in the deployed version ofthe kernel (first it was released as a separate kernel dll).

Released on July 13, 2009.

• EyesWeb Mobile - Added the EyesWeb Mobile application to the EyesWeb package

• Kernel - Adds support for EyesWeb Mobile; eywconsole –help shows the option avail-able to run EyesWeb as a server

• Kernel - Added a flag to Kernel::Init so that RegisterModule can avoid starting theRCF server (and force the firewall to ask whether it should be blocked)

• Kernel - Performance optimizations when executing subpatches

• Deployment

– The deployed version is compiled with the Intel C++ compiler

– The distributed SDK is still compiled with the Visual C++ compiler

– Added batch files to register/unregister dlls in debug and release mode

• Base catalog - Added ExtractMidiTimecode block

1315

• Base catalog - Blob2D datatype now requires initinfo to specify the size of the sourceimage

• Base catalog - CentroidCalc block can now work on half silhouette (lower or upperpart of the whole body)

• Base catalog - Added FaceDetection block developed by Matei Mancas

• Base catalog - Added CircularHough transform block

• Base catalog - Datatype deriving from ITimeSeries now share a common interfaceevent for initialization data. In this way block operation on TimeSeries can be moregeneric (do not need to enumerate known datatypes)

• Base catalog - Matrix2TimeSeries: added an option to avoid data clipping (by defaultdata is not clipped, except for old patches)

• Base catalog - TimeSeries.StatisticalOperations: a copy is now avoided unless it isreally necessary (MaxAbs cannot be performed as a single IPP operation)

• Base catalog - PCM Audio Mixer has now an option for smoothed operations

• Base catalog - Blob2D serialization now uses RLE-encoding

• Base catalog - Add support for sending/receiving multiple data items in an OSCmessage

• Base catalog - Added block MatrixSum, which sums rows or columns of a matrix

• Kernel catalog - changed conversion from time to double, now the outcoming doublerepresents the time in seconds (first it was in 100ns). The conversion now has the samebehaviour as the double to time conversion (where double values were interpreted asseconds)

• Steinberg catalog - The blocks VSTHost has been extended to accept all supportedformat of PCM datatypes

• Steinberg catalog - The blocks VSTHost now has a communication channel with theVST plugin though which the plugin can add non-numeric parameters and non-audiooutputs

• System catalog - GetFromVideoServer: the KeepAspectRatio parameter can be changedeven at design time

• Documentation - Added 3D and NationalInstruments catalog to the documentation

• Bugfixes

1316


This release mainly includes bugfixes and new blocks.Released on February 13, 2009.

• Base catalog - Added DFlipFlop block which behaves like a D-type flip-flop withgeneric input, startup value, reset and three different type of clock event (rise, fall ortrigger) modes

• Base catalog - Added block CentroidsToLine which transforms the points (baricenters)extracted from the CentroidCalc block to a set of segments, in order to provide a bettervisual representation of the centroids

• Base catalog - Added parameters to the CentroidsCalc block to specify whether toalpha-filter the computed points, and to tune such filtering

• Base catalog - enhancements to the PeakDetector block:

– Added continuos signal parameter to analyze or ignore the last sample ofprevious time series

– added threshold mode parameter to select whether the threshold has to becompared with the sample values or with their absolute values

– added compare parameter to validate peaks only when they are above or belowa given threshold

• Base Catalog - The AudioSave block now also supports the 8 bits (unsigned) format

• Base Catalog - Added StringToInt block, to convert a String datatype to an Integerdatatype

• Base Catalog - Added blocks TimeSeresReader and TimeSeriesWriter, which read andwrite timeseries to file. The file is compatible with other software (e.g., Audacity)

• Base Catalog - Added a tracker based on proximity measures (square distance orcorrelation)

• Kernel - Improved logging (added logs when a patch is loaded, initialized, checked,started, stopped, uninitialized); also improved log info in the case of blocks withouta label (not added to a patch yet, i.e., during patch loading): the classname is usedinstead of the label

• IDE - The revision number is now shown in the about box

• Setup - The Xvid coded is distributed with EyesWeb, in order to reduce the size ofthe redistributed media files

• IDE - Changed the profilinginfo dialog such that the mean execution time is shownnear the block name, and the item are sorted by descending execution time

• IDE - Added a command to export the profiling data to a text file

1317


This release mainly includes bugfixes and new blocks.Released on October 14, 2008.

• Base catalog - added block CentroidsCalc, which heuristically computes the positionof some human-related body parts

• Base catalog - added block ExtractBlobFromList, which extract a blob out of anunordered list accordin to a given criteria (biggest one, smallest one, nearest to agiven point, etc.)

• Base catalog - added blocks to work on GeometricLabelesSets (i.e., collection of geo-metric opbjects such as points, rectabngles, etc). The added blocks are:

– FilterGeometricLabeledSet - removes from the labeled set all items which are oftypes different from the user-selected one

– LabeldSetfeatures - compute some features on the items of the labelled set (i.e.,mean velocity, direction, etc)

• Base catalog - added block LucasKanade (automatically select the some points to betracked and track thems. Eventually reset the list of points to be tracked if some havebeen lost). There is also an alternative implementation of the block which separatesthe selection of the points from the tracking algorithm.

• Kernel - improved logging to file. Also added an option for each block in order totune how much info to log for that block.

• Freeframe catalog - added native support for freeframe plugins version 1.0

• Base catalog - Added ImageMorphingOperator, which perform morphological opera-tions (e.g., erode, dilate, open, close) on images. The implementation of this blockis based on the IPP libraries. An alternative implementation, which is based on theOpenCV libraries is available too

• Base catalog - Added ImageMorphingOperatorOpenCV, which perform morphologicaloperations (e.g., erode, dilate, open, close, etc) on images. The implementation ofthis block is based on the OpenCV libraries. An alternative implementation, whichis based on IPP libraries is available too (more performing but less flexible)

• Base catalog - Added support for the Freescale ZStar triaxial accelerometer board(RD3152MMA7260Q)

• Base catalog - Added/reenginered many of the blocks drawing graphs:

– Scalar Graph ValueVsSample: graph of scalar values; uses the sample index forthe abscissas

– Scalar Graph ValueVsTime: graph of scalar values; uses the time value (presen-tation time) for the abscissas

1318

– Scalar Graph ValueVsValue: graph of scalar values; uses the one the values forthe abscissas

– Matrix Graph ValueVsSample: graph of matrices; uses the item index (columnor row of the matrix) for the abscissas

– Scalar Graph ValueVsValue: graph of matrices; uses the one the rows (or columns)for the abscissas

All the graphs are available both as displays (i.e., they have thier own display window),or as overlay (i.e., the draw over an image datatype).

• Base catalog - Added option to the SetReset block to handle the case of both inputsbeing true

• Base catalog - Extended EywQuery tool to generate the documentation for datatypeconverters and datatype interfaces

• Base catalog - added block MatrixConcatenate, which let on build matrices by placingtwo (or more) matrices side by side (horizontally or vertically)

• Base catalog - added block ImageConcatenate, which let on build images by placingtwo (or more) images side by side (horizontally or vertically)

• Base catalog - added ImageSetAlpha block, which set the alpha channel of an Image

• Base catalog - added MoveRect block, which moves a part of an Image (specified bymeans of a SetROI block) inside the image itself

• Kernel catalog - added functionalities to support system-wide keyboad press

• National Instruments catalog - added this new catalog to support NI acquisitionboards. It currently supports the USB6210 device.

• Base catalog - added block to extract rotation info from an Ellipse datatype

• Base catalog - added some working modes to the PictureInPicture block (mask pro-vided as input, global mask provided as a scalar number)

• Base catalog - added block SpectralEnvelopeExtractor (find exact frequencies of ar-monics of a signal)

• Base catalog - added block ModPhase (converts FFT from Rael-Imaginary represen-tation to Modulo-Phase representation)

• Base catalog - added block SpectrumAnalyzer (computes the energy in the specifiedbands)

• Base catalog - added block Videogram which computes the visualizations describedin Jensenius, A. R. (2006). Using motiongrams in the study of musical gestures. InProceedings of the 2006 International Computer Music Conference, 6-11 November,New Orleans.

1319

• Kernel catalog - added the ’WeightedSum’ block, which computes a weighted sum ofinput datatypes

• System catalog - optimization for drawing small cells in the matrix display block.

• System catalog - added support for SDIHD inputs of DeckLink framegrabbers

• Steinberg catalog - added some options to the ASIO device (and related blocks) tochoose the buffersize and to specify some bounds for the internal queues (prefer to berealtime rather than not loosing any data).

• Base catalog - added GetPixel block to extract info about a single pixel of an image.

• Base catalog - added converters from Geometric to Graphic labelled sets (it is nowpossible to draw the output of LKTracker and other blocks)

• Base catalog - counter block: added a working mode (active by default) to avoid thethe need for a bang to start counting.

• Base catalog - time series generator: the block can now generate both fixed-size andvariable-size time series.

• Added support for Epix frame grabbers.

• Base catalog - BCDistorsion: added better heuristics to compute threasholds in au-tomatic mode; also added some improvements when having dark foreground objectsagainst a light background.

• SDK: added some descriptors to the signature of EyesWeb objects, besides the nameand description fields which were currently available. The new descriptors are:

– details: containes a more dtailed description of the block

– notes: contain info which does not fit other fields

• Kernel: returning false from the Execute method is now allowed and is considered anerror to be logged. It does not cause rescheduling as it happended in older versions.

• SDK: the sdk now catches all unhandle exceptions of type std::exception derived orEyw::IException-derived and logs them

• Breaking changes in the SDK since 5.0.1.x: your blocks need to be rebuild againstthe new sdk


This release mainly includes bugfixes and new blocks.Released on April 15, 2008.

• Base and System Catalogs: improved management of display blocks (lower cpu usage)

1320

• Base Catalog: added blocks SetStrokeProperties and SetFillProperties to change thegraphical appearance of geometric objects

• Kernel Catalog: improved MatrixFromFile block to support other separators besideswhite space

• Base catalog: fixed an issue with eywconsolercf when the base folder for patches wasspecified as a relative path

• Base catalog: added an option to ReadFile block to delete the .bak files when con-verting an old format to a new one

• Base catalog: changed the IBlob2D datatype to support the IDrawing interface. Inpractice, this means that you can draw a blob with the generic DrawGraphicObjectblock. This is a breaking change for blocks using the IBlob2D datatype; recompilingthem against the new sdk is needed.

• Base catalog: added block ExtractSingleBlob, to simplify blob extraction in controlledenvironments.

• Base catalog: improved DrawGraphicObject to support RGB and RGBA color for-mats (besides the already supported BGR, BGRA, and BW formats)


This release mainly includes bugfixes and new blocks. For internal testing only, not officiallyreleased.

• Documentation: added auto-generated documentation for many blocks

• Kernel: added notification of implicit converters usage even in the case of links toparameters

• Base Catalog: changed block ReadImagesFromFolder (System catalog) to block Read-Image with a simplified signature. Patches using this block need to be updated; inmany cases the block GetIndexedPath has to be put before the ReadImagesFrom-Folder block

• Base catalog: added block to read AIFF files (AIFFReader) and a block to extractmarkings and other info from an AIFF file (AIFFInfo).

• Base catalog: added block GetIndexedPath, to extract a file (specified by an index)from a folder.

• Base catalog: added datatype PCMAudioBuffer (only 16 bits PCM is implemented)

• Base catalog: added block PCMComposeChannels to compose the channels of PCMaudio buffers

• Base catalog: added block PCMMixer to mix the channels of a PCM audio buffer

1321

• System catalog: AudioDisplayGDI can be now docked and has the fatures commonto most EyesWeb displays

• Base catalog: FFTDisplay can be now docked and has the fatures common to mostEyesWeb displays

• Base catalog: added block Size2DGenerator

• GUI: added description of selected treeview item

• Base catalog: added some predefined FOURCC to the AviWriter block (simplifiesselecting the codec) and added the possibility to change the filename at runtime

• Kernel Catalog: added a working mode to the threshold block to use a single thresholdvalue instead of two


Released on March 3, 2008.

• Documentation: improved documentation for many blocks

• Base catalog: added block for selection of tracked blobs

• System catalog: improved DirectSound input block by adding the possibility to specifythe buffer size in number of samples

• Base catalog: improved RebufferAudio block by adding the possibility to specify thebuffer size in number of samples

1322

Appendix C

Bugfixes

C.1 EyesWeb 5.2.1

• Fixed bug in MovingArithOpImpl. Reset with a window length greater than 0 didnot work correctly

• Fixed bug in Image datatype: compressed formats (4:2:2) were not handled correctly

• Fixed bug in ImageDisplay: subsampled formats (e.g. YUYV) were not correctlyvisualized

• Fixed bug in Cuda Image datatype: the Cuda thread was not joined when closingEyw. This could cause a crash when quitting Eyw

C.2 EyesWeb 5.2.0

• Fixed bug in BaseMath: the ReadMatrixFromFile blocks fail to load matrix when therow lenght of text file is bigger than 4098 bytes

• Fixed bug in AudioFileReader and VideoFileReader: the synchronization mode wasnot initialized

• Fixed bug in Network Send and Receive block with UDP v. 2.0 protocol: could blockon exit

• Fixel bug in LabelledSetExtract: if extracting elements by index and if index is notfound, then the output timestamp should not be updated

• Fixed bug in EywRegisterModule: crash if the folder is read-only (e.g., when runningon Windows 7 and the catalog is in the Program Files folder)

• Fixed bug in TitleMachine block: with some color formats the text appeared twisted

• Fixed bug in FaceDetection block (see forum post. Some parameter values causedthe underlying OpenCV libraries to crash

• Fixed bug in Rectangle2DGenerator: might crash when selection Int mode

1323

http://forum.eyesweb.org/viewtopic.php?f=24&t=581

• Fixed bug in AIFF Reader: crashes if the index value is greater than the end of thefile

• Fixed bug kernel (RCF server): crash when stopping a patch via MetaEyesWeb

• Fixed bug #295: input selector block causes the patch to slow down

• Fixed bug in VideoFileReader: could crash due to trying to extract an image froman empty list

• Fixed bug in CentroidsCalc: could crash in the case of empty sub-regions

• Fixed bug #233: reducing number of input in blocks with variable number of inputsmight crash EyesWeb

C.3 EyesWeb 5.1.0

• Fixed bug #214: Loops involving syncin pins were not correctly managed

• Fixed bug #191: The clear button of the DynamicToStaticPCMBuffer did not work

• Fixed bug #217: Rotation parameter of Obj3DGenerator block was not preservedwhen a patch is opened

• Fixed bug #188: ExtractSubstring may crash Eyw when setting the last character toa value greater than the length of the string

• Fixed bug #205: Multiple selection may crash Eyw

• Fixed bug #262: Full Screen Monitor Index was not saved

• Fixed bug #241: EyesWeb crashes when MetaEyw is running while EyesWeb is startedor stopped

• Fixed bug #252: Display blocks do not work in console mode

• Fixed bug #211: TitleMachine block does not work with 24 bits images

• Fixed bug #191: The clear button of the DynamicToStaticPCMBuffer block does notwork

• Fixed bug #187: An empty company name causes the catalog not to be registered

• Fixed bug #190: AIFFReader ignore the last marker

• Fixed bug #189: Periodic blocks inside subpatches were not activated

• Fixed bug #185: Strange behaviour of subpatch outputs

• Fixed bug #20: Editing a subpatch could crash EyesWeb

• Fixed bug #140: EyesWeb crashed when Bang block activated

1324



















• Fixed bug #50: Closing Click Display External Window Crashes Eyesweb

• Fixed bug #111: TimeDelay block introduces crash on execution stop

• Fixed bug #177: All blocks in math.matrix.graph - crash when pressing reset in prop-erties

• Fixed bug #173: Scalar display not working for greater than 1 input

• Fixed bug: Ellipse2DGenerator provided axes with integer range even in the case ofdouble coordinates (which were expected to be normalized)

• Fixed bug: the device identifier of the Mixer (audio) devices was not guaranteed tobe unique (at least under Windows 7)

• Fixed a memory leaks related to inserting items into collections (labeled set or list):The Insert method returns an iterator which must be deallocated (or assigned to asmart pointer), otherwise it will be leaked

• Fixed bug in the RCF communication mechanism: The queue of the publisher thread(used to implement the callback mechanism) could grow undefinitely

• Fixed bug in EywRegisterModule: Don’t allow EyesWeb-specific exceptions to reachthe main function, as at that point the kernel has already been unloaded and theexception has been deleted

• Fixed bug in EywRegisterModule: On multiprocessor systems, several builds can endat the same time, resulting in EywRegisterModule being called to register N catalogs;this can lead to corruption of the catalog file, or simply crashes because opening thefile fails

• Fixed bug in EywQuery: Don’t allow EyesWeb-specific exceptions to reach the mainfunction, as at that point the kernel has already been unloaded and the exception hasbeen deleted

• Fixed bug: when installing as a service and specifying the server port, the command-line value was lost

• AIFFReader could crash when the chunck size was odd.

• GUI - EyesWeb could crash when saving Advanced Kernel Properties due to confusionamong double and float properties

C.4 EyesWeb 5.0.3.0

• Fixed bug #179: movingArithOp behaves incorrectly when reset

• Fixed bug #147: incorrect summed value in Operations.Moving Arithmetic

1325







• Base Catalog - PCMaudio-related blocks were many drawbacks which have been nowfixed

• SDK - license info was not registered

• The GdiDisplay block could draw some images skewd, according to the image size

• Fixed a bug in Blob2D internal memory deallocation (delete was used instead ofdelete[])

• The block ”ZStarIn” never report the state of Button S1

• MatrixFromFile: fixed an issue when reading single-line matrices from file. Size wasnot automatically detected

• Fixed issues with block Counter: Stop did not work; Bounded and Circular modesdid not work in some cases

• Fixed bug with FreeFrame plugins. If FrameCopy is not supported, invoking FF GETPLUGINCAPSreturn FF FAIL which is defined as 0xFFFFFFFF. This was used as the number ofinputs/outputs of the block, causing Eyw to crash.

• 3DDisplay: check that the texture file exists before trying to load it

• GetMouse: the type could be changed at runtime causing a signature change event,which causes an EysWeb crash!

• Eyesweb crash when starting a patch containing the WaveFileWriter block with emptyfilename parameter

• Fixed some issues with delayed notification of parameter changes in subpatches

• ProximityMeasures: the block could cause Eyw to crash when the search ROI ex-ceeded the image boundaries

• Fixed bug in block ColorToGray (image step was wrong)

C.5 EyesWeb 5.0.2.2

• Base Catalog - Block BooleanToTrigger used the same name and description for Modeand InitialState parameters

• Base Catalog - Fixed issue with DrawGraphicObjects. It was drawing all inputseven if unchanged; not it draws only changed inputs. An option to preserve the oldbehaviour is available

• Base Catalog - Extract Blob From List, when asked to use the contraction index, wasexamining an uninitialized variable, leading to random results; now it uses the returnvalue of GetContractionIndex

1326

• Base Catalog - The MatrixConcatenate block could fail after the first execution if thesize of the input matrices was changed

• Base Catalog - Fixed bug with the Image datatype. An access violation could occurwhen performing a SetColor operation

• Base Catalog - Fixed a bug which caused the SignalGenerator block to crash withsome buffersizes

• Kernel Catalog - Fixed a problem with the InputSelector block which could slow downEyesWeb after running for a while if the Active input parameter was continuosly set(even if it was not actually changing)

• Steinberg Catalog - VST blocks would fail to instantiate because they would try tounregister an activation event on input would always fail because the block didn’tregister for input-based activation yet

• Steinberg Catalog - The last character in each VST parameter name was trimmed(even if it wasn’t a space)

• Steinberg Catalog - When the VST reports an initial value that is outside the [0,1]range, force it to be a valid valu

• Kernel - Fixed wrong comparison of log level, which caused debug messages not tobe logged to file

• Media Format - Fixed bugs with WMVReader, VideoServer, NetRecvUDP, Net-SendUDP, VideoFileReader. They allocated a thread in the constructor; this couldcause EywQuery to fail

C.6 EyesWeb 5.0.2.1

• Base Catalog - The colorToRGB block removeed the inputs without removing relatedactivation events

• Base Catalog - The VSTHost block removeed the inputs without removing relatedactivation events

• Base Catalog - Fixed bug in MovingArithmeticOp; initial value was taken from firstdatatype instance instead of using an empty datatype

• Base Catalog - a WriteFile parameter was not correctly initialized when loading thepatch from file.

• Base Catalog - the function CImageImpl::COpDisplatcher 8u C4::AddInt caused in-finite recursion

• Base catalog - fixed some issue with the ImageMerge block which did not keep intoaccount the position of the merged image

1327

• Base catalog - TemporalData::InitInstance was not copying the min/max value of thesignal from the provided structure

• System catalog - AudioDisplayGDI now tells the graph what is the valid range of thesamples, so that the graph is resized correctly

• GUI - When starting a patch fails, call PatchStop and PatchDone instead of justtelling the engine to perform a done(), or the UI will keep the start and stop buttonsenabled, with the engine already deinitialized. Clicking either button would thencrash Eyesweb.

• Base catalog - Fixed biomobius bug #101 (problems activating Shimmer + Sc2Au +Mean block combination)

• 3D catalog - block 3DObjGenerator: when a parameter was changed the texture datawas reset, thus losing all the information on dynamic texture

• Kernel - links to kernel parameters (parameters related to scheduling) could be lost

• Base catalog - aiff reader: fixed bug which could cause EyesWeb to crash. Buffer sizewas not initialized)

• Base catalog - image datatype: fixed bug which could cause EyesWeb to crash. Thepitch size (size of the memory used by a single row of the image) could assume valuesbelow the required minimum.

• Base catalog - image datatype: fixed bug in ImageGenerator. The size parametercould not be changed.

• Base catalog - PCM dynamic buffer datatype: fixed bug which could cause EyesWebto crash when copying buffers of non-zero size.

• System catalog - OSC reader/writer: fixed bug which slowed down the block; eachmessage sent/received was logged to the EyesWeb console.

• Base catalog - aiff reader: fixed bug which could cause a wrong signature when openingold patches.

• Base catalog - image datatype: fixed wrong RGB to YUV conversion (8u format, 4channels).

• Base catalog - image datatype: fixed buffer overflow (32f format, YUV color model,4 channels).

• Base catalog - audio datatype: fixed buffer overflow in conversion to PCM.

• Kernel: fixed scheduling-related bugs: blocks with only sync-in inputs were activatedmore than necessary if syncin pin was connected to a block which changed schedulingmode at runtime

1328

• Kernel: fixed scheduling-related bugs: when changing activation mode at runtimefrom non-periodic to periodic, the block could not be activated

• Kernel: fixed bugs in catalogs loading: a block without a library declaration causedthe whole catalog not to be loaded. Now the catalog is loaded and the block is loadedtoo (but not visible in the treeview). A log message is written to file.

C.7 EyesWeb 5.0.1.4

• Kernel and SDK: fixed a bug with some waiting functions. Wait could be silentlyabandoned earlier than necessary, causing unpredictable behaviours

• Kernel: fixed bug when saving patches: FitMode and RequiredInterfaces were notsaved

• Kernel: fixed bug #164: when a mobius client stopped patch execution, both theclient and the EyesWeb server could crash

C.8 EyesWeb 5.0.1.3

• Kernel: fixed bug #161 (output of ScalarArithmeticOperation (double) excessive atInit)

• Kernel: fixed bug #167 (conversion from integer matrices to double matrices wasaffected by the installation of the Legacy catalog).

• Base Catalog: fixed bug #166 (the generic reader crashed when loading file with nosaved datatypes)

• SDK (Wizard): defined a title for the wizard dialog, or random characters could bedisplayed

• BaseCatalog: fixed some issues with FileReader which could cause EyesWeb to crashin the case of corrupted ebf files

C.9 EyesWeb 5.0.1.2

• Base Catalog: fixed a bug in computation of Contraction Index

• Kernel Catalog: fixed a bug with input selector when non-matching initinfo(s) werefound

• Kernel: fixed bug with blocks activation at Absolute times

• System Catalog: fixed bugs with ScreenCapture block

• System Catalog: fixed bug(s) with ROI and VideoFilereader

1329

• Kernel: fixed bugs with implicit convertions: sometimes a longer converters chaincould be chosen

• GUI: fixed bug related to the import subpatch command

• System Catalog: fixed bug with NetSendUDP block: could crash EyesWeb wheninitialization of other blocks failed

• Kernel: fixed bug with Initialization-Deinitialization: Done method could be calledeven if Init was not called

• Base Catalog: fixed bug(s) with geometric/graphic datatypes: double coordinateswere not properly normalized in some cases

• System catalog: fixed SystemDirectX block to pose less requirements on the HW

• Kernel: fixed bug with syncin and exclusive mode when no link was connected to thesync pin

• System catalog: fixed bug in StringDisplay: special characters (e.g.,n,r) were not handled properly

C.10 EyesWeb 5.0.1.1

• Installer: installation of DirectX and Visual Studio redistributables was missing

• Installer: installation of OpenCV dlls was missing

• Kernel Catalog: inputselector crashed in the case of inputs of the same type but withdifferent initinfo

• Kernel Catalog: generators did not go back to non continuous output mode

• SDK: nsc were not included correctly

1330

Appendix D

License

Use of EyesWeb (hereinafter ’SOFTWARE’) is contingent on your agreement to the follow-ing terms:

WARRANTY & USE: DIST – University of Genoa grants you a limited, non-exclusive license to use the SOFTWARE free of charge for ANY purpose, commercial orprivate, without restrictions. DIST – University of Genoa makes no representations aboutthe suitability of this software for any purpose. It is provided “as is” without express orimplied warranty. DIST – University of Genoa is not obligated to provide maintenance orupdates for the SOFTWARE.

DISTRIBUTION: the SOFTWARE, in original version or in part, may be freelydistributed, provided that this copyright and permission notice appear on all copies andsupporting documentation, and that the DIST – University of Genoa copyright notices arereferred in the following ways:

a) DIST – University of Genoa’s copyright notice should be included in the documen-tation, regardless of the media used to supply the documentation;

b) the DIST – University of Genoa and EyesWeb Logos have to appear on softwarepackages based on EyesWeb or using it, and on any related promotional material(DIST – University of Genoa makes the logos available on the EyesWeb ftp siteftp://infomus.dist.unige.it);

c) in the “about box” of the product, in the case that it is not the EyesWeb about box,DIST – University of Genoa and EyesWeb must be cited in the following manner:EyesWeb is copyright c© Laboratorio di Infomatica Musicale – DIST – University ofGenoa (http://infomus.dist.unige.it);

d) any public use of EyesWeb, or the distribution of any application based on EyesWeb,must be preliminarily notified to [email protected];

e) this license must be notified to any third party to which EyesWeb is redistributed.

This license only covers EyesWeb and the libraries provided in the original installer.Other extensions (libraries or patches), provided by DIST or by third parties, may besubject to any license, provided that it is not in contrast with this license.

1331

ftp://infomus.dist.unige.it

http://infomus.dist.unige.it


D.1 Third-party software

This product includes software developed by the Apache Software Foundation(http://www.apache.org).

1332

http://www.apache.org

User Manual

Documents

Transcript of User Manual