update:生成验证码的文档

Author: pangwu86

doc/manual/img/advanced.man

@@ -79,6 +79,62 @@
 
     <a2.jpg>
 
+------------------------------------------------------------------------
+生成验证码
+
+    将指定的文字内容生成验证码。验证码的生成步骤如下：
+
+    1. 随机选择颜色与字体
+    2. 文字写入
+    3. 添加干扰线
+    4. 图像整体进行扭曲
+
+    对于验证码内容，可以使用Nutz中Lang包提供的R.captchaNumber或R.captchaChar，也可以填入任意内容。
+
+
+    比如生成6位数字验证码：
+
+    {{{<JAVA>
+    img = Images.createCaptcha(R.captchaNumber(6));
+    }}}
+
+    效果如下：
+
+    <cpn6.jpg>
+
+
+    比如生成6位字符+数字验证码：
+
+    {{{<JAVA>
+    img = Images.createCaptcha(R.captchaChar(6));
+    }}}
+
+    效果如下：
+
+    <cpc6.jpg>
+
+
+    如果要生成其他字符的，比如中文，则需要手动指定字体名称，否者容易产生乱码：
+
+    {{{<JAVA>
+    img = Images.Images.createCaptcha("胖五是好人", 0, 0, null, "#FFF", "微软雅黑");
+    }}}
+
+    效果如下：
+
+    <cpchinese.jpg>
+
+
+    也可以指定前后背景颜色，这样不会显得那么花哨了：
+
+    {{{<JAVA>
+    img  = Images.createCaptcha(R.captchaChar(10), 0, 0, "#000", "#FFF", null);
+    }}}
+
+    效果如下：
+
+    <cphb.jpg>
+
 ------------------------------------------------------------------------
 灰度图
 

doc/manual/img/cpc6.jpg

@@ -589,7 +589,7 @@ public static BufferedImage twist(Object srcIm, double twistRank, String bgColor
             twistRank = 1;
         }
         BufferedImage bufImg = read(srcIm);
-        double period = R.random(0, 10) + 3;// 波形的幅度倍数，越大扭曲的程序越高，一般为3
+        double period = R.random(0, 7) + 3;// 波形的幅度倍数，越大扭曲的程序越高，一般为3
         double phase = R.random(0, 6);// 波形的起始相位，取值区间（0-2＊PI）
         int width = bufImg.getWidth();
         int height = bufImg.getHeight();
@@ -613,17 +613,17 @@ public static BufferedImage twist(Object srcIm, double twistRank, String bgColor
     }
 
     // 扭曲相关计算, 后面的参数有两种组合
-    // 1. width, x, y
-    // 2. height, y, x
+    // 1. height, x, y
+    // 2. width, y, x
     private static int pos4twist(double rank,
                                  double phase,
                                  double period,
-                                 int wOrH,
+                                 int hOrW,
                                  int xOrY,
                                  int yOrX) {
-        double dyOrX = Math.PI * rank * xOrY / wOrH + phase;
+        double dyOrX = Math.PI * rank * yOrX / hOrW + phase;
         double dxOrY = Math.sin(dyOrX);
-        return yOrX + (int) (dxOrY * period);
+        return xOrY + (int) (dxOrY * period);
     }
 
     public static final int WATERMARK_TOP_LEFT = 1;