list of contents - aniom atom... · 2019-08-21 · for more detales see here. • true – request...

48
1 List of Contents Last updated.: Jul. 27.2019 Package creation........................................................................................................................................... 2 Basic Settings............................................................................................................................................. 2 Customized Package Settings ............................................................................................................. 5 Package Stylization ............................................................................................................................. 8 Preview Files............................................................................................................................................10 Package Structure ...................................................................................................................................11 Template Elements ...........................................................................................................................14 Group Attributes ...............................................................................................................................17 Purchase Code Control ............................................................................................................................23 Purchase Code Control [VideoHive] .................................................................................................24 Purchase Code Control [Gumroad] ...................................................................................................25 Purchase Code Control [Own ad-hoc] ..............................................................................................25 Package Testing ..........................................................................................................................................26 What’s the point of the tester mode? ....................................................................................................26 How to switch the tester mode on?........................................................................................................27 How to switch the tester mode off? .......................................................................................................27 Attachment for creation of a package structure and package compilation .............................................28 Auto Resize (creation of adaptive composition sizes) ............................................................................29 Special Marking for Bounding with Atom ...............................................................................................35 Mark-comment for Settings Layer (Customizer Layer).....................................................................37 Mark-comment for Text Layers ........................................................................................................38 Mark-comment for Indicators of Time Settings ...............................................................................39 Express Creation and adding of Mark-comments (cycle) .................................................................40 Creation of a Project Structure (with pointing the options needed) ......................................................41 Groups...............................................................................................................................................42 Items .................................................................................................................................................42 Custom Args ......................................................................................................................................43 Group Options ..................................................................................................................................43 Compilation of package (creation of the final version) ...........................................................................46 The package is ready. What’s next?...........................................................................................................48

Upload: others

Post on 27-Jun-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

1

List of Contents Last updated.: Jul. 27.2019

Package creation ........................................................................................................................................... 2

Basic Settings ............................................................................................................................................. 2

Customized Package Settings ............................................................................................................. 5

Package Stylization ............................................................................................................................. 8

Preview Files ............................................................................................................................................ 10

Package Structure ................................................................................................................................... 11

Template Elements ........................................................................................................................... 14

Group Attributes ............................................................................................................................... 17

Purchase Code Control ............................................................................................................................ 23

Purchase Code Control [VideoHive] ................................................................................................. 24

Purchase Code Control [Gumroad] ................................................................................................... 25

Purchase Code Control [Own ad-hoc] .............................................................................................. 25

Package Testing .......................................................................................................................................... 26

What’s the point of the tester mode? .................................................................................................... 26

How to switch the tester mode on? ........................................................................................................ 27

How to switch the tester mode off? ....................................................................................................... 27

Attachment for creation of a package structure and package compilation ............................................. 28

Auto Resize (creation of adaptive composition sizes) ............................................................................ 29

Special Marking for Bounding with Atom ............................................................................................... 35

Mark-comment for Settings Layer (Customizer Layer) ..................................................................... 37

Mark-comment for Text Layers ........................................................................................................ 38

Mark-comment for Indicators of Time Settings ............................................................................... 39

Express Creation and adding of Mark-comments (cycle) ................................................................. 40

Creation of a Project Structure (with pointing the options needed) ...................................................... 41

Groups............................................................................................................................................... 42

Items ................................................................................................................................................. 42

Custom Args ...................................................................................................................................... 43

Group Options .................................................................................................................................. 43

Compilation of package (creation of the final version) ........................................................................... 46

The package is ready. What’s next? ........................................................................................................... 48

Page 2: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

2

Package creation Open a file which contains a package example (Example Package.atom) in Notepad++/Sublime Text

editor or another that highlights syntax and point out the syntax code as JavaScript. That makes working

with the package easier.

Example of open package (Sublime Text editor):

Without syntax highlifghting With the highlighting (JavaScript)

Basic Settings

Section: pack_object.settings

Attribute Description

name A package name Ex.: “InstaManiac”

