This example shows how to use the Billboard cloud pipeline

// Copyright (c) Microsoft Corporation. 
// Licensed under the MIT license. 

#include <string>
#include <stdlib.h>
#include <filesystem>
#include <future>
#include "SimplygonLoader.h"


void RunBillboardCloudPipeline(Simplygon::ISimplygon* sg)
{
	Simplygon::spSceneImporter sgSceneImporter = sg->CreateSceneImporter();
	sgSceneImporter->SetImportFilePath( "../Assets/Cages/Cages.obj" );
	if(!sgSceneImporter->RunImport())
		throw std::exception("Failed to load Cages/Cages.obj.");
	Simplygon::spScene sgScene = sgSceneImporter->GetScene();

	// For all materials in the scene set the blend mode to blend (instead of opaque) 
	int materialCount = (int)sgScene->GetMaterialTable()->GetMaterialsCount();
	for (int i = 0; i < materialCount; ++i)
	{
		sgScene->GetMaterialTable()->GetMaterial(i)->SetBlendMode(Simplygon::EMaterialBlendMode::Blend);
	}

	// Create the Impostor processor. 
	Simplygon::spBillboardCloudPipeline sgBillboardCloudPipeline = sg->CreateBillboardCloudPipeline();

	Simplygon::spBillboardCloudSettings sgBillboardCloudSettings = sgBillboardCloudPipeline->GetBillboardCloudSettings();
	Simplygon::spMappingImageSettings sgMappingImageSettings = sgBillboardCloudPipeline->GetMappingImageSettings();

	// Set billboard cloud mode to Outer shell. 
	sgBillboardCloudSettings->SetBillboardMode( Simplygon::EBillboardMode::OuterShell );
	sgBillboardCloudSettings->SetBillboardDensity( 0.5f );
	sgBillboardCloudSettings->SetGeometricComplexity( 0.9f );
	sgBillboardCloudSettings->SetMaxPlaneCount( 20 );
	sgBillboardCloudSettings->SetTwoSided( false );

	sgMappingImageSettings->SetMaximumLayers( 10 );

	Simplygon::spMappingImageOutputMaterialSettings sgOutputMaterialSettings = sgMappingImageSettings->GetOutputMaterialSettings(0);

	// Setting the size of the output material for the mapping image. This will be the output size of the 
	// textures when we do material casting in a later stage. 
	sgOutputMaterialSettings->SetTextureWidth( 1024 );
	sgOutputMaterialSettings->SetTextureHeight( 1024 );
	sgOutputMaterialSettings->SetMultisamplingLevel( 2 );

	// Add diffuse material caster to pipeline. 
	Simplygon::spColorCaster sgDiffuseCaster = sg->CreateColorCaster();

	Simplygon::spColorCasterSettings sgDiffuseCasterSettings = sgDiffuseCaster->GetColorCasterSettings();
	sgDiffuseCasterSettings->SetMaterialChannel( "Diffuse" );
	sgDiffuseCasterSettings->SetOutputImageFileFormat( Simplygon::EImageOutputFormat::PNG );
	sgDiffuseCasterSettings->SetBakeOpacityInAlpha( false );
	sgDiffuseCasterSettings->SetOutputPixelFormat( Simplygon::EPixelFormat::R8G8B8 );
	sgDiffuseCasterSettings->SetDilation( 10 );
	sgDiffuseCasterSettings->SetFillMode( Simplygon::EAtlasFillMode::Interpolate );

	sgBillboardCloudPipeline->AddMaterialCaster( sgDiffuseCaster, 0 );

	// Add specular material caster to pipeline. 
	Simplygon::spColorCaster sgSpecularCaster = sg->CreateColorCaster();

	Simplygon::spColorCasterSettings sgSpecularCasterSettings = sgSpecularCaster->GetColorCasterSettings();
	sgSpecularCasterSettings->SetMaterialChannel( "Specular" );
	sgSpecularCasterSettings->SetOutputImageFileFormat( Simplygon::EImageOutputFormat::PNG );
	sgSpecularCasterSettings->SetDilation( 10 );
	sgSpecularCasterSettings->SetFillMode( Simplygon::EAtlasFillMode::Interpolate );

	sgBillboardCloudPipeline->AddMaterialCaster( sgSpecularCaster, 0 );

	// Add normals material caster to pipeline. 
	Simplygon::spNormalCaster sgNormalsCaster = sg->CreateNormalCaster();

	Simplygon::spNormalCasterSettings sgNormalsCasterSettings = sgNormalsCaster->GetNormalCasterSettings();
	sgNormalsCasterSettings->SetMaterialChannel( "Normals" );
	sgNormalsCasterSettings->SetGenerateTangentSpaceNormals( true );
	sgNormalsCasterSettings->SetOutputImageFileFormat( Simplygon::EImageOutputFormat::PNG );
	sgNormalsCasterSettings->SetDilation( 10 );
	sgNormalsCasterSettings->SetFillMode( Simplygon::EAtlasFillMode::Interpolate );

	sgBillboardCloudPipeline->AddMaterialCaster( sgNormalsCaster, 0 );

	// Setup and run the opacity material casting. Make sure the there is no dilation or fill. 
	Simplygon::spOpacityCaster sgOpacityCaster = sg->CreateOpacityCaster();

	Simplygon::spOpacityCasterSettings sgOpacityCasterSettings = sgOpacityCaster->GetOpacityCasterSettings();
	sgOpacityCasterSettings->SetMaterialChannel( "Opacity" );
	sgOpacityCasterSettings->SetOutputImageFileFormat( Simplygon::EImageOutputFormat::PNG );
	sgOpacityCasterSettings->SetFillMode( Simplygon::EAtlasFillMode::NoFill );
	sgOpacityCasterSettings->SetOutputPixelFormat( Simplygon::EPixelFormat::R8 );

	sgBillboardCloudPipeline->AddMaterialCaster( sgOpacityCaster, 0 );

	// Start the impostor pipeline. 
	sgBillboardCloudPipeline->RunScene(sgScene, Simplygon::EPipelineRunMode::RunInThisProcess);

	// Get the processed scene. 
	Simplygon::spScene sgProcessedScene = sgBillboardCloudPipeline->GetProcessedScene();

	Simplygon::spSceneExporter  sgSceneExporter = sg->CreateSceneExporter();
	sgSceneExporter->SetScene(sgProcessedScene);
	sgSceneExporter->SetExportFilePath( "OuterShellOutput.obj" );
	if(!sgSceneExporter->RunExport())
		throw std::exception("Failed to save OuterShellOutput.obj.");

}

