โครงสร้างคอมโพเนนต์

โดยพื้นฐานแล้ว คอมโพเนนต์คืออ็อบเจกต์ JSON ที่ประกอบด้วยฟังก์ชัน export ทั่วไปแบบเดียวกับที่ปลั๊กอินมี เช่น ชื่อ ขนาด จำนวน LED เป็นต้น

ไดเรกทอรี

ไฟล์เหล่านี้จะถูกดึงมาจากหนึ่งในสองไดเรกทอรี ไฟล์ในตัวจะถูกเก็บไว้ที่:

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

ส่วนไฟล์ที่ผู้ใช้สร้างขึ้นควรเก็บไว้ในไดเรกทอรีผู้ใช้ ซึ่งโดยค่าเริ่มต้นจะอยู่ในเอกสาร:

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

ไฟล์ที่เก็บใน appdata จะถูกเขียนทับทุกครั้งที่อัปเดต ขณะที่ไฟล์ที่เก็บในไดเรกทอรีเอกสารของผู้ใช้จะคงอยู่ข้ามเวอร์ชัน ไฟล์ที่เก็บไว้ที่นั่นยังจะแทนที่ไฟล์ใด ๆ ในไดเรกทอรี appdata ที่มีชื่อผลิตภัณฑ์ตรงกันด้วย คอมโพเนนต์แบบกำหนดเองของผู้ใช้เหล่านี้จะแสดงเหมือนกับคอมโพเนนต์ในตัว พร้อมตัวกรองแบรนด์และประเภทที่สร้างขึ้นโดยอัตโนมัติ

โครงสร้าง JSON

ด้านล่างนี้คือตัวอย่างของ Chair Upgrade Kit ของ “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	ProductName ที่ใช้เป็นชื่อของคอมโพเนนต์สำหรับการบันทึกถาวร	String	Corsair LL Fan
Brand	สตริงที่แสดงแบรนด์ของคอมโพเนนต์สำหรับการกรอง	String	Corsair
Type	สตริงที่แสดงประเภทของคอมโพเนนต์สำหรับการกรอง	String	Fan
LedCount	จำนวนเต็มที่แสดงจำนวน LED ทั้งหมดของคอมโพเนนต์	Int	16
Width	จำนวนเต็มที่แสดงความกว้างของบัฟเฟอร์พิกเซลของคอมโพเนนต์	Int	5
Height	จำนวนเต็มที่แสดงความสูงของบัฟเฟอร์พิกเซลของคอมโพเนนต์	Int	5
LedMapping	อาร์เรย์ที่ระบุลำดับที่ข้อมูลสีของ LED ควรถูกส่งคืน	อาร์เรย์ 1 มิติ	[0,1,2]
LedCoordinates	อาร์เรย์ที่มีตำแหน่ง [X,Y] ของ LED ทั้งหมด	อาร์เรย์ 2 มิติ	[[0,0],[0,1]]
LedNames	อาร์เรย์ที่มีชื่อของ LED แต่ละดวง	อาร์เรย์ 1 มิติ	[“Led 1”,“Led 2”]
ImageUrl	สตริง URL ของรูปภาพที่ใช้เป็นภาพขนาดย่อของคอมโพเนนต์	String