tincture-apca 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '03519433f7f021e7c641da9814503f7175233ebab635f70599c419616ac18d15'
-  data.tar.gz: 58cb22824f9af6a9d99970e0213b8a761b8597fbcf65aa16b60d51a40ce61ca1
+  metadata.gz: 4ec4fba8841d4a1abf8cb3098ba8a09fbdac6694ee06d1961eb8f72633470199
+  data.tar.gz: 5f7c3d4fa2a2091df2110be9bca3dc7acdf66ff96a0b6c911c07e583175de670
 SHA512:
-  metadata.gz: 3014dc7a59b1deb07bc0686482cb4f2a077df8a73f9db6888f7e5abb140e0c9d391b35459e429ed70d232e91dd6445d9f38582a470f66450e221effb10e78c4e
-  data.tar.gz: 05b97f7f2f23d18296b530945be9fb9c5cfea664b5e3fc36dfc3340c96761572cc64a84bc116a8cd31546d6444180909f0b94db7b536a883d1bcb3a28c703d41
+  metadata.gz: e86c24c6b01ce4d9d1f8b074f08691cadb7c02b83671b059bd97081f96ae4d41391ee9c7740947ca7d18c95502a93c2514304c944f1824eb27ad25b366ee3960
+  data.tar.gz: ecd090a79025658f2765ef485b3822480ee858d36e1741d02a39d6c29508a1c408442d4701932d4e2f9055c4e8a4a9a0ee400962b8020563a56eabfaa739bb3e

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.1.0 (2026-10-21)
+
+- Performance: `apca_contrast` is about 30% faster and `Apca.luminance` about 2.5 times faster. Luminance looks up each channel's linear value in a table and no longer computes a power. Results are unchanged.
+- Performance: `Apca.contrast` is about 25% faster. It no longer builds an array to soft-clamp its two luminances.
+- Performance: `apca_contrast` with translucent text is about 40% faster. It blends the channels without building a new colour.
+
 ## 1.0.0 (2026-10-21)
 
 - `apca_contrast` and `contrast_color(method: :apca)` for `Tincture::Color`, ported from apca-w3 0.1.9.

data/README.md

@@ -50,4 +50,4 @@ bundle exec rake        # tests and RuboCop
 bundle exec rake rdoc   # API docs in doc/
 ```
 
-To release, set the version in `lib/tincture/apca/version.rb`, date the changelog entry, commit, and push a `vX.Y.Z` tag. GitHub Actions runs the checks and publishes the gem to rubygems.org through trusted publishing.
+To release, set the version in `lib/tincture/apca/version.rb`, date the changelog entry, commit, and push a `vX.Y.Z` tag. GitHub Actions runs the checks, publishes the gem to rubygems.org through trusted publishing, and creates a GitHub release with that changelog entry as its notes.

data/lib/tincture/apca/version.rb

@@ -2,6 +2,6 @@
 
 module Tincture
   module Apca
-    VERSION = '1.0.0' # :nodoc:
+    VERSION = '1.1.0' # :nodoc:
   end
 end

data/lib/tincture/apca.rb

@@ -41,6 +41,8 @@ module Tincture # :nodoc:
       loClip: 0.1
     }.freeze
 
+    LINEAR_CHANNELS = Array.new(256) { (it / 255.0)**SA98G[:mainTRC] }.freeze # :nodoc:
+
     module_function
 
     # Lc for text on a background, from their #luminance values. Positive for
@@ -49,7 +51,8 @@ module Tincture # :nodoc:
     #
     #: (Float text_y, Float background_y) -> Float
     def contrast(text_y, background_y)
-      text_y, background_y = [text_y, background_y].map { soft_clamped(it) }
+      text_y = soft_clamped(text_y)
+      background_y = soft_clamped(background_y)
 
       lc =
         if (background_y - text_y).abs < SA98G[:deltaYmin] then 0.0
@@ -65,11 +68,10 @@ module Tincture # :nodoc:
     #
     #: ([Integer, Integer, Integer] rgb) -> Float
     def luminance((red, green, blue))
-      (SA98G[:sRco] * linear(red)) + (SA98G[:sGco] * linear(green)) + (SA98G[:sBco] * linear(blue))
+      (SA98G[:sRco] * LINEAR_CHANNELS[red]) + (SA98G[:sGco] * LINEAR_CHANNELS[green]) +
+        (SA98G[:sBco] * LINEAR_CHANNELS[blue])
     end
 
-    def linear(channel) = (channel / 255.0)**SA98G[:mainTRC] # :nodoc:
-
     def soft_clamped(luminance) # :nodoc:
       luminance > SA98G[:blkThrs] ? luminance : luminance + ((SA98G[:blkThrs] - luminance)**SA98G[:blkClmp])
     end
@@ -84,7 +86,7 @@ module Tincture # :nodoc:
       sapc > -SA98G[:loClip] ? 0.0 : sapc + SA98G[:loWoBoffset]
     end
 
-    private_class_method :linear, :soft_clamped, :dark_on_light, :light_on_dark
+    private_class_method :soft_clamped, :dark_on_light, :light_on_dark
 
     # Added to Tincture::Color.
     module ColorMethods
@@ -100,15 +102,15 @@ module Tincture # :nodoc:
       #: (String | Color background) -> Float
       def apca_contrast(background)
         background = Color.parse(background)
-        text = opaque? ? self : blended_over(background)
+        text_rgb = opaque? ? rgb : rgb_blended_over(background)
 
-        Apca.contrast(Apca.luminance(text.rgb), Apca.luminance(background.rgb))
+        Apca.contrast(Apca.luminance(text_rgb), Apca.luminance(background.rgb))
       end
 
       private
 
-      def blended_over(background)
-        Color.rgb(*rgb.zip(background.rgb).map { |mine, theirs| (theirs * (1 - alpha)) + (mine * alpha) })
+      def rgb_blended_over(background)
+        rgb.zip(background.rgb).map { |mine, theirs| ((theirs * (1 - alpha)) + (mine * alpha)).round }
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tincture-apca
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Andy Croll