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

asdoc追加

ファイル:

凡例:

変更無し
追加
削除
更新
コピー
移動
  • 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                * 2つの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                * 2つの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