version Version of a package name with a dot (for free version dial DEMO or choose relevant option in the compiler). If the package is in DEMO version, you’ll have a button while installing that leeds you to get a full version of the package. There’s no such button in paid versions.

Ex.: “1.4”

required_app_version The Atom version required for package installing. The latest version see here. The system will not install the package with previous version and will reqire an app updating. Ex.: “2.0”

Page 3: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

3

engine_pack Engine type for all elements of a template. If you change the engine - the engine type options such as buttons, Toolbar, customizer and others will change. You can use various engine types while working on various templates. We can improve types of engines or even create new ones for you (ezxtra pay).

• _COMPOSER – After Effects Templates/Audio Files/…

• _TEXT_PRESETS – Text presaets (created by a particular interpreter)

Ex.: “_COMPOSER”

inside_security Inner security code (input TEST_MODE for package testing). The special code will be set up in a compiled version of the project. Ex.: “TEST_MODE”

required_purchase_code Is it necessary to require a purchase code? When you buy a videohive.net / gumroad.com or other stocks project you get a purchase code that you need to input into the extention to install the package. You can also render temporary activation codes with the help of Atom’s admin panel or by emailing the project author. We can add another system of purchase control for your packages (extra pay). Point out the chosen purchase control system in the Atom’s admin panel or inform the author of the project.

Page 4: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

4

Default - VideoHive. For more detales see here.

• true – Request

• false – Do not request (indicate for free packages or while testing a package)

Ex.: true

cc_author_username Author’s username that is displayed for the package. It is not necessary connected to VideoHive or other payment systems. You will also use the username to log in to Atom’s Help Centeadmin panelr. Ex.: “aniom”

Now we’re done with basiс settings and let's continue with settings of After Effects projects.

Page 5: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

5

Customized Package Settings

The settings are located:

inside_option_sets: { here }

Attribute Description

auto_size_composition An auto-change of a composition size (from the template used) to one that specified in user’s active composition.

• NONE – do not use

• ONLY_MAIN – used only for main composition (the one we change – the preferable version for composition size auto-change)

• ALL_COMPS – for all compositions Ex.: “ONLY_MAIN”

auto_fps_composition An auto-change of the frame per second (FPS) jf the composition (from the template used) to one that specified in user’s active composition.

• NONE – do not use

• ONLY_MAIN – used only for main composition (applied one)

• ALL_COMPS – for all compositions Ex.: “ONLY_MAIN”

duplicate_origin_setting Doubling the applied composition. So to preserve the wholeness of the imported composition. Have to be used obligatory.

• ONLY_MAIN – used only for main composition (applied one)

• ALL_COMPS – for all compositions Ex.: “ONLY_MAIN”

use_start_timeline_pointer A layer on timeline of the applied composition.

• NONE or START_POINT – the very beginning of timeline

• FOLLOW_CURSOR – timeline pointer position (preferrable)

• IN_MARKER_POINT – position of the pointer or IN marker (if there is one)

Page 6: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

6

Ex.: “FOLLOW_CURSOR”

layer_index_position Index of the added element (layer/composition) on the timeline

• NONE or MOVE_BEGIN – the first index (the top of layers)

• MOVE_BELOW – add an element below marked layer (if there is marking)

• MOVE_ABOVE - add an element above marked layer (if there is marking)

• MOVE_END – add an element into the end of layers (the last index)

Ex.: “MOVE_ABOVE”

customizer_action Using of the customizer

To use the customizer you need to add a specific comment (ATOM_CUSTOMIZER_LAYER)

For the layer with controllers (sliders, colors, etc.) inside your composition.

Point the operation while pressing the customizer button.

• SIMPLE – go to the layer with controllers

Page 7: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

7

• EDITOR – the editor of controllers and text (if included) right inside of the extension

Ex.: “EDITOR”

customizer_text_editor Facility to edit the text straight through the extension with pressing thq customizer button.

The setting finds text layers in all the compositions with a special comment inside the original composition (ATOM_TEXT_EDITOR_LAYER)

Works if the value is higher (customizer_action), equal – EDITOR.

• true – Run the text editor

• false – Turn off the editor Ex.: true

