컴포넌트 구조

컴포넌트의 핵심은 플러그인이 갖는 일반 함수 내보내기, 즉 이름, 크기, LED 수 등을 포함하는 JSON 객체입니다.

디렉토리

이 파일들은 두 가지 디렉토리 중 하나에서 가져옵니다. 내장 파일은 다음 위치에 저장됩니다:

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	컴포넌트 이름으로 지속성을 위해 사용되는 ProductName	String	Corsair LL Fan
Brand	필터링을 위한 컴포넌트의 브랜드를 나타내는 문자열	String	Corsair
Type	필터링을 위한 컴포넌트의 유형을 나타내는 문자열	String	Fan
LedCount	컴포넌트의 총 LED 수를 나타내는 정수	Int	16
Width	컴포넌트의 픽셀 버퍼 너비를 나타내는 정수	Int	5
Height	컴포넌트의 픽셀 버퍼 높이를 나타내는 정수	Int	5
LedMapping	LED 색상 정보를 반환해야 하는 순서를 포함하는 배열	1D 배열	[0,1,2]
LedCoordinates	모든 LED의 [X,Y] 위치를 포함하는 배열	2D 배열	[[0,0],[0,1]]
LedNames	각 LED의 이름을 포함하는 배열	1D 배열	[“Led 1”,“Led 2”]
ImageUrl	컴포넌트의 썸네일로 사용되는 URL 이미지 문자열	String