forked from aresdevo/animaide
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.html
executable file
·282 lines (282 loc) · 15.4 KB
/
readme.html
1
2
3
4
5
6
<!DOCTYPE html><html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Readme</title> </head> <body><span style="font-family: Arial;"><img src="images/AnimAide_logo.png" alt="AnimAide Logo" title="AnimAide Logo"><br> </span> <p><span style="font-family: Arial;">Hello there! This is <a href="https://github.com/aresdevo/animaide" title="AnimAide"><b>AnimAide</b></a>, an add-on for Blender that has some helpful tools for animation.<br> <br> In contrast to modeling, when animating there are not that many options to manipulate the keys on a fcurve like you can with the vertex on a geometry. When modeling there are countless ways to edit geometry, but when it comes to working in the graph editor we are out of luck.<br> <br> That is where <a href="https://github.com/aresdevo/animaide" title="AnimAide"><b>AnimAide</b></a> comes in. It gives you the ability to simultaneously manipulate a group of keys across multiple fcurves from either animated objects or animated bones in an armature.<br> <br> There are some Blender options to manipulate keys, but <a href="https://github.com/aresdevo/animaide" title="AnimAide"><b>AnimAide</b></a> open the door to new possibilities. Not only has a wider range of tools but when working with a group of fcurves each one will have their local space.<br> </span></p> <p><span style="font-family: Arial;"><img src="images/multi_curves.gif" alt="multi-curves" title="Multi-curves"> <br> <br> This kind of tools is standard in the game and film industry.<br> </span></p> <h2><span style="font-family: Arial;"><b>Instalation</b><br> </span></h2> <p><span style="font-family: Arial;">Go to this online address: <a href="https://github.com/aresdevo/animaide%20%20" title="https://github.com/aresdevo/animaide ">https://github.com/aresdevo/animaide
</a>and download the addon to a chosen folder on your computer.<br> <br> Then in Blender, go to "Add-ons" tab on the preference window. There click on the "Install" button and navigate to the folder where you downloaded the add-on. Choose the AnimAide file and it will be installed.<br> <br> Make sure the add-on check-mark is active.<br> <br> </span></p> <p style="text-align: left;"><span style="font-family: Arial;"><img src="images/blender_preferences.jpg" alt="blender_preference_window" title="Blender Preference Window"><br> </span></p> <p><span style="font-family: Arial;">After installed you can find AnimAide panels on a tab in the Graph Editor's sidebar.<br> <br> At the moment, AnimAide has two main panels: <b>Sliders</b> and <b>AnimTransform</b>.<br> </span></p> <div style="text-align: left;"><img src="images/interface.jpg" alt="interface" title="Interface"></div> <h2><span style="font-family: Arial;">Sliders</span></h2> <p style="text-align: left;"><span style="font-family: Arial;"><img src="images/slider_b.gif" alt="slider" title="Slider"></span></p> <p><span style="font-family: Arial;"></span><span style="font-family: Arial;"></span><span style="font-family: Arial;">The
slider is a series of buttons where the center one activates a slider mode when you click on it (you don't have to keep pressing the mouse). To accept the value of the slider you simply left-click again or right-click to cancel. The buttons at either side of the center circle apply the tool in increments of 25%<br> </span></p> <p style="text-align: left;"><span style="font-family: Arial;"><img src="images/interface_instruction.jpg" alt="interface_instruction" title="Interface Instruction"><br> </span></p> <p><span style="font-family: Arial;">The slider preference menu provides adjustment options to the particular tool selected. <br> </span></p> <div style="text-align: left;"><img src="images/slider_options.jpg" alt="slider_options" title="Slider Options"></div> <p><span style="font-family: Arial;">The <b>Slope</b> affects some of the tools making the transition sharper <br> </span></p> <p><span style="font-family: Arial;"><em><code>I still have to take the slope option out of the menu on the tools that are not affected by it.<br> </code></em><br> <b>Overshoot</b> allows a bigger range for the slider<br> </span></p> <p style="text-align: left;"><span style="font-family: Arial;"><img src="images/overshoot.jpg" alt="overshoot" title="Overshoot"></span></p> <p><span style="font-family: Arial;"></span><span style="font-family: Arial;">At
the moment there are 14 different tools in the slider:<br> </span></p> <h3><span style="font-family: Arial;">Ease To Ease</span></h3> <p><span style="font-family: Arial;">This fcurve adjustment it is very useful because usually you want a nice transition between to different point in time. It does not remember how the curve was before activating the tool<br> </span></p> <div style="text-align: left;"><img src="images/ease_to_ease.gif" alt="ease_to_ease" title="Ease to Ease"></div> <p><span style="font-family: Arial;">With a higher slope:<br> </span></p> <div style="text-align: left;"><img src="images/ease_to_ease_slope_5.gif" alt="ease_to_ease_slope_5" title="Ease to Ease - slope 5"></div> <h3><span style="font-family: Arial;">Ease</span></h3> <p><span style="font-family: Arial;">With this one, you just have either an ease-in or an ease-out, because sometimes that is just what you need. It does not remember how the curve was before activating the tool<br> </span></p> <div style="text-align: left;"><img src="images/ease.gif" alt="ease" title="Ease"></div> <h3><span style="font-family: Arial;">Blend Ease</span></h3> <p><span style="font-family: Arial;">This is similar to "Ease", but it remembers how the curve was before engaging the tool.<br> </span></p> <div style="text-align: left;"><img src="images/blend_ease.gif" alt="blend_ease" title="Blend Ease"></div> <h3><span style="font-family: Arial;">Blend Neighbor</span></h3> <p><span style="font-family: Arial;">Progressively makes the values of the selected keys match either of the neighboring keys. it remembers how the curve was before engaging the tool.<br> </span></p> <div style="text-align: left;"><img src="images/blend_neighbor.gif" alt="blend_neighbor" title="Blend Neighbor"></div> <h3><span style="font-family: Arial;">Blend Frame</span></h3> <p><span style="font-family: Arial;">Allows you to use specific frames in the animation as reference for matching the values of the selected keys. It creates markers on the reference frames. <br> <br> it remembers how the curve was before engaging the tool.<br> </span></p> <div style="text-align: left;"><img src="images/blend_frame.gif" alt="blend_frame" title="Blend Frame"></div> <h3><span style="font-family: Arial;">Blend Offset</span></h3> <p><span style="font-family: Arial;">Move the selected keys as a block until it reaches either neighboring key<br> </span></p> <div style="text-align: left;"><img src="images/blend_offset.gif" alt="blend_offset" title="Blend Offset"></div> <h3><span style="font-family: Arial;">Push-Pull</span></h3> <p><span style="font-family: Arial;">Exaggerates the values (push) or decreases the intensity of the animation (pull)<br> </span></p> <div style="text-align: left;"><img src="images/Push_pull.gif" alt="push_pull" title="Push Pull"></div> <h3><span style="font-family: Arial;">Scale Average</span></h3> <p><span style="font-family: Arial;">Scale the values of the selected keys using the average of all the values as the anchor. <br> </span></p> <div style="text-align: left;"><img src="images/scale_average.gif" alt="scale_average" title="Scale Average"></div> <h3><span style="font-family: Arial;">Scale Left</span></h3> <p><span style="font-family: Arial;">Scale the values of the selected keys using the left neighboring key as the anchor. <br> </span></p> <div style="text-align: left;"><img src="images/scale_left.gif" alt="scale_left" title="Scale Left"></div> <h3><span style="font-family: Arial;">Scale Right</span></h3> <p><span style="font-family: Arial;">Scale the values of the selected keys using the right neighboring key as the anchor. <br> </span></p> <div style="text-align: left;"><img src="images/scale_right.gif" alt="scale_right" title="Scale Right"></div> <h3><span style="font-family: Arial;">Smooth</span></h3> <p><span style="font-family: Arial;">It will try to average the values of the keys to smooth out the fcurve. You might have to run the slider more than once to get a smoother result.<br> <br> <code><em>I'm working on a better smoothing method</em></code><br> </span></p> <div style="text-align: left;"><img src="images/smooth.gif" alt="smooth" title="Smooth"></div> <h3><span style="font-family: Arial;">Noise</span></h3> <p><span style="font-family: Arial;">It adds random values to the selected keys. The more you move the slider to the right de more the intensity grows.</span></p> <p><span style="font-family: Arial;"><em><code>I'm working on a better noise method</code></em><br> </span></p> <div style="text-align: left;"><img src="images/noise.gif" alt="noise" title="Noise"></div> <h3><span style="font-family: Arial;">Time Offset</span></h3> <p><span style="font-family: Arial;">The effect is similar to sliding the keys in time, but with this option, the keys stay in the same frame. It works better when there are a lot of keys.<br> </span></p> <div style="text-align: left;"><img src="images/time_offset.gif" alt="time_offset" title="Time Offset"></div> <h3><span style="font-family: Arial;">Tween</span></h3> <p><span style="font-family: Arial;">A simple linear transition between the neighboring keys<br> </span></p> <div style="text-align: left;"><img src="images/tween.gif" alt="tween" title="Tween"></div> <p><span style="font-family: Arial;">Aside from accessing those tools using the slider on the panel, you can also use shortcuts for faster workflow. you can see the list on the question icon on the main panel:<br> </span></p> <div style="text-align: left;"><img src="images/shortcuts.jpg" alt="shortcuts" title="Shortcuts"></div> <p><span style="font-family: Arial;">If pie menus are your thing, We have also provided two of them<br> </span></p> <p style="text-align: left;"><img src="images/pie_menu_a.jpg" alt="pie_menu_a" title="Pie Menu A">
<img src="images/pie_menu_b.jpg" alt="pie_menu_b" title="Pie Menu B"> </p> <p><span style="font-family: Arial;">When you use either pie menus or shortcuts the main slider (that one that always shows) will change to that tool.<br> <br> But in case you like having the option to interact with different sliders at the same time, we have provided you with that option too. By clicking the plus icon on the main panel you can add extra sliders (with the minus you can remove them). Each extra slider can use any of the tools with the preferences adjusted independently (so you can have the same tools in different sliders with different preferences).<br> </span></p> <p style="text-align: left;"><span style="font-family: Arial;"><img src="images/extra_sliders_sample.jpg" alt="extra_sliders" title="Extra Sliders"></span></p> <p><span style="font-family: Arial;"></span><span style="font-family: Arial;"></span><span style="font-family: Arial;">There
is another workflow where you can jump from key to key and adjust each one just with the keyboard. For that there are some shortcuts:<br> <br> <code><em>Toward the Left Neighboring Key: (-)<br> Toward the Right Neighboring Key: (+)<br> Match Left Neigboring Key: (shift -)<br> Match Right Neigboring Key: (shift +)</em></code><br> </span></p> <div style="text-align: left;"><img src="images/key_by_key_selected_fcurve.gif" alt="key_to_key_selected" title="Key to Key -selected"></div> <p><span style="font-family: Arial;">For this to work make sure the option "Non-selected keys on frame" is checked in the main panel settings.</span></p> <div style="text-align: left;"><img src="images/settings_b.jpg" alt="settings_b" title="Settings B"></div> <p><span style="font-family: Arial;">If you choose the "Non-selected fcurves" option then you can affect all the keys in the frame even if the fcurve is not selected.<br> </span></p> <div style="text-align: left;"><img src="images/key_by_key_all.gif" alt="key_to_key_all" title="Key to Key -All"></div> <p><span style="font-family: Arial;">This shortcuts can work on multiple selected keys too, but make sure the "Non-selected keys on frame" is unchecked or you will also modify the keys on the current frame and maybe that is not what you want.<br> </span></p> <h2><span style="font-family: Arial;">Anim Transform</span></h2> <div style="text-align: left;"><img src="images/activate_anim_transform.gif" alt="activate_anim_transform" title="Activate AnimTransform"></div> <p><span style="font-family: Arial;">This tool freezes time, so any transformation you do to an animated object or armature affect the entire animation equally<br> </span></p> <div style="text-align: left;"><img src="images/anim_transform.gif" alt="anim_transform" title="AnimTransform"></div> <p><span style="font-family: Arial;">If you add a mask to it just that section will be affected. <br> </span></p> <img src="images/mask_menu.gif" alt="mask_menu" title="Mask Menu"> <p><span style="font-family: Arial;">The mask has the option of adding a blending border the fades the effect of the tool. <br> </span></p> <img src="images/anim_transform_mask.gif" alt="anim_transform_mask" title="Anim Transform Mask"> <p><span style="font-family: Arial;">You can control the shape of the blending using the mask option menu<br> </span></p> <img src="images/mask_options.jpg" alt="mask_options" title="Mask Options"> <h2><span style="font-family: Arial;">Closing</span></h2> <p><span style="font-family: Arial;">Thanks for the inspiration to all the people that have created similar tools for other software. I wanted to bring the fun to Blender and share it with the community. I hope you find these tools useful<br> <br> <br> <br> </span></p> <span style="font-family: Arial;"> </span> </body></html>