Package Options
To add options, simply specify them in your package's inside_option_sets separated by commas.
"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.
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.
| Software | Description | Option |
|---|---|---|
| After Effects | To run the customizer, you need to add a special comment ATOM_CUSTOMIZER_LAYER to the control layer. | EDITOR |
| Premiere Pro | Runs 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.
| Software | Operation aspects |
|---|---|
| After Effects | Finds text layers with special comment ATOM_TEXT_EDITOR_LAYER in all the compositions inside the main one. |
| Premiere Pro | Runs with MOGRT (Motion Graphics Template) elements only. |
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.
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.
NONE– not apply (default)ONLY_MAIN– for a current composition onlyALL_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 onlyALL_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 onlyALL_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 toSTART_POINT(by default)START_POINT– the very beginning of the timelineFOLLOW_CURSOR– in current cursor positionIN_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 toMOVE_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 sequencesONLY_MOGRT– apply only to MOGRT filesALL_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.
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) filesFULL_PROJECT–import the entire project and select the desired sequence within it (new system).
"source_type": "PROJECT"
