チェンジセット 804

差分発生行の前後
無視リスト:
コミット日時:
2008/07/09 17:30:07 (4 年前)
コミッタ:
michi
ログメッセージ:

asdoc追加

ファイル:

凡例:

変更無し
追加
削除
更新
コピー
移動

  • as3/Utils/src/org/libspark/utils/ArrayUtil.as

    r512 r804  
    1818{ 
    1919    /** 
    20      * Arayのためのユーティリティクラスです 
     20     * Arrayのためのユーティリティクラスです 
    2121     */ 
    2222    public class ArrayUtil 

  • as3/Utils/src/org/libspark/utils/BitmapUtil.as

    r397 r804  
    2222import flash.display.DisplayObject; 
    2323import flash.display.DisplayObjectContainer; 
     24import flash.display.IBitmapDrawable; 
    2425import flash.display.Loader; 
    2526import flash.display.Sprite; 
    …… 
    3132import flash.errors.IllegalOperationError; 
    3233 
     34/** 
     35 * BitmapData のためのユーティリティクラスです 
     36 */ 
    3337public class BitmapUtil 
    3438{ 
    …… 
    123127     * DisplayObjectインスタンスのキャプチャデータを作成します 
    124128     *  
    125      * @param   target 対象となるDisplayObjectインスタンス 
    126      * @return  キャプチャデータを持つBitmapDataインスタンス 
     129     * @param   target 対象となる IBitmapDrawable オブジェクト 
     130     * @return  キャプチャデータを持つ BitmapData オブジェクト 
    127131     */ 
    128     public static function capture( target:DisplayObject ):BitmapData 
     132    public static function capture (target:IBitmapDrawable):BitmapData 
    129133    { 
    130         var rect:Object = target.getBounds( target ); 
     134                if (target is BitmapData) return (target as BitmapData).clone(); 
     135                var display:DisplayObject = target as DisplayObject; 
     136        var rect:Object = display.getBounds( display ); 
    131137        var width:Number = rect.width; 
    132138        var height:Number = rect.height; 
    133139        var bitmap:BitmapData = new BitmapData(  
    134             width+1 , height+1, true, 0x00000000 ); 
     140            width , height, true, 0x00000000 ); 
    135141        var matrix:Matrix = new Matrix(); 
    136142        matrix.translate( -rect.x , -rect.y ); 
    137         bitmap.draw( target , matrix ); 
     143        bitmap.draw( display , matrix ); 
    138144        return bitmap; 
    139145    } 

  • as3/Utils/src/org/libspark/utils/ColorUtil.as

    r512 r804  
    2121    import flash.geom.ColorTransform; 
    2222         
     23        /** 
     24         * 色情報を扱うユーティリティクラスです 
     25         */ 
    2326        public class ColorUtil 
    2427        { 
    …… 
    3942         * @param       alpha 透明度 (0.0 - 1.0) 
    4043         * @return 新しい ColorTransform インスタンス 
     44                 * @author  michi at seyself.com 
    4145         */ 
    4246        public static function colorTransform( rgb:uint=0, amount:Number=1.0, alpha:Number=1.0 ):ColorTransform 
    …… 
    5256         
    5357                /** 
    54                 * 減算 
     58                * 減算. <br /> 
    5559                * ２つのRGBを示す数値（ 0x000000 から 0xFFFFFF まで）から減算した数値を返します. 
    5660                *  
    …… 
    5862                * @param col2   RGBを示す数値（ 0x000000 から 0xFFFFFF まで） 
    5963                * @return       減算混色値 
     64                * @author  michi at seyself.com 
    6065                */ 
    6166                public static function subtract( col1:uint , col2:uint ):uint 
    …… 
    7075                 
    7176                /** 
    72                 * 加法混色 
     77                * 加法混色. <br /> 
    7378                * ２つのRGBを示す数値（ 0x000000 から 0xFFFFFF まで）から加法混色した数値を返します. 
    7479                *  
    …… 
    7681                * @param col2   RGBを示す数値（ 0x000000 から 0xFFFFFF まで） 
    7782                * @return       加法混色値 
     83                * @author  michi at seyself.com 
    7884                */ 
    7985                public static function sum( col1:uint , col2:uint ):uint 
    …… 
    8894                 
    8995                /** 
    90                 * 減法混色 
     96                * 減法混色. <br /> 
    9197                * 2つのRGBを示す数値（ 0x000000 から 0xFFFFFF まで）から減法混色した数値を返します. 
    9298                *  
    …… 
    94100                * @param col2   RGBを示す数値（ 0x000000 から 0xFFFFFF まで） 
    95101                * @return       減法混色値 
     102                * @author  michi at seyself.com 
    96103                */ 
    97104                public static function sub( col1:uint , col2:uint ):uint 
    …… 
    106113                 
    107114                /** 
    108                 * 比較（暗） 
     115                * 比較（暗）. <br /> 
    109116                * 2つのRGBを示す数値（ 0x000000 から 0xFFFFFF まで）から比較して、RGBそれぞれ数値の低い方を合わせた数値を返します. 
    110117                *  
    …… 
    112119                * @param col2   RGBを示す数値（ 0x000000 から 0xFFFFFF まで） 
    113120                * @return       比較（暗）値 
     121                * @author  michi at seyself.com 
    114122                */ 
    115123                public static function min( col1:uint , col2:uint ):uint 
    …… 
    124132                 
    125133                /** 
    126                 * 比較（明） 
     134                * 比較（明）. <br /> 
    127135                * 2つのRGBを示す数値（ 0x000000 から 0xFFFFFF まで）から比較して、RGBそれぞれ数値の高い方を合わせた数値を返します. 
    128136                *  
    …… 
    130138                * @param col2   RGBを示す数値（ 0x000000 から 0xFFFFFF まで） 
    131139                * @return       比較（明）値 
     140                * @author  michi at seyself.com 
    132141                */ 
    133142                public static function max( col1:uint , col2:uint ):uint 
    …… 
    142151                 
    143152                /** 
     153                 * RGB それぞれの数値から RGB カラー値を求めます。 
     154                 *  
     155                 * @param r     赤（R）を示す数値（ 0 から 255 まで） 
     156                 * @param g     緑（G）を示す数値（ 0 から 255 まで） 
     157                 * @param b     青（B）を示す数値（ 0 から 255 まで） 
     158                 * @return 各色の値から求められたRGBを示す数値 
     159                 * @author  michi at seyself.com 
     160                 */ 
     161                public static function rgb(r:uint, g:uint, b:uint):uint 
     162                { 
     163                        return r << 16 | g << 8 | b; 
     164                } 
     165                 
     166                /** 
     167                 * HSV それぞれの数値から RGB カラー値を求めます。 
     168                 *  
     169                 * @param       h 色相（Hue）を示す数値（ 0 から 360 まで） 
     170                 * @param   s 彩度（Saturation）を示す数値（ 0.0 から 1.0 まで） 
     171                 * @param   v 明度（Value）を示す数値（ 0.0 から 1.0 まで） 
     172                 * @return 各色の値から求められたRGBを示す数値 
     173                 * @author  michi at seyself.com 
     174                 */ 
     175                public static function hsv(h:int, s:Number, v:Number):uint 
     176                { 
     177                        return rgb.apply( null, HSVtoRGB(h, s, v)); 
     178                } 
     179                 
     180                /** 
    144181                * RGBを示す数値（ 0x000000 から 0xFFFFFF まで）を 
    145182                * R, G, B それぞれ 0 から 255 までの数値に分割した配列を返します. 
    146183                *  
    147                 * @param col    ARGBを示す数値（ 0x00000000 から 0xFFFFFFFF まで） 
    148                 * @return       各色の値を示す配列 [ R , G , B , Alpha ]  
    149                 */ 
    150                 public static function toRGB( col:uint ):Array 
    151                 { 
    152                         var r:uint = col >> 16 & 0xFF; 
    153                         var g:uint = col >> 8  & 0xFF; 
    154                         var b:uint = col       & 0xFF; 
     184                * @param rgb    RGBを示す数値（ 0x000000 から 0xFFFFFF まで） 
     185                * @return       各色の値を示す配列 [ R , G , B ]  
     186                * @author  michi at seyself.com 
     187                */ 
     188                public static function toRGB( rgb:uint ):Array 
     189                { 
     190                        var r:uint = rgb >> 16 & 0xFF; 
     191                        var g:uint = rgb >> 8  & 0xFF; 
     192                        var b:uint = rgb       & 0xFF; 
    155193                        return [r,g,b]; 
    156                 } 
    157                  
    158                 /** 
    159                 * 引数に R, G, B, Alpha を示す、それぞれ 0x00 から 0xFF までの数値を合算した数値を返します. 
    160                 *  
    161                 * @param r      赤（R）を示す数値（ 0x00 から 0xFF まで） 
    162                 * @param g      緑（G）を示す数値（ 0x00 から 0xFF まで） 
    163                 * @param b      青（B）を示す数値（ 0x00 から 0xFF まで） 
    164                 * @return       各色の値から求められたRGBを示す数値 
    165                 */ 
    166                 public static function toDec( r:Number , g:Number , b:Number ):Number 
    167                 { 
    168                         return r << 16 | g << 8 | b; 
    169194                } 
    170195                 
    …… 
    187212                * @param b      青（B）を示す数値（ 0x00 から 0xFF まで） 
    188213                * @return       HSVに変換した値の配列 [ H, S, V ]  
     214                * @author  michi at seyself.com 
    189215                */ 
    190216                public static function RGBtoHSV( r:Number, g:Number, b:Number ):Array 
    …… 
    235261                * @param v      明度（Value）を示す数値（ 0.0 から 1.0 まで） 
    236262                * @return       RGBに変換した値の配列 [ R, G, B ]  
     263                * @author  michi at seyself.com 
    237264                */ 
    238265                public static function HSVtoRGB( h:Number, s:Number, v:Number ):Array 

  • as3/Utils/src/org/libspark/utils/DateUtil.as

    r512 r804  
    2525        import flash.errors.IllegalOperationError; 
    2626         
    27         /*======================================================================*//** 
    28         *//*=======================================================================*/ 
     27        /** 
     28         * Date クラスのためのユーティリティクラスです 
     29         */ 
    2930        public class DateUtil { 
    3031                 
    …… 
    6869         
    6970        /** 
    70          * うるう年かどうかを調べます 
     71         * うるう年かどうかを調べます. 
    7172         *  
    7273         * @param       fullyear 西暦 
    …… 
    8283         
    8384        /** 
    84          * 西暦を和暦に変換します 
     85         * 西暦を和暦に変換します. 
    8586         * 対応しているのは明治以降になります（1868年以降） 
    8687         *  
    …… 
    8990         * @author  michi at seyself.com 
    9091         */ 
    91         public static function convertJP( fullyear:uint ):String 
     92        public static function convertJCalendar( fullyear:uint ):String 
    9293        { 
    9394            var gengou:Array = ["M", "T", "S", "H"]; 
    …… 
    108109         
    109110        /** 
    110          * 曜日名を取得します 
    111          *  
     111         * 曜日名を取得します. <br /> 
     112                 * type の指定によって得られる値<br /> 
     113         * 0 : SUNDAY, MONDAY, TUSEDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY<br /> 
     114                 * 1 : Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday<br /> 
     115                 * 2 : sunday, monday, tuesday, wednesday, thursday, friday, saturday<br /> 
     116                 * 3 : SUN, MON, TUE, WED, THU, FRI, SAT<br /> 
     117                 * 4 : Sun, Mon, Tue, Wed, Thu, Fri, Sat<br /> 
     118                 * 5 : sun, mon, tue, wed, thu, fri, sat<br /> 
     119                 * 6 : 日曜日, 月曜日, 火曜日, 水曜日, 木曜日, 金曜日, 土曜日<br /> 
     120                 * 7 : 日, 月, 火, 水, 木, 金, 土<br /> 
     121                 *  
    112122         * @param       index 曜日インデックス値 
    113123         * @param       type 取得する曜日名のタイプ（0から7まで） 
    …… 
    131141         
    132142        /** 
    133          * 月を示す文字列を返します 
    134          *  
     143         * 月を示す文字列を返します. <br /> 
     144                 * type の指定によって得られる値<br /> 
     145         * 0 : JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER<br /> 
     146         * 1 : January, February, March, April, May, June, July, August, September, October, November, December<br /> 
     147         * 2 : january, february, march, april, may, june, july, august, september, october, november, december<br /> 
     148         * 3 : JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC<br /> 
     149         * 4 : Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec<br /> 
     150         * 5 : jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec<br /> 
     151         * 6 : 1月, 2月, 3月, 4月, 5月, 6月, 7月, 8月, 9月, 10月, 11月, 12月<br /> 
     152         * 7 : 睦月, 如月, 弥生, 卯月, 皐月, 水無月, 文月, 葉月, 長月, 神無月, 霜月, 師走<br /> 
     153                 *  
    135154         * @param       index 月 
    136155         * @param       type 取得する月名のタイプ（0から7まで） 

  • as3/Utils/src/org/libspark/utils/FileUtil.as

    r237 r804  
    1 /** 
     1/** 
    22 * The File Utility Class for ActionScript 3.0 
    33 * 
    …… 
    3232    import flash.filesystem.File; 
    3333    import flash.filesystem.FileStream; 
    34  
     34         
     35        /** 
     36         * ファイル操作を行うためのユーティリティクラスです <span style="color:#FF0000; font-weight:bold;">(AIR Only)</span> 
     37         */ 
    3538    public class FileUtil { 
    3639 
    3740       /** 
    3841        * Constructor 
     42                * @private 
    3943        */ 
    4044        public function FileUtil() { 

  • as3/Utils/src/org/libspark/utils/GeomUtil.as

    r512 r804  
    2727    import flash.geom.Transform; 
    2828     
    29     public class GeomUtil 
     29    /** 
     30     * 図形計算のためのユーティリティクラスです 
     31     */ 
     32        public class GeomUtil 
    3033    { 
    3134         
    …… 
    317320        } 
    318321         
     322                /** 
     323                 * 4つの座標数値からスプライン曲線の中間座標を取得します。 
     324                 *  
     325                 * @param       p0 始点座標数値 
     326                 * @param       p1 通過点座標数値（求められる曲線の始点） 
     327                 * @param       p2 通過点座標数値（求められる曲線の終点） 
     328                 * @param       p3 終点座標数値 
     329                 * @param       t 2 つの座標間の補間値。 0 から 1 までの数値 
     330                 * @return  p1 から p2 の間にある t の位置を示す座標値 
     331                 * @author  michi at seyself.com 
     332                 */ 
     333        public static function spline(p0:Number, p1:Number, p2:Number, p3:Number, t:Number):Number 
     334        { 
     335            var v0:Number = (p2 - p0) * 0.5; 
     336            var v1:Number = (p3 - p1) * 0.5; 
     337            var t2:Number = t * t; 
     338            var t3:Number = t2 * t; 
     339            return (2 * p1 - 2 * p2 + v0 + v1) * t3 +  
     340                ( -3 * p1 + 3 * p2 - 2 * v0 - v1) * t2 + v0 * t + p1; 
     341        } 
     342         
    319343        /** 
    320344         * 指定されたオブジェクトのストリング表現を返します。 

  • as3/Utils/src/org/libspark/utils/MathUtil.as

    r521 r804  
    2626        import flash.geom.Point; 
    2727         
    28         /*======================================================================*//** 
    29         *//*=======================================================================*/ 
     28        /** 
     29         * 基本的な計算を補うためのユーティリティクラスです 
     30         */ 
    3031        public class MathUtil { 
    3132                 
    …… 
    363364        } 
    364365         
     366                 
     367                public static function magnitude(x:Number, y:Number, z:Number=0):Number 
     368        { 
     369            return Math.sqrt(x * x + y * y + z * z); 
     370        } 
     371         
     372                 
     373                 
    365374        /** 
    366375         * (x1,y1)と(x2,y2)の距離を求めます 

  • as3/Utils/src/org/libspark/utils/NumberUtil.as

    r135 r804  
    2525        import flash.errors.IllegalOperationError; 
    2626         
    27         /*======================================================================*//** 
    28         *//*=======================================================================*/ 
     27        /** 
     28         * Number オブジェクトのためのユーティリティクラスです 
     29         */ 
    2930        public class NumberUtil { 
    3031                 

  • as3/Utils/src/org/libspark/utils/ObjectUtil.as

    r447 r804  
    1919{ 
    2020 
    21  
     21/** 
     22 * オブジェクトのためのユーティリティクラスです 
     23 */ 
    2224public class ObjectUtil 
    2325{ 
    …… 
    6264     * @param   ...propNames プロパティ名を文字列で指定します 
    6365     * @return   
     66         * @author  michi at seyself.com 
    6467     */ 
    6568    public static function toArray(target:Object, propNames:Array=null /* of String */ ):Array 
    …… 
    8083    } 
    8184     
     85        /** 
     86         * オブジェクトが持つ列挙可能なプロパティの名前を一覧で取得します。 
     87         *  
     88         * @param       target オブジェクト 
     89         * @return  プロパティ名の一覧 
     90         * @author  michi at seyself.com 
     91         */ 
     92        public static function getPropNames(target:Object):Array 
     93        { 
     94                var a:Array = []; 
     95                for (var val:String in target) a.push(val); 
     96                return a; 
     97        } 
     98         
     99        /** 
     100         * オブジェクトが持つ列挙可能なプロパティの値を一覧で取得します。 
     101         *  
     102         * @param       target オブジェクト 
     103         * @return  プロパティ値の一覧 
     104         * @author  michi at seyself.com 
     105         */ 
     106        public static function getPropValues(target:Object):Array 
     107        { 
     108                var a:Array = []; 
     109                for each(var val:* in target) a.push(val); 
     110                return a; 
     111        } 
     112         
    82113} 
    83114} 

  • as3/Utils/src/org/libspark/utils/SqlUtil.as

    r236 r804  
    1 /** 
     1/** 
    22 * The SQLite Utility Class for ActionScript 3.0 
    33 * 
    …… 
    3434    import flash.data.*; 
    3535 
     36        /** 
     37         * <span style="color:#FF0000; font-weight:bold;">(Flex Only)</span> 
     38         */ 
    3639    public class SqlUtil { 
    3740 

  • as3/Utils/src/org/libspark/utils/StringUtil.as

    r512 r804  
    2525        import flash.errors.IllegalOperationError; 
    2626        import flash.text.TextField; 
     27        import flash.utils.ByteArray; 
    2728         
    28         /*======================================================================*//** 
    29         *//*=======================================================================*/ 
     29        /** 
     30         * 文字列のためのユーティリティクラスです 
     31         */ 
    3032        public class StringUtil { 
    3133                 
    …… 
    8082                 
    8183        /** 
    82          * 改行をすべて\r（LF）に変換します。 
     84         * 改行コードをすべて\r（CR）に変換します。 
    8385         *  
    8486         * @param       str 変換対象の文字列 
    …… 
    128130        } 
    129131         
     132                 
    130133        } 
    131134}