#include <Image4.h>

Public Types
typedef Image4	Type

typedef shared_ptr< class Image4 >	Ref

Public Types inherited from G3D::Map2D< Color4, Color4 >
typedef Color4	StorageType

typedef Color4	ComputeType

typedef Map2D< Color4, Color4 >	Type

typedef shared_ptr< Map2D >	Ref

Public Member Functions
const class ImageFormat *	format () const

void	load (const std::string &filename)

void	save (const std::string &filename)

Public Member Functions inherited from G3D::Map2D< Color4, Color4 >
const Color4 &	fastGet (int x, int y) const

void	fastSet (int x, int y, const Color4 &v)

Color4	bicubic (float x, float y, WrapMode wrap) const

Color4	bicubic (float x, float y) const

Color4	bicubic (const Vector2 &p, WrapMode wrap) const

Color4	bicubic (const Vector2 &p) const

void	resize (uint32 newW, uint32 newH)

bool	changed ()

void	setChanged (bool c)

Color4 *	getCArray ()

const Color4 *	getCArray () const

Array< Color4 > &	getArray ()

const Array< Color4 > &	getArray () const

bool	inBounds (int x, int y) const

bool	inBounds (const Vector2int16 &v) const

const Color4 &	get (int x, int y, WrapMode wrap) const

const Color4 &	get (int x, int y) const

const Color4 &	get (const Vector2int16 &p) const

const Color4 &	get (const Vector2int16 &p, WrapMode wrap) const

Color4 &	get (int x, int y, WrapMode wrap)

Color4 &	get (int x, int y)

Color4 &	get (const Vector2int16 &p)

void	set (const Vector2int16 &p, const Color4 &v)

void	set (int x, int y, const Color4 &v, WrapMode wrap)

void	set (int x, int y, const Color4 &v)

void	set (const shared_ptr< Map2D< Color4, T > > &src)

void	setAll (const Color4 &v)

void	maybeFlipVertical (bool flip)

virtual void	flipVertical ()

virtual void	flipHorizontal ()

virtual void	crop (int newX, int newY, int newW, int newH)

virtual void	crop (const Rect2D &rect)

Color4	nearest (float x, float y, WrapMode wrap) const

Color4	nearest (float x, float y) const

Color4	nearest (const Vector2 &p) const

Color4	average () const

Color4	bilinear (float x, float y, WrapMode wrap) const

Color4	bilinear (float x, float y) const

Color4	bilinear (const Vector2 &p) const

Color4	bilinear (const Vector2 &p, WrapMode wrap) const

int32	width () const

int32	height () const

Vector2int16	size () const

Rect2D	rect2DBounds () const

size_t	sizeInMemory () const

WrapMode	wrapMode () const

void	setWrapMode (WrapMode m)

Public Member Functions inherited from G3D::ReferenceCountedObject
virtual	~ReferenceCountedObject ()

Static Public Member Functions
static Ref	createEmpty (int width, int height, WrapMode wrap=WrapMode::ERROR)

static Ref	createEmpty (WrapMode wrap=WrapMode::ERROR)

static Ref	fromFile (const std::string &filename, WrapMode wrap=WrapMode::ERROR)

static Ref	fromArray (const class Color1unorm8 *ptr, int width, int height, WrapMode wrap=WrapMode::ERROR)

static Ref	fromArray (const class Color3unorm8 *ptr, int width, int height, WrapMode wrap=WrapMode::ERROR)

static Ref	fromArray (const class Color4unorm8 *ptr, int width, int height, WrapMode wrap=WrapMode::ERROR)

static Ref	fromArray (const class Color1 *ptr, int width, int height, WrapMode wrap=WrapMode::ERROR)

static Ref	fromArray (const class Color3 *ptr, int width, int height, WrapMode wrap=WrapMode::ERROR)

static Ref	fromArray (const class Color4 *ptr, int width, int height, WrapMode wrap=WrapMode::ERROR)

static Ref	fromImage4unorm8 (const shared_ptr< class Image4unorm8 > &im)

Static Public Member Functions inherited from G3D::Map2D< Color4, Color4 >
static Ref	create (int w=0, int h=0, WrapMode wrap=WrapMode::ERROR)

Protected Member Functions
	Image4 (int w, int h, WrapMode wrap)

