- 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]
- OpenCV discrete transforms documentation (cv2.dct / cv2.idct): docs.opencv.org/4.x/d2/de8/group__core__array.html
This SDK is built in AppForAI - AI Dev Tools.