| LOADSHAPE | |
| Syntax | LOADSHAPE filename LOADSHAPE filename.ext (LOADSHAPE) LOADSHAPE type-descriptors |
| Explanation | LOADSHAPE loads the specified file from
the disk and sets the shape of all active turtles to that
image. Note that the file still exists on the disk; only
a copy of it has been transferred to the workspace.
Turtle shapes are normally black-and-white bitmaps with a
size of 31x31 dots. If the loaded bitmap is bigger or
smaller, it is scaled to a size of up to 31x31 dots and
converted to black-and-white. White areas of the bitmap
are made transparent, while all other colors make up the
turtle shape. LOADSHAPE can load JPEG format or Windows bitmaps (.BMP) files.The Macintosh version can also load Macintosh PICT files. If no extension is given to the filename, the picture format that is loaded is the format specified in the built-in variable PICTURE.FORMAT. If the file has a different extension, then the extension must be specified in the LOADSHAPE command. LOADSHAPE is also capable of displaying a standard file open/save dialog box. In order to open a dialog box instead of a file, the file name contains a list of file type descriptors. A file type descriptor is a file type, optionally followed by an "=" and a description. The text "JPG=JPEG files" would be a vaild file type descriptor for all files ending with ".JPG". More than one file descriptor may be supplied; in this case, separate the descriptors with commas. The file open/save dialog would display all files ending with the given file type. A Windows dialog would also display the description of the file types, while a Macintosh dialog would display the matching files only. The Logo command LOADSHAPE "|JPG=JPEG files,BMP=Windows bitmaps| would, for example, display all files ending with .JPEG or .BMP. If you use "*" as a file type, the file open/save dialog displays all available files. This is done differently on Windows and the Macintosh. A Windows dialog would initially display all files with the first type, and offer all additional file types as choices. The Macintosh dialog would always display all files matching all file types. If you do not supply a file name, Logo automatically opens a file open/save dialog displaying all available files. Clicking the Cancel button in a file open/save dialog causes the LOADSHAPE command to stop. See also SAVESHAPE. |
| Examples | LOADSHAPE
"ToolBox/Shapes/moose
|