NAME

mac - Macintosh Utility Routines for ImageMagick


SYNOPSIS

BottleneckTest(picture,codec,depth,colormap_id)

Exit(status)

FilenameToFSSpec(filename,fsspec)

MACSystemCommand(command)

image=ReadPICTImage(image_info)

SetApplicationType(filename,magick,application)

closedir(entry)

opendir(entry)

readdir(entry)

seekdir(entry,position)

telldir(entry)


FUNCTION DESCRIPTIONS


BottleneckTest

Method BottleneckTest intercepts any compressed images.

The format of the BottleneckTest routine is:

        BottleneckTest(picture,codec,depth,colormap_id)

A description of each parameter follows:

picture:

Specifies a pointer to a PicHandle structure.

codec:

The code type is returned in this CodecType pointer structure.

depth:

The image depth is returned as an integer pointer.

colormap_id:

The colormap ID is returned in this short pointer.


closedir

Method closedir closes the named directory stream and frees the DIR structure.

The format of the closedir routine is:

        closedir(entry)

A description of each parameter follows:

entry:

Specifies a pointer to a DIR structure.


Exit

Method Exit exits the process.

The format of the Exit routine is:

        Exit(status)

A description of each parameter follows:

status:

an integer value representing the status of the terminating process.


FilenameToFSSpec

Method FilenameToFSSpec sets the file type of an image.

The format of the FilenameToFSSpec routine is:

        FilenameToFSSpec(filename,fsspec)

A description of each parameter follows:

filename:

Specifies the name of the file.

fsspec:

A pointer to type FSSpec.


MacGSExecuteCommand

Method MacGSExecuteCommand executes the Ghostscript command.


MacGSLaunchApplicationCore

Method MacGSLaunchApplicationCore launches the Ghostscript command.


MacGSLaunchApplication

Method MacGSLaunchApplication launches the Ghostscript command.


MacGSLaunchApplicationToFront

Method MacGSLaunchApplicationToFront moves the Ghostscript window to the front.


MacGSQuitApplication

Method MacGSQuitApplication quits the Ghostscript application.


MacGSSetWorkingFolder

Method MacGSSetWorkingFolder set the Ghostscript working folder.


MACSystemCommand

 Method MACSystemCommand executes the specified command and waits until it

 terminates.  The returned value is the exit status of the command.

The format of the MACSystemCommand routine is:

        MACSystemCommand(command)

A description of each parameter follows:

command:

This string is the command to execute.


MACWarningHandler

Method MACWarningHandler displays a warning message.

The format of the MACWarningHandler routine is:


opendir

Method opendir opens the directory named by filename and associates a directory stream with it.

The format of the opendir routine is:

        opendir(entry)

A description of each parameter follows:

entry:

Specifies a pointer to a DIR structure.


ProcessPendingEventsi

Method ProcessPendingEvents processes any pending events. This prevents ImageMagick from monopolizing the processor.

The format of the ProcessPendingEvents routine is:

    ProcessPendingEvents(text)

A description of each parameter follows:

text:

A character string representing the current process.


readdir

Method readdir returns a pointer to a structure representing the directory entry at the current position in the directory stream to which entry refers.

The format of the readdir

        readdir(entry)

A description of each parameter follows:

entry:

Specifies a pointer to a DIR structure.


ReadPICTImage

Method ReadPICTImage reads an Apple Macintosh QuickDraw/PICT image file using MacOS QuickDraw routines and returns it. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

This routine was written and contributed by spd@daphne.cps.unizar.es (feel free to copy and use it as you want. No warranty).

The format of the ReadPICTImage routine is:

        image=ReadPICTImage(image_info)

A description of each parameter follows:

image:

Method ReadPICTImage returns a pointer to the image after reading. A null image is returned if there is a a memory shortage or if the image cannot be read.

image_info:

Specifies a pointer to an ImageInfo structure.


SearchForFile

Method SearchForFile searches for a file.


seekdir

Method seekdir sets the position of the next readdir() operation on the directory stream.

The format of the seekdir routine is:

        seekdir(entry,position)

A description of each parameter follows:

entry:

Specifies a pointer to a DIR structure.

position:

specifies the position associated with the directory stream.


SetApplicationType

Method SetApplicationType sets the file type of an image.

The format of the SetApplicationType routine is:

        SetApplicationType(filename,magick,application)

A description of each parameter follows:

filename:

Specifies the name of the file.

filename:

Specifies the file type.

application:

Specifies the type of the application.


telldir

 Method telldir returns the current location associated  with  the

 named directory stream.

The format of the telldir routine is:

        telldir(entry)

A description of each parameter follows:

entry:

Specifies a pointer to a DIR structure.