Page 8: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

8

Package Stylization Now lets do the final attributes – package stylization (extension header).

The settings are located:

stylization: { here }

Attribute Description

header_image_bytes Your own image for the header in bytes format. You can add it with the help of Atom Toolkit Helper that is specially available for the project authors. The image for the header have to be in .PNG format. Size: 282х75 (.pdf file for the header image is in history) If you know how to deal with bytes and want to add the data manually then insert either here:

or in the section above

header_color_hex Color of the header background extention (the right side) in HEX format (including

# sign in the beginning of the color code)

Page 9: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

9

Ex.: “#35AEDB”

Page 10: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

10

Preview Files For the preview of one element you need two types of files:

• Static icon of the element (.PNG format)

• Preview of the element – animation (.GIF)

Available versions of elements’ preview (in pixels):

240 x 135 (landscape) 135 x 240 (portrait for the Instagram and

etc.)

240 x 240 (square in equal proportion)

135 x 135 (small square version)

File size (in pixels) and name have to be the same both for PNG and GIF.

How to use these files in a project structure – see further.

Page 11: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

11

Package Structure Section: pack_object.structure

The structure of the project is hierarchical model of groups and templates.

With pressing on group/template:

• Group – the group unfolds and reveals other groups or a template.

• Template – shows all the compositions/template elements (preview) to the right

An example of a structure code (inside the pack_object.structure section):

"Group 1": { "Template name": { preview: { Template element }, Template parameters } }, "Group 2": { "Subgroup 1": { "Template name": { preview: { Template element }, Template parameters } } }

Section examples:

Template without any group

Template Brush inside the Typography group

Page 12: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

12

Template Basic inside Kinetic group (the group itself is in a group named Typography).

You may ask how the preview files supplement the loading.

Names of groups and templates imitate folders on your computer (with current entitling).

There have to be two folders next to your package (.ATOM) and all of this is the package itself:

• Atom After Effects – After Effects Templates

• Atom Preview Assets – Preview Files

For example, if the structure of your package is like:

Page 13: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

13

Then a folder with preview files has to be like:

Folder Atom Preview Assets -> Instagram Stomp -> the files

In the example given the ID of files are used as their names. However, you can use ordinary names of

files by adding a particular attribute (for more details see Group Options).

Then the template should be here:

Folder Atom After Effects -> the files

The more compound the hierarchy - the more folders and files inside them you have. You can use any

other names for folders and AE projects with the help of specific attributes. (for more details see Group

Options).

Page 14: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

14

Template Elements A template element looks like:

“UNIQUE_ID”: { attributes of the element – read about them further }

Use a specific ID to add an element, preview files (flective option) and other tasks into favorites, the

value can be of any type but has to be unique and should not repeat more than once in a current

package.

ATTENTION: Unique ID cannot contain specific symbols (dots, commas, spaces, etc.)

Way of writing: MYSC_ID_1

Attribute Description

enabled To show the element in the extention or not

• true – show

• false – hide Ex.: true

name The name of the element (shown in extention). That shoul be a composition name inside the AE Template (to change use attributes below – custom_args, atribute comp_name)

options [Optional] Specific icons of the element.

ICON:TEXT - an icon from the list below and its corresponding text. (If you point just an ICON without pointing text and symbol “:” (colon), the utility adds just default text. If you point the text only, then icon info be displayed). If there’s no need to use the attribute, you can either delete it or signify it as option:false

ICON FORM DEFAULT TEXT

THREED 3D Animation

PUZZLEPART Mask Path

DIAMONDPICK Our choice

PLUGIN Need Plug-in

PEN Font

PEN2 Font Mix

Page 15: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

15

WINNER_CUP Fresh Item

INFO Custom Text

Ex.: “winner_cup:I like it!”

custom_args [Optional] Specific arguments for the elelment (separated by commas), standalone frame: custom_args: { arguments }, inside the basic frame of the element. See the attributes further. Ex.: custom_args:{ attributes }

Attributes custom_args:

Attribute Description

parent_folder [Optional] The name of a parent folder for the composition (inside the AE Template). You can use it in case of similar composition names in the same category but with other folder names. Ex.: “Typo Assets”

comp_name [Optional] Your own composition name (in case you need it to differ from a name of element in package structure). Notice: Use the attribute if you want the name in package structure differ from name of the composition in AE project. Ex.: “Other Comp Name”

layer_sets [Optional] Settings of a composition layer (you can activate several layers if write them in line and separate each by “:”).

• 3D – use for 3D layer

• ADJUSTMENT – adjustment layer

• COLLAPSE_TRANS – collapse transformation

of layer

• MO_BLUR – do the motion blur of the layer

(motion blur)

Ex.: “3D:MO_BLUR”

Page 16: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

16

layer_timing [Optional] To create markers (IN/OUT, Duration, etc.) for timing with the help of Time Remapping (specific statement). To use the attribute to the full extent you need to create any layer (Null object, Shape, Adjustment, or Solid) composition in AE project. We call the layer timing control layer afterwards. Then add a comment (ATOM_TIMING_CONTROL_LAYER),

to it and place one marker (with any name) at the endpoint of your animation (for animation reverse by markers)

• COPY_MARKERS – simply copy the markers from timing control layer without Time Remapping (including earlier set names of markers).

• TIME_REMAP_ONLY – just add Time Remapping without any markers and specific statement.

• TIME_REMAP_LAYER_DURATION – add Time Remapping with specific statement for time of the layer control (the longer is layer – the more it’s extended in time).

• TIME_REMAP_IN_OUT – add Time Remapping with specific statement and markers (IN & OUT) for time of the layer control. How it works: The attribute creates an empty zone between the markers IN & OUT, making a break on a point set by a marker of the timing control layer, and prosecute the animation (if expanded beyond the marker OUT). Timing control layer is obligatory. TIME_REMAP_IN_OUT_REVERSE – works similar to the previous one, but instead of prosecuting reverses the animation (from the marker OUT the animation goes шт the reveresed direction). Timing control layer is obligatory.

• TIME_REVERSE – reverses layer time without any markers or specific statements.

Ex.: “TIME_REMAP_IN_OUT_REVERSE”

Page 17: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

17

Group Attributes The options that influence all the elements (compositions) for the present template. Optional.

Example (settings for the template Brush, separated by commas):

Attribute Description

custom_folder [Optional] The key folder [Atom Preview Assets] Custom folder name (explorer) for preview files. If you want a folder name to differ from the name of the group inside the extension, use the attribute mentioned, inputing the proper name. Ex.: You have a template called Instagram in the package structute, but folder with preview files (PNG/GIF) has another name, and you don’t want these two names be similar. Then just signify a proper name for the folder here:

aep_file_name [Optional]

The key folder [Atom After Effects] Looks alike the previous attribute, but works for AE Template. If you want the template name differ from the name in the package structure, use the aep_file_name attribute. Ex.: A templane has a name Stomp in the package structure, but the file with the tenplate (AEP) called differently, and you don’t want these two names be similar. Then just signify a proper name for the template here:

Page 18: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

18

label_color_num [Optional] Color of the layer on the timeline.

Enter a number to specify color (from 0 to 16).

Ex.: 3

Page 19: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

19

preview_name_instead_id [Optional] Use the name of preview file instead of its ID (for preview files PNG/GIF).

If the attribute is off or absent, files have elements ID instead of the names:

• true – use name instead of ID

• false – use ID instead of name Ex.: true

change_engine [Optional] Change of global parameter for engine_pack – detailes are here. Use the same values that set for the global parameter and they will apply to the current group replacing the global parameter settings.

change_auto_size_composition [Optional] Change of global parameter for auto_size_composition – detailes see here.

Page 20: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

20

Use the same values that set for the global parameter and they will apply to the current group replacing the global parameter settings.

change_duplicate_origin_setting [Optional] Change of global parameter for duplicate_origin_setting – detailes see here. Use the same values that set for the global parameter and they will apply to the current group replacing the global parameter settings.

change_use_start_timeline_pointer

[Optional] Added in vers. 2.1.5 Change of global parameter for use_start_timeline_pointer – detailes see здесь. Use the same values that set for the global parameter and they will apply to the current group replacing the global parameter settings.

change_layer_index_position [Optional] Added in vers. 2.1.5 Change of global parameter for layer_index_position – detailes see here. Use the same values that set for the global parameter and they will apply to the current group replacing the global parameter settings.

custom_preview_res_thumbnail [Optional] Preview display look

• DEFAULT – normal sized (landscape – 240x135), to apply a regular size just delete the attribute.

• VERTICAL – vertical (portrait - 135x240).

Page 21: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

21

• BOX_MAX – a large box (240x240)

• BOX_MIN – a small box (135x135)

More information on preview display look see here. Ex.: “VERTICAL”

is_audio [Optional] Indicates that all the elements from the group are audio files. Some settings of AE templates (make 3D layer, timing, etc.) stop functioning when the option is on. All the audio files are of one style (icon and preview) that is already integrated into the extention. The main choise of stylization is the form displayed for the parameter custom_preview_res_thumbnail: BOX_MAX or BOX_MIN. BOX_MIN is default if nothing is chosen. Also there is an equalizer during audio-files play (you can switch it

off in settings ) and additional information about audio files duration.

Page 22: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

22

The audio files should be inside folder (Atom Preview Assets) on the structure rout instead of preview files. Audio files should have a .WAV format In the file explorer:

In the package structure:

• true – the current group contains only audio files

• false – do not use the group as a group for audio files only Ex.: true

Page 23: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

23

Purchase Code Control If you sell a package in diverse web scraping tools (shops), you can control the purchase of a package

while installing (buyer should input a code received with the purchase), or use your own control system.

The main thing is to generate purchase codes while selling. Web scraping tools generate the codes

without assistance, or you can customize your own service.

Moreover, you can generate temporary purchase codes (to limit the quantity of activations, expiration

of time) with the help of Atom’s admin panel (or emailing the project author). It’s convenient!

Available variants to get and control purchase codes:

• VideoHive (videohive.net)

• Gumroad (gumroad.com)

• Your own system

Page 24: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

24

Purchase Code Control [VideoHive] To control purchase you will need your personal token. To create the token visit the official website

Envato: https://build.envato.com/create-token

Login, dial name of token (of any kind) and adjust enabling required:

Thus, you agree to give access to your sakes history (that’s the way the system controls purchase codes).

Press the button to create a token and copy its code (it appears just once, if you lose it, you'll have to

create a new one).

Send written token code to us (by contact section from our website) or enter it at Atom’s admin panel

(complete information will be available later).

Page 25: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

25

Purchase Code Control [Gumroad] Launch the key generation of your item:

Instead of token (as it is for VideoHive), we need only link to your item from Gumroad, but just the part

with the ID:

Send it to us or enter it at Atom’s admin panel. Unlike token for VideoHive, the link (items ID) has to be

entered not to your profile but to package settings were that kind of activation is used.

Purchase Code Control [Own ad-hoc] We can connect the extension with your own purchase control system.

Contact us by E-mail (by contact section from our website) for further discussion.

The service is available if you purchase tariff rates either Enterprise or Special, otherwise it’s extra pay.

Page 26: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

26

Package Testing For package testing you need:

1) Have the latest version of the extension (you can check it on website).

