Create and access nodes and resources. More...

Inheritance diagram for Project:

Collaboration diagram for Project:

Public Member Functions
Brush	CreateBrush (string name, BrushLibrary parent, BrushType brushType)
	Creates a brush in the Brushes library.

Brush	CreateBrush (string name, BrushLibrary parent, BrushTypeEnum brushType)
	Creates a brush in the Brushes library.

Node	CreateComponentNode (string name, Node parent, ComponentType componentType)
	Creates a component node.

DataSource	CreateDataSource (string name, [NotNull] DataSourceType dataSourceType)
	Creates a data source in the Data Sources library.

LightNode	CreateLightNode (string name, ProjectItem parent, LightKind kind)
	Creates a light node of the specified kind.

MessageType	CreateMessageType (string name, IEnumerable< PluginInterface.Property > messageArguments)
	Creates a message type.

NodeComponent	CreateNodeComponent (string name, NodeComponentHost parent, NodeComponentType nodeComponentType)
	Creates a node component to the specified parent.

NodeEffect2D	CreateNodeEffect2D (string name, INodeEffect2DContainer parent, NodeEffectType2D nodeEffectType)
	Creates an effect.

NodeEffectPrefab2D	CreateNodeEffectPrefab2D (string name, NodeEffectType2D nodeEffectType)
	Use effects to apply post-processing effects to 2D nodes.

ProjectItem	CreateProjectItem (Type projectItemType, string name, ProjectItem parent)
	Creates a project item.

T	CreateProjectItem< T > (string name, ProjectItem parent)
	Creates a project item.

RenderPass	CreateRenderPass (string name, IComposerContainer parent, RenderPassType renderPassType)
	Creates a render pass.

RenderPassPrefab	CreateRenderPassPrefab (string name, RenderPassType renderPassType)
	Creates a render pass prefab.

StudioPluginItem	CreateStudioPluginItem (string name, [CanBeNull] StudioPluginItem parent, [CanBeNull] string logicFactoryName)
	Creates a studio plugin item.

PreviewConfiguration?	GetPreviewConfiguration ()
	Gets the Preview application configuration that Kanzi Studio currently uses.

ProjectItem	GetProjectItem (string projectItemPath)
	Gets a project item.

ProjectItem	GetProjectItemByKzbUrl (string kzbUrl, bool searchFromReferencedProjects)
	Gets a project item by its kzb URL.

IEnumerable< string >	GetReferringItemsKzbNames (string propertyTypeName)
	Gets the kzb names of items that refer to the specified property type.

bool	IsAbstract (Type projectItemType)
	Checks whether a project item type is abstract and cannot be instantiated directly.

Public Member Functions inherited from ProjectItem
void	AddProperty (Property property)
	Adds a property to an item.

void	AddProperty (string propertyName)
	Adds a property to an item.

void	BeginBatchModification (string batchName)
	Begins a batch modification operation.

bool	CanAddProperty (Property property)
	Checks whether Kanzi Studio allows you to add a specific property to an item.

bool	CanAddProperty (string propertyName)
	Checks whether Kanzi Studio allows you to add a specific property to an item.

void	CommitBatchModification ()
	Commits the current batch modification operation.

bool	Delete ()
	Deletes a project item.

void	DeregisterThumbnailUser (object user)
	Deregisters a registerd thumbnail user.

IEnumerable< Property >	GetAddableProperties ()
	Gets a list of properties which you can add to an item.

T	GetAncestor< T > ()
	Gets the nearest item of given type in the parent tree.

ProjectItem	GetChild (string childName)
	Gets the child item of the current item with the given name.

T	GetChild< T > (string childName)
	Gets the child item of the current item with the given name and type.

int	GetChildIndex (ProjectItem child)
	Gets the index of a child project item within this item's children collection.

IEnumerable< Property >	GetContextProperties ()
	Gets the context properties for this project item.

IEnumerable< Property >	GetFixedProperties ()
	Gets the fixed properties for this project item that cannot be removed.

IEnumerable< Property >	GetFrequentlyAddedProperties ()
	Gets the properties that are frequently added to this type of project item.

ProjectItem	GetProjectItemByPath (string path)
	Gets a project item by its path relative to this project item.

string	GetRelativeProjectPathTo (ProjectItem anotherItem)
	Gets the relative path from this project item to another project item.

IEnumerable< Property >	GetRemovableProperties ()
	Gets a list of properties which you can remove from an item.

BitmapSource	GetThumbnail (int width, int height, bool showChildren, bool showFullScreen, Node contextNode)
	Gets the thumbnail image for a project item.

BitmapSource	GetThumbnail (int width, int height, bool showChildren, bool showFullScreen, Node contextNode, float[] letterboxColorRGBA)
	Gets the thumbnail image for a project item.

IEnumerable< ProjectItem >	GetTreeItemsAsList ()
	Enumerates the items under this ProjectItem including this item itself, children, and grand children.

bool	HasProperty (Property property)
	Checks whether an item has a specific property.

bool	HasProperty (string propertyName)
	Checks whether an item has a specific property.

bool	IsPropertyReadOnly (Property property)
	Checks whether the specified property is read-only on this project item.

void	RegisterThumbnailUser (object user, uint width, uint height, bool showChildren, bool showFullScreen, Node contextNode)
	Registers a user for the thumbnail images for a project item.

void	RemoveProperty (Property property)
	Removes a property from an item.

void	RemoveProperty (string propertyName)
	Removes a property from an item.

void	SetChildIndex (ProjectItem child, int index)
	Sets the index of a child project item within this item's children collection.

void	SetPropertyReadOnlyStatus (Property property, bool? value)
	Sets the read-only status of the specified property on this project item.

void	UpdateValidity ()
	Recalculates the validity the item.

Public Member Functions inherited from PropertyContainer
object	Get (Property property)
	Gets the value of a property.

object	Get (string propertyName)
	Gets the value of a property.

T	Get< T > (TypedProperty< T > property)
	Gets the value of a property.

void	Set (string propertyName, object value)
	Sets the value of a property.

void	Set< T > (TypedProperty< T > property, T value)
	Sets the value of a property.

Public Member Functions inherited from ChildContainer
string	GenerateUniqueChildName (string defaultName)
	Generates a unique name.

string	GetInvalidityReasonOfNewName (string newName)
	Returns the reason why the passed name is not valid.

Properties
ProjectItem	ActiveComposition `[get]`
	Gets the currently active composition in Kanzi Studio.

AnimationClipLibrary	AnimationClipLibrary `[get]`
	Gets the Animation Clips library which stores animation clips in a Kanzi Studio project.

AnimationLibrary	AnimationLibrary `[get]`
	Gets the Animation Data library which stores all animations in a Kanzi Studio project.

ApplicationConfigurationResourceFileDirectory	ApplicationDirectory `[get]`
	Gets the Application directory which contains the application configuration files in a Kanzi Studio project.

Asset3DImportSourceDirectory	Asset3DImportSourceDirectory `[get]`
	Gets the directory which contains the 3D asset import source files in a Kanzi Studio project.

string	BinaryExportDirectory `[get]`
	Gets the directory path where Kanzi Studio exports the kzb binary files.

BrushLibrary	BrushLibrary `[get]`
	Gets the Brushes library which stores brushes used in a Kanzi Studio project.

BrushTypeLibrary	BrushTypeLibrary `[get]`
	Gets the brush types available in a Kanzi Studio project.

ComponentTypeLibrary	ComponentTypeLibrary `[get]`
	Gets the component node types available in a Kanzi Studio project.

DataSourceLibrary	DataSourceLibrary `[get]`
	Gets the Data Sources library which stores data sources in a Kanzi Studio project.

DataSourceTypeLibrary	DataSourceTypeLibrary `[get]`
	Gets the Data Source Types library which stores data source types in a Kanzi Studio project.

EnginePluginLibrary	EnginePluginLibrary `[get]`
	Gets the Engine Plugins library which stores engine plugin references in a Kanzi Studio project.

FontDirectory	FontDirectory `[get]`
	Gets the Fonts directory which contains the fonts in a Kanzi Studio project.

FontFamilyLibrary	FontFamilyLibrary `[get]`
	Gets the Font Families library which contains the font families in a Kanzi Studio project.

GenericResourceFileDirectory	GenericResourceFileDirectory `[get]`
	Gets the Generic directory which contains the generic resource files in a Kanzi Studio project.

IEnumerable< Guide >	Guides `[get]`
	Gets the guides in a Kanzi Studio project.

ImageDirectory	ImageDirectory `[get]`
	Gets the Images directory which contains the image files in a Kanzi Studio project.

bool	IsJavaProject `[get]`
	Gets whether this project is a Java-based project.

bool	IsNewlyCreatedProject `[get]`
	Gets whether this is a newly created project that has not been saved yet.

bool	IsSDKProject `[get]`
	Checks whether this Kanzi Studio project follows the folder structure of a project that uses application code.

LocaleLibrary	LocaleLibrary `[get]`
	Gets the Locales library which stores locales in a Kanzi Studio project.

MaterialLibrary	MaterialLibrary `[get]`
	Gets the Materials library which contains the materials in a Kanzi Studio project.

MaterialTypeLibrary	MaterialTypeLibrary `[get]`
	Gets the Material Types library which contains the material types in a Kanzi Studio project.

MeshLibrary	MeshLibrary `[get]`
	Gets the Meshes library which contains the meshes in a Kanzi Studio project.

MessageTypeLibrary	MessageTypeLibrary `[get]`
	Gets the message types available in a Kanzi Studio project.

NodeComponentTypeLibrary	NodeComponentTypeLibrary `[get]`
	Gets the node component types available in a Kanzi Studio project.

NodeEffectPrefab2DLibrary	NodeEffectPrefab2DLibrary `[get]`
	Gets the 2D Effects library which stores the 2D effects in a Kanzi Studio project.

NodeEffectType2DLibrary	NodeEffectType2DLibrary `[get]`
	Gets the 2D effect types available in a Kanzi Studio project.

PageTransitionCollectionLibrary	PageTransitionCollectionLibrary `[get]`
	Gets the Page Transitions library which contains the page transitions in a Kanzi Studio project.

PipelineItemLibrary	PipelineItemLibrary `[get]`
	Gets the Object Sources library which contains the object sources and filters in a Kanzi Studio project.

PrefabLibrary	PrefabLibrary `[get]`
	Gets the Prefabs library which contains the prefabs used in a Kanzi Studio project.

string	PreviewWorkingDirectory `[get]`
	Gets the working directory used by the Kanzi Studio Preview.

ProjectReferenceLibrary	ProjectReferenceLibrary `[get]`
	Gets the Project References library which stores the project references and kzb file references in a Kanzi Studio project.

new ProjectProperties	PropertyTypes `[get]`

RenderPassPrefabLibrary	RenderPassPrefabLibrary `[get]`
	Gets the Render Pass Prefabs library which stores the render passes used in a Kanzi Studio project.

RenderPassTypeLibrary	RenderPassTypeLibrary `[get]`
	Gets the render pass types available in a Kanzi Studio project.

Screen	Screen `[get]`
	Gets the Screen node in a Kanzi Studio project.

ShaderGraphsLibrary	ShaderGraphsLibrary `[get]`
	Gets the Shader Graphs library which stores the visual shader graphs in a Kanzi Studio project.

ShaderSourceDirectory	ShaderSourceDirectory `[get]`
	Gets the Shaders directory which stores the shader source files in a Kanzi Studio project.

ShortcutLibrary	ShortcutLibrary `[get]`
	Gets the Bookmarks library which stores the bookmarks in a Kanzi Studio project.

StateManagerLibrary	StateManagerLibrary `[get]`
	Gets the State Managers library which stores state managers used in a Kanzi Studio project.

StudioPluginItemLibrary	StudioPluginItemLibrary `[get]`
	Gets the Studio Plugin Items library which stores studio plugin items in a Kanzi Studio project.

StyleLibrary	StyleLibrary `[get]`
	Gets the Styles library which stores styles used in a Kanzi Studio project.

TagLibrary	TagLibrary `[get]`
	Gets the Tags library which stores tags used in a Kanzi Studio project.

TextureLibrary	TextureLibrary `[get]`
	Gets the Textures library which stores textures used in a Kanzi Studio project.

ThemeLibrary	ThemeLibrary `[get]`
	Gets the Themes library which stores themes in a Kanzi Studio project.

TimelineSequenceLibrary	TimelineSequenceLibrary `[get]`
	Gets the Timeline Sequences library which stores timeline sequences in a Kanzi Studio project.

