weight watchers calculators

Document Sample
weight watchers calculators Powered By Docstoc
					WWCalc V4.0.1 Weight Watchers Calculator and Journal
Installation of WWCalc is as simple as hot-syncing the WWCalc.prc file to your Palm compatible device. The WWCalc program will be installed into the Main category of the PalmOS Launcher as shown below. Note: Older versions of PalmOS seem to ignore the application-preferred category and tend to install all applications in the Unfiled category. If, after installing, you are unable to locate the WWCalc icon try looking in Unfiled.
Launcher Main Category.

WWCalc icon.

The minimum requirements for running the WWCalc program are:   PalmOS version 3.0 or later. 150K of free RAM.

WWCalc is a PalmOS program designed to assist people following the Weight Watchers Winning Points program. The features include a set of calculators and a journal allowing POINTs progress to be easily tracked. Neither the WWCalc program nor this document attempt to explain the POINTs program. For information in this area please see the Weight Watchers site http://www.weightwatchers.com or ask your WW Leader.

Main Screen
The WWCalc main screen provides quick access to all the features of the program. Figure 1 shows the major controls of the main screen.

12) Remaining points for the selected day.

13) Notes indicator icon. 11) Current bank value.

1) Title bar displaying selected day‟s date. 10) Point and bank adjustment controls.

2) Activity points.

3) Vitamin checkbox.

9) Food item table displays item description, point value, and meal designation.

8) Scroll buttons for the food item table.

4) Counters for Water, Vegetable/Fruit, and Milk intake.

5) Current weight.

6) Counters for points by meal. Breakfast, Lunch, Dinner, Snack.

7) Quick access buttons for List DB Lookup, Points Calc, BMI Calc, Activity Calc, and Day Selection.

Figure 1

1) Title Bar
The main screen title bar always displays the date of the selected day. When the program is started this will be the current date but may change as the selected day is changed either via the Go To button or using the weekday controls in the upper right corner of the screen.

2) Activity Points
This control displays the number of points that have been earned during the selected day by exercising. The number of points earned is displayed within the dotted border box, which is called a selector trigger. Tapping on the selector trigger displays the Activity Points dialog allowing the current points to be incremented or replaced. Figure 2 shows the Activity Points dialog of the Activity Log option is disabled. This dialog is backward compatible with older versions of WWCalc. If the Activity Log option is enabled the dialog is Figure 3 is displayed instead. Refer to the section on Activity Log for more information.

Tap i for help with this dialog.

Figure 2

The number of activity points may be directly entered in the Activity Points field or selected from the Select popup trigger. The following buttons may be tapped to take action on this dialog:     Calculate – Bring up the Activity Point Calculator allowing the point value to be determined using activity intensity level, duration, and current weight. Add – Add this point value to the current activity point total. Replace – Replace the current activity point total with the value from this dialog. Cancel – Dismiss this dialog taking no action.

3) Vitamin Check Box
This check box is just an indicator that you have taken you vitamins for the selected day. If you aren‟t taking vitamins … well, stop for a minute and ask yourself why not!

4) Water/Veg/Milk Counters
These counters track the number of items of each category you consume during the day. Tap on the number within the selector trigger to increment the counter by one. The maximum value for each of these counters may be specified on the Preferences dialog. When a counter exceeds the maximum value it returns to zero. In the upper left corner of each counter is a graphic button that may be tapped to decrement the respective counter. These graphics are designed to be as unobtrusive as possible however the tappable area is larger than it appears. The down arrow image is located at the lower right-hand corner of the button so tapping near the top left of the arrow will be in the center of the button. The image below indicates the active area of a decrement button:

5) Current Weight
Your current weight is an important value in many of the feature offered by WWCalc. When WWCalc is started for the first time on the current date your weight is copied from the previous day. To change your weight tap in the selector trigger to bring up the Weight Value dialog as shown in Figure 3. If you would prefer that your weight not be displayed on the main screen you can uncheck the Show Weight check box on the Preferences dialog. The weight selector trigger will then be replaced with a button giving you access to the Weight Value dialog as shown in Figure 4.

Figure 3 - Weight Value dialog

Figure 4 - Show Weight disabled

6) Meal Counters
The meal counters display the number of points consumed for each meal. These counters may be disabled by unchecking the Meal Totals check box on the Preferences dialog. Following are the meanings of the one-letter abbreviations:  B – Breakfast  L – Lunch  D – Dinner  S – Snack Figure 5 shows an example of the results of enabling/disabling the Meal Total feature.

Figure 5a - Meal Totals enabled

Figure 5b - Meal Totals disabled

