The documentation you are reading may be old. To find the latest version of ChipNSil, enter the following command in a Command Tool viewer [the ® symbol stands for the version number of the current Cedar release. If you do not know it, type Version in a Command Tool viewer]:

If you are confused, locate a DA tool implementor or a designer and ask him what the current version is.

Suppose you determined that the latest version has the number 21. To get the files onto your disk type in the Command Tool viewer:

The next thing you need to do, is to load the program into memory. To do that simply type:

ChipNSil responds opening a viewer labelled "Terminal". It will be used for messages and prompts.

Fine point: Once you have started to use a particular Command Tool viewer, you should always use the same. This is to be sure that all you need is in the same working directory.

Case 1: you got an existing ChipNSil file you should edit. The command to be entered in the Command Tool viewer to read it is:

Case 2: you want to create a new file: type in the Command Tool viewer:

Case 3: you want to work on a Sil file. ChipNSil will convert the file to his format and allow you to edit it. However, you will not be able to produce an updated Sil file. The command is:

In each of these cases ChipNSil will react in the same way. It opens a viewer for the drawing (either on the color screen or on the left of the black and white screen) and a small control panel viewer on the bottom right of the screen. Now you can start editing.

If the above did not happen, look in the Terminal viewer for an explanation.

The mouse buttons have the following fixed meaning:

If you do not move the mouse while you select, ChipNSil marks selected the closest object it can find. If you have several objects cluttered one above the other, keep the mouse button pressed and hit the space bar until ChipNSil marks selected the object you want.

Of course, if you move the mouse while you select, everything inside the rectangle is selected.

Look at the control panel. In the second line you see a list of colors. To select the color in which subsequent input will be drawn, click the middle (yellow) mouse button on the color name. ChipNSil responds writing this color name on the first line ("current layer").

The numbers below the color names are the thicknesses in which subsequently specified lines are drawn. Each color has an own value, and when a color is chosen, then its own thickness is used. To increase the thickness of a color, hit the left (red) mouse button on its name. Similarly the right (blue) mouse button makes the subsequently specified lines thinner.

To draw arbitrary rectangles, set the thicknesses of the color to 0.

On the control panel you find a line which starts with the word "font". Place the cursor on it and hit any mouse button. A menu pops up. Select a font for the subsequent text input and ChipNSil writes its name right after the word "font".

To actually write some text, hit the "T" key while you press the middle mouse button. Now look in the Terminal viewer. ChipNSil is prompting you for a string, terminated by a "RETURN".

If you just want to replace an existing text, but keep its attributes (font and color), hit the "Q" key while selecting.

Similarly you can just change the font of some text hitting the "F" key while selecting. If there is a lot of text that should get the same font, just go ahead and select the whole area; ChipNSil is not bothered if also lines are selected. The new font is the one you last selected in the control panel.

That is easy. Just keep the "CTRL" key pressed while moving the mouse with the appropriate selection key down.

If instead of "CTRL" you keep the "SHIFT" key pressed, the selection is copied.

Or instead you can keep the "TAB" key pressed. This causes the object to be stretched. (Text cannot be stretched).

To delete, select the objects and the hit "CTRL""D". If you made a mistake and want your stuff back, just press "ESC""D".

To enlarge what you see (zoom in), hit the comma key. To zoom out hit the period key.

To move around the drawing without changing the scale, keep the space bar pressed while you move the mouse with the middle button pressed.

If you want to see a certain area in greater detail, keep the space bar pressed while you move the mouse with the left button pressed.

If you want to see a certain collection of objects such that they fit best in the viewer, select them and press "CTRL" and the space bar at the same time.

If things are very small, you cannot see them well. Therefore ChipNSil does not bother to draw them as they really are. If you do not like it, press the comma key and the space bar at the same time. A pop up menu allows you to set a new simplification threshold.

Similarly you can change the grid (slash and space) and the ticks (period and space).

If you have problems putting things on your grid, try the following more general command. Hitting the "S" key and the space bar at the same time lets a "special" menu pop up. Select the entry called "move to grid".

One of the things that make ChipNSil powerful, is that it allows you to structure your drawing. If you have several instances of a collection of objects, you can group one of these collections into a cell. You then make instances of the cell. This has the advantage, that when you modify one instance of a cell, the modifications are propagated to all other instances.

Another benefit of cells is that you can put a hierarchical structure on your drawing. A cell that is contained in another cell is called a child of the former. A collection of cells with the same father is a collection of siblings.

To create a cell, select all objects that are to be part of it using the right (blue) mouse button. Now press down at the same time the "X" and "C" keys and the middle (yellow) mouse button. ChipNSil will ask you a name for the cell in the Terminal viewer.

To insert an instance of a cell hold down the "C" key while pressing the middle (yellow) mouse button. Type in the Terminal viewer the name of the cell to be inserted.

Once you have created a cell, you will note that you cannot access the elements in it. All operations (like move or copy) apply to the cell as a whole and not to its contents. The reason is that the contents is one level down in the hierarchy. To access the contents of a cell you have to push into it. This is done by holding down the "C" key while pressing the selection mouse button.

When you are done with the editing in a cell, you commit the modifications and propagate them to all instances with the pop operation. Popping is achieved by pressing "SHIFT""C".

When you convert Alto Sil files to ChipNSil, you obtain a design for each Sil file. If you want to paste them together into a single ChipNSil design, you have to move the stuff from one design to another.

To help you in this operation, the CDReadSil command introduced in the first section collects the objects it finds in a Sil file into a cell. To access a cell in another design, you have to import the design. Choose one design into which you will merge the Alto Sil files; let us call it the result design. Go in one of the other designs and press at the same time "X", the space bar and the right (blue) mouse button. Now go to the result design and press at the same time "X" and the middle (yellow) mouse button. A pop up menu appears which among others contains the name of the design you have chosen for the import; select this menu entry. In the terminal viewer you are asked the name of the cell, which you can read on the black viewer label.

Probably the cell has not been inserted in the exact place it should go. For your convenience the newly inserted cell is automatically selected by ChipNSil and you can use the move command to position it correctly.

Suppose you have two Sil drawings stored in files map1.sil and map2.sil respectively. To combine them into a single design, perform the following operations.