| show | Show information about defined objects |
| status | Show current state of SAWDUST (maximum number of objects, current range, etc.) |
| delete | Delete one object |
| forget | Delete all objects |
The show command displays information about current defined objects:
* show # type the command 'show'
Show What? : all # show everything
defined objects:
e0 e1 e2 e3
l1 l2 t1 v1
e4 e5 e6 e7
l3 l4 l5
8 elements, 5 links, 0 merges, 0 mingles, 1 vary's, 1
turns
15 total
Show What? : l3 # what else to show? a link
l3 Link
Expand sub-objects? (y/n) y # now show the link's parts
e4 Element 1500a, 55s
e5 Element 2500a, 45s
e6 Element 3500a, 35s
e7 Element 500a, 25s
275 statements 160 samples
Show What? : # a blank line ends the 'show'
* # back to Sawdust's prompt.
The status command tells you the current state of Sawdust:
* status # type the 'status' command Rate = 44100 Auto-seed : 0 Cutrate : 500.000000 Exact-vary : OFF Limits: Amp Range Objects Ele/Link Ele/Vary Max: 4095 280 100 24 Min: 0 *
The variables Rate and Limits, are general and apply to all the commands in Sawdust. They tell you:
| Rate | Sawdust's sampling rate (44100 samples per second) |
| Limits | The current capacities of Sawdust: |
| The amplitude range is 0 to 4095 (can be reset by range). | |
| The maximum number of objects that Sawdust can handle in one session: 280. | |
| The maximum number of elements that can be in a link: 100. | |
| The maximum number of elements that can be in a vary: 24. |
The following variables are specific to vary, and do not affect the other commands:
| Auto-seed | The current random number seed. This can be set by the command seed |
| Cutrate | Specifies the number of points along the polynomial to be sampled when looking for |
| its minimum and maximum values. Cutrate can be set by the command vquick. | |
| Exact-vary | Whether vary will play the exact time requested or not. |
| It can be set with the exact command. |
The delete command deletes one object from Sawdust's memory. Sawdust won't let you delete an object if it is currently being used by another object, i.e., you can't delete an element if it's being used by a link.
* delete # type the 'delete' command name: e1 # delete 'e1' e1 is used by other objects; cannot delete. # Sawdust won't let you name: e2 # delete 'e2' e2 is used by other objects; cannot delete. # Sawdust won't let you name: e8 # e8 can be deleted safely name: f1 # but f1 doesn't exist. not defined: f1. name: / # end the delete command * # back to Sawdust's prompt
The forget command deletes ALL the objects in Sawdust's memory. It will ask for confirmation before deleting everything.
* forget # type the 'forget' command This command deletes all currently defined objects. delete all objects? y # ask for confirmation * # back to Sawdust's prompt