Orifice Aligner v1.0.0 Plugin Usage Guidance
============================================

Attach the Orifice Aligner plugin to any Atom (e.g. an Animation Step or a sex toy) that you want to align with an orifice (mouth, vagina or anus). Open the Custom UI for the plugin. Select the target person and orifice that you want to align to. Activate the Control Position and the Control Rotation check boxes. The atom position will move to the orifice opening and rotate such that it is pointing into the orifice. If the target person moves or rotates, the Atom being controlled will maintain its position relative to the orifice opening. Adjustments can be made as follows:

- X Position Offset: The position of the Atom being controlled will move left or down relative to the orifice position and forward direction

- Y Position Offset: The position of the Atom being controlled will move up or down relative to the orifice position and forward direction

- Z Position Offset: The position of the Atom being controlled will move in front or behind of the orifice position relative to its forward direction

- Rotation Mode: The rotation mode can be set to either "Sync with target" or "Point at target"
                 Sync with target: The atom being controlled will rotate such that it pointing in the same direction as the orifice opening. This mode is the default.
				 Point at target: The atom being controlled will rotate such that it is pointing at the orifice opening. This is useful if the X or Y position offsets have been set.				 

- X Rotation Offset: The pitch rotation of the Atom will be adjusted relative to the rotation set by the Rotation Mode.

- Y Rotation Offset: The yaw rotation of the Atom will be adjusted relative to the rotation set by the Rotation Mode.

- Z Rotation Offset: The roll roation of the Atom wil be adjusted relative to the rotation set by the Rotation Mode.

Note that some VAM items are not aligned in the same direction. For example the Dildo forward direction is aligned with the shaft direction of the dildo, however the Butt Plug forward direction is not aligned with it's shaft direction. An X Rotation Offset of +90 degrees in Orifice Aligner can be used to align the Butt Plug rotation correctly.

Orifice Aligner can not be used to directly contol a body part such as a penis. Instead Orifice Aligner can contol an Animation Steps and body parts can be controlled by the parent Animation Pattern.