ملف التكوين، مفتاحًا مفتاحًا

يحتوي التكوين على إعدادات المشروع دون نموذجه: كائن JSON واحد بترميز UTF-8. يكتبه Export › Configuration (.occc) ويعيد Import › Configuration (.occc) قراءته؛ ويحمل المشروع (.occp) الكائن نفسه بجوار نموذجه، وتكوينك الافتراضي هو أيضًا تكوين.

• تُخزَّن الإعدادات حسب الاسم: تقع إعدادات الكائن تحت اسمه كما يعرضه مستعرض النموذج، وتنطبق على كل كائن يحمل هذا الاسم في كل منظر. وتُخزَّن المناظر والملاحظات والمناسيب حسب الاسم أيضًا.
• لا يذكر التكوين إلا ما يختلف عن القيم الافتراضية: المفتاح المحذوف يأخذ القيمة الافتراضية المذكورة له أدناه.
• تُعرَّف الطبقات وإعدادات التهشير المسبقة وسماكات الخطوط وأنواعها الخاصة بالمشروع مرة واحدة، في قوائم، وتشير إليها الإعدادات عبر id الخاص بها.

الملف كائن واحد. يكتب Occlusia مفاتيحه بهذا الترتيب، مع كل قائمة وكل مجموعة إعدادات، حتى إن كانت فارغة:

{
  "author": "Occlusia",
  "app_version": "0.1.0",
  "app_build": "gbc7dba5",
  "snapshot_plugin_version": "0.1.0+gbc7dba5",
  "created_at": "2026-10-23 08:00:00",
  "saved_at": "2026-10-23 16:54:49",
  "project_layers": [ … ],
  "hatch_presets": [ … ],
  "line_weights": [ … ],
  "line_types": [ … ],
  "objects_settings": { "Facing brick": { … }, … },
  "sections_settings": { "Section A-A": { … }, … },
  "annotations_settings": { "Wall build-up": { … }, … },
  "spot_elevations_settings": { "Ground floor": { … }, … },
  "spot_elevation_datum": { "offset_m": 152.35, "label": "TAW" }
}

author · app_version · app_build

من كتب الملف: Occlusia وإصداره ورقم بنائه. للعلم فقط: لا يُقرأ أبدًا.

snapshot_plugin_version

ما الذي التقط النموذج الذي وُضعت عليه الإعدادات. للعلم فقط.

created_at · saved_at

متى أُنشئ المستند ومتى كُتب هذا الملف، بالصيغة YYYY-MM-DD HH:MM:SS بالتوقيت المحلي. للعلم فقط.

project_layers

طبقات DXF في المشروع: قائمة. راجع «الطبقات».

hatch_presets

إعدادات التهشير المسبقة: قائمة. راجع «إعدادات التهشير المسبقة».

line_weights · line_types

سماكات الخطوط وأنواعها الخاصة بالمشروع، إلى جانب القياسية: قائمتان. راجع «سماكات الخطوط وأنواعها».

objects_settings

إعدادات الكائنات، حسب اسم الكائن. راجع «الكائنات».

sections_settings

إعدادات المناظر، حسب اسم المنظر. راجع «المناظر».

annotations_settings

إعدادات الملاحظات، حسب اسم الملاحظة. راجع «الملاحظات».

spot_elevations_settings

إعدادات المناسيب، حسب الاسم. راجع «المناسيب».

spot_elevation_datum

منسوب أصل النموذج في مرجع المشروع: offset_m بالأمتار، وlabel الذي يُكتب بعد القيمة المطلقة (NGF، TAW). القيمتان الافتراضيتان 0 وفارغ.

التكوين ملف يكتبه Occlusia. أما الملف المكتوب أو المعدَّل في مكان آخر — يدويًا أو ببرنامج نصي أو بالذكاء الاصطناعي — فيُفحص عند فتحه، ويُرفض بالكامل إن خالف قاعدة: لا يُطبَّق شيء جزئيًا، وتبقى الإعدادات الحالية، وتسرد نافذة الحوار كل مشكلة مع رمز الخطأ الخاص بها (راجع «الأخطاء»).

