Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Appendix A - Newton Toolkit Enhancements / Functions

/

MakeDitheredPattern

MakeDitheredPattern(bwPattern, foregroundColor, backgroundColor)

Creates a dithered pattern.

bwPattern

A one-bit pattern. A pattern is a binary object containing an 8x8 bitmap of class 'pattern. The constants vfWhite, vfLtGray, vfGray, vfDkGray, and vfBlack specify patterns in the Newton OS ROM.

foregroundColor

A kRGB_GrayXX constant or a packed RGB integer returned by *PackRGB.

backgroundColor

A kRGB_GrayXX constant or a packed RGB integer returned by *PackRGB.

return value

A dithered pattern frame as defined in "Dithered Pattern".

DISCUSSION

Using this function, as opposed to creating your own frame ensures that the frame shares a frame map with other dithered pattern frames.

SEE ALSO

For an example use of this function, see "Dithered Patterns".