// Objective: Use a Precomp ("precomposition")
// Expected Result: You will see 2 red boxes, both containing the word "Hello". The word "Hello" will be zooming in and out.

// Create a Precomp setting the initial width of its camera to 200 x 200.
let precomp = new Precomp( "MyPrecomp", 200, 200, true );
precomp.camera.backgroundColor = new Color( .5, .1, .1, 1 ); // adjust the color to red

// Create a TextAssembly and add it to the Scene provided by the Precomp.
let textAssembly = new TextAssembly( precomp.scene, "TextAssembly" ); 
textAssembly.string = "Hello";
// Add motion to the TextAssembly in order to expand and shrink the text over a speed interval.
textAssembly.scale.addMotion.all( .25, 20, .2 );

// Create 2 GraphicObjects, each using the GraphicAsset from "MyPrecomp".
let graphicObject1 = new GraphicObject( nc.graphicAssets.MyPrecomp, nc.mainScene, "SceneViewerGraphicObject1" );
graphicObject1.position.x = -150;
let graphicObject2 = new GraphicObject( precomp.graphicAsset, nc.mainScene, "SceneViewerGraphicObject2" );
graphicObject2.position.x = 150;

MEMBERS

automaticallyManageLoadingTierDelayedContentRendering :boolean

IncisorAPI.js, line 8711

Boolean determining if this Precomp attempts to manage its own delayed rendering. With this value set to true and 'autorender=true', this Precomp will change the 'autoRenderOrder' of its own Camera to account for any Precomp nesting that migth occur. With this value set to true and 'autorender=false', this Precomp will set up an internal callback to render its Scene content once it all loads. If this value is set to false, no delayed rendering management actions occur unless manually triggered. The Precomp can be rendered at any time by calling 'Precomp.camera.render'.

Default Value:

• true

camera :OrthographicCamera

IncisorAPI.js, line 8688

The OrthographicCamera that resides in, and renders, this Precomp's Scene.

graphicAsset :GraphicAsset

IncisorAPI.js, line 8700

The GraphicAsset using this Precomp's RenderTarget (using its Texture)

inheritedTypes :object

IncisorAPI.js, line 8670

Dictionary object listing all of the types this object is compatible with.

name :string

IncisorAPI.js, line 8676

The name of the Precomp. This name will also be used for the GraphicAsset, Texture, and Geometry that are created as part of this Precomp.

renderTarget :RenderTarget

IncisorAPI.js, line 8694

The RenderTarget that this Precomp's Camera renders to.

scene :Scene

IncisorAPI.js, line 8682

The Scene holding the this Precomp's content. This is the Scene that is rendered to inform the associated GraphicAsset.

type :string

IncisorAPI.js, line 8664

Type identifier.

METHODS

async writePngFile(filePath, isPathRelative (opt), postLoadCallbackOwner (opt), postLoadCallbackName (opt), postLoadCallbackArgs (opt), unMultiply (opt))

IncisorAPI.js, line 8727

An awaitable method that writes the rendered content from this Precomp's RenderTarget to disk as a '.png' file once it has all loaded. A callback function can be provided to manipulate the contents of this Precomp once it has loaded before it is rendered and write to file. [REQUIREMENT: unpublished projects only] [REQUIREMENT: user subscription access - 'fileIO']

Parameters:

Name	Type	Attributes	Default	Description
filePath	string			The relative or absolute path to the png file to be written to disk.
isPathRelative	boolean	<optional>		Bool stating if the given path is relative to the project path or an absolute path. If an absolute path is used that is outside of the project directory, the 'allowUniversalFileIO' item in application settings must be set to true. [DEFAULT: true]
postLoadCallbackOwner	object	<optional>		The owner of the optional callback function that is called once the Precomp Scene's content is loaded before it is rendered.
postLoadCallbackName	string	<optional>		The name of the optional callback function that is called once the Precomp Scene's content is loaded before it is rendered.
postLoadCallbackArgs	Array | any	<optional>		Parameters for the optional callback function that is called once the Precomp Scene's content is loaded before it is rendered.
unMultiply	boolean	<optional>		Boolean determining if the contents of the RenderTarget are 'un-multiplied' before the '.png' is written. Since textures loaded in Incisor® use premultiplied alpha, un-multiplication would need to happen to get a file with transparency that was equivalent to the original asset files. [DEFAULT: true]