# CoreIX overview

> An introduction to CoreIX, the media processing engine built into Bitiful S4.

**CoreIX** is Bitiful's in-house, high-performance, real-time **media processing engine**.

For images, videos, and other media stored in S4 object storage, append **processing parameters** to the end of the URL (or pass them in a GetObject request) and get the processed result in real time. Processing never modifies the original object in your bucket.

> **Warning**
>
> **Note** CoreIX is currently in beta and free of charge. The billing start date and pricing will be announced separately, so keep an eye on our announcements.

## Quickstart

Add parameters to the end of a media file's URL:

```text
Original image: https://demo.bitiful.com/girl.jpeg
```

With processing parameters: [**`https://demo.bitiful.com/girl.jpeg?w=800&h=500&pos=top`**](https://demo.bitiful.com/girl.jpeg?w=800\&h=500\&pos=top)

![Resized, keeping the top](https://demo.bitiful.com/girl.jpeg?w=800\&h=500\&pos=top)

You can combine multiple parameters freely, for example to resize, add a watermark, and convert the format in a single request.

## Key features

1. **Exceptional performance**: Up to **10x** faster or more than mainstream image processing services in China.
2. **End-to-end HDR**: HDR photos and videos stay HDR after cropping, resizing, and watermarking, and can be mapped to SDR with a single parameter.
3. **Professional color management**: Accurately handles color spaces such as CMYK, Display P3, and Adobe RGB.
4. **Very large images**: Supports images up to **200 MB**.
5. **Content awareness**: Automatically detects and preserves faces, people, pets, and the main subject when cropping. It can also blur faces automatically and pick video cover frames.
6. **Broad format coverage**: Natively supports camera RAW, SVG, PDF, OpenEXR, JPEG XL, and more. See [Supported formats](/en/formats).
7. **Live Photos**: Extracts the still image and video from Live Photos (motion photos) on iOS and major Android brands, and converts between them.
8. **Video and animated images**: Extract frames from and clip videos, and convert between video and animated images.
9. **Built-in image analysis**: Text recognition (OCR), color palettes, perceptual hashes, content labels, similar-image features, and BlurHash and ThumbHash placeholders.
10. **Quantized compression**: `fmt=tpng` delivers compression similar to TinyPNG.

## Automatic optimizations

Before applying the parameters you specify, CoreIX performs a set of automatic optimizations that balance **visual accuracy** against **data transfer savings**:

- **Auto-orientation**: Rotates images based on their Exif orientation. Supports JPEG, PNG, WebP, AVIF, HEIF, and major camera RAW formats.
- **Metadata stripping**: Removes Exif data that is useless when sharing images, saving up to about `500 KiB`.
- **Automatic color management**: Performs any necessary color space conversion when generating thumbnails and slims down the color profile, saving up to about `2.5 MiB` for images in uncommon color spaces.
- **HDR preservation**: HDR sources produce HDR output by default. Add `hdr-rate=0` to map to SDR without a washed-out look.
- **Format negotiation**: `fmt=auto` picks JPEG XL, AVIF, or WebP based on what the browser supports. If you explicitly request a format the browser doesn't support, CoreIX falls back automatically.
- **Smart lossless**: Images with few colors, such as icons and screenshots, are automatically encoded with a lossless palette, making them smaller without any quality loss.

## Feature overview

### Size and cropping

| Feature                                              | Key parameters                     | Description                                                                           |  Applies to  |
| :--------------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------- | :----------: |
| [Resize images](/en/coreix/features/resize)          | `w` `h` `dpr` `mode`               | Proportional resize, crop, pad, or stretch                                            |      All     |
| [Smart crop](/en/coreix/features/resize)             | `pos`                              | Keep a given position when cropping, or automatically keep faces and the main subject |      All     |
| [Custom crop](/en/coreix/features/crop)              | `rect`                             | Extract any rectangular region by coordinates                                         |    Images    |
| [Trim borders](/en/coreix/features/trim)             | `trim`                             | Automatically remove solid-color or transparent borders                               | Still images |
| [Shapes and canvas](/en/coreix/features/draw-canvas) | `flip` `border` `pad` `box` `mask` | Flip, borders, padding, color blocks, rounded corners, and circles                    |    Images    |

### Quality and color

| Feature                                                         | Key parameters                        | Description                                                                               |   Applies to  |
| :-------------------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------- | :-----------: |
| [Output quality](/en/coreix/features/quality)                   | `q`                                   | Adjust the compression quality of lossy formats                                           |      All      |
| [Sharpen images](/en/coreix/features/sharp)                     | `sharp` `usm`                         | Improve sharpness                                                                         |  Still images |
| [Blur images](/en/coreix/features/blur)                         | `blur` `px`                           | Blur and pixelate                                                                         |  Still images |
| [Color adjustment and auto enhance](/en/coreix/features/adjust) | `enhance` `bri` `con` `sat`, and more | Enhance images in one step, or manually adjust brightness, contrast, saturation, and more |     Images    |
| [Color management](/en/coreix/features/colorspace)              | `cs`                                  | Set the output color space                                                                |  Still images |
| [HDR processing](/en/coreix/hdr)                                | `hdr-rate` `hdr-fmt`                  | Control HDR brightness and output form, or convert to SDR                                 | Images, video |

### Watermarks

| Feature                                                      | Key parameters | Description                                                                             |  Applies to  |
| :----------------------------------------------------------- | -------------- | --------------------------------------------------------------------------------------- | :----------: |
| [Text watermarks](/en/coreix/features/watermark)             | `txt`          | Fonts, color, stroke, shadow, background box, line breaks, rotation, and tiling         | Still images |
| [Image watermarks](/en/coreix/features/watermark-image)      | `mark`         | Bitmap or SVG watermarks, with tiling and blend modes                                   | Still images |
| [SVG template watermarks](/en/coreix/features/watermark-svg) | `mark` + `txt` | Fill text into an SVG template dynamically for multiple text blocks and complex layouts | Still images |
| [Watermark fonts](/en/coreix/features/watermark-fonts)       | `txt-font`     | List of available fonts                                                                 |       –      |

### Privacy

| Feature                                           | Key parameters           | Description                                          |  Applies to  |
| :------------------------------------------------ | ------------------------ | ---------------------------------------------------- | :----------: |
| [Face blurring](/en/coreix/features/face-privacy) | `face-blur` `face-pixel` | Automatically detect faces and blur or pixelate them | Still images |

### Video and animated images

| Feature                                                                | Key parameters | Description                                                                           |       Applies to       |
| :--------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------- | :--------------------: |
| [Extract frames from video and animations](/en/coreix/features/frame)  | `frame`        | Capture a frame by timestamp or frame index, or automatically pick a cover frame      | Video, animated images |
| [Clip video and convert to animations](/en/coreix/features/video-clip) | `frame` range  | Clip videos, extract animated segments, and convert between video and animated images | Video, animated images |

> **Note**
>
> Video processing works only on files already stored in S4 object storage. For mirrored origin fetch, it takes effect only after the file has been fetched from origin successfully.

### Formats and analysis

| Feature                                            | Key parameters | Description                                                                                              | Applies to |
| :------------------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------- | :--------: |
| [Image format conversion](/en/coreix/features/fmt) | `fmt`          | JPEG, PNG, WebP, AVIF, JPEG XL, HEIC, GIF, and more, or automatic selection                              |     All    |
| [Image analysis](/en/coreix/features/analysis)     | `fmt`          | Color palettes, perceptual hashes, face positions, content labels, aesthetic scores, and feature vectors |   Images   |
| [Supported formats](/en/formats)                   | –              | Recognized input formats and what each format supports                                                   |      –     |