TrajectoryLibrary	TrajectoryLibrary `[get]`
	Gets the Trajectories library which stores trajectories used in a Kanzi Studio project.

TriggerActionTypeLibrary	TriggerActionTypeLibrary `[get]`
	Gets the trigger action types available in a Kanzi Studio project.

Properties inherited from ProjectItem
IEnumerable< ProjectItem >	Children `[get]`
	Gets all child items of a project item.

string	IconLocation `[get]`
	Gets the location of the icon for this project item in Kanzi Studio.

object	IconModifier `[get, set]`
	Gets or sets the icon modifier for this project item.

string	InvalidityReason `[get]`
	Gets the reason why this project item is in an invalid state, or null if the item is valid.

bool	IsDeleted `[get]`
	Gets whether this project item has been deleted.

bool	IsDisposed `[get]`
	Gets whether this project item has been disposed.

bool	IsHidden `[get, set]`
	Gets or sets whether this project item is hidden in Kanzi Studio.

bool	IsReadOnly `[get, set]`
	Gets or sets whether this project item is read-only.

bool	IsValidState `[get]`
	Gets whether this project item is in a valid state.

string	KzbUrl `[get]`
	Gets the kzb URL of a project item.

string	Name `[get, set]`
	Gets or sets the name of a project item.

ProjectItem	Parent `[get, set]`
	Gets or sets the parent of this project item.

string	Path `[get]`
	Gets the path to this project item within the project.

Project	Project `[get]`
	Gets the project in which this item is located.

Type	ProjectItemType `[get]`
	Gets the type of this project item.

PropertyTypeLibrary	PropertyTypeLibrary `[get]`
	Gets the Property Types library of the project of this item which stores all property types you create in a Kanzi Studio project.

object	this[Property property] `[get, set]`
	Gets or sets the value of the specified property on this project item.

object	this[string propertyName] `[get, set]`
	Gets or sets the value of the property with the specified name on this project item.

string	ToolTip `[get]`
	Gets the tooltip text for this project item in Kanzi Studio.

string	TypeDisplayName `[get]`
	Gets the type of a project item.

Properties inherited from PropertyContainer
IEnumerable< Property >	Properties `[get]`
	Gets the properties in a project item or node component.

Properties inherited from FileSystemProjectItem
string	FileSystemParentDirectory `[get]`
	Gets the path to the directory in which a resource file is stored.

string	FileSystemPath `[get]`
	Gets the full path to a resource file.

Events
EventHandler< CompositionChangedEventArgs >	ActiveCompositionChanged
	Occurs when the active composition changes.

EventHandler	BinaryExported
	Occurs after the export of the kzb file of the project is completed.

EventHandler	BinaryExporting
	Occurs when the export of the kzb file of the project starts.

EventHandler	Closing
	Occurs when the project is about to close.

EventHandler< ProjectMergeEventArgs >	Merged
	Occurs after a project merge operation is completed.

EventHandler< ProjectMergeEventArgs >	Merging
	Occurs when a project merge operation is about to start.

EventHandler< ProjectSavingEventArgs >	Saved
	Occurs after Kanzi Studio successfully saves the project.

EventHandler< ProjectSavingEventArgs >	Saving
	Occurs when the saving of the project starts.

Events inherited from ProjectItem
EventHandler< CollectionChangedEventArgs< ProjectItem > >	ChildCollectionChanged
	Occurs when the children collection of this project item changes.

EventHandler< DeletedEventArgs >	Deleted
	Occurs after this project item has been deleted.

EventHandler< DeletedEventArgs >	Deleting
	Occurs when this project item is about to be deleted.

EventHandler< CollectionChangedEventArgs< ProjectItem > >	DescendantChildCollectionChanged
	Occurs when the children collection of this project item or any of its descendants changes.

EventHandler< DeletedEventArgs >	DescendantDeleted
	Occurs after a descendant of this project item has been deleted.

EventHandler< DynamicPropertyChangedEventArgs >	DescendantDynamicPropertyChanged
	Occurs when a dynamic property value changes on this project item or any of its descendants.

EventHandler< ParentChangedEventArgs >	DescendantParentChanged
	Occurs when the parent of this project item or any of its descendants changes.

EventHandler< CollectionChangedEventArgs< string > >	DescendantPropertyCollectionChanged
	Occurs when a property is added to or removed from this project item or any of its descendants.

EventHandler< ProjectItemEventArgs >	Disposing
	Occurs when this project item is being disposed.

EventHandler< DynamicPropertyChangedEventArgs >	DynamicPropertyChanged
	Occurs when a dynamic property value changes on this project item.

EventHandler< ParentChangedEventArgs >	ParentChanged
	Occurs when the parent of this project item changes.

EventHandler< PathChangedEventArgs >	PathChanged
	Occurs when the path of this project item changes.

EventHandler< DynamicPropertyChangedEventArgs >	PreviewDescendantDynamicPropertyChanged
	Occurs before a dynamic property value changes on this project item or any of its descendants.

EventHandler< DynamicPropertyChangedEventArgs >	PreviewDynamicPropertyChanged
	Occurs before a dynamic property value changes on this project item.

EventHandler< CollectionChangedEventArgs< string > >	PropertyCollectionChanged
	Occurs when a property is added to or removed from this project item.

EventHandler< ReplaceEventArgs >	Replacing
	Occurs when this project item is being replaced.

EventHandler	ThumbnailChanged
	Occurs when the thumbnail of this project item changes.

EventHandler	ValidityChanged
	Occurs when the validity state of this project item changes.

Detailed Description

Create and access nodes and resources.

Use the functions in this class to create nodes and resources in a project and to access the resources in resource libraries in a project.

Member Function Documentation

◆ CreateBrush() [1/2]

Brush CreateBrush	(	string	name,
		BrushLibrary	parent,
		BrushType	brushType )

Creates a brush in the Brushes library.

Parameters

name	The name of the brush.
parent	The library in which you create the brush.
brushType	The type of the brush you create with this function. BrushTypeLibrary stores the brush types available in a Kanzi Studio project.

Returns: The brush you create with this function.

See also: BrushTypeLibrary, BrushLibrary, TextureLibrary, CreateBrush(string, BrushLibrary, BrushTypeEnum), ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a green Color Brush use this code snippet.
In the Visual Studio solution of your plugin, in the Solution Explorer right-click the project name, select Add Reference, and add the reference to the PresentationCore assembly. Your plugin uses this assembly to define the color you use to set the Brush Color property of the Color Brush.

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Brushes library in the Library > Materials and Textures which stores all the Brushes in a Kanzi Studio project.
            var brushLibrary = studio.ActiveProject.BrushLibrary;
            // Create a Color Brush named Green in the Brushes library.
            var colorBrush = studio.ActiveProject.CreateBrush(
                brushLibrary.GenerateUniqueChildName("Green"), 
                brushLibrary, 
                studio.ActiveProject.BrushTypeLibrary.GetItemByName(BrushTypeNames.ColorBrush));
            // Set the Brush Color property of the Color Brush to green (A=255, R=0, G=255, B=0).
            colorBrush.Set(colorBrush.PropertyTypes.ColorBrushColor, System.Windows.Media.Color.FromArgb(255, 0, 255, 0));
        }

To create a function that creates texture brushes that use PNG images from a directory:

        // For example, to create texture brushes which use images in the 
        // <KanziInstallationDirectory>\Studio\Asset Library\AssetPackages\Coverflow\Tool_project\Images directory,
        // use CreateTextureBrush("../Asset Library/AssetPackages/Coverflow/Tool_project/Images").
        private void CreateTextureBrush(string directory)
        {
            // Get the names of all PNG files in the directory that you pass to this function.
            // To use this function, in the class library file that implements the PluginCommand interface add the using directive for the System.IO namespace.
            var pngFiles = Directory.GetFiles(directory, "*.png").Select(x => Path.GetFileName(x)).ToArray();
 
            // Get the Library > Materials and Textures > Textures library which stores all the textures in a Kanzi Studio project.
            var textureLibrary = studio.ActiveProject.TextureLibrary;
 
            // Get the Library > Materials and Textures > Brushes library which stores all the brushes in a Kanzi Studio project.
            var brushLibrary = studio.ActiveProject.BrushLibrary;
 
            // Create a Texture Brush for each of the images.
            foreach (var pngFile in pngFiles)
            {
                // Get the name of a file without the extension.
                var resourceName = Path.GetFileNameWithoutExtension(pngFile);
 
                // Import the image file to the Library > Resource Files > Images directory and create a Single Texture that uses this image.
                // To import an image without creating a texture, set the second parameter of the ImportImages command to false.
                studio.Commands.ImportImages(studio.ActiveProject, Path.Combine(directory, pngFile), true);
 
                // Get the texture you created.
                var texture = textureLibrary.GetItemByName(resourceName);
 
                // Create a Texture Brush in the Library > Materials and Textures > Brushes and name it after the texture.
                var myTextureBrush = studio.ActiveProject.CreateBrush(
                    brushLibrary.GenerateUniqueChildName(resourceName),
                    brushLibrary,
                    studio.ActiveProject.BrushTypeLibrary.GetItemByName(BrushTypeNames.TextureBrush));
 
                // Set the Brush Texture property of the Texture Brush to the texture you created.
                myTextureBrush.Set(myTextureBrush.PropertyTypes.TextureBrushRenderTexture.Name, texture);
            }
        }

◆ CreateBrush() [2/2]

Brush CreateBrush	(	string	name,
		BrushLibrary	parent,
		BrushTypeEnum	brushType )

Creates a brush in the Brushes library.

You can use this function to create brushes of types that come with Kanzi Studio.

Parameters

name	The name of the brush.
parent	The library in which you create the brush.
brushType	The type of the brush you create with this function. Use BrushTypeEnum.COLOR for Color Brush, BrushTypeEnum.CONTENT for Content Brush, BrushTypeEnum.MATERIAL for Material brush, and BrushTypeEnum.TEXTURE for Texture Brush.

Returns: The brush you create with this function.

See also: CreateBrush(string, BrushLibrary, BrushType), BrushLibrary

Examples

To create a green Color Brush use this code snippet.
In the Visual Studio solution of your plugin, in the Solution Explorer right-click the project name, select Add Reference, and add the reference to the PresentationCore assembly. Your plugin uses this assembly to define the color you use to set the Brush Color property of the Color Brush.

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Brushes library in the Library > Materials and Textures which stores all the Brushes in a Kanzi Studio project.
            var brushLibrary = studio.ActiveProject.BrushLibrary;
            // Create a Color Brush named Green in the Brushes library.
            var colorBrush = studio.ActiveProject.CreateBrush(brushLibrary.GenerateUniqueChildName("Green"), brushLibrary, BrushTypeEnum.COLOR);
            // Set the Brush Color property of the Color Brush to green (A=255, R=0, G=255, B=0).
            colorBrush.Set(colorBrush.PropertyTypes.ColorBrushColor, System.Windows.Media.Color.FromArgb(255, 0, 255, 0));
        }

◆ CreateComponentNode()

Node CreateComponentNode	(	string	name,
		Node	parent,
		ComponentType	componentType )

Creates a component node.

Parameters

name	The name of the node.
parent	The parent node of the node you create with this function.
componentType	The component type of the node.

Returns: The component node you create with this function.

See also: ComponentTypeLibrary

Examples

To create component nodes:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the component type library which contains the Kanzi component node types.
            var componentTypeLibrary = studio.ActiveProject.ComponentTypeLibrary;
            // Get the Scene node in the Screens/Screen/RootNode/Viewport 2D node.
            var scene = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D").GetChild<Scene>("Scene");
 
            // In the Scene node create a Button 3D node named My Button.
            studio.ActiveProject.CreateComponentNode(
                scene.GenerateUniqueChildName("My Button"), scene, componentTypeLibrary.GetComponentType(ComponentTypeNames.Button3D));
 
            // In the Scene node create a Grid List Box 3D node named My Grid List Box.
            studio.ActiveProject.CreateComponentNode(
                scene.GenerateUniqueChildName("My Grid List Box 3D"), scene, componentTypeLibrary.GetComponentType(ComponentTypeNames.GridListBox3D));
 
            // In the Scene node create a Scroll View 3D node named My Scroll View.
            studio.ActiveProject.CreateComponentNode(
                scene.GenerateUniqueChildName("My Scroll View"), scene, componentTypeLibrary.GetComponentType(ComponentTypeNames.ScrollView3D));
 
            // In the Scene node create a Stack Layout 3D node named My Stack Layout.
            studio.ActiveProject.CreateComponentNode(
                scene.GenerateUniqueChildName("My Stack Layout"), scene, componentTypeLibrary.GetComponentType(ComponentTypeNames.StackLayout3D));
        }