int main()
{
	Simplygon::ISimplygon* sg = NULL;
	Simplygon::EErrorCodes initval = Simplygon::Initialize( &sg );
	if( initval != Simplygon::EErrorCodes::NoError )
	{
		return int(initval);
	}

	RunBillboardCloudPipeline(sg);

	Simplygon::Deinitialize(sg);

	return 0;
}

// Copyright (c) Microsoft Corporation. 
// Licensed under the MIT license. 

using System;
using System.IO;
using System.Threading.Tasks;

public class Program
{
    static void RunBillboardCloudPipeline(Simplygon.ISimplygon sg)
    {
        using (Simplygon.spSceneImporter sgSceneImporter = sg.CreateSceneImporter())
        {
            sgSceneImporter.SetImportFilePath( "../Assets/Cages/Cages.obj" );
            if(!sgSceneImporter.RunImport())
                throw new System.Exception("Failed to load Cages/Cages.obj.");
            Simplygon.spScene sgScene = sgSceneImporter.GetScene();

            // For all materials in the scene set the blend mode to blend (instead of opaque) 
            int materialCount = (int)sgScene.GetMaterialTable().GetMaterialsCount();
            for (int i = 0; i < materialCount; ++i)
            {
                sgScene.GetMaterialTable().GetMaterial(i).SetBlendMode(Simplygon.EMaterialBlendMode.Blend);
            }

            {
            }
            // Create the Impostor processor. 
            using (Simplygon.spBillboardCloudPipeline sgBillboardCloudPipeline = sg.CreateBillboardCloudPipeline())
            {
                using (Simplygon.spBillboardCloudSettings sgBillboardCloudSettings = sgBillboardCloudPipeline.GetBillboardCloudSettings())
                using (Simplygon.spMappingImageSettings sgMappingImageSettings = sgBillboardCloudPipeline.GetMappingImageSettings())
                {
                    // Set billboard cloud mode to Outer shell. 
                    sgBillboardCloudSettings.SetBillboardMode( Simplygon.EBillboardMode.OuterShell );
                    sgBillboardCloudSettings.SetBillboardDensity( 0.5f );
                    sgBillboardCloudSettings.SetGeometricComplexity( 0.9f );
                    sgBillboardCloudSettings.SetMaxPlaneCount( 20 );
                    sgBillboardCloudSettings.SetTwoSided( false );

                    sgMappingImageSettings.SetMaximumLayers( 10 );

                    using (Simplygon.spMappingImageOutputMaterialSettings sgOutputMaterialSettings = sgMappingImageSettings.GetOutputMaterialSettings(0))
                    {
                        // Setting the size of the output material for the mapping image. This will be the output size of the 
                        // textures when we do material casting in a later stage. 
                        sgOutputMaterialSettings.SetTextureWidth( 1024 );
                        sgOutputMaterialSettings.SetTextureHeight( 1024 );
                        sgOutputMaterialSettings.SetMultisamplingLevel( 2 );

                    }
                }
                // Add diffuse material caster to pipeline. 
                using (Simplygon.spColorCaster sgDiffuseCaster = sg.CreateColorCaster())
                {
                    using (Simplygon.spColorCasterSettings sgDiffuseCasterSettings = sgDiffuseCaster.GetColorCasterSettings())
                    {
                        sgDiffuseCasterSettings.SetMaterialChannel( "Diffuse" );
                        sgDiffuseCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat.PNG );
                        sgDiffuseCasterSettings.SetBakeOpacityInAlpha( false );
                        sgDiffuseCasterSettings.SetOutputPixelFormat( Simplygon.EPixelFormat.R8G8B8 );
                        sgDiffuseCasterSettings.SetDilation( 10 );
                        sgDiffuseCasterSettings.SetFillMode( Simplygon.EAtlasFillMode.Interpolate );
                    }

                    sgBillboardCloudPipeline.AddMaterialCaster( sgDiffuseCaster, 0 );
                }

                // Add specular material caster to pipeline. 
                using (Simplygon.spColorCaster sgSpecularCaster = sg.CreateColorCaster())
                {
                    using (Simplygon.spColorCasterSettings sgSpecularCasterSettings = sgSpecularCaster.GetColorCasterSettings())
                    {
                        sgSpecularCasterSettings.SetMaterialChannel( "Specular" );
                        sgSpecularCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat.PNG );
                        sgSpecularCasterSettings.SetDilation( 10 );
                        sgSpecularCasterSettings.SetFillMode( Simplygon.EAtlasFillMode.Interpolate );
                    }

                    sgBillboardCloudPipeline.AddMaterialCaster( sgSpecularCaster, 0 );
                }

                // Add normals material caster to pipeline. 
                using (Simplygon.spNormalCaster sgNormalsCaster = sg.CreateNormalCaster())
                {
                    using (Simplygon.spNormalCasterSettings sgNormalsCasterSettings = sgNormalsCaster.GetNormalCasterSettings())
                    {
                        sgNormalsCasterSettings.SetMaterialChannel( "Normals" );
                        sgNormalsCasterSettings.SetGenerateTangentSpaceNormals( true );
                        sgNormalsCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat.PNG );
                        sgNormalsCasterSettings.SetDilation( 10 );
                        sgNormalsCasterSettings.SetFillMode( Simplygon.EAtlasFillMode.Interpolate );
                    }

                    sgBillboardCloudPipeline.AddMaterialCaster( sgNormalsCaster, 0 );
                }

