home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / misc / emu / AROSdev.lha / AROS / workbench / libs / iffparse / entryhandler.c < prev    next >
Encoding:
C/C++ Source or Header  |  1997-02-03  |  2.1 KB  |  104 lines
  1. /*
  2.     (C) 1995-96 AROS - The Amiga Replacement OS
  3.     $Id: entryhandler.c,v 1.1 1997/02/03 16:44:22 digulla Exp $
  4.  
  5.     Desc:
  6.     Lang: english
  7. */
  8. #include "iffparse_intern.h"
  9.  
  10. /*****************************************************************************
  11.  
  12.     NAME */
  13. #include <proto/iffparse.h>
  14.  
  15.     AROS_LH6(LONG, EntryHandler,
  16.  
  17. /*  SYNOPSIS */
  18.     AROS_LHA(struct IFFHandle *, iff, A0),
  19.     AROS_LHA(LONG              , type, D0),
  20.     AROS_LHA(LONG              , id, D1),
  21.     AROS_LHA(LONG              , position, D2),
  22.     AROS_LHA(struct Hook      *, handler, A1),
  23.     AROS_LHA(APTR              , object, A2),
  24.  
  25. /*  LOCATION */
  26.     struct Library *, IFFParseBase, 17, IFFParse)
  27.  
  28. /*  FUNCTION
  29.     Installs an entry handler for a specific chunk type
  30.     that wil be called whenever a chunk of that type is pushed on the contextstack
  31.     via ParseIFF().
  32.  
  33.  
  34.     INPUTS
  35.     iff        - pointer to an iffhandle struct.
  36.     type      - type code for the chunk to handle. (ex: "ILBM").
  37.     id      -  ID code for the chunk to handle. (ex: "CMAP")
  38.     position  -  position of localcontextitem. See StoreLocalItem for
  39.             more info.
  40.     handler    -  an initialised Hook structure for the handler function.
  41.     object      -  pointer to some kind of object that will be passed to
  42.             your handler function.
  43.  
  44.     RESULT
  45.     error - 0 If successfull, IFFERR_#? elsewise.
  46.  
  47.     NOTES
  48.  
  49.     EXAMPLE
  50.  
  51.     BUGS
  52.  
  53.     SEE ALSO
  54.     ExitHandler(), StoreLocalItem(), StoreItemInContext()
  55.  
  56.  
  57.  
  58.     INTERNALS
  59.  
  60.     HISTORY
  61.   27-11-96    digulla automatically created from
  62.       iffparse_lib.fd and clib/iffparse_protos.h
  63.  
  64. *****************************************************************************/
  65. {
  66.     AROS_LIBFUNC_INIT
  67.     AROS_LIBBASE_EXT_DECL(struct Library *,IFFParseBase)
  68.  
  69.     struct LocalContextItem *lci;
  70.     struct HandlerInfo *hi;
  71.  
  72.     if
  73.     (
  74.     !(lci = AllocLocalItem
  75.         (
  76.         type,
  77.         id,
  78.         IFFLCI_ENTRYHANDLER,
  79.         sizeof (struct HandlerInfo)
  80.         )
  81.     )
  82.     )
  83.     return (IFFERR_NOMEM);
  84.  
  85.     /* Get pointer to the user data */
  86.     hi = LocalItemData(lci);
  87.  
  88.     hi->hi_Hook  = handler;
  89.  
  90.     hi->hi_Object  = object;
  91.  
  92.     return
  93.     (
  94.     StoreLocalItem
  95.     (
  96.         iff,
  97.         lci,
  98.         position
  99.     )
  100.     );
  101.  
  102.     AROS_LIBFUNC_EXIT
  103. } /* EntryHandler */
  104.