Name
  doc:CreateImageFromMem -- create new image from memory data
Synopsis

      img = doc:CreateImageFromMem(data, width, height, colorspace, bpc)

Function
  `doc:CreateImageFromMem()` creates an image from raw pixel data in memory. The `data` argument must be a memory pointer obtained via Hollywood's `GetMemPointer()` function. This function loads the data without any conversion so it is usually faster than the other functions. `bpc` specifies the bit size of each color component and can be either 1, 2, 4, or 8.

  The `colorspace` argument must be one of `#HPDF_CS_DEVICE_GRAY`, `#HPDF_CS_DEVICE_RGB`, or `#HPDF_CS_DEVICE_CMYK`. See doc:LoadRawImage for details.

  When `doc:CreateImageFromMem()` succeeds, it returns the handle of an image object. Otherwise, it returns `Nil` and the error handler is called.

Inputs
  data
    the pointer to the image data
  width
    the width of an image file
  height
    the height of an image file
  colorspace
    `#HPDF_CS_DEVICE_GRAY` or `#HPDF_CS_DEVICE_RGB` or `#HPDF_CS_DEVICE_CMYK` is allowed
  bpc
    the bit size of each color component; valid values are either 1, 2, 4, 8
Results
  img
    handle to an image
Errors
  `#HPDF_INVALID_DOCUMENT` - An invalid document handle was set.

  `#HPDF_FAILED_TO_ALLOC_MEM` - Memory allocation failed.

  `#HPDF_INVALID_COLOR_SPACE` - An invalid color_space value is specified.

  `#HPDF_INVALID_IMAGE` - The size of an image data is invalid.

Show TOC