summaryrefslogtreecommitdiffstats
path: root/examples
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2014-03-18 03:31:13 +0100
committerMattias Andrée <maandree@operamail.com>2014-03-18 03:31:25 +0100
commitf0287b86fb6d323052496337c83d9d7fb43c1819 (patch)
tree33525c6c74c90cc3ede68218f0a0720910384b08 /examples
parentwhoops (diff)
downloadblueshift-f0287b86fb6d323052496337c83d9d7fb43c1819.tar.gz
blueshift-f0287b86fb6d323052496337c83d9d7fb43c1819.tar.bz2
blueshift-f0287b86fb6d323052496337c83d9d7fb43c1819.tar.xz
quite a bit of the text based configuration example
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to 'examples')
-rw-r--r--examples/textconf369
-rw-r--r--examples/textconf.conf63
2 files changed, 432 insertions, 0 deletions
diff --git a/examples/textconf b/examples/textconf
new file mode 100644
index 0000000..7dcff6f
--- /dev/null
+++ b/examples/textconf
@@ -0,0 +1,369 @@
+# -*- python -*-
+
+# This example uses a text based configuration file to make
+# it easier for non-programmers to use Blueshift. It is however
+# rather limited, the lisp-esque example is a bit more complex
+# but do much more. It will # read a file with the same pathname
+# just with ‘.conf’ # appended (‘textconf.conf’ in this case.)
+# However, if the filename of this file ends with with ‘rc’,
+# that part will be removed, for example, if you rename this
+# script to ‘~/.blueshiftrc’ it will read ‘~/.blueshift.conf’
+# rather than ‘~/.blueshiftrc.conf’.
+
+
+# Copyright © 2014 Mattias Andrée (maandree@member.fsf.org)
+#
+# This program 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 of the License, 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.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+import sys
+import subprocess
+
+
+# Get the name of .conf file
+conf = '%s.conf' % (config_file[:-2] if config_file.endswith('rc') else config_file)
+
+
+# Read .conf file
+with open(conf, 'r') as file:
+ conf = file.read()
+
+
+# Parse .conf file
+sections = {'blueshift' : []}
+section = []
+sections['blueshift'].append(section)
+for line in conf.split('\n'):
+ line = line.strip()
+ if line.startswith('[') and line.startswith(']'):
+ section_name = line[1 : -1].strip().lower()
+ if section_name not in sections:
+ sections[section_name] = []
+ section = []
+ sections[section_name].append(section)
+ elif line.startswith(';') or line.startswith('#'):
+ continue
+ elif ('=' in line) or (':' in line):
+ eq = len(line) if '=' not in line else line.find('=')
+ cl = len(line) if ':' not in line else line.find(':')
+ eq = min(eq, cl)
+ section.append((line[:eq].strip().lower(), line[:eq + 1].strip()))
+ elif len(line.strip()) > 0:
+ sys.stderr.buffer.write(('Malformated line: %s' % line).encode('utf-8'))
+sys.stderr.buffer.flush()
+
+
+# Default values
+location = None
+adjustment_method_x = ['randr']
+adjustment_method_tty = ['drm']
+points = ['solar', '3', '-6']
+
+
+# List of adjustments and temporary monitor information
+adjustments = []
+monitors = []
+crtc = None
+screen = None
+card = None
+
+
+def parse_value(value):
+ '''
+ Parse a setting value
+
+ @param value:str The value to parse
+ @return :(list<str>, bool, bool, bool) The words in the value string, with commands spawned,
+ and with 'linear', 'cie' and 'default' filtered out,
+ and their
+ existance is put as booleans
+ '''
+ def spawn(cmd):
+ '''
+ Spawn an external process and read its output, but only the first line
+
+ @param cmd:str The command to spawn
+ @return :str? The first line of the command's output, `None` on failure
+ '''
+ proc = subprocess.Popen(['sh', '-c', cmd], stdout = subprocess.PIPE, stderr = sys.stderr)
+ output = proc.communicate()[0].split('\n')[0]
+ if (proc.returncode == 0) and (len(output) > 0):
+ return output
+ return None
+ words, buf, cmd = [], '', None
+ for c in value:
+ if cmd is not None:
+ if cmd == '':
+ if c == '(':
+ cmd += '('
+ else:
+ cmd = None
+ buf += '$'
+ else:
+ cmd += c
+ if c == ')':
+ cmd = cmd[1 : -1]
+ cmd = spawn(cmd)
+ if cmd is not None:
+ buf = cmd
+ cmd = None
+ elif c == ' ':
+ if not buf == '':
+ words.append(buf)
+ buf = ''
+ elif c == '$':
+ cmd = ''
+ else:
+ buf += c
+ return ([w in w for words if w not in ['linear', 'cie', 'default']],
+ 'linear' in words, 'cie' in words, 'default' in words)
+
+
+# Evaluate .conf file
+def make_f(f, value, default):
+ '''
+ Make an adjustment function
+
+ @param f:(*¿V??)→void The function that makes the adjustment
+ @param value:list<¿V??> The values for each time point
+ @param default:list<¿V??> The default value
+ '''
+ ff = None
+ value_ = []
+ for val in value:
+ value_ += val
+ if any(map(lambda v : v if None, value_)) or (default is None):
+ def ff(t, a):
+ val0 = value[(int(t) + 0) % len(value)]
+ val1 = value[(int(t) + 1) % len(value)]
+ t %= 1
+ val = zip(val0, val1, default)
+ def interpol(v0, v1, d):
+ if (v0 is None) or (v1 is None) or (d is None):
+ if ( d is None) and a == 0: return None
+ if (v0 is None) and t == 0: return None
+ if (v1 is None) and t == 1: return None
+ v0 = v0 * (1 - t) if v0 is not None else 0
+ v1 = v1 * t if v1 is not None else 0
+ return v0 + v1
+ val = [interpol(v0, v1, d) for v0, v1, d in val]
+ f(*val)
+ else:
+ def ff(t, a):
+ val0 = value[(int(t) + 0) % len(value)]
+ val1 = value[(int(t) + 1) % len(value)]
+ t %= 1
+ val = zip(val0, val1, default)
+ val = [(v0 * (1 - t) + v1 * t) * a + (1 - a) * d for v0, v1, d in val]
+ f(*val)
+ return ff
+
+def float3(value):
+ '''
+ Parse a string representation of a float trio
+
+ @param value:str The float trio as a string
+ @return :[float?, float?, float?] The float trio as a float list
+ '''
+ value = [None if v == 'none' else float(v) for v in value.split(':')]
+ if len(value) < 3:
+ value *= 3
+ return value[:3]
+
+def float6(value):
+ '''
+ Parse a string representation of a float pair-trio
+
+ @param value:str The float pair-trio as a string
+ @return :[float?]*6 The float pair-trio as a float list
+ '''
+ (part1, part2) = [[float(v) for v in val.split(':')] for val in value.split('..')]
+ if len(part1) < 3: part1 *= 3
+ if len(part2) < 3: part2 *= 3
+ part1 = part1[:3]
+ part2 = part2[:3]
+ value = []
+ for p, q in zip(part1, part2):
+ value.append(p)
+ value.append(q)
+ return value
+
+def add_adjustments(section_name, adjustments):
+ '''
+ Add adjustions from a section to a list
+
+ @param sections:list<list<(str, str)>> The sections
+ @param adjustments:list<(float, float)→void> The list to fill with adjustments
+ '''
+ global location, points, adjustment_method_x, adjustment_method_tty, crtc, screen, card
+ for section in sections:
+ for (setting, value) in section:
+ (value, linear, cie, default) = parse_value(value)
+ new_adjustment = None
+ if linear:
+ adjustments.append(lambda _t, _a: linearise())
+ if setting == 'location': location = value
+ elif setting == 'points': points = value
+ elif setting == 'adjustment-method-x': adjustment_method_x = value
+ elif setting == 'adjustment-method-tty': adjustment_method_tty = value
+ elif setting == 'crtc': crtc = value
+ elif setting == 'screen': screen = value
+ elif setting == 'card': card = value
+ elif setting == 'temperature':
+ f = lambda x : temperature(x, lambda t : divide_by_maximum(cmf_10deg(t)))
+ new_adjustment = make_f(f, [[float(v)] for v in value], [6500])
+ elif setting == 'contrast':
+ f = cie_contrast if cie else rgb_contrast
+ new_adjustment = make_f(f, [float3(v) for v in value], 3 * [1])
+ elif setting == 'brightness':
+ f = cie_brightness if cie else rgb_brightness
+ new_adjustment = make_f(f, [float3(v) for v in value], 3 * [1])
+ elif setting == 'gamma':
+ def f(*levels):
+ clip()
+ gamma(*levels)
+ new_adjustment = make_f(f, [float3(v) for v in value], 3 * [1])
+ elif setting == 'negative':
+ def f(*values):
+ negative(*[not v == 0 for v in values])
+ new_adjustment = make_f(f, [float3(v) for v in value], 3 * [0])
+ elif setting == 'invert':
+ def f(*values):
+ (cie_invert if cie else rgb_invert)(*[not v == 0 for v in values])
+ new_adjustment = make_f(f, [float3(v) for v in value], 3 * [0])
+ elif setting == 'sigmoid':
+ new_adjustment = make_f(sigmoid, [float3(v) for v in value], 3 * [None])
+ elif setting == 'limits':
+ f = cie_limits if cie else rgb_limits
+ new_adjustment = make_f(f, [float6(v) for v in value], 3 * [0, 1])
+ elif setting == 'icc':
+ def noop():
+ pass
+ profiles = [noop if val == 'none' else load_load(val) for val in value]
+ new_adjustment = make_icc_interpolation(profiles)
+ elif setting == 'monitor':
+ add_adjustments(' '.join([monitor] + value), adjustments)
+ else:
+ sys.stderr.buffer.write(('Setting not recognised: %s' % setting).encode('utf-8'))
+ sys.stderr.buffer.flush()
+ if new_adjustment is not None:
+ if default:
+ new_adjustment_ = new_adjustment
+ def f(t, a):
+ new_adjustment_(t, 1)
+ new_adjustment = f
+ adjustments.append(new_adjustment)
+ if linear:
+ adjustments.append(lambda _t, _a: standardise())
+
+add_adjustments(sections['blueshift'], adjustments)
+
+adjustment_method = adjustment_method_tty if ttymode else adjustment_method_x
+adjustment_method = adjustment_method[0]
+
+for section in sections[adjustment_method]:
+ output_adjustments = []
+ crtc, screen, card = None, None, None
+ add_adjustments([section], output_adjustments)
+ monitors.append(crtc, screen, card, output_adjustments)
+
+
+# Get gamma adjustment/reader functions
+get_method = {'randr' : randr_get, 'vidmode' : vidmode_get, 'drm' : drm_get}
+set_method = {'randr' : randr, 'vidmode' : vidmode, 'drm' : drm }
+get_method = get_method[adjustment_method]
+set_method = set_method[adjustment_method]
+
+
+# Evaluate location
+if 'solar' in points:
+ if (location is None) or (len(location) == 0):
+ sys.stderr.buffer.write(('Location missing').encode('utf-8'))
+ sys.stderr.buffer.flush()
+ sys.exit(1)
+ try:
+ if not len(location) == 2:
+ raise Exception()
+ location = [float(c) for c in location]
+ except:
+ sys.stderr.buffer.write(('Malformation location').encode('utf-8'))
+ sys.stderr.buffer.flush()
+ sys.exit(1)
+ if not ((-90 <= location[0] <= 90) and (-180 <= location[0] <= 180)):
+ sys.stderr.buffer.write(('Invalid location').encode('utf-8'))
+ sys.stderr.buffer.flush()
+ sys.exit(1)
+
+
+# Evaluate point
+if ('solar' not in points) and ('time' not in points):
+ sys.stderr.buffer.write(('Invalid points settings').encode('utf-8'))
+ sys.stderr.buffer.flush()
+ sys.exit(1)
+reduce_points = 'reduce' in points
+solar_points = 'solar' in points
+def t(point):
+ point = [float(p) for p in point.split(':')]
+ while len(point) > 3:
+ point.append(0)
+ point = sum([v * 60 ** (2 - i) for i, v in enumerate(point)])
+points = [float(p) if solar_points else t(p) for p in points if p not in ['solar', 'time', 'point']]
+points = list(enumerate(points))
+if reduce_points:
+ n = len(points) - 1
+ points = [(r / n, v) for r, v in points]
+
+
+def periodically(year, month, day, hour, minute, second, weekday, fade):
+ '''
+ :(int, int, int, int, int, int, int, float?)?→void Place holder for periodically invoked function
+
+ Invoked periodically
+
+ If you want to control at what to invoke this function next time
+ you can set the value of the global variable `wait_period` to the
+ number of seconds to wait before invoking this function again.
+ The value does not need to be an integer.
+
+ @param year:int The year
+ @param month:int The month, 1 = January, 12 = December
+ @param day:int The day, minimum value is 1, probable maximum value is 31 (*)
+ @param hour:int The hour, minimum value is 0, maximum value is 23
+ @param minute:int The minute, minimum value is 0, maximum value is 59
+ @param second:int The second, minimum value is 0, probable maximum value is 60 (**)
+ @param weekday:int The weekday, 1 = Monday, 7 = Sunday
+ @param fade:float? Blueshift can use this function to fade into a state when it start
+ or exits. `fade` can either be negative, zero or positive or `None`,
+ but the magnitude of value cannot exceed 1. When Blueshift starts,
+ this function will be invoked multiple with the time parameters
+ of the time it is invoked and each time `fade` will increase towards
+ 1, starting at 0, when the value is 1, the settings should be applied
+ to 100 %. After this this function will be invoked once again with
+ `fade` being `None`. When Blueshift exits the same behaviour is used
+ except, `fade` decrease towards -1 but start slightly below 0, when
+ -1 is reached all settings should be normal. Then Blueshift will NOT
+ invoke this function with `fade` being `None`, instead it will by
+ itself revert all settings and quit.
+
+ (*) Can be exceeded if the calendar system is changed, like in 1712-(02)Feb-30
+ (**) See https://en.wikipedia.org/wiki/Leap_second
+ '''
+ pass
+
+
+def reset():
+ '''
+ Invoked to reset the displays
+ '''
+ pass
+
diff --git a/examples/textconf.conf b/examples/textconf.conf
new file mode 100644
index 0000000..8fdc26c
--- /dev/null
+++ b/examples/textconf.conf
@@ -0,0 +1,63 @@
+; Copyright © 2014 Mattias Andrée (maandree@member.fsf.org)
+;
+; Permission is granted to copy, distribute and/or modify this document
+; under the terms of the GNU Free Documentation License, Version 1.3
+; or any later version published by the Free Software Foundation;
+; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+; You should have received a copy of the GNU General Public License
+; along with this software package. If not, see <http://www.gnu.org/licenses/>.
+
+
+; Lines starting with either ; (semicolon) or # (pound) are comments.
+; Both = (equal sign) and : (colon) are valid key–value delimiters.
+
+
+[blueshift]
+temperature = 6500 3600
+contrast = 1
+contrast = 1:1:1 cie
+brightness = 1
+brightness = 1:1:1 cie
+gamma = 1:1:1
+negative = 1:1:1
+negative = 1
+invert = 1:1:1
+invert = 1:1:1 cie
+sigmoid = 4.5
+sigmoid = 4.5:none:4.5
+limits = 0:0:0..1:1:1
+limits = 0:0:0..1:1:1 cie
+;icc =
+;location =
+points = time 0:00 10:00 20:00 reduce
+adjustment-method-x = randr
+adjustment-method-tty = drm
+
+
+[monitor 0]
+gamma=1.16:1.15:1.11 default
+
+[randr]
+monitor=0
+crtc=0
+screen=0
+
+[drm]
+monitor=0
+crtc=1
+card=0
+
+
+[monitor 1]
+gamma=1.10:1.16:1.10 default
+
+[randr]
+monitor=1
+crtc=1
+screen=0
+
+[drm]
+monitor=1
+crtc=0
+card=0
+