EntityLauncher

The EntityLauncher object creates an entity when it is clicked by the user or when a specified keyboard key is pressed.

The simulation model must be executing in Real Time mode for entities to be generated.  For the keyboard action to be detected, the View window containing the EntityLauncher must be selected.

The PrototypeEntity keyword identifies the entity to be copied.  This entity can be any type of object, no matter how complex.  Either a specific object or an expression that returns an object can be entered.  The generated copies retain both the graphics of the prototype as well as the values of all its inputs.

The ActionKey input is used to specify a keyboard shortcut for creating an entity.

EntityLauncher Inputs

Keyword

Description

Key Inputs

 

Description

A free-form string describing the object.

ActionKey

An optional keyboard key that will cause the EntityLauncher to generate an entity.

PrototypeEntity

The entity to be copied by the EntityLauncher.

NextComponent

The next object to which a generated entity is passed.

BaseName

The base for the names assigned to the generated entities.  The generated entities will be named Name1, Name2, etc.

Options

 

AttributeDefinitionList, CustomOutputList

See Section 6.2.

Graphics

 

Position, Alignment, Size, Orientation, Region, RelativeEntity, DisplayModel, Show, Movable

See Section 11.1.

EntityLauncher Outputs

Output Name

Description

Entity and DisplayEntity

 

Name, ObjectType, SimTime, Parent, Attributes, Custom Outputs, Position, Size, Orientation, Alignment, GraphicalLength, ObserverList, NextList, PreviousList

See Section 11.1.