사용자 정의 커서

개요¶

사용자 정의 커서(Custom Cursor) 란 Hive UI에 일반적인 마우스 커서가 아닌 사용자가 원하는 커서 모양을 로드할 수 있는 기능입니다. 사용자는 게임 외에도 약관동의 팝업, 로그인 팝업과 같은 Hive에서 제공하는 UI에 커스터마이징된 커서를 적용함으로써 게임과 하이브 UI 간의 커서 스타일 이질감을 줄일 수 있습니다.

지원 파일 형식¶

사용자 정의 커서로 지원되는 파일 형식은 아래와 같습니다.

• CUR 파일
• ICO 파일
• PNG 파일

동작 우선 순위¶

Hive SDK에서 커서 파일을 로드하는 우선 순위는 아래와 같습니다.

• CUR, ICO, PNG 파일이 모두 존재할 경우: 파일 형식 CUR → ICO → PNG 순서로 각 파일을 읽어 커서로 표시합니다.
• 파일명(예: customcursor)이 동일한 경우: customcursor.cur, customcursor.ico, customcursor.png 파일 중 우선 순위에 따라 가장 먼저 읽힌 파일만 커서로 표시합니다.

사용자 설정¶

사용자 정의 커서를 사용하려면 크게 리소스 폴더 설정과 핫스파 지정을 해야 합니다.

리소스 폴더 설정¶

Resources 폴더 하위에 customcursor.확장자명 형식으로 파일을 배치합니다.

핫스팟 지정¶

커서 파일 유형에 따른 핫스파 지정 방식은 아래와 같습니다.

• CUR 파일: 핫스팟 정보(Hotspot Information)를 포함하고 있어, 이를 기반으로 커서를 정확히 표시합니다.

• ICO 및 PNG 파일: 핫스팟 정보를 포함하지 않으므로, 기본적으로 좌표 (0,0) 을 핫스팟으로 지정합니다.

유의 사항¶

Hive SDK에 사용자 정의 커서 기능을 적용 시, 아래 사항을 유의하세요.

• 최대 지원 해상도는 256x256 픽셀입니다. CUR, ICO, PNG 파일의 각 해상도가 256x256 파일을 초과하는 경우, 해당 커서가 올바르게 표시되지 않을 수 있습니다.

• ICO 파일 및 CUR 파일은 여러 개의 이미지 사이즈를 지원하지만, Hive SDK는 미리 지정된 기본 사이즈로만 커서를 표시합니다.

• PNG 파일은 투명 처리된 영역도 이미지 영역으로 간주됩니다.따라서 좌측 상단을 (0,0) 핫스팟 지정에 따른 문제를 방지하려면 좌측 상단에 투명 영역을 사용하지 않는 것을 권장합니다.