Code: Select all
"""
Sprite Batch Renderer Ex, a Blender addon
Copyright (C) 2015-2016 Pekka Väänänen
Copyright (C) 2019-2022 Nash Muhandes
MIT License
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
"""
"""
Renders the scene from multiple directions and saves the results in separate files.
The "front" direction is the same as Blender's front view, in other words your model
should face to the negative Y direction.
Multiple frames can be rendered. The animation Frame Range is read from the regular
Start Frame and End Frame rendering properties.
Usage:
Set your camera (called "Camera") to track an object placed at the origo.
Place your camera to the distance and height you'd like it to render the object from.
See Sprite Batch Render Ex section of the Render-tab for controls.
Note: the rendering process can't be canceled once started, so make sure your
Frame Range and image resolution are correct.
"""
import os
import bpy
import math
import sys
import time
import signal
from bpy.props import *
bl_info = \
{
"name" : "Sprite Batch Render Ex",
"author" : "Pekka Väänänen <pekka.vaananen@iki.fi>, Nash Muhandes (Ex fork)",
"version" : (1, 2, 0),
"blender" : (3, 2, 1),
"location" : "Render",
"description" :
"Renders the scene from multiple directions.",
"warning" : "There's currently no way to cancel rendering",
"wiki_url" : "",
"tracker_url" : "https://github.com/nashmuhandes/SpriteBatchRender/issues",
"category" : "Render",
}
class SpriteRenderSettings(bpy.types.PropertyGroup):
target: StringProperty (
name = "Target object",
description = """The Empty object with the actual models as children""",
default = ""
)
spritename: StringProperty (
name = "Sprite name",
description = """Name of sprite. Must be exactly 4 letters. The last letter of the sprite will be replaced with a single number (from 0 to 9) every 26 frames""",
default = ""
)
path: StringProperty (
name = "Sprite render path",
description = """Where to save the sprites""",
default = "",
subtype = 'FILE_PATH'
)
class SpriteRenderOperator(bpy.types.Operator):
bl_idname = "render.spriterender_operator"
bl_label = "Sprite Render Operator"
bl_options = {'REGISTER'}
def execute(self, context):
#if frame_start is None:
frame_start = context.scene.frame_start
#if frame_end is None:
frame_end = context.scene.frame_end
#if frame_step is None:
frame_step = context.scene.frame_step
self.render(
context.scene,
context.scene.sprite_render.target,
context.scene.sprite_render.spritename,
context.scene.sprite_render.path,
frame_start,
frame_end,
frame_step
)
return {'FINISHED'}
def render(self, scene, obj_name, spritename, filepath,\
start_frame=0, end_frame=0, frame_step=0):
os.system("cls")
camera = scene.camera
if camera is None:
self.report({'ERROR_INVALID_INPUT'}, "No camera exists! Please add a camera into your scene!")
return
old_frame = scene.frame_current
if not obj_name in scene.objects:
self.report({'ERROR_INVALID_INPUT'}, "Target object '%s' not found!" % obj_name)
return
obj = scene.objects[obj_name]
if obj.type != 'EMPTY':
self.report({'ERROR_INVALID_INPUT'}, "Target must be an Empty object!")
return
sprite_string = spritename
# sprite name must be valid
if (len(sprite_string) != 4):
self.report({'ERROR_INVALID_INPUT'}, "Sprite name must be exactly 4 characters!")
return
angles = "12345678"
sixteen_angles = bpy.data.objects[obj.name]['SixteenAngles']
if sixteen_angles == 1:
angles = "192A3B4C5D6E7F8G"
frames = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
subsprites = "0123456789"
total_angles = len(angles)
total_frames = len(frames)
total_subsprites = len(subsprites)
# too many frames
if end_frame > (total_frames * total_subsprites):
self.report({'ERROR_INVALID_INPUT'}, "Animation exceeds %i frames!" % total_frames * total_subsprites)
return
count = 0
obj.rotation_mode = 'XYZ'
orig_rotation = obj.rotation_euler.z
current_subsprite = 0
current_subsprite_counter = old_frame - 1
for f in range(start_frame, int(end_frame/frame_step)+1):
scene.frame_set(f*frame_step)
# only 1 step if there's no rotation
no_rotation = bpy.data.objects[obj.name]['NoRotation']
if no_rotation == 1:
total_angles = 1
mirror = bpy.data.objects[obj.name]['Mirror']
print()
# increase subsprite number
current_subsprite_counter += 1
if current_subsprite_counter > total_frames:
current_subsprite_counter = 1
if f > (total_frames * 2):
current_subsprite += 1
for ang in range(0, total_angles):
ang_max = 5
if sixteen_angles == 1:
ang_max = 9
# stop full rotation if mirrored
if no_rotation == 0 and mirror == 1 and ang >= ang_max:
break
angle = ((math.pi*2.0) / total_angles) * ang
obj.rotation_euler.z = orig_rotation - angle
print(obj.rotation_euler.z)
bpy.ops.wm.redraw_timer(type='DRAW_WIN_SWAP', iterations=1)
# if no_rotation is true, force angle 0
if no_rotation == 0:
angle_string = angles[ang]
else:
angle_string = "0"
frame_string = frames[(f - 1) % total_frames]
subsprite_string = subsprites[current_subsprite]
# set the full sprite string again
sprite_string = spritename
# if there are more than 26 frames, remove the last
# character from the sprite name and append the subsprite
if f > total_frames:
sprite_string = sprite_string[:-1]
else:
subsprite_string = ""
# handle mirroring
if no_rotation == 0 and mirror == 1:
if sixteen_angles == 0:
# 2 and 8
if ang == 1:
angle_string = angle_string + frame_string + "8"
# 3 and 7
elif ang == 2:
angle_string = angle_string + frame_string + "7"
# 4 and 6
elif ang == 3:
angle_string = angle_string + frame_string + "6"
else:
# 9 and G
if ang == 1:
angle_string = angle_string + frame_string + "G"
# 2 and 8
elif ang == 2:
angle_string = angle_string + frame_string + "8"
# A and F
elif ang == 3:
angle_string = angle_string + frame_string + "F"
# 3 and 7
elif ang == 4:
angle_string = angle_string + frame_string + "7"
# B and E
elif ang == 5:
angle_string = angle_string + frame_string + "E"
# 4 and 6
elif ang == 6:
angle_string = angle_string + frame_string + "6"
# C and D
elif ang == 7:
angle_string = angle_string + frame_string + "D"
scene.render.filepath = filepath + sprite_string + subsprite_string + frame_string + angle_string
bpy.ops.render.render(animation=False, write_still=True)
#print ("%d:%s: %f,%f" % (f, angle_string, camera.location.x, camera.location.y))
count += 1
print ("Rendered %d shots" % (count))
scene.frame_set(old_frame)
obj.rotation_euler.z = orig_rotation
class SpriteRenderPanel(bpy.types.Panel):
bl_idname = 'sprite_panel'
bl_label = 'Sprite Batch Render Ex'
bl_space_type = 'PROPERTIES'
bl_region_type = 'WINDOW'
bl_context = "render"
def draw(self, context):
l = self.layout
framerow = l.row()
props = context.scene.sprite_render
l.column().prop_search(props, "target", context.scene, "objects",\
icon='OBJECT_DATA', text="Target object")
if props.target not in context.scene.objects:
l.column().label(text = "Invalid target object '%s'!" % (props.target),
icon='ERROR')
l.row().prop(props, "spritename", text="Sprite name")
if len(context.scene.sprite_render.spritename) != 4:
l.column().label(text = "Invalid sprite name!",
icon='ERROR')
l.row().prop(props, "path", text="Output path")
row = l.row()
row.operator("render.spriterender_operator", text="Render Batch", icon='RENDER_ANIMATION')
classes = (SpriteRenderOperator, SpriteRenderPanel, SpriteRenderSettings)
def register():
for cls in classes:
bpy.utils.register_class(cls)
bpy.types.Scene.sprite_render = bpy.props.PointerProperty(type=SpriteRenderSettings)
def unregister():
for cls in reversed(classes):
bpy.utils.unregister_class(cls)
del bpy.types.Scene.sprite_render
if __name__ == "__main__":
register()
