AtomX
Essentials

Package Options

Custom package options allow you to apply specific parameters to the extension; these settings are linked to and work only with a specific application (After Effects, Premiere Pro, etc.) or globally.

To add options, simply specify them in your package's inside_option_sets separated by commas.

Settings Example
"settings": {
    "main": {...},
    "inside_option_sets": {
        "auto_size_composition": "ONLY_MAIN",
        "auto_fps_composition": "NONE",
        "customizer_control_range": {...},
        ... # Add here any options
    }
}

If you don't need to change the extension's behavior and don't specify any options, the default values ​​will be used.

Some options can be overridden for a group; see Group Options for more information.

Common Options

Here are the parameters that work in all applications.

customizer_control_range

Allows you to set the maximum and minimum settings for the customizer parameters as [X, Y, Z] / [FROM, TO]. The parameter name is related to the name of your effect on the control layer / or MOGRT element.

"customizer_control_range": {
    "My Fx Position": [-2000, 2000, 150],
    "Custom Opacity": [0, 100],
    ...
}

customizer_action

Determines what to do when you click the customizer button - open the customizer or go directly to managing the native settings.

SoftwareDescriptionOption
After EffectsTo run the customizer, you need to add a special comment ATOM_CUSTOMIZER_LAYER to the control layer.EDITOR
Premiere ProRuns with MOGRT (Motion Graphics Template) elements only.EDITOR

SIMPLE – open the composition with the control level and mark it in default

EDITOR – open the editor of controllers and text (if it's on) right inside the extension

"customizer_action": "EDITOR"

customizer_text_editor

Ability to edit the text strictly in the extension by pushing the customizer button.

SoftwareOperation aspects
After EffectsFinds text layers with special comment ATOM_TEXT_EDITOR_LAYER in all the compositions inside the main one.
Premiere ProRuns with MOGRT (Motion Graphics Template) elements only.
customizer_action must be specified as EDITOR.

true – text editor in the extension is on (by default)

false – text editor in the extension is off

"customizer_text_editor": true

auto_size_footage

Allows you to create adaptability for your footages (images/video files).

Works only for groups with footage - the is_footage parameter.

Size copying (height and width) of a current composition/sequence to the applied footages in the extension (with the preservation of proportions). Creates an effect of auto-changing (adaptivity) of the size.

You can change this parameter for individual groups of elements (for more information, see change_auto_size_footage).

  • NONE – not apply (default)
  • ALL_ITEMS – apply to all elements (images/video)
"auto_size_footage": "ALL_ITEMS"

use_webm_preview

Allows using WEBM/MP4 (videos) for file previews instead of standard GIFs throughout the package.

You can disable this option and use GIFs for individual groups using the disable_webm_preview option.
  • webm .WEBM format preview (video)
  • mp4 .MP4 format preview (video)

If you simply specify true, then WEBM will be used according to the standard.

"use_webm_preview": "webm"

After Effects only

Options that only work for the After Effects package.

auto_size_composition

Allows you to create screen-adapted sequences and MOGRT files (motion graphics templates).

The size of the current composition will be used for the applied element, creating a responsive effect.

This works especially well if your composition is designed with high-quality responsiveness of elements in mind.
  • NONE – not apply (default)
  • ONLY_MAIN – for a current composition only
  • ALL_COMPS – for all inner compositions (unrecommended)
"auto_size_composition": "ONLY_MAIN"

auto_fps_composition

Copy FPS of a current composition into the composition applied via the extension.

  • NONE – not apply (default)
  • ONLY_MAIN – for a current composition only
  • ALL_COMPS – for all inner compositions
"auto_fps_composition": "NONE"

duplicate_origin_setting

Duplicating a composition and all internal compositions allows for easy editing of each element individually. ONLY_MAIN is sufficient if there is only one main editing composition.

It will be possible to override this setting for individual groups.

  • ONLY_MAIN – for a current composition only
  • ALL_COMPS – for all inner compositions
"duplicate_origin_setting": "ALL_COMPS"

use_start_timeline_pointer

Specifies where the cursor will be on the timeline after applying the element.

  • NONE – similar to START_POINT (by default)
  • START_POINT – the very beginning of the timeline
  • FOLLOW_CURSOR – in current cursor position
  • IN_MARKER_POINT – in current cursor position and the first marker inside the composition (perfectly fits to transition compositions)
"use_start_timeline_pointer": "FOLLOW_CURSOR"

layer_index_position

Index (the position of a layer/composition) for the element applied on the timeline. Allows you to apply a layer above the selected one, below the selected one, etc.

  • NONE – similar to MOVE_BEGIN (by default)
  • MOVE_BEGIN – add an element to the very top of layers (the first index)
  • MOVE_BELOW – add an element below selected layer (if there is one)
  • MOVE_ABOVE – add an element above selected layer (if there is one)
  • MOVE_END – add an element at the end of layers (the last index)
"layer_index_position": "MOVE_ABOVE"

Premiere Pro only

Options that only work for the Premiere Pro package.

auto_size_sequence

Allows you to create screen-adapted sequences and MOGRT files (motion graphics templates).

The size of the current sequence / MOGRT will be used for the applied element, creating a responsive effect.

  • NONE – not apply (default)
  • ONLY_SEQ – apply only to sequences
  • ONLY_MOGRT – apply only to MOGRT files
  • ALL_ITEMS – apply to all items (sequences and MOGRT files)
"auto_size_sequence": "ALL_ITEMS"

files_protection_method

Allows you to encrypt your files so that they can only be opened through the extension AtomX.

Files must be pre-saved with the selected encryption type so that the extension will only decrypt these files in the future.

To save as encrypted file, open Dev Panel. Pick already saved before file, and click to PR: .atomxasset.

  • NONE – not apply (default)
  • BIN_AX – open the elements with encryption BIN_AX
"files_protection_method": "BIN_AX"

source_type

Specifies the type of project elements to use, specifically how the element is applied.

  • PROJECT – the elements are Premiere Pro projects (apply the element as a sequence) - by default.
  • MOGRT – the elements are .MOGRTs (Motion Graphics Template - convertible compositions with After Effects) files
  • FULL_PROJECT –import the entire project and select the desired sequence within it (new system).
"source_type": "PROJECT"