2) Switch on a tester mode in the extension.

What’s the point of the tester mode? You need a tester mode to have an opportunity to test your packages any time and adjust them as

convenient.

In the tester mode you can only set a package that has TEST_MODE written in the inside_security

attribute.

Aspects of tester mode:

• You cannot neither set no run someone else's package into the tester mode.

• You can apply basic functions only (package interface, templates applying, etc.), block of

favorites, search and other subtle things will not work.

• The added package will not set up (copied, etc.), after extension reboot the package will vanish

from the extension.

• To see the package header you need to place the image file near the package (header name

custom_header_name, PNG format).

Page 27: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

27

How to switch the tester mode on? Open the extension, press settings tab page and chose Tester Mode:

Then you’ll se a notification that the mode is on.

Also you can see this information at the bottom of the extension

How to switch the tester mode off? The same way you switch it on!

Page 28: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

28

Attachment for creation of a package structure and

package compilation For all authors from the Atom (after tariff payment) we provide a program for After Effects (script

panel). We constantly improve the utility so some of the screenshots may not correspond to the latest

version of the program.

You can add it into a folder ScriptUI Panel of your After Effects (to fix it inside the program and for more

convenience) or just laung it from tab page File -> Scripts -> Run Script File… -> Atom Toolkit Helper

[version].jsxbin

