QLab cue list showing batch generated subtitle group cues

Cara Membuat Teks Takarir QLab dengan Cepat dari Excel, CSV, atau TXT

Jika Anda sudah menjalankan pertunjukan di QLab, bagian yang lambat jarang sekali proyektornya.

Bagian yang lambat adalah mengubah naskah, terjemahan, lembar sebar, atau dokumen teks biasa menjadi ratusan baris takarir yang siap diisyaratkan tanpa merusak berkas pertunjukan.

Seorang manajer panggung mungkin memiliki naskah Word. Seorang penerjemah mungkin memiliki lembar Excel. Seorang teknisi mungkin memiliki daftar teks biasa. Operator QLab membutuhkan sesuatu yang lain: isyarat Teks yang andal yang dapat ditempatkan ke dalam linimasa pertunjukan, dilatih, dipindahkan, dinomori ulang, dan dipicu di bawah tekanan.

Panduan ini menjelaskan alur kerja cepat QLab 5 untuk membangun takarir dari Excel, CSV, atau TXT. Panduan ini juga membandingkan metode tersebut dengan dokumentasi resmi QLab, sehingga batasnya jelas: apa yang didukung langsung oleh QLab, apa yang dapat diotomatisasi dengan AppleScript, dan di mana alur kerja takarir khusus seperti SurtitleLive menjadi lebih aman.

Bisakah QLab menampilkan takarir?

Ya. Di QLab, takarir atau teks layar biasanya dibangun dengan isyarat Teks.

Dokumentasi resmi QLab 5 menjelaskan isyarat Teks sebagai isyarat yang menampilkan teks bergaya sebagai keluaran video. Isyarat Teks dapat menggunakan pengaturan font, ukuran, gaya, perataan, warna, dan warna latar belakang, dan ketika isyarat dijalankan, QLab merender teks sebagai video. Karena isyarat Teks adalah bagian dari sistem video QLab, isyarat tersebut dapat ditetapkan ke panggung keluaran video untuk proyeksi.

Bagi tim teater, itu berarti takarir dapat menjadi isyarat QLab biasa:

  • dapat berada di daftar isyarat yang sama dengan suara, video, pencahayaan, jeda, dan momen siaga
  • dapat ditetapkan ke proyektor atau panggung layar
  • dapat diformat seperti materi visual lainnya
  • dapat dipicu dengan GO, pemicu isyarat, grup linimasa, OSC, MIDI, atau logika kendali pertunjukan lainnya

Itulah kabar baiknya.

Kabar buruknya adalah QLab bukanlah editor terjemahan. Bukan alat segmentasi naskah. Bukan penampil multi-bahasa untuk penonton. Jika Anda membuat setiap takarir secara manual di dalam QLab, Anda bisa kehilangan waktu berjam-jam sebelum latihan dimulai.

Apa yang didukung oleh dokumentasi resmi QLab

Sebelum membangun alur kerja, ada baiknya memisahkan perilaku resmi QLab dari pintasan produksi.

Kebutuhan Apa yang didukung dokumen resmi QLab Apa yang ditambahkan artikel ini
Menampilkan teks yang diproyeksikan Isyarat Teks QLab merender teks bergaya sebagai keluaran video dan dapat ditetapkan ke panggung keluaran video. Perlakukan setiap takarir sebagai satu isyarat Teks QLab.
Menghasilkan banyak isyarat Kamus AppleScript QLab mendukung make type "text" dan mengekspos properti isyarat seperti text, text alignment, fixed width, stage name, translation x, dan translation y. Gunakan baris lembar sebar atau blok teks sebagai sumber untuk setiap isyarat Teks.
Menggunakan lembar sebar Buku Masak QLab menyertakan contoh berbasis lembar sebar yang membaca baris Excel, membuat grup, membuat isyarat Teks, mengatur teks dan format, serta memindahkan isyarat ke dalam grup. Adaptasi pola yang sama untuk takarir dan teks layar, bukan kartu kilas.
Mengimpor XLSX secara asli sebagai takarir Dokumentasi publik QLab mendemonstrasikan otomatisasi Excel, bukan fitur impor takarir XLSX asli satu klik. Gunakan Excel/CSV/TXT sebagai data sumber, lalu gunakan skrip atau pengimpor untuk menghasilkan isyarat QLab.
Menyinkronkan ponsel penonton Isyarat Teks QLab menangani proyeksi lokal. Isyarat tersebut, dengan sendirinya, tidak menerbitkan status takarir berbasis peramban ke ponsel penonton. Gunakan SurtitleLive QLab Sync ketika isyarat yang sama perlu menggerakkan proyeksi dan tampilan ponsel penonton.

