DesktopWeather v0.4 by Judge

Installation:
-------------
1. Unpack into your Samurize directory.
2. Install the fonts weather.ttf and nu.ttf
3. Configure Scripts/DesktopWeather.vbs for your setup
4. Maybe edit Config/DesktopWeather.ini to change degrees F to
   degrees C and mph to kmh (and anything else you like :-) ).
5. If you change the instance name, set up a shortcut to run
   Client.exe with the right name.
6. Double-click on your shortcut (a shortcut called SamurizeWeather.exe
   is provided that runs a Samurize instance called 'weather').
7. Note that if you chose not have the script restart Samurize you will
   probably need to select 'reload config' on the instance a couple of
   times to get the data displayed sensibly (so that the meters are in
   sync with the cache files). This would happen automatically if you
   left it for a while or if you allow the script to restart Samurize
   for you.

Files:
------
DesktopWeather.Readme.txt	This file.
nu.fon				A font used in the example config.
WEATHER.ttf			A font with a bunch of weather symbols
				in it. Use this if you don't like using
				the PNGs!
SamurizeWeather.exe		A shortcut that will run an instance of
				Samurize with the instance name 'weather'.
Configs/DesktopWeather.ini	An example config file
Scripts/DesktopWeather.vbs	The file containing all the functions
Skins/DesktopWeather/*		The directory containing all of the
				graphics files.

Trouble Shooting:
----------------
Over time you will notice an increasing number of Samurize icons in your
system tray. This is a side-effect of the script having to restart the
Samurize client. The easiest way to stop it happening is to install
systrayx or traymanager - or use ObjectBar to display you sustem tray
instead of the standard Windows one.

Configuration:
--------------
You can edit the following constants in DesktopWeather.vbs:

CITY
	Set this to your city, dont forget the format "<zip code>" for
	U.S.A. or "city, country" elsewhere

USE_CELCIUS
	If you want temperatures returned in celcius or farenheit
	
MPH
	If you want the wind speed in miles or kilometer per hour
	
RESTART
	If you want to restart the client after a cache file update
	(so that the graphics update). See later also
	
INSTANCE_NAME
	Name of the samurize instance to restart
	
SAMURIZE_DIRECTORY
	The directory that Samurize is installed in

Cache Function:
---------------
getCacheFiles(mins)
	Downloads the necessary pages from http://www.weather.com/
	and stores them on your PC. It is absolutely essential that
	you have a meter that calls this function. The parameter is
	the age of these files in minutes past which the samurize
	client instance	will be restarted. A good value for this is
	30.
	
	The meter can be set to call this function as frequently as
	you like, but it is easiest to make it the same value.
	
	Other meters can be set to be updated more frequently. I set
	the other meters to update once every 5 minutes for example.

Current Weather Functions:
--------------------------
getCity
	Returns the city reported by weather.com
	
getTime
	Returns the time that the latest observation was taken
	
getDate
	Returns the date that the latest observation was taken
	
getSymbol
	Use this function if you are using the weather font -
	returns the right character code for the conditions.

getTemperature
	Gets the current temperature in either Farenheit or Celcius.
	It returns only the number.

getFeelsLike
	Gets the temperature adjusted for wind chill and hunidity
	
getCondition
	Gets a description of the current conditions
	
getPrecipChance
	Gets the chance of precipitation as a percentage in the
	next 24 hours. Only the number is returned.
	
getWindDirection
	Gets the wind direction as a number between 0 (North) and 15
	(North Northwest)

getWindSpeed
	Gets the wind speed in either mph or kmh. Only the number is returned.
	
getWind
	Gets a description of the wind speed and direction.
	
Function getHumidity
	Gets the percent humidty
	
getVisibility 
	Gets the visibility in either mph or kmh
	
getPressure
	Gets a description of the pressure
	
getDewPoint
	Gets the dewpoint temperature in either Farenheit or Celcius
	
Function getUV
	Gets the UV index

Hourly Weather Functions:
-------------------------
NOTE: Hour numbers for hourly forecasts run from 0 through 4

getHourlyTemp(hourNum)
	Returns the forecast temperature in Farenheit or Celcius for
	the given hour.

getHourlyHour(hourNum)
	Returns the actual hour that the hour number corresponds to.
	
Daily Weather Functions:
-------------------------
NOTE: Day numbers for daily forecasts run from 0 thru 9

getDayFC(dayNum)
	Get the day of the week that the day number corresponds to.
	
getDateFC(dayNum)
	Get the date that the day number corresponds to.
	
getConditionFC(dayNum)
	Get a description of the condition for the given day.
	
getSymbolFC(dayNum)
	Use this function if you are using the weather font -
	returns the right character code for the conditions on
	the given day.
	
getHighFC(dayNum)
	Get the high temperature for the given day in either Farenheit
	or Celcius. Returns only the number.
	
getLowFC(dayNum)
	Get the low temperature for the given day in either Farenheit
	or Celcius. Returns only the number.

getHighLowFC(dayNum)
	Get the temperature for the given day as <high>/<low> in either
	Farenheit or Celcius.
	
getPrecipChanceFC(dayNum)
	Gets the percentage chance of precipitation for the given day.