void	copyArray (const Color1 *src, int w, int h)

void	copyArray (const Color3 *src, int w, int h)

void	copyArray (const Color4 *src, int w, int h)

void	copyArray (const Color1unorm8 *src, int w, int h)

void	copyArray (const Color3unorm8 *src, int w, int h)

void	copyArray (const Color4unorm8 *src, int w, int h)

Protected Member Functions inherited from G3D::Map2D< Color4, Color4 >
const Color4 &	slowGet (int x, int y, WrapMode wrap)

Color4	bicubic (const Color4 *ctrl, double s) const

	Map2D (int w, int h, WrapMode wrap)

Additional Inherited Members
Public Attributes inherited from G3D::Map2D< Color4, Color4 >
GMutex	mutex

Protected Attributes inherited from G3D::Map2D< Color4, Color4 >
Color4	ZERO

uint32	w

uint32	h

WrapMode	_wrapMode

AtomicInt32	m_changed

Array< Color4 >	data

Detailed Description

RGBA image with 32-bit floating point storage for each channel.

Whenever a method needs to convert from RGB to RGBA, A=1 is assumed.

Bilinear interpolation on Image4 is about 8x faster than on Image4unorm8 due to the large cost of converting int->float on modern machines.

See also: G3D::Image4unorm8, G3D::GImage.

Member Typedef Documentation

typedef shared_ptr<class Image4> G3D::Image4::Ref

typedef Image4 G3D::Image4::Type

Constructor & Destructor Documentation

G3D::Image4::Image4	(	int	w,
		int	h,
		WrapMode	wrap
	)

protected

  : Map2D<Color4, Color4>(w, h, wrap) {
  setAll(Color4::zero());
 }

Here is the call graph for this function:

Member Function Documentation

void G3D::Image4::copyArray	(	const Color1 *	src,
		int	w,
		int	h
	)

protected

  {
  resize(w, h);
  int N = w * h;
 
  Color4* dst = getCArray();
  for (int i = 0; i < N; ++i) {
  dst[i].r = dst[i].g = dst[i].b = src[i].value;
  dst[i].a = 1.0f;
  }
 }

Here is the call graph for this function:

Here is the caller graph for this function:

void G3D::Image4::copyArray	(	const Color3 *	src,
		int	w,
		int	h
	)

protected

  {
  resize(w, h);
 
  int N = w * h;
  Color4* dst = data.getCArray();
  
  // Add alpha
  for (int i = 0; i < N; ++i) {
  dst[i] = Color4(src[i], 1.0f);
  }
 }

Here is the call graph for this function:

void G3D::Image4::copyArray	(	const Color4 *	src,
		int	w,
		int	h
	)

protected

  {
  resize(w, h);
  System::memcpy(getCArray(), src, w * h * sizeof(Color4));
 }

Here is the call graph for this function:

void G3D::Image4::copyArray	(	const Color1unorm8 *	src,
		int	w,
		int	h
	)

protected

  {
  resize(w, h);
  int N = w * h;
 
  Color4* dst = getCArray();
  for (int i = 0; i < N; ++i) {
  dst[i].r = dst[i].g = dst[i].b = Color1(src[i]).value;
  dst[i].a = 1.0f;
  }
 }

Here is the call graph for this function:

void G3D::Image4::copyArray	(	const Color3unorm8 *	src,
		int	w,
		int	h
	)

protected

  {
  resize(w, h);
 
  int N = w * h;
  Color4* dst = data.getCArray();
  
  // Add alpha and convert
  for (int i = 0; i < N; ++i) {
  dst[i] = Color4(Color3(src[i]), 1.0f);
  }
 }

Here is the call graph for this function:

void G3D::Image4::copyArray	(	const Color4unorm8 *	src,
		int	w,
		int	h
	)

