Initial commit

Library/PackageCache/com.unity.2d.animation@3.2.6/Documentation~/2DAnimInter.md

@@ -0,0 +1,24 @@
+# Sprite Swap and 2D Animation Integration
+
+__Sprite Swap__ is integrated with the 2D Animation workflow. You must install the following packages or newer to use Sprite Swap:
+
+- [2D Animation version 2.2.0-preview.1](https://docs.unity3d.com/Packages/com.unity.2d.animation@latest/index.html?preview=1)
+- [PSDImporter version 1.2.0-preview.1](https://docs.unity3d.com/Packages/com.unity.2d.psdimporter@latest/index.html?preview=1)
+
+To ensure Sprite Swap works correctly with skeletal animation, the animation rig needs to be identical between the interchangeable Sprites. Use the [Copy and Paste](CopyPasteSkele.md) tools to duplicate the rig from one Sprite to the other Sprite(s) to ensure they can be swapped.
+
+## Asset Generation Behaviour
+
+The following is the steps that Unity takes to generate the various Sprite Swap components.
+
+1. When you import a PSB file with the [PSD Importer](https://docs.unity3d.com/Packages/com.unity.2d.psdimporter@latest/index.html?preview=1), Unity generates a Prefab and creates a [Sprite Library Asset](SLAsset.md) as a sub-Asset of this Prefab.
+
+2. Unity then generates a GameObject for each Sprite in the Prefab that does not belong to a __Category__, or is the first Label in the Category.
+
+3. Unity attaches the [Sprite Resolver component](SRComponent.md) to all Sprite GameObjects that belong to a Category.
+
+4. Unity then attaches the [Sprite Library component](SLComponent.md) to the root GameObject, and the component is set to reference the Sprite Library Asset created in Step 1.
+
+## Sprite Swap and Skeletal Animation Limitations
+
+To ensure Sprite Swap works correctly with skeletal animation, the animation skeleton rig needs to be identical between corresponding Sprites that are to be swapped. Use the [Copy and Paste](CopyPasteSkele.md) feature to copy both the bones and Mesh data from one Sprite(s) to the other corresponding Sprite(s).