◆ CreateDataSource()

DataSource CreateDataSource	(	string	name,
		[NotNull] DataSourceType	dataSourceType )

Creates a data source in the Data Sources library.

Parameters

name	The name of the data source.
dataSourceType	The type of the data source. DataSourceTypeLibrary stores the data source types available in a Kanzi Studio project.

Returns: The data source you create with this function.

See also: DataSourceLibrary, DataSourceTypeLibrary

◆ CreateLightNode()

LightNode CreateLightNode	(	string	name,
		ProjectItem	parent,
		LightKind	kind )

Creates a light node of the specified kind.

Use this function instead of CreateProjectItem(System.Type, string, ProjectItem) when you need to create a typed light (Directional, Point, or Spot). The generic CreateProjectItem path creates a default-typed light, and the internal LightType property cannot be changed afterward using the public API.

Parameters

name	The name of the light node.
parent	The parent node of the light node you create with this function. Must be a Node3D.
kind	The kind of light to create.

Returns: The light node you create with this function.

See also: LightKind, CreateProjectItem(System.Type, string, ProjectItem)

◆ CreateMessageType()

MessageType CreateMessageType	(	string	name,
		IEnumerable< PluginInterface.Property >	messageArguments )

Creates a message type.

Use this function to create message types in the Message Type library of a Kanzi Studio project.

Parameters

name	The name of the message type.

///

Parameters

messageArguments The arguments of the message type. Kanzi engine uses these arguments with the execution of the message.

Returns: The message type you create with this function.

◆ CreateNodeComponent()

NodeComponent CreateNodeComponent	(	string	name,
		NodeComponentHost	parent,
		NodeComponentType	nodeComponentType )

Creates a node component to the specified parent.

Parameters

name	The name of the node component.
parent	The NodeComponentHost in which you want to create the node component.
nodeComponentType	The type of the node component you create with this function. NodeComponentTypeLibrary stores the node component types available in a Kanzi Studio project.

Returns: The node component you create with this function.

See also: NodeComponentTypeLibrary, NodeComponentHost.CreateNodeComponent(string, NodeComponentType), NodeComponentHost.CreateNodeComponent(NodeComponent), ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a node component:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the RootNode node in the Screens/Screen node.
            var rootNode = studio.ActiveProject.GetProjectItem("Screens/Screen").GetChild<EmptyNode2D>("RootNode");
            // Get the Animation Player node component type.
            var animationPlayerType = studio.ActiveProject.NodeComponentTypeLibrary.GetItemByName(NodeComponentTypeNames.AnimationPlayer);
            // Create an Animation Player named Root Animation Player in the RootNode node.
            var animationPlayer = studio.ActiveProject.CreateNodeComponent(
                rootNode.GenerateUniqueChildName("Root Animation Player"), rootNode, animationPlayerType);
        }

◆ CreateNodeEffect2D()

NodeEffect2D CreateNodeEffect2D	(	string	name,
		INodeEffect2DContainer	parent,
		NodeEffectType2D	nodeEffectType )

Creates an effect.

Use effects to apply post-processing effects to 2D nodes. This function creates the effect as child of an INodeEffect2DContainer, such as the NodeEffectPrefab2D.

Parameters

name	The name of the effect.
parent	The parent effect container of the node effect that you create with this function.
nodeEffectType	The type of the node effect. NodeEffectType2DLibrary stores the node effect types available in a Kanzi Studio project.

Returns: The node effect that you create with this function.

See also: CreateNodeEffectPrefab2D, NodeEffectType2DLibrary, ProjectItemLibrary<T>.GetItemByName(string)

Examples

To replace the node effect of an existing node effect prefab:

        // This example replaces the root of a shadow effect prefab with a blur effect and assigns the prefab to a 2D node.
        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Shadow Effect 2D type.
            var shadowEffectType = studio.ActiveProject.NodeEffectType2DLibrary.GetItemByName(NodeEffectType2DNames.ShadowEffect2D);
            // Get the Blur Effect 2D type.
            var blurEffectType = studio.ActiveProject.NodeEffectType2DLibrary.GetItemByName(NodeEffectType2DNames.BlurEffect2D);
            // Create a Shadow Effect 2D effect in the Library > 2D Effects.
            var effectPrefab = studio.ActiveProject.CreateNodeEffectPrefab2D(
                studio.ActiveProject.GenerateUniqueChildName("Shadow Effect"), shadowEffectType);
 
            // Delete the root shadow effect.
            effectPrefab.RootNodeEffect2D.Delete();
 
            // Create a Blur Effect 2D in place of the Shadow Effect 2D that you deleted.
            studio.ActiveProject.CreateNodeEffect2D(
                studio.ActiveProject.GenerateUniqueChildName("Blur Effect"), effectPrefab, blurEffectType);
 
            // Get the Screens/Screen/RootNode/Viewport 2D node.
            var viewportNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D");
            // Set the Effect Prefab property of the Viewport 2D node to the node effect prefab that you created.
            viewportNode.Set(Properties.Node2DEffectPrefab.Name, effectPrefab);
        }

◆ CreateNodeEffectPrefab2D()

NodeEffectPrefab2D CreateNodeEffectPrefab2D	(	string	name,
		NodeEffectType2D	nodeEffectType )

Use effects to apply post-processing effects to 2D nodes.

This function creates the effect prefabs in the 2D Effects library of a Kanzi Studio project.

Parameters

name	The name of the node effect prefab.
nodeEffectType	The type of the node effect. NodeEffectType2DLibrary stores the node effect types available in a Kanzi Studio project.

Returns: The node effect prefab that you create with this function.

See also: CreateNodeEffect2D, NodeEffectType2DLibrary, ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a node effect prefab:

        // This example creates a shadow effect and assigns it to a 2D node.
        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Shadow Effect 2D type.
            var shadowEffectType = studio.ActiveProject.NodeEffectType2DLibrary.GetItemByName(NodeEffectType2DNames.ShadowEffect2D);
            // Create a Shadow Effect 2D effect in the Library > 2D Effects.
            var shadowEffectPrefab = studio.ActiveProject.CreateNodeEffectPrefab2D(
                studio.ActiveProject.GenerateUniqueChildName("Shadow Effect"), shadowEffectType);
 
            // Get the root shadow effect.
            var shadowEffect = shadowEffectPrefab.RootNodeEffect2D;
 
            // Set the value of the Shadow Distance property to 15.
            shadowEffect.Set(Properties.ShadowEffect2DDistance, 15);
 
            // Get the Screens/Screen/RootNode/Viewport 2D node.
            var viewportNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D");
            // Set the Effect Prefab property of the Viewport 2D node to the node effect prefab that you created.
            viewportNode.Set(Properties.Node2DEffectPrefab.Name, shadowEffectPrefab);
        }

◆ CreateProjectItem()

ProjectItem CreateProjectItem	(	Type	projectItemType,
		string	name,
		ProjectItem	parent )

Creates a project item.

Use this function to create Kanzi nodes and resources.

Parameters

projectItemType	The type of the item.
name	The name of the item.
parent	The parent item of the item you create with this function.

Returns: The item you create with this function.

See also: ChildContainer.GenerateUniqueChildName, CreateProjectItem<T>(string, ProjectItem), GetProjectItem

Examples

To create five Image2D nodes in the RootNode node:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Screens/Screen/RootNode node.
            var rootNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode");
            // Create five Image2D nodes in the RootNode node.
            var count = "";
            for (var i = 1; i <= 5; i++)
            {
                count = i.ToString();
                studio.ActiveProject.CreateProjectItem(typeof(Image2D), rootNode.GenerateUniqueChildName("Image " + count), rootNode);
            }
            // Print "Created 5 Image2D nodes in the RootNode node" to the Kanzi Studio Log window.
            studio.Log("Created " + count + " " + typeof(Image2D).Name + " nodes in the " + rootNode.Name + " node");
        }

◆ CreateProjectItem< T >()

T CreateProjectItem< T >	(	string	name,
		ProjectItem	parent )

Creates a project item.

Use this function to create Kanzi nodes and resources.

Template Parameters

T	The type of the item you want to create with this function.

Parameters

name	The name of the item.
parent	The parent item of the item you create with this function.

Returns: The item you create with this function.

See also: ChildContainer.GenerateUniqueChildName, CreateProjectItem(Type, string, ProjectItem), GetProjectItem

Examples

To create a function which creates an Empty Node 2D:

        // This example shows how you can create a function which creates an Empty Node 2D node as a child node of the node, 
        // location of which you pass as a parameter. For example, you can prompt the user to provide the path of the parent node, 
        // or use the GetProjectItem function to get the parent node.
        private Node2D CreateEmptyNode2D(Node2D parentNode)
        {
            // Create an Empty Node 2D node. You use the Project as a factory.
            // The first parameter defines the name of the node. Use the GenerateUniqueChildName function, 
            // because the names of sibling nodes must be unique. The second parameter defines the location 
            // of the parent node of the Empty Node 2D node you create. You pass this parameter to the 
            // CreateEmptyNode2D function when you call it. 
            var emptyNode2D = studio.ActiveProject.CreateProjectItem<EmptyNode2D>(parentNode.GenerateUniqueChildName("Empty Node 2D"), parentNode);
        
            // Make the Empty Node 2D 300 pixels high by setting its Layout Height property.
            emptyNode2D.Set(emptyNode2D.PropertyTypes.NodeHeight, 300.0f);
            // Make the Empty Node 2D 400 pixels wide by setting its Layout Width property.
            emptyNode2D.Set(emptyNode2D.PropertyTypes.NodeWidth, 400.0f);
        
            return emptyNode2D;
        }

Type Constraints

T

:

ProjectItem

◆ CreateRenderPass()

RenderPass CreateRenderPass	(	string	name,
		IComposerContainer	parent,
		RenderPassType	renderPassType )

Creates a render pass.

Use this function to create render passes of different types in the Render Pass Prefabs library of a Kanzi Studio project.

Parameters

name	The name of the render pass.
parent	The parent render pass of the render pass you create with this function.
renderPassType	The type of the render pass. RenderPassTypeLibrary stores the render pass types available in a Kanzi Studio project.

Returns: The render pass you create with this function.

See also: CreateRenderPassPrefab, RenderPassTypeLibrary, ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a basic set of render passes which first clear depth and then draw all the content of the scene:

        // This example creates a render pass prefab that contains this hierarchy of render passes:
        // - Group Render Pass
        //     - Clear Render Pass
        //     - Gather Lights Render Pass
        //         - Draw Objects Render Pass
        // It then sets Kanzi Studio to render the Screens/Screen/RootNode/Viewport 2D node using the Group Render Pass.
        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Group Render Pass render pass type.
            var groupRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.RenderPass);
            // Create a Group Render Pass render pass prefab in the Library > Rendering > Render Pass Prefabs.
            var groupRenderPassPrefab = studio.ActiveProject.CreateRenderPassPrefab(
                studio.ActiveProject.GenerateUniqueChildName("Group Render Pass"), groupRenderPassType);
            // Get the root render pass of the render pass prefab that you created.
            var groupRenderPass = groupRenderPassPrefab.RootRenderPass;
 
            // Get the Clear Render Pass render pass type.
            var clearRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.ClearRenderPass);
            // Create a Clear Render Pass in the Group Render Pass that you created.
            var clearRenderPass = studio.ActiveProject.CreateRenderPass(
                groupRenderPass.GenerateUniqueChildName("Clear Render Pass"), groupRenderPass, clearRenderPassType);
 
            // Get the Gather Lights Render Pass render pass type.
            var gatherLightsRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.GatherLightsRenderPass);
            // Create a Gather Lights Render Pass in the Group Render Pass that you created.
            var gatherLightsRenderPass = studio.ActiveProject.CreateRenderPass(
                groupRenderPass.GenerateUniqueChildName("Gather Lights Render Pass"), groupRenderPass, gatherLightsRenderPassType);
 
            // Get the Draw Objects Render Pass render pass type.
            var drawObjectsRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.DrawObjectsRenderPass);
            // Create a Draw Objects Render Pass in the Gather Lights Render Pass that you created.
            var drawObjectsRenderPass = studio.ActiveProject.CreateRenderPass(
                gatherLightsRenderPass.GenerateUniqueChildName("Draw Objects Render Pass"), gatherLightsRenderPass, drawObjectsRenderPassType);
 
            // Get the Screens/Screen/RootNode/Viewport 2D node.
            var viewportNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D");
            // Set the Render Pass Prefab property of the Viewport 2D node to the render pass prefab that you created.
            viewportNode.Set(Properties.Viewport2DRenderPassPrefab.Name, groupRenderPassPrefab);
        }

