Deskripsi
# Rangka 3D — Opsi 1: Pakai Sendiri (edisi pribadi)
Edisi ini dipakai di komputer Anda sendiri. **Tidak perlu install, tidak perlu akun, tidak ada iklan, tidak perlu internet.**
Semua fitur terbuka, dan proyek disimpan sebagai file `.rk3` di komputer Anda.
## 1. Membuka aplikasi
1. Ekstrak zip ke tempat yang permanen, misalnya `Documents\Rangka3D` (jangan dijalankan langsung dari dalam zip).
2. Klik dua kali:
- Windows: **`Buka Rangka3D (Windows).bat`**
- macOS: **`Buka Rangka3D (Mac).command`** (pertama kali: klik kanan › Open, lalu Open, karena file dari internet diblokir Gatekeeper)
- Linux: **`Buka Rangka3D (Linux).sh`**
Atau langsung buka `Rangka3D/index.html` dengan Chrome/Edge (klik kanan › Open with › Google Chrome).
3. Aplikasi langsung masuk ke lembar kerja dengan contoh rumah. Mulai proyek baru lewat **File › New** (Ctrl+N).
**Agar praktis:** buat shortcut ke `Rangka3D/index.html` di desktop, atau bookmark halaman itu di browser.
Browser yang disarankan: **Google Chrome** atau **Microsoft Edge**. Di kedua browser ini *Save* langsung menimpa file yang sedang dibuka,
seperti aplikasi desktop biasa. Di Firefox/Safari setiap *Save* mengunduh file `.rk3` baru ke folder Download (aplikasi tetap berfungsi penuh).
## 2. Menyimpan dan membuka proyek
| Perintah | Tombol | Fungsi |
|---|---|---|
| **File › Save** | Ctrl+S | Simpan ke file `.rk3`. Pertama kali Anda memilih nama dan folder; berikutnya langsung menimpa file yang sama. |
| **File › Save As…** | Ctrl+Shift+S | Simpan salinan dengan nama/folder lain (mis. `Rumah-Budi-revisi2.rk3`). |
| **File › Open Project…** | Ctrl+O | Buka file `.rk3` (atau `.json` versi lama). |
| **File › New** | Ctrl+N | Proyek baru. |
| Seret file `.rk3` ke jendela | — | Membuka proyek tersebut. |
Pengaman bawaan:
- Jika ada perubahan yang belum disimpan, aplikasi bertanya dulu sebelum membuat proyek baru, membuka file lain, atau menutup tab.
- **Cadangan otomatis** tiap 1 menit selama ada perubahan yang belum disimpan. Jika browser tertutup atau komputer mati mendadak,
saat aplikasi dibuka lagi akan muncul pilihan **Pulihkan**. Cadangan ini hanya darurat — tetap simpan pekerjaan dengan Ctrl+S.
- Nama file yang sedang dibuka tampil di bagian atas jendela dan di tab browser.
Tips: simpan proyek di folder yang ikut ter-backup (Google Drive, OneDrive, Dropbox) supaya aman dan bisa dibuka di komputer lain.
File `.rk3` biasanya hanya puluhan sampai ratusan KB.
## 3. Ekspor hasil kerja
- **Gambar & render**: File › Export (PNG/JPG), atau Extensions › Rangka Render untuk render fotorealistis.
- **Gambar teknik**: tombol **CAD** di kanan bawah denah → atur kop (**Title**), area (**Area**), lalu **PDF** (lembar A3 siap cetak) atau **DXF** (dibuka di AutoCAD/BricsCAD/LibreCAD).
- **Model 3D**: File › Export (DAE, GLB, OBJ, STL).
- **Rekap plumbing**: ribbon MEP › Summary › Unduh CSV.
File hasil ekspor masuk ke folder **Download** browser.
## 4. Memakai di beberapa komputer / jaringan kantor (opsional)
- Cukup salin seluruh folder `1-Pakai-Sendiri` ke komputer lain.
- Untuk dipakai bersama di jaringan kantor tanpa internet, jalankan server kecil di satu komputer yang ada Python:
```
cd Rangka3D
python -m http.server 8080
```
lalu komputer lain membuka `http://IP-komputer-itu:8080`. Proyek tetap disimpan di komputer masing-masing pengguna.
## 5. Pengaturan (`Rangka3D/config.js`)
```js
window.RANGKA_CONFIG = {
edition: "local", // edisi pribadi: tanpa akun, iklan, dan cloud
deployed: true,
skpConverterUrl: null // isi alamat layanan konverter .skp milik Anda jika ingin impor SketchUp
};
```
Tidak ada yang wajib diubah.
## 6. Masalah yang sering ditemui
| Gejala | Solusi |
|---|---|
| Layar putih / model tidak tampil | Pastikan memakai Chrome/Edge versi baru dan akselerasi hardware aktif (Settings › System › *Use graphics acceleration*). |
| Save selalu mengunduh file baru | Itu perilaku Firefox/Safari. Pakai Chrome/Edge agar Save menimpa file yang sama. |
| Proyek hilang setelah membersihkan data browser | Proyek hanya aman bila disimpan ke file `.rk3`. Cadangan otomatis tersimpan di data browser dan ikut terhapus. |
| `.command` di Mac tidak bisa dibuka | Klik kanan › Open, atau jalankan `chmod +x "Buka Rangka3D (Mac).command"` di Terminal. |
| Ingin mengubah nama aplikasi/logo | Lihat `../3-Source-Code/README.md`, lalu jalankan `python3 build.py local`. |