===========================================================
  RASA - Render Bridge untuk Autodesk Revit 2017
  Laboratorium Arsitektur Digital, Jurusan Arsitektur UNG
===========================================================

CARA PASANG (mahasiswa / pengguna biasa, satu akun saja)
-----------------------------------------------------------
1. Klik kanan file rasa-revit2017-bridge.zip -> Properties ->
   centang "Unblock" di bagian bawah -> OK.
   (Langkah ini mencegah peringatan keamanan Windows. Kalau
   terlewat juga tidak masalah -- install.bat akan membersihkan
   tanda itu secara otomatis.)
2. Ekstrak ZIP ke folder mana saja (klik kanan -> Extract All).
3. Buka folder hasil ekstrak, klik dua kali install.bat.
4. Ikuti pesan di layar sampai muncul "BERHASIL!".
5. Buka Autodesk Revit 2017.
6. Kalau muncul peringatan keamanan addin, pilih "Always Load".
7. Tab "RASA" akan muncul di ribbon atas, berisi 3 tombol:
   - Render View Ini     : tangkap view 3D aktif, langsung render
   - Render Multi View   : pilih beberapa view 3D sekaligus
   - Buka RASA           : buka situs rasarender.com

CARA PASANG UNTUK SEMUA AKUN DI SATU PC (PC lab)
-----------------------------------------------------------
Gunakan install-semua-pengguna.bat (bukan install.bat) supaya
plugin aktif untuk SEMUA akun Windows yang memakai PC itu, bukan
cuma akun yang sedang login.
1-2. Sama seperti di atas (Unblock + ekstrak).
3. Klik dua kali install-semua-pengguna.bat.
4. Kalau muncul jendela "User Account Control", klik "Yes" (ini
   wajib, karena memasang untuk semua akun butuh hak Administrator).
5-7. Sama seperti langkah 4-7 di atas.

SYARAT HASIL TERBAIK DI REVIT
-----------------------------------------------------------
- Buka/pilih view 3D (kamera atau isometric), BUKAN denah/tampak.
- Aktifkan opsi "Sky" di Graphic Display Options (ikon kecil di
  bawah area gambar Revit) supaya latar belakang view tidak putih
  kosong -- AI bisa salah menebak sudut kamera kalau latarnya
  putih polos.
- Isi bingkai view dengan bangunannya (jangan terlalu jauh/kecil).

CARA MEMPERBARUI (UPDATE)
-----------------------------------------------------------
1. Tutup Revit 2017 dulu.
2. Unduh ulang rasa-revit2017-bridge.zip versi terbaru.
3. Jalankan install.bat (atau install-semua-pengguna.bat) lagi
   seperti pemasangan baru -- file lama otomatis tertimpa.

CARA MENCOPOT (UNINSTALL)
-----------------------------------------------------------
1. Tutup Revit 2017 dulu.
2. Jalankan uninstall.bat dari folder hasil ekstrak.
3. Kalau plugin juga terpasang untuk semua pengguna, akan diminta
   hak Administrator untuk ikut mencopot bagian itu.

UNTUK LABORAN -- PASANG KE BANYAK PC LAB SEKALIGUS
-----------------------------------------------------------
1. Salin daftar-pc.txt.contoh jadi daftar-pc.txt, isi nama-nama
   komputer lab (satu nama per baris, lihat Control Panel > System
   atau jalankan "hostname" di tiap PC untuk tahu namanya).
2. Pastikan semua PC tujuan menyala, terhubung jaringan yang sama,
   dan Revit 2017 TERTUTUP di semua PC itu.
3. Jalankan deploy-lab.bat dari akun yang punya akses admin ke
   share C$ PC-PC tersebut (biasanya akun admin domain/jaringan
   lab kampus).
4. Skrip akan menyalin plugin ke tiap PC lewat
   \\NAMA-PC\C$\ProgramData\Autodesk\Revit\Addins\2017\ dan
   melaporkan PC mana yang berhasil/gagal di akhir.

KENDALA UMUM
-----------------------------------------------------------
Masalah                         | Kemungkinan Penyebab & Solusi
---------------------------------|---------------------------------
Tab "RASA" tidak muncul          | Pastikan Revit yang dibuka memang
di ribbon                        | versi 2017 (bukan versi lain).
                                  | Cek file RasaRevitBridge.dll dan
                                  | .addin ada di
                                  | %APPDATA%\Autodesk\Revit\Addins\2017\
                                  | Cek log di
                                  | %LOCALAPPDATA%\RASA\revit-bridge.log
Muncul peringatan keamanan       | Ini normal untuk addin pihak ketiga
addin saat Revit dibuka          | -- pilih "Always Load" supaya tidak
                                  | ditanya lagi tiap kali buka Revit.
install.bat gagal, bilang file   | Tutup Revit dulu (DLL terkunci
terkunci/tidak bisa disalin      | selama Revit memakainya), lalu
                                  | jalankan install.bat lagi.
Gagal mengunggah / "Tidak bisa   | Periksa koneksi internet. Kalau
terhubung ke server RASA"        | sudah online tapi tetap gagal,
                                  | hubungi laboran (mungkin server
                                  | sedang ada gangguan).
"Buka view 3D / kamera dulu"     | Tombol Render View Ini/Multi View
                                  | perlu view 3D (kamera/isometric)
                                  | aktif, bukan denah/tampak/potongan.
Hasil render kamera/bentuk       | Lihat bagian "SYARAT HASIL
bangunan berubah                 | TERBAIK DI REVIT" di atas.

File log lengkap ada di: %LOCALAPPDATA%\RASA\revit-bridge.log
(buka lewat Notepad kalau perlu laporkan masalah ke laboran).

CATATAN -- INSTALLER .EXE (RASA-Revit2017-Setup.exe)
-----------------------------------------------------------
Belum dibuat -- Inno Setup (ISCC.exe) tidak terdeteksi di komputer
tempat plugin ini disiapkan. Installer .bat di atas sudah mencakup
semua fitur yang dibutuhkan (deteksi Revit, cek Revit berjalan,
Unblock otomatis, update, uninstall) tanpa perlu installer .exe
sama sekali.

Kalau suatu saat ingin membuat installer .exe juga (tampilan lebih
rapi + muncul di Control Panel > Uninstall a program):
1. Pasang Inno Setup (gratis): https://jrsoftware.org/isdl.php
2. Buat file plugin-revit/installer/rasa-revit2017.iss yang
   mengemas RasaRevitBridge.dll + .addin, dengan pilihan "Hanya
   saya" (%APPDATA%) / "Semua pengguna" (%ProgramData%), cek Revit
   tidak sedang berjalan sebelum instal, dan entri uninstall resmi.
3. Compile lewat ISCC.exe rasa-revit2017.iss -> hasilnya
   RASA-Revit2017-Setup.exe, taruh di public/downloads/ -- halaman
   /plugin otomatis menampilkan tombol unduhnya kalau file ini ada.
