Wiki Page Content

Differences between revisions 7 and 8
Revision 7 as of 2013-08-08 19:22:01
Size: 1478
Editor: RyanGordon
Comment: Rewritten
Revision 8 as of 2013-08-08 19:22:59
Size: 1413
Editor: RyanGordon
Comment: Oops
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:
= SDL_RWFromConstMem = = SDL_RWFromMem =
Line 11: Line 11:
SDL_RWops* SDL_RWFromConstMem(const void* mem,
                             
int         size)
SDL_RWops* SDL_RWFromMem(void* mem, int size)
Line 16: Line 15:
||'''mem'''||a pointer to a read-only buffer to feed an [[SDL_RWops]] stream|| ||'''mem'''||a pointer to a buffer to feed an [[SDL_RWops]] stream||

SDL_RWFromMem

Use this function to prepare a read-only memory buffer for use with RWops.

Syntax

SDL_RWops* SDL_RWFromMem(void* mem, int size)

Function Parameters

mem

a pointer to a buffer to feed an SDL_RWops stream

size

the buffer size, in bytes

Return Value

Returns a pointer to a new SDL_RWops structure, or NULL if it fails; call SDL_GetError() for more information.

Code Examples

char bitmap[310000];
SDL_RWops *rw = SDL_RWFromMem(bitmap, sizeof(bitmap));
SDL_SaveBMP_RW(screen, rw, 1);  /* closes RWOPS, leaves us memory buffer of data */

Remarks

This function sets up an SDL_RWops struct based on a memory area of a certain size, for both read and write access.

This memory buffer is not copied by the RWops; the pointer you provide must remain valid until you close the stream. Closing the stream will not free the original buffer.

If you need to make sure the RWops never writes to the memory buffer, you should use SDL_RWFromConstMem with a read-only buffer of memory instead.


CategoryAPI, CategoryIO

None: SDL_RWFromMem (last edited 2015-06-20 20:00:06 by PhilippWiesemann)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit