Library Functions Polntlnlmage (Revision 2.0)

Description: tests whether an image contains a specific point Library: intuition.library

Offset: -$270 Syntax:

C:

ML:

Arguments:

Result:

PolyDraw

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

doesContain = PointInImage(point, image) BOOL PointInImage(struct Point, struct Image *) dO

=

PointInImage( dO, aO)

point

=

the point's coordinates image

=

image to check

doesContain = nonzero if point is found in image definition or image = 0

draws a polygon from an array of points graphics.library

-$150

PolyDraw(rastPort, count, array)

VOID PolyDraw(struct RastPort *, WORD, WORD *) PolyDraw(al, dO, aO)

rastPort

=

RastPort structure

count = number of points in the array array = array of points

Result: none

PopChunk (Revision 2.0)

Description: pops the top context node off the context stack Library: iffparse.library

Offset: -$5A Syntax:

C:

ML:

Arguments:

Result:

error = PopChunk(iff)

LONG PopChunk(struct IFFHandle *) dO

=

PopChunk(aO)

iff

=

an IFFHandle structure

error

=

zero if successful; nonzero error-code if unsuccessful

PrlntDTObJectA (Revision 3.0)

Description: calls a DataType object's DTM_PRINT method as a separate process Library: datatypes.library

Offset: -$72 Syntax:

C:

ML:

success

=

PrintDTObjectA(object, window, requester, msg)

ULONG PrintDTObjectA(Object * , struct Window *, struct Requester *, struct dtPrint *)

=

PrintDTObjectA(aO, aI, a2, a3)

Mapping the Amiga

Arguments: object

=

Object structure returned by NewDTObjectA() window

=

window to which the object is attached requester = requester to which the object is attached msg = Initialized dtPrint structure

Result: success

=

zero if unsuccessful

PrlntFault (ReviSion 2.0)

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

PrintlText

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

returns the text associated with a DOS error code dos.library

-$IDA

success

=

PrintFau1t(code, header) BOOL PrintFault(LONG, STRPTR) dO

=

PrintFauJt(dI, d2)

code = error code

header = text to output before error text success = zero if unsuccessful

prints text found in an IntuiText structure intuition.library

-$D8

PrintIText(rastPort, iText, leftOffset, topOffset)

VOID PrintIText(struct RastPort *, struct IntuiText *, WORD, WORD) PrintIText(aO, aI, dO, dI)

rastPort

=

destination RastPort

iText = IntuiText structure containing text

leftOffset = horizontal offset from left edge of RastPort topOffset = vertical offset from top edge of RastPort Result: none

Procure (ReviSion 3.0)

Description:

Library:

Offset Syntax:

C:

ML:

Arguments:

Result:

makes a bid for a semaphore exec.library

-$21C

Procure(semaphore, bidMessage)

VOID Procure(struct SignalSemaphore *, struct SemaphoreMessage *) Procure(aO, al)

semaphore = the SignalSemaphore desired

bidMessage

=

the SemaphoreMessage to be sent when the semaphore is obtained

none

Library Functions

PnDChunk (Ravlslon 2.0)

Description: stores a property chunk Library: iffparse.library

Offset: -$72 Syntax:

C:

ML:

Arguments:

Result:

error = PropChunk(iff, type, id)

LONG PropChunk(struct IFFHandle *, LONG, LONG) dO = PropChunk(aO, dO, dl)

iff = an IFFHandle structure type = type code for the new chunk id = identifier for the new chunk

error

=

zero if successful; nonzero error-code if unsuccessful

PropChunks (Revision 2.0)

Description: declares multiple property chunks Library: iffparse.library

Offset: -$78 Syntax:

C:

ML:

Arguments:

Result:

error = PropChunks(iff, propArray, numPairs)

LONG PropChunks(struct IFFHandle *, LONG *, LONG) dO = PropChunks(aO, aI, dO)

iff

=

an IFFHandle structure

propArray = array of longword chunk types and identifiers numPairs = number of pairs in propArray

error = zero if successful; nonzero error-code if unsuccessful

PubScreenStatus (Revision 2.0)

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

changes a public screen's status flags intuition.library

-$228

resultF1ags = PubScreenStatus(screen, statusFlags) UWORD PubScreenStatus(struct Screen *, UWORD) dO

=

PubScreenStatus(aO, dO)

screen

=

public screen to change

statusFlags = new flags-PSNF ]RIV A TE ($00000001) resultF1ags = zero if unsuccessful

PushChunk (Revision 2.0)

Description: pushes a new context node on the context stack Library: iffparse.library

Offset: -$54 Syntax:

C:

ML:

error

=

PushChunk(iff, type, id, size);

LONG PushChunk(struct IFFHandle *, LONG, LONG, LONG) dO

=

PushChunk(aO, dO, dl, d2)

Mapping the Amiga

Arguments: iff

=

an IFFHandle structure type = chunk type specifier id = chunk id specifier

