FCOnline_Image_Searcher Files

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

[KOREAN / 한국어]

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

2. v2.0 업데이트 내역 (Change Log)
   기존 v1.7 버전의 기능을 계승하면서, 구동 엔진을 완전히 교체하여 성능과 디자인을 대폭 개선했습니다.

   A. 엔진 및 프레임워크 전면 교체
      - 기존 Tkinter에서 전문 GUI 프레임워크인 PyQt6로 변경했습니다.
      - 끊김 없는 부드러운 스크롤과 고해상도(HiDPI) 화면을 지원합니다.

   B. UI/UX 디자인 혁신
      - 카드형 레이아웃: 이미지와 정보를 직관적인 카드 형태로 보여줍니다.
      - 반응형 그리드: 창 크기를 조절하면 카드 배열이 자연스럽게 바뀝니다.
      - 시각적 진행률: 검색 진행 상황을 게이지 바(Progress Bar)로 확인할 수 있습니다.

   C. 성능 및 안정성 강화 (Non-blocking)
      - 검색 중에도 프로그램이 멈추지 않으며 다른 작업을 할 수 있습니다.
      - 이미지 로딩 속도와 검색 속도가 더욱 빨라졌습니다.

   D. 기존 편의 기능 강화
      - 다크 모드: 색상 반전이 아닌, 완벽한 테마(QSS)를 적용하여 눈이 편안합니다.
      - 일괄 저장: 검색된 모든 이미지를 더 안정적으로 내 컴퓨터에 저장합니다.

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

2. v2.0 Update Highlights
   The core engine has been upgraded from Tkinter to PyQt6 for better performance and design.

   A. New Framework (PyQt6)
      - Provides a smoother, more responsive user interface.
      - Supports High-DPI displays for sharper visuals.

   B. UI/UX Improvements
      - Card Layout: Displays images and info in a clean card format.
      - Responsive Grid: Automatically adjusts layout when resizing the window.
      - Visual Progress Bar: Shows search progress intuitively.

   C. Enhanced Performance
      - Non-blocking architecture ensures the app remains responsive during searches.
      - Faster image loading and processing.

   D. Feature Enhancements
      - Full Dark Mode: Professional dark theme support via QSS.
      - Improved Batch Save: More stable bulk downloading of images.

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.

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