What can the utility do? It helps to create automatically convertible composition sizes, makes it easy to

apply the settings you need to be in a package (text markers, timeline markers, layers with controllers),

and moreover it creates a project structure that contains a list of preferable options (course of elements

numeration) and implements compilation (creation of the final version of the package).

Page 29: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

29

Auto Resize (creation of adaptive composition sizes)

The left column Add Nulls For contains buttons for flective sizes creation:

• Save Aspect Ratio – check mark pointing if there is a need to maintain the proportions (for ex., if

video elements, text end etc. used). Works for Background only.

• New Group – create a new group (Null object). You need to press Global Group before creation

(required before regular groups).

• Global Group – global group of the composition.

• Background – add null object for the background.

The right column Change Comp Size allows seeing the result quickly, all you need is to choose preferable

size and press the button.

If you choose a layer beforehand and press the button from the left column, the program automatically

connects the chosen layer to created null object (you can use it or not).

How it works in details?

Example of how the script works (another interface, but equal implementation):

https://www.youtube.com/watch?v=zbKd6BroygA

Let’s create a null object (with the help of the script) for the Background.

Choose preferable background (one layer or several at a time) and press the button Background. After

that, the utility creates null object and the layers you marked are connected to the null object.

Let’s change composition size to check the work:

Page 30: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

