Manages the ImageSerializer repository and the named images. More...

#include <geogram/image/image_library.h>

Inheritance diagram for GEO::ImageLibrary:

Public Member Functions
bool	bind_image_serializer (const std::string &extension, ImageSerializer *serializer)
	Binds an ImageSerializer.

ImageSerializer *	resolve_image_serializer (const std::string &extension) const
	Finds an ImageSerializer by extension.

bool	bind_image (const std::string &name, Image *image)
	Binds an image with a name.

bool	unbind_image (const std::string &name)
	Unbinds a named image.

Image *	resolve_image (const std::string &name) const
	Finds an image by name.

Image *	load_image (const std::string &file_name)
	Loads an image from a file.

bool	save_image (const std::string &file_name, Image *image)
	Saves an image into a file.

void	copy_image_to_clipboard (Image *image)
	Copies an image to the clipboard of the operating system.

bool	get_local_value (const std::string &name, std::string &value) const override
	Retrieves a variable value locally.

bool	set_local_value (const std::string &name, const std::string &value) override
	Sets a variable value locally.

Public Member Functions inherited from GEO::Environment
virtual bool	add_environment (Environment *env)
	Adds a child environment.

bool	has_value (const std::string &name) const
	Tests if a variable exists.

virtual bool	get_value (const std::string &name, std::string &value) const
	Retrieves the value of a variable.

std::string	get_value (const std::string &name) const
	Retrieves the value of a variable.

virtual bool	set_value (const std::string &name, const std::string &value)
	Sets a variable value.

virtual Environment *	find_environment (const std::string &name)
	Finds the environment that declares a variable as a local name.

virtual bool	add_observer (const std::string &name, VariableObserver *observer)
	Attaches an observer to a variable.

virtual bool	remove_observer (const std::string &name, VariableObserver *observer)
	Detaches an observer from a variable.

virtual bool	notify_observers (const std::string &name, bool recursive=false)
	Notifies observers.

Public Member Functions inherited from GEO::Counted
void	ref () const
	Increments the reference count.

void	unref () const
	Decrements the reference count.

bool	is_shared () const
	Check if the object is shared.

int	nb_refs () const
	Gets the number of references that point to this object.

Static Public Member Functions
static ImageLibrary *	instance ()
	Gets the instance.

static void	initialize ()
	Initializes the ImageLibrary instance.

static void	terminate ()
	Terminates the ImageLibrary instance.

Static Public Member Functions inherited from GEO::Environment
static Environment *	instance ()
	Gets the root environment.

static void	terminate ()
	Cleans up the environment.

Static Public Member Functions inherited from GEO::Counted
static void	ref (const Counted *counted)
	Increments the reference count.

static void	unref (const Counted *counted)
	Decrements the reference count.

Friends
class	World

Additional Inherited Members
Protected Member Functions inherited from GEO::Environment
	~Environment () override
	Environment destructor.

bool	notify_observers (const std::string &name, const std::string &value, bool recursive)
	Notifies observers.

bool	notify_local_observers (const std::string &name, const std::string &value)
	Notifies local observers.

Protected Member Functions inherited from GEO::Counted
	Counted ()
	Creates a reference counted object.

virtual	~Counted ()
	Destroys a reference counted object.

Detailed Description

Manages the ImageSerializer repository and the named images.

Definition at line 68 of file image_library.h.

Member Function Documentation

◆ bind_image()

bool GEO::ImageLibrary::bind_image	(	const std::string &	name,
		Image *	image
	)

Binds an image with a name.

Parameters

[in]	name	the name of the image
[in]	image	a pointer to the image to be bound. Ownership is transferred to this ImageLibrary.

Return values

true	if the Image could be successfully bound
false	otherwise, i.e. if there was already an Image bound with the same name

◆ bind_image_serializer()

bool GEO::ImageLibrary::bind_image_serializer	(	const std::string &	extension,
		ImageSerializer *	serializer
	)

Binds an ImageSerializer.

Parameters

[in]	extension	the file extension without the "."
[in]	serializer	a pointer to an ImageSerializer. Ownership is transferred to this ImageLibrary

