refactor: Update sequence method calls for consistency across scripts

- Changed instances of `xf_runner.Sequence.new` to `xf_runner.sequence` in various Blender and Unreal render scripts, ensuring uniformity with the updated API.
- Updated related test and tutorial files to reflect the new method name, enhancing clarity and consistency in documentation.

Author: HaiyiMei

samples/blender/03_basic_render.py

@@ -3,6 +3,7 @@
 
 This is a script to render a preset level in blender.
 """
+
 from pathlib import Path
 
 import xrfeitoria as xf
@@ -49,7 +50,7 @@ def main(debug=False, background=False):
     )
 
     # by creating a new `sequence`, XRFeitoria links a new collection named `{seq_name}` to the level.
-    with xf_runner.Sequence.new(seq_name=seq_name, level='Scene') as seq:
+    with xf_runner.sequence(seq_name=seq_name, level='Scene') as seq:
         # The cameras in the level will not be used for rendering by default,
         # but you can activate them by calling `seq.use_camera(camera)`.
         # There is a camera named `Camera` in the level, and we use it for rendering.

samples/blender/04_staticmesh_render.py

@@ -3,6 +3,7 @@
 
 This is a script to render static meshes in blender.
 """
+
 import math
 from pathlib import Path
 
@@ -64,7 +65,7 @@ def main(debug=False, background=False):
     ##################################################
     #### Create a new sequence with default level ####
     ##################################################
-    with xf_runner.Sequence.new(seq_name=seq_1_name) as seq:
+    with xf_runner.sequence(seq_name=seq_1_name) as seq:
         # use the `camera` in level to render
         seq.use_camera(camera=camera)
 
@@ -85,7 +86,7 @@ def main(debug=False, background=False):
     ########################################################
     #### Create another new sequence with default level ####
     ########################################################
-    with xf_runner.Sequence.new(seq_name=seq_2_name) as seq:
+    with xf_runner.sequence(seq_name=seq_2_name) as seq:
         # import an actor to the sequence, and add transform keys to make it rotate around the bunny and grow bigger and bigger
         actor_kc = seq.import_actor(file_path=assets_path['koupen_chan'], stencil_value=255)
         actor_kc.set_origin_to_center()

samples/blender/05_skeletalmesh_render.py

@@ -3,6 +3,7 @@
 
 This is a script to render skeletal meshes in blender.
 """
+
 from pathlib import Path
 
 import xrfeitoria as xf
@@ -38,7 +39,7 @@ def main(debug=False, background=False):
     ### Create a new sequence with the defined level ###
     ####################################################
     seq_length = 200
-    with xf_runner.Sequence.new(seq_name=seq_name, level='MyLevel', seq_length=seq_length) as seq:
+    with xf_runner.sequence(seq_name=seq_name, level='MyLevel', seq_length=seq_length) as seq:
         # import an skeletal mesh and set an animation to it
         actor = seq.import_actor(file_path=assets_path['SMPL_XL'], stencil_value=128)
         actor.setup_animation(animation_path=assets_path['motion_2'])

samples/unreal/03_basic_render.py

@@ -3,6 +3,7 @@
 
 This is a script to render a preset level in unreal.
 """
+
 from pathlib import Path
 
 import xrfeitoria as xf
@@ -28,7 +29,7 @@ def main(debug=False, background=False):
 
     # open a pre-made sequence, which has a corresponding level
     # the sequence data is under /Game/XRFeitoriaUnreal/Sequences/{seq_name}_data
-    with xf_runner.Sequence.open(seq_name=seq_name) as seq:
+    with xf_runner.sequence(seq_name=seq_name) as seq:
         # use the camera in the level to render
         camera = xf_runner.Camera('Camera')
         camera_name = camera.name

samples/unreal/04_staticmesh_render.py

@@ -3,6 +3,7 @@
 
 This is a script to render static meshes in unreal.
 """
+
 import math
 from pathlib import Path
 
@@ -62,7 +63,7 @@ def main(debug=False, background=False):
     ####################################################
     ######## Create a new sequence with level   ########
     ####################################################
-    with xf_runner.Sequence.new(level=dst_level_path, seq_name=seq_1_name, replace=True) as seq:
+    with xf_runner.sequence(level=dst_level_path, seq_name=seq_1_name, replace=True) as seq:
         # show the sequence in unreal editor
         seq.show()
         # use the `camera` in level to render
@@ -86,7 +87,7 @@ def main(debug=False, background=False):
     ####################################################
     ##### Create another new sequence with level   #####
     ####################################################
-    with xf_runner.Sequence.new(level=dst_level_path, seq_name=seq_2_name, seq_length=6, replace=True) as seq:
+    with xf_runner.sequence(level=dst_level_path, seq_name=seq_2_name, seq_length=6, replace=True) as seq:
         # show the sequence in unreal editor
         seq.show()
 

samples/unreal/05_skeletalmesh_render.py

@@ -3,6 +3,7 @@
 
 This is a script to render skeletal meshes in unreal.
 """
