# Si Crate - Simple Image Manipulation in Rust
The Si crate (pronounced "ess-eye") is a lightweight and easy-to-use Rust library to create Social Share Images (the website previews you see, for example).
See the examples in `examples` to get started.
> **Note**: The examples require the `image` crate (`si` is based on that) for PNG Encoding. Unless you need to save images in disk (for which you will need to encode the bytes), you don't really need that.
## Installation
To use the Si crate in your Rust project, add it as a dependency in your `Cargo.toml` file:
```toml
[dependencies]
si-img = "0.3.1"
```
## Getting Started
To start using the Si crate, import the necessary modules:
```rust
use si_img::{SiImage, SiFont};
```
## Creating a Font
You can create a custom font using the `SiFont::from_network` constructor. You need to provide a font URL. Here's an example:
```rust
let font = SiFont::from_network("FONT_URL"); // Synchronously (blocking, use SiFont::from_network_async for async fetching)
```
## Creating an Image
Next, create an image using the `SiImage::from_network` constructor. You'll need to provide an image URL:
```rust
let img = SiImage::from_network("Image_URL"); // Synchronously (blocking, use SiImage::from_network_async for async fetching)
```
## Adding Text to the Image
Now, you can add text to the image using the `text` method. Specify the text, scale, x and y coordinates, an optional color (or use `None` for the default color), and the font you created earlier:
```rust
img.text("Hello Cool User", 48.00, 32.0, 20.0, Some("#00ffff".to_string()), &font);
```
## Getting Image Bytes
Finally, you can retrieve the (decoded) image as bytes using the `to_bytes` method:
```rust
let bytes = img.to_bytes();
```
## Example
Here's a complete example that puts it all together:
```rust
use si_img::{SiImage, SiFont};
fn main() {
// Create a font
let font = SiFont::from_network("FONT_URL");
// Create an image
let img = SiImage::from_network("Image_URL");
// Add text to the image
img.text("Hello Cool User", 48.00, 32.0, 20.0, Some("#00ffff".to_string()), &font);
// Get image bytes
let bytes = img.to_bytes();
// Do something with the image bytes (e.g., save to a file or send over a network)
}
```
That's it! You now have the basics to start using the Si crate for simple image manipulation in your Rust projects. Feel free to explore more features and customization options provided by the crate as you build your image processing applications.
> **Note**: This Crate serves as the base for the WebAssembly-based `Si.js` library (for Node.js and Deno).