Metadata-Version: 2.4
Name: PyColorSpace
Version: 0.0.3
Summary: Color space conversion library
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: opencv-python
Dynamic: license-file

# PyColorSpace

**PyColorSpace** is a Python library for fast, accurate, and easy-to-use color space conversions. It provides a simple and consistent API for converting images between commonly used color spaces while supporting multiple industry-standard color conversion matrices.

## Features

- Fast NumPy-based implementations
- Simple and intuitive API
- Support for multiple color conversion standards:
  - BT.601
  - BT.709
  - BT.2020
- Support for multiple image layouts:
  - HWC (Height × Width × Channels)
  - CHW (Channels × Height × Width)
- Support for normalized and integer image ranges
- Configurable output data types
- Lightweight with minimal dependencies

## Installation

Install PyColorSpace from PyPI:

```bash
pip install PyColorSpace
```


## Supported Color Spaces

PyColorSpace currently supports conversions between:

- RGB
- HSV
- YUV 4:4:4
- YUV 4:2:0

More color spaces will be added in future releases.

## Quick Start

### RGB → YUV444

```python
import PyColorSpace as pcs

yuv = pcs.rgb_to_yuv444(rgb)
```

### YUV444 → RGB

```python
rgb = pcs.yuv444_to_rgb(yuv)
```

### HSV → RGB

```python
rgb = pcs.hsv_to_rgb(hue, saturation, value)
```

### HSV → YUV444

```python
yuv = pcs.hsv_to_yuv444(hue, saturation, value)
```

### HSV → YUV420

```python
Y, U420, V420 = pcs.hsv_to_yuv420(
    hue,
    saturation,
    value
)
```

## Design Goals

PyColorSpace is built with the following goals:

- Accurate color space conversions
- Consistent function interfaces
- High performance using NumPy
- Easy integration into image processing and computer vision projects
- Clean, well-documented APIs

## Requirements

- Python 3.8+
- NumPy

## Documentation

Comprehensive documentation, tutorials, and API references will be added in future releases.

## Contributing

Contributions, feature requests, bug reports, and pull requests are welcome.

## License

This project is licensed under the MIT License.