+
 from pathlib import Path
 
 import xrfeitoria as xf
@@ -30,7 +31,7 @@ def main(debug=False, background=False):
         path=assets_path['motion_1'], skeleton_path=f'{SMPL_XL_path}_Skeleton'
     )[0]
 
-    with xf_runner.Sequence.new(seq_name=seq_name, level=level_path, seq_length=200, replace=True) as seq:
+    with xf_runner.sequence(seq_name=seq_name, level=level_path, seq_length=200, replace=True) as seq:
         seq.show()
 
         # add a camera in sequence to render

tests/blender/level.py

@@ -1,6 +1,7 @@
 """
 >>> python -m tests.blender.level
 """
+
 from pathlib import Path
 
 import xrfeitoria as xf
@@ -23,7 +24,7 @@
 
 
 def seq_simple(xf_runner: XRFeitoriaBlender, seq_name: str = 'seq_simple'):
-    with xf_runner.Sequence.new(seq_name=seq_name, level='Scene', seq_length=1) as seq:
+    with xf_runner.sequence(seq_name=seq_name, level='Scene', seq_length=1) as seq:
         camera = xf_runner.Camera('Camera')
         seq.use_camera(camera)
 

tests/blender/sequence.py

@@ -1,6 +1,7 @@
 """
 >>> python -m tests.blender.sequence
 """
+
 from pathlib import Path
 
 import numpy as np
@@ -31,7 +32,7 @@ def seq_actor(xf_runner: XRFeitoriaBlender, seq_name: str = 'seq_actor'):
     camera_level = xf_runner.Camera.spawn(location=(0, 10, 0))
     camera_level.look_at(target=(0, 0, 0))
 
-    with xf_runner.Sequence.new(seq_name=seq_name, seq_length=2) as seq:
+    with xf_runner.sequence(seq_name=seq_name, seq_length=2) as seq:
         seq.use_camera(camera_level)
         camera = seq.spawn_camera(camera_name='camera', location=(-10, 0, 0), rotation=(90, 0, -90), fov=39.6)
 
@@ -85,7 +86,7 @@ def seq_actor(xf_runner: XRFeitoriaBlender, seq_name: str = 'seq_actor'):
 
 
 def seq_shape(xf_runner: XRFeitoriaBlender, seq_name='seq_shape'):
-    with xf_runner.Sequence.new(seq_name=seq_name, seq_length=6) as seq:
+    with xf_runner.sequence(seq_name=seq_name, seq_length=6) as seq:
         camera = seq.spawn_camera(location=(-10, 0, 0), rotation=(90, 0, -90), fov=39.6)
 
         xf_runner.utils.set_frame_current(frame=3)

tutorials/01_get_started.ipynb

@@ -198,7 +198,7 @@
                 "\n",
                 "# Use `with` statement to create a sequence, and it will be automatically close the sequence after the code block is executed.\n",
                 "sequence_name = 'MySequence'\n",
-                "with xf_runner.Sequence.new(seq_name=sequence_name, replace=True) as seq:\n",
+                "with xf_runner.sequence(seq_name=sequence_name, replace=True) as seq:\n",
                 "\n",
                 "    # Add a camera and make it look at the koupen-chan\n",
                 "    camera_location = (0.0, -0.8, 0.0)\n",

tutorials/02_randomization.ipynb

@@ -311,7 +311,7 @@
                 "# Use the `with` statement to create a sequence, and it will be automatically close the sequence after the code block is executed.\n",
                 "# The argument `seq_length` controls the number of frames to be rendered. \n",
                 "sequence_name = 'MySequence'\n",
-                "with xf_runner.Sequence.new(seq_name=sequence_name, seq_length=frame_num, replace=True) as seq:\n",
+                "with xf_runner.sequence(seq_name=sequence_name, seq_length=frame_num, replace=True) as seq:\n",
                 "    ##############################\n",
                 "    ##### Add transform keys #####\n",
                 "    ##############################\n",