You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+9-19Lines changed: 9 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,14 +18,9 @@ Also check out the [Blender Servo Animation Arduino Library](https://github.com/
18
18
19
19
## Installation
20
20
21
-
> Note: this Add-on is compatible with Blender version**2.90 or higher**.
21
+
> Note: the latest version of this Add-on is compatible with Blender **4.2 or higher**.
22
22
23
-
1. Download the [latest version of the Add-on](https://github.com/timhendriks93/blender-servo-animation/releases/latest/download/blender_servo_animation_addon.zip) as a ZIP archive.
24
-
2. Open Blender and go to `File > Preferences > Add-ons`.
25
-
3. Click the `Install...` button, select the previously downloaded ZIP and click `Install Add-on`.
26
-
4. Enable the Add-on by checking the checkbox in the Add-ons list.
27
-
28
-
More information and screenshots can be found in the official [Blender Manual](https://docs.blender.org/manual/en/latest/editors/preferences/addons.html#add-ons).
23
+
The Add-on can be installed as a regular [Blender Extension](https://docs.blender.org/manual/en/latest/editors/preferences/extensions.html).
29
24
30
25
## Providing Servo Settings
31
26
@@ -73,16 +68,19 @@ Once all servo settings are provided and your animation is ready, you can calcul
73
68
74
69
Make sure to select the armature containing the bones/servos you want to export and choose the desired format in the `File > Export` menu:
75
70
76
-
71
+
72
+
73
+
Alternatively, you can also trigger the export via the timeline menu which is shown in the live mode section below:
77
74
78
-
Alternatively, you can also trigger the export via the timeline menu which is shown in the live mode section below.
75
+
79
76
80
77
### Export Formats
81
78
82
-
There are two different formats to choose from:
79
+
There are 3 different formats to choose from:
83
80
84
81
1.`Animation Servo Positions (.h)`: An Arduino/C/C++ style header file which can be easily included in an Arduino project.
85
82
2.`Animation Servo Positions (.json)`: A simple (non-formatted) JSON file which can be used in a more generic way.
83
+
3.`Animation Servo Positions (.bin)`: A binary file which can be used to store the animation data on an SD card.
86
84
87
85
### Using the Exported Data
88
86
@@ -99,21 +97,13 @@ To make the animation process even more intuitive, you can enable the `Live mode
99
97
100
98
This will allow you to control your servos in real-time from within Blender.
101
99
102
-
### Installing dependencies
103
-
104
-
After enabling the add-on, you can find the `Servo Positions` popover menu in the header of the timeline. Before using the live mode feature of this add-on, you might have to install some Python dependencies first by pressing the `Install dependencies` button. This will automatically install the required `pip` packages and requires an active internet connection. This process can might take a few seconds depending on the speed of your internet connection.
Afterwards you can prepare and control the connection to be used for the `Live mode` via this menu. For additional convenience, you will also find buttons to export the servo positions here.
109
-
110
100
### Setup a connection
111
101
112
102
To use the `Live Mode`, you will need to prepare a receiver which will interpret the received commands and use them to control the servo motors accordingly.
113
103
114
104
In most cases, the receiver can be considered an Arduino compatible micro controller. As a first step, a connection method should be selected via the `Method` dropdown menu.
> Note: starting the `Live Mode` will immediately send the position values for all servos based on the current frame. Make sure that this will not break anything, as the servos will try to move to their new position as fast as possible.
0 commit comments