Developer

API Reference

AEECLSID_TrigAppletFactory

Brew Release
Brew MP 1.0.2
Description
This class creates an IApplet container (TrigApplet) for a trigplayer widget. The metadata provided to the IAppletFactory_Create() method should be a filesystem URL to the .TMF file describing the trig.
The created applet will have the following features:

Default TrigML Fragment

The TrigML fragment "startup/default" will be loaded into _root after the trig is initialized.

Secondary Display Support

The trig may choose to use a secondary display instead of the primary display.
This feature is selected when the trig provides the node "/trig/config/trigapplet/displayIndex" with value of 2 for the secondary display, 3 for the tertiary display, etc. If this node is not provided by the trig, TrigApplet defaults to using the primary display (1).
Note that currently a TrigApplet cannot use more than one display. This is because the TrigPlayer is an IWidget, which cannot span multiple displays, and the TrigApplet only supports a single TrigPlayer instance.
See the IDisplay documentation in AEEDisp.h for more details regarding using multiple displays.

Null Display Support

The trig may also choose to use a null display (one that is not tied to a physical display).
This feature is selected when the trig provides the node "config/trigapplet/displayIndex" with a negative value. -1 means use a null display with the same size as the primary display
-2 means use a null display with the same size as the secondary display

Null displays are typically used by a background (daemon) trig that still needs to output content to a display bitmap

Display Bitmap Support

The trig may also choose to use a specific bitmap implementation. This bitmap will be used as a null display destination.
This feature is selected when the trig provides the node "config/trigapplet/displayBitmap" with the bitmap clsID. This node has priority over the "config/trigapplet/displayIndex" node.

No Display Support

Finally, the trig may choose no display. In this case the trigplayer is not attached to a RootContainer and thus has no means of affecting any display (without the use of additional actors). This option intended to be selected by trigs that utilize the "trigplayer split" feature.
This feature is selected when the trig provides the node "config/trigapplet/displayBitmap" with a value of 0. This node has priority over the "config/trigapplet/displayIndex" node.

End Key Handling

If the TrigApplet receives an EVT_KEY event for the End key without first receiving EVT_KEY_PRESS, the EVT_KEY_PRESS event is sent to the TrigPlayer prior to the EVT_KEY. This is because the TrigPlayer requires an EVT_KEY_PRESS event to acknowledge that a key has been pressed, and holding the End key will therefore propagate over multiple instances of the TrigApplet.

CompositeTrigAppletActor

This TrigApplet fully supports the CompositeTrigAppletActor interface.

Trig Theming

This TrigApplet supports the application of a Trig-independent theme through the "/trig/appletfactory/0106c637/themeSettings/themePath" AEECLSID_SettingsReg ISettings item. This string contains one or more theme .bar files (comma delimited) to be applied to the trig.
TrigApplet monitors this string for change and reapplies the theme .bar files if the list changes while the applet is running. The AEEPRIVID_TrigAppletFactoryThemeSettingsUpdate privilege is required to modify this ISettings item.
Refer to the 'TrigML How To' guide for examples on using Theming.
Default Interface Name
  • Follow