protected

  {
  resize(w, h);
 
  int N = w * h;
  Color4* dst = data.getCArray();
  // Convert int8 -> float
  for (int i = 0; i < N; ++i) {
  dst[i] = Color4(src[i]);
  }
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::createEmpty	(	int	width,
		int	height,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

Creates an all-zero width x height image.

  {
  return shared_ptr<Image4>(new Type(width, height, wrap));
 }

Here is the caller graph for this function:

Image4::Ref G3D::Image4::createEmpty ( WrapMode wrap = WrapMode::ERROR )

static

Creates a 0 x 0 image.

  {
  return createEmpty(0, 0, wrap);
 }

Here is the call graph for this function:

const ImageFormat * G3D::Image4::format ( ) const

  {
  return ImageFormat::RGBA32F();
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromArray	(	const class Color1unorm8 *	ptr,
		int	width,
		int	height,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

  {
  Ref out = createEmpty(wrap);
  out->copyArray(ptr, w, h);
  return out;
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromArray	(	const class Color3unorm8 *	ptr,
		int	width,
		int	height,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

  {
  Ref out = createEmpty(wrap);
  out->copyArray(ptr, w, h);
  return out;
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromArray	(	const class Color4unorm8 *	ptr,
		int	width,
		int	height,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

  {
  Ref out = createEmpty(wrap);
  out->copyArray(ptr, w, h);
  return out;
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromArray	(	const class Color1 *	ptr,
		int	width,
		int	height,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

  {
  Ref out = createEmpty(wrap);
  out->copyArray(ptr, w, h);
  return out;
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromArray	(	const class Color3 *	ptr,
		int	width,
		int	height,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

  {
  Ref out = createEmpty(wrap);
  out->copyArray(ptr, w, h);
  return out;
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromArray	(	const class Color4 *	ptr,
		int	width,
		int	height,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

  {
  Ref out = createEmpty(wrap);
  out->copyArray(ptr, w, h);
  return out;
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromFile	(	const std::string &	filename,
		WrapMode	wrap = `WrapMode::ERROR`
	)

static

  {
  Ref out = createEmpty(wrap);
  out->load(filename);
  return out;
 }

Here is the call graph for this function:

Image4::Ref G3D::Image4::fromImage4unorm8 ( const shared_ptr< class Image4unorm8 > & im )

static

  {
  Ref out = createEmpty(static_cast<WrapMode>(im->wrapMode()));
  out->resize(im->width(), im->height());
 
  int N = im->width() * im->height();
  const Color4unorm8* src = reinterpret_cast<Color4unorm8*>(im->getCArray());
  for (int i = 0; i < N; ++i) {
  out->data[i] = Color4(src[i]);
  }
 
  return out;
 }

Here is the call graph for this function:

void G3D::Image4::load ( const std::string & filename )

Loads from any of the file formats supported by G3D::GImage.

  {
  shared_ptr<Image> image = Image::fromFile(filename);
  if (image->format() != ImageFormat::RGBA32F()) {
  image->convertToRGBA8();
  }
 
  switch (image->format()->code)
  {
  case ImageFormat::CODE_L8:
  copyArray(static_cast<const Color1unorm8*>(image->toPixelTransferBuffer()->buffer()), image->width(), image->height());
  break;
  case ImageFormat::CODE_L32F:
  copyArray(static_cast<const Color1*>(image->toPixelTransferBuffer()->buffer()), image->width(), image->height());
  break;
  case ImageFormat::CODE_RGB8:
  copyArray(static_cast<const Color3unorm8*>(image->toPixelTransferBuffer()->buffer()), image->width(), image->height());
  break;
  case ImageFormat::CODE_RGB32F:
  copyArray(static_cast<const Color3*>(image->toPixelTransferBuffer()->buffer()), image->width(), image->height());
  break;
  case ImageFormat::CODE_RGBA8:
  copyArray(static_cast<const Color4unorm8*>(image->toPixelTransferBuffer()->buffer()), image->width(), image->height());
  break;
  case ImageFormat::CODE_RGBA32F:
  copyArray(static_cast<const Color4*>(image->toPixelTransferBuffer()->buffer()), image->width(), image->height());
  break;
  default:
  debugAssertM(false, "Trying to load unsupported image format");
  break;
  }
 
  setChanged(true);
 }

Here is the call graph for this function:

void G3D::Image4::save ( const std::string & filename )

Saves in any of the formats supported by G3D::GImage.

  {
  // To avoid saving as floating point image. FreeImage cannot convert floating point to RGBA8.
  Image4unorm8::Ref unorm8 = Image4unorm8::fromImage4(dynamic_pointer_cast<Image4>(shared_from_this()));
  unorm8->save(filename);
 }

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

dep/g3dlite/include/G3D/Image4.h
dep/g3dlite/source/Image4.cpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation