Buat Video Simple Splat dengan SpatialStudio: Panduan Cepat dan Mudah!

Jika Anda sudah memahami dasar-dasar Python, tutorial ini akan sangat mudah diikuti. Namun, jika ada bagian yang kurang jelas, jangan ragu untuk bertanya di kolom komentar di bawah!

Cara Instal dan Menggunakan spatialstudio untuk Membuat Video Splat 3D

Pertama-tama, Anda perlu menginstal library bernama spatialstudio melalui pip. Library ini menyediakan utilitas tingkat rendah yang memudahkan pembuatan video splat, yaitu video 3D yang bisa Anda jelajahi dari berbagai sudut. Format video yang dihasilkan berekstensi .splv, singkatan dari SPatiaLVideo.

Instalasi spatialstudio

pip install spatialstudio

Membuat Video Splat Dasar: Cube Berubah Warna

Dalam tutorial ini, kita akan membuat video splat sederhana yang menampilkan sebuah kubus yang berganti warna antara merah dan biru setiap detik. Berikut langkah-langkahnya.

Inisialisasi Encoder

Pertama, kita definisikan resolusi video 3D berupa lebar, tinggi, dan kedalaman. Misalnya, 8x8x8; mirip dengan mengubah kualitas video 1080p ke 8p, tapi dalam ruang tiga dimensi. Kemudian, buat encoder yang bertugas mengumpulkan frame, mengompresi, dan menulis file .splv dengan framerate yang kita tentukan.

from spatialstudio import splv

width, height, depth = 8, 8, 8
encoder = splv.Encoder(
    width,
    height,
    depth,
    framerate=1.0,
    outputPath="color_cube.splv"
) 

Membuat Frame dan Menambahkan Voxel

Selanjutnya, kita buat total frame yang diinginkan dan tentukan warna merah serta biru menggunakan format RGB. Di setiap frame, kita buat objek Frame kosong dengan ukuran 8x8x8, dan mengganti warna voxel di posisi (4, 4, 4) secara bergantian antara merah dan biru berdasarkan indeks frame genap atau ganjil.

frame_total = 300  
red = (255, 0, 0)
blue = (0, 0, 255)

for frame_index in range(frame_total):
    frame = splv.Frame(width, height, depth)
    voxel_color = red if frame_index % 2 == 0 else blue
    frame.set_voxel(4, 4, 4, voxel_color)
    encoder.encode(frame) 

Selesai Mengenkode dan Menyimpan File

Setelah frame-frame selesai dibuat dan dikodekan, panggil metode finish() agar encoder menyelesaikan kompresi dan menulis file .splv di direktori kerja Anda.

encoder.finish()

Preview Video Splat 3D Anda

Anda dapat menggunakan tool preview berbasis browser gratis tanpa perlu login untuk melihat hasil .splv yang sudah dibuat. Cukup buka link berikut:

https://splats.com/preview

Jika mengalami kendala atau ingin berdiskusi, tinggalkan komentar atau bergabung di Discord komunitas.

Kode Lengkap Contoh "Color-Changing Cube"

from spatialstudio import splv

width, height, depth = 8, 8, 8
encoder = splv.Encoder(width, height, depth, framerate=1.0, outputPath="color_cube.splv")

frame_total = 300  
red = (255, 0, 0)
blue = (0, 0, 255)

for frame_index in range(frame_total):
    frame = splv.Frame(width, height, depth)
    voxel_color = red if frame_index % 2 == 0 else blue
    frame.set_voxel(4, 4, 4, voxel_color)
    encoder.encode(frame)

encoder.finish()

print(f"Created color-changing voxel animation: color_cube.splv")