size = size of the chunk to create or IFFSIZE_UNKNOWN ($FFFFFFFF) Result: error = zero if successful; nonzero error-code if unsuccessful

PulDemlskOblect (Revision 2.0)

Description: writes a disk object as the default for its type Library: icon.library

Offset: -$7E Syntax:

c:

ML:

Arguments:

Result:

PulDlskOblect

success = PutDefDiskObject(diskobj)

BOOL PutDetDiskObject(struct DiskObject *) dO = PutDetDiskObject(aO)

diskobj

=

DiskObject structure to write success = zero if unsuccessful

Description: writes a DiskObject to disk Library: icon.library

Offset: -$54 Syntax:

c:

ML:

Arguments:

Result:

PUIMsa

Description:

Library:

Offset:

Syntax:

c:

ML:

Arguments:

Result:

success

=

PutDiskObject(name, diskobj)

BOOL PutDiskObject(char *, struct DiskObject *) dO = PutDiskObject(aO, al)

name = name of the object to write diskobj

=

DiskObject structure to write success = zero if unsuccessful

puts a message to a message port exec.library

-$16E

PutMsg(port, message)

VOID PutMsg(struct MsgPort *, struct Message *) PutMsg(aO, at)

port = the message port to recei ve the message message = the message to put

none

PUISIr (Revision 2.0)

Description: writes a string to the the default output device Library: dos.library

Offset: -$3B4 Syntax:

c:

^error⁼PutStr(str) LONG PutStr(STRPTR)

ML:

Arguments:

Result:

OBln

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

OBSBIII

Description:

Library:

Offset:

Syntax:

ML:

Arguments:

Result:

=

PutStr(dl) str = string to write

error

=

nonzero if unsuccessful

queues a blitter request graphics.library -$114

QBlit(bp)

VOID QBIit(struct bltnode *) QBlit(al)

=

initialized bltnode structure none

Library Functions

queues a blitter request that is linked to the video beam's position graphics.library

-$126 QBSBlit(bsp)

VOID QBSBlit(struct bltnode *) QBSBlit(al)

bp = initialized bltnode structure none

OuervOVerscan (Revision 2.0)

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

RawDoFmt

Description:

Library:

Offset:

Syntax:

C:

ML:

checks how large a system-legal overscan screen may be intuition.library

-$1DA

success = QueryOverscan(displayID, rect, oScanType) LONG QueryOverscan(ULONG, struct Rectangle *, WORD) dO = QueryOverscan(aO, aI, dO)

displayID = desired display mode-see <graphics/displaymodes.h>

rect = Rectangle structure to receive data

oScanType = type of overscan mode-OSCAN_TEXT ($0001), OSCAN_ST ANDARD ($0002), OSCAN_MAX ($0003), OSCAN_ VIDEO ($0004)

success = zero if unsuccessful

formats data into a character stream exec.library

-$20A

nextData = RawDoFmt(formatString, dataStream, putChProc, putChData);

APTR RawDoFmt(STRPTR, APTR, VOID (*)( ), APTR) dO = RawDoFmt(aO, aI, a2, a3)

Mapping the Amiga

Arguments: fonnatString = a template string similar to that used by C's printf() dataStream = the data to fonnat

putChProc = function called to output each character

putChData = user data passed to the putChProc along with each character Result: nextData = a pointer to the end of dataStream; valid under Revision 2.0 only Read

Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

reads bytes of data from a file dos.library

-$2A

actualLength = Read(fh, buffer, length) LONG Read(BPTR, VOID *, LONG) dO

=

Read(dI, d2, d3)

fb = filehandle of file from which to read buffer = input buffer to receive data

length

=

number of bytes to read; may not exceed buffer size actualLength = actual number of bytes read

ReadArgs (Revision 2.0) Description:

Library:

Offset:

Syntax:

C:

ML:

Arguments:

Result:

parses command line input dos.library

-$31E

result = ReadArgs(template, array, rdargs)

struct RDArgs *ReadArgs(STRPTR, LONG *, struct RDArgs *) dO

=

ReadArgs(dl, d2, d3)

template

=

fonnat string

array = array of longwords to hold results, one per template entry

rdargs = optional rdargs structure (as returned by AllocDosObject()) to hold options result

=

an initialized RDArgs structure; zero if unsuccessful

ReadChunkBytes (ReviSion 2.0)

Description: reads bytes from the current chunk Library: iffparse.library

Offset: -$3C Syntax:

C:

ML:

Arguments:

Result:

actual = ReadChunkBytes(iff, buf, numBytes)

LONG ReadChunkBytes(struct IFFHandle *, APTR, LONG) dO = ReadChunkBytes(aO, aI, dO)

iff = an IFFHandle structure buf = buffer to receive data

numB ytes = number of bytes to read

actual = number of bytes actually read, if successful;

negative error value if unsuccessful

Library Functions

Dans le document Mapping Amiga® the (Page 181-187)