SDL_rwops.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:5k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /*
  2.     SDL - Simple DirectMedia Layer
  3.     Copyright (C) 1997-2006 Sam Lantinga
  4.     This library is free software; you can redistribute it and/or
  5.     modify it under the terms of the GNU Lesser General Public
  6.     License as published by the Free Software Foundation; either
  7.     version 2.1 of the License, or (at your option) any later version.
  8.     This library is distributed in the hope that it will be useful,
  9.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  10.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11.     Lesser General Public License for more details.
  12.     You should have received a copy of the GNU Lesser General Public
  13.     License along with this library; if not, write to the Free Software
  14.     Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  15.     Sam Lantinga
  16.     slouken@libsdl.org
  17. */
  18. /* This file provides a general interface for SDL to read and write
  19.    data sources.  It can easily be extended to files, memory, etc.
  20. */
  21. #ifndef _SDL_rwops_h
  22. #define _SDL_rwops_h
  23. #include "SDL_stdinc.h"
  24. #include "SDL_error.h"
  25. #include "begin_code.h"
  26. /* Set up for C function definitions, even when using C++ */
  27. #ifdef __cplusplus
  28. extern "C" {
  29. #endif
  30. /* This is the read/write operation structure -- very basic */
  31. typedef struct SDL_RWops {
  32. /* Seek to 'offset' relative to whence, one of stdio's whence values:
  33. SEEK_SET, SEEK_CUR, SEEK_END
  34.    Returns the final offset in the data source.
  35.  */
  36. int (SDLCALL *seek)(struct SDL_RWops *context, int offset, int whence);
  37. /* Read up to 'num' objects each of size 'objsize' from the data
  38.    source to the area pointed at by 'ptr'.
  39.    Returns the number of objects read, or -1 if the read failed.
  40.  */
  41. int (SDLCALL *read)(struct SDL_RWops *context, void *ptr, int size, int maxnum);
  42. /* Write exactly 'num' objects each of size 'objsize' from the area
  43.    pointed at by 'ptr' to data source.
  44.    Returns 'num', or -1 if the write failed.
  45.  */
  46. int (SDLCALL *write)(struct SDL_RWops *context, const void *ptr, int size, int num);
  47. /* Close and free an allocated SDL_FSops structure */
  48. int (SDLCALL *close)(struct SDL_RWops *context);
  49. Uint32 type;
  50. union {
  51. #if defined(__WIN32__) && !defined(__SYMBIAN32__)
  52.     struct {
  53. int   append;
  54. void *h;
  55. struct {
  56.     void *data;
  57.     int size;
  58.     int left;
  59. } buffer;
  60.     } win32io;
  61. #endif
  62. #ifdef HAVE_STDIO_H 
  63.     struct {
  64. int autoclose;
  65.   FILE *fp;
  66.     } stdio;
  67. #endif
  68.     struct {
  69. Uint8 *base;
  70.   Uint8 *here;
  71. Uint8 *stop;
  72.     } mem;
  73.     struct {
  74. void *data1;
  75.     } unknown;
  76. } hidden;
  77. } SDL_RWops;
  78. /* Functions to create SDL_RWops structures from various data sources */
  79. extern DECLSPEC SDL_RWops * SDLCALL SDL_RWFromFile(const char *file, const char *mode);
  80. #ifdef HAVE_STDIO_H
  81. extern DECLSPEC SDL_RWops * SDLCALL SDL_RWFromFP(FILE *fp, int autoclose);
  82. #endif
  83. extern DECLSPEC SDL_RWops * SDLCALL SDL_RWFromMem(void *mem, int size);
  84. extern DECLSPEC SDL_RWops * SDLCALL SDL_RWFromConstMem(const void *mem, int size);
  85. extern DECLSPEC SDL_RWops * SDLCALL SDL_AllocRW(void);
  86. extern DECLSPEC void SDLCALL SDL_FreeRW(SDL_RWops *area);
  87. #define RW_SEEK_SET 0 /* Seek from the beginning of data */
  88. #define RW_SEEK_CUR 1 /* Seek relative to current read point */
  89. #define RW_SEEK_END 2 /* Seek relative to the end of data */
  90. /* Macros to easily read and write from an SDL_RWops structure */
  91. #define SDL_RWseek(ctx, offset, whence) (ctx)->seek(ctx, offset, whence)
  92. #define SDL_RWtell(ctx) (ctx)->seek(ctx, 0, RW_SEEK_CUR)
  93. #define SDL_RWread(ctx, ptr, size, n) (ctx)->read(ctx, ptr, size, n)
  94. #define SDL_RWwrite(ctx, ptr, size, n) (ctx)->write(ctx, ptr, size, n)
  95. #define SDL_RWclose(ctx) (ctx)->close(ctx)
  96. /* Read an item of the specified endianness and return in native format */
  97. extern DECLSPEC Uint16 SDLCALL SDL_ReadLE16(SDL_RWops *src);
  98. extern DECLSPEC Uint16 SDLCALL SDL_ReadBE16(SDL_RWops *src);
  99. extern DECLSPEC Uint32 SDLCALL SDL_ReadLE32(SDL_RWops *src);
  100. extern DECLSPEC Uint32 SDLCALL SDL_ReadBE32(SDL_RWops *src);
  101. extern DECLSPEC Uint64 SDLCALL SDL_ReadLE64(SDL_RWops *src);
  102. extern DECLSPEC Uint64 SDLCALL SDL_ReadBE64(SDL_RWops *src);
  103. /* Write an item of native format to the specified endianness */
  104. extern DECLSPEC int SDLCALL SDL_WriteLE16(SDL_RWops *dst, Uint16 value);
  105. extern DECLSPEC int SDLCALL SDL_WriteBE16(SDL_RWops *dst, Uint16 value);
  106. extern DECLSPEC int SDLCALL SDL_WriteLE32(SDL_RWops *dst, Uint32 value);
  107. extern DECLSPEC int SDLCALL SDL_WriteBE32(SDL_RWops *dst, Uint32 value);
  108. extern DECLSPEC int SDLCALL SDL_WriteLE64(SDL_RWops *dst, Uint64 value);
  109. extern DECLSPEC int SDLCALL SDL_WriteBE64(SDL_RWops *dst, Uint64 value);
  110. /* Ends C function definitions when using C++ */
  111. #ifdef __cplusplus
  112. }
  113. #endif
  114. #include "close_code.h"
  115. #endif /* _SDL_rwops_h */