Class: ColorLib::CMYK

Inherits:
Object
  • Object
show all
Defined in:
lib/color_lib/cmyk.rb,
lib/color_lib.rb

Overview

An CMYK colour object. CMYK (cyan, magenta, yellow, and black) colours are based on additive percentages of ink. A CMYK colour of (0.3, 0, 0.8, 0.3) would be mixed from 30% cyan, 0% magenta, 80% yellow, and 30% black. Primarily used in four-colour printing processes.

Constant Summary collapse

PDF_FORMAT_STR =

The format of a DeviceCMYK colour for PDF. In color-tools 2.0 this will be removed from this package and added back as a modification by the PDF::Writer package.

"%.3f %.3f %.3f %.3f %s"

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(c = 0, m = 0, y = 0, k = 0) ⇒ CMYK

Creates a CMYK colour object from percentages. Internally, the colour is managed as fractional values 0..1.

ColorLib::CMYK.new(30, 0, 80, 30)



51
52
53
54
55
56
 
# File 'lib/color_lib/cmyk.rb', line 51

def initialize(c = 0, m = 0, y = 0, k = 0)
  @c = c / 100.0
  @m = m / 100.0
  @y = y / 100.0
  @k = k / 100.0
end

Class Method Details

.from_fraction(c = 0, m = 0, y = 0, k = 0) ⇒ Object

Creates a CMYK colour object from fractional values 0..1.

ColorLib::CMYK.from_fraction(0.3, 0, 0.8, 0.3)



30
31
32
33
34
35
36
37
 
# File 'lib/color_lib/cmyk.rb', line 30

def self.from_fraction(c = 0, m = 0, y = 0, k = 0)
  colour   = ColorLib::CMYK.new
  colour.c = c
  colour.m = m
  colour.y = y
  colour.k = k
  colour
end

.from_percent(c = 0, m = 0, y = 0, k = 0) ⇒ Object

Creates a CMYK colour object from percentages. Internally, the colour is managed as fractional values 0..1.

ColorLib::CMYK.new(30, 0, 80, 30)



43
44
45
 
# File 'lib/color_lib/cmyk.rb', line 43

def self.from_percent(c = 0, m = 0, y = 0, k = 0)
  ColorLib::CMYK.new(c, m, y, k)
end

Instance Method Details

#==(other) ⇒ Object

Compares the other colour to this one. The other colour will be converted to CMYK before comparison, so the comparison between a CMYK colour and a non-CMYK colour will be approximate and based on the other colour’s #to_cmyk conversion. If there is no #to_cmyk conversion, this will raise an exception. This will report that two CMYK colours are equivalent if all component values are within COLOR_TOLERANCE of each other.



18
19
20
21
22
23
24
25
 
# File 'lib/color_lib/cmyk.rb', line 18

def ==(other)
  other = other.to_cmyk
  other.kind_of?(ColorLib::CMYK) and
    ((@c - other.c).abs <= ColorLib::COLOR_TOLERANCE) and
    ((@m - other.m).abs <= ColorLib::COLOR_TOLERANCE) and
    ((@y - other.y).abs <= ColorLib::COLOR_TOLERANCE) and
    ((@k - other.k).abs <= ColorLib::COLOR_TOLERANCE)
end

#black ⇒ Object

Returns the black (K) component of the CMYK colour as a percentage value.



260
261
262
 
# File 'lib/color_lib/cmyk.rb', line 260

def black
  @k * 100.0
end

#black=(kk) ⇒ Object

Sets the black (K) component of the CMYK colour as a percentage value.



271
272
273
 
# File 'lib/color_lib/cmyk.rb', line 271

def black=(kk)
  @k = ColorLib.normalize(kk / 100.0)
end

#c ⇒ Object

Returns the cyan © component of the CMYK colour as a value in the range 0.0 .. 1.0.



197
198
199
 
# File 'lib/color_lib/cmyk.rb', line 197

def c
  @c
end

#c=(cc) ⇒ Object

Sets the cyan © component of the CMYK colour as a value in the range 0.0 .. 1.0.



208
209
210
 
# File 'lib/color_lib/cmyk.rb', line 208

def c=(cc)
  @c = ColorLib.normalize(cc)
end

#css_hsl ⇒ Object

Present the colour as an HSL HTML/CSS colour string (e.g., “hsl(180, 25%, 35%)”). Note that this will perform a #to_hsl operation using the default conversion formula.



94
95
96
 
# File 'lib/color_lib/cmyk.rb', line 94

def css_hsl
  to_hsl.css_hsl