• المعرّفات صارمة. يحتاج كل عنصر في القوائم الأربع إلى id فريد في قائمته. ويجب أن تكون أسماء الطبقات وأنواع الخطوط فريدة أيضًا، دون اعتبار لحالة الأحرف: فملف DXF يعرف الطبقة ونوع الخط باسمهما.
• رمز القطع كلمة مغلقة. قيمة symbol للكائن هي none أو cross أو insulation؛ وأي كلمة أخرى تؤدي إلى رفض الملف.
• كل قيمة أخرى حرة. المفتاح المحذوف يأخذ قيمته الافتراضية، وnull تُعامَل كأنها محذوفة، والقيمة من نوع خاطئ تُقرأ كالقيمة الافتراضية، والمفتاح الذي لا يعرفه Occlusia يُحتفظ به كما هو ويُعاد كتابته.
• المراجع تعود إلى الافتراضي. الإعداد الذي يشير إلى طبقة لا يعرّفها الملف يُرسم على الطبقة 0؛ والإعداد الذي يشير إلى إعداد مسبق أو نمط خط مفقود يأخذ القيمة الافتراضية للإعداد.
• يجب أن تتطابق الأسماء تمامًا. لا تصل الإعدادات إلى كائن إلا إذا كان مفتاحها هو اسمه كما يعرضه مستعرض النموذج، بما في ذلك الأحرف الكبيرة والمسافات. أما إعدادات اسم غير موجود في النموذج فيُحتفظ بها دون استخدام.

تسرد project_layers طبقات المشروع الخاصة. الطبقة الافتراضية 0 ملك لـ Occlusia: موجودة دائمًا، ولا تُكتب أبدًا، ولا يجوز لأي عنصر أن يدّعيها، لا بمعرّفها layer_0 ولا بالاسم 0.

{
  "id": "layer_1761134408",
  "name": "A-WALL",
  "description": "Masonry",
  "color": "#D9483B",
  "line_weight": "50",
  "line_type": "solid",
  "transparency": 0,
  "active": true,
  "frozen": false,
  "locked": false,
  "plot": true
}

id

مطلوب. نص فريد في القائمة: ما يشير إليه كل …_layer_id. يكتب Occlusia layer_ متبوعًا برقم.

name

مطلوب. اسم الطبقة في DXF: غير فارغ، بلا مسافات حوله، فريد دون اعتبار لحالة الأحرف، ولا يكون أبدًا 0.

description

نص حر. فارغ افتراضيًا.

color

#RRGGBB. القيمة الافتراضية #FFFFFF.

line_weight

default، أو سماكة خط بأجزاء المئة من المليمتر: 25 تعني 0.25 مم. القيمة الافتراضية default.

line_type

solid افتراضيًا، أو نوع خط آخر (راجع «سماكات الخطوط وأنواعها»).

transparency

من 0 إلى 100 %. القيمة الافتراضية 0.

active · frozen · locked · plot

مُشغَّلة، مجمَّدة، مقفلة، قابلة للطباعة: افتراضيًا true وfalse وfalse وtrue.

تسرد hatch_presets الإعدادات المسبقة للمشروع؛ أما none وcustom فملك لـ Occlusia ولا تُكتبان أبدًا. الكائن الذي يستخدم إعدادًا مسبقًا يذكره — template لتعبئة القطع، وsurface_template لتعبئة السطح — ويحتفظ بنسخته الخاصة من قيم الإعداد المسبق.

{
  "id": "concrete",
  "label": "Concrete",
  "fill_pattern": "hatch_ar_conc",
  "color": "#000000",
  "color_bylayer": true,
  "bg": "#BBBBBB",
  "line_weight": "stroke-medium",
  "scale": 0.15,
  "angle": 0,
  "transparency": 0
}

id

مطلوب. نص فريد، ولا يكون أبدًا none أو custom. يكتب Occlusia الاسم بأحرف صغيرة، مع _ بدل المسافات: concrete_block.

label

الاسم الذي تعرضه القوائم.

fill_pattern

none أو hatch_solid أو نمط: اسمه في قائمة Fill Type بأحرف صغيرة بعد hatch_، والشرطة تُكتب _ — ANSI31 هو hatch_ansi31، وAR-CONC هو hatch_ar_conc.

color · color_bylayer