To create render passes which render to a composition target and draw that to the screen use this code snippet.
In the Visual Studio solution of your plugin, in the Solution Explorer right-click the project name, select Add Reference, and add the reference to the PresentationCore assembly. Your plugin uses this assembly to define the color you use to set the Clear Color property for a Clear Render Pass.

        // This example creates a render pass prefab that contains this hierarchy of render passes:
        // - Group Render Pass
        //     - Composition Target Render Pass
        //         - Clear Render Pass which clears the color buffer with transparent black color
        //         - Gather Lights Render Pass which collects the light nodes
        //             - Draw Objects Render Pass which draws all content
        //     - Blit Render Pass which draws the Composition Target Render Pass to the screen
        // It then creates a Sphere node in the Screens/Screen/RootPage/Viewport 2D/Scene node and 
        // sets Kanzi Studio to render the Viewport 2D node using the render pass prefab.
        // You can create this render pass hierarchy also by using the 
        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Group Render Pass render pass type.
            var groupRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.RenderPass);
            // Create a Group Render Pass render pass prefab in the Library > Rendering > Render Pass Prefabs.
            var groupRenderPassPrefab = studio.ActiveProject.CreateRenderPassPrefab(
                studio.ActiveProject.GenerateUniqueChildName("Group Render Pass"), groupRenderPassType);
            // Get the root render pass of the render pass prefab that you created.
            var groupRenderPass = groupRenderPassPrefab.RootRenderPass;
 
            // Get the Composition Target Render Pass render pass type.
            var compositionTargetRenderPassType
                = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.CompositionTargetRenderPass);
            // Create a Composition Target Render Pass in the Group Render Pass that you created.
            var compositionTargetRenderPass = studio.ActiveProject.CreateRenderPass(
                groupRenderPass.GenerateUniqueChildName("Composition Target Render Pass"), groupRenderPass, compositionTargetRenderPassType);
 
            // Get the Clear Render Pass render pass type.
            var clearRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.ClearRenderPass);
            // Create a Clear Render Pass in the Composition Target Render Pass that you created.
            var clearRenderPass = studio.ActiveProject.CreateRenderPass(
                compositionTargetRenderPass.GenerateUniqueChildName("Clear Render Pass"), compositionTargetRenderPass, clearRenderPassType);
            // In the Clear Render Pass add the Clear Color 0 property and set it to transparent black.
            clearRenderPass.Set(
                clearRenderPass.PropertyTypes.ClearRenderPassClearColor0, System.Windows.Media.Color.FromArgb(0, 0, 0, 0));
 
            // Get the Gather Lights Render Pass render pass type.
            var gatherLightsRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.GatherLightsRenderPass);
            // Create a Gather Lights Render Pass in the Composition Target Render Pass that you created.
            var gatherLightsRenderPass = studio.ActiveProject.CreateRenderPass(
                compositionTargetRenderPass.GenerateUniqueChildName("Gather Lights Render Pass"), compositionTargetRenderPass, gatherLightsRenderPassType);
 
            // Get the Draw Objects Render Pass render pass type.
            var drawObjectsRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.DrawObjectsRenderPass);
            // Create a Draw Objects Render Pass in the Gather Lights Render Pass that you created.
            studio.ActiveProject.CreateRenderPass(
                gatherLightsRenderPass.GenerateUniqueChildName("Draw Objects Render Pass"), gatherLightsRenderPass, drawObjectsRenderPassType);
 
            // Get the Blit Render Pass render pass type.
            var blitRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.BlitRenderPass);
            // Create a Blit Render Pass in the Group Render Pass that you created.
            var blitRenderPass = studio.ActiveProject.CreateRenderPass(
                groupRenderPass.GenerateUniqueChildName("Blit Render Pass"), groupRenderPass, blitRenderPassType);
 
            // Bind the Texture 0 property of the Blit Render Pass to the Result Texture 0 property of the Composition Target Render Pass.
            blitRenderPass.CreateBinding(
                Properties.BlitRenderPassTexture0,
                AnimationTargetPropertyAttributeEnum.WHOLE_PROPERTY,
                "{@../Composition Target Render Pass/CompositionTargetRenderPass.ResultTexture0}");
 
            // Get the Screens/Screen/RootNode/Viewport 2D/Scene node.
            var sceneNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D/Scene");
            // Create a Sphere node in the Scene node.
            studio.ActiveProject.CreateProjectItem<SphereMeshNode>(sceneNode.GenerateUniqueChildName("Sphere"), sceneNode);
 
            // Get the Screens/Screen/RootNode/Viewport 2D node.
            var viewportNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D");
            // Set the Render Pass Prefab property of the Viewport 2D node to the render pass prefab that you created.
            viewportNode.Set(Properties.Viewport2DRenderPassPrefab.Name, groupRenderPassPrefab);
        }

◆ CreateRenderPassPrefab()

RenderPassPrefab CreateRenderPassPrefab	(	string	name,
		RenderPassType	renderPassType )

Creates a render pass prefab.

Use this function to create render pass prefabs in the Render Pass Prefabs library of a Kanzi Studio project.

Parameters

name	The name of the render pass prefab.
renderPassType	The type of the render pass. RenderPassTypeLibrary stores the render pass types available in a Kanzi Studio project.

Returns: The render pass prefab you create with this function.

See also: CreateRenderPass, RenderPassTypeLibrary, ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a render pass prefab that contains a basic set of render passes which first clear depth and then draw all the content of the scene:

        // This example creates a render pass prefab that contains this hierarchy of render passes:
        // - Group Render Pass
        //     - Clear Render Pass
        //     - Gather Lights Render Pass
        //         - Draw Objects Render Pass
        // It then sets Kanzi Studio to render the Screens/Screen/RootNode/Viewport 2D node using the Group Render Pass.
        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Group Render Pass render pass type.
            var groupRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.RenderPass);
            // Create a Group Render Pass render pass prefab in the Library > Rendering > Render Pass Prefabs.
            var groupRenderPassPrefab = studio.ActiveProject.CreateRenderPassPrefab(
                studio.ActiveProject.GenerateUniqueChildName("Group Render Pass"), groupRenderPassType);
            // Get the root render pass of the render pass prefab that you created.
            var groupRenderPass = groupRenderPassPrefab.RootRenderPass;
 
            // Get the Clear Render Pass render pass type.
            var clearRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.ClearRenderPass);
            // Create a Clear Render Pass in the Group Render Pass that you created.
            var clearRenderPass = studio.ActiveProject.CreateRenderPass(
                groupRenderPass.GenerateUniqueChildName("Clear Render Pass"), groupRenderPass, clearRenderPassType);
 
            // Get the Gather Lights Render Pass render pass type.
            var gatherLightsRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.GatherLightsRenderPass);
            // Create a Gather Lights Render Pass in the Group Render Pass that you created.
            var gatherLightsRenderPass = studio.ActiveProject.CreateRenderPass(
                groupRenderPass.GenerateUniqueChildName("Gather Lights Render Pass"), groupRenderPass, gatherLightsRenderPassType);
 
            // Get the Draw Objects Render Pass render pass type.
            var drawObjectsRenderPassType = studio.ActiveProject.RenderPassTypeLibrary.GetItemByName(RenderPassTypeNames.DrawObjectsRenderPass);
            // Create a Draw Objects Render Pass in the Gather Lights Render Pass that you created.
            var drawObjectsRenderPass = studio.ActiveProject.CreateRenderPass(
                gatherLightsRenderPass.GenerateUniqueChildName("Draw Objects Render Pass"), gatherLightsRenderPass, drawObjectsRenderPassType);
 
            // Get the Screens/Screen/RootNode/Viewport 2D node.
            var viewportNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D");
            // Set the Render Pass Prefab property of the Viewport 2D node to the render pass prefab that you created.
            viewportNode.Set(Properties.Viewport2DRenderPassPrefab.Name, groupRenderPassPrefab);
        }

◆ CreateStudioPluginItem()

StudioPluginItem CreateStudioPluginItem	(	string	name,
		[CanBeNull] StudioPluginItem	parent,
		[CanBeNull] string	logicFactoryName )

Creates a studio plugin item.

Parameters

name	The name of the studio plugin item.
parent	The parent studio plugin item, or null to create at the root of the library.
logicFactoryName	The name of the logic factory, or null.

Returns: The studio plugin item you create with this function.

See also: StudioPluginItemLibrary

◆ GetPreviewConfiguration()

PreviewConfiguration? GetPreviewConfiguration ( )

Gets the Preview application configuration that Kanzi Studio currently uses.

If Kanzi Studio cannot find the build configuration set by the user, Kanzi Studio uses the next available build configuration. The Preview application configuration is not always the same as the one that the user sets in the properties of their Kanzi Studio project. To get the Preview application configuration set by the user, get the values of PreviewDebugReleaseConfiguration and PreviewVisualStudioVersion properties.

Returns: The Preview application configuration that Kanzi Studio currently uses.

◆ GetProjectItem()

ProjectItem GetProjectItem ( string projectItemPath )

Gets a project item.

For example, use this function to get a node in the node tree and then add child nodes to it, or add, set, and modify the values of the node properties.

Parameters

projectItemPath The path to the project item you want to get.

Returns: The project item at the path you pass to the function.

Examples

To get a project item:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the RootNode node in the node tree.
            var rootNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode");
        }

◆ GetProjectItemByKzbUrl()

ProjectItem GetProjectItemByKzbUrl	(	string	kzbUrl,
		bool	searchFromReferencedProjects )

Gets a project item by its kzb URL.

Parameters

kzbUrl	The kzb URL of the project item.
searchFromReferencedProjects	Whether to search in referenced projects.

Returns: The project item if found, otherwise null.

◆ GetReferringItemsKzbNames()

IEnumerable< string > GetReferringItemsKzbNames ( string propertyTypeName )

Gets the kzb names of items that refer to the specified property type.

Parameters

propertyTypeName The name of the property type.

Returns: A collection of kzb names of items that refer to the property type.

◆ IsAbstract()

bool IsAbstract ( Type projectItemType )

Checks whether a project item type is abstract and cannot be instantiated directly.

Parameters

projectItemType The type to check.

Returns: True if the type is abstract, otherwise false.

Property Documentation

◆ ActiveComposition

ProjectItem ActiveComposition

get

Gets the currently active composition in Kanzi Studio.

See also: ActiveCompositionChanged

◆ AnimationClipLibrary

AnimationClipLibrary AnimationClipLibrary

get

Gets the Animation Clips library which stores animation clips in a Kanzi Studio project.

◆ AnimationLibrary

AnimationLibrary AnimationLibrary

get

Gets the Animation Data library which stores all animations in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

Examples

To create an animation in the Animation Data library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Animations > Animation Data library which stores all animations in a Kanzi Studio project.
            var animationLibrary = studio.ActiveProject.AnimationLibrary;
            // In the Animation Data library create an Animation named My Animation.
            var animation = studio.ActiveProject.CreateProjectItem<Animation>(
                animationLibrary.GenerateUniqueChildName("My Animation"), animationLibrary);
            // In the My Animation animation set Target Property to Node3D.RenderTransformation.
            animation.Set(animation.PropertyTypes.AnimationTargetPropertyName, Properties.Node3DRenderTransformation);
            // In the My Animation animation set Property Attribute to Translation Y.
            animation.Set(animation.PropertyTypes.AnimationTargetPropertyAttribute, AnimationTargetPropertyAttributeEnum.TRANSLATION_Y);
        }

◆ ApplicationDirectory

ApplicationConfigurationResourceFileDirectory ApplicationDirectory

get

Gets the Application directory which contains the application configuration files in a Kanzi Studio project.

◆ Asset3DImportSourceDirectory

Asset3DImportSourceDirectory Asset3DImportSourceDirectory

get

Gets the directory which contains the 3D asset import source files in a Kanzi Studio project.

◆ BinaryExportDirectory

string BinaryExportDirectory

get

Gets the directory path where Kanzi Studio exports the kzb binary files.

◆ BrushLibrary

BrushLibrary BrushLibrary

get

Gets the Brushes library which stores brushes used in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

The Brushes library in a Kanzi Studio project.

