#
# Example of creating a temporary custom property (aka custom pset)
# which can be written to before actually depositing in the scene
# 
app = Application
from win32com.client import constants as c
app.NewScene( "", 0 )
# Demonstrate how you can use it to create a built-in custom pset
presetFullPath = XSIUtils.BuildPath( 
        app.InstallationPath(c.siFactoryPath), 
        "Data", "DSPresets", "Properties", "Annotation.Preset"
)
oAnnotation = app.CreateObjectFromPreset( presetFullPath, "Notes" )
if ( oAnnotation ) :
        # Even though it only exists on the clipboard you can still populate it
        app.InspectObj( oAnnotation, "", "Annotation Test", "siModal", 0 )
        # Notice how the owner of this annotation doesn't have to 
        # exist until you are ready to cut-and-paste it
        oNull = app.ActiveSceneRoot.AddModel("", "Jerry")
        app.CopyPaste(oAnnotation, "", oNull, 1)
        # Just to prove that it exists any modifications 
        for oParam in oNull.Properties("Notes").Parameters :
                app.LogMessage( oParam.Name + ": " + str(oParam.Value) )
else :
        app.LogMessage( "Couldn't create Annotatation property." )
# Expected results (similar to):
# INFO : Title: 
# INFO : Text: need to refine right bicep
# INFO : Keyword: modeling
# INFO : Flag 1: False
# INFO : Flag 2: True

/*
        This example demonstrates how to use the CopyPaste command to 
        reparent scene objects by physically moving objects under 
        their new parents (a la drag-and-drop in the UI).
*/
// Create a new scene with 4 nulls
var app = Application;
NewScene(null, false);
GetPrim("Null");
GetPrim("Null");
GetPrim("Null");
GetPrim("Null");
// Reparent null2 and null3 under null1
CopyPaste("null3", null, "null1", 1);
CopyPaste("null2", null, "null1", 1);
// Reparent null under null2
CopyPaste("null", null, "null2", 1);
// Print the visual hierarchy
ShowMeTheHierarchy(app.ActiveSceneRoot, "");
// Expected results:
// INFO : Camera_Root
// INFO : ...Camera
// INFO : ...Camera_Interest
// INFO : light
// INFO : null1
// INFO : ...null3
// INFO : ...null2
// INFO : ......null
// Convenience function to print out a graphical representation 
// of the hierarchy in the scene starting at the specified object
function ShowMeTheHierarchy(in_parent, in_depth)
{
        var kid = new Enumerator(in_parent.Children);
        for (; !kid.atEnd(); kid.moveNext()) {
                app.LogMessage(in_depth + kid.item().FullName);
                if (kid.item().Children.Count) {
                        ShowMeTheHierarchy(kid.item(), in_depth + "...");
                }
        }
}