30

1920x1080 (our proportions)

1080x1920 (outside our proportions)

Now let’s create groups (New Group), but before it we need to create a Global Group of the

composition.

Page 31: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

31

Unmark all the layers (otherwise they will be connected to the global layer, that will not allow you do

your own objects upsizing), and press the button.

Then create necessary elements and locate them as needed, example below contains two text layers:

Press to create a New Group. Unmark all the layers, as we want to add upsizing for two elements, and

click twice the button of making a new group.

The first null object carry over the point of the first symbol of layer Left, now it will be fixed there even

when proportions changed.

Page 32: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

32

The second null object transfer to the last symbol of the layer with text Right.

Now connect text layers to corresponding null objects:

Done!

Let’s change the proportions to 1080x1920:

Page 33: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

33

What do you think? I think that’s great!

Also let’s play a bit with size (click ++), inscription on the buttons will change, and you’ll be able to

choose other size:

Let’s pick 2160x2160:

Page 34: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

34

That’s perfect! And there can be a great lot of elemens!

Page 35: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

35

Special Marking for Bounding with Atom You can add special marks (comments) to layers manually, or you can simplify a problem and use our

script. Go to tab page Atom Sets.

The left column allows adding a comment to a certain layer (or layers). Comments for letting the Atom

know what you pointed

• Text Layers – text layers that you can edit with Atom

• Customizer Layer – layer with settings (effects, controllers, that Atom need to get, so that you

could configure them with Atom)

• Timing Layer (with Marker) – layer with time index (pointed by markers)

The right column allows doing many things quickly: highlight all the layers in composition, add

preferable value to all compositions, etc. We’ll talk about it later.

Let’s start adding special marks to layers (comments for Atom), but first let’s make comments of layers

visible:

Сlick with a right mouse button on that space:

Next:

Page 36: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

36

Enable comments.

Page 37: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

37

Mark-comment for Settings Layer (Customizer Layer) Let’s create a null object, highlight it and press button Customizer Layer.

The special comment ATOM_CUSTOMIZER_LAYER was added on layer (information about all special

comments is in chapter Package creation), as well as simple marker with plane description of the layer.

