documentation.HELP! SFML v1.6 Documentation

SFML - Simple and Fast Multimedia Library

SFML v1.6

previous page next page

sf::Image Class Reference

Image is the low-level class for loading and manipulating images. More...

#include <Image.hpp>

Inheritance diagram for sf::Image:

List of all members.

Public Member Functions
	Image ()
	Default constructor.
	Image (const Image &Copy)
	Copy constructor.
	Image (unsigned int Width, unsigned int Height, const Color &Col=Color(0, 0, 0, 255))
	Construct an empty image.
	Image (unsigned int Width, unsigned int Height, const Uint8 *Data)
	Construct the image from pixels in memory.
	~Image ()
	Destructor.
bool	LoadFromFile (const std::string &Filename)
	Load the image from a file.
bool	LoadFromMemory (const char *Data, std::size_t SizeInBytes)
	Load the image from a file in memory.
bool	LoadFromPixels (unsigned int Width, unsigned int Height, const Uint8 *Data)
	Load the image directly from an array of pixels.
bool	SaveToFile (const std::string &Filename) const
	Save the content of the image to a file.
bool	Create (unsigned int Width, unsigned int Height, Color Col=Color(0, 0, 0, 255))
	Create an empty image.
void	CreateMaskFromColor (Color ColorKey, Uint8 Alpha=0)
	Create transparency mask from a specified colorkey.
void	Copy (const Image &Source, unsigned int DestX, unsigned int DestY, const IntRect &SourceRect=IntRect(0, 0, 0, 0), bool ApplyAlpha=false)
	Copy pixels from another image onto this one.
bool	CopyScreen (RenderWindow &Window, const IntRect &SourceRect=IntRect(0, 0, 0, 0))
	Create the image from the current contents of the given window.
void	SetPixel (unsigned int X, unsigned int Y, const Color &Col)
	Change the color of a pixel.
const Color &	GetPixel (unsigned int X, unsigned int Y) const
	Get a pixel from the image.
const Uint8 *	GetPixelsPtr () const
	Get a read-only pointer to the array of pixels (RGBA 8 bits integers components) Array size is GetWidth() x GetHeight() x 4 This pointer becomes invalid if you reload or resize the image.
void	Bind () const
	Bind the image for rendering.
void	SetSmooth (bool Smooth)
	Enable or disable image smooth filter.
unsigned int	GetWidth () const
	Return the width of the image.
unsigned int	GetHeight () const
	Return the height of the image.
bool	IsSmooth () const
	Tells whether the smooth filtering is enabled or not.
FloatRect	GetTexCoords (const IntRect &Rect) const
	Convert a subrect expressed in pixels, into float texture coordinates.
Image &	operator= (const Image &Other)
	Assignment operator.
Static Public Member Functions
static unsigned int	GetValidTextureSize (unsigned int Size)
	Get a valid texture size according to hardware support.

---

Detailed Description

Image is the low-level class for loading and manipulating images.

Definition at line 46 of file Image.hpp.

---

Constructor & Destructor Documentation

sf::Image::Image

(

)

Default constructor.

Definition at line 43 of file Image.cpp.

sf::Image::Image

(

const Image &

Copy

)

Copy constructor.

Parameters:

Copy

: instance to copy

Definition at line 60 of file Image.cpp.

sf::Image::Image	(	unsigned int	Width,
		unsigned int	Height,
		const Color &	Col = Color(0, 0, 0, 255)
	)

Construct an empty image.

Parameters:

	Width	: Image width
	Height	: Image height
	Col	: Image color (black by default)

Definition at line 79 of file Image.cpp.

sf::Image::Image	(	unsigned int	Width,
		unsigned int	Height,
		const Uint8 *	Data
	)

Construct the image from pixels in memory.

Parameters:

	Width	: Image width
	Height	: Image height
	Data	: Pointer to the pixels in memory (assumed format is RGBA)

Definition at line 96 of file Image.cpp.

