Component Structure

A component at its core is a JSON object containing the normal function exports a plugin would have, like name, size, LED count, etc.

If you are editing files you'll need to reselect the component to update it with changes

Directories

These files are grabbed from one of two directories. Built-in ones are stored in:

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

And user-made files should be stored in the User Directory. By default this is in documents:

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

Files stored in appdata are overwritten on each update, while ones stored in the user's documents directory will persist between versions. Files stored there will also override anything in the appdata directory with a matching product name. These custom user components will show up just like a built in component, with automatically generated brand and type filters.

JSON Structure

Below is an example of a "Vertagear" Chair Upgrade Kit being expressed as a component with all necessary attributes.

  • Note: Common errors and warnings when loading these files will be printed to the debug logs.
Javascript
Copy
ParameterDescriptionTypeExample
ProductNameThe ProductName used for persistence as the component's nameStringCorsair LL Fan
BrandString representing the component's brand for filteringStringCorsair
TypeString representing the component's type for filteringStringFan
LedCountInteger representing the total LED count of the componentInt16
WidthInteger representing the width of the component's pixel bufferInt5
HeightInteger representing the height of the component's pixel bufferInt5
LedMappingArray containing the order LED color info should be returned in1D Array[0,1,2]
LedCoordinatesArray containing the [X,Y] position of all LEDs2D Array[[0,0],[0,1]]
LedNamesArray containing the name of each LED1D Array["Led 1","Led 2"]
ImageUrlURL Image String used as the component's thumbnailString

Images should be formatted in a 1024x1024 image size with a live area of 920x920.

Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard