git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2023 Contributors to the openHAB project
   3  *
   4  * See the NOTICE file(s) distributed with this work for additional
   5  * information.
   6  *
   7  * This program and the accompanying materials are made available under the
   8  * terms of the Eclipse Public License 2.0 which is available at
   9  * http://www.eclipse.org/legal/epl-2.0
  10  *
  11  * SPDX-License-Identifier: EPL-2.0
  12  */
  13 package org.openhab.binding.mqtt.generic.values;
  14
  15 import java.math.BigDecimal;
  16 import java.util.List;
  17 import java.util.Locale;
  18
  19 import javax.ws.rs.NotSupportedException;
  20
  21 import org.eclipse.jdt.annotation.NonNullByDefault;
  22 import org.eclipse.jdt.annotation.Nullable;
  23 import org.openhab.binding.mqtt.generic.mapping.ColorMode;
  24 import org.openhab.core.library.CoreItemFactory;
  25 import org.openhab.core.library.types.HSBType;
  26 import org.openhab.core.library.types.OnOffType;
  27 import org.openhab.core.library.types.PercentType;
  28 import org.openhab.core.library.types.StringType;
  29 import org.openhab.core.types.Command;
  30 import org.openhab.core.types.UnDefType;
  31 import org.openhab.core.util.ColorUtil;
  32 import org.slf4j.Logger;
  33 import org.slf4j.LoggerFactory;
  34
  35 /**
  36  * Implements a color value.
  37  *
  38  * <p>
  39  * Accepts user updates from a HSBType, OnOffType and StringType.
  40  * </p>
  41  * Accepts MQTT state updates as OnOffType and a
  42  * StringType with comma separated HSB ("h,s,b"), RGB ("r,g,b"), CIE xyY ("x,y,Y") and on, off strings.
  43  * On, Off strings can be customized.
  44  *
  45  * @author David Graeff - Initial contribution
  46  * @author Aitor Iturrioz - Add CIE xyY colors support
  47  */
  48 @NonNullByDefault
  49 public class ColorValue extends Value {
  50     private static BigDecimal factor = new BigDecimal("2.55"); // string to not lose precision
  51
  52     private final Logger logger = LoggerFactory.getLogger(ColorValue.class);
  53
  54     private final ColorMode colorMode;
  55     private final String onValue;
  56     private final String offValue;
  57     private final int onBrightness;
  58
  59     /**
  60      * Creates a non initialized color value.
  61      *
  62      * @param colorMode The color mode: HSB, RGB or XYY.
  63      * @param onValue The ON value string. This will be compared to MQTT messages.
  64      * @param offValue The OFF value string. This will be compared to MQTT messages.
  65      * @param onBrightness When receiving an ON command, the brightness percentage is set to this value
  66      */
  67     public ColorValue(ColorMode colorMode, @Nullable String onValue, @Nullable String offValue, int onBrightness) {
  68         super(CoreItemFactory.COLOR, List.of(OnOffType.class, PercentType.class, StringType.class));
  69
  70         if (onBrightness > 100) {
  71             throw new IllegalArgumentException("Brightness parameter must be <= 100");
  72         }
  73
  74         this.colorMode = colorMode;
  75         this.onValue = onValue == null ? "ON" : onValue;
  76         this.offValue = offValue == null ? "OFF" : offValue;
  77         this.onBrightness = onBrightness;
  78     }
  79
  80     /**
  81      * Updates the color state.
  82      */
  83     @Override
  84     public HSBType parseCommand(Command command) throws IllegalArgumentException {
  85         HSBType oldvalue = (state == UnDefType.UNDEF) ? new HSBType() : (HSBType) state;
  86         if (command instanceof HSBType hsbCommand) {
  87             return hsbCommand;
  88         } else if (command instanceof OnOffType onOffCommand) {
  89             PercentType minOn = new PercentType(Math.max(oldvalue.getBrightness().intValue(), onBrightness));
  90             return new HSBType(oldvalue.getHue(), oldvalue.getSaturation(),
  91                     onOffCommand == OnOffType.ON ? minOn : new PercentType(0));
  92         } else if (command instanceof PercentType percentCommand) {
  93             return new HSBType(oldvalue.getHue(), oldvalue.getSaturation(), percentCommand);
  94         } else {
  95             final String updatedValue = command.toString();
  96             if (onValue.equals(updatedValue)) {
  97                 PercentType minOn = new PercentType(Math.max(oldvalue.getBrightness().intValue(), onBrightness));
  98                 return new HSBType(oldvalue.getHue(), oldvalue.getSaturation(), minOn);
  99             } else if (offValue.equals(updatedValue)) {
 100                 return new HSBType(oldvalue.getHue(), oldvalue.getSaturation(), new PercentType(0));
 101             } else {
 102                 String[] split = updatedValue.split(",");
 103                 if (split.length != 3) {
 104                     throw new IllegalArgumentException(updatedValue + " is not a valid string syntax");
 105                 }
 106                 switch (this.colorMode) {
 107                     case HSB:
 108                         return new HSBType(updatedValue);
 109                     case RGB:
 110                         return HSBType.fromRGB(Integer.parseInt(split[0]), Integer.parseInt(split[1]),
 111                                 Integer.parseInt(split[2]));
 112                     case XYY:
 113                         HSBType tempState = HSBType.fromXY(Float.parseFloat(split[0]), Float.parseFloat(split[1]));
 114                         return new HSBType(tempState.getHue(), tempState.getSaturation(), new PercentType(split[2]));
 115                     default:
 116                         throw new IllegalArgumentException("Non supported color mode");
 117                 }
 118             }
 119         }
 120     }
 121
 122     /**
 123      * Converts the color state to a string.
 124      *
 125      * @return Returns the color value depending on the color mode: as a HSB/HSV string (hue,saturation,brightness ->
 126      *         "60,100,100"), as an RGB string (red,green,blue -> "255,255,0") or as a xyY string
 127      *         ("0.419321,0.505255,100.00").
 128      */
 129     @Override
 130     public String getMQTTpublishValue(Command command, @Nullable String pattern) {
 131         String formatPattern = pattern;
 132         if (formatPattern == null || "%s".equals(formatPattern)) {
 133             if (this.colorMode == ColorMode.XYY) {
 134                 formatPattern = "%1$f,%2$f,%3$.2f";
 135             } else {
 136                 formatPattern = "%1$d,%2$d,%3$d";
 137             }
 138         }
 139
 140         HSBType hsbState = (HSBType) command;
 141
 142         switch (this.colorMode) {
 143             case HSB:
 144                 return String.format(formatPattern, hsbState.getHue().intValue(), hsbState.getSaturation().intValue(),
 145                         hsbState.getBrightness().intValue());
 146             case RGB:
 147                 int[] rgb = ColorUtil.hsbToRgb(hsbState);
 148                 return String.format(formatPattern, rgb[0], rgb[1], rgb[2]);
 149             case XYY:
 150                 double[] xyY = ColorUtil.hsbToXY(hsbState);
 151                 return String.format(Locale.ROOT, formatPattern, xyY[0], xyY[1],
 152                         hsbState.getBrightness().doubleValue());
 153             default:
 154                 throw new NotSupportedException(String.format("Non supported color mode: {}", this.colorMode));
 155         }
 156     }
 157 }