7) Quick Access Buttons
These buttons allow quick access to commonly used features as follows:  Lookup – Lookup an item in a point database. This feature requires databases created by the ListDB program, which is freely available. Please see the section on using the lookup feature below for additional information on this feature. Point Calculator – Display the POINT calculator allowing point values to be determined from food nutrient values. See the section on using the POINT calculator below for more information. BMI Calculator – Displays the BMI Calculator. Activity Calculator – Displays the Activity Calculator. Go To/Today - This button selects the day to be displayed on the WWCalc main screen. If the selected day is the current date this button has a Go To label and brings up the Palm Select Date dialog to allow selection of a day to be displayed. If the selected day is not the current date this button has a label of Today and tapping it immediately selects the current date.

   

8) Scroll Buttons
These buttons appear when more food items are entered for a day than can be displayed on the main screen. Tapping the up arrow scrolls the food item table up, tapping the down arrow scrolls in the other direction. Note that the hardware scroll button may also be used for this purpose.

9) Food Item Table
This area, which occupies the majority of the screen, is used to display the food item descriptions, point values, and meal designations for the current day. To enter a new item tap on the description area of empty item at the end of the table and enter the description and then tap on the zero to the right of the description to enter the point value. The meal designation will default to the row immediately above the one being entered, if this is the first row the default if breakfast. If the designation is incorrect you may tap on it to pop up a list allowing it to be changed.

10) Point/Bank Adjust Controls
The point/bank adjust feature allows the remaining points and bank values respectively to be adjusted for the current day. Each value may be adjusted in the range of –4 to +10. Unchecking the Enable Adjust check box on the Preferences dialog will disable this feature and remove the controls from the main screen.

Figure 6a - Point/Bank Adjust enabled

Figure 6b - Point/Bank Adjust disabled

11) Current Bank Value
The bank value, assuming the selected day is the current date or a past date, is displayed here. If the selected day is in the future, no bank value is displayed.

12) Remaining Points
The range of remaining points for the selected day is displayed here. These values are calculated using the total points for the food items consumed in the selected day along with your weight value. For information on how the maximum point range is selected see the Set POINT Ranges feature below. If the maximum point range (including adjustments and activity points) is exceeded this value will display as a negative number. For example, if Remaining is displayed as a –2 it means that you have exceeded your daily allotment of points by 2 and, if possible, 2 points have been removed from your bank. The point value displayed can take several forms depending on the number of points used for the selected day and your bank value as follows:    Current total at or below minimum point range: The range of remaining points are displayed, i.e. 5 – 10 Current total above minimum point range but less than or equal to maximum point range: The remaining points are displayed, i.e. 4 Current total above maximum point range, points used from daily bank: The value zero is displayed followed by the number of points the maximum range value was



exceeded by, i.e. 0 (-5). This means that no points remain available except those left in the daily bank and that 5 points have already been drawn from the bank. Current total above maximum point range, daily bank value exceeded: The value of the points remaining adjusted by those withdrawn from the bank is displayed followed by the number of points the maximum range value was exceeded by, i.e. –2 (-7). This means that all daily bank points have been used and the total used exceeds these by 2. The –7 indicates that the maximum point range has been exceeded by 7 points indicating that the daily bank contained 5 points at the start of the day and it currently empty. Current total above maximum point range and bank is empty (or negative): The number of points the maximum point range was exceeded, i.e. –3.

13) Note Indicator Icon
This icon may be tapped to bring up the Notes dialog allowing text to be associated with the selected day. The icon displayed changes to indicate the presence of absence of notes as demonstrated in Figure 7. The Notes dialog may also be accessed via the Notes … item on the Record menu.
No Notes for this day. Now there are Notes.

Figure 7 - Adding Notes to the Selected Day

Menu Items
WWCalc supplies a menu bar with three top-level menus providing selectable options. Some of the options provided are duplicates of features offered from controls on the main screen while others are only available from these menus.

Record Menu

The Record menu provides options, which affect or change the selected day.  Delete – If a food item is currently selected in the item table this option will remove it.  Change Desc – Change the description of the currently selected item. This change is global and will affect all journal entries referencing that item. See the Change Description feature for more details.  Notes – Bring up the Notes dialog allowing comments to be associated with the selected day.  Bank Info – Displays a screen showing how the bank for the selected day was calculated and allows this information to be exported to the Memo Pad. See the Bank Info feature below for more information.  Copy Day – All data on the currently selected day will be copied to the date you select on the date picker dialog presented. If the target date you select already contains data a warning will be issued. If you elect to continue with the copy operation all existing data for the target date will be removed and replaced by the data for the currently selected day.  Export Data – Allows data accumulated with WWCalc to be exported to the Memo Pad in comma separated variable format. Refer to the Export Data feature for more information.  Export Day – Export the information for the current day to the Memo Pad. See the Export feature below for more information.  Export Week – Export the information for the selected week to the Memo Pad. See the Export feature below for more information.  Lookup – Look up a food item in a point database. This is the same as the Lookup button on the main screen. See the Lookup feature for additional information.  Purge – Purge records from the WWCalc database. Refer to the Purge feature for more information.  Goto – Brings up the Palm Select Day dialog allowing a new selected day to be chosen.  Delete Day – Delete all data for the currently selected day. A dialog is presented asking for confirmation prior to deletion of data.