Perbedaan ini penting untuk SEO dan untuk akurasi produksi. Frasa yang aman bukanlah "QLab mengimpor takarir Excel secara asli." Frasa yang lebih aman dan lebih akurat adalah:

Anda dapat membuat isyarat Teks takarir QLab dari Excel, CSV, atau TXT menggunakan alur kerja berbasis lembar sebar atau skrip.

Itu sesuai dengan cara Buku Masak QLab sendiri mendekati otomatisasi lembar sebar.

Struktur tercepat: satu takarir per baris

Jika sumber Anda adalah Excel atau Google Sheets, mulailah dengan satu takarir per baris.

Jaga lembar tetap membosankan. Membosankan itu bagus. Membosankan bertahan dalam latihan teknis.

Struktur lembar sebar Excel yang membosankan untuk takarir QLab Unduh templatnya di sini: Templat Excel Takarir QLab (XLSX)

Kolom Contoh Mengapa penting
cue_number 10 Nomor isyarat QLab yang ingin Anda tetapkan.
subtitle_text Selamat datang di pertunjukan. Teks yang dilihat penonton.
operator_note Setelah bel pintu Catatan isyarat untuk operator.
language id Berguna jika Anda menyiapkan lebih dari satu versi.
stage Teks Layar Nama panggung keluaran video QLab opsional.
alignment center Biasanya center, tetapi buatlah eksplisit.

Untuk tahap awal, hanya dua kolom yang penting:

cue_number,subtitle_text
10,Welcome to the show.
11,Please turn off your phones.
12,The performance will begin shortly.

Jika takarir berasal dari penerjemah, mintalah mereka untuk tidak menggabungkan sel, memberi kode warna pada makna, atau menyembunyikan catatan produksi dalam komentar. Letakkan teks di kolom. Skrip dapat membaca kolom. Operator dapat memeriksa kolom.

Metode 1: Excel ke isyarat Teks QLab

Metode ini paling dekat dengan pola Buku Masak QLab resmi.

Idenya sederhana:

  1. Buka lembar sebar takarir di Excel.
  2. Buka ruang kerja QLab 5 target.
  3. Atur templat isyarat Teks Anda di QLab terlebih dahulu.
  4. Jalankan AppleScript yang membaca setiap baris.
  5. Untuk setiap baris, buat isyarat Teks QLab.
  6. Atur nomor isyarat, nama isyarat, teks, perataan, lebar, catatan, dan secara opsional panggung.
  7. Pindahkan atau salin isyarat yang dihasilkan ke linimasa pertunjukan yang sebenarnya.

Contoh Buku Masak resmi menggunakan Excel untuk membuat ruang kerja visual yang lebih kompleks dengan grup dan beberapa isyarat Teks per baris. Untuk takarir, Anda dapat menyederhanakan pola itu: satu baris lembar sebar menjadi satu isyarat Teks takarir.

Kerangka AppleScript minimal mungkin terlihat seperti ini:

-- Official QLab 5 pattern:
-- https://qlab.app/docs/v5/scripting/examples/#create-and-move-a-new-cue
on makeCueInGroup(cueType, destinationContainer)
  tell application id "com.figure53.QLab.5" to tell front workspace
    make type cueType
    set newCue to last item of (selected as list)
    set q number of newCue to ""
    set newCueID to uniqueID of newCue
    set sourceList to parent of newCue
    move cue id newCueID of sourceList to end of destinationContainer
    return cue id newCueID of destinationContainer
  end tell
end makeCueInGroup

Anda dapat mengunduh paket pendamping lengkap yang berisi AppleScript ini, templat Excel, dan tangkapan layar di sini: Aset Demo Takarir QLab (ZIP).

Ini bukanlah pengimpor produksi yang sudah jadi. Ini adalah titik awal yang mudah dibaca.

Untuk pertunjukan sungguhan, tambahkan pemeriksaan sebelum menulis ke ruang kerja QLab:

  • berhenti jika nomor isyarat kosong
  • berhenti jika nomor isyarat sudah ada
  • potong spasi berlebih dari teks takarir
  • peringatkan jika satu baris terlalu panjang
  • tolak baris yang ditandai sebagai draf atau belum disetujui
  • tempatkan isyarat yang dihasilkan ke dalam grup sementara terlebih dahulu
  • simpan cadangan ruang kerja QLab dengan stempel waktu

