Metadata-Version: 2.1
Name: custom-motorcycle-helmet-styles
Version: 1.0.0
Summary: Motorcycle helmet shell silhouettes, paintable zones and surface finishes across 33 helmet styles and 5 rider categories.
Home-page: https://custommotorcyclehelmet.com
Author: Custom Motorcycle Helmet
License: MIT
Keywords: motorcycle-helmet,custom-motorcycle-helmet,motocross,helmet-graphics,helmet-wrap
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Project-URL: Homepage, https://custommotorcyclehelmet.com
Project-URL: Online Designer, https://custommotorcyclehelmet.com/design?utm_source=pypi&utm_medium=referral&utm_campaign=pypi
Project-URL: Repository, https://github.com/dirt-bike-graphics/custom-motorcycle-helmet
Project-URL: Issues, https://github.com/dirt-bike-graphics/custom-motorcycle-helmet/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules

# custom-motorcycle-helmet-styles

How motorcycle helmet graphics sit across 33 shell silhouettes, and which paintable zones each style gives you. Covers 12 full face, 7 motocross, 2 adventure, 6 open face and 6 half helmets, plus five surface finishes: gloss, matte, chrome, pearl and carbon fiber.

Use it to filter helmet silhouettes by rider category or check whether a shell includes a closed chin bar and sun peak before laying out a wrap, decal kit or airbrush graphic.

## Install

```bash
pip install custom-motorcycle-helmet-styles
```

## Usage

```python
from custom_motorcycle_helmet_styles import FINISHES, STYLES, by_category, find_style, paintable_zones

find_style("Retro full face")
# {'id': 'retro-full-face', 'category': 'Full face', 'model': 'Retro full face', 'hasPeak': True, 'hasChinBar': True}

len(by_category("Motocross"))
# 7

paintable_zones("jet-long-shield")
# ['crown', 'forehead', 'sides', 'back', 'neck']

len(STYLES), len(FINISHES)
# (33, 5)
```

Style queries are matched loosely: `retro-full-face`, `Retro Full Face` and `retrofullface` resolve to the same entry.

## Data

Each entry in `styles` (also in `styles.json`):

| Field | Example |
|---|---|
| `id` | `retro-full-face` |
| `category` | `Full face`, `Adventure`, `Motocross`, `Open face` or `Half helmet` |
| `model` | `Retro full face` |
| `hasPeak` | `true` |
| `hasChinBar` | `true` |

Surface finishes (`finishes`): `gloss`, `matte`, `chrome`, `pearl`, `carbon-fiber`.

Not covered: brand-specific vent cutouts, aftermarket intercom clamp footprints, or DOT, ECE and Snell shell sizing tolerances. Always verify your helmet maker's paint and vinyl rules before wrapping or spraying a street shell.

## Design graphics on these helmet shells

The catalog comes from [Custom Motorcycle Helmet](https://custommotorcyclehelmet.com), an AI 3D motorcycle helmet designer. Describe the look you want or start from a photo, fit it onto any of the 33 helmet silhouettes, add your name and race number, and spin it in 3D. **[Open the 3D motorcycle helmet designer](https://custommotorcyclehelmet.com/design?utm_source=pypi&utm_medium=referral&utm_campaign=pypi)**

<img src="https://raw.githubusercontent.com/dirt-bike-graphics/custom-motorcycle-helmet/main/assets/helmet-3d-editor-preview.webp" width="640" alt="AI generated motorcycle helmet graphics, edited online in 2D and 3D">

## Contributing

Found a mistake or want to suggest a shell silhouette? [Open an issue](https://github.com/dirt-bike-graphics/custom-motorcycle-helmet/issues) with the helmet style, rider category and reference photos.

## License

MIT