Edit Menu

The Edit menu offers the standard Palm features. Please refer to your Palm documentation for information on these items.

Options Menu

The Options menu offers various program features as well as access to all the Weight Watchers caclulators.  Preferences – Allows setting program options which affect how WWCalc operates. Please see Preferences section below for more information.  Bank Preferences – Settings which affect how the bank is handled. Please see the Bank Preferences section for more information.  Activity Calculator – Calculates point values for various amounts of exercise. See the Activity Calculator feature for more information.  Points Calculator – Calculate point values given food nutrition attributes. See the Points Calculator feature for additional information.  BMI Calculator – Calculate a Body Mass Indicator based on your weight and height. Refer to the BMI Calculator feature for more information.  Set POINT Ranges – Allows the point ranges associated with a weight group to be modified. See the Set POINT Ranges feature below.  Order Entries by Meal – Sorts the journal entries for the currently displayed day by meal designation. The sort order is: Breakfast, Lunch, Dinner, Snack.  Resync Unique Ids – Resynchronizes the unique Ids used to locate item descriptions. These unique IDs are assigned by Palm OS and generally remain unchanged. Some utilities such as database beamers and memory card backup facilities may assign new unique ID to a database. If this happens WWCalc will continue to work but all journal entries will have a description similar to “Unknown food item 2273473”. If this happens selecting this menu option will correct the database.  About WWCalc – Displays a screen showing the version of the WWCalc program.

Features Preferences
The Preferences dialog presents various options available in WWCalc and allows you to specify how you would like the program to operate. Figure 8 shows the Preferences dialog and the following text discusses each of the available options.

Tap i for help with this dialog.

Figure 8 - Preferences Dialog

 Description Lookup – The Description Lookup feature examines the description of food items previously enter and offers matching suggestions as a new item entry is being made. WWCalc offers the following options: 1. No Lookup – The Description Lookup feature is disabled. 2. Lookup Field – As an item is being entered the closest matching description is presented on the same line as the entry. As additional characters are entered the matching description is updated to reflect the new closest match.


Lookup List – As an item is being entered all matching items are displayed in a list under the entry line. This list may be scrolled and an item may be selected from it to complete the entry. Due to bugs in earlier PalmOS versions this feature requires PalmOS version 3.5 or later. If you have an OS version prior to 3.5 selecting this option effectively disables the Description Lookup feature.

 Meal Totals - The Meal Totals check box controls the display of point totals by meal designation. Figure 5 shows the effect of enabling or disabling this feature.  Show Weight – The Show Weight option determines if your weight value is displayed on the main screen. If this option is disabled the weight selector will be replaced with a button allowing access to the Weight Value dialog. Refer to Figure 4 for an example of disabling the Show Weight option.  Enable Adjust – The Enable Adjust feature allows the remaining points and/or the bank value for the current day to be modified. If disabled, the controls permitting adjustment are removed from the main screen. Refer to Figure 6 for an example of the effects of this option.  Cache Meal – This preference determines if the meal designation is cached along with an items point value. If you frequently eat the same items for the same meal this feature can be useful. Otherwise you can disable it to have the meal designation default to that of the item above it in the journal. Note, the first meal designation in the journal for a day defaults to Breakfast if not overridden by the cache.

 Activity Log – This preference determines if the Activity Log feature is enabled. If checked, all activity points are maintained in a log providing visibility to the activity description, duration, and intensity. Refer to the Activity Log section for more information.  Points – This preference determines how point values are displayed. It provides three options: 1. Whole Points – This setting represents all point values as integers. Fractional point values are rounded as follows: .0 - .4  rounded to next lower integer value. .5 - .9  rounded to next higher integer value. 2. Half Points – Point values are represented in increments of 0.5 points. Fractional point values are rounded as follows: .0 -.2  rounded to the next lower half point (i.e. 1.2 rounds to 1.0) .3 - .7  rounded to the appropiate half point (i.e. 1.6 rounds to 1.5) .8 - .9  rounded to the next higher half point (i.e. 1.8 rounds to 2.0) 3. Tenth Points – All point values are represented in tenths of a point.  Purge Warning Days – Specifies the number of days used for issuing a warning when the Purge feature is invoked. If Never is specified a warning will not be issued for any Purge operation. Refer to the Purge feature for more information.

 Auto Purge Days – Specifies the number of days to be used for the Auto Purge feature. If Never is specified the Auto Purge feature is disabled. Refer to the Purge feature for more information.

 Max Water, Veg, Milk Counts – The maximum values for the Water, Veg/Fruit, and Milk counters may be specified here. Each counter will continue to increment each time it is tapped until it reaches its maximum value. They then rollover to zero and continue incrementing from there.  Item Cache Size – The size of the item cache may be specified with this option. The value selected here determines the maximum number of food items that will be remembered in the cache. If this value is set to zero the item cache feature is disabled. Refer to the Item Cache feature for additional information.

 Reset Button – The Reset button returns all preferences to their default condition.