Alur kerja teraman adalah menghasilkan isyarat ke dalam ruang kerja QLab terpisah atau grup yang diberi nama jelas, meninjaunya, dan baru kemudian menempelkannya ke dalam berkas pertunjukan langsung.

Metode 2: CSV ke takarir QLab

CSV seringkali merupakan format pertukaran yang lebih baik daripada XLSX.

Excel nyaman untuk diedit. CSV nyaman untuk otomatisasi.

Alur kerja CSV biasanya terlihat seperti ini:

  1. Edit takarir di Excel, Google Sheets, Numbers, atau Airtable.
  2. Ekspor sebagai CSV.
  3. Jalankan pengimpor kecil yang membaca CSV dan membuat isyarat Teks QLab.
  4. Tinjau isyarat QLab yang dihasilkan sebelum latihan.

Keuntungannya adalah pengimpor tidak perlu berbicara langsung ke Excel. Ia dapat membaca berkas CSV biasa. Itu membuat alur kerja lebih mudah untuk diberi versi, diuji, dan diulang.

CSV juga dapat disimpan di Git, sehingga perubahan lebih mudah ditinjau. Misalnya, manajer produksi dapat melihat bahwa isyarat 42 berubah dari satu terjemahan ke terjemahan lain tanpa membuka ruang kerja QLab.

Bagi tim teater, ini berguna karena pekerjaan takarir terus berubah:

  • terjemahan dipersingkat
  • seorang aktor mengubah jeda
  • sebuah lelucon membutuhkan pemutusan baris yang berbeda
  • pemotongan di akhir menghilangkan satu halaman
  • sutradara meminta untuk memindahkan takarir dua isyarat lebih awal

Jika data sumber Anda terstruktur, membangun kembali daftar isyarat QLab menjadi dapat diulang alih-alih manual.

Metode 3: TXT ke takarir QLab

Teks biasa adalah titik awal tercepat ketika Anda belum memiliki lembar sebar.

Gunakan format blok sederhana:

10
Welcome to the show.

11
Please turn off your phones.

12
The performance will begin shortly.

Dalam format ini, setiap blok takarir memiliki:

  1. nomor isyarat
  2. satu atau lebih baris teks takarir
  3. baris kosong sebelum blok berikutnya

Pengimpor TXT dapat memisahkan berkas pada baris kosong, membaca baris pertama sebagai nomor isyarat QLab, dan memperlakukan baris yang tersisa sebagai teks takarir.

Ini cepat, tetapi juga rapuh. Teks biasa baik untuk acara kecil atau latihan awal. Ini menjadi lemah ketika Anda membutuhkan banyak bahasa, status persetujuan, catatan operator, nomor babak, nama tokoh, atau riwayat revisi.

Untuk teks layar yang serius, ubah TXT menjadi lembar sebar atau editor takarir khusus segera setelah strukturnya menjadi lebih kompleks.

Pengaturan proyeksi: jangan lupa panggung

Menghasilkan isyarat Teks hanya setengah dari pekerjaan.

Isyarat Teks QLab harus mengeluarkan output ke suatu tempat. Di inspektur isyarat Teks QLab resmi, tab I/O menetapkan isyarat ke panggung keluaran video. Jika isyarat tidak memiliki panggung, isyarat Teks dapat rusak atau gagal muncul di tempat yang diharapkan.

Inspektur isyarat Teks QLab menunjukkan penetapan panggung video di tab I/O

Sebelum mengimpor ratusan isyarat takarir, buat dan uji panggung:

  • sambungkan proyektor atau layar
  • konfigurasikan panggung keluaran video QLab
  • buat satu isyarat Teks manual
  • atur font, ukuran, warna, lebar, perataan, dan posisi
  • pastikan dapat dibaca dari baris belakang
  • simpan isyarat itu sebagai templat atau salin pengaturannya ke isyarat yang dihasilkan

Lakukan ini sebelum otomatisasi. Otomatisasi mengulangi pengaturan Anda. Jika templat salah, otomatisasi akan mengulangi pengaturan yang salah dengan sangat cepat.

Apa yang biasanya rusak dalam alur kerja takarir QLab DIY

Pembuatan takarir QLab DIY berfungsi dengan baik ketika masalahnya sederhana:

Saya punya teks. Saya perlu isyarat Teks QLab.

Ini menjadi lebih sulit ketika masalahnya sebenarnya adalah ini:

Saya punya naskah terjemahan, suntingan terlambat, banyak versi, layar proyeksi, ponsel penonton, lompatan isyarat, dan operator langsung yang perlu pulih ketika pertunjukan keluar dari naskah.

Titik kegagalan umum meliputi:

  • nomor isyarat duplikat
  • penetapan panggung hilang
  • takarir yang terlalu lebar untuk layar
  • pemutusan baris yang terlihat bagus di Excel tetapi tidak di proyektor
  • perubahan terjemahan setelah isyarat sudah diimpor
  • berkas pertunjukan QLab yang menjadi satu-satunya tempat teks takarir berada
  • tidak ada cara bersih untuk membandingkan versi 3 dan versi 4 terjemahan
  • proyeksi dan pengiriman takarir seluler melenceng
  • stres operator ketika aktor melewatkan, mengulang, atau mengatur ulang baris

Itulah batas antara "otomatisasi QLab cepat" dan alur kerja produksi teks layar yang sesungguhnya.

Kapan SurtitleLive adalah alur kerja yang lebih baik

Jika Anda hanya membutuhkan proyeksi lokal, alur kerja isyarat Teks QLab mungkin sudah cukup.

Jika Anda membutuhkan tinjauan terjemahan, kunci isyarat yang stabil, tampilan seluler, atau proyeksi plus ponsel penonton, SurtitleLive memberikan pekerjaan takarir rumah khusus sebelum mencapai QLab.

Alur kerja SurtitleLive QLab memiliki dua tingkat.

Paket Proyeksi QLab

Gunakan ini ketika Anda menginginkan proyeksi lokal dari QLab.

Alur kerjanya adalah:

Editor SurtitleLive → Paket Proyeksi QLab → Isyarat Teks QLab → proyektor

Anda menyiapkan naskah dan segmen takarir di SurtitleLive, meninjau terjemahan dan urutan isyarat, lalu mengekspor isyarat yang siap QLab. QLab tetap menjadi lingkungan pemutaran untuk tempat pertunjukan.

Ini berguna ketika QLab sudah menjadi pusat gravitasi operator teknis, tetapi persiapan takarir tidak boleh terjadi di dalam QLab satu isyarat dalam satu waktu.

Sinkronisasi Cloud QLab + SurtitleLive

Gunakan ini ketika QLab harus terus menjalankan linimasa pertunjukan, tetapi ponsel penonton harus mengikuti status takarir yang sama.

Alur kerjanya adalah:

QLab → proyeksi lokal → proyektor

dan, pada titik isyarat yang sama:

Isyarat sinkron QLab → jembatan Mac lokal → Cloud SurtitleLive → ponsel penonton

Dalam pengaturan ini, setiap takarir SurtitleLive dapat diimpor ke QLab sebagai Grup linimasa. Grup tersebut berisi isyarat Teks untuk proyeksi lokal dan isyarat sinkron untuk ponsel penonton. Operator masih bekerja di dalam linimasa QLab, sementara SurtitleLive menangani status takarir seluler penonton.