sf::Image::~Image

(

)

Destructor.

Definition at line 113 of file Image.cpp.

---

Member Function Documentation

void sf::Image::Bind

(

)

const

Bind the image for rendering.

Definition at line 473 of file Image.cpp.

void sf::Image::Copy	(	const Image &	Source,
		unsigned int	DestX,
		unsigned int	DestY,
		const IntRect &	SourceRect = IntRect(0, 0, 0, 0),
		bool	ApplyAlpha = false
	)

Copy pixels from another image onto this one.

This function does a slow pixel copy and should only be used at initialization time

Parameters:

	Source	: Source image to copy
	DestX	: X coordinate of the destination position
	DestY	: Y coordinate of the destination position
	SourceRect	: Sub-rectangle of the source image to copy (empty by default - entire image)
	ApplyAlpha	: Should the copy take in account the source transparency? (false by default)

This function does a slow pixel copy and should only be used at initialization time

Definition at line 270 of file Image.cpp.

bool sf::Image::CopyScreen	(	RenderWindow &	Window,
		const IntRect &	SourceRect = IntRect(0, 0, 0, 0)
	)

Create the image from the current contents of the given window.

Create the image from the current contents of the given window.

Parameters:

	Window	: Window to capture
	SourceRect	: Sub-rectangle of the screen to copy (empty by default - entire image)

Returns:

True if copy was successful

Definition at line 358 of file Image.cpp.

bool sf::Image::Create	(	unsigned int	Width,
		unsigned int	Height,
		Color	Col = Color(0, 0, 0, 255)
	)

Create an empty image.

Parameters:

	Width	: Image width
	Height	: Image height
	Col	: Image color (black by default)

Returns:

True if creation was successful

Definition at line 222 of file Image.cpp.

void sf::Image::CreateMaskFromColor	(	Color	ColorKey,
		Uint8	Alpha = 0
	)

Create transparency mask from a specified colorkey.

Parameters:

	ColorKey	: Color to become transparent
	Alpha	: Alpha value to use for transparent pixels (0 by default)

Definition at line 249 of file Image.cpp.

unsigned int sf::Image::GetHeight

(

)

const

Return the height of the image.

Returns:

Height in pixels

Definition at line 526 of file Image.cpp.

const Color & sf::Image::GetPixel	(	unsigned int	X,
		unsigned int	Y
	)			const

Get a pixel from the image.

Parameters:

	X	: X coordinate of pixel in the image
	Y	: Y coordinate of pixel in the image

Returns:

Color of pixel (X, Y)

Definition at line 431 of file Image.cpp.

const Uint8 * sf::Image::GetPixelsPtr

(

)

const

Get a read-only pointer to the array of pixels (RGBA 8 bits integers components) Array size is GetWidth() x GetHeight() x 4 This pointer becomes invalid if you reload or resize the image.

Get a read-only pointer to the array of pixels (RGBA 8 bits integers components) Array size is GetWidth() x GetHeight() x 4 This pointer becomes invalid if you reload or resize the image.

Returns:

Const pointer to the array of pixels

Definition at line 453 of file Image.cpp.

FloatRect sf::Image::GetTexCoords

(

const IntRect &

Rect

)

const

Convert a subrect expressed in pixels, into float texture coordinates.

Convert a subrect expressed in pixels, into float texture coordinates.

Parameters:

Rect

: Sub-rectangle of image to convert

Returns:

Texture coordinates corresponding to the sub-rectangle

Definition at line 545 of file Image.cpp.

unsigned int sf::Image::GetValidTextureSize

(

unsigned int

Size

)

[static]

Get a valid texture size according to hardware support.

Parameters:

Size

: Size to convert

Returns:

Valid nearest size (greater than or equal to specified size)

Definition at line 560 of file Image.cpp.

unsigned int sf::Image::GetWidth

(

)

const

Return the width of the image.

Returns:

Width in pixels