Now this level is a control level for effects and Atom will catch it for settings. Let’s check it, add a couple

of control levels on layer (Color Control, Slider Control) and name them as you like.

Now open Atom and press Customizer button while in composition (it’s not necessary to highlight

layer, Atom will catch it when you are in the composition or when you are in another composition and

highlighting layer as a composition. You can check it yourself).

Atom successfully cached the control level. Here you can indicate any controllers that you want to see in

Atom (through pressing on Customizer, in case if the parameters are switched on it package settings).

Page 38: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

38

Mark-comment for Text Layers Now let’s assign marks to text layers. For example create two text layers and highlight only one of them:

Then press the button Text Layers and the system will add a comment ATOM_TEXT_EDITOR_LAYER to

the text, due to the comment Atom will recognise the layer with text.

Now launch Atom once again and due to the layer described above (Customizer layer, Atom needs it to

catch further parameters), you can press Customizer button and see the layer for editing:

Why do we see only one layer when we have two of them?

The thing is that only one layer has the special comment, that’s why we see only this layer. As soon aas

you added special comment to both layers, you would see them both. Atom also searches for text layers

through all inner compositions no matter how many of then you have. The main thing is that

compositions have to have special comment so that Atom would know what to do.

Page 39: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

39

Mark-comment for Indicators of Time Settings Let’s customize time indicators. Create a null object, add a marker to the object (it can have any name,

but for some parameters in Atom structure that name will be copied to the main composition). Place

the marker to the end of composition animation (the length doesn’t matter, it can be in a point of

marker, or even very long). After that highlight the null object and press the button:

And the system adds a special comment ATOM_TIMING_CONTROL_LAYER to the layer.

These parameters cannot be checked without importing of compositions, so we won’t do checking.

Page 40: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

40

Express Creation and adding of Mark-comments (cycle) You can easily and quickly add marks to all text layers or create null object for customizer or time

settings!

The right column will help:

● Create Customizer with Fx – create null object with a couple of effects (for example) and a

mark-comment.

● Create Timing Layer – create null object with marker (places marker on the place of cursor) and

a special comment.

● Select All Text Layers – highlight all text layers in current composition (so that you could add all

mark-comments by only one button in a follow-up).

● Add Mark to All Texts in Comps – add mark-comments to all text layers for each chosen

composition (in a project structure).

● Save Screenshots (timing layer) – render screenshots (.PNG) for chosen compositions (in a

project structure) by pointing marker Timing Layer.

● Save Screenshots (simple) – as above, but without time layer, % of composition time is taken

(.PNG).

Page 41: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

41

Creation of a Project Structure (with pointing the options needed) You can quickly generate a project structure in tab Create Pack Structure:

There are more tabs inside, but they contain parameters.

● Groups – allows adding groups (or you may not add) and indicate the teplate name.

● Items – basic parameters (ID, name of element, options).

● Custom Args – elements own arguments (Parent Folder, Comp Name, etc.).

● Group Options 1 и Group Options 2 – settings for current group of elements in a project structure.

And Output panel:

In the panel you can set the number of elements generation with countdown, and press Create

Structure. You can press the button anytime, even with basic settings.

● Counter – a number of elements to generate

● Count From – numeration of elements from the number set

● For – for which parameters you need to use a counter

● Num Style – style of the counter

Page 42: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

42

Groups

1. Switch on the whole panel and its settings (if switched off the code will be smaller and without

indication of templates/groups and their structure)

2. Add a new group and its name to the right.