graph TD
    %% Style Definitions
    classDef qlab fill:#1a1c23,stroke:#5856d6,stroke-width:2px,color:#fff;
    classDef hardware fill:#2a2b36,stroke:#8e8e93,stroke-width:2px,color:#fff;
    classDef cloud fill:#0d2d5e,stroke:#007aff,stroke-width:2px,color:#fff;
    classDef audience fill:#103823,stroke:#34c759,stroke-width:2px,color:#fff;
    
    subgraph Venue ["Local Venue (Theatre)"]
        QLab["QLab 5 Workspace
(Show Control Mac)"]:::qlab
        Projector["Stage Projector"]:::hardware
        Screen["Subtitle Screen / LED Wall"]:::hardware
        Bridge["SurtitleLive Local Bridge
(Receives QLab OSC)"]:::qlab
    end

    subgraph CloudSpace ["Cloud Service"]
        Cloud["SurtitleLive Cloud Platform
(Real-time Sync)"]:::cloud
    end

    subgraph Viewers ["Audience Devices"]
        Phone1["Audience Phone A
(Web Browser)"]:::audience
        Phone2["Audience Phone B
(Web Browser)"]:::audience
        PhoneN["...Other Phones"]:::audience
    end

    %% Connection Logic
    QLab -->|"1. Video Output (HDMI/SDI)"| Projector
    Projector --> Screen
    
    QLab -->|"2. Local OSC Trigger"| Bridge
    Bridge -->|"3. Secure WebSocket"| Cloud
    
    Cloud -->|"4. Millisecond-level Push"| Phone1
    Cloud -->|"4. Millisecond-level Push"| Phone2
    Cloud -->|"4. Millisecond-level Push"| PhoneN

    %% Subgraph Styling
    style Venue fill:#f9f9fb,stroke:#ccc,stroke-width:1px;
    style CloudSpace fill:#f0f7ff,stroke:#b3d7ff,stroke-width:1px;
    style Viewers fill:#f2fff5,stroke:#c2f0cc,stroke-width:1px;

Ini penting karena alur kerja takarir ponsel tidak boleh mengharuskan perangkat penonton berbicara langsung ke QLab. Komputer pertunjukan, proyektor, jembatan lokal, dan tautan penonton semuanya memiliki tugas yang berbeda.

Rekomendasi praktis terbaik

Untuk acara kecil satu malam:

Gunakan Excel atau TXT untuk menghasilkan isyarat Teks QLab. Buatlah sederhana. Uji proyektornya. Simpan cadangan.

Untuk pertunjukan teater terjemahan:

Siapkan takarir di luar QLab, lalu impor ke QLab setelah teks ditinjau.

Untuk pertunjukan multi-bahasa atau penonton seluler:

Gunakan SurtitleLive dengan ekspor QLab atau Sinkronisasi QLab. Pertahankan QLab sebagai linimasa pertunjukan, tetapi jangan jadikan QLab sebagai satu-satunya sumber kebenaran untuk konten takarir.

Tujuannya bukan untuk menggantikan QLab. Tujuannya adalah untuk membiarkan QLab melakukan apa yang QLab kuasai: kendali pertunjukan langsung.

Persiapan takarir, tinjauan terjemahan, tampilan seluler, dan sinkronisasi status isyarat membutuhkan alur kerja mereka sendiri.

FAQ

Bisakah QLab menampilkan takarir?

Ya. Isyarat Teks QLab dapat menampilkan teks bergaya sebagai keluaran video, sehingga umum digunakan untuk takarir yang diproyeksikan, teks layar, teks takarir, pengumuman, dan visual berbasis teks serupa.

Bisakah saya mengimpor takarir Excel langsung ke QLab?

Buku Masak resmi QLab mendemonstrasikan pembuatan isyarat berbasis Excel menggunakan AppleScript, tetapi itu berbeda dari fitur impor takarir XLSX bawaan satu klik. Pendekatan praktisnya adalah menggunakan Excel sebagai data sumber, lalu menjalankan skrip atau pengimpor yang membuat isyarat Teks QLab.

Bisakah saya membuat takarir QLab dari CSV?

Ya, dengan pengimpor. CSV seringkali lebih mudah daripada XLSX karena berupa teks biasa dan lebih mudah diurai. Skrip dapat membaca setiap baris dan membuat satu isyarat Teks per takarir.

Bisakah saya membuat takarir QLab dari TXT?

Ya, jika berkas TXT menggunakan struktur yang dapat diprediksi. Misalnya, setiap blok dapat dimulai dengan nomor isyarat, diikuti oleh teks takarir, dengan baris kosong di antara isyarat. Skrip dapat mengubah blok-blok tersebut menjadi isyarat Teks QLab.

Haruskah takarir menjadi isyarat Teks QLab atau isyarat Video?

Untuk teks langsung yang dapat diedit, gunakan isyarat Teks. Isyarat Video lebih baik ketika takarir sudah terbenam dalam video atau grafik yang dirender. Isyarat Teks lebih mudah direvisi, diformat, dan dihasilkan dari teks terstruktur.

Apakah QLab menyinkronkan takarir ke ponsel penonton?

QLab dapat memproyeksikan isyarat Teks secara lokal, tetapi pengiriman ponsel penonton membutuhkan alur kerja peramban/seluler. SurtitleLive QLab Sync dirancang untuk itu: QLab tetap menjadi linimasa pertunjukan sementara SurtitleLive memperbarui status takarir ponsel penonton.

Kapan saya harus berhenti menggunakan skrip takarir QLab DIY?

Berhenti hanya mengandalkan skrip DIY ketika alur kerja takarir membutuhkan tinjauan terjemahan, banyak bahasa, kunci isyarat yang stabil, tampilan seluler, pemulihan latihan, atau pembaruan berulang setelah impor. Pada titik itu, gunakan alur kerja takarir khusus dan ekspor ke QLab alih-alih memelihara semua konten takarir secara manual di dalam ruang kerja QLab.

Sumber daya terkait

Artikel terkait