Definition at line 517 of file Image.cpp.

bool sf::Image::IsSmooth

(

)

const

Tells whether the smooth filtering is enabled or not.

Returns:

True if image smoothing is enabled

Definition at line 535 of file Image.cpp.

bool sf::Image::LoadFromFile

(

const std::string &

Filename

)

Load the image from a file.

Parameters:

Filename

: Path of the image file to load

Returns:

True if loading was successful

Definition at line 123 of file Image.cpp.

bool sf::Image::LoadFromMemory	(	const char *	Data,
		std::size_t	SizeInBytes
	)

Load the image from a file in memory.

Parameters:

	Data	: Pointer to the file data in memory
	SizeInBytes	: Size of the data to load, in bytes

Returns:

True if loading was successful

Definition at line 145 of file Image.cpp.

bool sf::Image::LoadFromPixels	(	unsigned int	Width,
		unsigned int	Height,
		const Uint8 *	Data
	)

Load the image directly from an array of pixels.

Parameters:

	Width	: Image width
	Height	: Image height
	Data	: Pointer to the pixels in memory (assumed format is RGBA)

Returns:

True if loading was successful

Definition at line 174 of file Image.cpp.

Image & sf::Image::operator=

(

const Image &

Other

)

Assignment operator.

Parameters:

Other

: instance to assign

Returns:

Reference to the image

Definition at line 585 of file Image.cpp.

bool sf::Image::SaveToFile

(

const std::string &

Filename

)

const

Save the content of the image to a file.

Parameters:

Filename

: Path of the file to save (overwritten if already exist)

Returns:

True if saving was successful

Definition at line 209 of file Image.cpp.

void sf::Image::SetPixel	(	unsigned int	X,
		unsigned int	Y,
		const Color &	Col
	)

Change the color of a pixel.

Parameters:

	X	: X coordinate of pixel in the image
	Y	: Y coordinate of pixel in the image
	Col	: New color for pixel (X, Y)

Definition at line 408 of file Image.cpp.

void sf::Image::SetSmooth

(

bool

Smooth

)

Enable or disable image smooth filter.

Enable or disable image smoothing filter.

This parameter is enabled by default

Parameters:

Smooth

: True to enable smoothing filter, false to disable it

Definition at line 490 of file Image.cpp.

---

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

• Image.hpp
• Image.cpp

 ::  Copyright © 2007-2008 Laurent Gomila, all rights reserved  ::  Documentation generated by doxygen 1.5.2  :: 

previous page start next page

Menu

• Homepage

Table of contents

• Main Page
• Class List
  • sf::AudioResource
  • sf::Clock
  • sf::Color
  • sf::Context
  • sf::Drawable
  • sf::Event
  • sf::Event::Event::JoyButtonEvent
  • sf::Event::Event::JoyMoveEvent
  • sf::Event::Event::KeyEvent
  • sf::Event::Event::MouseButtonEvent
  • sf::Event::Event::MouseMoveEvent
  • sf::Event::Event::MouseWheelEvent
  • sf::Event::Event::SizeEvent
  • sf::Event::Event::TextEvent
  • sf::Font
  • sf::Ftp
  • sf::Ftp::Ftp::DirectoryResponse
  • sf::Ftp::Ftp::ListingResponse
  • sf::Ftp::Ftp::Response
  • sf::Glyph
  • sf::Http
  • sf::Http::Http::Request
  • sf::Http::Http::Response
  • sf::Image
  • sf::Input
  • sf::IPAddress
  • sf::Listener
  • sf::Lock
  • sf::Matrix3
  • sf::Music
  • sf::Mutex
  • sf::NonCopyable
  • sf::Packet
  • sf::PostFX
  • sf::Randomizer
  • sf::Rect< T >
  • sf::RenderTarget
  • sf::RenderWindow
  • sf::Resource< T >
  • sf::ResourcePtr< T >
  • sf::Selector< Type >
  • sf::SelectorBase
  • sf::Shape
  • sf::SocketHelper
  • sf::SocketTCP
  • sf::SocketUDP
  • sf::Sound
  • sf::SoundBuffer
  • sf::SoundBufferRecorder
  • sf::SoundRecorder
  • sf::SoundStream
  • sf::SoundStream::SoundStream::Chunk
  • sf::Sprite
  • sf::String
  • sf::Thread
  • sf::Unicode
  • sf::Unicode::Unicode::Text
  • sf::Vector2< T >
  • sf::Vector3< T >
  • sf::VideoMode
  • sf::View
  • sf::Window
  • sf::WindowListener
  • sf::WindowSettings
