SETTURTLEMODE

Synopsis
SETTURTLEMODE mode
Description

Sets the current bitmap mode for the currently selected turtle to mode. The mode input must be a number from 1 to 9. The meaning of each value is given by the following table:

ModeMeaning
1Take copy of memory then copy to screen
2Take copy of memory OR with copy of screen then copy to screen
3Take copy of memory AND with copy of screen then copy to screen
4Take copy of memory XOR with copy of screen then copy to screen
5Take copy of memory AND with invert of screen then copy to screen
6Take invert of memory then copy to screen
7Take copy of memory OR with copy of screen then invert to screen
8Take invert of memory OR with copy of screen then copy to screen
9Take invert of screen then copy to screen

SETTURTLEMODE only works if the selected turtle is currently bitmapped (as with BITMAPTURTLE). It enables bitmapped turtles to paste their images in different ways. Sometimes you want the background erased and sometimes not. Sometimes you wish to invert the image before pasting it and sometimes not.

Use SETTURTLE to select a different turtle.

Use TURTLEMODE to obtain the selected turtle's mode.

Use BITMAPTURTLE to map a turtle to a bitmap.

SETTURTLEMODE has no effect if the selected turtle is not currently bitmapped. It is an error to run SETTURTLEMODE on a turtle that was bitmapped with a rotating bitmap.

Example
; Fill the screen with white
SETSCREENCOLOR [255 255 255]
CLEARSCREEN

; Draw a circle and fill it with red
PENDOWN
CIRCLE 50
SETFLOODCOLOR [255 0 0]
FILL

; Copy the red circle to the clipboard
PENUP
SETXY -50 -50
BITCOPY 101 101

; Use a simple copy for the turtle's mode
BITMAPTURTLE

; fill the screen with yellow
SETSCREENCOLOR [255 255 0]
; Notice that the white corners show up when using the default turtle mode

; Set the turtle mode to AND the image onto the background
SETTURTLEMODE 3
; Notice that the white corners disappeared

SourceForge.net Logo