Struct ImageLoader 

pub struct ImageLoader {
    base_dir: Option<PathBuf>,
    cache: HashMap<String, ImageData>,
    allow_remote: bool,
}

Manages loading and caching of images for a document.

Provides automatic path resolution for relative paths and handles both local filesystem and remote HTTP(S) image loading.

Fields

base_dir: Option<PathBuf>

Base directory for resolving relative paths

cache: HashMap<String, ImageData>

Cache of loaded images to avoid redownloading

allow_remote: bool

Whether to enable remote image downloading

Implementations

impl ImageLoader

pub fn new(document_path: Option<&Path>) -> Self

Create a new image loader for a document at the specified path.

The base directory is extracted from the document path and used to resolve relative image references.

Arguments

• document_path - Path to the markdown document (optional)

Example

use markdown2pdf::images::ImageLoader;
use std::path::Path;

let loader = ImageLoader::new(Some(Path::new("./docs/document.md")));
// Images will be resolved relative to ./docs/

pub fn set_allow_remote(&mut self, allow: bool)

Enable or disable remote image downloading.

Example

use markdown2pdf::images::ImageLoader;
let mut loader = ImageLoader::new(None);
loader.set_allow_remote(false);
// Will not download images from URLs

pub fn resolve_path(&self, url_or_path: &str) -> Result<String, ImageError>

Resolve an image path relative to the document location.

For absolute URLs (http/https), returns the URL as-is. For relative paths, resolves them relative to the document directory.

Arguments

• url_or_path - Image URL or relative path

Returns

Either an absolute path string for local images or a full URL for remote images

Example

use markdown2pdf::images::ImageLoader;
use std::path::Path;

let loader = ImageLoader::new(Some(Path::new("./docs/document.md")));
// Relative path gets resolved
// loader.resolve_path("images/photo.jpg") -> "/full/path/to/docs/images/photo.jpg"
// HTTP URL stays as-is
// loader.resolve_path("https://example.com/image.jpg") -> "https://example.com/image.jpg"

pub fn load(&mut self, url_or_path: &str) -> Result<ImageData, ImageError>

Load an image from a URL or path.

Attempts to load from cache first, then from local filesystem or remote URL. Returns image data along with format information.

Arguments

• url_or_path - Image URL or relative path

Errors

Returns ImageError if loading fails or image format is unsupported.

fn load_local(&self, path: &str) -> Result<Vec<u8>, ImageError>

Load an image from the local filesystem.

Errors

Returns ImageError::LoadError if the file cannot be read.

fn load_remote(&self, url: &str) -> Result<Vec<u8>, ImageError>

Download an image from a remote URL.

Requires the fetch feature to be enabled.

Errors

Returns ImageError::DownloadError if the download fails.