# ImageEnhancer
ImageEnhancer는 다양한 이미지 처리 기능을 제공하는 Python 패키지입니다. 로컬 이미지 파일과 URL의 이미지를 모두 처리할 수 있으며, 노이즈 제거, 밝기/대비 조정, 색상 강화, 선명도 증가, 크기 조정, 회전 등 다양한 기능을 제공합니다.
## 설치
pip를 사용하여 ImageEnhancer를 설치할 수 있습니다:
```bash
pip install image-enhancer
```
## 사용법
기본적인 사용법은 다음과 같습니다:
```python
from image_enhancer import ImageEnhancer
enhancer = ImageEnhancer(output_dir="enhanced_images")
# 로컬 이미지 파일 처리
enhanced_path = enhancer.enhance("path/to/local/image.jpg", {
"brightness": 1.2,
"contrast": 1.1,
"sharpness": 1.5
}, "enhanced_local_image.jpg")
# URL의 이미지 처리
url = "https://example.com/image.jpg"
enhanced_path = enhancer.enhance(url, {
"denoise_strength": 10,
"saturation": 1.2,
"gamma": 1.1
}, "enhanced_url_image.jpg")
print(f"Enhanced image saved at: {enhanced_path}")
```
## 주요 기능
ImageEnhancer는 다음과 같은 주요 기능을 제공합니다:
- 노이즈 제거 (`denoise_strength`)
- 밝기 조정 (`brightness`)
- 대비 조정 (`contrast`)
- 색상 강화 (`color`)
- 채도 조정 (`saturation`)
- 색조 이동 (`hue_shift`)
- 선명도 증가 (`sharpness`)
- 엣지 강화 (`edge_enhance`)
- 감마 보정 (`gamma`)
- 크기 조정 (`width`, `height`)
- 회전 (`rotation_angle`)
- 뒤집기 (`flip_direction`)
- 자르기 (`crop_box`)
- 워터마크 추가 (`watermark_text`, `watermark_position`)
- 필터 적용 (`filter`)
- HSL 조정 (`hue`, `saturation`, `lightness`)
각 기능은 `enhance` 메서드에 전달되는 파라미터 딕셔너리를 통해 조절할 수 있습니다.
## 고급 기능
### 배치 처리
여러 이미지를 동시에 처리할 수 있습니다:
```python
enhancer = ImageEnhancer()
params = {"brightness": 1.2, "contrast": 1.1}
image_paths = ["image1.jpg", "image2.jpg", "image3.jpg"]
output_names = ["enhanced1.jpg", "enhanced2.jpg", "enhanced3.jpg"]
results = enhancer.batch_process(image_paths, params, output_names)
```
### 처리 전후 비교
원본 이미지와 처리된 이미지를 나란히 비교할 수 있습니다:
```python
comparison_path = enhancer.compare_before_after("original.jpg", params, "comparison.jpg")
```
## 예제
```python
enhancer = ImageEnhancer()
params = {
"denoise_strength": 5,
"brightness": 1.2,
"contrast": 1.1,
"color": 1.1,
"saturation": 1.2,
"hue_shift": 10,
"sharpness": 1.5,
"edge_enhance": 1.2,
"gamma": 1.1,
"width": 800,
"height": 600,
"rotation_angle": 45,
"flip_direction": "horizontal",
"crop_box": (100, 100, 700, 500),
"watermark_text": "Copyright 2024",
"watermark_position": (50, 50),
"filter": "emboss"
}
enhanced_path = enhancer.enhance("https://example.com/image.jpg", params, "enhanced_image.jpg")
print(f"Enhanced image saved at: {enhanced_path}")
```
## 프로젝트 구조
```
image-enhancer/
├── image_enhancer/
│ ├── __init__.py
│ └── enhancer.py
├── tests/
│ └── test_enhancer.py
├── README.md
├── setup.py
└── requirements.txt
```
## 기여하기
버그 리포트, 기능 제안, 풀 리퀘스트 등 모든 기여를 환영합니다. 기여하기 전에 프로젝트의 이슈 트래커를 확인해 주세요.
## 라이선스
이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 `LICENSE` 파일을 참조하세요.
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/image-enhancer",
"name": "image-enhancer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Your Name",
"author_email": "your.email@example.com",
"download_url": "https://files.pythonhosted.org/packages/db/47/3ff783abcdb4ce6c11cbe8d6edbe7e07a7d726e4ce6143cc7fc9f5154d79/image-enhancer-0.1.3.tar.gz",
"platform": null,
"description": "# ImageEnhancer\n\nImageEnhancer\ub294 \ub2e4\uc591\ud55c \uc774\ubbf8\uc9c0 \ucc98\ub9ac \uae30\ub2a5\uc744 \uc81c\uacf5\ud558\ub294 Python \ud328\ud0a4\uc9c0\uc785\ub2c8\ub2e4. \ub85c\uceec \uc774\ubbf8\uc9c0 \ud30c\uc77c\uacfc URL\uc758 \uc774\ubbf8\uc9c0\ub97c \ubaa8\ub450 \ucc98\ub9ac\ud560 \uc218 \uc788\uc73c\uba70, \ub178\uc774\uc988 \uc81c\uac70, \ubc1d\uae30/\ub300\ube44 \uc870\uc815, \uc0c9\uc0c1 \uac15\ud654, \uc120\uba85\ub3c4 \uc99d\uac00, \ud06c\uae30 \uc870\uc815, \ud68c\uc804 \ub4f1 \ub2e4\uc591\ud55c \uae30\ub2a5\uc744 \uc81c\uacf5\ud569\ub2c8\ub2e4.\n\n## \uc124\uce58\n\npip\ub97c \uc0ac\uc6a9\ud558\uc5ec ImageEnhancer\ub97c \uc124\uce58\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4:\n\n```bash\npip install image-enhancer\n```\n\n## \uc0ac\uc6a9\ubc95\n\n\uae30\ubcf8\uc801\uc778 \uc0ac\uc6a9\ubc95\uc740 \ub2e4\uc74c\uacfc \uac19\uc2b5\ub2c8\ub2e4:\n\n```python\nfrom image_enhancer import ImageEnhancer\n\nenhancer = ImageEnhancer(output_dir=\"enhanced_images\")\n\n# \ub85c\uceec \uc774\ubbf8\uc9c0 \ud30c\uc77c \ucc98\ub9ac\nenhanced_path = enhancer.enhance(\"path/to/local/image.jpg\", {\n \"brightness\": 1.2,\n \"contrast\": 1.1,\n \"sharpness\": 1.5\n}, \"enhanced_local_image.jpg\")\n\n# URL\uc758 \uc774\ubbf8\uc9c0 \ucc98\ub9ac\nurl = \"https://example.com/image.jpg\"\nenhanced_path = enhancer.enhance(url, {\n \"denoise_strength\": 10,\n \"saturation\": 1.2,\n \"gamma\": 1.1\n}, \"enhanced_url_image.jpg\")\n\nprint(f\"Enhanced image saved at: {enhanced_path}\")\n```\n\n## \uc8fc\uc694 \uae30\ub2a5\n\nImageEnhancer\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \uc8fc\uc694 \uae30\ub2a5\uc744 \uc81c\uacf5\ud569\ub2c8\ub2e4:\n\n- \ub178\uc774\uc988 \uc81c\uac70 (`denoise_strength`)\n- \ubc1d\uae30 \uc870\uc815 (`brightness`)\n- \ub300\ube44 \uc870\uc815 (`contrast`)\n- \uc0c9\uc0c1 \uac15\ud654 (`color`)\n- \ucc44\ub3c4 \uc870\uc815 (`saturation`)\n- \uc0c9\uc870 \uc774\ub3d9 (`hue_shift`)\n- \uc120\uba85\ub3c4 \uc99d\uac00 (`sharpness`)\n- \uc5e3\uc9c0 \uac15\ud654 (`edge_enhance`)\n- \uac10\ub9c8 \ubcf4\uc815 (`gamma`)\n- \ud06c\uae30 \uc870\uc815 (`width`, `height`)\n- \ud68c\uc804 (`rotation_angle`)\n- \ub4a4\uc9d1\uae30 (`flip_direction`)\n- \uc790\ub974\uae30 (`crop_box`)\n- \uc6cc\ud130\ub9c8\ud06c \ucd94\uac00 (`watermark_text`, `watermark_position`)\n- \ud544\ud130 \uc801\uc6a9 (`filter`)\n- HSL \uc870\uc815 (`hue`, `saturation`, `lightness`)\n\n\uac01 \uae30\ub2a5\uc740 `enhance` \uba54\uc11c\ub4dc\uc5d0 \uc804\ub2ec\ub418\ub294 \ud30c\ub77c\ubbf8\ud130 \ub515\uc154\ub108\ub9ac\ub97c \ud1b5\ud574 \uc870\uc808\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n\n## \uace0\uae09 \uae30\ub2a5\n\n### \ubc30\uce58 \ucc98\ub9ac\n\n\uc5ec\ub7ec \uc774\ubbf8\uc9c0\ub97c \ub3d9\uc2dc\uc5d0 \ucc98\ub9ac\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4:\n\n```python\nenhancer = ImageEnhancer()\nparams = {\"brightness\": 1.2, \"contrast\": 1.1}\nimage_paths = [\"image1.jpg\", \"image2.jpg\", \"image3.jpg\"]\noutput_names = [\"enhanced1.jpg\", \"enhanced2.jpg\", \"enhanced3.jpg\"]\nresults = enhancer.batch_process(image_paths, params, output_names)\n```\n\n### \ucc98\ub9ac \uc804\ud6c4 \ube44\uad50\n\n\uc6d0\ubcf8 \uc774\ubbf8\uc9c0\uc640 \ucc98\ub9ac\ub41c \uc774\ubbf8\uc9c0\ub97c \ub098\ub780\ud788 \ube44\uad50\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4:\n\n```python\ncomparison_path = enhancer.compare_before_after(\"original.jpg\", params, \"comparison.jpg\")\n```\n\n## \uc608\uc81c\n\n```python\nenhancer = ImageEnhancer()\n\nparams = {\n \"denoise_strength\": 5,\n \"brightness\": 1.2,\n \"contrast\": 1.1,\n \"color\": 1.1,\n \"saturation\": 1.2,\n \"hue_shift\": 10,\n \"sharpness\": 1.5,\n \"edge_enhance\": 1.2,\n \"gamma\": 1.1,\n \"width\": 800,\n \"height\": 600,\n \"rotation_angle\": 45,\n \"flip_direction\": \"horizontal\",\n \"crop_box\": (100, 100, 700, 500),\n \"watermark_text\": \"Copyright 2024\",\n \"watermark_position\": (50, 50),\n \"filter\": \"emboss\"\n}\n\nenhanced_path = enhancer.enhance(\"https://example.com/image.jpg\", params, \"enhanced_image.jpg\")\nprint(f\"Enhanced image saved at: {enhanced_path}\")\n```\n\n## \ud504\ub85c\uc81d\ud2b8 \uad6c\uc870\n\n```\nimage-enhancer/\n\u251c\u2500\u2500 image_enhancer/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2514\u2500\u2500 enhancer.py\n\u251c\u2500\u2500 tests/\n\u2502 \u2514\u2500\u2500 test_enhancer.py\n\u251c\u2500\u2500 README.md\n\u251c\u2500\u2500 setup.py\n\u2514\u2500\u2500 requirements.txt\n```\n\n## \uae30\uc5ec\ud558\uae30\n\n\ubc84\uadf8 \ub9ac\ud3ec\ud2b8, \uae30\ub2a5 \uc81c\uc548, \ud480 \ub9ac\ud018\uc2a4\ud2b8 \ub4f1 \ubaa8\ub4e0 \uae30\uc5ec\ub97c \ud658\uc601\ud569\ub2c8\ub2e4. \uae30\uc5ec\ud558\uae30 \uc804\uc5d0 \ud504\ub85c\uc81d\ud2b8\uc758 \uc774\uc288 \ud2b8\ub798\ucee4\ub97c \ud655\uc778\ud574 \uc8fc\uc138\uc694.\n\n## \ub77c\uc774\uc120\uc2a4\n\n\uc774 \ud504\ub85c\uc81d\ud2b8\ub294 MIT \ub77c\uc774\uc120\uc2a4 \ud558\uc5d0 \ubc30\ud3ec\ub429\ub2c8\ub2e4. \uc790\uc138\ud55c \ub0b4\uc6a9\uc740 `LICENSE` \ud30c\uc77c\uc744 \ucc38\uc870\ud558\uc138\uc694.\n",
"bugtrack_url": null,
"license": null,
"summary": "A package for enhancing images with various filters and adjustments",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/yourusername/image-enhancer"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2f0ce2f6aac745649aa4bb6c794d4ad86a7bf4b93fda42e3899d9e88add9e892",
"md5": "24ebbaa5fa59977bf719b12ee1f67204",
"sha256": "7d3f6978d05e87142b028fe78c5a5437fb0a6cee34986d663a46eb9e45c201cf"
},
"downloads": -1,
"filename": "image_enhancer-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "24ebbaa5fa59977bf719b12ee1f67204",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 7657,
"upload_time": "2024-08-29T08:12:05",
"upload_time_iso_8601": "2024-08-29T08:12:05.888423Z",
"url": "https://files.pythonhosted.org/packages/2f/0c/e2f6aac745649aa4bb6c794d4ad86a7bf4b93fda42e3899d9e88add9e892/image_enhancer-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "db473ff783abcdb4ce6c11cbe8d6edbe7e07a7d726e4ce6143cc7fc9f5154d79",
"md5": "f48e435113590bbda0125933c1dd81e2",
"sha256": "6bfa81a03ae51682f4454fcd5476f4f58e24e477f73055ae32abd1498190d178"
},
"downloads": -1,
"filename": "image-enhancer-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "f48e435113590bbda0125933c1dd81e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 7001,
"upload_time": "2024-08-29T08:12:06",
"upload_time_iso_8601": "2024-08-29T08:12:06.867042Z",
"url": "https://files.pythonhosted.org/packages/db/47/3ff783abcdb4ce6c11cbe8d6edbe7e07a7d726e4ce6143cc7fc9f5154d79/image-enhancer-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-29 08:12:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "image-enhancer",
"github_not_found": true,
"lcname": "image-enhancer"
}
JSON
