     /**
     Returns a color object representing the color with the given RGB component values with an opacity (alpha) of 1.0.  Values below 0 will be treated as 0 and values above 1 will be treated as 1.
     
-    :param: red   The red component of the color, specified between 0 and 1.
-    :param: green The green component of the color, specified between 0 and 1.
-    :param: blue  The blue component of the color, specified between 0 and 1.
+    - parameter red:   The red component of the color, specified between 0 and 1.
+    - parameter green: The green component of the color, specified between 0 and 1.
+    - parameter blue:  The blue component of the color, specified between 0 and 1.
     
-    :returns: The color object.
+    - returns: The color object.
     */
     
     convenience init ( red: CGFloat, green: CGFloat, blue: CGFloat ) {

            let range = NSMakeRange( 0, stringSize )
            let pattern = "#?[0-9A-F]{6}"
            
            if let regex = NSRegularExpression ( pattern: pattern, options: .CaseInsensitive, error: &error ) {
                let matchRange = regex.rangeOfFirstMatchInString( hexString, options: .ReportProgress, range: range )
                
                if matchRange.location != NSNotFound {
                    var workingString = hexString
                    
                    if ( stringSize == 7 ) {
                        workingString = workingString.substringFromIndex( advance( workingString.startIndex, 1 ) )
                    }
                    
                    NSScanner ( string: workingString ).scanHexInt ( &hexIntValue )
                }
            }
        }
        
        
        self.init ( hex: Int( hexIntValue ), alpha: alpha )
    }
}


    /**
    Returns a color object representing the color with the given RGB value passed in as a hexadecimal integer and has the specified opacity.
    
    - parameter hex: The red, green, and blue components that compromise the color combined into a single hexadecimal string.  Each component has two characters which range from 0 through to f.  The string may be optionally prefixed with a '#' sign.
    - parameter alphaValue: A CGFloat between 0.0 and 1.0 representing the opacity with a default value of 1.0.
    
    - returns: The color object
    */
    
    convenience init ( hexString : String, alpha : CGFloat = 1.0 ) {
        
        var hexIntValue : UInt32 = 0x000000
        
        let stringSize = hexString.characters.count
        
        
        if ( ( stringSize == 6 ) || ( stringSize == 7 ) ) {