Return values

true	if the ImageSerializer could be successfully bound
false	otherwise (i.e. if there was already a serializer with the same name).

◆ copy_image_to_clipboard()

void GEO::ImageLibrary::copy_image_to_clipboard ( Image * image )

Copies an image to the clipboard of the operating system.

Parameters

[in] image the image to be copied to the clipboard.

Note: Only implemented under Windows

◆ get_local_value()

bool GEO::ImageLibrary::get_local_value	(	const std::string &	name,
		std::string &	value
	)		const

overridevirtual

Retrieves a variable value locally.

This function is used internally. It searches variable name locally and stores its value in the output string value.

Parameters

[in]	name	the name of the variable
[out]	value	is set the variable value if it was found locally.

Return values

true	if the variable was found
false	if not

Note: This function must be reimplemented in derived custom environments.

Provides the following environment variables:

image_read_extensions
image_write_extensions

Implements GEO::Environment.

◆ initialize()

static void GEO::ImageLibrary::initialize ( )

static

Initializes the ImageLibrary instance.

This function is automatically called during Geogram startup. It should not be called by client code.

◆ instance()

static ImageLibrary * GEO::ImageLibrary::instance ( )

static

Gets the instance.

Returns: a pointer to the unique instance of ImageLibrary.

◆ load_image()

Image * GEO::ImageLibrary::load_image ( const std::string & file_name )

Loads an image from a file.

Parameters

[in] file_name the name of the file that contains the image

Returns: a pointer to the loaded image, or nil if the image could not be loaded.

Note: The returned pointer can be stored in an Image_var

◆ resolve_image()

Image * GEO::ImageLibrary::resolve_image ( const std::string & name ) const

Finds an image by name.

Parameters

[in] name the name of the image

Returns: a pointer to the image, or nil if no image is bound to the name

See also: bind_image(), unbind_image()

◆ resolve_image_serializer()

ImageSerializer * GEO::ImageLibrary::resolve_image_serializer ( const std::string & extension ) const

Finds an ImageSerializer by extension.

Parameters

[in] extension the file extension without the "."

Returns: a pointer to the ImageSerializer that can serialize images in the file format that corresponds to the extension, or nil if no such ImageSerializer was found

◆ save_image()

bool GEO::ImageLibrary::save_image	(	const std::string &	file_name,
		Image *	image
	)

Saves an image into a file.

Parameters

[in]	file_name	the name of the file that will receive the image
[in]	image	a pointer to the Image to be saved

Return values

true	if the image could be successfully saved
false	otherwise

◆ set_local_value()

bool GEO::ImageLibrary::set_local_value	(	const std::string &	name,
		const std::string &	value
	)

overridevirtual

Sets a variable value locally.

This function is used internally. It sets the variable named name to the given value locally.

Parameters

[in]	name	the name of the variable
[in]	value	the value of the variable

Return values

true	if the variable was successfully added locally
false	otherwise

Note: This function must be reimplemented in derived custom environments.

Implements GEO::Environment.

◆ terminate()

static void GEO::ImageLibrary::terminate ( )

static

Terminates the ImageLibrary instance.

This function is automatically called during Geogram shutdown. It should not be called by client code.

◆ unbind_image()

bool GEO::ImageLibrary::unbind_image ( const std::string & name )

Unbinds a named image.

Parameters

[in] name the name of the image

Return values

true	if the Image could be successfully unbound
false	otherwise, i.e. if there was no Image bound with the specified name

Friends And Related Symbol Documentation

◆ World

friend class World

friend

Definition at line 192 of file image_library.h.

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

geogram/image/image_library.h

Public Member Functions

Static Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ bind_image()

◆ bind_image_serializer()

◆ copy_image_to_clipboard()

◆ get_local_value()

◆ initialize()

◆ instance()

◆ load_image()

◆ resolve_image()

◆ resolve_image_serializer()

◆ save_image()

◆ set_local_value()

◆ terminate()

◆ unbind_image()

Friends And Related Symbol Documentation

◆ World