home *** CD-ROM | disk | FTP | other *** search
- <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
- <html>
-
- <head>
- <meta http-equiv="refer" content="file:coolcalc.htc">
-
-
-
- <title>Customizing CoolCalc</title>
- </head>
-
- <body bgcolor="#FFFFFF">
-
- <h2>Customizing CoolCalc</h2>
-
- <p>This section answers the following questions:</p>
-
- <dl>
- <dt>I want to customize CoolCalc. Where do I start?<br>
- How do I create a macro?<br>
- What is a layout anyway? <br>
- How do I manipulate layouts? (Run Mode vs. Program Mode)<br>
- How do I reposition and resize buttons in a layout?<br>
- How do I assign a different function to a button, or
- change the appearance of a button?<br>
- How do I add a new button?<br>
- How do I delete a button?<br>
- What's the difference between Macros and Layouts? How are
- they alike?<br>
- How do I edit a Macro or a Layout?<br>
- How do I change the fonts in a layout?</dt>
- </dl>
-
- <h3>I want to customize CoolCalc. Where do I start?</h3>
-
- <blockquote>
- <p>CoolCalc is more that just a bunch of nicely linked
- together screens that do basic calculations, it is also a
- programming environment for you to create your own
- calculations and screens. You can create macros (memorized
- sequences of buttons), and make them run with a single button
- press. You can add new buttons, delete buttons, and move and
- resize buttons. And best of all, you can do all of this right
- from your HPC, without having to be linked to a PC or write
- software in a computer language such as Basic or C.</p>
- </blockquote>
-
- <h3>How do I create a macro?</h3>
-
- <blockquote>
- <p>Let's say you're travelling to England from the U.S., and
- you have to convert English pounds to American dollars. You
- wish to set up a special key on your Business Calculator to
- make this calculation for you. The exchange rate is currently
- 1.625 pounds for every dollar. </p>
- <p><strong>Here's how to create this sample macro:</strong></p>
- <ol>
- <li>Go to the Business Calculator from the main menu.</li>
- <li>Enter a starting value for pounds, say 5. This is
- used as a sample value for creating the macro.</li>
- <li>From the menu bar at the top of the screen, select
- Macro, then Record Macro.</li>
- <li>Enter a name for the macro; let's call it pounds.</li>
- <li>Now, we start the calculation. Tap the division key,
- then tap 1.625, then =. The value you see is 3.08, or
- 5 pounds in dollars.</li>
- <li>From the menu, select Macro, then End Record Macro.</li>
- <li>Next, you will be asked "Want to assign next
- button pressed to recorded macro?" Tap Yes.</li>
- <li>Tap any blank button. The macro we just recorded is
- now attached to that button. To test it, enter 10,
- then tap the pounds button. You should see 6.15 in
- the display.</li>
- <li>Tap the home button. You will see a message
- "Current Layout has changed. Do you wish to save
- it before continuing?" If you want to
- permanently have the pounds macro attached to the
- button you selected, answer yes. However, since very
- few of you will be travelling to England in the near
- future, and the exchange rate is bound to change, you
- should answer no.</li>
- </ol>
- </blockquote>
-
- <h3>What is a layout anyway? </h3>
-
- <p>A layout refers to the appearance of individual screens, i.e.
- the size and position of various buttons, and what functions are
- assigned to them. CoolCalc has built-in tools to allow you to
- easily change the assignment of various buttons, and move those
- buttons around.</p>
-
- <h3>How do I manipulate layouts? (Run Mode vs. Program Mode)</h3>
-
- <blockquote>
- <p>On the top menu bar, select View, then select Program
- Mode. Now, tap any button on the screen. You'll notice that
- the button gets a large border around it, but nothing else
- happens. This large border around the button on the left side
- means that the button is selected. Experiment: tap other
- buttons to select them. You'll notice that only one button at
- a time can be selected. In this mode, you can reassign and
- reposition all buttons, as well as add or delete buttons.</p>
- </blockquote>
-
- <h3>How do I reposition and resize buttons in a layout?</h3>
-
- <blockquote>
- <p>Once you enter Program Mode from the View menu selection,
- you can reposition buttons as follows:</p>
- <ul>
- <li><strong>To select a button:</strong> Tap the button
- which you wish to move or resize. A large border will
- appear around the button, indicating that it is
- selected.</li>
- <li><strong>To move a button: </strong>Place the stylus
- in the center of the selected button, and drag the
- button around the screen. You can also use the arrow
- keys to move the selected button.</li>
- <li><strong>To resize a button:</strong> Place the stylus
- on the edge of a button, and drag the edge around.
- You can also hold down the shift key, and use the
- arrow keys to resize the button.</li>
- <li><strong>To align other buttons with the selected
- button:</strong> Say you want to align other buttons
- with the top of a "master" button. Select
- the "master" button, then select Align from
- the menu, then select Top. From now on, any button
- you press will be aligned with the top of the
- "master" button. IMPORTANT: When you're
- done aligning, select Align from the top menu, then
- select Off.</li>
- <li><strong>To undo any button movement:</strong>
- Occasionally you will move or align a button you
- didn't want to. If this happens, select Edit, then
- Undo Move from the menu. You can undo the last 100
- button moves.</li>
- </ul>
- </blockquote>
-
- <h3>How do I assign a different function to a button, or change
- the appearance of a button?</h3>
-
- <blockquote>
- <p>In Program Mode, hold down the Alt key and tap a button.
- You will be presented with the button properties dialog.</p>
- </blockquote>
-
- <blockquote>
- <p>Here's what the various dialog fields do:</p>
- </blockquote>
-
- <blockquote>
- <ul>
- <li><strong>Function:</strong> This allows you to attach
- a function to the button. The functions are described
- in the Function Reference section. Calculator
- specific functions such as "plus" or
- "minus" always start with a letter from
- "a" to "z". Other functions, such
- as "_PlayMacro", start with the
- "_" character. This was done to separate
- layout functions from calculator functions.</li>
- <li><strong>Parameter:</strong> Some functions require a
- parameter. For example, the _PlayMacro function needs
- the name of the macro to play.</li>
- <li><strong>Alt. Keycap: </strong>This field lets you
- dictate how you want the button to appear. If you
- leave this field blank, then a default value will be
- used. If the Format field is "Text", then
- the text string you specify here will appear on the
- button. If you set the Format to "Bitmap",
- then the bitmap file (*.2bp) image will appear on the
- button. </li>
- <li><strong>Font: </strong>You can select a small, medium
- or large font to draw the text on the button. The
- small, medium and large fonts can be changed by the
- Edit command from the top menu bar while in Program
- Mode.</li>
- <li><strong>Align: </strong>You can have the button text
- or bitmap image aligned left, center, or right.</li>
- <li><strong>Format:</strong> This is the format for the
- button, it can be Money, Text, Real Number, Integer,
- or Bitmap. Most of the time, you will want to have
- this set as Text or Bitmap. Money, Real Number and
- Integer are used with the _Variable or _Display
- functions.</li>
- <li><strong>X, Y, Width, Height: </strong>These specify
- the position and size of the button. You can also
- change the position and size by dragging the button,
- or the edge of a button.</li>
- </ul>
- </blockquote>
-
- <p> </p>
-
- <h3>How do I add a new button?</h3>
-
- <blockquote>
- <p>In Program Mode, select Edit, then New Button from the top
- menu. Then, tap where you wish the new button to be placed.</p>
- </blockquote>
-
- <h3>How do I delete a button?</h3>
-
- <blockquote>
- <p>In Program Mode, select the button you wish to delete.
- Next, select Edit, Delete Button from the top menu. If the
- button is not blank, you will be asked to confirm deletion of
- the button.</p>
- </blockquote>
-
- <h3>What's the difference between Macros and Layouts? How are
- they alike?</h3>
-
- <blockquote>
- <p>Despite being used somewhat differently, macros and
- layouts share some common similarities. Both are sequences of
- commands, both are stored in files that end in .mac, and both
- can be edited using the macro editor. When you press one of
- the buttons in the main menu (for example, the Business
- Calculator), you are really running a macro that erases all
- of the current buttons, draws new buttons, and sets various
- things such as the small, medium and large fonts, the real
- number precision, and other things. When you select File,
- Save from the top menu, this command writes a series of
- commands to a macro file that will recreate the screen as it
- currently looks. Likewise, when you select File, Open from
- the top menu bar, a macro is run which erases all the buttons
- on the current screen, and redraws the screen.</p>
- </blockquote>
-
- <h3>How do I edit a Macro or a Layout?</h3>
-
- <blockquote>
- <p>In Program Mode, select Macro, Edit Macro from the top
- menu. From there, you can open a <strong>.mac</strong> file
- with the name of the macro or layout file. The macro editor
- is a simple text editor; you need to make sure everything is
- spelled correctly, and there are no extra space characters.
- (If you run a macro with a misspelled function name, you will
- get a warning.) The <a href="function.htp">Function Reference</a>
- section has details on all of the available functions.</p>
- </blockquote>
-
- <h3>How do I change the fonts in a layout?</h3>
-
- <blockquote>
- <p>From the top menu in Program Mode, select Edit, then Small
- Font, Medium Font, or Large Font. You can change the
- typeface, size, and specify bold or italic for the font.</p>
- </blockquote>
- </body>
- </htm