====== Director Events ======
Below is a list of Functions fired when certain events occur during the acquisition of the captured window.

===== Calling Order =====

Initialize\\
TranslateUrl\\
StartPlayerSearch\\
OnPlayerFound\\
GetPlayerViewingRectangle

===== Initialize =====


function director:Initialize()

end;


===== TranslateUrl =====


function director:TranslateUrl(url)
--This method can be used to pass additional information
--to the director block appended within the calling VideoFile url.
--Pass the corrected url back using the return function.
newurl = url;
return newurl;
end;


===== StartPlayerSearch =====


function director:StartPlayerSearch(url)
--This method is called for each additional url that the calling url opens.
--You can test the contents of the page and return true|false when the page that
--contains the player is found.
return true;
end;


===== OnPlayerFound =====


function director:OnPlayerFound(player)
--This method is called once StartPlayerSearch returns true
--and the player is located on the page
--The window handle of the player is passed in variable "player".
--The player window handle can also be returned using director:get_PlayerWindow()
end;


===== GetPlayerViewingRectangle =====


function director:GetPlayerViewingRectangle(playerSize)
return Rectangle(0, 0, playerSize.Width, playerSize.Height - 30);
end;


===== get_PlayerSearchCriteria =====


function director:get_PlayerSearchCriteria()
return PlayerBounds(360, 0, 1.1, 2.0);
end;