Gå til indhold

Komponentstruktur

En komponent er i sin kerne et JSON-objekt der indeholder de sædvanlige funktionseksporter som et plugin ville have, såsom navn, størrelse, LED-antal osv.

Disse filer indlæses fra én af to mapper. Indbyggede filer gemmes i:

C:\Users\[DIT BRUGERNAVN]\AppData\Local\VortxEngine\app-[AKTUEL VERSION]\Signal-x64\Components

Og brugerdefinerede filer bør gemmes i brugermappen. Som standard befinder denne sig i Dokumenter:

C:\Users\[DIT BRUGERNAVN]\Documents\WhirlwindFX\Components

Filer der er gemt i AppData overskrives ved hvert opdatering, mens filer i brugerens Dokumenter-mappe bevares mellem versioner. Filer gemt der overskriver også alle filer i AppData-mappen med et matchende produktnavn. Disse brugerdefinerede komponenter vises ligesom en indbygget komponent med automatisk genererede mærke- og typefiltre.

JSON-struktur

Nedenfor vises et eksempel på et “Vertagear”-stolopgraderingskit udtrykt som en komponent med alle nødvendige attributter.

  • Bemærk: Hyppige fejl og advarsler ved indlæsning af disse filer udskrives i debug-logs.
{
"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": ""
}
ParameterBeskrivelseTypeEksempel
ProductNameDet ProductName der bruges til persistens som komponentens navnStringCorsair LL Fan
BrandStreng der repræsenterer komponentens mærke til filtreringStringCorsair
TypeStreng der repræsenterer komponentens type til filtreringStringFan
LedCountHeltal der repræsenterer det samlede antal LED’er i komponentenInt16
WidthHeltal der repræsenterer bredden af komponentens pixel-bufferInt5
HeightHeltal der repræsenterer højden af komponentens pixel-bufferInt5
LedMappingArray der indeholder den rækkefølge hvori LED-farveinformationer skal returneres1D Array[0,1,2]
LedCoordinatesArray der indeholder [X,Y]-positionen for alle LED’er2D Array[[0,0],[0,1]]
LedNamesArray der indeholder navnet på hver LED1D Array[“Led 1”,“Led 2”]
ImageUrlURL-billedstreng der bruges som forhåndsvisningsbillede for komponentenString