Work with libraries
The library in a Animate document stores media assets that you create in the Animateauthoring environment or import to use in the document. You can create vector artwork or text directly in Animate; import vector artwork, bitmaps, video, and sound; and create symbols. A symbol is a graphic, a button, a movie clip, or text that you create once and can reuse multiple times. You can also use ActionScript to add media content to a document dynamically.
The library also contains any components that you have added to your document. Components can be either compiled clips or MovieClip based components.
You can open the library of any Animate document while you are working in Animate, to make the library items from that file available for the current document. You can search the symbols in the library by their names or their ActionScript linkage names.
You can create permanent libraries in your Animate application that are available whenever you start Animate. Animate also includes several sample libraries containing buttons, graphics, movie clips, and sounds.
You can export library assets as a SWF file to a URL to create a runtime-shared library. This lets you link to the library assets from Animate documents that import symbols using runtime sharing.
The Library panel (Window > Library) displays a scroll list with the names of all items in the library, which lets you view and organize these elements as you work. An icon next to an item’s name in the Library panel indicates the item’s file type.
note: (Animate CC and later versions only) Dragging objects from Stage to the Library panel to convert to a Symbol is deprecated, and will not be functional with Animate CC.
note: (Animate CC and later versions only) Dragging objects on to the Stage across two undocked documents is deprecated, and will not be functional with Animate CC.
You can organize items in the Library panel using folders. When you create a new symbol, it is stored in the selected folder. If no folder is selected, the symbol is stored at the root of the library.
Animate also imports animated GIF files in an organized way by placing them in a separate folder under the library root folder and naming all the associated bitmaps based on their sequence.
Columns in the Library panel list the name of an item, its type, the number of times it’s used in the file, its linkage status and identifier (if the item is associated with a shared library or is exported for ActionScript), and the date on which it was last modified.
You can sort items in the Library panel alphanumerically by any column. Items are sorted within folders.
Animate libary organizes the imported animated GIF files in a separate folder under the library root folder and names all the associated bitmaps based on their sequence.
If you import or copy a library asset into a document that already contains a different asset of the same name, choose whether to replace the existing item with the new item. This option is available with all the methods for importing or copying library assets.
The Resolve Library Items dialog box appears when you attempt to place items that conflict with existing items in a document. A conflict exists when you copy an item from a source document that already exists in the destination document and the items have different modification dates. Avoid naming conflicts by organizing your assets inside folders in your document’s library. The dialog box also appears when you paste a symbol or component into your document’s Stage and you already have a copy of the symbol or component that has a different modification date from the one you’re pasting.
If you choose not to replace the existing items, Animate attempts to use the existing item instead of the conflicting item that you are pasting. For example, if you copy a symbol named Symbol 1 and paste the copy into the Stage of a document that already contains a symbol named Symbol 1, Animate creates an instance of the existing Symbol 1.
If you choose to replace the existing items, Animate replaces the existing items (and all their instances) with the new items of the same name. If you cancel the Import or Copy operation, the operation is canceled for all items (not just those items that conflict in the destination document).
Only identical library item types may be replaced with each other. That is, you cannot replace a sound named Test with a bitmap named Test. In such cases, the new items are added to the library with the word Copy appended to the name.
Replacing library items using this method is not reversible. Save a backup of your FLA file before you perform complex paste operations that are resolved by replacing conflicting library items.
If the Resolve Library Conflict dialog box appears when you are importing or copying library assets into a document, resolve the naming conflict.
Work with library items
When you select an item in the Library panel, a thumbnail preview of the item appears at the top of the Library panel. If the selected item is animated or is a sound file, you can use the Play button in the library preview window or the Controller to preview the item.
You can search the library search panel for symbols by their names or their ActionScript linkage names.
- To search for a library item, type in the first few letters of the symbol name or the ActionScript linkage name of the library item. As you type, the list of matching symbols appears in the library panel.
When starting a supported external editor, Animate opens the original imported document.
When you delete an item from the library, all instances or occurrences of that item in the document are also deleted.
It is not necessary to delete unused library items to reduce a Animate document’s file size, because unused library items are not included in the SWF file. However, items linked for export are included in the SWF file.
If you use an external editor to modify files that you have imported into Animate, such as bitmaps or sound files, you can update the files in Animate without reimporting them. You can also update symbols that you have imported from external Animate documents. Updating an imported file replaces its contents with the contents of the external file.
Note: You can locate the imported animated GIF files organized in a separate folder under the library root folder with all the associated bitmaps named based on their sequence.
You can copy library assets from a source document into a destination document in a variety of ways. You can also share symbols between documents as shared library assets during authoring or at runtime.
If you attempt to copy assets that have the same name as existing assets in the destination document, the Resolve Library Conflicts dialog box lets you choose whether to overwrite the existing assets or to preserve the existing assets and add the new assets with modified names. Organize library assets in folders to minimize name conflicts when copying assets between documents.