UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
FAQ
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine and Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
CIGI Client Plugin
Rendering-Related Classes

Setting Up Projections with AppEasyBlend Plugin

AppEasyBlend plugin allows you to render the UNIGINE-based application on multi-projector setups that are stored in the calibration files created via the Scalable Display Manager and set up via the EasyBlend SDK. The setup can have a complex shape, such as dome.

Notice
  • The plugin is available only on Windows with DirectX 11 API. OpenGL support is currently experimental.
  • Microsoft Visual C++ 2008 Redistributable Package x64 / x86 is required.
  • This plugin cannot be used in a Qt-based application.

The plugin supports the fullwindow mode (when the application window is rendered without decorations).

Notice
If you run the application in the windowed mode, the window should be non-resizable.

You can toggle the AppEasyBlend plugin via the easyblend console command:

  • To enable, use:
    Source code
    easyblend 1
  • To disable, use:
    Source code
    easyblend 0

See Also

Implementing Unigine Application with AppEasyBlend Support

To use the AppEasyBlend plugin with UNIGINE, perform the following:

  1. Download and install the Scalable SDK.
  2. Set the path to the following files in the PATH environment variable or place these files in the same folder as the binary executable:
    • x86:
      • <Scalable Display SDK>/ScalableSDK_DX/DLL/Win32/mplEasyBlendSDKDX11.dll
      • <Scalable Display SDK>/ScalableSDK_GL/DLL/Win32/mplEasyBlendSDK.dll
    • x64:
      • <Scalable Display SDK>/ScalableSDK_DX/DLL/x64/mplEasyBlendSDKDX1164.dll
      • <Scalable Display SDK>/ScalableSDK_GL/DLL/x64/mplEasyBlendSDK64.dll
  3. Create a new project with AppEasyBlend support via UNIGINE SDK Browser: click Plugins, check the EasyBlend support (AppEasyBlend plugin) option in the form that opens and click Ok.

    AppEasyBlend Plugin on Plugins Panel
    Notice
    To add AppEasyBlend support to the existing project, in UNIGINE SDK Browser, click Other Actions -> Configure Project -> Plugins -> EasyBlend support (AppEasyBlend plugin) -> Ok.
  4. Implement your application.
  5. Launch the AppEasyBlend plugin on the application start-up.

Launching AppEasyBlend

To launch the plugin, specify the extern_plugin command line option on the application start-up as follows:

Notice
For the correct result, the screen resolution must be specified on the application start-up, and it must be the same as the one set in the *.ol file.
Shell commands
main_x64d -extern_plugin AppEasyBlend -calibration_file "my_file.ol" -video_mode -1 -video_width 1024 -video_height 768

Here:

  • calibration_file option specifies a path to an *.ol calibration file that stores projection settings. Both relative and absolute paths are supported.

If you run the application via UNIGINE SDK Browser, specify the command-line options given above in the Customize Run Options form.

Notice

It is not possible to use AppEasyBlend with:

Compiling AppEasyBlend

Plugin compilation is required if you change its source code (for example, add new API functions).

ScalableSDK is required for recompiling the AppEasyBlend plugin:

  1. Get the ScalableSDK and the DirectX SDK.
  2. Set the path to the <ScalableSDK> folder in the SCALABLESDK environment variable. The DXSDK_DIR environment variable will be automatically created on DirectX SDK installation.
    Shell commands
    set SCALABLESDK=<ScalableSDK>
  3. Compile the plugin in one of the following ways:
    • By using the build script:
      Shell commands
      C:\UnigineSDK\source>build.py --plugin AppEasyBlend
    • Manually with Scons: go to <UnigineSDK>\source via the command line, type scons and the plugin name and press ENTER:
      Shell commands
      C:\UnigineSDK\source>scons AppEasyBlend
    • Via Microsoft Visual Studio: go to the <UnigineSDK>\source\plugins\App\AppEasyBlend, open the appeasyblend_vs2013.vcxproj or appeasyblend_vs2015.vcxproj project and build it.
Last update: 2018-12-17