3. As above (if add both groups, one of them will contain another, global group will be #1)

4. Name of template (for the menu structure of Atom - name of AEP project without a format).

You can choose any name and specify a AEP template name in group settings (see further).

Items Identify the basic parameters for elements:

1. Indicate a unique ID (without numeration, as it will be automatically added)

2. Name of element (numeration will be added)

3. Options (choose an icon and dial text)

Page 43: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

43

Custom Args Own arguments for each element (more details see in chapter about package structure creation):

1. Parent folder for the composition inside template (if needed)

2. Name of the composition (on the standard use the name, signified in structure). However, if

there is another name in structure, you can use an original one.

3. Layer settings (choose one or several options if needed)

4. Time settings for the applied layer (any parameter if needed)

Group Options Settings for a group of elements (unified)

1. Own folder (name) for preview files (if differs from name in menu structure)

2. Template name without format (on the standard use the name, signified in menu structure, that

will be the name for template). But if the name in the menu structure is different, then you can

signify an original one

3. Color for layer from 0 to 16

4. Use names instead ID (for preview files)

5. Change the engine type (for a group point out another, different from global one)

Page 44: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

44

Further tab with group parameters (Group Options 2):

1. Own options of size auto-change for group (different from global options)

2. Own options of doubling of the original composition for the current group (different from global

options)

3. Own options for the layer beginning on timeline (different from global options)

4. Own options for position of layer index on timeline (different from global options)

5. Own options of aspect ratio for preview (different from global options)

6. Use the current group for audio files – the group will work only with audio files. See details of

mentioned parameters here.

After all changes (or you can do nothing and just press the button to check how the code would look

like), identify number of elements generation, better start with 1 or 2. Then appoint a numeration start

(let’s leave 0 now), press button Create Structure.

In the example given we generated a code with basic options.

If we clear up the first parameter from the first tab:

Page 45: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

45

And try to generate the code again, we get the code without template name, but only with its structure

(including preview part):

However if we enable the setting again and add another group:

The group will be pointed in the code structure (and in Atom’s package menu).

Now the code looks like this (including one group, template, and elements structure).

Closure: due to generation with the script you can see and understand, how a structure of package is

being created. Gather needed one, you can copy it and add to the package.

Page 46: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

46

Compilation of package (creation of the final version) If you tested your package and sure it’s ready, then it’s time to compile it.

Pass to the tab Build Package:

Here you need to choose a compiler (a utility ExtendScript Toolkit, you can download it fo free from

Adobe, through Creative Cloud or straight. More likely you already have the program on your

computers, as it automatically sets up while installing After Effects).

Approximate route to program is already declared (for Windows), if change - will be automatically saved

for the current AE version.

The next step is to choose your package (.ATOM).

Now let’s specify options for Image Header:

Choose the type needed:

● Default – do not change the options (if you didn’t specified manually, the header will be empty)

● Add New – add a new header

Page 47: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

47

● Remove Header – delete header (if you specified the header manually in bytes, when you remove

it there will be the default image instead of header)

While choosing Add New – appoint the .PNG image route. Information about creating of the header see

here.

Noe let’s set options for Change Package Options:

You can change options that are already set in the package to the new ones:

● Default – leave options without changes (if you pointed it manually in the package and don’t

want to change it)

● DEMO – set up as a demo version for the package (the version will be changed, won’t request a

purchase code if the key was switched earlier)

● PREMIUM – set up as a paid version for the package (an opportunity to change the package

version - dial with a dot, choose the variant of package activation - with or without the purchase

code)

More details about versions see here.

After all settings press the button Compile the Package. If all options are right, the program will propose

you to choose the route for saving packed package (its final version).

Now, when the final version of the package is created (you can create individual versions for free DEMO

package (DEMO), and paid one (PREMIUM) for selling), you can sell in with the extension Atom.

p.s: any manipulations with the package now available with the help of the program (creation of demo,

full versions, versions update, adding of package header and so on…)

Page 48: List of Contents - Aniom Atom... · 2019-08-21 · For more detales see here. • true – Request • false – Do not request (indicate for free packages or while testing a package)

48

The package is ready. What’s next? The package is tested, and you’re satisfied with how it looks like? The final version is compiled?

Then congrats with successful package creation and testing!

After you get the final version, you can do whatever you wish to your package - sell, present for free,

etc.!

Send us your demo (if you have one) or add it with the help of Atoms admin panel to dispose the

package on our website.

Also your package will be added to Atom Market, you’ll have an access to downloading stats, package

installing and etc. This information as well as other convenient options you can have through the Atom’s

admin panel (information and parameters for login you’ll get by email).

Welcome to our team!