FCOnline_Image_Searcher Files

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

[KOREAN / 한국어]

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

2. v2.1 업데이트 내역 (Change Log)
   사용자 경험(UX)을 대폭 개선하고, 검색 결과의 가독성을 높이는 데 집중했습니다.

   A. 로딩 애니메이션 및 프로세스 개선
      - 기존의 단순한 로딩 방식에서 세련된 원형 스피너(Spinner) 애니메이션으로 변경했습니다.
      - 이미지 다운로드 진행률(%)이 스피너 중앙에 직관적으로 표시됩니다.
      - 검색 중 화면이 깜빡이거나 이미지가 뒤죽박죽 뜨는 현상을 제거했습니다.

   B. 검색 결과 정렬 최적화
      - 검색이 완료되면 모든 카드가 시즌/ID 순서(오름차순)로 정렬되어 한 번에 표시됩니다.
      - 뒤죽박죽 섞여 있던 시즌 배열 문제를 해결하여 보기가 훨씬 편해졌습니다.

   C. UI 디자인 디테일 강화
      - 랭킹 패널: 배경과 분리된 깔끔한 라운드 박스 디자인을 적용했습니다.
      - 선수 카드: 일반 상태일 때 불필요한 배경색을 제거하여 투명하고 깔끔하게 변경했습니다.
      - 그리드 정렬: 창 크기 변경 시 여백 계산을 정밀화하여 카드가 화면에 꽉 차게 배열됩니다.

   D. 버그 수정 및 안정성
      - 검색 완료 후에도 '전체 저장' 버튼이 비활성화되던 문제를 수정했습니다.
      - 랭킹 패널 하단에 '서버 연결 중...' 텍스트가 중복 표시되던 오류를 해결했습니다.

3. 주요 기능 및 사용 방법

   [선수 검색 탭]
   - 사용법: 선수 이름(예: 손흥민) 또는 고유 ID(spid)를 입력하고 검색합니다.
   - 기능: 해당 선수의 과거부터 현재까지 모든 시즌 이미지를 찾아줍니다.

   [시즌 검색 탭]
   - 사용법: 3자리 시즌 코드(예: 101, 230)를 입력하여 검색합니다.
   - 기능: 데이터 센터에 없는 미확인 시즌도 코드로 탐색할 수 있습니다.

   [즐겨찾기 탭]
   - 기능: 자주 찾는 선수를 등록하여 이미지를 모아볼 수 있습니다.
   - 추가/해제: 검색된 이미지 위에서 마우스 우클릭 후 '즐겨찾기 추가/해제' 선택.

   [이미지 저장]
   - 개별 저장: 이미지 우클릭 -> '이미지 저장' 선택.
   - 일괄 저장: 상단 메뉴의 '전체 저장' 버튼 클릭 (검색 결과가 있을 때만 활성화).

   [결과 내 재검색]
   - 검색 결과가 많을 경우, 상단 입력창에 텍스트를 입력하여 즉시 필터링할 수 있습니다.

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.1
   - Developer: Pemco Seoyuri
   - Tech Stack: Python 3.11, PyQt6
   - Function: Search and download action shot images from FC Online.

2. v2.1 Update Highlights
   Focused on significantly improving User Experience (UX) and result readability.

   A. Enhanced Loading Experience
      - Replaced the simple loading bar with a stylish circular spinner animation.
      - Download progress (%) is now intuitively displayed in the center of the spinner.
      - Eliminated screen flickering and disorganized image loading during searches.

   B. Optimized Result Sorting
      - Results are now displayed all at once, sorted by Season/ID (ascending), after the search finishes.
      - Resolved the issue where player cards appeared in random order.

   C. Refined UI Design
      - Ranking Panel: Applied a clean, rounded box design distinct from the background.
      - Player Cards: Removed unnecessary background colors for non-favorited cards for a cleaner look.
      - Grid Alignment: Improved margin calculations to ensure cards fill the screen efficiently when resizing.

   D. Bug Fixes & Stability
      - Fixed an issue where the 'Save All' button remained disabled after a search.
      - Resolved a bug where "Server connecting..." text appeared duplicated in the ranking panel.

3. How to Use

   [Player Search]
   - Enter a player's name or ID (spid) to find images from all seasons.

   [Season Search]
   - Enter a 3-digit season code to browse all players in that season.

   [Favorites]
   - Right-click an image to add/remove it from your favorites list.

   [Saving Images]
   - Individual: Right-click an image -> Select 'Save Image'.
   - Batch: Click the 'Save All' button at the top.

4. Data Location
   This program stores cache data in the following directory:
   * 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.

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