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