easycv-lib 0.3.0

A convenient wrapper library for OpenCV - Simple and easy-to-use computer vision tools

EasyCV

یک کتابخانه راحت و ساده برای کار با OpenCV

نصب

نصب از PyPI

کتابخانه در PyPI منتشر شده است. برای نصب:

pip install easycv-lib

نکته: نام پکیج در PyPI easycv-lib است (چون نام easycv قبلاً گرفته شده بود)، اما بعد از نصب می‌توانید با import easycv استفاده کنید.

روش 1: نصب از پوشه پروژه (برای توسعه)

از پوشه اصلی پروژه این دستور را اجرا کنید:

pip install .

بعد از نصب، می‌توانید از هر جای سیستم از کتابخانه استفاده کنید:

import easycv.vision
easycv.vision.open_live_window()

روش 2: نصب با اسکریپت خودکار

ویندوز:

build_and_install.bat

لینوکس/Mac:

chmod +x build_and_install.sh
./build_and_install.sh

یا با Python:

python install.py

روش 3: نصب از فایل wheel (بعد از build)

اگر قبلاً کتابخانه را build کرده‌اید:

# ابتدا build کنید
python -m build

# سپس از فایل wheel نصب کنید
pip install dist/easycv-0.1.0-py3-none-any.whl

روش 4: نصب در حالت توسعه (برای توسعه‌دهندگان)

اگر می‌خواهید تغییرات را بلافاصله ببینید:

pip install -e .

نکته: برای نصب از PyPI از pip install easycv-lib استفاده کنید.

استفاده

توابع موجود

• open_live_window() - نمایش ویدیو زنده از دوربین
• open_live_window_from_file() - پخش ویدیو از فایل
• load_image() - بارگذاری تصویر از فایل
• detect_hand() - تشخیص دست انسان (با MediaPipe)
• detect_face() - تشخیص چهره انسان (با MediaPipe)

روش 1: استفاده از ماژول (پیشنهادی)

import easycv.vision as cv

# باز کردن پنجره لایو
cv.open_live_window(window_name="Live Feed", show_fps=True)

# بارگذاری تصویر
img = cv.load_image("photo.jpg")

# تشخیص دست
result_img, hands = cv.detect_hand(img, draw_landmarks=True)
print(f"تعداد دست‌ها: {len(hands)}")

# تشخیص چهره
result_img, faces = cv.detect_face(img, draw_landmarks=True)
print(f"تعداد چهره‌ها: {len(faces)}")

روش 2: Import مستقیم توابع

from easycv import open_live_window, load_image, detect_hand, detect_face

open_live_window(window_name="Live Feed", show_fps=True)
img = load_image("photo.jpg")
result, hands = detect_hand(img)

روش 3: Import ماژول با نام کوتاه‌تر

from easycv import vision

vision.open_live_window(window_name="Live Feed", show_fps=True)

ساختار پروژه

easycv/
├── __init__.py          # نقطه ورود اصلی
├── vision.py            # ماژول پردازش ویدیو و دوربین
└── ...

توسعه

این پروژه در حال توسعه است و توابع به تدریج اضافه خواهند شد.