• Class Hierarchy
  • sf::AudioResource
    • sf::Sound
      • sf::SoundStream
        • sf::Music
    • sf::SoundBuffer
  • sf::Clock
  • sf::Color
  • sf::Drawable
    • sf::PostFX
    • sf::Shape
    • sf::Sprite
    • sf::String
  • sf::Event
  • sf::Event::Event::JoyButtonEvent
  • sf::Event::Event::JoyMoveEvent
  • sf::Event::Event::KeyEvent
  • sf::Event::Event::MouseButtonEvent
  • sf::Event::Event::MouseMoveEvent
  • sf::Event::Event::MouseWheelEvent
  • sf::Event::Event::SizeEvent
  • sf::Event::Event::TextEvent
  • sf::Ftp::Ftp::Response
    • sf::Ftp::Ftp::DirectoryResponse
    • sf::Ftp::Ftp::ListingResponse
  • sf::Glyph
  • sf::Http::Http::Request
  • sf::Http::Http::Response
  • sf::IPAddress
  • sf::Listener
  • sf::Matrix3
  • sf::NonCopyable
    • sf::Context
    • sf::Ftp
    • sf::Http
    • sf::Input
    • sf::Lock
    • sf::Mutex
    • sf::Thread
      • sf::SoundRecorder
        • sf::SoundBufferRecorder
      • sf::SoundStream
    • sf::Window
      • sf::RenderWindow
  • sf::Packet
  • sf::Randomizer
  • sf::Rect< T >
  • sf::RenderTarget
    • sf::RenderWindow
  • sf::Resource< T >
  • sf::Resource< Font >
    • sf::Font
  • sf::Resource< Image >
    • sf::Image
  • sf::Resource< SoundBuffer >
    • sf::SoundBuffer
  • sf::ResourcePtr< T >
  • sf::SelectorBase
    • sf::Selector< Type >
  • sf::SocketHelper
  • sf::SocketTCP
  • sf::SocketUDP
  • sf::SoundStream::SoundStream::Chunk
  • sf::Unicode
  • sf::Unicode::Unicode::Text
  • sf::Vector2< T >
  • sf::Vector3< T >
  • sf::VideoMode
  • sf::View
  • sf::WindowListener
    • sf::Input
    • sf::Window
  • sf::WindowSettings
• Class Members
• Namespace List
  • sf::Blend
  • sf::Joy
  • sf::Key
  • sf::Mouse
  • sf::Style
