Variable Editor

The variable editor is included in the opening requester for FWCalendar. Changes made in the variable editor are saved to the preference file.

To speed up rendering, not all variables are included in the variable editor. Those that are expected to change from time to time are included, those that are not likely to be changed or that should not be changed casually are not included (these can be changed by including them in the preferences file). The variable editor itself does not allow the addition of unlisted variables; if you want to add a variable to the cycle gadget of the variable editor, add the variable to the preferences file using a text editor.

Both FWCalendar and FWCAddEvent use the same user-chosen preference file for initializing variables, so you should not change the preferences file between using FWCalendar and FWCAddEvent.


Several options are available on the first ("Options & Layout") tab of the variable editor. Checking one of the checkboxes is equivalent to setting the corresponding variable to 1:
Checkbox    Variable
MiniCals = DoMiniCals
Highlights = DoHighlights
Images = DoImages
Box Dates = DoDateBox
Backgrounds = DoBackgrounds
Extended = DoExtended
Extra week at top = DoTopExtraWk
Include note box = DoNoteBox

Note that the "Images" checkbox will be ghosted if FWCalendar can't find the graphics appliction set as GfxApp. If the "Images" checkbox is ghosted and you don't think it should be, check the values of the GfxApp and GfxAppPath variables to make sure they are properly set.

If the "Extended" option is set, the days from the previous month and the next month will be printed on the calendar as appropriate. If "Extra week at top" is set, then the last week of months that extend into the 6th week will be printed as full-sized cells at the top of the calendar rather than half-height cells at the bottom of the calendar. Since these two options are mutually exclusive, the "Extra week at top" checkbox will be ghosted if the "Extended" option is set.

If "Include note box" is set, then an empty box with the user-definable label "Notes" will be included where ever empty calendar boxes would show up. This option can be used with the "Extra week at top" option, but cannot be used with the "Extended" option (the entire calendar is filled with calendar boxes in this case), so the "Include note box" checkbox will be ghosted if the "Extended" option is set.

The center of the first tab allows setting the page orientation and margins. The center cycle gadget alternates between "Tall" (portrait) and "Wide" (landscape) settings. The text boxes surrounding the cycle gadget correspond to the (going clockwise from the top) top, right, bottom, and left margins.

The bottom of the first tab (which shows up on all the tabs) allows you to set the month and year of the desired calendar.

Clicking on the "Monthly" button will begin generation of a monthly calendar, while clicking on the "Yearly" button will begin generation of a yearly calendar (the month will be ignored in this case).

The "Reset" button causes the default settings (the settings coded into FWCalendar) to be loaded, while clicking on "Load" will allow you to load a preferences file. The full path and file name of the loaded preferences file will be displayed at the top of the requester; if the PrefsName variable is set in the preferences file, that name will be displayed in place of the preferences file's path and file name.

Obviously, the "Cancel" button cancels the operation. If the requester is cancelled, no changes made to any variables (either in the variable requester or in the highlight editor) will be saved.

If one of the margin gadgets is active, the <TAB> key will cycle through the margin settings.


The "Variables" tab of the variable requestor allows various variables, including fonts and colors, to be changed.

To change a font, first select the name of the desired variable (eg, Font.Date or Bold.MiniCal), then click on the file requester gadget at the end of the line. The popup gadget must be used to change the font; direct changes to the font in the text gadget will not be accepted. When Final Writer is being used, a standard file requestor will appear from which you can locate and select the desired font; when PageStream is being used, a list of all installed fonts will appear.

Colors are changed by first selecting the name of the desired variable (eg, Color.Date or Line.Extended), then selecting the desired color from the cycle gadget. The colors present in the cycle gadget are those read from the preferences for either Final Writer or PageStream. Only the various background colors (those variables begining with Background.) can be set to "<Clear>" (or your translation for "Clear"). This setting will cause the various boxes to be transparent, allowing, for example, a background picture to be visible through the boxes.

If the "Date Color = Highlight Color" checkbox is checked, the date (and date box, if this option is selected) will be printed in the same color as the highlight text. If the checkbox is cleared, the date color will be determined by Color.Date. This corresponds to the DoMatchColors variable.

If the "Use Daily Colors" checkbox is checked, the date (and date box, if this option is selected) will be printed in a color determined by the variables Color.Sunday through Color.Saturday. If the checkbox is cleared, the date color will be determined by Color.Date. This corresponds to the DoDailyColors variable.

The highlight editor can be invoked by clicking on the "Highlights" gadget.

Miscellaneous variables can be set in the lower section of this tab. Quotes will automatically be added for variables requiring non-numeric values. The <TAB> key will cycle through the variable list (forward only), and the <RETURN> key will activate the variable-value text box. The file requester gadget must be used to change the values of GfxApp, GfxAppPath, and SunCalcPath; direct changes to the values in the text gadget will not be accepted for these variables.


The options for adding extras (moon phases, julian dates, week numbers, etc.) are found in the third and fourth tabs. The radio buttons in the third tab ("Top") will locate the extras in the two available top positions, while the radio buttons in the last tab ("Bottom") locate the extras in the three available bottom positions. Each of the extras is mutually exclusive (ie, each extra can be used in one location only). Extras can be added at the top or bottom of any date; if any extras are added at the top of a date, highlights for that date will begin down one line.

The "Sunrise," "Sunset," and "Rise/Set" options will be ghosted if FWCalendar can't find SunCalc; check the value of the SunCalcPath variable to make sure you have properly set the path only to SunCalc.