                // Setup and run the opacity material casting. Make sure the there is no dilation or fill. 
                using (Simplygon.spOpacityCaster sgOpacityCaster = sg.CreateOpacityCaster())
                {
                    using (Simplygon.spOpacityCasterSettings sgOpacityCasterSettings = sgOpacityCaster.GetOpacityCasterSettings())
                    {
                        sgOpacityCasterSettings.SetMaterialChannel( "Opacity" );
                        sgOpacityCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat.PNG );
                        sgOpacityCasterSettings.SetFillMode( Simplygon.EAtlasFillMode.NoFill );
                        sgOpacityCasterSettings.SetOutputPixelFormat( Simplygon.EPixelFormat.R8 );
                    }

                    sgBillboardCloudPipeline.AddMaterialCaster( sgOpacityCaster, 0 );
                }

                // Start the impostor pipeline. 
                sgBillboardCloudPipeline.RunScene(sgScene, Simplygon.EPipelineRunMode.RunInThisProcess);

                // Get the processed scene. 
                using (Simplygon.spScene sgProcessedScene = sgBillboardCloudPipeline.GetProcessedScene())
                {
                    using (Simplygon.spSceneExporter sgSceneExporter = sg.CreateSceneExporter())
                    {
                        sgSceneExporter.SetScene(sgProcessedScene);
                        sgSceneExporter.SetExportFilePath( "OuterShellOutput.obj" );
                        if(!sgSceneExporter.RunExport())
                            throw new System.Exception("Failed to save OuterShellOutput.obj.");

                    }
                }
            }
        }
    }
    static int Main(string[] args)
    {
        using (var sg = Simplygon.Loader.InitSimplygon(out var errorCode, out var errorMessage))
        {
            if (errorCode != Simplygon.EErrorCodes.NoError)
                return (int)errorCode;
            RunBillboardCloudPipeline(sg);
        }

        return 0;
    }
}

