atome 0.4.7.0 → 0.5.1.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Gemfile +1 -1
- data/README.md +7 -4
- data/Rakefile +22 -13
- data/app_builder_helpers/Rakefile +63 -21
- data/exe/atome +91 -45
- data/lib/atome/atome_meta_engine.rb +132 -0
- data/lib/atome/extensions/atome.rb +41 -0
- data/lib/atome/{kernel/helpers → extensions}/geolocation.rb +0 -0
- data/lib/atome/{kernel/helpers → extensions}/ping.rb +0 -0
- data/lib/atome/{kernel/helpers → extensions}/sha.rb +3 -1
- data/lib/atome/genesis/generators/atome.rb +13 -0
- data/lib/atome/{renderers/headless/properties/generator.rb → genesis/generators/communication.rb} +2 -0
- data/lib/atome/genesis/generators/effect.rb +6 -0
- data/lib/atome/genesis/generators/event.rb +5 -0
- data/lib/atome/genesis/generators/geometry.rb +6 -0
- data/lib/atome/genesis/generators/identity.rb +15 -0
- data/lib/atome/genesis/generators/material.rb +10 -0
- data/lib/atome/genesis/generators/spatial.rb +12 -0
- data/lib/atome/genesis/generators/utility.rb +14 -0
- data/lib/atome/genesis/genesis.rb +51 -0
- data/lib/atome/genesis/sparkle.rb +58 -0
- data/lib/atome/helpers/color_helper/color/cmyk.rb +263 -0
- data/lib/atome/helpers/color_helper/color/css.rb +7 -0
- data/lib/atome/helpers/color_helper/color/grayscale.rb +197 -0
- data/lib/atome/helpers/color_helper/color/hsl.rb +240 -0
- data/lib/atome/helpers/color_helper/color/palette/adobecolor.rb +260 -0
- data/lib/atome/helpers/color_helper/color/palette/gimp.rb +104 -0
- data/lib/atome/helpers/color_helper/color/palette/monocontrast.rb +164 -0
- data/lib/atome/helpers/color_helper/color/palette.rb +4 -0
- data/lib/atome/helpers/color_helper/color/rgb/colors.rb +167 -0
- data/lib/atome/helpers/color_helper/color/rgb/contrast.rb +57 -0
- data/lib/atome/helpers/color_helper/color/rgb/metallic.rb +28 -0
- data/lib/atome/helpers/color_helper/color/rgb.rb +715 -0
- data/lib/atome/helpers/color_helper/color/yiq.rb +62 -0
- data/lib/atome/helpers/color_helper/color.rb +196 -0
- data/lib/atome/helpers/essentials.rb +42 -0
- data/lib/atome/helpers/sanitizer.rb +42 -0
- data/lib/atome/helpers/utilities.rb +57 -0
- data/lib/atome/kernel/essentials.rb +30 -0
- data/lib/atome/kernel/universe.rb +75 -26
- data/lib/atome/presets/atome.rb +66 -0
- data/lib/atome/processors/utilities.rb +10 -0
- data/lib/atome/renderers/browser/atome.rb +95 -0
- data/lib/atome/renderers/browser/browser.rb +158 -0
- data/lib/atome/renderers/browser/effect.rb +23 -0
- data/lib/atome/renderers/browser/event.rb +9 -0
- data/lib/atome/renderers/browser/geometry.rb +11 -0
- data/lib/atome/renderers/browser/identity.rb +20 -0
- data/lib/atome/renderers/browser/material.rb +43 -0
- data/lib/atome/renderers/{opal → browser}/opal_browser.rb +0 -2
- data/lib/atome/renderers/browser/spatial.rb +22 -0
- data/lib/atome/renderers/browser/utility.rb +26 -0
- data/lib/atome/renderers/html/atome.rb +47 -0
- data/lib/atome/renderers/html/effect.rb +19 -0
- data/lib/atome/renderers/html/event.rb +9 -0
- data/lib/atome/renderers/html/geometry.rb +11 -0
- data/lib/atome/renderers/html/html.rb +42 -0
- data/lib/atome/renderers/html/identity.rb +14 -0
- data/lib/atome/renderers/html/opal_browser.rb +6 -0
- data/lib/atome/renderers/html/spatial.rb +28 -0
- data/lib/atome/renderers/html/utility.rb +15 -0
- data/lib/atome/renderers/opal/atome_opal_extensions.rb +1 -1
- data/lib/atome/renderers/opal/extensions/atome.rb +29 -0
- data/lib/atome/renderers/opal/opal.rb +4 -0
- data/lib/atome/version.rb +1 -2
- data/lib/atome.rb +22 -45
- data/vendor/assets/application/index.rb +3 -1
- data/vendor/assets/application/required_example.rb +1 -0
- data/{lib/atome/renderers/headless/headless.rb → vendor/assets/aui.rb} +0 -0
- data/vendor/assets/build/css/style.css +51 -0
- data/vendor/assets/build/index.html +10 -7
- data/vendor/assets/build/js/atome/atome.js +61 -61
- data/{lib/atome/renderers/server/server.rb → vendor/assets/build/medias/rubies/examples/_animation.rb} +0 -0
- data/vendor/assets/build/medias/rubies/examples/_code.rb +12 -0
- data/vendor/assets/build/medias/rubies/examples/_id.rb +14 -0
- data/vendor/assets/build/medias/rubies/examples/_link.rb +17 -0
- data/vendor/assets/build/medias/rubies/examples/{on.rb → _on.rb} +3 -1
- data/vendor/assets/build/medias/rubies/examples/{read.rb → _read.rb} +2 -0
- data/vendor/assets/build/medias/rubies/examples/_refresh.rb +9 -0
- data/vendor/assets/build/medias/rubies/examples/atome.new.rb +13 -10
- data/vendor/assets/build/medias/rubies/examples/auto_height.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/auto_width.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/blur.rb +4 -0
- data/vendor/assets/build/medias/rubies/examples/bottom.rb +3 -1
- data/vendor/assets/build/medias/rubies/examples/box.rb +15 -8
- data/vendor/assets/build/medias/rubies/examples/circle.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/clear.rb +2 -1
- data/vendor/assets/build/medias/rubies/examples/color.rb +47 -8
- data/vendor/assets/build/medias/rubies/examples/create_atome_in_atome.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/delete.rb +7 -0
- data/vendor/assets/build/medias/rubies/examples/drag.rb +1 -0
- data/vendor/assets/build/medias/rubies/examples/element.rb +6 -0
- data/vendor/assets/build/medias/rubies/examples/get_renderer_list.rb +3 -1
- data/vendor/assets/build/medias/rubies/examples/grab.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/height.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/image.rb +6 -2
- data/vendor/assets/build/medias/rubies/examples/left.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/monitoring.rb +20 -0
- data/vendor/assets/build/medias/rubies/examples/parent.rb +7 -5
- data/vendor/assets/build/medias/rubies/examples/repeat.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/right.rb +3 -1
- data/vendor/assets/build/medias/rubies/examples/schedule.rb +0 -4
- data/vendor/assets/build/medias/rubies/examples/shadow.rb +30 -0
- data/vendor/assets/build/medias/rubies/examples/text.rb +21 -7
- data/vendor/assets/build/medias/rubies/examples/touch.rb +2 -0
- data/vendor/assets/build/medias/rubies/examples/video.rb +2 -2
- data/vendor/assets/build/medias/rubies/examples/web.rb +2 -2
- data/vendor/assets/server/atome_server.rb +3 -5
- metadata +74 -174
- data/lib/atome/atome_native_extensions.rb +0 -5
- data/lib/atome/extensions/helper.rb +0 -112
- data/lib/atome/kernel/atome.rb +0 -99
- data/lib/atome/kernel/generators/generator.rb +0 -517
- data/lib/atome/kernel/generators/genesis.rb +0 -277
- data/lib/atome/kernel/generators/sanitizer.rb +0 -73
- data/lib/atome/kernel/generators/shapes.rb +0 -55
- data/lib/atome/kernel/helpers/internal_methods.rb +0 -173
- data/lib/atome/kernel/helpers/utilities.rb +0 -39
- data/lib/atome/kernel/properties/essential.rb +0 -77
- data/lib/atome/kernel/sparkle.rb +0 -38
- data/lib/atome/renderers/opal/properties/generator.rb +0 -1
- data/lib/atome/renderers/renderer.rb +0 -13
- data/lib/atome/renderers/server/properties/generator.rb +0 -9
- data/vendor/assets/build/js/application.js +0 -0
- data/vendor/assets/build/medias/audios/guitar.wav +0 -0
- data/vendor/assets/build/medias/images/beach.jpg +0 -0
- data/vendor/assets/build/medias/rubies/examples/Old_examples/!demos.rb +0 -111
- data/vendor/assets/build/medias/rubies/examples/Old_examples/action.rb +0 -12
- data/vendor/assets/build/medias/rubies/examples/Old_examples/add.rb +0 -26
- data/vendor/assets/build/medias/rubies/examples/Old_examples/alignment.rb +0 -27
- data/vendor/assets/build/medias/rubies/examples/Old_examples/animation.rb +0 -92
- data/vendor/assets/build/medias/rubies/examples/Old_examples/atome_as_property.rb +0 -20
- data/vendor/assets/build/medias/rubies/examples/Old_examples/atome_list.rb +0 -4
- data/vendor/assets/build/medias/rubies/examples/Old_examples/atomiser.rb +0 -17
- data/vendor/assets/build/medias/rubies/examples/Old_examples/attach_extract.rb +0 -13
- data/vendor/assets/build/medias/rubies/examples/Old_examples/authorisation.rb +0 -22
- data/vendor/assets/build/medias/rubies/examples/Old_examples/batch.rb +0 -6
- data/vendor/assets/build/medias/rubies/examples/Old_examples/blend.rb +0 -15
- data/vendor/assets/build/medias/rubies/examples/Old_examples/blur.rb +0 -9
- data/vendor/assets/build/medias/rubies/examples/Old_examples/border.rb +0 -9
- data/vendor/assets/build/medias/rubies/examples/Old_examples/calendar.rb +0 -5
- data/vendor/assets/build/medias/rubies/examples/Old_examples/capture.rb +0 -57
- data/vendor/assets/build/medias/rubies/examples/Old_examples/center.rb +0 -21
- data/vendor/assets/build/medias/rubies/examples/Old_examples/child.rb +0 -18
- data/vendor/assets/build/medias/rubies/examples/Old_examples/clear.rb +0 -21
- data/vendor/assets/build/medias/rubies/examples/Old_examples/clip.rb +0 -11
- data/vendor/assets/build/medias/rubies/examples/Old_examples/code.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/code_editor.rb +0 -26
- data/vendor/assets/build/medias/rubies/examples/Old_examples/collaborate.rb +0 -115
- data/vendor/assets/build/medias/rubies/examples/Old_examples/convert_to_px.rb +0 -14
- data/vendor/assets/build/medias/rubies/examples/Old_examples/copy_paste.rb +0 -35
- data/vendor/assets/build/medias/rubies/examples/Old_examples/current_code.rb +0 -14
- data/vendor/assets/build/medias/rubies/examples/Old_examples/cursor.rb +0 -3
- data/vendor/assets/build/medias/rubies/examples/Old_examples/data.rb +0 -11
- data/vendor/assets/build/medias/rubies/examples/Old_examples/database.rb +0 -29
- data/vendor/assets/build/medias/rubies/examples/Old_examples/delete.rb +0 -12
- data/vendor/assets/build/medias/rubies/examples/Old_examples/display.rb +0 -19
- data/vendor/assets/build/medias/rubies/examples/Old_examples/disposition.rb +0 -10
- data/vendor/assets/build/medias/rubies/examples/Old_examples/double_and_long_touch.rb +0 -23
- data/vendor/assets/build/medias/rubies/examples/Old_examples/drag.rb +0 -61
- data/vendor/assets/build/medias/rubies/examples/Old_examples/drag_and_drop_import.rb +0 -1
- data/vendor/assets/build/medias/rubies/examples/Old_examples/drop.rb +0 -23
- data/vendor/assets/build/medias/rubies/examples/Old_examples/duplicate.rb +0 -11
- data/vendor/assets/build/medias/rubies/examples/Old_examples/edit.rb +0 -6
- data/vendor/assets/build/medias/rubies/examples/Old_examples/eval.rb +0 -9
- data/vendor/assets/build/medias/rubies/examples/Old_examples/extract_detach.rb +0 -23
- data/vendor/assets/build/medias/rubies/examples/Old_examples/fill.rb +0 -10
- data/vendor/assets/build/medias/rubies/examples/Old_examples/find.rb +0 -37
- data/vendor/assets/build/medias/rubies/examples/Old_examples/fit.rb +0 -44
- data/vendor/assets/build/medias/rubies/examples/Old_examples/fullscreen.rb +0 -28
- data/vendor/assets/build/medias/rubies/examples/Old_examples/generate.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/gradient.rb +0 -24
- data/vendor/assets/build/medias/rubies/examples/Old_examples/group.rb +0 -21
- data/vendor/assets/build/medias/rubies/examples/Old_examples/helper.rb +0 -64
- data/vendor/assets/build/medias/rubies/examples/Old_examples/history.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/hue.rb +0 -10
- data/vendor/assets/build/medias/rubies/examples/Old_examples/input_text.rb +0 -54
- data/vendor/assets/build/medias/rubies/examples/Old_examples/insert_attach.rb +0 -13
- data/vendor/assets/build/medias/rubies/examples/Old_examples/internationalisation.rb +0 -10
- data/vendor/assets/build/medias/rubies/examples/Old_examples/key.rb +0 -19
- data/vendor/assets/build/medias/rubies/examples/Old_examples/keyboard_shortcut.rb +0 -69
- data/vendor/assets/build/medias/rubies/examples/Old_examples/list_methods.rb +0 -4
- data/vendor/assets/build/medias/rubies/examples/Old_examples/list_types.rb +0 -4
- data/vendor/assets/build/medias/rubies/examples/Old_examples/listen.rb +0 -47
- data/vendor/assets/build/medias/rubies/examples/Old_examples/mail.rb +0 -9
- data/vendor/assets/build/medias/rubies/examples/Old_examples/map.rb +0 -6
- data/vendor/assets/build/medias/rubies/examples/Old_examples/mask.rb +0 -15
- data/vendor/assets/build/medias/rubies/examples/Old_examples/media_recorder.rb +0 -24
- data/vendor/assets/build/medias/rubies/examples/Old_examples/media_streaming.rb +0 -41
- data/vendor/assets/build/medias/rubies/examples/Old_examples/meteo.rb +0 -41
- data/vendor/assets/build/medias/rubies/examples/Old_examples/methods_chaining.rb +0 -8
- data/vendor/assets/build/medias/rubies/examples/Old_examples/midi.rb +0 -37
- data/vendor/assets/build/medias/rubies/examples/Old_examples/monitoring.rb +0 -47
- data/vendor/assets/build/medias/rubies/examples/Old_examples/mulitrendering.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/noise_gradient_texture.rb +0 -26
- data/vendor/assets/build/medias/rubies/examples/Old_examples/notification.rb +0 -9
- data/vendor/assets/build/medias/rubies/examples/Old_examples/object_in_object.rb +0 -13
- data/vendor/assets/build/medias/rubies/examples/Old_examples/on_resize.rb +0 -12
- data/vendor/assets/build/medias/rubies/examples/Old_examples/over.rb +0 -15
- data/vendor/assets/build/medias/rubies/examples/Old_examples/overflow.rb +0 -22
- data/vendor/assets/build/medias/rubies/examples/Old_examples/parameter.rb +0 -14
- data/vendor/assets/build/medias/rubies/examples/Old_examples/parent.rb +0 -19
- data/vendor/assets/build/medias/rubies/examples/Old_examples/particle.rb +0 -15
- data/vendor/assets/build/medias/rubies/examples/Old_examples/pay.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/ping.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/play.rb +0 -24
- data/vendor/assets/build/medias/rubies/examples/Old_examples/play_audio.rb +0 -6
- data/vendor/assets/build/medias/rubies/examples/Old_examples/position.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/read_file.rb +0 -9
- data/vendor/assets/build/medias/rubies/examples/Old_examples/reboot.rb +0 -15
- data/vendor/assets/build/medias/rubies/examples/Old_examples/refresh.rb +0 -17
- data/vendor/assets/build/medias/rubies/examples/Old_examples/remote_server.rb +0 -31
- data/vendor/assets/build/medias/rubies/examples/Old_examples/render.rb +0 -17
- data/vendor/assets/build/medias/rubies/examples/Old_examples/repeat.rb +0 -19
- data/vendor/assets/build/medias/rubies/examples/Old_examples/require_remote.rb +0 -3
- data/vendor/assets/build/medias/rubies/examples/Old_examples/restore_atome.rb +0 -11
- data/vendor/assets/build/medias/rubies/examples/Old_examples/resurect.rb +0 -30
- data/vendor/assets/build/medias/rubies/examples/Old_examples/ruby_version.rb +0 -1
- data/vendor/assets/build/medias/rubies/examples/Old_examples/say.rb +0 -3
- data/vendor/assets/build/medias/rubies/examples/Old_examples/scale.rb +0 -41
- data/vendor/assets/build/medias/rubies/examples/Old_examples/schedule.rb +0 -39
- data/vendor/assets/build/medias/rubies/examples/Old_examples/scroll.rb +0 -9
- data/vendor/assets/build/medias/rubies/examples/Old_examples/select.rb +0 -32
- data/vendor/assets/build/medias/rubies/examples/Old_examples/selector.rb +0 -6
- data/vendor/assets/build/medias/rubies/examples/Old_examples/shadow.rb +0 -30
- data/vendor/assets/build/medias/rubies/examples/Old_examples/shape_with_path.rb +0 -7
- data/vendor/assets/build/medias/rubies/examples/Old_examples/size.rb +0 -109
- data/vendor/assets/build/medias/rubies/examples/Old_examples/smooth.rb +0 -5
- data/vendor/assets/build/medias/rubies/examples/Old_examples/speech_renderer.rb +0 -5
- data/vendor/assets/build/medias/rubies/examples/Old_examples/synth.rb +0 -6
- data/vendor/assets/build/medias/rubies/examples/Old_examples/system.rb +0 -3
- data/vendor/assets/build/medias/rubies/examples/Old_examples/tags.rb +0 -18
- data/vendor/assets/build/medias/rubies/examples/Old_examples/text.rb +0 -33
- data/vendor/assets/build/medias/rubies/examples/Old_examples/text_selection.rb +0 -33
- data/vendor/assets/build/medias/rubies/examples/Old_examples/text_to_midi.rb +0 -22
- data/vendor/assets/build/medias/rubies/examples/Old_examples/touch.rb +0 -23
- data/vendor/assets/build/medias/rubies/examples/Old_examples/touch_stop_propagation.rb +0 -27
- data/vendor/assets/build/medias/rubies/examples/Old_examples/treat_object_in_object.rb +0 -26
- data/vendor/assets/build/medias/rubies/examples/Old_examples/type_mutations.rb +0 -27
- data/vendor/assets/build/medias/rubies/examples/Old_examples/video_callback.rb +0 -46
- data/vendor/assets/build/medias/rubies/examples/Old_examples/view_mode.rb +0 -29
- data/vendor/assets/build/medias/rubies/examples/Old_examples/virtual_events.rb +0 -17
- data/vendor/assets/build/medias/rubies/examples/Old_examples/visual.rb +0 -23
- data/vendor/assets/build/medias/rubies/examples/Old_examples/vr_display.rb +0 -5
- data/vendor/assets/build/medias/rubies/examples/Old_examples/wait.rb +0 -21
- data/vendor/assets/build/medias/rubies/examples/Old_examples/web.rb +0 -10
- data/vendor/assets/build/medias/rubies/examples/Old_examples/web_address_bar.rb +0 -14
- data/vendor/assets/build/medias/rubies/examples/Old_examples/websocket.rb +0 -16
- data/vendor/assets/build/medias/rubies/examples/Old_examples/webstate.rb +0 -10
- data/vendor/assets/build/medias/rubies/examples/animation.rb +0 -0
- data/vendor/assets/build/medias/rubies/examples/code.rb +0 -5
- data/vendor/assets/build/medias/rubies/examples/link.rb +0 -11
- data/vendor/assets/build/medias/videos/avengers.mp4 +0 -0
- data/vendor/assets/build/medias/videos/lion_king.mp4 +0 -0
- data/vendor/assets/build/medias/videos/madmax.mp4 +0 -0
- data/vendor/assets/build/medias/videos/starwars.mov +0 -0
- data/vendor/assets/build/medias/videos/superman.mp4 +0 -0
@@ -0,0 +1,715 @@
|
|
1
|
+
# An RGB colour object.
|
2
|
+
class Color::RGB
|
3
|
+
include Color
|
4
|
+
|
5
|
+
# The format of a DeviceRGB colour for PDF. In color-tools 2.0 this will
|
6
|
+
# be removed from this package and added back as a modification by the
|
7
|
+
# PDF::Writer package.
|
8
|
+
PDF_FORMAT_STR = "%.3f %.3f %.3f %s"
|
9
|
+
|
10
|
+
# Coerces the other Color object into RGB.
|
11
|
+
def coerce(other)
|
12
|
+
other.to_rgb
|
13
|
+
end
|
14
|
+
|
15
|
+
# Creates an RGB colour object from the standard range 0..255.
|
16
|
+
#
|
17
|
+
# Color::RGB.new(32, 64, 128)
|
18
|
+
# Color::RGB.new(0x20, 0x40, 0x80)
|
19
|
+
def initialize(r = 0, g = 0, b = 0, radix = 255.0, &block) # :yields self:
|
20
|
+
@r, @g, @b = [ r, g, b ].map { |v| Color.normalize(v / radix) }
|
21
|
+
block.call(self) if block
|
22
|
+
end
|
23
|
+
|
24
|
+
# Present the colour as a DeviceRGB fill colour string for PDF. This will
|
25
|
+
# be removed from the default package in color-tools 2.0.
|
26
|
+
def pdf_fill
|
27
|
+
PDF_FORMAT_STR % [ @r, @g, @b, "rg" ]
|
28
|
+
end
|
29
|
+
|
30
|
+
# Present the colour as a DeviceRGB stroke colour string for PDF. This
|
31
|
+
# will be removed from the default package in color-tools 2.0.
|
32
|
+
def pdf_stroke
|
33
|
+
PDF_FORMAT_STR % [ @r, @g, @b, "RG" ]
|
34
|
+
end
|
35
|
+
|
36
|
+
# Present the colour as an RGB hex triplet.
|
37
|
+
def hex
|
38
|
+
r = (@r * 255).round
|
39
|
+
r = 255 if r > 255
|
40
|
+
|
41
|
+
g = (@g * 255).round
|
42
|
+
g = 255 if g > 255
|
43
|
+
|
44
|
+
b = (@b * 255).round
|
45
|
+
b = 255 if b > 255
|
46
|
+
|
47
|
+
"%02x%02x%02x" % [ r, g, b ]
|
48
|
+
end
|
49
|
+
|
50
|
+
# Present the colour as an HTML/CSS colour string.
|
51
|
+
def html
|
52
|
+
"##{hex}"
|
53
|
+
end
|
54
|
+
|
55
|
+
# Present the colour as an RGB HTML/CSS colour string (e.g., "rgb(0%, 50%,
|
56
|
+
# 100%)"). Note that this will perform a #to_rgb operation using the
|
57
|
+
# default conversion formula.
|
58
|
+
def css_rgb
|
59
|
+
"rgb(%3.2f%%, %3.2f%%, %3.2f%%)" % [ red_p, green_p, blue_p ]
|
60
|
+
end
|
61
|
+
|
62
|
+
# Present the colour as an RGBA (with an optional alpha that defaults to 1)
|
63
|
+
# HTML/CSS colour string (e.g.,"rgb(0%, 50%, 100%, 1)"). Note that this will
|
64
|
+
# perform a #to_rgb operation using the default conversion formula.
|
65
|
+
#
|
66
|
+
# Color::RGB.by_hex('ff0000').css_rgba
|
67
|
+
# => 'rgba(100.00%, 0.00%, 0.00%, 1.00)'
|
68
|
+
# Color::RGB.by_hex('ff0000').css_rgba(0.2)
|
69
|
+
# => 'rgba(100.00%, 0.00%, 0.00%, 0.20)'
|
70
|
+
def css_rgba(alpha = 1)
|
71
|
+
"rgba(%3.2f%%, %3.2f%%, %3.2f%%, %3.2f)" % [ red_p, green_p, blue_p, alpha ]
|
72
|
+
end
|
73
|
+
|
74
|
+
# Present the colour as an HSL HTML/CSS colour string (e.g., "hsl(180,
|
75
|
+
# 25%, 35%)"). Note that this will perform a #to_hsl operation using the
|
76
|
+
# default conversion formula.
|
77
|
+
def css_hsl
|
78
|
+
to_hsl.css_hsl
|
79
|
+
end
|
80
|
+
|
81
|
+
# Present the colour as an HSLA (with alpha) HTML/CSS colour string (e.g.,
|
82
|
+
# "hsla(180, 25%, 35%, 1)"). Note that this will perform a #to_hsl
|
83
|
+
# operation using the default conversion formula.
|
84
|
+
def css_hsla
|
85
|
+
to_hsl.css_hsla
|
86
|
+
end
|
87
|
+
|
88
|
+
# Converts the RGB colour to CMYK. Most colour experts strongly suggest
|
89
|
+
# that this is not a good idea (some even suggesting that it's a very bad
|
90
|
+
# idea). CMYK represents additive percentages of inks on white paper,
|
91
|
+
# whereas RGB represents mixed colour intensities on a black screen.
|
92
|
+
#
|
93
|
+
# However, the colour conversion can be done. The basic method is
|
94
|
+
# multi-step:
|
95
|
+
#
|
96
|
+
# 1. Convert the R, G, and B components to C, M, and Y components.
|
97
|
+
# c = 1.0 - r
|
98
|
+
# m = 1.0 - g
|
99
|
+
# y = 1.0 - b
|
100
|
+
# 2. Compute the minimum amount of black (K) required to smooth the colour
|
101
|
+
# in inks.
|
102
|
+
# k = min(c, m, y)
|
103
|
+
# 3. Perform undercolour removal on the C, M, and Y components of the
|
104
|
+
# colours because less of each colour is needed for each bit of black.
|
105
|
+
# Also, regenerate the black (K) based on the undercolour removal so
|
106
|
+
# that the colour is more accurately represented in ink.
|
107
|
+
# c = min(1.0, max(0.0, c - UCR(k)))
|
108
|
+
# m = min(1.0, max(0.0, m - UCR(k)))
|
109
|
+
# y = min(1.0, max(0.0, y - UCR(k)))
|
110
|
+
# k = min(1.0, max(0.0, BG(k)))
|
111
|
+
#
|
112
|
+
# The undercolour removal function and the black generation functions
|
113
|
+
# return a value based on the brightness of the RGB colour.
|
114
|
+
def to_cmyk
|
115
|
+
c = 1.0 - @r.to_f
|
116
|
+
m = 1.0 - @g.to_f
|
117
|
+
y = 1.0 - @b.to_f
|
118
|
+
|
119
|
+
k = [c, m, y].min
|
120
|
+
k = k - (k * brightness)
|
121
|
+
|
122
|
+
c = [1.0, [0.0, c - k].max].min
|
123
|
+
m = [1.0, [0.0, m - k].max].min
|
124
|
+
y = [1.0, [0.0, y - k].max].min
|
125
|
+
k = [1.0, [0.0, k].max].min
|
126
|
+
|
127
|
+
Color::CMYK.from_fraction(c, m, y, k)
|
128
|
+
end
|
129
|
+
|
130
|
+
def to_rgb(ignored = nil)
|
131
|
+
self
|
132
|
+
end
|
133
|
+
|
134
|
+
# Returns the YIQ (NTSC) colour encoding of the RGB value.
|
135
|
+
def to_yiq
|
136
|
+
y = (@r * 0.299) + (@g * 0.587) + (@b * 0.114)
|
137
|
+
i = (@r * 0.596) + (@g * -0.275) + (@b * -0.321)
|
138
|
+
q = (@r * 0.212) + (@g * -0.523) + (@b * 0.311)
|
139
|
+
Color::YIQ.from_fraction(y, i, q)
|
140
|
+
end
|
141
|
+
|
142
|
+
# Returns the HSL colour encoding of the RGB value. The conversions here
|
143
|
+
# are based on forumlas from http://www.easyrgb.com/math.php and
|
144
|
+
# elsewhere.
|
145
|
+
def to_hsl
|
146
|
+
min = [ @r, @g, @b ].min
|
147
|
+
max = [ @r, @g, @b ].max
|
148
|
+
delta = (max - min).to_f
|
149
|
+
|
150
|
+
lum = (max + min) / 2.0
|
151
|
+
|
152
|
+
if Color.near_zero?(delta) # close to 0.0, so it's a grey
|
153
|
+
hue = 0
|
154
|
+
sat = 0
|
155
|
+
else
|
156
|
+
if Color.near_zero_or_less?(lum - 0.5)
|
157
|
+
sat = delta / (max + min).to_f
|
158
|
+
else
|
159
|
+
sat = delta / (2 - max - min).to_f
|
160
|
+
end
|
161
|
+
|
162
|
+
# This is based on the conversion algorithm from
|
163
|
+
# http://en.wikipedia.org/wiki/HSV_color_space#Conversion_from_RGB_to_HSL_or_HSV
|
164
|
+
# Contributed by Adam Johnson
|
165
|
+
sixth = 1 / 6.0
|
166
|
+
if @r == max # Color.near_zero_or_less?(@r - max)
|
167
|
+
hue = (sixth * ((@g - @b) / delta))
|
168
|
+
hue += 1.0 if @g < @b
|
169
|
+
elsif @g == max # Color.near_zero_or_less(@g - max)
|
170
|
+
hue = (sixth * ((@b - @r) / delta)) + (1.0 / 3.0)
|
171
|
+
elsif @b == max # Color.near_zero_or_less?(@b - max)
|
172
|
+
hue = (sixth * ((@r - @g) / delta)) + (2.0 / 3.0)
|
173
|
+
end
|
174
|
+
|
175
|
+
hue += 1 if hue < 0
|
176
|
+
hue -= 1 if hue > 1
|
177
|
+
end
|
178
|
+
Color::HSL.from_fraction(hue, sat, lum)
|
179
|
+
end
|
180
|
+
|
181
|
+
# Returns the XYZ colour encoding of the value. Based on the
|
182
|
+
# {RGB to XYZ}[http://www.brucelindbloom.com/index.html?Eqn_RGB_to_XYZ.html]
|
183
|
+
# formula presented by Bruce Lindbloom.
|
184
|
+
#
|
185
|
+
# Currently only the sRGB colour space is supported.
|
186
|
+
def to_xyz(color_space = :sRGB)
|
187
|
+
unless color_space.to_s.downcase == 'srgb'
|
188
|
+
raise ArgumentError, "Unsupported colour space #{color_space}."
|
189
|
+
end
|
190
|
+
|
191
|
+
# Inverse sRGB companding. Linearizes RGB channels with respect to
|
192
|
+
# energy.
|
193
|
+
r, g, b = [ @r, @g, @b ].map { |v|
|
194
|
+
if (v > 0.04045)
|
195
|
+
(((v + 0.055) / 1.055) ** 2.4) * 100
|
196
|
+
else
|
197
|
+
(v / 12.92) * 100
|
198
|
+
end
|
199
|
+
}
|
200
|
+
|
201
|
+
# Convert using the RGB/XYZ matrix at:
|
202
|
+
# http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html#WSMatrices
|
203
|
+
{
|
204
|
+
:x => (r * 0.4124564 + g * 0.3575761 + b * 0.1804375),
|
205
|
+
:y => (r * 0.2126729 + g * 0.7151522 + b * 0.0721750),
|
206
|
+
:z => (r * 0.0193339 + g * 0.1191920 + b * 0.9503041)
|
207
|
+
}
|
208
|
+
end
|
209
|
+
|
210
|
+
# Returns the L*a*b* colour encoding of the value via the XYZ colour
|
211
|
+
# encoding. Based on the
|
212
|
+
# {XYZ to Lab}[http://www.brucelindbloom.com/index.html?Eqn_XYZ_to_Lab.html]
|
213
|
+
# formula presented by Bruce Lindbloom.
|
214
|
+
#
|
215
|
+
# Currently only the sRGB colour space is supported and defaults to using
|
216
|
+
# a D65 reference white.
|
217
|
+
def to_lab(color_space = :sRGB, reference_white = [ 95.047, 100.00, 108.883 ])
|
218
|
+
xyz = to_xyz
|
219
|
+
|
220
|
+
# Calculate the ratio of the XYZ values to the reference white.
|
221
|
+
# http://www.brucelindbloom.com/index.html?Equations.html
|
222
|
+
xr = xyz[:x] / reference_white[0]
|
223
|
+
yr = xyz[:y] / reference_white[1]
|
224
|
+
zr = xyz[:z] / reference_white[2]
|
225
|
+
|
226
|
+
# NOTE: This should be using Rational instead of floating point values,
|
227
|
+
# otherwise there will be discontinuities.
|
228
|
+
# http://www.brucelindbloom.com/LContinuity.html
|
229
|
+
epsilon = (216 / 24389.0)
|
230
|
+
kappa = (24389 / 27.0)
|
231
|
+
|
232
|
+
# And now transform
|
233
|
+
# http://en.wikipedia.org/wiki/Lab_color_space#Forward_transformation
|
234
|
+
# There is a brief explanation there as far as the nature of the calculations,
|
235
|
+
# as well as a much nicer looking modeling of the algebra.
|
236
|
+
fx, fy, fz = [ xr, yr, zr ].map { |t|
|
237
|
+
if (t > (epsilon))
|
238
|
+
t ** (1.0 / 3)
|
239
|
+
else # t <= epsilon
|
240
|
+
((kappa * t) + 16) / 116.0
|
241
|
+
# The 4/29 here is for when t = 0 (black). 4/29 * 116 = 16, and 16 -
|
242
|
+
# 16 = 0, which is the correct value for L* with black.
|
243
|
+
# ((1.0/3)*((29.0/6)**2) * t) + (4.0/29)
|
244
|
+
end
|
245
|
+
}
|
246
|
+
{
|
247
|
+
:L => ((116 * fy) - 16),
|
248
|
+
:a => (500 * (fx - fy)),
|
249
|
+
:b => (200 * (fy - fz))
|
250
|
+
}
|
251
|
+
end
|
252
|
+
|
253
|
+
# Mix the RGB hue with White so that the RGB hue is the specified
|
254
|
+
# percentage of the resulting colour. Strictly speaking, this isn't a
|
255
|
+
# darken_by operation.
|
256
|
+
def lighten_by(percent)
|
257
|
+
mix_with(White, percent)
|
258
|
+
end
|
259
|
+
|
260
|
+
# Mix the RGB hue with Black so that the RGB hue is the specified
|
261
|
+
# percentage of the resulting colour. Strictly speaking, this isn't a
|
262
|
+
# darken_by operation.
|
263
|
+
def darken_by(percent)
|
264
|
+
mix_with(Black, percent)
|
265
|
+
end
|
266
|
+
|
267
|
+
# Mix the mask colour (which must be an RGB object) with the current
|
268
|
+
# colour at the stated opacity percentage (0..100).
|
269
|
+
def mix_with(mask, opacity)
|
270
|
+
opacity /= 100.0
|
271
|
+
rgb = self.dup
|
272
|
+
|
273
|
+
rgb.r = (@r * opacity) + (mask.r * (1 - opacity))
|
274
|
+
rgb.g = (@g * opacity) + (mask.g * (1 - opacity))
|
275
|
+
rgb.b = (@b * opacity) + (mask.b * (1 - opacity))
|
276
|
+
|
277
|
+
rgb
|
278
|
+
end
|
279
|
+
|
280
|
+
# Returns the brightness value for a colour, a number between 0..1. Based
|
281
|
+
# on the Y value of YIQ encoding, representing luminosity, or perceived
|
282
|
+
# brightness.
|
283
|
+
#
|
284
|
+
# This may be modified in a future version of color-tools to use the
|
285
|
+
# luminosity value of HSL.
|
286
|
+
def brightness
|
287
|
+
to_yiq.y
|
288
|
+
end
|
289
|
+
# Convert to grayscale.
|
290
|
+
def to_grayscale
|
291
|
+
Color::GrayScale.from_fraction(to_hsl.l)
|
292
|
+
end
|
293
|
+
alias to_greyscale to_grayscale
|
294
|
+
|
295
|
+
# Returns a new colour with the brightness adjusted by the specified
|
296
|
+
# percentage. Negative percentages will darken the colour; positive
|
297
|
+
# percentages will brighten the colour.
|
298
|
+
#
|
299
|
+
# Color::RGB::DarkBlue.adjust_brightness(10)
|
300
|
+
# Color::RGB::DarkBlue.adjust_brightness(-10)
|
301
|
+
def adjust_brightness(percent)
|
302
|
+
percent = normalize_percent(percent)
|
303
|
+
hsl = to_hsl
|
304
|
+
hsl.l *= percent
|
305
|
+
hsl.to_rgb
|
306
|
+
end
|
307
|
+
|
308
|
+
# Returns a new colour with the saturation adjusted by the specified
|
309
|
+
# percentage. Negative percentages will reduce the saturation; positive
|
310
|
+
# percentages will increase the saturation.
|
311
|
+
#
|
312
|
+
# Color::RGB::DarkBlue.adjust_saturation(10)
|
313
|
+
# Color::RGB::DarkBlue.adjust_saturation(-10)
|
314
|
+
def adjust_saturation(percent)
|
315
|
+
percent = normalize_percent(percent)
|
316
|
+
hsl = to_hsl
|
317
|
+
hsl.s *= percent
|
318
|
+
hsl.to_rgb
|
319
|
+
end
|
320
|
+
|
321
|
+
# Returns a new colour with the hue adjusted by the specified percentage.
|
322
|
+
# Negative percentages will reduce the hue; positive percentages will
|
323
|
+
# increase the hue.
|
324
|
+
#
|
325
|
+
# Color::RGB::DarkBlue.adjust_hue(10)
|
326
|
+
# Color::RGB::DarkBlue.adjust_hue(-10)
|
327
|
+
def adjust_hue(percent)
|
328
|
+
percent = normalize_percent(percent)
|
329
|
+
hsl = to_hsl
|
330
|
+
hsl.h *= percent
|
331
|
+
hsl.to_rgb
|
332
|
+
end
|
333
|
+
|
334
|
+
# TODO: Identify the base colour profile used for L*a*b* and XYZ
|
335
|
+
# conversions.
|
336
|
+
|
337
|
+
# Calculates and returns the closest match to this colour from a list of
|
338
|
+
# provided colours. Returns +nil+ if +color_list+ is empty or if there is
|
339
|
+
# no colour within the +threshold_distance+.
|
340
|
+
#
|
341
|
+
# +threshold_distance+ is used to determine the minimum colour distance
|
342
|
+
# permitted. Uses the CIE Delta E 1994 algorithm (CIE94) to find near
|
343
|
+
# matches based on perceived visual colour. The default value (1000.0) is
|
344
|
+
# an arbitrarily large number. The values <tt>:jnd</tt> and
|
345
|
+
# <tt>:just_noticeable</tt> may be passed as the +threshold_distance+ to
|
346
|
+
# use the value <tt>2.3</tt>.
|
347
|
+
def closest_match(color_list, threshold_distance = 1000.0)
|
348
|
+
color_list = [ color_list ].flatten(1)
|
349
|
+
return nil if color_list.empty?
|
350
|
+
|
351
|
+
threshold_distance = case threshold_distance
|
352
|
+
when :jnd, :just_noticeable
|
353
|
+
2.3
|
354
|
+
else
|
355
|
+
threshold_distance.to_f
|
356
|
+
end
|
357
|
+
lab = to_lab
|
358
|
+
closest_distance = threshold_distance
|
359
|
+
best_match = nil
|
360
|
+
|
361
|
+
color_list.each do |c|
|
362
|
+
distance = delta_e94(lab, c.to_lab)
|
363
|
+
if (distance < closest_distance)
|
364
|
+
closest_distance = distance
|
365
|
+
best_match = c
|
366
|
+
end
|
367
|
+
end
|
368
|
+
best_match
|
369
|
+
end
|
370
|
+
|
371
|
+
# The Delta E (CIE94) algorithm
|
372
|
+
# http://en.wikipedia.org/wiki/Color_difference#CIE94
|
373
|
+
#
|
374
|
+
# There is a newer version, CIEDE2000, that uses slightly more complicated
|
375
|
+
# math, but addresses "the perceptual uniformity issue" left lingering by
|
376
|
+
# the CIE94 algorithm. color_1 and color_2 are both L*a*b* hashes,
|
377
|
+
# rendered by #to_lab.
|
378
|
+
#
|
379
|
+
# Since our source is treated as sRGB, we use the "graphic arts" presets
|
380
|
+
# for k_L, k_1, and k_2
|
381
|
+
#
|
382
|
+
# The calculations go through LCH(ab). (?)
|
383
|
+
#
|
384
|
+
# See also http://www.brucelindbloom.com/index.html?Eqn_DeltaE_CIE94.html
|
385
|
+
#
|
386
|
+
# NOTE: This should be moved to Color::Lab.
|
387
|
+
def delta_e94(color_1, color_2, weighting_type = :graphic_arts)
|
388
|
+
case weighting_type
|
389
|
+
when :graphic_arts
|
390
|
+
k_1 = 0.045
|
391
|
+
k_2 = 0.015
|
392
|
+
k_L = 1
|
393
|
+
when :textiles
|
394
|
+
k_1 = 0.048
|
395
|
+
k_2 = 0.014
|
396
|
+
k_L = 2
|
397
|
+
else
|
398
|
+
raise ArgumentError, "Unsupported weighting type #{weighting_type}."
|
399
|
+
end
|
400
|
+
|
401
|
+
# delta_E = Math.sqrt(
|
402
|
+
# ((delta_L / (k_L * s_L)) ** 2) +
|
403
|
+
# ((delta_C / (k_C * s_C)) ** 2) +
|
404
|
+
# ((delta_H / (k_H * s_H)) ** 2)
|
405
|
+
# )
|
406
|
+
#
|
407
|
+
# Under some circumstances in real computers, delta_H could be an
|
408
|
+
# imaginary number (it's a square root value), so we're going to treat
|
409
|
+
# this as:
|
410
|
+
#
|
411
|
+
# delta_E = Math.sqrt(
|
412
|
+
# ((delta_L / (k_L * s_L)) ** 2) +
|
413
|
+
# ((delta_C / (k_C * s_C)) ** 2) +
|
414
|
+
# (delta_H2 / ((k_H * s_H) ** 2)))
|
415
|
+
# )
|
416
|
+
#
|
417
|
+
# And not perform the square root when calculating delta_H2.
|
418
|
+
|
419
|
+
k_C = k_H = 1
|
420
|
+
|
421
|
+
l_1, a_1, b_1 = color_1.values_at(:L, :a, :b)
|
422
|
+
l_2, a_2, b_2 = color_2.values_at(:L, :a, :b)
|
423
|
+
|
424
|
+
delta_a = a_1 - a_2
|
425
|
+
delta_b = b_1 - b_2
|
426
|
+
|
427
|
+
c_1 = Math.sqrt((a_1 ** 2) + (b_1 ** 2))
|
428
|
+
c_2 = Math.sqrt((a_2 ** 2) + (b_2 ** 2))
|
429
|
+
|
430
|
+
delta_L = color_1[:L] - color_2[:L]
|
431
|
+
delta_C = c_1 - c_2
|
432
|
+
|
433
|
+
delta_H2 = (delta_a ** 2) + (delta_b ** 2) - (delta_C ** 2)
|
434
|
+
|
435
|
+
s_L = 1
|
436
|
+
s_C = 1 + k_1 * c_1
|
437
|
+
s_H = 1 + k_2 * c_1
|
438
|
+
|
439
|
+
composite_L = (delta_L / (k_L * s_L)) ** 2
|
440
|
+
composite_C = (delta_C / (k_C * s_C)) ** 2
|
441
|
+
composite_H = delta_H2 / ((k_H * s_H) ** 2)
|
442
|
+
Math.sqrt(composite_L + composite_C + composite_H)
|
443
|
+
end
|
444
|
+
|
445
|
+
# Returns the red component of the colour in the normal 0 .. 255 range.
|
446
|
+
def red
|
447
|
+
@r * 255.0
|
448
|
+
end
|
449
|
+
# Returns the red component of the colour as a percentage.
|
450
|
+
def red_p
|
451
|
+
@r * 100.0
|
452
|
+
end
|
453
|
+
# Returns the red component of the colour as a fraction in the range 0.0
|
454
|
+
# .. 1.0.
|
455
|
+
def r
|
456
|
+
@r
|
457
|
+
end
|
458
|
+
# Sets the red component of the colour in the normal 0 .. 255 range.
|
459
|
+
def red=(rr)
|
460
|
+
@r = Color.normalize(rr / 255.0)
|
461
|
+
end
|
462
|
+
# Sets the red component of the colour as a percentage.
|
463
|
+
def red_p=(rr)
|
464
|
+
@r = Color.normalize(rr / 100.0)
|
465
|
+
end
|
466
|
+
# Sets the red component of the colour as a fraction in the range 0.0 ..
|
467
|
+
# 1.0.
|
468
|
+
def r=(rr)
|
469
|
+
@r = Color.normalize(rr)
|
470
|
+
end
|
471
|
+
|
472
|
+
# Returns the green component of the colour in the normal 0 .. 255 range.
|
473
|
+
def green
|
474
|
+
@g * 255.0
|
475
|
+
end
|
476
|
+
# Returns the green component of the colour as a percentage.
|
477
|
+
def green_p
|
478
|
+
@g * 100.0
|
479
|
+
end
|
480
|
+
# Returns the green component of the colour as a fraction in the range 0.0
|
481
|
+
# .. 1.0.
|
482
|
+
def g
|
483
|
+
@g
|
484
|
+
end
|
485
|
+
# Sets the green component of the colour in the normal 0 .. 255 range.
|
486
|
+
def green=(gg)
|
487
|
+
@g = Color.normalize(gg / 255.0)
|
488
|
+
end
|
489
|
+
# Sets the green component of the colour as a percentage.
|
490
|
+
def green_p=(gg)
|
491
|
+
@g = Color.normalize(gg / 100.0)
|
492
|
+
end
|
493
|
+
# Sets the green component of the colour as a fraction in the range 0.0 ..
|
494
|
+
# 1.0.
|
495
|
+
def g=(gg)
|
496
|
+
@g = Color.normalize(gg)
|
497
|
+
end
|
498
|
+
|
499
|
+
# Returns the blue component of the colour in the normal 0 .. 255 range.
|
500
|
+
def blue
|
501
|
+
@b * 255.0
|
502
|
+
end
|
503
|
+
# Returns the blue component of the colour as a percentage.
|
504
|
+
def blue_p
|
505
|
+
@b * 100.0
|
506
|
+
end
|
507
|
+
# Returns the blue component of the colour as a fraction in the range 0.0
|
508
|
+
# .. 1.0.
|
509
|
+
def b
|
510
|
+
@b
|
511
|
+
end
|
512
|
+
# Sets the blue component of the colour in the normal 0 .. 255 range.
|
513
|
+
def blue=(bb)
|
514
|
+
@b = Color.normalize(bb / 255.0)
|
515
|
+
end
|
516
|
+
# Sets the blue component of the colour as a percentage.
|
517
|
+
def blue_p=(bb)
|
518
|
+
@b = Color.normalize(bb / 100.0)
|
519
|
+
end
|
520
|
+
# Sets the blue component of the colour as a fraction in the range 0.0 ..
|
521
|
+
# 1.0.
|
522
|
+
def b=(bb)
|
523
|
+
@b = Color.normalize(bb)
|
524
|
+
end
|
525
|
+
|
526
|
+
# Adds another colour to the current colour. The other colour will be
|
527
|
+
# converted to RGB before addition. This conversion depends upon a #to_rgb
|
528
|
+
# method on the other colour.
|
529
|
+
#
|
530
|
+
# The addition is done using the RGB Accessor methods to ensure a valid
|
531
|
+
# colour in the result.
|
532
|
+
def +(other)
|
533
|
+
self.class.from_fraction(r + other.r, g + other.g, b + other.b)
|
534
|
+
end
|
535
|
+
|
536
|
+
# Subtracts another colour to the current colour. The other colour will be
|
537
|
+
# converted to RGB before subtraction. This conversion depends upon a
|
538
|
+
# #to_rgb method on the other colour.
|
539
|
+
#
|
540
|
+
# The subtraction is done using the RGB Accessor methods to ensure a valid
|
541
|
+
# colour in the result.
|
542
|
+
def -(other)
|
543
|
+
self + (-other)
|
544
|
+
end
|
545
|
+
|
546
|
+
# Retrieve the maxmum RGB value from the current colour as a GrayScale
|
547
|
+
# colour
|
548
|
+
def max_rgb_as_grayscale
|
549
|
+
Color::GrayScale.from_fraction([@r, @g, @b].max)
|
550
|
+
end
|
551
|
+
alias max_rgb_as_greyscale max_rgb_as_grayscale
|
552
|
+
|
553
|
+
def inspect
|
554
|
+
"RGB [#{html}]"
|
555
|
+
end
|
556
|
+
|
557
|
+
def to_a
|
558
|
+
[ r, g, b ]
|
559
|
+
end
|
560
|
+
|
561
|
+
# Numerically negate the color. This results in a color that is only
|
562
|
+
# usable for subtraction.
|
563
|
+
def -@
|
564
|
+
rgb = self.dup
|
565
|
+
rgb.instance_variable_set(:@r, -rgb.r)
|
566
|
+
rgb.instance_variable_set(:@g, -rgb.g)
|
567
|
+
rgb.instance_variable_set(:@b, -rgb.b)
|
568
|
+
rgb
|
569
|
+
end
|
570
|
+
|
571
|
+
private
|
572
|
+
def normalize_percent(percent)
|
573
|
+
percent /= 100.0
|
574
|
+
percent += 1.0
|
575
|
+
percent = [ percent, 2.0 ].min
|
576
|
+
percent = [ 0.0, percent ].max
|
577
|
+
percent
|
578
|
+
end
|
579
|
+
end
|
580
|
+
|
581
|
+
class << Color::RGB
|
582
|
+
# Creates an RGB colour object from percentages 0..100.
|
583
|
+
#
|
584
|
+
# Color::RGB.from_percentage(10, 20, 30)
|
585
|
+
def from_percentage(r = 0, g = 0, b = 0, &block)
|
586
|
+
new(r, g, b, 100.0, &block)
|
587
|
+
end
|
588
|
+
|
589
|
+
# Creates an RGB colour object from fractional values 0..1.
|
590
|
+
#
|
591
|
+
# Color::RGB.from_fraction(.3, .2, .1)
|
592
|
+
def from_fraction(r = 0.0, g = 0.0, b = 0.0, &block)
|
593
|
+
new(r, g, b, 1.0, &block)
|
594
|
+
end
|
595
|
+
|
596
|
+
# Creates an RGB colour object from a grayscale fractional value 0..1.
|
597
|
+
def from_grayscale_fraction(l = 0.0, &block)
|
598
|
+
new(l, l, l, 1.0, &block)
|
599
|
+
end
|
600
|
+
alias_method :from_greyscale_fraction, :from_grayscale_fraction
|
601
|
+
|
602
|
+
# Creates an RGB colour object from an HTML colour descriptor (e.g.,
|
603
|
+
# <tt>"fed"</tt> or <tt>"#cabbed;"</tt>.
|
604
|
+
#
|
605
|
+
# Color::RGB.from_html("fed")
|
606
|
+
# Color::RGB.from_html("#fed")
|
607
|
+
# Color::RGB.from_html("#cabbed")
|
608
|
+
# Color::RGB.from_html("cabbed")
|
609
|
+
def from_html(html_colour, &block)
|
610
|
+
# When we can move to 1.9+ only, this will be \h
|
611
|
+
h = html_colour.scan(/[0-9a-f]/i)
|
612
|
+
case h.size
|
613
|
+
when 3
|
614
|
+
new(*h.map { |v| (v * 2).to_i(16) }, &block)
|
615
|
+
when 6
|
616
|
+
new(*h.each_slice(2).map { |v| v.join.to_i(16) }, &block)
|
617
|
+
else
|
618
|
+
raise ArgumentError, "Not a supported HTML colour type."
|
619
|
+
end
|
620
|
+
end
|
621
|
+
|
622
|
+
# Find or create a colour by an HTML hex code. This differs from the
|
623
|
+
# #from_html method in that if the colour code matches a named colour,
|
624
|
+
# the existing colour will be returned.
|
625
|
+
#
|
626
|
+
# Color::RGB.by_hex('ff0000').name # => 'red'
|
627
|
+
# Color::RGB.by_hex('ff0001').name # => nil
|
628
|
+
#
|
629
|
+
# If a block is provided, the value that is returned by the block will
|
630
|
+
# be returned instead of the exception caused by an error in providing a
|
631
|
+
# correct hex format.
|
632
|
+
def by_hex(hex, &block)
|
633
|
+
__by_hex.fetch(html_hexify(hex)) { from_html(hex) }
|
634
|
+
rescue
|
635
|
+
if block
|
636
|
+
block.call
|
637
|
+
else
|
638
|
+
raise
|
639
|
+
end
|
640
|
+
end
|
641
|
+
|
642
|
+
# Return a colour as identified by the colour name.
|
643
|
+
def by_name(name, &block)
|
644
|
+
__by_name.fetch(name.to_s.downcase, &block)
|
645
|
+
end
|
646
|
+
|
647
|
+
# Return a colour as identified by the colour name, or by hex.
|
648
|
+
def by_css(name_or_hex, &block)
|
649
|
+
by_name(name_or_hex) { by_hex(name_or_hex, &block) }
|
650
|
+
end
|
651
|
+
|
652
|
+
# Extract named or hex colours from the provided text.
|
653
|
+
def extract_colors(text, mode = :both)
|
654
|
+
text = text.downcase
|
655
|
+
regex = case mode
|
656
|
+
when :name
|
657
|
+
Regexp.union(__by_name.keys)
|
658
|
+
when :hex
|
659
|
+
Regexp.union(__by_hex.keys)
|
660
|
+
when :both
|
661
|
+
Regexp.union(__by_hex.keys + __by_name.keys)
|
662
|
+
end
|
663
|
+
|
664
|
+
text.scan(regex).map { |match|
|
665
|
+
case mode
|
666
|
+
when :name
|
667
|
+
by_name(match)
|
668
|
+
when :hex
|
669
|
+
by_hex(match)
|
670
|
+
when :both
|
671
|
+
by_css(match)
|
672
|
+
end
|
673
|
+
}
|
674
|
+
end
|
675
|
+
end
|
676
|
+
|
677
|
+
class << Color::RGB
|
678
|
+
private
|
679
|
+
|
680
|
+
def __named_color(mod, rgb, *names)
|
681
|
+
used = names - mod.constants.map(&:to_sym)
|
682
|
+
if used.length < names.length
|
683
|
+
raise ArgumentError, "#{names.join(', ')} already defined in #{mod}"
|
684
|
+
end
|
685
|
+
|
686
|
+
names.each { |n| mod.const_set(n, rgb) }
|
687
|
+
|
688
|
+
rgb.names = names
|
689
|
+
rgb.names.each { |n| __by_name[n] = rgb }
|
690
|
+
__by_hex[rgb.hex] = rgb
|
691
|
+
rgb.freeze
|
692
|
+
end
|
693
|
+
|
694
|
+
def __by_hex
|
695
|
+
@__by_hex ||= {}
|
696
|
+
end
|
697
|
+
|
698
|
+
def __by_name
|
699
|
+
@__by_name ||= {}
|
700
|
+
end
|
701
|
+
|
702
|
+
def html_hexify(hex)
|
703
|
+
# When we can move to 1.9+ only, this will be \h
|
704
|
+
h = hex.to_s.downcase.scan(/[0-9a-f]/)
|
705
|
+
case h.size
|
706
|
+
when 3
|
707
|
+
h.map { |v| (v * 2) }.join
|
708
|
+
when 6
|
709
|
+
h.join
|
710
|
+
else
|
711
|
+
raise ArgumentError, "Not a supported HTML colour type."
|
712
|
+
end
|
713
|
+
end
|
714
|
+
end
|
715
|
+
require 'atome/helpers/color_helper/color/rgb/colors'
|