بنية المكوّن

المكوّن في جوهره هو كائن JSON يحتوي على الصادرات المعتادة التي تحتويها الإضافة، مثل الاسم والحجم وعدد مصابيح LED وغيرها.

المجلدات

تُقرأ هذه الملفات من أحد مجلدين. تُخزَّن الملفات المدمجة في:

C:\Users\[YOUR USERNAME]\AppData\Local\VortxEngine\app-[CURRENT VERSION]\Signal-x64\Components

أما الملفات التي ينشئها المستخدم فيجب تخزينها في مجلد المستخدم. افتراضيًا يكون هذا المجلد داخل المستندات:

C:\Users\[YOUR USERNAME]\Documents\WhirlwindFX\Components

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

بنية JSON

فيما يلي مثال على مجموعة ترقية كرسي من “Vertagear” معبَّر عنها كمكوّن مع جميع السمات اللازمة.

ملاحظة: ستُطبع الأخطاء والتحذيرات الشائعة عند تحميل هذه الملفات في سجلات التصحيح.

{
    "ProductName": "VertaGear PL4500 RGB Top Kit (Chair Back)",
    "DisplayName": "VertaGear PL4500 RGB Top Kit (Chair Back) - 5 Zone",
    "Brand" : "Vertagear",
    "Type" : "Chair",
    "LedCount" : 5,
    "Width": 5,
    "Height": 5,
    "LedMapping" : [
        0,1,2,3,4
        ],
    "LedCoordinates" : [
        [0,0], [0,1], [1,0], [2,0], [2,1]
    ],
    "LedNames" : [
        "Back Side - Top","Back Side - Bottom","Center Acrylic","Front Side - Top", "Front Side - Bottom"
    ],
    "ImageUrl": ""
}

المعامل	الوصف	النوع	مثال
ProductName	اسم المنتج المستخدم للحفظ الدائم كاسم للمكوّن	String	Corsair LL Fan
Brand	سلسلة نصية تمثل العلامة التجارية للمكوّن لأغراض التصفية	String	Corsair
Type	سلسلة نصية تمثل نوع المكوّن لأغراض التصفية	String	Fan
LedCount	عدد صحيح يمثل إجمالي عدد مصابيح LED في المكوّن	Int	16
Width	عدد صحيح يمثل عرض مخزن البكسلات المؤقت للمكوّن	Int	5
Height	عدد صحيح يمثل ارتفاع مخزن البكسلات المؤقت للمكوّن	Int	5
LedMapping	مصفوفة تحتوي على الترتيب الذي يجب إرجاع معلومات ألوان LED به	مصفوفة أحادية البعد	[0,1,2]
LedCoordinates	مصفوفة تحتوي على موضع [X,Y] لجميع مصابيح LED	مصفوفة ثنائية البعد	[[0,0],[0,1]]
LedNames	مصفوفة تحتوي على اسم كل مصباح LED	مصفوفة أحادية البعد	[“Led 1”,“Led 2”]
ImageUrl	سلسلة رابط الصورة المستخدمة كصورة مصغّرة للمكوّن	String