See also: CreateBrush(string, BrushLibrary, BrushType), CreateBrush(string, BrushLibrary, BrushTypeEnum), BrushTypeLibrary, ProjectItemLibrary<T>.GetItemByName(string)

Examples

To get a brush from the Brushes library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Brushes library which stores brushes used in a Kanzi Studio project.
            var brushesLibrary = studio.ActiveProject.BrushLibrary;
            // Get the DefaultBackground texture brush from the Brushes library.
            var defaultBackground = brushesLibrary.GetItemByName("DefaultBackground");
        }

◆ BrushTypeLibrary

BrushTypeLibrary BrushTypeLibrary

get

Gets the brush types available in a Kanzi Studio project.

See also: CreateBrush(string, BrushLibrary, BrushType), BrushLibrary, ProjectItemLibrary<T>.Items

Examples

To get the brush types available in a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Brush Type library which stores the brush type available in a Kanzi Studio project.
            var brushTypeLibrary = studio.ActiveProject.BrushTypeLibrary;
            // Print the available brush types to the Kanzi Studio Log window.
            studio.Log("These brush types are available in this Kanzi Studio project:");
            foreach (var brushType in brushTypeLibrary.Items)
            {
                studio.Log(brushType.Name);
            }
        }

◆ ComponentTypeLibrary

ComponentTypeLibrary ComponentTypeLibrary

get

Gets the component node types available in a Kanzi Studio project.

See also: CreateComponentNode(string, Node, ComponentType)

Examples

To get the available component node types:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the component type library.
            var componentTypeLibrary = studio.ActiveProject.ComponentTypeLibrary;
            // Print the available component node types to the Kanzi Studio Log window.
            studio.Log("These component nodes are available in this Kanzi Studio project:");
            foreach (var componentType in componentTypeLibrary.Items)
            {
                studio.Log(componentType.Name);
            }
        }

◆ DataSourceLibrary

DataSourceLibrary DataSourceLibrary

get

Gets the Data Sources library which stores data sources in a Kanzi Studio project.

See also: DataSourceTypeLibrary, CreateDataSource

◆ DataSourceTypeLibrary

DataSourceTypeLibrary DataSourceTypeLibrary

get

Gets the Data Source Types library which stores data source types in a Kanzi Studio project.

See also: DataSourceLibrary, CreateDataSource

◆ EnginePluginLibrary

EnginePluginLibrary EnginePluginLibrary

get

Gets the Engine Plugins library which stores engine plugin references in a Kanzi Studio project.

◆ FontDirectory

FontDirectory FontDirectory

get

Gets the Fonts directory which contains the fonts in a Kanzi Studio project.

After you get the directory, you can access and import fonts.

See also: FontFamilyLibrary

Examples

To import a font file to the Fonts directory and add that font file to a Font Family:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Resource Files > Fonts directory which stores all the font files
            // in a Kanzi Studio project.
            var fontDirectory = studio.ActiveProject.FontDirectory;
 
            // Import the C:\\Temp\exo2-medium.ttf font file to the Fonts directory and add the imported file
            // to the Library > Font Families > Exo 2 font family. If the Exo 2 font family does not exist,
            // Kanzi Studio creates it.
            studio.Commands.ImportFont(fontDirectory, "C:\\Temp\\exo2-medium.ttf");
        }

◆ FontFamilyLibrary

FontFamilyLibrary FontFamilyLibrary

get

Gets the Font Families library which contains the font families in a Kanzi Studio project.

After you get the library, you can access and create font families.

See also: FontDirectory

Examples

To create a function that creates a Font Family and adds to it a font file:

        // Create a function that creates a Font Family and includes in that Font Family
        // the font file that you pass to this function.
        private void CreateFontFamily(string name, FontFile fontFile)
        {
            // Get the Font Families library which stores the font families in a Kanzi Studio project.
            var fontFamilyLibrary = studio.ActiveProject.FontFamilyLibrary;
 
            // Create a Font Family in the Font Families library.
            var fontFamily = studio.ActiveProject.CreateProjectItem<FontFamily>(
                fontFamilyLibrary.GenerateUniqueChildName(name), fontFamilyLibrary);
 
            // Create a list of font files which contains the font file that you pass to this function.
            var fontFiles = new List<FontFile>(new FontFile[] { fontFile });
 
            // Set the Font Files property of the Font Family to the font file that you pass to this function.
            fontFamily.Set(fontFamily.PropertyTypes.FontFiles, fontFiles);
 
            var arabFontFamily = studio.ActiveProject.CreateProjectItem<FontFamily>(
                fontFamilyLibrary.GenerateUniqueChildName("Arabic Font Family"), fontFamilyLibrary);
 
            var emojiFontFamily = studio.ActiveProject.CreateProjectItem<FontFamily>(
                fontFamilyLibrary.GenerateUniqueChildName("Emoji Font Family"), fontFamilyLibrary);
 
            // Create a list of Font Families that you pass as fallbacks to the Font Family.
            var fallbackFontFamilyChain = new List<FontFamily>(new FontFamily[] { arabFontFamily, emojiFontFamily });
 
            // Set the Fallback Font Family Chain property of the Font Family to the list of Font Families you want to use as fallbacks.
            fontFamily.Set(fontFamily.PropertyTypes.FallbackFontFamilyChain, fallbackFontFamilyChain);
        }

◆ GenericResourceFileDirectory

GenericResourceFileDirectory GenericResourceFileDirectory

get

Gets the Generic directory which contains the generic resource files in a Kanzi Studio project.

After you get the directory, you can access and import files.

Examples

To import a text file to the Generic directory:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Resource Files > Generic directory which stores
            // all the generic resource files in a Kanzi Studio project.
            var genericResourceDirectory = studio.ActiveProject.GenericResourceFileDirectory;
 
            // Import the C:\\Temp\MyFile.xml file to the Generic directory.
            // To import multiple files, use commas to separate the file locations.
            // You set the last parameter as null because you do not want to import the file to the Textures library.
            studio.Commands.ImportResources(new List<string> { "C:\\Temp\\MyFile.xml" }, genericResourceDirectory, null);
        }

◆ Guides

IEnumerable<Guide> Guides

get

Gets the guides in a Kanzi Studio project.

Examples

To get the guides in a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the guides in a Kanzi Studio project.
            var guides = studio.ActiveProject.Guides;
            // Print the name and position of all guides in your project to the Kanzi Studio Log window.
            studio.Log("This Kanzi Studio project contains these guides:");
            foreach (var guide in guides)
            {
                studio.Log(guide.Name + ": " + guide.Get(Properties.GuidePosition));
            }
        }

To create a guide:

        public void Execute(PluginCommandParameter parameter)
        {
            // Create a guide named VerticalGuide100.
            var verticalGuide = studio.ActiveProject.CreateProjectItem<Guide>("VerticalGuide100", null);
            // Set the position of the guide on the x axis to 100.
            // Note that to create a Vector data type you need to add the using directive for the System.Windows. 
            verticalGuide.Set(Properties.GuidePosition, new Vector(100, 0));
            // To create a vertical guide, set the Rotation property to 1,5708 radians (90 degrees).
            verticalGuide.Set(Properties.GuideRotation, (float)Math.PI / 2);
        }

◆ ImageDirectory

ImageDirectory ImageDirectory

get

Gets the Images directory which contains the image files in a Kanzi Studio project.

See also: TextureLibrary, CreateBrush(string, BrushLibrary, BrushType)

Examples

To get an image file in the Images directory of a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Images directory which contains the image files in a Kanzi Studio project. 
            var imageDirectory = studio.ActiveProject.ImageDirectory;
            // Get an image file in the Images directory.
            var imageFile = imageDirectory.Children.OfType<ImageFile>().First();
            // Print the path to the Images directory to the Kanzi Studio Log window.
            studio.Log("The image files of this project are stored in " + imageFile.FileSystemParentDirectory);
        }

To import an image to the Images directory:

        public void Execute(PluginCommandParameter parameter)
        {
            // Import the C:\\Temp\MyImage.png file to the Library > Resource Files > Images directory
            // and create a Single Texture that uses this image. To import an image without creating a texture, 
            // set the third parameter of the ImportImages command to false.
            studio.Commands.ImportImages(studio.ActiveProject, "C:\\Temp\\MyImage.png", true);
        }

◆ IsJavaProject

bool IsJavaProject

get

Gets whether this project is a Java-based project.

◆ IsNewlyCreatedProject

bool IsNewlyCreatedProject

get

Gets whether this is a newly created project that has not been saved yet.

◆ IsSDKProject

bool IsSDKProject

get

Checks whether this Kanzi Studio project follows the folder structure of a project that uses application code.

If the project follows the folder structure of a project that uses application code, true, otherwise false.

◆ LocaleLibrary

LocaleLibrary LocaleLibrary

get

Gets the Locales library which stores locales in a Kanzi Studio project.

◆ MaterialLibrary

MaterialLibrary MaterialLibrary

get

Gets the Materials library which contains the materials in a Kanzi Studio project.

After you get the library, you can access and create materials.

See also: MaterialTypeLibrary, CreateProjectItem<T>(string, ProjectItem), ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a material in the Materials library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Materials and Textures > Material Types library
            // which stores all the material types in a Kanzi Studio project.
            var materialTypeLibrary = studio.ActiveProject.MaterialTypeLibrary;
            // In the Material Types library create a Material Type named MyMaterialType.
            var myMaterialType = studio.ActiveProject.CreateProjectItem<MaterialType>(
                materialTypeLibrary.GenerateUniqueChildName("MyMaterialType"), materialTypeLibrary);
 
            // Get the Library > Materials and Textures > Materials library
            // which stores all the materials in a Kanzi Studio project.
            var materialLibrary = studio.ActiveProject.MaterialLibrary;
            // In the Materials library create a material named MyMaterialTypeMaterial.
            var myMaterial = studio.ActiveProject.CreateProjectItem<Material>(
                materialLibrary.GenerateUniqueChildName(myMaterialType.Name + "Material"), materialLibrary);
            // Set the Material Type property of MyMaterialTypeMaterial to MyMaterialType.
            myMaterial.Set(myMaterial.PropertyTypes.MaterialType.Name, materialTypeLibrary.GetItemByName(myMaterialType.Name));
        }

◆ MaterialTypeLibrary

MaterialTypeLibrary MaterialTypeLibrary

get

Gets the Material Types library which contains the material types in a Kanzi Studio project.

After you get the library, you can access and create material types.

See also: MaterialLibrary, ShaderSourceDirectory, CreateProjectItem<T>(string, ProjectItem), ProjectItemLibrary<T>.Items

Examples

To get all material types in the Material Types library of a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Materials and Textures > Material Types library
            // which stores all the material types in a Kanzi Studio project.
            var materialTypeLibrary = studio.ActiveProject.MaterialTypeLibrary;
 
            // Print the name of all material types in your project to the Kanzi Studio Log window.
            studio.Log("This Kanzi Studio project contains these material types:");
            foreach (var materialType in materialTypeLibrary.Items)
            {
                studio.Log(materialType.Name);
            }
        }

To create a function that creates a material type from vertex and fragment shaders:

        // Create a function that creates a Material Type and takes as its input the paths to the files
        // that contain the vertex and fragment shaders for this material type.
        private void CreateMaterialType(string name, string vertexShaderPath, string fragmentShaderPath)
        {
            // Create a Material Type in the Library > Materials and Textures > Material Types library.
            var materialTypeLibrary = studio.ActiveProject.MaterialTypeLibrary;
            var materialType = studio.ActiveProject.CreateProjectItem<MaterialType>(
                materialTypeLibrary.GenerateUniqueChildName(name), materialTypeLibrary);
 
            // Set the material type you created to use the vertex shader that you pass to the function.
            // Read the content of the file which contains the vertex shader code that you want to use.
            // To use this function, in the class library file that implements the PluginCommand interface
            // add the using directive for the System.IO namespace.
            string vertexShaderSource = File.ReadAllText(vertexShaderPath);
            // Get the vertex shader of the material type you created.
            var vertexShader = materialType.Children.OfType<VertexShader>().First();
            // Get the vertex shader source file.
            var vertexShaderSourceFile = vertexShader.Get(vertexShader.PropertyTypes.ShaderSourceFile);
            // Get the path to the vertex shader source file.
            var vertexShaderSourceFileFileSystemPath = vertexShaderSourceFile.FileSystemPath;
            if (File.Exists(vertexShaderSourceFileFileSystemPath))
            {
                // Replace the content of the existing vertex shader with the vertex shader you pass to the function.
                File.WriteAllText(vertexShaderSourceFileFileSystemPath, vertexShaderSource);
            }
 
            // Set the material type you created to use the fragment shader you pass to the function.
            // Use the same approach you used to set the vertex shader.
            string fragmentShaderSource = File.ReadAllText(fragmentShaderPath);
            var fragmentShader = materialType.Children.OfType<FragmentShader>().First();
            var fragmentShaderSourceFile = fragmentShader.Get(fragmentShader.PropertyTypes.ShaderSourceFile);
            var fragmentShaderSourceFileFileSystemPath = fragmentShaderSourceFile.FileSystemPath;
            if (File.Exists(fragmentShaderSourceFileFileSystemPath))
            {
                File.WriteAllText(fragmentShaderSourceFileFileSystemPath, fragmentShaderSource);
            }
 
            // Create a material which uses the material type you created.
            var materialLibrary = studio.ActiveProject.MaterialLibrary;
            var material = studio.ActiveProject.CreateProjectItem<Material>(
                materialLibrary.GenerateUniqueChildName(name + "Material"), materialLibrary);
            material.Set(material.PropertyTypes.MaterialType, materialType);
        }