Bank Preferences
The Bank Preferences dialog presents various options affecting how the bank is calculated.

 Bank Calculation Method – The Bank Calculation Method offers three different options for calculation of the bank value. These methods are defined as follows: 1. 2. 7 Day - The bank is calculated as the sum of the remaining points over the past seven days. 7 Day DOW - The bank is calculated as the sum of the remaining points over the past seven days, however, the bank is reset and starts at zero on the selected day of the week. See My week starts on. Prev Day - The bank is calculated as the remaining points for the previous day.


In all cases the maximum value for a daily bank is limited to the Max Bank Value preference.  My week starts on – Setting this value affects the bank calculation for the 7 Day DOW method as well as the weekday control at the top-right of the main screen. If you have a regular weekly weigh-in day you might consider making that day the start of your week. The following screen shots demonstrate the effects of setting this option:

Week starts on Sunday.

Week starts on Wednesday.

 Min Bank Value – This value is the minimum value that will be assigned to the bank. If None is selected there is no minimum. Selected zero for this preference will restrict the bank from becoming negative. The default value is None.  Max Bank Value – This value to the maximum value that will be assigned to the bank. If None is selected there is no maximum. Selecting zero for this preference will restrict the bank from containing a positive value. The default value is None.

Note: This preference was added in V2.6.9. Screen shots in this document have not been updated to reflect this enhancement. If you are updating from a previous version of WWCalc to V2.6.9 it is possible that the default value for Max Bank Value will be set to zero rather than None. This is due to an oversight with the way WWCalc preferences are stored on the PDA and cannot be corrected without causing backward compatibility problems. After upgrading to V2.6.9 please set this Bank Preference to your desired value.  Max Daily Bank – This value is the maximum daily bank value. The bank may contain more points that this value but daily usage of the bank will be restricted based on this setting. The default value is 10, which is the Weight Watchers recommendation for maximum bank points used during a single day.  Max Daily Point Bank – This value is the maximum points remaining that will be added to the bank for a single day. The default value is 5, which is the Weight Watchers recommendation for maximum regular points banked daily. Note that if you are banking more than 5 points in a day you are eating below the minimum point value for your weight group.  Max Daily Activity Bank – This value is the maximum number of unused activity points that will be banked per day. The default is 4 points, which is the Weight Watchers recommendation.  Reset Button – The Reset button returns all preferences to their default condition.

The Export feature allows data that you have entered into WWCalc to be formatted and written to the builtin Memo Pad database. After hotsyncing your device these Memo‟s will be available on the Palm Desktop where you can print or archive them. The Export feature supports two types of export, daily or weekly. A daily export will format and export the data for the currently selected day. A weekly export will format and export the data for the currently selected week. The export file contains all relevant WWCalc data including any Notes you may have entered for a day. If the contents of the data being exported exceeds the 4096 character limit of the Memo Pad multiple Memo records will be created with a title of "WWCalc continued...". Both Export options are available from the Record menu. The following screen shots demonstrate the export of the selected day:

Export Data
The Export Data feature allows data for a range of dates to be exported to the Memo Pad in CSV format allowing for easy import into a spreadsheet. Following is the Export Data dialog:

The following options are available: 1. All Days – Export the data for all days in the selected date range. 2. Start Days – Export the data for all start of week days in the selected date range. The start of weekday is defined on the Bank Preferences screen. 3. Cancel – Dismiss the Export Data screen without exporting any data. After selecting either the All Days button or the Start Days button you are requested to enter the range of dates to be exported:

