 Acrobat file (185K) |  ClarisWorks 4 file (62K) |  QuickView file (473K) |
| Acrobat file (185K) | ClarisWorks 4 file (62K) | QuickView file (473K) |
| Technote 1005 | OCTOBER 1995 |
This Technote explains how to use SimpleText to create Release notes and ReadMe files, complete with pictures and sound, even QuickTime movies.
The primary purpose of this Technote is to show you how to create read-only Release notes. This Note also showcases some of the new features that have been added to SimpleText 1.3.
This Note assumes familiarity with ResEdit.
Contents
SimpleText supports Drag & Drop, which simplifies the creation of documents by allowing passages to be moved around visually instead of the old copy and paste method.
SimpleText's possibly greatest feature is that it allows developers to create Read-only Release notes that include text, pictures, and sound.
SimpleText checks the file type of text documents to determine if they are modifiable or if they should be opened as read-only, allowing the user to scroll through the document or print its contents, but not to modify it. If the file type is "TEXT" (the default file type for documents created by SimpleText) then the file is modifiable. If the file type is "ttro", the file is read-only.
Sound can be in modifiable (type "TEXT") or read-only (type "ttro") documents. You are limited to only one sound per document, however. SimpleText will record up to 24 seconds of sound with its minimum memory partition of 192K or with any other size memory partition. Increasing the size of the memory partition does not allow you to record more sound. If you need to record more than 24 seconds of sound, you will need to use another program and paste the sound into the document using ResEdit. SimpleText will play any length sound, as long as it has enough memory to do so. If you install a sound that is longer than 24 seconds, set SimpleText's memory partition to the size of the sound plus at least 100K.
The sound is stored as 'snd ' resource number 10000; it is not marked as purgeable by SimpleText. Twenty-four seconds of 22.254Khz sound is 90K. Having a sound, of any length, embedded in your document will increase the loading time of the document slightly.
To add sound to a document: open the document with SimpleText, go to the Sound menu and choose Record. The following dialog box appears as shown in Figure 1.
Input is from the Input source selected in the Sound control panel. Simply begin recording and save the document when you are done.
If you want to put more pre-production into your sound, or have a longer sound embedded in the document, you need to have a 'snd ' resource that you can paste into the document using ResEdit. Set the resource ID to 10000, save it and you are done.
Once a sound is added to a document, all that is required to play the sound is for the user to select Play from the Sound menu. You will probably want to have a line of text in your document that alerts the user to the fact that there is a nifty audio clip available, and to hear it, they need to choose Play from the Sound menu.
This feature is meant to allow users to view a QuickTime movie if they do not have MoviePlayer; it is not intended to replace MoviePlayer, and as such does not allow for any type of editing (i.e., no Cut, Copy, or Paste).
SimpleText can also speak only the selected text: select the text you want spoken and choose Speak Selection from the Sound menu.
"ttro"). A document's pictures are stored as purgeable 'PICT' resources in the resource fork of the document. Whenever a file is opened, each of these picture resources is loaded in numerical order, and its size is read into an array (so SimpleText can later test to see if a picture needs to be drawn into the window without loading the picture). After the picture resources are loaded (and every time the window is resized thereafter), SimpleText scans the text of the document for non-breaking space characters (ASCII $CA, entered as Option-Space Bar and usually used instead of a space to prevent related words from being split across line boundaries). In SimpleText documents, a non-breaking space character represents the line on which the top of a picture resides. Figure 2 illustrates this relationship.
If there are more non-breaking space characters than 'PICT' resources, SimpleText ignores the extra non-breaking spaces. Likewise, if there are more 'PICT' resources than non-breaking space characters, SimpleText ignores the extra 'PICT' resources. Every time an update event occurs, SimpleText checks each picture in the array, and if any of the pictures in the array overlap the current update region, it draws that picture.
As it happens, TextEdit is particularly messy about redrawing large portions of the screen when a user is entering text, and this makes editing documents with pictures rather clumsy. Since resizing the window causes another scan for non-breaking space characters as well as an update event, sizing the window in any way causes SimpleText to ``refresh'' the pictures.
"TEXT"). You can even use SimpleText if you so desire. Don't put carriage returns after each line either, since SimpleText automatically wraps lines, just like a real word processor (the SimpleText window conforms to the size of the current screen, so don't depend on the breaks you see either). Don't worry about non-breaking space characters at this point either; you'll get a chance to add them later. Just think about what pictures you want (if you want them at all) and in what order you want them. When you are finished with the text, save it as a text-only file. If your word processor gives you the option of putting carriage returns after lines or after paragraphs, choose the after paragraphs option.SimpleText now lets you use different fonts, sizes and styles in your documents. No longer are you held captive to only one font. Be brave, spice up your document, this is a Mac, not a VT100. Just remember that people actually have to read this document, so don't make it so cluttered with fonts and sizes that it's illegible. Also stick to the standard fonts like Times, Helvetica, and Geneva, since if the font is not installed on the reader's system, the text will end up in Geneva.
Unfortunately, the ideal method for creating a picture involves both a paint program and a draw program. Once you are finished with your pictures, save them to a document, then do one of the following:
1. If you used a painting program to draw your pictures:
Because of a quirk in the Printing Manager and PostScript(R), you have to perform a few more steps.
Open your Scrapbook file (the one with all the pictures in it). Its ResEdit window should contain a 'PICT' resource along with some others. Select 'PICT' (don't double-click), and copy this resource to the SimpleText document by bringing its window to the front and selecting Paste from the Edit menu. If you do this step correctly, your pictures and text should all be in the same document. Save the SimpleText document so you don't have to do this step again and close the Scrapbook.
Now you need to put the pictures into the proper numerical order so they show up in the correct order in the SimpleText document. Numbering starts at 1000 (i.e., first picture should be 1000, second picture 1001, etc.). To order these pictures, double-click on the 'PICT' in the SimpleText document's window. You should get another window which contains each of the pictures you copied into this document. Use the scroll bar until you find the first picture you want to appear in the document. Select it (by clicking on it once), and choose the Get Info or Get Resource Info option to get information on the resource. ResEdit displays an information window about the selected resource with space to enter a name and an ID (there is already a random ID number assigned). Change the ID to 1000 and give the picture a name too (i.e., ``Figure 1'', etc.). Near the bottom of this window you can see the resource attributes. Be sure that the ``Purgeable'' attribute is checked, then close the window. Repeat this process for each succeeding picture, giving each a successive number (i.e., 1001, 1002, 1003, etc.). When you are finished with all of the pictures, save the file and quit ResEdit.
That's the difficult part; the rest is icing. Go get some more coffee or whatever it is you are drinking.
Now resize the window, and voilà, when the window redraws, your picture will be just below the non-breaking space character. Now enter as many carriage returns as necessary to provide space for the picture. When you enter the first carriage return, SimpleText will erase the picture, so you will need to resize the window again to verify your spacing, clicking the zoom box works well.
Once you have enough room for the first picture (you probably want to leave an extra blank line or two after it too), move on to the next desired picture location and repeat the process. Continue this process (and don't forget to save the document along the way) until you have placed all of the pictures. When you finish placing the pictures, you should save the document again and try printing it on both an ImageWriter and LaserWriter if possible. You may wish to tweak the picture spacing or location to keep them from crossing printed-page boundaries.
When you are satisfied with the results, Quit SimpleText.
"TEXT" to "ttro" (the lowercase is significant) and check to make sure the creator type is "ttxt". Now quit ResEdit and save the changes to the document when prompted.That's all there is to it.
PICT' resources to the non-breaking space characters in the document, you can simply skip a resource number to use a non-breaking space character as a non-breaking space in the text. For example, if you had four non-breaking spaces in the document and you wanted pictures at the first, second, and fourth, you would number your 'PICT' resources 1000, 1001, and 1003. The third non-breaking space character would normally have 'PICT' resource 1002 assigned to it, but since there is not a resource with this ID, it simply acts as a non-breaking space in the document. PICT' list and choose Open Picker by ID from the Resource menu of ResEdit 2.x. You should get a window with a list of all of your pictures, in order, and numbered sequentially from 1000. If this is not what you get, then you have missed a step along the way and need to make sure all your pictures are in the resource and numbered sequentially. In October, 1995, this Technote was updated to SimpleText 1.3 rather than TeachText.