ColorValue.st
author Claus Gittinger <cg@exept.de>
Wed, 22 Jan 1997 04:19:07 +0100
changeset 378 3924b37b0ea4
parent 301 9d63572bb1e2
child 412 5fbd63617e33
permissions -rw-r--r--
added literalEncodings
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
39
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     1
"
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     2
 COPYRIGHT (c) 1995 by Claus Gittinger
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     3
	      All Rights Reserved
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     4
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
5c397bf531b3 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    11
"
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    12
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    13
Color subclass:#ColorValue
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    14
	instanceVariableNames:''
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    15
	classVariableNames:''
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    16
	poolDictionaries:''
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    17
	category:'Graphics-Support'
39
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    18
!
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    19
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    20
!ColorValue class methodsFor:'documentation'!
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    21
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    22
copyright
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    23
"
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    24
 COPYRIGHT (c) 1995 by Claus Gittinger
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    25
	      All Rights Reserved
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    26
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    27
 This software is furnished under a license and may be used
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    28
 only in accordance with the terms of that license and with the
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    30
 be provided or otherwise made available to, or used by, any
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    31
 other person.  No title to or ownership of the software is
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    32
 hereby transferred.
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    33
"
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    34
!
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    35
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    36
documentation
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    37
"
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    38
    ColorValue is provided for ST-80 compatibility.
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    39
    read the section on compatibility issues in the Color class's documentation.
220
4106d9ce7e02 documentation
Claus Gittinger <cg@exept.de>
parents: 214
diff changeset
    40
4106d9ce7e02 documentation
Claus Gittinger <cg@exept.de>
parents: 214
diff changeset
    41
    [author:]
4106d9ce7e02 documentation
Claus Gittinger <cg@exept.de>
parents: 214
diff changeset
    42
        Claus Gittinger
39
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    43
"
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    44
! !
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    45
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    46
!ColorValue class methodsFor:'instance creation'!
5c397bf531b3 Initial revision
claus
parents:
diff changeset
    47
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    48
brightness:grey
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    49
    "return a grey color.
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    50
     The grey value is given in 0..1 instead of percent"
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    51
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
    52
    ^ self scaledGray:(grey * MaxValue) rounded
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    53
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    54
    "
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    55
     ColorValue brightness:0.5
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    56
    "
277
7833361c76a2 gray vs. grey
Claus Gittinger <cg@exept.de>
parents: 220
diff changeset
    57
7833361c76a2 gray vs. grey
Claus Gittinger <cg@exept.de>
parents: 220
diff changeset
    58
    "Modified: 28.5.1996 / 20:53:52 / cg"
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    59
!
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    60
100
claus
parents: 99
diff changeset
    61
doesNotUnderstand:aMessage
claus
parents: 99
diff changeset
    62
    "catch other instance creation messages"
claus
parents: 99
diff changeset
    63
claus
parents: 99
diff changeset
    64
    |clr|
claus
parents: 99
diff changeset
    65
claus
parents: 99
diff changeset
    66
    (clr := self name:aMessage selector asString) notNil ifTrue:[
claus
parents: 99
diff changeset
    67
	^ clr
claus
parents: 99
diff changeset
    68
    ].
claus
parents: 99
diff changeset
    69
    ^ super doesNotUnderstand:aMessage
claus
parents: 99
diff changeset
    70
claus
parents: 99
diff changeset
    71
    "
claus
parents: 99
diff changeset
    72
     ColorValue royalBlue
claus
parents: 99
diff changeset
    73
     ColorValue funnyGreen
claus
parents: 99
diff changeset
    74
    "
47
b8bf773bdf76 *** empty log message ***
claus
parents: 39
diff changeset
    75
!
b8bf773bdf76 *** empty log message ***
claus
parents: 39
diff changeset
    76
63
claus
parents: 47
diff changeset
    77
hue:hue saturation:sat brightness:light 
claus
parents: 47
diff changeset
    78
    "return a color.
claus
parents: 47
diff changeset
    79
     The hue, saturation and brightness values are given in 0..1 instead of 
claus
parents: 47
diff changeset
    80
     degrees / percent"
claus
parents: 47
diff changeset
    81
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
    82
    ^ self hue:hue*360 light:light*100 saturation:sat*100 
63
claus
parents: 47
diff changeset
    83
claus
parents: 47
diff changeset
    84
    "
claus
parents: 47
diff changeset
    85
     ColorValue hue:0 saturation:1 brightness:0.5 