لون خطوط التهشير أو التعبئة المصمتة (#000000)، وما إذا كان DXF يأخذ لون الطبقة بدلًا منه (true).

bg

لون مصمت خلف التهشير، أو none (القيمة الافتراضية).

line_weight

سماكة خطوط التهشير: stroke-hairline افتراضيًا.

scale · angle · transparency

معامل الحجم (1)، والدوران بالدرجات عكس اتجاه عقارب الساعة (0)، والشفافية من 0 إلى 100 (0).

أينما أخذ إعدادٌ سماكة خط أو نوع خط، فإنه يسمّي واحدًا قياسيًا أو واحدًا من خطوط المشروع الخاصة. السماكات القياسية هي stroke-hairline (0.13 مم) وstroke-thin (0.25) وstroke-medium (0.35) وstroke-bold (0.50) وstroke-heavy (0.70) وstroke-ultra (1.00)؛ والأنواع القياسية هي solid وdashed وdotted وdash-dot وlong_dash. وتقبل خطوط الكائن أيضًا none: بلا خط إطلاقًا.

"line_weights": [
  { "id": "stroke-custom-fine", "name": "Fine", "width": 0.18 }
],
"line_types": [
  { "id": "custom-hidden_edge", "name": "Hidden edge", "pattern": [3.0, -1.5] }
]

line_weights · id

stroke-custom- متبوعًا بأحرف أو أرقام أو _ أو -؛ فريد.

line_weights · name · width

الاسم الذي تعرضه القوائم، والعرض بالمليمتر من 0.05 إلى 2.11 (نطاق AutoCAD). ويكتب DXF أقرب سماكة خط في AutoCAD.

line_types · id

custom- متبوعًا بأحرف أو أرقام أو _ أو -؛ فريد.

line_types · name

اسم نوع الخط في DXF: فريد دون اعتبار لحالة الأحرف، بلا مسافات حوله، بحد أقصى 255 بايت، دون أي حرف يرفضه جدول DXF (< > / \ " : ; ? * | , = وعلامات الاقتباس)، وليس اسمًا يحجزه DXF أو Occlusia: Continuous وByLayer وByBlock واسم نوع قياسي وNONE.

line_types · pattern

الشرطات بالمليمتر على اللوحة المطبوعة، كما يكتبها AutoCAD: الطول الموجب شرطة، والسالب فراغ، و0 نقطة، واثنا عشر عنصرًا كحد أقصى. [3, -1.5] شرطة بطول 3 مم وفراغ بطول 1.5 مم.

تضم objects_settings عنصرًا واحدًا لكل اسم كائن، بما في ذلك أسماء المجموعات. يُرسم كل كائن بعنصره الخاص: تكتب الواجهة التغيير الذي يُجرى على مجموعة في عنصر كل كائن داخلها، والملف المكتوب يدويًا يفعل الشيء نفسه. كل المفاتيح اختيارية. Facing brick في النموذج التجريبي:

"Facing brick": {
  "template": "custom",
  "fill_pattern": "hatch_ansi31",
  "cut_pattern_color": "#000000",
  "cut_pattern_color_bylayer": false,
  "cut_pattern_bg_color": "#f2d4a6",
  "cut_pattern_line_weight": "stroke-hairline",
  "cut_pattern_scale": 1.0,
  "cut_pattern_angle": 0,
  "cut_pattern_transparency": 0,
  "surface_template": "custom",
  "surface_hatch": "hatch_ar_brstd",
  "surf_pattern_color": "#000000",
  "surf_pattern_color_bylayer": false,
  "surf_pattern_bg_color": "#F2D4A6",
  "surf_pattern_line_weight": "stroke-hairline",
  "surf_pattern_scale": 0.11,
  "surf_pattern_angle": 0,
  "surf_pattern_transparency": 0,
  "cut_line_weight": "stroke-bold",
  "cut_layer_id": "layer_1761134408",
  "surf_layer_id": "layer_1761134408",
  "hatch_layer_id": "layer_1761134404"
}

الخطوط. مفاتيح cut_ تنسّق المحيط حيث يقطع المنظر الكائن، ومفاتيح surf_ تنسّق حوافه المرئية خلف المستوى.

cut_line_weight · surf_line_weight

stroke-thin وstroke-hairline افتراضيًا.

cut_line_type · surf_line_type

solid افتراضيًا؛ وnone لا يرسم أي خط.

cut_line_type_scale · surf_line_type_scale

معامل على أطوال شرطات النوع: 1 افتراضيًا.

cut_line_color · surf_line_color

#000000 افتراضيًا.

cut_line_transparency · surf_line_transparency

من 0 إلى 100: القيمة الافتراضية 0.

…_bylayer

بجوار كل لون وسماكة ونوع للخطوط والأنماط والرمز: true، وهي القيمة الافتراضية، تجعل DXF يأخذ قيمة الطبقة. أما SVG وPDF فيرسمان دائمًا قيمة الكائن.

التعبئات. مفاتيح cut_pattern_ تملأ الأوجه المقطوعة، ومفاتيح surf_pattern_ تملأ الأوجه المرئية خلف المستوى.

template · surface_template

الإعداد المسبق لتعبئة القطع ولتعبئة السطح: none (القيمة الافتراضية)، أو custom — القيم أدناه دون ربطها بأي إعداد مسبق — أو id إعداد مسبق.

fill_pattern · surface_hatch

تعبئة القطع وتعبئة السطح: none افتراضيًا، أو hatch_solid أو نمط (راجع «إعدادات التهشير المسبقة»).

cut_pattern_color · surf_pattern_color

لون خطوط التهشير أو التعبئة المصمتة: #000000.

cut_pattern_bg_color · surf_pattern_bg_color

لون مصمت خلف التهشير، أو none (القيمة الافتراضية).

cut_pattern_line_weight · surf_pattern_line_weight

سماكة خطوط التهشير: stroke-hairline.

cut_pattern_scale · surf_pattern_scale

معامل الحجم: 1.

cut_pattern_angle · surf_pattern_angle

الدوران بالدرجات، عكس اتجاه عقارب الساعة: 0.

cut_pattern_transparency · surf_pattern_transparency

من 0 إلى 100: 0.

الرمز والطبقات والتصيير.

symbol

none (القيمة الافتراضية) أو cross أو insulation — لا غير: أي كلمة أخرى تؤدي إلى رفض الملف.

symbol_line_weight · symbol_line_type · symbol_line_color · symbol_line_transparency

خطوط الرمز: stroke-hairline وsolid و#000000 و0.

cut_layer_id · surf_layer_id · hatch_layer_id · cut_symbol_layer_id

طبقات DXF لخطوط القطع وخطوط السطح والتهشيرات والرمز: id طبقة، وlayer_0 افتراضيًا.

draw_order

الأعلى يُرسم فوق: 0 افتراضيًا.

export_block · block_name · block_layer_id

يصدّر الكائن وما يحتويه ككتلة (block) واحدة (false)، واسمها — إن كان فارغًا: اسم الكائن — وطبقة إدراجها (layer_0).

exclude_from_shadows

No Shadows: لا يُلقي ظلًا ولا يستقبله (false).

wireframe

يُرسم بخطوطه فقط (false).

hidden

في كل منظر: true مخفي، وfalse ظاهر. إذا حُذف، يبقى الكائن كما يعرضه النموذج.

تضم sections_settings عنصرًا واحدًا لكل اسم منظر: علامته المرسومة في المناظر الأخرى، وخيارات الظهور المتخذة في هذا المنظر، وظلاله، وصفحة PDF الخاصة به.

"South elevation": {
  "marker_style": "default",
  "marker_color": "#000000",
  "marker_number_color": "#000000",
  "marker_name_color": "#000000",
  "section_line_color": "#000000",
  "marker_layer_id": "layer_1761134400",
  "shadow": {
    "enabled": true,
    "sun_mode": "manual",
    "azimuth": 225,
    "altitude": 40,
    "interiors": false,
    "pattern": "default",
    "layer_id": "layer_1761134400"
  },
  "spot_elevations": { "Ground level": false, "Ceiling": false }
}

hidden

true يخفي علامة المنظر في كل المناظر الأخرى.

marker_style

default (قرص يحمل الرمز والاسم) أو closed_arrow أو open_arrow.

marker_color · marker_number_color · marker_name_color

الرؤوس والرمز والاسم: #0000FF افتراضيًا.

section_line_type · section_line_color

خط القطع: dash-dot و#000000 افتراضيًا.

marker_endpoints

both (القيمة الافتراضية) أو start أو end أو none.

marker_show_number · marker_show_name

رسم الرمز والاسم: true.

marker_size_mode · marker_scale

auto يلائم العلامة مع الرسم؛ وmanual يحتفظ بالحجم marker_scale (1).

marker_number_font_family · marker_number_font_size

خط الرمز (Arial) ومعامل حجمه (1). والمفاتيح نفسها مع name بدل number تنسّق الاسم.

marker_layer_id

طبقة DXF للعلامة: layer_0.

object_visibility

خيارات هذا المنظر الخاصة، حسب اسم الكائن: true ظاهر هنا، وfalse مخفي هنا. وهي تتقدّم على hidden الخاصة بالكائنات.

spot_elevations

وكذلك للمناسيب، حسب الاسم.

shadow

enabled (false)، وsun_mode (manual)، وazimuth بالدرجات باتجاه عقارب الساعة من الشمال (135)، وaltitude (45)، وinteriors (true)، وpattern — default أو id إعداد مسبق — وlayer_id.

pdf

format من A4 إلى A0 (A4)، وorientation auto أو portrait أو landscape (auto)، وscale_mode fit أو custom بمقياس 1:scale_denominator (fit، 50)، وmargins_mm (10)، وcenter: نقطة النموذج الواقعة في مركز اللوحة بعد تحريك الرسم عليها.

تضم annotations_settings عنصرًا واحدًا لكل اسم ملاحظة — الاسم الذي يمنحه النموذج للملاحظة (OCCTAG#Name)، لا النص الذي تكتبه.

"Wall build-up": {
  "font_family": "Arial",
  "font_size": 4.2,
  "font_style": "regular",
  "background": "drawing",
  "layer_id": "layer_1761134400"
}

hidden

true يخفي الملاحظة في كل المناظر.

font_family · font_size · font_style

Arial؛ وارتفاع الحرف الكبير بوحدات الرسم (12)؛ وregular أو bold أو italic أو bold-italic.

color · color_bylayer · transparency

#000000 وtrue و0.

multiline · max_width

التفاف النص عند عرض بوحدات الرسم: false و0.

show_leader

رسم خط الإشارة عندما يمنحه النموذج للملاحظة: true.

background · background_color

none (القيمة الافتراضية)، أو solid — مربع بلون background_color (#FFFFFF) — أو drawing: خلفية الرسم نفسه.

layer_id

طبقة DXF للملاحظة: layer_0.

تضم spot_elevations_settings عنصرًا واحدًا لكل اسم منسوب (OCCLEVEL#Name).

"Ground level": {
  "marker_style": "triangle_half",
  "value_font_size": 4.6,
  "name_font_size": 4.2,
  "layer_id": "layer_1761134400",
  "marker_side": "left",
  "size_mode": "manual",
  "scale": 2.0
}

hidden

true يخفيه في كل المناظر؛ ويتقدّم عليه خيار spot_elevations الخاص بالمنظر.

marker_style · marker_side

triangle (القيمة الافتراضية) أو triangle_half أو triangle_open أو target؛ والنصوص على اليمين right (القيمة الافتراضية) أو على اليسار left.

marker_color · marker_line_weight

تعبئة العلامة (#000000) والسماكة الوحيدة لخطوطها (stroke-hairline).

size_mode · scale

auto، أو manual بمقياس scale من 0.05 إلى 50 (1).

show_line · line_type · line_weight · line_color · line_length

خط المنسوب: معطّل (false)، وdashed، وstroke-hairline، و#000000، وطوله 20 وحدة رسم — 0 لا يرسم شيئًا.

show_value · value_display

كتابة المنسوب (true): relative ارتفاع النموذج نفسه (+2.90)، أو absolute ذلك الارتفاع مضافًا إليه offset_m من spot_elevation_datum، متبوعًا بـ label الخاص به.

show_name

كتابة التسمية: true.

value_font_family · value_font_size · value_font_style

نص المنسوب: Arial و12 وbold.

name_font_family · name_font_size · name_font_style

نص التسمية: Arial و12 وregular.

value_color · name_color

#000000.

marker_color_bylayer · line_color_bylayer · value_color_bylayer · name_color_bylayer

قرار ByLayer واحد لكل لون: true.

layer_id

طبقة DXF: layer_0.

يمكن للذكاء الاصطناعي أن يكتب تكوينًا — معيار مكتب، أو أنماطًا منقولة من برنامج آخر، أو نسخة معدّلة من ملف موجود — بمجرد أن يعرف القواعد أعلاه والأسماء الموجودة في نموذجك.

1. 01

   زوّده بالصيغة

   هذه الصفحة وJSON Schema أعلاه: كل مفتاح ونوعه وقيمته الافتراضية وقواعده.

2. 02

   زوّده بأسمائك

   أسماء كائناتك ومناظرك وملاحظاتك ومناسيبك تمامًا كما يعرضها مستعرض النموذج — أو تكوين مُصدَّر من النموذج.

3. 03

   اطلب ما يختلف فقط

   المفاتيح التي تختلف عن القيم الافتراضية، والطبقات والإعدادات المسبقة التي تستخدمها، ولا عنصر لاسم غير موجود في النموذج.

4. 04

   استورده واقرأ النتيجة

   Import › Configuration (.occc). الملف الذي يخالف قاعدة لا يغيّر شيئًا، وتسرد نافذة الحوار كل مشكلة مع رمز الخطأ الخاص بها: أعِد القائمة إلى الذكاء الاصطناعي. ويتراجع ⌘Z (Ctrl+Z) عن الاستيراد.

يُظهر الملف المرفوض Cannot import this configuration. — وCannot open this project. للمشروع، وYour default configuration was not loaded. للتكوين الافتراضي. وتسرد تفاصيله كل مشكلة: رمز الخطأ والعنصر والسبب. ولا يتغير معنى الرمز أبدًا.

OC001

الملف ليس تكوينًا: محتواه ليس كائن JSON، أو ليس JSON قابلًا للقراءة.

OC100

project_layers ليست قائمة.

OC101

طبقة ليست كائنًا.

OC102

طبقة بلا id، أو بمعرّف فارغ.

OC103

طبقتان تتشاركان id نفسه.

OC104

طبقة بلا name، أو باسم فارغ.

OC105

طبقتان تحملان الاسم نفسه دون اعتبار لحالة الأحرف: في DXF ستصبحان طبقة واحدة.

OC106

اسم طبقة تحيط به مسافات.

OC107

عنصر يدّعي الطبقة الافتراضية 0، بالمعرّف layer_0 أو بالاسم 0. احذفه: الطبقة الافتراضية لا تُكتب أبدًا.

OC200

قيمة symbol لكائن ليست none أو cross أو insulation.

OC300

hatch_presets ليست قائمة.

OC301

إعداد مسبق ليس كائنًا.

OC302

إعداد مسبق بلا id، أو بمعرّف فارغ.

OC303

إعدادان مسبقان يتشاركان id نفسه.

OC304

إعداد مسبق يأخذ المعرّف none أو custom، وهما ملك لـ Occlusia.

OC400

line_weights ليست قائمة.

OC401

سماكة خط ليست كائنًا.

OC402

id سماكة خط مفقود، أو ليس stroke-custom- متبوعًا بأحرف أو أرقام أو _ أو -.

OC403

سماكتا خط تتشاركان id نفسه.

OC500

line_types ليست قائمة.

OC501

نوع خط ليس كائنًا.

OC502

id نوع خط مفقود، أو ليس custom- متبوعًا بأحرف أو أرقام أو _ أو -.

OC503

نوعا خط يتشاركان id نفسه.

OC504

نوع خط بلا name، أو باسم فارغ.

OC505

نوعا خط يحملان الاسم نفسه دون اعتبار لحالة الأحرف.

OC506

اسم نوع خط تحيط به مسافات.

OC507

نوع خط يأخذ اسمًا يحجزه DXF أو Occlusia: Continuous وByLayer وByBlock واسم نوع قياسي وNONE.

OC508

اسم نوع خط يحتوي على حرف يرفضه جدول DXF، أو يتجاوز طوله 255 بايت.