Jump to content

BlenderOni: Difference between revisions

Added image of the BlenderOni panel
(Added image of the BlenderOni panel)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
{|style="float:right"
{|style="float:right"
|[[Image:Guido_-_Kon_face_07.jpg|thumb|150px|Note to self: no more pizza before bed! Nightmares! ]]
|[[Image:BlenderOni.png|thumb|130px|BlenderOni version 1.0.1]]
|}
|}
'''BlenderOni''' is a [[Blender]] add-on intended as an integral companion tool for the [[Using_the_Rigify_animation_rig|Animation rig for Blender]]. It contains functionalities that automate a lot of operations necessary for the rig to function and be used properly. However, the vast majority of the add-on's options can also be used for general Blender tasks.  
'''BlenderOni''' is a [[Blender]] add-on intended as an integral companion tool for the [[Using_the_Rigify_animation_rig|Animation rig for Blender]]. It contains functionalities that automate a lot of operations necessary for the rig to function and be used properly. However, the vast majority of the add-on's options can also be used for general Blender tasks.  
Line 7: Line 7:


==History==
==History==
{|style="float:right"
|[[Image:Guido_-_Kon_face_07.jpg|thumb|150px|''Note to self: no more pizza before bed! Nightmares!'' ]]
|}
When the Rigify-Oni rig was first released to the public, it was meant to be used together with a number of scripts stored within the Blender scene containing the rig. However, those scripts were not ideal - they were awkward to use as setting up the appropriate values was possible only by changing the script code.
When the Rigify-Oni rig was first released to the public, it was meant to be used together with a number of scripts stored within the Blender scene containing the rig. However, those scripts were not ideal - they were awkward to use as setting up the appropriate values was possible only by changing the script code.


Those scripts have become obsolete with the introduction of BlenderOni, which is essentially little more than those scripts wrapped into a GUI. The scripts are nonetheless archived [[Blender/Obsolete scripts|HERE]] for legacy purposes.
Those scripts have become obsolete with the introduction of BlenderOni, which is essentially little more than those scripts wrapped into a GUI. The scripts are nonetheless archived [[Blender/Obsolete scripts|HERE]] for legacy purposes.
==Tutorial video==
BlenderOni has its own tutorial video, with the Options explained in Part 2, and Use cases explained in Part 3.
The video can be accessed [https://www.youtube.com/watch?v=pA_Y8QBCvPI HERE].
==Use cases==
Since BlenderOni is a companion tool for the Rigify-Oni rig, explanation of its intended usage is in the rig documentation, available [[Using_the_Rigify_animation_rig|HERE]].


==Options==
==Options==
===Bake Keyframe Rotation Mode===
===Bake Keyframe Rotation Mode===
Keyframes the rotation data in the selected rotation mode for every selected object, for every frame in the specified frame range. Usually used for converting rotation data from Euler angles to Quaternions if needed.
Keyframes the rotation data in the selected rotation mode for every selected object, for every frame in the specified frame range. Usually used for converting rotation data from Euler angles to Quaternions if needed. '''Use in Object Mode.'''


===Change Rotation Mode===
===Change Rotation Mode===
Changes the rotation mode of every selected object to the selected rotation mode.
Changes the rotation mode of every selected object to the selected rotation mode. '''Use in Object Mode.'''


===Adjust Throw Target===
===Adjust Throw Target===
Line 23: Line 34:
If the "Adjust back throw target" operation is selected and the object's location is not { X , Y } = { 0 , 0 }, it gets moved to { X , Y } = { 0 , 0 }.
If the "Adjust back throw target" operation is selected and the object's location is not { X , Y } = { 0 , 0 }, it gets moved to { X , Y } = { 0 , 0 }.


Used for adjusting the position of the throw target animation, both for forward (Adjust and rotate throw target) and back (Adjust back throw target) throws.
Used for adjusting the position of the throw target animation, both for forward (Adjust and rotate throw target) and back (Adjust back throw target) throws. '''Use in Object Mode.'''


If you are importing an animation from Oni, the X, Y and Z fields are supposed to be taken from the <Position> tag. The position tag has the following order:
If you are importing an animation from Oni, the X, Y and Z fields are supposed to be taken from the <Position> tag. The position tag has the following order:
Line 52: Line 63:


===Bone Visual Transformer===
===Bone Visual Transformer===
Applies visual transform and keyframes rotation and location data for every selected bone of the aramture in the specified frame range. Used as a way to copy animation data from character models to the rig. '''Use in Pose Mode.'''
Applies visual transform and keyframes rotation and location data for every selected bone of the armature in the specified frame range. Used as a way to copy animation data from character models to the rig. '''Use in Pose Mode.'''


===Set Object Constraint Targets===
===Set Object Constraint Targets===
Line 75: Line 86:


===Constrain Character Model===
===Constrain Character Model===
On the selected Oni character model, creates a set of Copy Location and Copy Rotation constraints targeting a specified rig. Effectively constrains the selected Oni character model to the specified rig. '''Can be used in any object interaction mode.'''


==Use cases==
If any of the model objects already contain any constrains, BlenderOni will output an error, and the user should clear all constraints in the selected objects.
To be further described, but probably best to link to the [[Using_the_Rigify_animation_rig|rig documentation]]


[[Category:Completed modding tools]][[Category:Bi-platform modding tools]]
[[Category:Completed modding tools]][[Category:Bi-platform modding tools]]
191

edits