====== recognizeCaptchaAG ======
Gets the text of the specified [[http://en.wikipedia.org/wiki/CAPTCHA|captcha]], recognized with API [[http://antigate.com/?action=api|AntiGate]].
===== Syntax =====
<code javascript>recognizeCaptchaAG = function(aImageElement, aKey, aPhrase, aMinLen,
  aMaxLen, aNumeric, aRegSense, aCalc, aRussian);
  
recognizeCaptchaAG = function(aImage, aKey, aPhrase, aMinLen,
  aMaxLen, aNumeric, aRegSense, aCalc, aRussian);</code>
==== Parameters ====
  * **//aImage//** 
    * //functions:// element image of which has to be recognized
  * **//aImage//** 
    * //functions:// image to be recognized
  * **//aKey//** 
    * //type:// string
    * //functions:// API key of AntiGate service
  * **//aCaptchaID//** 
    * //functions:// resulting captcha ID
  * **//aPhrase//** 
    * //functions:// 0 = one word, 1 = captcha has two words
  * **//aMinLen//** 
    * //functions:// 0 = default value, >0 = minimum length of text displayed in a CAPTCHA, the employee must enter
  * **//aMaxLen//** 
    * //functions:// 0 = unlimited, >0 = maximum length of text displayed in a CAPTCHA, the employee must enter
  * **//aNumeric//** 
    * //functions:// 0 = default value, 1 = captcha consists only of digits, 2 = captcha has no digits
  * **//aRegSense//** 
    * //functions:// 0 = register has no values, 1 = register has a value
  * **//aCalc//** 
    * //назначение:// 0 = default value, 1 = mathematical operation of digits displayed in a captcha
  * **//aRussian//** 
    * //functions:// 0 = default value, 1 = show captcha to employee with knowledge of Russian language
==== Returned value ====
  * //functions:// text obtained by recognition
===== Notes =====
  * To learn more about API AntiGate click the [[http://antigate.com/?action=api|link]]
  * If the service AntiGate returns an error, the result of the function is an empty string  
===== Examples =====
  -<code javascript>loadURI('http://www.google.com/recaptcha/learnmore');
//Get the captcha image
var image = getElement('img',0,['src'],['google.com/recaptcha/']);
//Send the image to recognize with service AntiGate
var captchatext = recognizeCaptchaAG(image,'MyAGKey').text;
//If the text is not empty, then enter the text to the input field
if (captchatext !== ''){
  var input = getElement('input',0,['name','id'],['recaptcha_response_field','recaptcha_response_field'],true);
  clickElement(input);
  typeIn(captchatext);
}</code>
  -<code javascript>loadURI('http://www.google.com/recaptcha/learnmore');
//Get the captcha image
var image = getImage(0,['src'],['google.com/recaptcha/']);
//Send the image to recognize with service AntiGate
var captchatext = recognizeCaptchaAG(image,'MyAGKey').text;
//If the text is not empty, then enter the text to the input field
if (captchatext !== ''){
  var input = getElement('input',0,['name','id'],['recaptcha_response_field','recaptcha_response_field'],true);
  clickElement(input);
  typeIn(captchatext);
}</code>