The resulting record in the Memo Pad shows that between 12/16/01 and 12/30/01 (inclusive) there were only two days that had data. Hopefully your journaling efforts will be more successful than this! The data exported to the Memo Pad contains the following data items for each day selected:              Date in the format MM/DD Weight Minimum point range available for the day Maximum point range available for the day Total points used on this date. (This was added after these screen shots were taken but it‟s there, trust me). Activity points earned for the day. Point adjustment for this date. Bank value for this day. Bank adjustment for the date. Water count for this day. Veg/Fruit count for this day. Milk count for this day. Vitamin status (Y or N)

The Purge feature of WWCalc may be used to delete old data and reduce the memory requirements of the program. The Purge feature may be invoked manually via the Record menu or automatically each time to start the program via the Auto Purge feature as defined in Preferences. When a purge operation is started it examines the databases for records which are more than the specified number of days old. All records that meet this criterion are removed.

The Purge feature also supports a warning value, which will not delete data within the warning period without your approval. This protects you against accidentally specifying a very recent purge date and removing most of your data. For example, assume that today is December 30, 2001 and you have the Purge Warning Days set to seven (7) days. Invoking a purge operation and selecting Christmas day results in the following warning being issued. The data will only be removed if you respond Yes to this warning.

Set POINT Ranges
The Set POINT Ranges dialog allows setting the range of points to be assigned to each weight group. WWCalc defaults these values to those specified by Weight Watchers for the 2001 POINTs program. If the program changes this dialog offers a means to set the new range values. In addition, there are circumstances where a change is warranted. For example, people who have reached their goal and are maintaining, nursing mothers or teenagers have special requirements that may require modification of these values. Following is the layout of the POINT Ranges dialog with a discussion of the various options.
Tap i for help with this dialog.

The values specified for each weight group are Maximum Weight Value, minimum POINTs, and maximum POINTs. For example, the above setting specify that for weight values from 0-150 pounds the point range to be assigned should be 18-23. Likewise for weight values from 151-174 the point range is 20-25. The Global Adjust control allow a value to be added to (or subtracted from) each point range. This is convenient if you wish to alter the point ranges assigned by a set value without changing each individual range value. For example, suppose that you are at your goal and attempting to maintain your current weight. You have determined that using three points above the ranges specified by Weight Watchers lets you do this. You can set the Global Adjust option to 3 and avoid changing the min/max range values. If,

for example, your current weight were 172 then rather than the range 20-25 being assigned, WWCalc would assign the range 23-28. Tapping the Done button will save your current settings. Pressing Reset will set all values back to their default settings.

Activity Calculator
The Activity Calculator is a tool, which can be used to convert exercise into additional points that may be used during the current day or carried over in your bank value. Weight Watchers defines three levels of activity as follows:   Light - Light activities that do not make you sweat. You are able to talk and sing as you're exercising. Examples include stretching or walking at a leisurely pace. Moderate – Activities that probably make you break into a sweat after 10 minutes of continuous exercise. You breath more often and deeper as you exercise. You‟re able to talk but not able to sing. Examples include walking at a fast pace or biking. High – Activities that make you break into a sweat after several minutes of continuous exercise. Your breathing is more rapid and deep. You‟re able to speak briefly, but not hold a long conversation. Examples include jogging, running, and competitive swimming, or biking.


In addition to the activity intensity level the duration of the activity (in minutes) and your current weight are variables to this calculation. WWCalc will use your current weight value, however, you can over-ride and specify a new value in the calculator.
Tap i for help with this dialog.

To calculate activity points select the intensity level and enter the duration in minutes. If you wish to change the weight value used, simply tap on the weight selector. Press the Calculate button to display the points associated with the activity as well as estimated daily calorie intake. The calorie data is for information only and gives an idea of the amounts of carbohydrates, proteins, and fats a healthy diet would include. You should administer your food intake with respect to points and not attempt to consume the estimated daily calories. Tapping the Cancel button will dismiss the dialog. Tapping the OK will increase the daily activity points by the calculated value. If the Activity Log option is enabled a default entry with a description Activity Calculator will be made in the log.

Points Calculator
The Points Calculator is a tool used to determine the number of points charged for a food item based on its nutritional composition. The input to the calculator is the number of calories, the fat grams, and the fiber grams per serving. The following screen shot shows the format of the Points Calculator.

