You are here: Start » Getting Started » Using User Filters on Linux

Using User Filters on Linux

Creating Studio project

First you should create Aurora Vision Studio project and add new User Filter library on Windows. Refer to Creating User Filters Studio article for details.

Implement and build your User Filter. Then in Aurora Vision Studio add it to program and use it as needed. Note that path to the User Filter should be relative to the project.

Building User Filter on Linux

On Linux install avexecutor. Copy source code of your User Filter to Linux. To build it using gcc, you will need to:

• add the avexecutor's include/ subdirectory to the compiler include directories: -I switch
• add the avexecutor's lib/x86_64-linux-gnu/ subdirectory to the linker directories: -L switch
• link with Aurora Vision Library Lite and UserFilters: -lAVL_Lite -lUserFilters
• signify we are building a shared library: -shared -fPIC
• set output name to .so: -o user_filter_library.so

Loading User Filter library from Studio program

Copy Studio project files to Linux. Put built .so User Filter library in directory relative to project files. Make sure the file name of User Filter selected on Windows (e.g. user_filter_library.dll) matches name of .so file. The file extension will be changed automatically by Console application.

Then the program can be started as usual: <path to Console application> <path to .avproj file>

Using AVL instead of AVL Lite

User Filter can alternatively be built using full AVL library. The process described above will need to be changed as follows:

• point compiler also to include and lib directories of AVL
• link with AVL instead of AVL_Lite: -lAVL
• copy libAVL.so from AVL directory to avexecutor/lib/x86_64-linux-gnu/ directory
• change #include to <AVL.h>
• remember to modify Visual Studio solution on Windows in a similar manner