[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
       GetRPAttrA -- examine rastport settings via a tag list
        GetRPAttrs  -- varargs stub for GetRPAttrA

   SYNOPSIS
       GetRPAttrA(rp,tags)
                  a0   a1

        void GetRPAttrA(struct rastport *, struct tagitem *);

        GetRPAttrs(rp,attr1,&result1,...);

   FUNCTION
       read the settings of a rastport into variables. the
        ti_Tag field of the tagitem specifies which attribute
        should be read, and the ti_Data field points at the
        location where the result hsould be stored. All current
        tags store the return data as LONGs (32 bits).

        currently available tags are:

                RPTAG_Font              Font for text()
                RPTAG_SoftStyle         style for text (see graphics/text.h)
                RPTAG_APen              Primary rendering pen
                RPTAG_BPen              Secondary rendering pen
                RPTAG_DrMd              Drawing mode (see graphics/rastport.h)
                RPTAG_OutLinePen        Area Outline pen
                RPTAG_WriteMask         Bit Mask for writing.
                RPTAG_MaxPen            Maximum pen to render (see setmaxpen())
                RPTAG_DrawBounds        Determine the area that will be rendered
                                        into by rendering commands. Can be used
                                        to optimize window refresh. Pass a pointer
                                        to a rectangle in the tag data. On return,
                                        the rectangle's MinX will be greater than
                                        its MaxX if there are no active cliprects.

   INPUTS
        rp - pointer to the rastport to examine.
        tags - a standard tag list specifying the attributes to be read,
                and where to store their values.

   RESULT

   BUGS

   SEE ALSO
        getapen() getbpen() getdrmd() getoutlinepen()
        setrpattra() graphics/rpattr.h