• Version: 20261019
  • Source Code Copyright: Unknown
  • Redistribution Restriction: This source code is integrated by LEADERG INC. Please use it privately. Please DO NOT distribute it to internet.

Console/terminal demo of DCT-based image compression, supporting Windows 11, Ubuntu Linux 24.04 and macOS 14+ (Apple Silicon): the grayscale input is transformed with cv2.dct, only the low-frequency coefficients are kept (rows/columns up to --keep), and the image is reconstructed with cv2.idct — a minimal picture of how JPEG-style compression works. Three example images ship under data/; the results are saved to model/dct/. CPU only: the pip opencv-python build has no GPU backend (no CUDA, no Apple GPU), and one image takes milliseconds.

 

[Folder Structure]

  • CLAUDE.md / AGENTS.md: Program specification (identical content).
  • CHANGELOG.md: Change log.
  • copyright.txt: Copyright notice.
  • Image-OpenCV-DCT-Python.html: This document (usage page).
  • data/: Example images: Lena.png (the notebook's example), SC-150.png, sample.png.
  • model/dct/: Results: gray.png, dct.png, idct.png (ships with the Lena examples).
  • tool/tools.py: Shared helpers.
  • src/: The demo and launcher scripts.
  • venv/: Python virtual environment, created by 02_venv_create_windows/linux/mac.

[Prerequisites]

  • Python 3.14, installed by 01_python_install_windows.bat / 01_python_install_linux.sh / 01_python_install_mac.sh (Windows: winget; Ubuntu: apt, or the deadsnakes PPA when the Ubuntu archive has no python3.14; macOS: Homebrew).
  • 02_venv_create_windows.bat / 02_venv_create_linux.sh / 02_venv_create_mac.sh create venv/ with Python 3.14 and install numpy and opencv-python from src/requirements.txt (same packages on every OS).
  • GPU: none. CPU only on every OS, because the pip opencv-python build has no GPU backend; no NVIDIA driver or CUDA is needed.

[Launcher Scripts]

1. 01_python_install_windows.bat / 01_python_install_linux.sh / 01_python_install_mac.sh

Install Python 3.14 (winget / apt or deadsnakes PPA, needs sudo / Homebrew). Skips the install when Python 3.14 is already present. On Windows, open a new terminal afterwards.

 

2. 02_venv_create_windows.bat / 02_venv_create_linux.sh / 02_venv_create_mac.sh

Delete the old venv/, create a fresh one with Python 3.14, install src/requirements.txt. Aborts loudly if pip fails.

 

3. 03_venv_activate.bat / 03_venv_activate.sh

Activate the venv. On Linux/macOS, source it: source src/03_venv_activate.sh (bash or zsh). If the project folder was renamed after the venv was created, re-create the venv with 02_venv_create_windows/linux/mac first; the other launchers do not need activation.

 

4. 04_dct.bat / 04_dct.sh

Run the DCT compression demo (extra arguments are forwarded).

 

5. 99_venv_clean.bat / 99_venv_clean.sh

Delete the venv/ folder.

 

6. 99_venv_deactivate.bat / 99_venv_deactivate.sh

Deactivate the venv in the current shell. On Linux/macOS, source it: source src/99_venv_deactivate.sh (bash or zsh).

[Python Entry Point]

src/dct.py

[--source IMG] [--keep 100] [--output-dir DIR] [--show]. Defaults follow the notebook: keep coefficients up to index 100 (3.9% of them on the 512x512 Lena). Saves gray.png, dct.png (log-magnitude coefficient view), and idct.png (the reconstruction) to model/dct/, and prints the kept-coefficient ratio; --show also opens the results in windows. Smaller --keep values compress harder and show more ringing. Runs on the CPU (OpenCV's pip build has no GPU backend); there is no --device option.

[Quick Start]

Windows 11

src\01_python_install_windows.bat

REM open a new terminal

src\02_venv_create_windows.bat

src\04_dct.bat

 

Ubuntu 24.04

bash src/01_python_install_linux.sh

bash src/02_venv_create_linux.sh

bash src/04_dct.sh

 

macOS 14+ (Apple Silicon)

bash src/01_python_install_mac.sh

bash src/02_venv_create_mac.sh

bash src/04_dct.sh

Harder compression or your own image:

bash src/04_dct.sh --source data/SC-150.png --keep 50

[References]

 

This SDK is built in AppForAI - AI Dev Tools.