To use the calculator, enter the required values and press the Calculate button. The computed point value will be display next to the POINTS label. The Fiber Grams field allows free form input, however, Weight Watcher‟s 2001 program recommends that no more than 4 fiber grams per serving be used. The pop up trigger next to this field allows easy selection of a value from 0 through 4. The calculated point value will be displayed with fractional points in tenths if the Display in tenths checkbox is checked regardless of your Point display preference. When a point value is entered into your journal it will be rounded based on your Point display preference. Pressing the OK or Cancel button will dismiss the dialog. If the calculator was started from the P-Calc button on the main screen or the Record menu these button perform the same function. If the calculator was started from the Calculate button of the Points Value dialog (by tapping on an item point value) then pressing OK completes the calculation (if required) and enters the value which Cancel dismisses the calculator without taking any action. Following is a screen shot of the Points Value dialog:

Tapping the item point value launches the Points Value dialog.

BMI Calculator
The BMI Calculator computes a value, which measures body mass using your height and weight as input. The resulting value is a general indicator of how healthy your weight is for a person of your height. The calculator may be started from the Options menu. The calculator screen is show below:

Tap i for help with this dialog.

The BMI Calculator computes an indicator of how healthy your weight is in relation to your height. The default weight value is your journal weight for the selected day. If you would like to change the weight for “what if” calculations tap the weight selector and enter a new value. This will not alter your weight in the journal. Enter your gender by tapping on the appropriate button, set your weight and birthday if required, and use the popup lists to set your height. These values will be remembered so you only need to set them once. Each time you change any variable (Gender, Weight, or Height) the BMI will automatically be recalculated. The first time you use the BMI Calculator the Birthday selector will say Not Set. After entering your birthday from the date picker displayed by tapping on this trigger the display will change to Set. Of course you can select this trigger at anytime to verify or change the birthday being used to calculate your age. Tap the OK button to dismiss the calculator and return to the main screen. Following are the published meanings of the BMI values returned by the calculator:     BMI below 20 is considered to be underweight. BMI of 20-25 is generally considered to be healthy. BMI of 26-30 is generally considered overweight. BMI over 30 is generally considered to be very overweight (obese).

The Ideal Weight value is calculated based on your height and age. This value will be the midpoint between the Weight Watchers maximum weight recommendation for your height/age and the maximum weight for the next lower age group. The Ideal BMI value is the BMI that is calculated based on your ideal weight. If your age, based on the birth date entered, is less than or equal to 12 your ideal weight will be calculated via a formula rather than by using the Weight Watchers‟ tables. This formula considers your height and gender in calculating an ideal weight.

The Notes dialog is useful for storing any text you would like to associate with the selected day. If you don‟t use notes they require no additional storage overhead. Notes are persistent; they remain for as long as the data for the associated day remains. If the data for the day is deleted, either manually or via the Purge option, the notes will also be discarded. The Notes dialog is started either from the Record menu or by tapping on the note icon to the right of the main screen title bar. Following is a screen image of the Notes dialog:

Tap the Save button to save your notes and the Cancel button to dismiss the dialog without making any changes. If you wish to delete all the notes for a day simply select all the text in the dialog, backspace to delete it, and then tap the Save button. WWCalc will notice that all the text has been deleted and will remove the notes data record. Tapping the clock icon in the lower left-hand corner of the screen will insert the current time at the cursor position.

The List Lookup feature allows external databases created for the List program to be referenced from within WWCalc. Databases created by the List utilities consist of three fields, two data fields and a notes field. While List can be used for storing various types of data, many people on the Internet have created List databases containing Weight Watchers food item point values. The two data fields are assigned the item description and point value while the notes field is either left blank or filled in with miscellaneous information such as serving size or nutrition data. WWCalc expects the databases you reference from it to be in this format. For more information about List, or to download the software, visit the author‟s web site at http://www.magma.ca/~roo/list/list.html. If this site is not available you may obtain the List software at PalmGear.com. The List Lookup feature may be entered either via the Lookup button on the main screen or the Record menu. The first time Lookup is entered during the current program session it presents a database selection screen allowing a List database to be opened. Once open the food items within that database are displayed. The following diagram depicts the general flow.

Tapping on the Lookup button (or selecting Lookup from the Record menu) displays the Select Database screen. Note that re-entering the Lookup feature will skip the Select Database screen and immediately display the last used database. Tapping on a database name on this screen opens that database and displays the Lookup Items screen. This screen may be scrolled to locate an item, which can be selected by tapping on it. Selected items are displayed in reverse video. If there is a notes field associated with a selected item it will be displayed at the bottom of the screen directly above the row of buttons. The Lookup Items screen offers the following features:


