imageAim (configured with a file of calibration data)

    """

def clamp255(x):

    return min(255, max(0, x))

def _8bit(f):

    if not isinstance(f, (int, float)):

        raise TypeError(repr(f))

    return clamp255(int(f * 255))

def resolve(

        deviceType: DeviceUri,  # should be DeviceClass?

        deviceAttr: DeviceAttr,

        values: List[Any]):

    """

    return one value to use for this attr, given a set of them that

    have come in simultaneously. len(values) >= 1.

    bug: some callers are passing a device instance for 1st arg

    """

    if len(values) == 1:

        return values[0]

    if deviceAttr == DeviceAttr(L9['color']):

        rgbs = [hex_to_rgb(v) for v in values]

        return rgb_to_hex([max(*component) for component in zip(*rgbs)])

    # incomplete. how-to-resolve should be on the DeviceAttr defs in the graph.

    if deviceAttr in map(

            DeviceAttr,

        [L9['rx'], L9['ry'], L9['zoom'], L9['focus'], L9['iris']]):

        floatVals = []

        for v in values:

            if isinstance(v, Literal):

                floatVals.append(float(v.toPython()))

            elif isinstance(v, (int, float)):

                floatVals.append(float(v))

            else:

                raise TypeError(repr(v))

        # averaging with zeros? not so good

        return Literal(sum(floatVals) / len(floatVals))

    return max(values)

def toOutputAttrs(deviceType,

                  deviceAttrSettings) -> Dict[OutputAttr, OutputValue]:

    return dict(

        (OutputAttr(u), OutputValue(v)) for u, v in untype_toOutputAttrs(

            deviceType, deviceAttrSettings).items())

def untype_toOutputAttrs(deviceType, deviceAttrSettings) -> Dict[URIRef, int]:

    """

    Given device attr settings like {L9['color']: Literal('#ff0000')},

    return a similar dict where the keys are output attrs (like

    L9['red']) and the values are suitable for Collector.setAttr

    :outputAttrRange happens before we get here.

    """

    def floatAttr(attr, default=0):

        out = deviceAttrSettings.get(attr)

        if out is None:

            return default

        return float(out.toPython()) if isinstance(out, Literal) else out

    def rgbAttr(attr):

        color = deviceAttrSettings.get(attr, '#000000')

        r, g, b = hex_to_rgb(color)

        return r, g, b

    def cmyAttr(attr):

        rgb = sRGBColor.new_from_rgb_hex(deviceAttrSettings.get(

            attr, '#000000'))

        out = colormath.color_conversions.convert_color(rgb, CMYColor)

        return (_8bit(out.cmy_c), _8bit(out.cmy_m), _8bit(out.cmy_y))

    def fine16Attr(attr, scale=1.0):

        x = floatAttr(attr) * scale

        hi = _8bit(x)

        lo = _8bit((x * 255) % 1.0)

        return hi, lo

    def choiceAttr(attr):

        # todo

        if deviceAttrSettings.get(attr) == L9['g1']:

            return 3

        if deviceAttrSettings.get(attr) == L9['g2']:

            return 10

        return 0

    if deviceType == L9['ChauvetColorStrip']:

        r, g, b = rgbAttr(L9['color'])

    elif deviceType == L9['Bar612601']:

        r, g, b = rgbAttr(L9['color'])

        return {L9['red']: r, L9['green']: g, L9['blue']: b}

    elif deviceType == L9['SimpleDimmer']:

        return {L9['level']: _8bit(floatAttr(L9['brightness']))}

    elif deviceType == L9['Mini15']:

        out = {

            L9['rotationSpeed']: 0,  # seems to have no effect

            L9['dimmer']: 255,

            L9['colorChange']: 0,

            L9['colorSpeed']: 0,

            L9['goboShake']: _8bit(floatAttr(L9['goboShake'])),

        }

        out[L9['goboChoose']] = {

            L9['open']: 0,

            L9['mini15Gobo1']: 10,

            L9['mini15Gobo2']: 20,

            L9['mini15Gobo3']: 30,

        }[deviceAttrSettings.get(L9['mini15GoboChoice'], L9['open'])]

        out[L9['red']], out[L9['green']], out[L9['blue']] = rgbAttr(L9['color'])

        out[L9['xRotation']], out[L9['xFine']] = fine16Attr(L9['rx'], 1 / 540)

        out[L9['yRotation']], out[L9['yFine']] = fine16Attr(L9['ry'], 1 / 240)

        # didn't find docs on this, but from tests it looks like 64 fine steps takes you to the next coarse step

        return out

    elif deviceType == L9['ChauvetHex12']:

        out = {}

        out[L9['red']], out[L9['green']], out[L9['blue']] = r, g, b = rgbAttr(

            L9['color'])

        out[L9['amber']] = 0

        out[L9['white']] = min(r, g, b)

        out[L9['uv']] = _8bit(floatAttr(L9['uv']))

        return out

    elif deviceType == L9['Source4LedSeries2']:

        out = {}

        out[L9['red']], out[L9['green']], out[L9['blue']] = rgbAttr(L9['color'])

        out[L9['strobe']] = 0

        out[L9['fixed255']] = 255

        for num in range(7):

            out[L9['fixed128_%s' % num]] = 128

        return out

    elif deviceType == L9['MacAura']:

        out = {

            L9['shutter']: 22,

            L9['dimmer']: 255,

            L9['zoom']: _8bit(floatAttr(L9['zoom'])),

            L9['fixtureControl']: 0,

            L9['colorWheel']: 0,

            L9['colorTemperature']: 128,

            L9['fx1Select']: 0,

            L9['fx1Adjust']: 0,

            L9['fx2Select']: 0,

            L9['fx2Adjust']: 0,

            L9['fxSync']: 0,

            L9['auraShutter']: 22,

            L9['auraDimmer']: 0,

            L9['auraColorWheel']: 0,

            L9['auraRed']: 0,

            L9['auraGreen']: 0,

            L9['auraBlue']: 0,

        }

        out[L9['pan']], out[L9['panFine']] = fine16Attr(L9['rx'])

        out[L9['tilt']], out[L9['tiltFine']] = fine16Attr(L9['ry'])

        out[L9['red']], out[L9['green']], out[L9['blue']] = rgbAttr(L9['color'])

        out[L9['white']] = 0

        return out

    elif deviceType == L9['MacQuantum']:

        out = {

            L9['dimmerFadeLo']: 0,

            L9['fixtureControl']: 0,

            L9['fx1Select']: 0,

            L9['fx1Adjust']: 0,

            L9['fx2Select']: 0,

            L9['fx2Adjust']: 0,

            L9['fxSync']: 0,

        }

        # note these values are set to 'fade', so they update slowly. Haven't found where to turn that off.

        out[L9['cyan']], out[L9['magenta']], out[L9['yellow']] = cmyAttr(

            L9['color'])

        out[L9['focusHi']], out[L9['focusLo']] = fine16Attr(L9['focus'])

        out[L9['panHi']], out[L9['panLo']] = fine16Attr(L9['rx'])

        out[L9['tiltHi']], out[L9['tiltLo']] = fine16Attr(L9['ry'])

        out[L9['zoomHi']], out[L9['zoomLo']] = fine16Attr(L9['zoom'])

        out[L9['dimmerFadeHi']] = 0 if deviceAttrSettings.get(

            L9['color'], '#000000') == '#000000' else 255

        out[L9['goboChoice']] = {

            L9['open']: 0,

            L9['spider']: 36,

            L9['windmill']: 41,

            L9['limbo']: 46,

            L9['brush']: 51,

            L9['whirlpool']: 56,

            L9['stars']: 61,

@prefix : <http://light9.bigasterisk.com/> .

@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .

:color              a :DeviceAttr; rdfs:label "color"; :dataType :color .

:brightness         a :DeviceAttr; rdfs:label "brightness"; :dataType :scalar .

:strobe             a :DeviceAttr; rdfs:label "strobe"; :dataType :scalar;

  rdfs:comment "0=none, 1=fastest" .

:SimpleDimmer a :DeviceClass; rdfs:label "SimpleDimmer";

  :deviceAttr :brightness;

  :attr

    [ :outputAttr :level; :dmxOffset 0 ] .

:ChauvetColorStrip a :DeviceClass; rdfs:label "ChauvetColorStrip";

  :setup "SYS -> SdAd -> <base addr>";

  :docs <https://cdn01.usedlighting.com/products/files/f5773ffaf95fee.pdf>;

  :deviceAttr :color;

  :attr

    [ :outputAttr :mode;     :dmxOffset 0 ],

    [ :outputAttr :red;      :dmxOffset 1 ],

    [ :outputAttr :green;    :dmxOffset 2 ],

    [ :outputAttr :blue;     :dmxOffset 3 ] .

:Bar612601 a :DeviceClass; rdfs:label "LED Bar (mode d)";

  :deviceAttr :color;

  :attr

    [ :outputAttr :red;      :dmxOffset 0 ],

    [ :outputAttr :green;    :dmxOffset 1 ],

    [ :outputAttr :blue;     :dmxOffset 2 ] .

:LedPar90 a :DeviceClass; rdfs:label "LED Par 9x10W RGBW";

  :deviceAttr :color;

  :attr

    [ :outputAttr :master;   :dmxOffset 0 ],

    [ :outputAttr :red;      :dmxOffset 1 ],

    [ :outputAttr :green;    :dmxOffset 2 ],

    [ :outputAttr :blue;     :dmxOffset 3 ],

:LedPar54  a :DeviceClass; rdfs:label "LED Par 54 RGBW";

  :deviceAttr :color;

  :attr

    [ :outputAttr :master;   :dmxOffset 0 ],

    [ :outputAttr :red;      :dmxOffset 1 ],

    [ :outputAttr :green;    :dmxOffset 2 ],

    [ :outputAttr :blue;     :dmxOffset 3 ],

    [ :outputAttr :white;    :dmxOffset 4 ],

    [ :outputAttr :strobe;   :dmxOffset 5 ],

    [ :outputAttr :doNotUse; :dmxOffset 6 ] .