Current Section Core

2. Document Structure

Status dokumen: Normative

2.1 Root Structure

Dokumen RelGeo menggunakan struktur tingkat atas berikut:

version: 0.5

scene:

parameters:

constants:

derived:

profiles:

metaPresets:

components:

objects:

constraints:

views:

sheets:

meta:

Seluruh section bersifat opsional kecuali ditentukan lain oleh preset parameter tertentu.

[!NOTE] Jika version tidak ditulis, parser boleh mengasumsikan versi spec aktif yang diimplementasikan runtime saat itu. Pada kontrak aktif saat dokumen ini ditulis, default tersebut adalah 0.5.

2.2 Minimal Document

Contoh dokumen RelGeo paling sederhana:

objects:
  p1:
    type: point
    at: [0, 0]

2.3 Section Overview

Section	Wajib	Keterangan	Detail
`version`	✗	Versi spesifikasi RelGeo yang digunakan. Jika tidak ditulis, runtime boleh memakai versi spec aktifnya sebagai default	—
`scene`	✗	Konfigurasi unit, orientasi, origin, padding	→ 3. Scene
`parameters`	✗	Input yang dapat diubah pengguna, dengan default dan constraints	→ 8. Parameters
`constants`	✗	Nilai tetap yang tidak dapat diubah saat runtime	→ 9. Constants
`derived`	✗	Nilai hasil ekspresi, tergantung pada parameters/constants/anchors	→ 10. Derived Values
`profiles`	✗	Preset override untuk `parameters`	→ 11. Profiles
`metaPresets`	✗	Preset reusable untuk bundle `meta` object	→ 26. Metadata
`components`	✗	Definisi template komponen yang dapat diinstansiasi	→ 15. Composition Objects
`objects`	✗*	Objek geometri utama	→ 14. Geometry Objects
`constraints`	✗	Validasi hubungan geometri	→ 21. Constraints
`views`	✗	Snapshot tampilan subset geometri dengan skala	→ 25. Views and Sheets
`sheets`	✗	Komposisi lembar gambar dari views	→ 25. Views and Sheets
`meta`	✗	Metadata tingkat dokumen	→ 26. Metadata

[!NOTE] objects secara teknis opsional - dokumen tanpa objects valid secara sintaks, namun tidak menghasilkan geometri apapun.

[!NOTE] meta pada root berbeda dari scene. scene hanya untuk konfigurasi perilaku global, sedangkan metadata dokumen berada di <root>.meta. scene.meta bukan bagian dari spec aktif.

← 1. Overview | ↑ Index | 3. Scene →