Find Mode – The List Lookup Find feature operates in one of two modes, (S)earch or (L)ocate, indicated by the two push buttons in the upper left had corner of the screen. Tapping on one of these buttons sets the Find mode. The last selected Find mode is remembered and will be automatically selected each time you enter the List Lookup feature. – Search Mode – Performs a sequential search from the current position in the database. If no record is selected the search is from the beginning. If the find string is located anywhere within the item description the record is selected. – Locate Mode – Performs a binary search of the database matching description text at the beginning of the line only. This search is very fast but it requires the database to be sorted on the item description. When you open a List database WWCalc insures the data is properly sorted. If it isn‟t the database is sorted before being displayed. If you notice a short delay after opening a database this is probably what is taking place. Both Find Modes support string find and incremental find which may be used in conjunction, i.e. a string find can be performed and then extended using the incremental find.


Find – The find feature allows the item descriptions to be searched for a matching string. Both a string search and an incremental search are supported and they work in combination with each other. When no find string exists, the find selector at the top left of the screen displays ==Find ==. Tapping on this selector brings up a find dialog allowing a find string to be entered. While a find is in progress the find selector will display the current find string:

Find Mode is Search. Current find string. 1 3 4


The letter s entered via the graffiti pad to extend the current find incrementally.

In the example above a find operation is depicted. Following is a discussion of the find using the numbers in the small circles as reference points: 1. 2. 3. The find selector is tapped which brings up the Find Item dialog. The search string apple is entered and the OK button is tapped. The find string is updated to display the current search string apple and the display is scrolled to the first matching entry, which is selected. At this point the user enters an „s‟

4. 

via the graffiti pad (or keyboard) to extend the search using the incremental search feature. The current find string is updated to display apples and the display is scrolled to the new matching entry.

Category Select Trigger – Each List database can have its records assigned a category. These categories can vary from database to database generally reflecting food groups for the subject of that database. The Category Select Trigger allows selection of a particular category for display. While a category is selected it is used to filter the database items so that only records with that category are displayed. In addition, the find feature will only inspect records belonging to the current category. Selecting a category of All returns to displaying all items in the database. Following is an example of using the category:


Select Button – Tapping the Select button while an item is selected dismisses the lookup screen and enters that item into the selected day. Pressing Select when no item is selected issues a short beep and ignores the request. Cancel Button – Tapping the Cancel button dismisses the Lookup screen and returns to the main screen without taking any action. Next Button – Tapping the Next button searches for the next match of the find string. The search continues from the currently selected item. If the end of the database is reached without finding a match the search position is reset to the top so tapping Next again will search from the beginning of the database. Tapping Next when there is no search string causes the request to be ignored and no action is taken. Open Button – Tapping the Open button returns to the Select Database screen allowing another List database to be opened.

 


List Items and the Note Description displayed at the bottom of the screen will show a small note icon if the description displayed is truncated. Tapping on this icon will display the full text in a popup window:

Item Cache
The Item Cache is a very useful feature that remembers the items that you‟ve entered and the point values assigned to them. The next time that same item description is entered the point value is retrieved from the cache and displayed. You are free to change the point value after it is retrieved from the cache and this will cause the cache to be updated with the new point value. You don‟t have to do anything special to enter items into the cache, just normal usage of WWCalc will result in the caching of point values unless this feature is disabled. Note that item descriptions are not stored in the cache but are part of the journal. The cache simply contains the associated point value and meal description. As a result clearing your cache will not have any effect on the items that are displayed using the Description Lookup feature of the program. The Item Cache is a Least Recently Used (LRU) cache meaning that when it exceeds the number of entries specified in the Preferences dialog the items that are the oldest are discarded. This insures that the cache contains items that you frequently use and doesn‟t waste storage space for Papa Bear‟s Meat-like Substance (motto: It‟s hot, brown, and plenty of it :-) which you ate last March and swore you‟d never touch again.

Change Description
The change description feature allows the description of a food item to be globally changed. To use this feature select the item to be changed, select the Change Desc menu item on the Record menu, and enter the new description in the dialog that appears. Tapping Update from this dialog will perform the change while tapping Cancel will dismiss the dialog without changing anything. In the following example the entry Egg & Cheese sandwich: fast food is selected and changed to Egg & Cheese sandwich. Note that while this example only shows the item being changed on this particular day that it has, in fact, been changed on all journal days referencing Egg & Cheese sandwich: fast food.

Bank Info
The bank information screen may be used to research the current state of your bank. It can be used to learn why your bank displays as it does or, in cases where a bank bug is present may be used to send me a bug report. This screen is activated by selecting the Bank Info… item of the Record menu. Following is a Bank Info screen:

