cio.h 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. /*
  2. * Copyright (c) 2002-2007, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium
  3. * Copyright (c) 2002-2007, Professor Benoit Macq
  4. * Copyright (c) 2001-2003, David Janssens
  5. * Copyright (c) 2002-2003, Yannick Verschueren
  6. * Copyright (c) 2003-2007, Francois-Olivier Devaux and Antonin Descampe
  7. * Copyright (c) 2005, Herve Drolon, FreeImage Team
  8. * All rights reserved.
  9. *
  10. * Redistribution and use in source and binary forms, with or without
  11. * modification, are permitted provided that the following conditions
  12. * are met:
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions and the following disclaimer.
  15. * 2. Redistributions in binary form must reproduce the above copyright
  16. * notice, this list of conditions and the following disclaimer in the
  17. * documentation and/or other materials provided with the distribution.
  18. *
  19. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
  20. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22. * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  23. * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  24. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  25. * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  26. * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  27. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  28. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  29. * POSSIBILITY OF SUCH DAMAGE.
  30. */
  31. #ifndef __CIO_H
  32. #define __CIO_H
  33. #if defined(_MSC_VER) || defined(__BORLANDC__)
  34. #define int64 __int64
  35. #else
  36. #define int64 long long
  37. #endif
  38. /**
  39. @file cio.h
  40. @brief Implementation of a byte input-output process (CIO)
  41. The functions in CIO.C have for goal to realize a byte input / output process.
  42. */
  43. /** @defgroup CIO CIO - byte input-output stream */
  44. /*@{*/
  45. /** @name Exported functions (see also openjpeg.h) */
  46. /*@{*/
  47. /* ----------------------------------------------------------------------- */
  48. /**
  49. Number of bytes left before the end of the stream
  50. @param cio CIO handle
  51. @return Returns the number of bytes before the end of the stream
  52. */
  53. int cio_numbytesleft(opj_cio_t *cio);
  54. /**
  55. Get pointer to the current position in the stream
  56. @param cio CIO handle
  57. @return Returns a pointer to the current position
  58. */
  59. unsigned char *cio_getbp(opj_cio_t *cio);
  60. /**
  61. Write some bytes
  62. @param cio CIO handle
  63. @param v Value to write
  64. @param n Number of bytes to write
  65. @return Returns the number of bytes written or 0 if an error occured
  66. */
  67. unsigned int cio_write(opj_cio_t *cio, unsigned int64 v, int n);
  68. /**
  69. Read some bytes
  70. @param cio CIO handle
  71. @param n Number of bytes to read
  72. @return Returns the value of the n bytes read
  73. */
  74. unsigned int cio_read(opj_cio_t *cio, int n);
  75. /**
  76. Skip some bytes
  77. @param cio CIO handle
  78. @param n Number of bytes to skip
  79. */
  80. void cio_skip(opj_cio_t *cio, int n);
  81. /* ----------------------------------------------------------------------- */
  82. /*@}*/
  83. /*@}*/
  84. #endif /* __CIO_H */