claus
parents: 47
diff changeset
    86
    "
claus
parents: 47
diff changeset
    87
!
claus
parents: 47
diff changeset
    88
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    89
red:r green:g blue:b
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    90
    "return a color from red, green and blue values.
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    91
     The arguments, r, g and b must be in the range (0..1)"
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    92
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
    93
    ^ self 
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
    94
	scaledRed:(r * MaxValue) rounded
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
    95
	scaledGreen:(g * MaxValue) rounded
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
    96
        scaledBlue:(b * MaxValue) rounded
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    97
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    98
    "
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    99
     ColorValue red:0 green:1 blue:0
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   100
     ColorValue red:0 green:0.5 blue:0
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   101
    "
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   102
! !
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   103
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   104
!ColorValue methodsFor:'accessing'!
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   105
301
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   106
blue
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   107
    "return the blue component in 0..1"
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   108
301
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   109
    ^ blue / MaxValue
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   110
!
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   111
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   112
green
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   113
    "return the green component in 0..1"
39
5c397bf531b3 Initial revision
claus
parents:
diff changeset
   114
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   115
    ^ green / MaxValue
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   116
!
39
5c397bf531b3 Initial revision
claus
parents:
diff changeset
   117
301
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   118
light
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   119
    "return the hue component in 0..1"
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   120
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   121
    ^ super light / 100.0
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   122
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   123
    "
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   124
     Color yellow light
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   125
     ColorValue yellow light
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   126
    "
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   127
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   128
    "Created: 11.6.1996 / 17:17:39 / cg"
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   129
!
300
97f6b30e8a50 Color changed to use integer r/g/b components internally (0..16rFFFF)
Claus Gittinger <cg@exept.de>
parents: 277
diff changeset
   130
301
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   131
red
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   132
    "return the red component in 0..1"
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   133
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   134
    ^ red / MaxValue
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   135
!
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   136
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   137
saturation
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   138
    "return the saturation component in 0..1"
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   139
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   140
    ^ super saturation / 100.0
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   141
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   142
    "
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   143
     Color yellow saturation     
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   144
     ColorValue yellow saturation  
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   145
    "
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   146
Claus Gittinger <cg@exept.de>
parents: 300
diff changeset
   147
    "Created: 11.6.1996 / 17:17:57 / cg"
39
5c397bf531b3 Initial revision
claus
parents:
diff changeset
   148
! !
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   149
378
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   150
!ColorValue methodsFor:'converting'!
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   151
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   152
fromLiteralArrayEncoding:encoding
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   153
    "read my values from an encoding.
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   154
     The encoding is supposed to be of the form: 
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   155
        (#ColorValue scaledRed scaledGreen scaledBlue)
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   156
     This is the reverse operation to #literalArrayEncoding."
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   157
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   158
    red := (encoding at:2).
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   159
    green := (encoding at:3).
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   160
    blue := (encoding at:4).
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   161
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   162
    "
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   163
      ColorValue new fromLiteralArrayEncoding:#(#Color 7700 7700 7700)
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   164
    "
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   165
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   166
    "Created: 22.1.1997 / 04:18:50 / cg"
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   167
!
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   168
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   169
literalArrayEncoding
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   170
    "encode myself as an array, from which a copy of the receiver
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   171
     can be reconstructed with #decodeAsLiteralArray.
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   172
     The encoding is: 
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   173
        (#ColorValue scaledRed scaledGreen scaledBlue)
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   174
    "
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   175
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   176
    ^ Array
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   177
        with:self class name asSymbol
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   178
        with:(self scaledRed)
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   179
        with:(self scaledGreen)
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   180
        with:(self scaledBlue)
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   181
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   182
    "
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   183
      ColorValue new fromLiteralArrayEncoding:#(#Color 50 25 25)
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   184
      (ColorValue red:0.5 green:0.25 blue:1.0) literalArrayEncoding 
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   185
    "
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   186
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   187
    "Modified: 22.1.1997 / 04:17:59 / cg"
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   188
! !
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   189
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   190
!ColorValue class methodsFor:'documentation'!
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   191
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   192
version
378
3924b37b0ea4 added literalEncodings
Claus Gittinger <cg@exept.de>
parents: 301
diff changeset
   193
    ^ '$Header: /cvs/stx/stx/libview2/ColorValue.st,v 1.13 1997-01-22 03:19:07 cg Exp $'
214
28ed6be65f4c commentary
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   194
! !