TLIB documentation
 

tlMemory.h File Reference

---

Detailed Description

Internal memory allocation routines.

#include "tlVision.h"

Include dependency graph for tlMemory.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
tlPixel *	tl_create_array (int width, int height, int pixel_width)
tlPixel *	tl_copy_array (tlPixel *src, int width, int height, int pixel_width)
tlPixel *	tl_copy_array (tlPixel *src, int width, int height, int pixel_width, tlRect *rect)
tlPixel *	tl_copy_subarray (tlPixel *src, int width, int height, int pixel_width, tlRect *subRect)
tlHRPixel *	tl_create_hrarray (int width, int height, int pixel_width)
tlHRPixel *	tl_copy_hrarray (tlHRPixel *src, int width, int height, int pixel_width)
tlHRPixel *	tl_copy_hrarray (tlHRPixel *src, int width, int height, int pixel_width, tlRect *rect)
tlHRPixel *	tl_copy_hrsubarray (tlHRPixel *src, int width, int height, int pixel_width, tlRect *subRect)

---

Function Documentation

tlPixel* tl_copy_array	(	tlPixel *	src,
		int	width,
		int	height,
		int	pixel_width,
		tlRect *	rect
	)

Create a copy of a portion of a given array containing an image; new (copied) array has the same size as the original.

Parameters:

	src	source array
	width	image width [pix]
	height	image height [pix]
	pixel_width	byte per pixel
	rect	portion of the image to copy

Returns:

A pointer to the new (copied) array, NULL if allocation failed.

Note:

for optimization reasons, no verification of the validity of the input array is made; in case an invalid pointer is passed, results are impredictable.

tlPixel* tl_copy_array	(	tlPixel *	src,
		int	width,
		int	height,
		int	pixel_width
	)

Create a copy of a given array containing an image.

Parameters:

	src	source array
	width	image width [pix]
	height	image height [pix]
	pixel_width	byte per pixel

Returns:

A pointer to the new (copied) array, NULL if allocation failed.

Note:

for optimization reasons, no verification of the validity of the input array is made; in case an invalid pointer is passed, results are impredictable.

tlHRPixel* tl_copy_hrarray	(	tlHRPixel *	src,
		int	width,
		int	height,
		int	pixel_width,
		tlRect *	rect
	)

Create a copy of a portion of a given high-resolution array containing an image; new (copied) array has the same size as the original.

Parameters:

	src	source array
	width	image width [pix]
	height	image height [pix]
	pixel_width	channels per pixel
	rect	portion of the image to copy

Returns:

A pointer to the new (copied) array, NULL if allocation failed.

Note:

for optimization reasons, no verification of the validity of the input array is made; in case an invalid pointer is passed, results are impredictable.

tlHRPixel* tl_copy_hrarray	(	tlHRPixel *	src,
		int	width,
		int	height,
		int	pixel_width
	)

Create a copy of a given high-resolution array containing an image.

Parameters:

	src	source array
	width	image width [pix]
	height	image height [pix]
	pixel_width	channel per pixel

Returns:

A pointer to the new (copied) array, NULL if allocation failed.

Note:

for optimization reasons, no verification of the validity of the input array is made; in case an invalid pointer is passed, results are impredictable.

tlHRPixel* tl_copy_hrsubarray	(	tlHRPixel *	src,
		int	width,
		int	height,
		int	pixel_width,
		tlRect *	rect
	)

Create a copy of a portion of a given high-resolution array containing an image; new (copied) array has the same size as the portion of the image to duplicate.

Parameters:

	src	source array
	width	image width [pix]
	height	image height [pix]
	pixel_width	byte per pixel
	rect	portion of the image to copy

Returns:

A pointer to the new (copied) array, NULL if allocation failed.

Note:

for optimization reasons, no verification of the validity of the input array is made; in case an invalid pointer is passed, results are impredictable.

tlPixel* tl_copy_subarray	(	tlPixel *	src,
		int	width,
		int	height,
		int	pixel_width,
		tlRect *	rect
	)

Create a copy of a portion of a given array containing an image; new (copied) array has the same size as the portion of the image to duplicate.

Parameters:

	src	source array
	width	image width [pix]
	height	image height [pix]
	pixel_width	byte per pixel
	rect	portion of the image to copy

Returns:

A pointer to the new (copied) array, NULL if allocation failed.

Note:

for optimization reasons, no verification of the validity of the input array is made; in case an invalid pointer is passed, results are impredictable.

tlPixel* tl_create_array	(	int	width,
		int	height,
		int	pixel_width
	)

Allocate a new pixel array.

Parameters:

	width	image width [pix]
	height	image height [pix]
	pixel_width	byte per pixel

Returns:

A pointer to the new array, NULL if allocation failed.

tlHRPixel* tl_create_hrarray	(	int	width,
		int	height,
		int	pixel_width
	)

Allocate a new high-resolution pixel array.

Parameters:

	width	image width [pix]
	height	image height [pix]
	pixel_width	byte per pixel

Returns:

A pointer to the new array, NULL if allocation failed.

---

TLIB documentation - generated on 7 May 2008
Please address any questions to seb@tuyphon.com
(C) 2001-2008 - S. Grange
(C) 2001-2007 - VRAI Group, EPFL
All Rights Reserved.