workbench/libs/datatypes/obtaindtdrawinfoa.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/exec.h>
  12 #include <proto/alib.h>
  13 #include <utility/tagitem.h>
  14 #include <datatypes/datatypesclass.h>
  15 #include <intuition/classusr.h>
  16 #include <clib/boopsistubs.h>
  17
  18 /*****************************************************************************
  19
  20     NAME */
  21
  22         AROS_LH2(APTR, ObtainDTDrawInfoA,
  23
  24 /*  SYNOPSIS */
  25         AROS_LHA(Object         *, o  ,   A0),
  26         AROS_LHA(struct TagItem *, attrs, A1),
  27
  28 /*  LOCATION */
  29         struct Library *, DataTypesBase, 20, DataTypes)
  30
  31 /*  FUNCTION
  32
  33     Prepare a data type object for drawing into a RastPort; this function
  34     will send the DTM_OBTAINDRAWINFO method the object using an opSet
  35     message.
  36
  37     INPUTS
  38
  39     o      --  pointer to the data type object to obtain the drawinfo for;
  40                may be NULL in which case nothing is done
  41     attrs  --  additional attributes
  42
  43     RESULT
  44
  45     A private handle that must be passed to ReleaseDTDrawInfo when the
  46     application is done drawing the object, or NULL if failure.
  47
  48     TAGS
  49
  50     PDTA_Screen     --  for pictureclass objects
  51     ADTA_Screen     --  for animationclass objects
  52
  53     NOTES
  54
  55     EXAMPLE
  56
  57     BUGS
  58
  59     SEE ALSO
  60
  61     DrawDTObjectA(), ReleaseDTDrawInfo()
  62
  63     INTERNALS
  64
  65     HISTORY
  66
  67     29.8.99  SDuvan  implemented
  68
  69 *****************************************************************************/
  70 {
  71     AROS_LIBFUNC_INIT
  72
  73     struct opSet ops;
  74
  75     if(o == NULL)
  76         return NULL;
  77
  78     ops.MethodID     = DTM_OBTAINDRAWINFO;
  79     ops.ops_AttrList = attrs;
  80     ops.ops_GInfo    = NULL;
  81
  82     return (APTR)DoMethodA(o, (Msg)&ops);
  83
  84     AROS_LIBFUNC_EXIT
  85 } /* ObtainDTDrawInfoA */