Library Functions SIIRSB32 (RIVISlol 3.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

SIIRSM

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

extracts 32-bit color values from a Color Map structure graphics.1ibrary

-$384

GetRGB32(colorMap, firstcolor, ncolors, table)

VOID GetRGB32(struct ColorMap *, ULONG, ULONG, ULONG *) GetRGB32(aO, dO, dl, al)

colorMap == colormap containing the desired colors ftrstcolor == first color register to get

ncolors == number of color registers to read table == buffer to receive extracted colors none

extracts a 12-bit color from a ColorMap structure graphics.library

-$246

value == GetRGB4(colorMap, entry)

ULONG GetRGB4(struct ColorMap *, LONG) dO == GetRGB32(aO, dO)

colorMap == colormap containing the desired color entry == index into colormap specifying desired entry value == 12-bit color value; -1 if no valid entry

SIIRPAHrA (Rlvlslon 3.0)

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

returns information about a RastPort graphics.1ibrary

-$414

GetRPAttrA(rp, tags)

VOID GetRP AttrA(struct RastPort *, struct TagItem *) GetRPAttrA(aO, al)

rastPort == RastPort to examine

tags == tag list of attributes-RPT AG_Font ($80000000), RPT AG_APen ($80000002), RPTAG_BPen ($80000003), RPTAG_DrMd ($80000004), RPTAG_OutLinePen ($80000005), RPTAG_WriteMask ($80000006), RPT AG _Max Pen ($80000007)

none

SllScraanDala

Description: obtains all or part of a Screen structure, opening the screen if necessary Library: intuition.1ibrary

Offset: -$IAA Syntax:

C:

ML:

success == GetScreenData(buffer, size, type, screen)

BOOL GetScreenData(APTR, UWORD, UWORD, struct Screen *) dO == GetScreenData(aO, dO, dl, al)

Mapping the Amiga

Arguments: buffer =buffer to receive data size = size of buffer

type = screen type, as specified in OpenWindow():

WBENCHSCREEN ($00000001), PUBLICSCREEN ($00000002), CUSTOMSCREEN ($OOOOOOOF)

screen = custom Screen structure; ignored if type is not CUSTOMSCREEN Result: success = zero if unsuccessful

BetScraenDrawlnlo (Re,lslon 2.0)

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

BetSprlte

obtains a screen's rendering information intuition.library

-$2BC

drInfo = GetScreenDrawInfo(screen)

struct Draw Info *GetScreenDrawInfo(struct Screen *) dO = GetScreenDrawInfo(aO)

screen = screen to examine

drInfo = a system-allocated DrawInfo structure

Description: gets a simple sprite Library: graphics.library Offset: -$198

Syntax:

C:

ML:

Arguments:

Result:

spriteNum = GetSprite(sprite, pick)

WORD GetSprite(struct SimpleSprite *, WORD) dO = GetSprite(aO, dO)

sprite = sprite definition

pick = desired sprite number; 0-7, or -1 if you don't care spriteNum = sprite number of sprite you got; -1 if unsuccessful

BetTagData (Revision 2.0)

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

108

obtains the data associated with a tag value utility.library

-$24

value = GetTagData(tagValue, defauItVal, tags)

ULONG GetTagData(tagValue, ULONG, struct TagItem *) dO = GetTagData(dO, dl, aO)

tagValue = tag value to search for

defauItVaI = value to be returned if tagValue is not found tags = the tag list to search

value = data in Tag Item matching tagValue if found, defaultVaI if not found

Library Functions

BetUnlquelD (Revision 3.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

returns a relatively unique number utility.library

-$lOE

ID = GetUniqueID()

ULONG GetUniqueID(VOID) dO

=

GetUniqueID( )

none

ID

=

a unique 32-bit value

BetVar (Revision 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

returns the value of an environment variable dos.library

-$38A

len

=

GetVar(name, buffer, size, flags)

LONG GetVar(S1RPTR, STRPTR, LONG, ULONG) dO = GetVar(dl, d2, d3, d4)

name = variable name buffer = buffer to hold value size = size of buffer

flags = type of variable to get:

GVF _GLOBAL_ONLY ($00000100), GVF _LOCAL_ONL Y ($00000200), GVF _BINARY _ V AR ($00000400)

len

=

size of environment variable; -1 if unsuccessful

BetVlsualinfoA (Revision 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

gets information for GadTools display gadtools.library

-$7E

vi

=

GetVisualInfoA(screen, tags)

APTR vi

=

GetVisualInfo(struct Screen *, struct TagItem *) dO

=

GetVisualInfoA(aO, al)

screen

=

the screen on which GadTools will operate tags

=

tag list of attributes-none are currently defined vi = pointer to private data; zero if unsuccessfull

BetVPModelD (Revision 2.0)

Description: gets a ViewPort's 32-bit DisplayID Library: graphics.library

Offset: -$318 Syntax:

c:

ML:

modeID = GetVPModeID(viewPort) ULONG GetVPModeID(struct ViewPort *) dO = GetVPModeID(aO)

Mapping the Amiga

Arguments:

Result:

viewPort

=

ViewPort structure

modeID

=

ViewPort's 32-bit DisplaylnfoRecord identifier; -1 if unsuccessful

GflAsSOcllll (Revlslol 2.0)

Description: associates a graphics extended node with a given pointer Library: graphics.library

Offset: -$2AO Syntax:

c:

ML:

Arguments:

Result:

GfxAssociate(pointer, node)

VOID GfxAssociate(VOID *, struct ExtendedNode *) GfxAssociate(aO, al)

pointer = data structure

node = ExtendedNode structure to associate with the pointer none

GlxFrel (Revlslol 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

frees a graphics extended data structure graphics.library

-$29A GfxFree(node)

VOID GfxFree(struct ExtendedNode *) GfxFree(aO)

node = graphics extended data structure returned by GfxNew( ) function none

GfILoukUP (Revlslol 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

finds a graphics extended node associated with a pointer graphics.library

-$2BE

result = GfxLookUp(pointer)

struct ExtendedNode *GfxLookUp(VOID *) dO

=

GfxLookUp(aO)

pointer

=

pointer in question

result = associated ExtendedNode structure; zero if unsuccessful

GfINew (Revlslol 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

allocates a graphics extended data structure graphics.library

-$294

node = GfxNew(nodeType)

struct ExtendedNode *GfxNew(ULONG) dO = GfxNew(dO)

Library Functions

Arguments: nodeType

=

type of graphics extended data structure to allocate:

VIEW_EXTRA_TYPE ($00000001), VIEWPORT_EX1RA_TYPE ($00000002), SPECIAL_MONITOR_TYPE ($00000003), MONITOR_SPEC_TYPE ($()()()()()()()4) Result: node

=

extended data structure; zero if unsuccessful

GoodlD (ReJision 2.0)

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

tests an identifier for adherance to the IFF 85 specification iffparse.library

-$102

isok = GoodID(id) LONG GoodID(LONG) dO

=

GoodID(dO) id

=

32-bit identifier

isok = zero if the id is invalid

GoodlY.e (Re,lslon 2.0)

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

tests a type for adherance to the IFF 85 specification iffparse.library

-$108

isok

=

GoodType(type) LONG GoodType(LONG) dO

=

GoodType( dO)

type = 32-bit format type identifier isok

=

zero if the type is invalid

GT_BeglnRelresb (Revision 2.0)

Description: begins a GadTools-friendly refresh Library: gadtools.library

Offset: -$5A

Syntax: GT _BeginRefresh(win)

C: VOID GT_BeginRefresh(struct Window *) ML: GT _BeginRefresh(aO)

Arguments: win

=

a Window structure to which GadTools gadgets are attached Result: none

GT_EndRelresb (Revision 2.0)

Description: ends a GadTools-friendly refresh Library: gadtools.library

Offset: -$60 Syntax:

C:

ML:

Arguments:

Result:

GT_EndRefresh(win, complete)

VOID GT_EndRefresh(struct Window *, BOOL) GT_EndRefresh(aO, dO)

win = a Window structure to which GadTools gadgets are attached complete

=

nonzero when done with refresh

none

Mapping the Amiga

"_fllleriMSI (Revision 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

ftlters an IntuiMessage through GadTools gadtools.library

-$66

modimsg

=

GT_FilterIMsg(msg)

struct IntuiMessage *GT_FilterIMsg(struct IntuiMessage *) dO = GT_FilterIMsg(al)

imsg = IntuiMessage structure to pass to GadTools modimsg

=

possibly-modified IntuiMessage structure;

zero if not a GadTools message and should be returned with ReplyMsg( )

GY_6I1GadleIAHrsA (Revision 3.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

obtains the attributes of a GadTools gadget gadtools.library

-$AE

numProcessed = GT_GetGadgetAttrsA(gad, win, req, tags)

LONG GT _GetGadgetAttrsA(struct Gadget *, struct Window *, struct Requester *, struct Tagltem *)

dO = GT_GetGadgetAttrsA(aO, aI, a2, a3) gad = the gadget to obtain information about win

=

the window containing the gadget.

req = reserved for future use; should be zero tags = tag list to receive data:

see <libraries/gadtools.h> for description

numProcessed

=

the number of data actually retrieved

GY_GIIIMSI (Revision 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

retrieves an IntuiMessage with Gadtools processing gadtools.library

-$48

imsg = GT_GetIMsg(msgport)

struct IntuiMessage *GT_GetIMsg(struct MsgPort *) dO = GT_GetIMsg(aO)

msgport = MsgPort of a Window that has GadTools gadgets attached imsg = pointer to Intuimessage structure;

zero if no messages are available or if all available messages relate only to GadTools

GY_PDStAlleriMsg (Revision 2.0)

Description: returns an unfiltered message which has been passed to GT_FilterIMsg() Library: gadtools.library

Offset: -$6C Syntax:

c:

imsg = GT_PostFilterIMsg(modimsg)

struct IntuiMessage *GT]ostFilterIMsg(struct IntuiMessage *)

Library Functions

ML:

Arguments:

Result:

dO = GT_PostFilterIMsg(al)

modimsg = IntuiMessage structure returned by GT_FilterIMsg( ) imsg = original IntuiMessage structure passed to GT _FilterIMsg( )

IT_RefreshWlndow (Revision 2.0)

Description: performs initial refresh of GadTools gadgets in a window Library: gadtools.library

Offset -$54 Syntax:

c:

ML:

Arguments:

Result:

GT _Refresh Window( win, req)

VOID GT_RefreshWindow(struct Window *, struct Requester *) GT_RefreshWindow(aO, al)

win = the Window containing the GadTools gadgets req

=

reserved for future use; should be zero none

S'-ReplylMsg (Re,lslon 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

replies to a message obtained with GT _ GetIMsg( ) gadtools.library

-$4E

GT _ReplyIMsg(imsg)

VOID GT_ReplyIMsg(struct IntuiMessage *) GT_ReplyIMsg(al)

imsg = IntuiMessage structure returned by GT_GetIMsg() none

IT_SItGadgelAttrsA (Re,lsIOn 2.0)

Description:

Library:

Offset:

sets attributes of a GadTools gadget gadtools.library

-$2A

GT_SetGadgetAttrsA(gad, win, req, tags) Syntax:

c:

VOID GT_SetGadgetAttrsA(struct Gadget *, struct Window *, struct Requester *, struct Tag Item *)

ML:

Arguments:

Result:

GT_SetGadgetAttrsA(aO, aI, a2, a3) gad

=

the gadget to modify

win = the window containing the gadget req

=

reserved for future use; should be zero

tags

=

tag list of parameters to set-see <libraries/gadtools.h> for description

none

Mapping the Amiga

Dans le document Mapping Amiga® the (Page 117-124)