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.

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

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#

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.

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

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 (absolute) to an *.ol calibration file that stores projection settings.

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

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.