|
;;; colir.el --- Color blending library -*- lexical-binding: t -*-
|
|
|
|
;; Copyright (C) 2015-2019 Free Software Foundation, Inc.
|
|
|
|
;; Author: Oleh Krehel <ohwoeowho@gmail.com>
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
;; This file is free software; you can redistribute it and/or modify
|
|
;; it under the terms of the GNU General Public License as published by
|
|
;; the Free Software Foundation; either version 3, or (at your option)
|
|
;; any later version.
|
|
|
|
;; This program is distributed in the hope that it will be useful,
|
|
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
;; GNU General Public License for more details.
|
|
|
|
;; For a full copy of the GNU General Public License
|
|
;; see <https://www.gnu.org/licenses/>.
|
|
|
|
;;; Commentary:
|
|
|
|
;; This package solves the problem of adding a face with a background
|
|
;; to text which may already have a background. In all conflicting
|
|
;; areas, instead of choosing either the original or the new
|
|
;; background face, their blended sum is used.
|
|
;;
|
|
;; The blend mode functions are taken from URL
|
|
;; `https://en.wikipedia.org/wiki/Blend_modes'.
|
|
|
|
;;; Code:
|
|
|
|
(require 'cl-lib)
|
|
(require 'color)
|
|
|
|
(defcustom colir-compose-method #'colir-compose-alpha
|
|
"Select a method to compose two color channels."
|
|
:group 'ivy
|
|
:type '(radio
|
|
(function-item colir-compose-alpha)
|
|
(function-item colir-compose-overlay)
|
|
(function-item colir-compose-soft-light)))
|
|
|
|
(defun colir-compose-soft-light (a b)
|
|
"Compose A and B channels."
|
|
(if (< b 0.5)
|
|
(+ (* 2 a b) (* a a (- 1 b b)))
|
|
(+ (* 2 a (- 1 b)) (* (sqrt a) (- (* 2 b) 1)))))
|
|
|
|
(defun colir-compose-overlay (a b)
|
|
"Compose A and B channels."
|
|
(if (< a 0.5)
|
|
(* 2 a b)
|
|
(- 1 (* 2 (- 1 a) (- 1 b)))))
|
|
|
|
(defun colir-compose-alpha (a b &optional alpha gamma)
|
|
"Compose A and B channels.
|
|
Optional argument ALPHA is a number between 0.0 and 1.0 which corresponds
|
|
to the influence of A on the result. Default value is 0.5.
|
|
Optional argument GAMMA is used for gamma correction. Default value is 2.2."
|
|
(setq alpha (or alpha 0.5))
|
|
(setq gamma (or gamma 2.2))
|
|
(+ (* (expt a gamma) alpha) (* (expt b gamma) (- 1 alpha))))
|
|
|
|
(defun colir-blend (c1 c2)
|
|
"Blend the two colors C1 and C2 using `colir-compose-method'.
|
|
C1 and C2 are triples of floats in [0.0 1.0] range."
|
|
(apply #'color-rgb-to-hex
|
|
(cl-mapcar
|
|
(if (eq (frame-parameter nil 'background-mode) 'dark)
|
|
;; this method works nicely for dark themes
|
|
'colir-compose-soft-light
|
|
colir-compose-method)
|
|
c1 c2)))
|
|
|
|
(defun colir-color-parse (color)
|
|
"Convert string COLOR to triple of floats in [0.0 1.0]."
|
|
(if (string-match "#\\([[:xdigit:]]\\{2\\}\\)\\([[:xdigit:]]\\{2\\}\\)\\([[:xdigit:]]\\{2\\}\\)" color)
|
|
(mapcar (lambda (v) (/ (string-to-number v 16) 255.0))
|
|
(list (match-string 1 color) (match-string 2 color) (match-string 3 color)))
|
|
;; does not work properly in terminal (maps color to nearest color
|
|
;; from available color palette).
|
|
(color-name-to-rgb color)))
|
|
|
|
(defun colir--blend-background (start next prevn face object)
|
|
(let ((background-prev (face-background prevn)))
|
|
(progn
|
|
(put-text-property
|
|
start next 'face
|
|
(if background-prev
|
|
(cons `(background-color
|
|
. ,(colir-blend
|
|
(colir-color-parse background-prev)
|
|
(colir-color-parse (face-background face nil t))))
|
|
prevn)
|
|
(list face prevn))
|
|
object))))
|
|
|
|
(defun colir-blend-face-background (start end face &optional object)
|
|
"Append to the face property of the text from START to END the face FACE.
|
|
When the text already has a face with a non-plain background,
|
|
blend it with the background of FACE.
|
|
Optional argument OBJECT is the string or buffer containing the text.
|
|
See also `font-lock-append-text-property'."
|
|
(let (next prev prevn)
|
|
(while (/= start end)
|
|
(setq next (next-single-property-change start 'face object end))
|
|
(setq prev (get-text-property start 'face object))
|
|
(setq prevn (if (listp prev)
|
|
(cl-find-if #'atom prev)
|
|
prev))
|
|
(cond
|
|
((or (keywordp (car-safe prev)) (consp (car-safe prev)))
|
|
(put-text-property start next 'face (cons face prev) object))
|
|
((facep prevn)
|
|
(colir--blend-background start next prevn face object))
|
|
(t
|
|
(put-text-property start next 'face face object)))
|
|
(setq start next))))
|
|
|
|
(provide 'colir)
|
|
|
|
;;; colir.el ends here
|