# Copyright (c) Microsoft Corporation. 
# Licensed under the MIT license. 

import math
import os
import sys
import glob
import gc
import threading

from pathlib import Path
from simplygon import simplygon_loader
from simplygon import Simplygon


def RunBillboardCloudPipeline(sg: Simplygon.ISimplygon):
    sgSceneImporter = sg.CreateSceneImporter()
    sgSceneImporter.SetImportFilePath( '../Assets/Cages/Cages.obj' )
    if not sgSceneImporter.RunImport():
        raise Exception('Failed to load Cages/Cages.obj.')
    sgScene = sgSceneImporter.GetScene()

    # For all materials in the scene set the blend mode to blend (instead of opaque) 
    materialCount = sgScene.GetMaterialTable().GetMaterialsCount()
    for i in range(0, materialCount):
        sgScene.GetMaterialTable().GetMaterial(i).SetBlendMode(Simplygon.EMaterialBlendMode_Blend)

    # Create the Impostor processor. 
    sgBillboardCloudPipeline = sg.CreateBillboardCloudPipeline()

    sgBillboardCloudSettings = sgBillboardCloudPipeline.GetBillboardCloudSettings()
    sgMappingImageSettings = sgBillboardCloudPipeline.GetMappingImageSettings()

    # Set billboard cloud mode to Outer shell. 
    sgBillboardCloudSettings.SetBillboardMode( Simplygon.EBillboardMode_OuterShell )
    sgBillboardCloudSettings.SetBillboardDensity( 0.5 )
    sgBillboardCloudSettings.SetGeometricComplexity( 0.9 )
    sgBillboardCloudSettings.SetMaxPlaneCount( 20 )
    sgBillboardCloudSettings.SetTwoSided( False )

    sgMappingImageSettings.SetMaximumLayers( 10 )

    sgOutputMaterialSettings = sgMappingImageSettings.GetOutputMaterialSettings(0)

    # Setting the size of the output material for the mapping image. This will be the output size of the 
    # textures when we do material casting in a later stage. 
    sgOutputMaterialSettings.SetTextureWidth( 1024 )
    sgOutputMaterialSettings.SetTextureHeight( 1024 )
    sgOutputMaterialSettings.SetMultisamplingLevel( 2 )

    # Add diffuse material caster to pipeline. 
    sgDiffuseCaster = sg.CreateColorCaster()
    sgDiffuseCasterSettings = sgDiffuseCaster.GetColorCasterSettings()
    sgDiffuseCasterSettings.SetMaterialChannel( "Diffuse" )
    sgDiffuseCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat_PNG )
    sgDiffuseCasterSettings.SetBakeOpacityInAlpha( False )
    sgDiffuseCasterSettings.SetOutputPixelFormat( Simplygon.EPixelFormat_R8G8B8 )
    sgDiffuseCasterSettings.SetDilation( 10 )
    sgDiffuseCasterSettings.SetFillMode( Simplygon.EAtlasFillMode_Interpolate )

    sgBillboardCloudPipeline.AddMaterialCaster( sgDiffuseCaster, 0 )

    # Add specular material caster to pipeline. 
    sgSpecularCaster = sg.CreateColorCaster()
    sgSpecularCasterSettings = sgSpecularCaster.GetColorCasterSettings()
    sgSpecularCasterSettings.SetMaterialChannel( "Specular" )
    sgSpecularCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat_PNG )
    sgSpecularCasterSettings.SetDilation( 10 )
    sgSpecularCasterSettings.SetFillMode( Simplygon.EAtlasFillMode_Interpolate )

    sgBillboardCloudPipeline.AddMaterialCaster( sgSpecularCaster, 0 )

    # Add normals material caster to pipeline. 
    sgNormalsCaster = sg.CreateNormalCaster()
    sgNormalsCasterSettings = sgNormalsCaster.GetNormalCasterSettings()
    sgNormalsCasterSettings.SetMaterialChannel( "Normals" )
    sgNormalsCasterSettings.SetGenerateTangentSpaceNormals( True )
    sgNormalsCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat_PNG )
    sgNormalsCasterSettings.SetDilation( 10 )
    sgNormalsCasterSettings.SetFillMode( Simplygon.EAtlasFillMode_Interpolate )

    sgBillboardCloudPipeline.AddMaterialCaster( sgNormalsCaster, 0 )

    # Setup and run the opacity material casting. Make sure the there is no dilation or fill. 
    sgOpacityCaster = sg.CreateOpacityCaster()
    sgOpacityCasterSettings = sgOpacityCaster.GetOpacityCasterSettings()
    sgOpacityCasterSettings.SetMaterialChannel( "Opacity" )
    sgOpacityCasterSettings.SetOutputImageFileFormat( Simplygon.EImageOutputFormat_PNG )
    sgOpacityCasterSettings.SetFillMode( Simplygon.EAtlasFillMode_NoFill )
    sgOpacityCasterSettings.SetOutputPixelFormat( Simplygon.EPixelFormat_R8 )

    sgBillboardCloudPipeline.AddMaterialCaster( sgOpacityCaster, 0 )

    # Start the impostor pipeline. 
    sgBillboardCloudPipeline.RunScene(sgScene, Simplygon.EPipelineRunMode_RunInThisProcess)

    # Get the processed scene. 
    sgProcessedScene = sgBillboardCloudPipeline.GetProcessedScene()

    sgSceneExporter = sg.CreateSceneExporter()
    sgSceneExporter.SetScene(sgProcessedScene)
    sgSceneExporter.SetExportFilePath( 'OuterShellOutput.obj' )
    if not sgSceneExporter.RunExport():
        raise Exception('Failed to save OuterShellOutput.obj.')


if __name__ == '__main__':
    sg = simplygon_loader.init_simplygon()
    if sg is None:
        exit(Simplygon.GetLastInitializationError())

    RunBillboardCloudPipeline(sg)

    sg = None
    gc.collect()