◆ MeshLibrary

MeshLibrary MeshLibrary

get

Gets the Meshes library which contains the meshes in a Kanzi Studio project.

See also: ProjectItemLibrary<T>.Items

Examples

To get the meshes in a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Meshes library which stores all the meshes in a Kanzi Studio project.
            var meshLibrary = studio.ActiveProject.MeshLibrary;
            // If the project contains meshes, print their names and the number of meshes in the Kanzi Studio Log window.
            if (meshLibrary.Items.Any())
            {
                var count = meshLibrary.Items.Count().ToString();
                studio.Log("This Kanzi Studio project contains " + count + " meshes:");
                foreach (var mesh in meshLibrary.Items)
                {
                    studio.Log(mesh.Name);
                }
            }
            else
            {
                studio.Log("This Kanzi Studio project does not contain meshes.");
            }
        }

◆ MessageTypeLibrary

MessageTypeLibrary MessageTypeLibrary

get

Gets the message types available in a Kanzi Studio project.

See also: ProjectItemLibrary<T>.Items

Examples

To get the message types available in a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Message Type Library which stores all the message types in a Kanzi Studio project.
            var messageTypeLibrary = studio.ActiveProject.MessageTypeLibrary;
            // Print the available message types to the Kanzi Studio Log window.
            studio.Log("These message types are available in this Kanzi Studio project:");
            foreach (var messageType in messageTypeLibrary.Items)
            {
                studio.Log(messageType.Name);
            }
        }

◆ NodeComponentTypeLibrary

NodeComponentTypeLibrary NodeComponentTypeLibrary

get

Gets the node component types available in a Kanzi Studio project.

See also: CreateNodeComponent, NodeComponentHost, ProjectItemLibrary<T>.Items

Examples

To get the node component types available in Kanzi:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the node component type library.
            var nodeComponentsLibrary = studio.ActiveProject.NodeComponentTypeLibrary;
            // Print the available node component types to the Kanzi Studio Log window.
            studio.Log("These node component types are available in this Kanzi Studio project:");
            foreach (var nodeComponentType in nodeComponentsLibrary.Items)
            {
                studio.Log(nodeComponentType.Name);
            }
        }

◆ NodeEffectPrefab2DLibrary

NodeEffectPrefab2DLibrary NodeEffectPrefab2DLibrary

get

Gets the 2D Effects library which stores the 2D effects in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

See also: NodeEffectType2DLibrary, CreateNodeEffectPrefab2D(string, NodeEffectType2D), CreateNodeEffect2D(string, INodeEffect2DContainer, NodeEffectType2D)

Examples

To get the 2D effects in a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Node Effect Prefab library which stores the 2D effects in a Kanzi Studio project.
            var nodeEffectPrefabLibrary = studio.ActiveProject.NodeEffectPrefab2DLibrary;
            // Print the name of each node effect prefab root to the Kanzi Studio Log window.
            foreach (var nodeEffect in nodeEffectPrefabLibrary.Items)
            {
                studio.Log(nodeEffect.Name);
            }
        }

◆ NodeEffectType2DLibrary

NodeEffectType2DLibrary NodeEffectType2DLibrary

get

Gets the 2D effect types available in a Kanzi Studio project.

See also: CreateNodeEffect2D(string, INodeEffect2DContainer, NodeEffectType2D), ProjectItemLibrary<T>.Items

Examples

To get the 2D effect types available in Kanzi:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the node effect type library.
            var nodeEffectTypeLibrary = studio.ActiveProject.NodeEffectType2DLibrary;
            // Print the available effect types to the Kanzi Studio Log window.
            studio.Log("These 2D effect types are available in this Kanzi Studio project:");
            foreach (var nodeEffectType in nodeEffectTypeLibrary.Items)
            {
                studio.Log(nodeEffectType.Name);
            }
        }

◆ PageTransitionCollectionLibrary

PageTransitionCollectionLibrary PageTransitionCollectionLibrary

get

Gets the Page Transitions library which contains the page transitions in a Kanzi Studio project.

After you get the library, you can access and create page transitions.

Examples

To create and configure a page transition:

        // This example creates a Fade Transition which animates the opacity of the Page nodes
        // between which the transition happens.
        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Page Transitions library which stores the page transitions in a Kanzi Studio project.
            var pageTransitionsLibrary = studio.ActiveProject.PageTransitionCollectionLibrary;
 
            // Create a Page Transition Collection named My Transition Collection in the Page Transitions library.
            var myTransitionCollection = studio.ActiveProject.CreateProjectItem<PageTransitionCollection>(
                pageTransitionsLibrary.GenerateUniqueChildName("My Transition Collection"),
                pageTransitionsLibrary);
 
            // Get the RootNode node in the Screens/Screen node.
            var rootNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode");
 
            // Create a Page Host node named RootPage in the RootNode node.
            var rootPage = studio.ActiveProject.CreateProjectItem<PageHost>(rootNode.GenerateUniqueChildName("RootPage"), rootNode);
 
            // Set the Transition property of the RootPage node to My Transition Collection.
            // This way you set the RootPage node to use the page transitions in My Transition Collection.
            rootPage.Set(rootPage.PropertyTypes.PageHostTransitions.Name, myTransitionCollection);
 
            // Create three Page nodes in the RootPage node. In each Page node create a Text Block 2D node and 
            // set the Text property of the Text Block 2D node to the name of its parent Page node.
            for (var i = 1; i <= 3; i++)
            {
                var page = studio.ActiveProject.CreateProjectItem<Page>(
                    rootPage.GenerateUniqueChildName("Page"),
                    rootPage);
                var textBlock = studio.ActiveProject.CreateProjectItem<TextBlock2D>(
                    page.GenerateUniqueChildName("Text Block 2D"),
                    page);
                textBlock.Set(textBlock.PropertyTypes.TextConceptText, page.Name);
            }
 
            // Get the Page node named Page in the RootPage node.
            var pageNode = rootPage.GetChild<Page>("Page");
 
            // Set the Default Subpage property of the RootPage node to the Page node.
            rootPage.Set(rootPage.PropertyTypes.PageHostDefaultSubPage, new NodeReference<Node2D>(pageNode));
 
            // Create a Page Transition named Fade Transition in My Transition Collection.
            var fadeTransition = studio.ActiveProject.CreateProjectItem<PageTransition>(
                myTransitionCollection.GenerateUniqueChildName("Fade Transition"),
                myTransitionCollection);
 
            // Configure the Fade Transition:
 
            // Set the Duration property to 200. This way you set the length of the transition to 200 ms.
            fadeTransition.Set(fadeTransition.PropertyTypes.PageTransitionDuration, 200);
 
            // Set the From property to the node named Page. 
            // This way you make the transition apply only when navigating from the node named Page.
            fadeTransition.Set(fadeTransition.PropertyTypes.PageTransitionFrom, pageNode.Name);
 
            // Set the To property to *. This way you apply the transition when navigating to all Page nodes.
            fadeTransition.Set(fadeTransition.PropertyTypes.PageTransitionTo, "*");
 
            // Set the Direction property to Unidirectional. 
            // Use the Direction property to set whether the transition applies to the transition 
            // from the nodes you set in the From property to the nodes you set in the To property,
            // or to the transitions from both nodes.
            // To set the Direction property of a Page Transition:
            // - For Bidirectional use 0. 
            //   This way you apply the transition to the transition from the nodes in the From property to
            //   the nodes in the To property, and from the nodes in the To property to the nodes in the From property.
            // - For Unidirectional use 1. 
            //   This way you apply the transition only to the transition from the nodes in the From property
            //   to the nodes in the To property.
            fadeTransition.Set(fadeTransition.PropertyTypes.PageTransitionDirection, 1);
 
            // Create a Page Transition Animation named Opacity In.
            var fadeTransitionInAnimation = studio.ActiveProject.CreateProjectItem<PageTransitionAnimation>(
                fadeTransition.GenerateUniqueChildName("Opacity In"),
                fadeTransition);
 
            // Configure the Opacity In animation:
 
            // Set the Animation Target property to Page In.
            // To set the Animation Target property of a Page Transition Animation:
            // - For Page In use 0.
            //   This way you use the animation when navigating to the set Page or Page Host node.
            // - For Page Out use 1.
            //   This way you use the animation when navigating from the set Page or Page Host node.
            fadeTransitionInAnimation.Set(
                fadeTransitionInAnimation.PropertyTypes.PageTransitionAnimationAnimationTarget, 0);
 
            // Set the Transition Property to Node.Opacity. This way you animate the Opacity property.
            fadeTransitionInAnimation.Set(
                fadeTransitionInAnimation.PropertyTypes.PageTransitionAnimationPropertyType,
                Properties.NodeOpacity);
 
            // Set the Start Value property to 0.
            // This way you set the value of the Transition Property to 0 when the transition animation starts.
            fadeTransitionInAnimation.Set(
                fadeTransitionInAnimation.PropertyTypes.PageTransitionAnimationStartValue, "0");
 
            // Set the End Value property to 1.
            // This way you set the value of the Transition Property to 1 when the transition animation ends.
            fadeTransitionInAnimation.Set(
                fadeTransitionInAnimation.PropertyTypes.PageTransitionAnimationEndValue, "1");
 
            // Create a Page Transition Animation named Opacity Out.
            var fadeTransitionOutAnimation = studio.ActiveProject.CreateProjectItem<PageTransitionAnimation>(
                fadeTransition.GenerateUniqueChildName("Opacity Out"),
                fadeTransition);
 
            // Configure the Opacity Out animation:
 
            // Set the Animation Target property to Page Out.
            fadeTransitionOutAnimation.Set(
                fadeTransitionOutAnimation.PropertyTypes.PageTransitionAnimationAnimationTarget, 1);
 
            // Set the Transition Property to Node.Opacity.
            fadeTransitionOutAnimation.Set(
                fadeTransitionInAnimation.PropertyTypes.PageTransitionAnimationPropertyType,
                Properties.NodeOpacity);
 
            // Set the Start Value property to 1.
            fadeTransitionOutAnimation.Set(
                fadeTransitionInAnimation.PropertyTypes.PageTransitionAnimationStartValue, "1");
 
            // Set the End Value property to 0.
            fadeTransitionOutAnimation.Set(
                fadeTransitionInAnimation.PropertyTypes.PageTransitionAnimationEndValue, "0");
        }

◆ PipelineItemLibrary

PipelineItemLibrary PipelineItemLibrary

get

Gets the Object Sources library which contains the object sources and filters in a Kanzi Studio project.

After you get the library, you can access and create object sources and filters.

See also: TagLibrary

Examples

To create a Tag Filter:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Object Sources library in Library > Rendering which stores
            // the object sources and filters in a Kanzi Studio project.
            var pipeLineItemLibrary = studio.ActiveProject.PipelineItemLibrary;
 
            // Create a Tag Filter named My Tag Filter in the Object Sources library.
            var myTagFilter = studio.ActiveProject.CreateProjectItem<TagFilterObjectSource>(
                pipeLineItemLibrary.GenerateUniqueChildName("My Tag Filter"),
                pipeLineItemLibrary);
 
            // Get the Tags library which stores tags used in a Kanzi Studio project.
            var tagsLibrary = studio.ActiveProject.TagLibrary;
 
            // Create a tag named My Tag in the Tags library.
            var myTag = studio.ActiveProject.CreateProjectItem<Tag>(
                tagsLibrary.GenerateUniqueChildName("My Tag"), tagsLibrary);
 
            // Create a list of tags which contains the My Tag tag.
            var tagList = new List<Tag>(new Tag[] { myTag });
 
            // Set the Included Tags property of the My Tag Filter to My Tag.
            // This way you set the filter to pick the nodes that have the My Tag tag.
            myTagFilter.Set(myTagFilter.PropertyTypes.TagFilterIncludeList, tagList);
        }