end

#css_hsla ⇒ Object

Present the colour as an HSLA (with alpha) HTML/CSS colour string (e.g., “hsla(180, 25%, 35%, 1)”). Note that this will perform a #to_hsl operation using the default conversion formula.



101
102
103
 
# File 'lib/color_lib/cmyk.rb', line 101

def css_hsla
  to_hsl.css_hsla
end

#css_rgb ⇒ Object

Present the colour as an RGB HTML/CSS colour string (e.g., “rgb(0%, 50%, 100%)”). Note that this will perform a #to_rgb operation using the default conversion formula.



80
81
82
 
# File 'lib/color_lib/cmyk.rb', line 80

def css_rgb
  to_rgb.css_rgb
end

#css_rgba ⇒ Object

Present the colour as an RGBA (with alpha) HTML/CSS colour string (e.g., “rgb(0%, 50%, 100%, 1)”). Note that this will perform a #to_rgb operation using the default conversion formula.



87
88
89
 
# File 'lib/color_lib/cmyk.rb', line 87

def css_rgba
  to_rgb.css_rgba
end

#cyan ⇒ Object

Returns the cyan © component of the CMYK colour as a percentage value.



191
192
193
 
# File 'lib/color_lib/cmyk.rb', line 191

def cyan
  @c * 100.0
end

#cyan=(cc) ⇒ Object

Sets the cyan © component of the CMYK colour as a percentage value.



202
203
204
 
# File 'lib/color_lib/cmyk.rb', line 202

def cyan=(cc)
  @c = ColorLib.normalize(cc / 100.0)
end

#html ⇒ Object

