User's guide
Installation¶
- Download the latest release from your Superhive , Gumroad or ArtStation account.
- Open Blender and navigate to
Edit > Preferences > Add-ons[1, 2, 3]. - Click on the [4] then
Install from Disk...button [5] and select theso_sprite-1.2.x.zipfile. - Enable the "SO-Sprite" add-on by checking the box next to it [6].
- Save parameters

If you want to see the process, check some YouTube content
Warning
The version 1.2 of the add-on works with Blender 4.5 and higher only.
Before you start¶
The Camera¶
The angles of the Sprites are calculated according to the current Camera. It is therefore possible to change Camera during animation without altering the orientation of the Sprites. However, it is not possible to orientate the Sprites with an other Object, unless you manually modify the Geometry Node associated with the Sprites.
Preferences¶
To ensure concordance of values between the N-Panel and Modifier Geometry Node, a polling system had to be implemented. This can be set in the add-on's preferences. To find this window, please refer to chapter "Installation".

Add a Sprite¶
N-Panel¶
First go to the SO N-Panel. If you can't see it, press N to toggle on the panel's visibility. Search for the "SO-Sprite" tab.
Media File¶
You can use all video an image files supported natively by Blender as well as image sequences (1). When the file is selected, the resolution is automatically set.
- To select an image sequence, select the first file then select the last one when holding Shift
Image sequence numbering
You absolutely must have a file numbering starting with 0. For example img_0000.png, img_0001.png,...
Plane Scale¶
This parameter is used to define a general size ratio. With scale = 1.0 a 1000x1000 px media will set to 1x1 Blender unit. You can, of course, resize the sprite later using Gizmo or the S key. The aim here is to easily reuse this ratio on all subsequently created sprites.
Tracking¶
Tracking ensures that the sprite is always oriented towards the camera.
2D: Rotation will take place only on theZaxis. The sprite will always be perpendicular to the ground.3D: Rotation will take place on theZandXaxes. The sprite's normal will always point towards the camera.Flat: The sprite will have exactly the same rotation as the camera. It will not be distorted by perspective.None: No tracking will be applied. Useful for placing an animation anywhere you like.
Origin Position¶
Allows you to change the center of the Object according to 5 predefined positions Bottom (1), Center, Top, Left and Right.
- Default position

Animation¶
Start from current frame is used to set the starty frame of the video / image sequence according to the current position of the playhead. The animation will start from the current frame.
Create Sprite¶
This is the button to start sprite creation.
![]()
Note
The sprite will be created at the location of the 3D cursor, depending on the position of the Object origin.
Active camera
If Tracking is set to 2D, 3D or Flat, you need an active camera. Otherwise a waring message will be displayed and the button will be disabled.

Tweak a Sprite¶
Tracking Update¶
The 4 modes are the same as tracking in Create section. But in some cases, problems can arise.
Note
If a sprite has been created in None tracking mode and there is no active camera, then it will be impossible to change the tracking mode.
![]()
Need a camera
There is no active camera. Tracking needs it to work. Creating a new camera will solve the problem.
![]()
Rotation along Y axe¶
It is possible to rotate the Sprite on the Y-axis, which allows you to control the orientation of the Sprite facing the camera. A numerical field is available on the N-Panel for this purpose.
A rotation gizmo is also available in the viewoprt when Sprite is selected.

Animation Tools¶
Cyclic: The animation is repeated in a loop if the box is checked.
Note
Cyclic option is accessible only when the media assigned to the sprite is an animation (video or image sequence).
Fade In and Fade Out:
Each Fade can be activated from the check box.
Start Frame and End Frame determines in and out frames of each fade phase. Fade In changes the alpha from 0.0 to 1.0, while Fade Out changes it from 1.0 to 0.0.

Button [A] : This button automatically fills the Start/End Frame field according to the current frame in Blender timeline.
Button [B] : Moves the Blender timeline playhead to the sprite start/end frame.
Material¶
Emission Strength: Makes the surface light-emissive. Particularly useful for fire effects, for example. (Default 0.0)
Roughness: Makes the surface more or less reflective. 0.0 is fully reflective, 1.0 is no reflection. (Default 1.0)
Texture Interpolation: Linear is the default option for no pixelation effect, while Closest is essential for displaying pixel art sprites.
Note
It is of course possible to go to the Material section of Blender to make your own modifications if required.
Alpha¶
Use Color for Alpha: If you don't have an alpha channel on your media, you can enable this option to use image brightness (HSL or HSV mode) as alpha. Useful for smoke videos on a black background, for example.
Value or Lightness: Use the "brithgness" from HSV or HSL. Slightly different, but may improve the result.
Smoother Step: Slightly changes the curve between high and low light.
Dark Tone Opacity: Dark tone threshold. (Default 0.0)
Light Tone Opacity: Light tone threshold. (Default 1.0)

footage from actionvfx.com
Note
-
For greater precision with
Dark Tone OpacityandLight Tone Opacity, use the Shift key during mouse movement. -
The closer the values for
Dark Tone OpacityandLight Tone Opacityare, the sharper the mask. -
Inverting the values of
Dark Tone OpacityandLight Tone Opacityinverts the mask.
Change Media Source¶
The media selection field works in the same way as during sprite creation. When validated with the Apply New Media button, the sprite size will be updated with the media proportions and will retain the material settings, unless Reset material settings is activated.
Troubleshooting¶
- Manually applying a rotation with Ctrl+A will break the add-on's functionality for this sprite.
- Please contact me by email at s
oriat.fr with as much information as possible about the problem and a copy of the console (menu
Window > Toggle System Console).