◆ PrefabLibrary

PrefabLibrary PrefabLibrary

get

Gets the Prefabs library which contains the prefabs used in a Kanzi Studio project.

After you get the library, you can access and create prefabs.

The Prefabs library in a Kanzi Studio project.

See also: CreateProjectItem<T>(string, ProjectItem), CreateProjectItem(Type, string, ProjectItem), GetProjectItem(string)

Examples

To create a prefab in the Prefabs library and instantiate it:

        public void Execute(PluginCommandParameter parameter)
        {
            // Create a prefab template:
            // Get the Prefabs library which stores all the prefabs in a Kanzi Studio project.
            var prefabsLibrary = studio.ActiveProject.PrefabLibrary;
            // In the Prefabs library create a prefab template named My Prefab which can hold 3D nodes. 
            // For 2D nodes you have to create a 2D prefab template.
            var myPrefabTemplate = studio.ActiveProject.CreateProjectItem<Node3DPrefabTemplate>(
                prefabsLibrary.GenerateUniqueChildName("My Prefab"), prefabsLibrary);
            // Create an Empty Node 3D node named My Prefab as the root node of the prefab.
            var rootNode = studio.ActiveProject.CreateProjectItem<EmptyNode>(
                myPrefabTemplate.GenerateUniqueChildName(myPrefabTemplate.Name), myPrefabTemplate);
 
            // If the Empty Node 3D node is the root of a 3D prefab template
            // print to the Log a message about successful creation of the prefab template.
            if (rootNode.Parent.ProjectItemType == typeof(Node3DPrefabTemplate))
            {
                studio.Log("Created a prefab named " + rootNode.Name);
            }
 
            // Create in the prefab a child node:
            // Get the component type of the Button 3D node.
            var componentType = studio.ActiveProject.ComponentTypeLibrary.GetComponentType(ComponentTypeNames.Button3D);
            // Use the component type you just created to create a Button 3D node in the root node of My Prefab.
            var button = studio.ActiveProject.CreateComponentNode("Button 3D", rootNode, componentType);
 
            // Instantiate the prefab that you created:
            // Get the node where you want to instantiate the prefab.
            var instantiateHere = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D/Scene");
            // Create the Prefab Placeholder node which instantiates the prefab in the node tree.
            var prefabInstance = studio.ActiveProject.CreateProjectItem<Node3DPrefabPlaceholder>(
                instantiateHere.GenerateUniqueChildName("Placeholder"), instantiateHere);
            // Create a resource reference from the prefab template which you want to instantiate.
            var reference = new ResourceReference<Node3DPrefabTemplate>(myPrefabTemplate);
            // Instantiate the prefab you created by setting the Prefab Template property 
            // to the prefab template reference you created in the previous line.
            prefabInstance.Set(prefabInstance.PropertyTypes.Node3DPrefabPlaceholderTemplate, reference);
        }

◆ PreviewWorkingDirectory

string PreviewWorkingDirectory

get

Gets the working directory used by the Kanzi Studio Preview.

◆ ProjectReferenceLibrary

ProjectReferenceLibrary ProjectReferenceLibrary

get

Gets the Project References library which stores the project references and kzb file references in a Kanzi Studio project.

See also: ProjectItemLibrary<T>.Items

Examples

To convert all project references to kzb file references:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Project References library which stores all the project references and kzb file references in
            // a Kanzi Studio project, iterate through the items in the library, and convert each project reference 
            // to a kzb file reference.
            foreach (var reference in studio.ActiveProject.ProjectReferenceLibrary.Items.OfType<ProjectReferenceItem>())
            {
                studio.Commands.ConvertProjectReferenceItemToKzbReferenceItem(reference);
            }
        }

◆ PropertyTypes

new ProjectProperties PropertyTypes

get

Implements ProjectItem.

◆ RenderPassPrefabLibrary

RenderPassPrefabLibrary RenderPassPrefabLibrary

get

Gets the Render Pass Prefabs library which stores the render passes used in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

See also: RenderPassTypeLibrary, CreateRenderPassPrefab(string, RenderPassType), CreateRenderPass(string, IComposerContainer, RenderPassType)

Examples

To get the render pass prefabs in a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Render Pass Prefabs library which stores the render passes used in a Kanzi Studio project.
            var renderPassPrefabLibrary = studio.ActiveProject.RenderPassPrefabLibrary;
            // Print the name of each render pass prefab root to the Kanzi Studio Log window.
            foreach (var renderPass in renderPassPrefabLibrary.Items)
            {
                studio.Log(renderPass.Name);
            }
        }

◆ RenderPassTypeLibrary

RenderPassTypeLibrary RenderPassTypeLibrary

get

Gets the render pass types available in a Kanzi Studio project.

See also: CreateRenderPass(string, IComposerContainer, RenderPassType), ProjectItemLibrary<T>.Items

Examples

To get the render pass types available in Kanzi:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the render pass type library.
            var renderPassTypeLibrary = studio.ActiveProject.RenderPassTypeLibrary;
            // Print the available render pass types to the Kanzi Studio Log window.
            studio.Log("These render pass types are available in this Kanzi Studio project:");
            foreach (var renderPassType in renderPassTypeLibrary.Items)
            {
                studio.Log(renderPassType.Name);
            }
        }

◆ Screen

Screen Screen

get

Gets the Screen node in a Kanzi Studio project.

The Screen node is the root node of the node tree in Kanzi.

The Screen node.

See also: PluginInterface.Screen.RootNode2D

Examples

To get the Screen node:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Screen node.
            var screen = studio.ActiveProject.Screen;
            // Set the Metrics Type property of the Screen node to Absolute.
            screen.Set(screen.PropertyTypes.WindowMetricsType, LengthTypeEnum.ABSOLUTE);
            // Set the Width property of the Screen node to 1920.
            screen.Set(screen.PropertyTypes.WindowAbsoluteWidth, 1920);
            // Set the Height property of the Screen node to 1080.
            screen.Set(screen.PropertyTypes.WindowAbsoluteHeight, 1080);
        }

◆ ShaderGraphsLibrary

ShaderGraphsLibrary ShaderGraphsLibrary

get

Gets the Shader Graphs library which stores the visual shader graphs in a Kanzi Studio project.

After you get the library, you can access shader graphs and read or write their model state via ShaderGraph.GetModelJson and ShaderGraph.SetModelJson(string).

See also: ShaderGraph, ProjectItemLibrary<T>.Items, ProjectItemLibrary<T>.GetItemByName(string)

◆ ShaderSourceDirectory

ShaderSourceDirectory ShaderSourceDirectory

get

Gets the Shaders directory which stores the shader source files in a Kanzi Studio project.

See also: MaterialTypeLibrary

Examples

To get all shader source files in the Shaders directory of a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Shaders directory which contains the shader source files in a Kanzi Studio project. 
            var shaderSourceDirectory = studio.ActiveProject.ShaderSourceDirectory;
            // Print the path of all shader source files in your project to the Kanzi Studio Log window.
            studio.Log("This Kanzi Studio project contains these shader source files:");
            foreach (var shaderFile in shaderSourceDirectory.Items)
            {
                studio.Log(shaderFile.FileSystemPath);
            }
        }

◆ ShortcutLibrary

ShortcutLibrary ShortcutLibrary

get

Gets the Bookmarks library which stores the bookmarks in a Kanzi Studio project.

After you get the library, you can access and create bookmarks.

Examples

To create a bookmark in the Bookmarks library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Bookmarks library which stores the bookmarks in a Kanzi Studio project.
            var bookmarkLibrary = studio.ActiveProject.ShortcutLibrary;
 
            // Get the Screens/Screen/RootNode node.
            var rootNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode");
 
            // Create a Button 2D node in the RootNode node.
            var button = studio.ActiveProject.CreateProjectItem<Button2D>(
                rootNode.GenerateUniqueChildName("Button 2D"), rootNode);
 
            // Create a bookmark named Button 2D in the Bookmarks library.
            var buttonBookmark = studio.ActiveProject.CreateProjectItem<Shortcut>(
                bookmarkLibrary.GenerateUniqueChildName("Button 2D"),
                bookmarkLibrary);
 
            // Set the Target property of the bookmark to the Button 2D node.
            buttonBookmark.Set(buttonBookmark.PropertyTypes.ShortcutTarget, button);
        }

◆ StateManagerLibrary

StateManagerLibrary StateManagerLibrary

get

Gets the State Managers library which stores state managers used in a Kanzi Studio project.

After you get the library, you can access and create state managers in that library.

The State Manager library in a Kanzi Studio project.

See also: StateGroup, State, StateObject, StateTransition, ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a state manager with a state group, state, and a state object in the State Managers library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the State Managers library which stores state managers used in a Kanzi Studio project.
            var stateManagerLibrary = studio.ActiveProject.StateManagerLibrary;
            // Create a state manager named MyStateManager in the State Managers library.
            var myStateManager = studio.ActiveProject.CreateProjectItem<StateManager>(
                stateManagerLibrary.GenerateUniqueChildName("MyStateManager"), stateManagerLibrary);
            // Create a state group named MyStateGroup in the MyStateManager state manager.
            var myStateGroup = studio.ActiveProject.CreateProjectItem<StateGroup>(
                myStateManager.GenerateUniqueChildName("MyStateGroup"),
                myStateManager);
            // Create a state named MyState in the MyStateGroup state group.
            var myState = studio.ActiveProject.CreateProjectItem<State>(
                myStateGroup.GenerateUniqueChildName("MyState"),
                myStateGroup);
            // Create a state object named MyStateObject in MyState state.
            var myStateObject = studio.ActiveProject.CreateProjectItem<StateObject>(
                myState.GenerateUniqueChildName("MyStateObject"),
                myState);
        }

To get a state manager from the State Managers library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the State Managers library which stores state managers used in a Kanzi Studio project.
            var stateManagerLibrary = studio.ActiveProject.StateManagerLibrary;
            // Create a state manager named MyStateManager in the State Managers library.
            studio.ActiveProject.CreateProjectItem<StateManager>(stateManagerLibrary.GenerateUniqueChildName("MyStateManager"), stateManagerLibrary);
            // Get a state manager named MyStateManager from the State Managers library.
            var myStateManager = stateManagerLibrary.GetItemByName("MyStateManager");
        }

◆ StudioPluginItemLibrary

StudioPluginItemLibrary StudioPluginItemLibrary

get

Gets the Studio Plugin Items library which stores studio plugin items in a Kanzi Studio project.

See also: CreateStudioPluginItem

◆ StyleLibrary

StyleLibrary StyleLibrary

get

Gets the Styles library which stores styles used in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

The Styles library in a Kanzi Studio project.

See also: ProjectItem.GetChild(string), ProjectItem.GetChild<T>(string), CreateProjectItem<T>(string, ProjectItem), CreateProjectItem(Type, string, ProjectItem), ProjectItemLibrary<T>.GetItemByName(string)

Examples

To create a named style in the Styles library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Styles library which stores styles used in a Kanzi Studio project.
            var stylesLibrary = studio.ActiveProject.StyleLibrary;
            // Create a named style named MyNamedStyle in the Styles library.
            var myNamedStyle = studio.ActiveProject.CreateProjectItem<StyleItem>(
                stylesLibrary.GenerateUniqueChildName("MyNamedStyle"), stylesLibrary);
        }

To create a typed style in the Styles library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Styles library which stores styles used in a Kanzi Studio project.
            var stylesLibrary = studio.ActiveProject.StyleLibrary;
            // Create a named style named MyTypedStyle in the Styles library.
            var myTypedStyle = studio.ActiveProject.CreateProjectItem<StyleItem>(
                stylesLibrary.GenerateUniqueChildName("MyTypedStyle"), stylesLibrary);
            // Convert the named style you just created to a typed style
            myTypedStyle.Set(myTypedStyle.PropertyTypes.StyleType, StyleTypeEnum.GENERIC);
        }

