AMIGA - MEM_#?
 ----------------------------------------------------------------------------

   NAME

      mem_loadpicture() - Allows to load and remap picture(s)
                          so they look best on a given screen.



   SYNOPSIS

      bmap = mem_loadpicture(file, cm, rp, memtype, flags);

      struct BitMap **mem_loadpicture(UBYTE *,
       struct ColorMap *, struct RastPort *, ULONG, ULONG);



   FUNCTION

      This func. allows to load binary('genanim' produced) or
      any other picture thru datatypes, using 'guigfx.library'.



   INPUTS

      file    - NULL terminated string.

      cm      - ColorMap to fit.

      rp      - RastPort to be used by the 'guigfx'.

      memtype - Memory type(binary images only!).

      flags   - Image/color flags.



   RETURNS

      Returns an array of bitmaps(last one is always NULL) or
      NULL if there is not enough memory.



   BASES

      SysBase, DOSBase, GfxBase, [GuiGFXBase]



   NOTES

      This func. can load binary animations too! Use 'PPaint'
      & 'genanim'.

      Frame optimization is essentially possible. Currently
      PJW64 hashing algorithm is being used to fish out duped
      frames.

      This function assumes that color 0 is pseudo transparent
      for binary pictures!

      Please dont assume that 'guigfx' returns standard Amiga
      BitMap!



   SEE ALSO

      mem_freepicture()



   EXAMPLE

      None.



   BUGS

      None known.



 ----------------------------------------------------------------------------