NAME

Image::Leptonica::Func::spixio

VERSION

version 0.04

spixio.c

spixio.c

  This does fast serialization of a pix in memory to file,
  copying the raw data for maximum speed.  The underlying
  function serializes it to memory, and it is wrapped to be
  callable from standard pixRead and pixWrite functions.

    Reading spix from file
         PIX        *pixReadStreamSpix()
         l_int32     readHeaderSpix()
         l_int32     freadHeaderSpix()
         l_int32     sreadHeaderSpix()

    Writing spix to file
         l_int32     pixWriteStreamSpix()

    Low-level serialization of pix to/from memory (uncompressed)
         PIX        *pixReadMemSpix()
         l_int32     pixWriteMemSpix()
         l_int32     pixSerializeToMemory()
         PIX        *pixDeserializeFromMemory()

FUNCTIONS

freadHeaderSpix

l_int32 freadHeaderSpix ( FILE *fp, l_int32 *pwidth, l_int32 *pheight, l_int32 *pbps, l_int32 *pspp, l_int32 *piscmap )

freadHeaderSpix()

    Input:  stream
            &width (<return>)
            &height (<return>)
            &bps (<return>, bits/sample)
            &spp (<return>, samples/pixel)
            &iscmap (<optional return>; input NULL to ignore)
    Return: 0 if OK, 1 on error

Notes:
    (1) If there is a colormap, iscmap is returned as 1; else 0.

pixDeserializeFromMemory

PIX * pixDeserializeFromMemory ( const l_uint32 *data, size_t nbytes )

pixDeserializeFromMemory()

    Input:  data (serialized data in memory)
            nbytes (number of bytes in data string)
    Return: pix, or NULL on error

Notes:
    (1) See pixSerializeToMemory() for the binary format.

pixReadMemSpix

PIX * pixReadMemSpix ( const l_uint8 *data, size_t size )

pixReadMemSpix()

    Input:  data (const; uncompressed)
            size (of data)
    Return: pix, or null on error

pixReadStreamSpix

PIX * pixReadStreamSpix ( FILE *fp )

pixReadStreamSpix()

    Input:  stream
    Return: pix, or null on error.

Notes:
    (1) If called from pixReadStream(), the stream is positioned
        at the beginning of the file.

pixSerializeToMemory

l_int32 pixSerializeToMemory ( PIX *pixs, l_uint32 **pdata, size_t *pnbytes )

pixSerializeToMemory()

    Input:  pixs (all depths, colormap OK)
            &data (<return> serialized data in memory)
            &nbytes (<return> number of bytes in data string)
    Return: 0 if OK, 1 on error

Notes:
    (1) This does a fast serialization of the principal elements
        of the pix, as follows:
          "spix"    (4 bytes) -- ID for file type
          w         (4 bytes)
          h         (4 bytes)
          d         (4 bytes)
          wpl       (4 bytes)
          ncolors   (4 bytes) -- in colormap; 0 if there is no colormap
          cdata     (4 * ncolors)  -- size of serialized colormap array
          rdatasize (4 bytes) -- size of serialized raster data
                                 = 4 * wpl * h
          rdata     (rdatasize)

pixWriteMemSpix

l_int32 pixWriteMemSpix ( l_uint8 **pdata, size_t *psize, PIX *pix )

pixWriteMemSpix()

    Input:  &data (<return> data of serialized, uncompressed pix)
            &size (<return> size of returned data)
            pix (all depths; colormap OK)
    Return: 0 if OK, 1 on error

pixWriteStreamSpix

l_int32 pixWriteStreamSpix ( FILE *fp, PIX *pix )

pixWriteStreamSpix()

    Input:  stream
            pix
    Return: 0 if OK; 1 on error

readHeaderSpix

l_int32 readHeaderSpix ( const char *filename, l_int32 *pwidth, l_int32 *pheight, l_int32 *pbps, l_int32 *pspp, l_int32 *piscmap )

readHeaderSpix()

    Input:  filename
            &width (<return>)
            &height (<return>)
            &bps (<return>, bits/sample)
            &spp (<return>, samples/pixel)
            &iscmap (<optional return>; input NULL to ignore)
    Return: 0 if OK, 1 on error

Notes:
    (1) If there is a colormap, iscmap is returned as 1; else 0.

sreadHeaderSpix

l_int32 sreadHeaderSpix ( const l_uint32 *data, l_int32 *pwidth, l_int32 *pheight, l_int32 *pbps, l_int32 *pspp, l_int32 *piscmap )

sreadHeaderSpix()

    Input:  data
            &width (<return>)
            &height (<return>)
            &bps (<return>, bits/sample)
            &spp (<return>, samples/pixel)
            &iscmap (<optional return>; input NULL to ignore)
    Return: 0 if OK, 1 on error

Notes:
    (1) If there is a colormap, iscmap is returned as 1; else 0.

AUTHOR

Zakariyya Mughal <zmughal@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Zakariyya Mughal.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.