Present the colour as an RGB HTML/CSS colour string (e.g., “#aabbcc”). Note that this will perform a #to_rgb operation using the default conversion formula.



73
74
75
 
# File 'lib/color_lib/cmyk.rb', line 73

def html
  to_rgb.html
end

#inspect ⇒ Object 



176
177
178
 
# File 'lib/color_lib/cmyk.rb', line 176

def inspect
  "CMYK [%.2f%%, %.2f%%, %.2f%%, %.2f%%]" % [cyan, magenta, yellow, black]
end

#k ⇒ Object

Returns the black (K) component of the CMYK colour as a value in the range 0.0 .. 1.0.



266
267
268
 
# File 'lib/color_lib/cmyk.rb', line 266

def k
  @k
end

#k=(kk) ⇒ Object

Sets the black (K) component of the CMYK colour as a value in the range 0.0 .. 1.0.



277
278
279
 
# File 'lib/color_lib/cmyk.rb', line 277

def k=(kk)
  @k = ColorLib.normalize(kk)
end

#m ⇒ Object

Returns the magenta (M) component of the CMYK colour as a value in the range 0.0 .. 1.0.



220
221
222
 
# File 'lib/color_lib/cmyk.rb', line 220

def m
  @m
end

#m=(mm) ⇒ Object

Sets the magenta (M) component of the CMYK colour as a value in the range 0.0 .. 1.0.



231
232
233
 
# File 'lib/color_lib/cmyk.rb', line 231

def m=(mm)
  @m = ColorLib.normalize(mm)
end

#magenta ⇒ Object

Returns the magenta (M) component of the CMYK colour as a percentage value.



214
215
216
 
# File 'lib/color_lib/cmyk.rb', line 214

def magenta
  @m * 100.0
end

#magenta=(mm) ⇒ Object

Sets the magenta (M) component of the CMYK colour as a percentage value.



225
226
227
 
# File 'lib/color_lib/cmyk.rb', line 225

def magenta=(mm)
  @m = ColorLib.normalize(mm / 100.0)
end

#pdf_fill ⇒ Object

Present the colour as a DeviceCMYK fill colour string for PDF. This will be removed from the default package in color-tools 2.0.



60
61
62
 
# File 'lib/color_lib/cmyk.rb', line 60

def pdf_fill
  PDF_FORMAT_STR % [@c, @m, @y, @k, "k"]
end

#pdf_stroke ⇒ Object

Present the colour as a DeviceCMYK stroke colour string for PDF. This will be removed from the default package in color-tools 2.0.



66
67
68
 
# File 'lib/color_lib/cmyk.rb', line 66

def pdf_stroke
  PDF_FORMAT_STR % [@c, @m, @y, @k, "K"]
end

#to_cmyk ⇒ Object 



172
173
174
 
# File 'lib/color_lib/cmyk.rb', line 172

def to_cmyk
  self
end

#to_grayscale ⇒ Object Also known as: to_greyscale

Converts the CMYK colour to a single greyscale value. There are undoubtedly multiple methods for this conversion, but only a minor variant of the Adobe conversion method will be used:

g = 1.0 - min(1.0, 0.299 * c + 0.587 * m + 0.114 * y + k)

This treats the CMY values similarly to YIQ (NTSC) values and then adds the level of black. This is a variant of the Adobe version because it uses the more precise YIQ (NTSC) conversion values for Y (intensity) rather than the approximates provided by Adobe (0.3, 0.59, and 0.11).



162
163
164
165
166
167
168
 
# File 'lib/color_lib/cmyk.rb', line 162

def to_grayscale
  c = 0.299 * @c.to_f
  m = 0.587 * @m.to_f
  y = 0.114 * @y.to_f
  g = 1.0 - [1.0, c + m + y + @k].min
  ColorLib::GrayScale.from_fraction(g)
end

#to_hsl ⇒ Object

Converts to RGB then HSL.



186
187
188
 
# File 'lib/color_lib/cmyk.rb', line 186

def to_hsl
  to_rgb.to_hsl
end

#to_rgb(use_adobe_method = false) ⇒ Object

Converts the CMYK colour to RGB. Most colour experts strongly suggest that this is not a good idea (some even suggesting that it’s a very bad idea). CMYK represents additive percentages of inks on white paper, whereas RGB represents mixed colour intensities on a black screen.

However, the colour conversion can be done, and there are two different methods for the conversion that provide slightly different results. Adobe PDF conversions are done with the first form.

  # Adobe PDF Display Formula
r = 1.0 - min(1.0, c + k)
g = 1.0 - min(1.0, m + k)
b = 1.0 - min(1.0, y + k)

  # Other
r = 1.0 - (c * (1.0 - k) + k)
g = 1.0 - (m * (1.0 - k) + k)
b = 1.0 - (y * (1.0 - k) + k)

If we have a CMYK colour of [33% 66% 83% 25%], the first method will give an approximate RGB colour of (107, 23, 0) or #6b1700. The second method will give an approximate RGB colour of (128, 65, 33) or #804121. Which is correct? Although the colours may seem to be drastically different in the RGB colour space, they are very similar colours, differing mostly in intensity. The first is a darker, slightly redder brown; the second is a lighter brown.

Because of this subtlety, both methods are now offered for conversion. The Adobe method is not used by default; to enable it, pass true to #to_rgb.

Future versions of ColorLib may offer other conversion mechanisms that offer greater colour fidelity, including recognition of ICC colour profiles.



139
140
141
142
143
144
145
146
147
148
149
150
 
# File 'lib/color_lib/cmyk.rb', line 139

def to_rgb(use_adobe_method = false)
  if use_adobe_method
    r = 1.0 - [1.0, @c + @k].min
    g = 1.0 - [1.0, @m + @k].min
    b = 1.0 - [1.0, @y + @k].min
  else
    r = 1.0 - (@c.to_f * (1.0 - @k.to_f) + @k.to_f)
    g = 1.0 - (@m.to_f * (1.0 - @k.to_f) + @k.to_f)
    b = 1.0 - (@y.to_f * (1.0 - @k.to_f) + @k.to_f)
  end
  ColorLib::RGB.from_fraction(r, g, b)
end

#to_yiq ⇒ Object

Converts to RGB then YIQ.



181
182
183
 
# File 'lib/color_lib/cmyk.rb', line 181

def to_yiq
  to_rgb.to_yiq
end

#y ⇒ Object

Returns the yellow (Y) component of the CMYK colour as a value in the range 0.0 .. 1.0.



243
244
245
 
# File 'lib/color_lib/cmyk.rb', line 243

def y
  @y
end

#y=(kk) ⇒ Object

Sets the yellow (Y) component of the CMYK colour as a value in the range 0.0 .. 1.0.



254
255
256
 
# File 'lib/color_lib/cmyk.rb', line 254

def y=(kk)
  @y = ColorLib.normalize(kk)
end

#yellow ⇒ Object

Returns the yellow (Y) component of the CMYK colour as a percentage value.



237
238
239
 
# File 'lib/color_lib/cmyk.rb', line 237

def yellow
  @y * 100.0
end

#yellow=(yy) ⇒ Object

Sets the yellow (Y) component of the CMYK colour as a percentage value.



248
249
250
 
# File 'lib/color_lib/cmyk.rb', line 248

def yellow=(yy)
  @y = ColorLib.normalize(yy / 100.0)
end