• Namespace Members
• File List
  • Arial.hpp
  • Audio.hpp
  • AudioDevice.cpp
  • AudioDevice.hpp
  • AudioResource.cpp
  • AudioResource.hpp
  • Clock.cpp
  • Clock.hpp
  • Color.cpp
  • Color.hpp
  • Config.hpp
  • Context.cpp
  • Context.hpp
  • Doxygen.hpp
  • Drawable.cpp
  • Drawable.hpp
  • Event.hpp
  • Font.cpp
  • Font.hpp
  • FontLoader.cpp
  • FontLoader.hpp
  • Ftp.cpp
  • Ftp.hpp
  • Glyph.hpp
  • Graphics.hpp
  • GraphicsContext.cpp
  • GraphicsContext.hpp
  • Http.cpp
  • Http.hpp
  • Image.cpp
  • Image.hpp
  • ImageLoader.cpp
  • ImageLoader.hpp
  • Input.cpp
  • Input.hpp
  • IPAddress.cpp
  • IPAddress.hpp
  • Cocoa/Joystick.cpp
  • Template for new ports/Joystick.cpp
  • Win32/Joystick.cpp
  • Cocoa/Joystick.hpp
  • Joystick.hpp
  • Template for new ports/Joystick.hpp
  • Win32/Joystick.hpp
  • Listener.cpp
  • Listener.hpp
  • Lock.cpp
  • Lock.hpp
  • Matrix3.cpp
  • Matrix3.hpp
  • Matrix3.inl
  • Music.cpp
  • Music.hpp
  • Mutex.cpp
  • Mutex.hpp
  • Win32/Mutex.hpp
  • Network.hpp
  • NonCopyable.hpp
  • OpenAL.hpp
  • OpenGL.hpp
  • Packet.cpp
  • Packet.hpp
  • Platform.cpp
  • Platform.hpp
  • Win32/Platform.hpp
  • PostFX.cpp
  • PostFX.hpp
  • Randomizer.cpp
  • Randomizer.hpp
  • Rect.hpp
  • Rect.inl
  • RenderTarget.cpp
  • RenderTarget.hpp
  • RenderWindow.cpp
  • RenderWindow.hpp
  • Resource.hpp
  • Resource.inl
  • ResourcePtr.inl
  • Selector.hpp
  • Selector.inl
  • SelectorBase.cpp
  • SelectorBase.hpp
  • SFML_Main.cpp
  • Shape.cpp
  • Shape.hpp
  • Sleep.cpp
  • Sleep.hpp
  • SocketHelper.cpp
  • SocketHelper.hpp
  • Win32/SocketHelper.hpp
  • Sockets.hpp
  • SocketTCP.cpp
  • SocketTCP.hpp
  • SocketUDP.cpp
  • SocketUDP.hpp
  • Sound.cpp
  • Sound.hpp
  • SoundBuffer.cpp
  • SoundBuffer.hpp
  • SoundBufferRecorder.cpp
  • SoundBufferRecorder.hpp
  • SoundFile.cpp
  • SoundFile.hpp
  • SoundFileDefault.cpp
  • SoundFileDefault.hpp
  • SoundFileOgg.cpp
  • SoundFileOgg.hpp
  • SoundRecorder.cpp
  • SoundRecorder.hpp
  • SoundStream.cpp
  • SoundStream.hpp
  • Sprite.cpp
  • Sprite.hpp
  • String.cpp
  • String.hpp
  • System.hpp
  • Thread.cpp
  • Thread.hpp
  • Win32/Thread.hpp
  • Unicode.cpp
  • Unicode.hpp
  • Unicode.inl
  • Vector2.hpp
  • Vector2.inl
  • Vector3.hpp
  • Vector3.inl
  • VideoMode.cpp
  • VideoMode.hpp
  • Cocoa/VideoModeSupport.cpp
  • Template for new ports/VideoModeSupport.cpp
  • Win32/VideoModeSupport.cpp
  • Cocoa/VideoModeSupport.hpp
  • Template for new ports/VideoModeSupport.hpp
  • VideoModeSupport.hpp
  • Win32/VideoModeSupport.hpp
  • View.cpp
  • View.hpp
  • Window.cpp
  • Window/Window.hpp
  • Window.hpp
  • WindowHandle.hpp
  • WindowImpl.cpp
  • WindowImpl.hpp
  • WindowImplCocoa.hpp
  • WindowImplWin32.cpp
  • WindowImplWin32.hpp
  • WindowImplXXX.cpp
  • WindowImplXXX.hpp
  • WindowListener.hpp
  • WindowSettings.hpp
  • WindowStyle.hpp

Get in touch

Submit feedback about this site to:

• [email protected]

© documentation.help. Design: rehmann.co.