To get a style from the Styles library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Styles library which stores styles used in a Kanzi Studio project.
            var stylesLibrary = studio.ActiveProject.StyleLibrary;
            // Create a named style named MyNamedStyle in the Styles library.
            studio.ActiveProject.CreateProjectItem<StyleItem>(stylesLibrary.GenerateUniqueChildName("MyNamedStyle"), stylesLibrary);
            // Get the named style named MyNamedStyle from the Styles library.
            var myNamedStyle = stylesLibrary.GetItemByName("MyNamedStyle");
        }

◆ TagLibrary

TagLibrary TagLibrary

get

Gets the Tags library which stores tags used in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

The Tags library in a Kanzi Studio project.

See also: ProjectItem.GetChild(string), ProjectItem.GetChild<T>(string), CreateProjectItem<T>(string, ProjectItem), CreateProjectItem(Type, string, ProjectItem), ProjectItemLibrary<T>.GetItemByName(string), PipelineItemLibrary

Examples

To get a tag from the Tags library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Tags library which stores tags used in a Kanzi Studio project.
            var tagsLibrary = studio.ActiveProject.TagLibrary;
            // Get the default tag Transparent from the Tags library.
            var tagTransparent = tagsLibrary.GetItemByName("Transparent");
        }

To create a tag in the Tags library:

         public void Execute(PluginCommandParameter parameter)
         {
             // Get the Tags library which stores tags used in a Kanzi Studio project.
             var tagsLibrary = studio.ActiveProject.TagLibrary;
             // Create a tag named MyTag in the Tags library.
             var tag = studio.ActiveProject.CreateProjectItem<Tag>(tagsLibrary.GenerateUniqueChildName("MyTag"), tagsLibrary);
         }

◆ TextureLibrary

TextureLibrary TextureLibrary

get

Gets the Textures library which stores textures used in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

The Textures library in a Kanzi Studio project.

See also: ProjectItem.GetChild, ProjectItemLibrary<T>.GetItemByName(string)

Examples

To get a texture from the Textures library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Materials and Textures > Textures library
            // which stores all the textures in a Kanzi Studio project.
            var texturesLibrary = studio.ActiveProject.TextureLibrary;
            // Get the DefaultTexture texture from the Textures library.
            var defaultTexture = texturesLibrary.GetItemByName("Default Texture");
        }

To create a Single Texture in the Textures library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Materials and Textures > Textures library.
            var textureLibrary = studio.ActiveProject.TextureLibrary;
 
            // Get the DefaultTextureImage.png image in the Images directory of the project.
            if (studio.ActiveProject.ImageDirectory.GetChild("DefaultTextureImage.png") is ImageFile defaultImage)
            {
                // In the Textures library, create a Single Texture named My Single Texture.
                var singleTexture = studio.ActiveProject.CreateProjectItem<SingleTexture>(
                    textureLibrary.GenerateUniqueChildName("My Single Texture"), textureLibrary);
 
                // Set the Image property of the Single Texture to DefaultTextureImage.png.
                singleTexture.Set(singleTexture.PropertyTypes.TextureImage, defaultImage);
            }
        }

To create a function that creates a Single Texture from an image file:

        private Texture CreateTextureFromImage(string path)
        {
            // Get the Library > Materials and Textures > Textures library.
            var textureLibrary = studio.ActiveProject.TextureLibrary;
 
            // Get the name of the image file without the file extension.
            // To use this function, in the class library file that implements the PluginCommand interface add the using directive for the System.IO namespace.
            var resourceName = Path.GetFileNameWithoutExtension(path);
 
            // Import the image file to the Library > Resource Files > Images library and create a Single Texture that uses this image file.
            // To import an image without creating a texture, set the second parameter of the ImportImages command to false.
            studio.Commands.ImportImages(studio.ActiveProject, path, true);
 
            // Get the texture you created.
            var texture = textureLibrary.GetItemByName(resourceName);
 
            return texture;
        }

To create a Render Target Texture in the Textures library:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Library > Materials and Textures > Textures library.
            var textureLibrary = studio.ActiveProject.TextureLibrary;
 
            // In the Textures library, create a Render Target Texture named My Render Target Texture.
            var renderTargetTexture = studio.ActiveProject.CreateProjectItem<RenderTargetTexture>(
                textureLibrary.GenerateUniqueChildName("My Render Target Texture"), textureLibrary);
 
            // Set the Width and Height properties of the Render Target Texture to 256.
            renderTargetTexture.Set(renderTargetTexture.PropertyTypes.RenderTargetTextureWidth, 256);
            renderTargetTexture.Set(renderTargetTexture.PropertyTypes.RenderTargetTextureHeight, 256);
        }

◆ ThemeLibrary

ThemeLibrary ThemeLibrary

get

Gets the Themes library which stores themes in a Kanzi Studio project.

◆ TimelineSequenceLibrary

TimelineSequenceLibrary TimelineSequenceLibrary

get

Gets the Timeline Sequences library which stores timeline sequences in a Kanzi Studio project.

◆ TrajectoryLibrary

TrajectoryLibrary TrajectoryLibrary

get

Gets the Trajectories library which stores trajectories used in a Kanzi Studio project.

After you get the library, you can access and create resources in that library.

See also: CreateComponentNode

Examples

To create a trajectory in the Trajectories library and set a Trajectory Layout node to use that trajectory:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Trajectories library which contains the trajectories in a Kanzi Studio project.
            var trajectoryLibrary = studio.ActiveProject.TrajectoryLibrary;
 
            // In the Trajectories library create a Circle Trajectory named My Circle Trajectory.
            var myCircleTrajectory = studio.ActiveProject.CreateProjectItem<CircleTrajectory>(trajectoryLibrary.GenerateUniqueChildName("My Circle Trajectory"), trajectoryLibrary);
            // Set the Radius property of My Circle Trajectory to 5. 
            myCircleTrajectory.Set(Properties.CircleRadius, 5);
 
            // Get the Scene node in the Screens/Screen/RootNode/Viewport 2D node.
            var sceneNode = studio.ActiveProject.GetProjectItem("Screens/Screen/RootNode/Viewport 2D").GetChild<Scene>("Scene");
            // Get the component type library which contains the Kanzi component node types.
            var componentTypeLibrary = studio.ActiveProject.ComponentTypeLibrary;
            // In the Scene node create a Trajectory Layout 3D node.
            var trajectoryLayout = studio.ActiveProject.CreateComponentNode(
                sceneNode.GenerateUniqueChildName("Trajectory Layout 3D"), sceneNode, componentTypeLibrary.GetComponentType(ComponentTypeNames.TrajectoryLayout3D));
            // Set the Trajectory property of the Trajectory Layout 3D node to My Circle Trajectory.
            trajectoryLayout.Set(Properties.TrajectoryLayoutConceptTrajectory, new ResourceReference<Trajectory>(myCircleTrajectory));
 
            // In the Trajectory Layout 3D node create 8 Sphere nodes.
            for (int i = 0; i < 8; i++)
            {
                studio.ActiveProject.CreateProjectItem(typeof(SphereMeshNode), trajectoryLayout.GenerateUniqueChildName("Sphere"), trajectoryLayout);
            }
        }

◆ TriggerActionTypeLibrary

TriggerActionTypeLibrary TriggerActionTypeLibrary

get

Gets the trigger action types available in a Kanzi Studio project.

See also: ProjectItemLibrary<T>.Items

Examples

To get the trigger action types available in a Kanzi Studio project:

        public void Execute(PluginCommandParameter parameter)
        {
            // Get the Trigger Action Type Library which stores all the trigger action types in a Kanzi Studio project.
            var triggerActionTypeLibrary = studio.ActiveProject.TriggerActionTypeLibrary;
            // Print the available trigger action types to the Kanzi Studio Log window.
            studio.Log("These trigger action types are available in this Kanzi Studio project:");
            foreach (var triggerActionType in triggerActionTypeLibrary.Items)
            {
                studio.Log(triggerActionType.Name);
            }
        }

Event Documentation

◆ ActiveCompositionChanged

EventHandler<CompositionChangedEventArgs> ActiveCompositionChanged

Occurs when the active composition changes.

See also: ActiveComposition

◆ BinaryExported

EventHandler BinaryExported

Occurs after the export of the kzb file of the project is completed.

Examples

To subscribe to the BinaryExported event:

        // Create the event handler and subscribe to the BinaryExported event to get 
        // notified when Kanzi Studio finishes exporting the kzb file of the project.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when Kanzi Studio finishes
            // exporting the kzb file of the project.
            studio.ActiveProject.BinaryExported += Project_BinaryExported;
        }
 
        private void Project_BinaryExported(object sender, EventArgs e)
        {
            // When Kanzi Studio finishes exporting the kzb file of the project,
            // print a message to the Kanzi Studio Log window.
            studio.Log("Finished exporting the kzb file of the project.");
        }
 

◆ BinaryExporting

EventHandler BinaryExporting

Occurs when the export of the kzb file of the project starts.

Examples

To subscribe to the BinaryExporting event:

        // Create the event handler and subscribe to the BinaryExporting event to get 
        // notified when Kanzi Studio is exporting the kzb file of the project.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when Kanzi Studio is exporting 
            // the kzb file of the project.
            studio.ActiveProject.BinaryExporting += Project_BinaryExporting;
        }
 
        private void Project_BinaryExporting(object sender, EventArgs e)
        {
            // When Kanzi Studio is exporting the kzb file of the project,
            // print a message to the Kanzi Studio Log window.
            studio.Log("Exporting the kzb file of the project...");
        }
 

◆ Closing

EventHandler Closing

Occurs when the project is about to close.

◆ Merged

EventHandler<ProjectMergeEventArgs> Merged

Occurs after a project merge operation is completed.

See also: Merging

◆ Merging

EventHandler<ProjectMergeEventArgs> Merging

Occurs when a project merge operation is about to start.

See also: Merged

◆ Saved

EventHandler<ProjectSavingEventArgs> Saved

Occurs after Kanzi Studio successfully saves the project.

◆ Saving

EventHandler<ProjectSavingEventArgs> Saving

Occurs when the saving of the project starts.

Public Member Functions

Properties

Events

Detailed Description

Member Function Documentation

◆ CreateBrush() [1/2]

◆ CreateBrush() [2/2]

◆ CreateComponentNode()

◆ CreateDataSource()

◆ CreateLightNode()

◆ CreateMessageType()

◆ CreateNodeComponent()

◆ CreateNodeEffect2D()

◆ CreateNodeEffectPrefab2D()

◆ CreateProjectItem()

◆ CreateProjectItem< T >()

◆ CreateRenderPass()

◆ CreateRenderPassPrefab()

◆ CreateStudioPluginItem()

◆ GetPreviewConfiguration()

◆ GetProjectItem()

◆ GetProjectItemByKzbUrl()

◆ GetReferringItemsKzbNames()

◆ IsAbstract()

Property Documentation

◆ ActiveComposition

◆ AnimationClipLibrary

◆ AnimationLibrary

◆ ApplicationDirectory

◆ Asset3DImportSourceDirectory

◆ BinaryExportDirectory

◆ BrushLibrary

◆ BrushTypeLibrary

◆ ComponentTypeLibrary

◆ DataSourceLibrary

◆ DataSourceTypeLibrary

◆ EnginePluginLibrary

◆ FontDirectory

◆ FontFamilyLibrary

◆ GenericResourceFileDirectory

◆ Guides

◆ ImageDirectory

◆ IsJavaProject

◆ IsNewlyCreatedProject

◆ IsSDKProject

◆ LocaleLibrary

◆ MaterialLibrary

◆ MaterialTypeLibrary

◆ MeshLibrary

◆ MessageTypeLibrary

◆ NodeComponentTypeLibrary

◆ NodeEffectPrefab2DLibrary

◆ NodeEffectType2DLibrary

◆ PageTransitionCollectionLibrary

◆ PipelineItemLibrary

◆ PrefabLibrary

◆ PreviewWorkingDirectory

◆ ProjectReferenceLibrary

◆ PropertyTypes

◆ RenderPassPrefabLibrary

◆ RenderPassTypeLibrary

◆ Screen

◆ ShaderGraphsLibrary

◆ ShaderSourceDirectory

◆ ShortcutLibrary

◆ StateManagerLibrary

◆ StudioPluginItemLibrary

◆ StyleLibrary

◆ TagLibrary

◆ TextureLibrary

◆ ThemeLibrary

◆ TimelineSequenceLibrary

◆ TrajectoryLibrary

◆ TriggerActionTypeLibrary

Event Documentation

◆ ActiveCompositionChanged

◆ BinaryExported

◆ BinaryExporting

◆ Closing

◆ Merged