workbench/libs/datatypes/releasedtdrawinfo.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8
   9 #define USE_BOOPSI_STUBS
  10 #include "datatypes_intern.h"
  11 #include <proto/alib.h>
  12 #include <datatypes/datatypesclass.h>
  13 #include <clib/boopsistubs.h>
  14
  15
  16 /*****************************************************************************
  17
  18     NAME */
  19
  20         AROS_LH2(VOID, ReleaseDTDrawInfo,
  21
  22 /*  SYNOPSIS */
  23         AROS_LHA(Object *, o     , A0),
  24         AROS_LHA(APTR    , handle, A1),
  25
  26 /*  LOCATION */
  27         struct Library *, DataTypesBase, 22, DataTypes)
  28
  29 /*  FUNCTION
  30
  31     Release the handle obtained from ObtainDTDrawInfoA(); invokes the object's
  32     DTM_RELEASEDRAWINFO method sending the dtReleaseDrawInfo message.
  33
  34     INPUTS
  35
  36     o       --  pointer to the data type object the drawinfo of which to
  37                 release; may be NULL
  38     handle  --  handle got from ObtainDTDrawInfoA()
  39
  40     RESULT
  41
  42     A private handle that must be passed to ReleaseDTDrawInfo when the
  43     application is done drawing the object, or NULL if failure.
  44
  45     TAGS
  46
  47     PDTA_Screen     --  for pictureclass objects
  48     ADTA_Screen     --  for animationclass objects
  49
  50     NOTES
  51
  52     EXAMPLE
  53
  54     BUGS
  55
  56     SEE ALSO
  57
  58     DrawDTObjectA(), ObtainDTDrawInfo()
  59
  60     INTERNALS
  61
  62     HISTORY
  63
  64     29.8.99  SDuvan  implemented
  65
  66 *****************************************************************************/
  67 {
  68     AROS_LIBFUNC_INIT
  69
  70     struct dtReleaseDrawInfo rdi;
  71
  72     if(o == NULL)
  73         return;
  74
  75     rdi.MethodID   = DTM_RELEASEDRAWINFO;
  76     rdi.dtr_Handle = handle;
  77
  78     DoMethodA(o, (Msg)&rdi);
  79
  80     AROS_LIBFUNC_EXIT
  81 } /* ReleaseDTDrawInfoA */