Following is a description of the data items on this screen staring at the top and moving left to right down the screen:                  Point Range – The range of points available for the selected day. Used – The number of points used for the selected day. Rem – The number of points remaining for the selected day. Adjust – The value of any point adjustment made for the selected day. Bank Method – The method of bank calculation selected on the Bank Preferences screen. Daily Bank – The current bank value for the selected day. Note that this may not be the same as the total bank value displayed below as it may be constrained by the Max Daily Bank preference. Adjust – The value of any bank adjustment made for the selected day. Val – The absolute Minimum and Maximum Bank Values as defined in the Bank Preferences. Note: this item used to labeled “Min” and was renamed with the addition of the Maximum Bank Value in V2.6.9. Screen shots in the document have not been updated to reflect this. Max – The Max Daily Bank preference. Point – The Max Daily Point Bank preference. Act – The Max Daily Activity Bank preference. Date – The date of the data record used in the calculation. Rem – The remaining points for this date. Start – The bank value at the start of this date. End – The bank value at the end of this day. Adj – Bank adjustments made for this date. Act – Activity points earned for this date.

While the Bank Info screen is displayed tapping the Export button will copy this information to a Memo Pad entry:

Note that if you use the 7 Day DOW bank calculation method and the currently selected day is the day before your week start day the end bank balance will be displayed as zero to indicate that the bank will be reset at the end of the day.

Activity Log
The Activity Log feature is new with V3.0.0 of WWCalc and allows monitoring not only of the total activity points earned per day but the details of each activity performed. If the Activity Log preference is enabled, tapping on the Activity Points selector brings up the activity log as shown below:
Activity Intensity L = Light M = Moderate H = High

Activity Duration (minutes)

Close Activity Log

Activity Description

Activity Point Value

Default Entry Created by the Activity Calculator

Total Activity Points

Edit/Delete Activity

Enter New Activity

Tapping the Details or New button brings up the Activity Detail form allowing an activity to be edited, deleted, or added respectively. Selecting the Detail button requires a current activity record to be selected. The Activity Detail form displays a list of all previously entered activities to allow for quick selection of frequently performed activities. The last entered activity duration and intensity are also cached and automatically entered when a list item is selected. Following is an example of the activity screen:

Following are some general tips that may make using WWCalc more pleasant:


When entering your own food items include the serving size as part of the description. This allows multiple cache entries for the various servings you use. Then when you begin to enter an item the Description Lookup feature will offer you the various serving sizes and you can select the appropriate one. Of course, this is most useful with the List form of Description Lookup. If you find yourself doing this a lot you might want to increase your maximum cache entries to avoid losing any. For example:


If you are using the Field Description Lookup setting and wish to enter an item with a description shorter than that displayed just enter extra spaces on the end of the description. This will cause the lookup to fail and no description will be proposed. WWCalc trims leading and trailing spaces for all description entries so there is no harm in doing this. For example, if you were to Enter “Turkey” and the description lookup feature displayed “Turkey Breast with Gravy” then entering two spaces would cause description lookup to fail and just the word “Turkey” would be entered.

Description Lookup for “Turkey”

Following “Turkey” with two spaces removes the match to “Turkey Breast with Gravy”

Thanks to Michele Akasha for allowing her Food point databases to be included in the original WWCalc distribution. Visit Michele‟s web site to keep up to date with point databases and for other Palm related tools. Thanks to group of people who helped test the program, made suggestions, and offered support. If I‟ve omitted you it is an oversight but you have my thanks nonetheless: Anne R., Barbara, Betsy, Brett, Cheryl, Connie, Damon, Dollie, Elsie, Gallia, Jane, Jennifer M., John E., Judi, Katie, Mike M., Miss B., Teresa, Tim, Wendy

“I love the program, how can I repay you?”
WWCalc is free software you may use it to your hearts content without obligation.

That being said if you would still like to do something to repay me for the efforts I have put into this program, I request that you make a contribution to EARS, The Emergency Animal Rescue Service at http://www.uan.org/ears/index.html. I have no affiliation with EARS other than my admiration for the wonderful service they provide. Your donation will make my day and probably yours as well.

WWCalc is freeware and, of course, comes with no guarantees. In addition, there is not a dedicated support staff to answer your questions or address your problems. However, I have put a lot of work into WWCalc and I want it to be the best Weight Watchers tool available at any price. I am happy to offer whatever support I can and I‟m always willing to listen to ideas for ways to improve the program. That doesn‟t mean I‟ll act on those ideas but I‟ll certainly consider them for inclusion in a future release. I‟m a pretty reasonable guy when I remember to take my medication! I‟ve set up a web page to provide WWCalc information, including a copy of this document. You can reach it by going to http://www.ruffboy.com/wwcalc.htm. Best of luck in your weight loss endeavors. Bob Withers bwit@pobox.com December 2001 February 2002 (revised)