FCOnline_Image_Searcher Files

========================================================================
FC Online Player Image Searcher v2.3 - README
========================================================================

[KOREAN / 한국어]

1. 프로그램 정보
   - 프로그램명: FC 온라인 선수 이미지 검색기
   - 버전: v2.3
   - 개발자: 펨코 서유리
   - 기반 기술: Python 3.11, PyQt6
   - 제공 기능: FC 온라인 선수 고유 이미지(Action Shot) 및 미니 페이스온 검색/다운로드

2. v2.3 업데이트 내역 (Change Log)
   v2.2의 기반 위에 강력한 '전체 검색' 기능과 UI 디테일 완성도를 높였습니다.

   A. '미니 페이스온(기본)' 전체 검색 기능 추가
      - 시즌 검색 탭에서 "기본"이라고 입력하면, 데이터베이스에 있는 모든 선수의 
        [cite_start]헤드샷(미니 페이스온)을 전수 조사하여 다운로드합니다. [cite: 30]
      - 약 5만 명 이상의 선수를 탐색하며, 다운로드된 이미지는 [기본]으로 표시됩니다.

   B. '스페셜 시즌' 전체 검색 기능 추가
      - 시즌 검색 탭에서 2자리 숫자(예: 24, 25) 또는 '_24' 입력 시,
        [cite_start]해당 특수 시즌(24시즌 등)을 보유한 모든 선수를 찾아냅니다. [cite: 31]

   C. 검색 편의성 및 정보 표시 강화
      - [cite_start]시즌/전체 검색 시에도 '남은 시간'과 '진행률(%)'이 표시되도록 개선했습니다. [cite: 33]
      - 대량의 데이터 검색 시 작업 종료 시간을 예측할 수 있어 답답함을 해소했습니다.

   D. UI 레이아웃 및 디자인 최적화
      - [cite_start]랭킹 패널 재배치: [랭킹 목록] -> [기준 시간] -> [여백] -> [바로가기] 순서로 변경하여 시선 처리를 개선했습니다. [cite: 36]
      - 여백(Margin) 조정: 패널 내부의 여백을 넓혀 답답한 느낌을 없애고 시각적 편안함을 제공합니다.

   E. 기존 핵심 기능 (v2.2 포함)
      - [cite_start]원형 스피너 로딩 UI 및 [기본 -> 특수 -> 일반] 자동 정렬 시스템. [cite: 34]
      - [cite_start]다크모드 완벽 지원 (바로가기 버튼 포함) 및 투명 배경 카드 적용. [cite: 37]
      - [cite_start]다운로드 오류 수정 (HEAD 요청 우회) 및 랭킹 텍스트 버그 수정. [cite: 40, 42]

3. 주요 기능 및 사용 방법

   [선수 검색 탭]
   - 사용법: 선수 이름(예: 손흥민) 또는 고유 ID(spid) 입력.
   - 기능: 기본 헤드샷부터 특수 시즌, 일반 시즌까지 모든 이미지를 한 번에 찾아줍니다.

   [시즌 검색 탭]
   - 일반 검색: 3자리 시즌 코드(예: 101, 230) 입력 -> 해당 시즌 선수 검색.
   - 스페셜 검색: 2자리 숫자(예: 24) 입력 -> 모든 선수의 '24시즌' 이미지 전수 조사.
   - 기본 검색: "기본" 입력 -> 모든 선수의 미니 페이스온(헤드샷) 전수 조사.

   [즐겨찾기 탭]
   - 기능: 자주 찾는 선수를 등록하여 이미지를 모아볼 수 있습니다.
   - 추가/해제: 이미지 우클릭 -> '즐겨찾기 추가/해제'.

   [이미지 저장]
   - 개별 저장: 이미지 우클릭 -> '이미지 저장'.
   - 일괄 저장: 상단 '전체 저장' 버튼 클릭.

4. 파일 저장 위치 및 데이터 관리
   * 경로: C:\Users\[사용자명]\AppData\Roaming\FCOnlineImageSearcher
   * 포함 파일:
     - player_history.json / season_history.json: 검색 기록
     - favorites.json: 즐겨찾기 목록
     - season_icons 폴더: 시즌 로고 이미지 파일

5. 저작권 및 면책 조항 (Disclaimer)
   - 본 프로그램은 NEXON Korea Corporation이 제공하는 공식 프로그램이 아닙니다.
   - 개인이 NEXON Open API를 활용하여 제작한 팬 메이드 툴입니다.
   - "EA SPORTS FC ONLINE"과 관련된 모든 이미지 및 데이터의 저작권은 넥슨 및 EA에 있습니다.
   - 본 프로그램을 통해 얻은 이미지는 개인적인 용도로만 사용해야 하며, 상업적 이용에 대한 책임은 사용자에게 있습니다.

========================================================================

[ENGLISH / English]

1. Program Information
   - Name: FC Online Player Image Searcher
   - Version: v2.3
   - Developer: Pemco Seoyuri
   - Tech Stack: Python 3.11, PyQt6
   - Function: Search and download action shot/headshot images from FC Online.

2. v2.3 Update Highlights
   Enhancing v2.2 with powerful 'Global Search' features and UI refinements.

   A. 'Global Basic Headshot' Search Added
      - Typing "기본" (Basic) in the Season Search tab initiates a full scan for 
        all players' minifaces (headshots) from the database.
      - Scans over 50,000 players; results are labeled as [Default].

   B. 'Global Special Season' Search Added
      - Entering a 2-digit number (e.g., 24, 25) scans all players for that specific special season images.

   C. Improved Progress Indicators
      - Added 'Remaining Time' and 'Progress (%)' display for Season/Global searches.
      - Crucial for tracking the progress of large-scale scans.

   D. UI Layout & Design Optimization
      - Reordered Ranking Panel: [Ranking List] -> [Timestamp] -> [Spacer] -> [Shortcuts] for better flow.
      - Margin Adjustment: Increased internal margins for a cleaner, less cramped look.

   E. Core Features (Includes v2.2)
      - Circular Spinner Loading & Sorted Results [Headshot -> Special -> Standard].
      - Full Dark Mode support and transparent card backgrounds.
      - Fixes for download blocks (HEAD requests) and ranking display bugs.

3. How to Use

   [Player Search]
   - Enter name or ID to find all images including headshots.

   [Season Search]
   - Standard: Enter 3-digit code (e.g., 101) -> Search players in that season.
   - Special: Enter 2-digit number (e.g., 24) -> Scan all players for 'Season 24' images.
   - Basic: Enter "기본" -> Scan all players for 'Miniface' images.

   [Favorites]
   - Right-click image -> Add/Remove Favorites.

   [Saving Images]
   - Individual: Right-click -> 'Save Image'.
   - Batch: Click 'Save All' button.

4. Data Location
   * Path: C:\Users\[Username]\AppData\Roaming\FCOnlineImageSearcher

5. Disclaimer
   - This is an unofficial, fan-made tool and is not endorsed by NEXON Korea Corporation.
   - All intellectual property rights related to FC Online belong to NEXON and EA.
   - Extracted images are for personal use only.

========================================================================