donner::svg::UrlLoader Class Reference

Utility class for loading a URI or decoding a data URL. More...

#include "donner/svg/resources/UrlLoader.h"

Classes
struct	Result
	Result of loading a URI or decoding a data URL. More...

Public Member Functions
	UrlLoader (ResourceLoaderInterface &resourceLoader, size_t maximumResourceSize=kDefaultMaximumResourceSize, size_t *remainingResourceBytes=nullptr)
	Create a new URL loader that uses the given resource loader to fetch external resources.
	~UrlLoader ()=default
	Destructor.
	UrlLoader (const UrlLoader &)=delete
	UrlLoader (UrlLoader &&)=delete
UrlLoader &	operator= (const UrlLoader &)=delete
UrlLoader &	operator= (UrlLoader &&)=delete
std::variant< Result, UrlLoaderError >	fromUri (std::string_view uri)
	Read an image from a URI, which can be a file path, a URL, or a data URL (e.g.

Static Public Member Functions
static std::optional< UrlLoaderError >	validateExternalUriRepresentation (std::string_view uri)
	Validate an external URI before any copy, hash, cache lookup, or callback.

Static Public Attributes
static constexpr size_t	kDefaultMaximumResourceSize = 16 * 1024 * 1024
	Default maximum decoded or fetched resource size.
static constexpr size_t	kMaximumExternalUriSize = 4096
	Maximum external URI bytes accepted before copying, hashing, or invoking a callback.

Detailed Description

Utility class for loading a URI or decoding a data URL.

---

Class Documentation

donner::svg::UrlLoader::Result

struct donner::svg::UrlLoader::Result

Result of loading a URI or decoding a data URL.

Class Members
vector< uint8_t >	data	Loaded data, either from a data URL or from a fetched URI.
string	mimeType	MIME type of the data, if known. Otherwise, an empty string.

Constructor & Destructor Documentation

UrlLoader()

donner::svg::UrlLoader::UrlLoader ( ResourceLoaderInterface & resourceLoader, size_t maximumResourceSize = kDefaultMaximumResourceSize, size_t * remainingResourceBytes = nullptr )

inlineexplicit

Create a new URL loader that uses the given resource loader to fetch external resources.

Parameters

resourceLoader	Resource loader to use for fetching external resources.
maximumResourceSize	Maximum bytes accepted from one loaded resource.
remainingResourceBytes	Optional shared byte budget, decremented on load.

Member Function Documentation

fromUri()

std::variant< Result, UrlLoaderError > donner::svg::UrlLoader::fromUri

(

std::string_view

uri

)

Read an image from a URI, which can be a file path, a URL, or a data URL (e.g.

"data:image/png;base64,...").

Parameters

uri	URI of the image, or data URL containing a base64 embedded image.

Returns

Loaded image data or an error code.

---

The documentation for this class was generated from the following file:

• donner/svg/resources/UrlLoader.h