VImage x/y offset

Author: kasemir

epics-vtype/vtype/src/main/java/org/epics/vtype/IVImage.java

@@ -15,19 +15,27 @@ public class IVImage extends VImage {
 
     private final int height;
     private final int width;
+    private final int xoffset;
+    private final int yoffset;
     private final ListNumber data;
     private final VImageDataType imageDataType;
     private final VImageType imageType;
 
     IVImage(int height, int width, ListNumber data, VImageDataType imageDataType, VImageType imageType, Alarm alarm,
             Time time) {
-        super();
+        this(height, width, 0, 0, data, imageDataType, imageType, alarm, time);
+    }
+
+    IVImage(int height, int width, int xoffset, int yoffset, ListNumber data, VImageDataType imageDataType, VImageType imageType, Alarm alarm,
+            Time time) {
         VType.argumentNotNull("alarm", alarm);
         VType.argumentNotNull("time", time);
         this.alarm = alarm;
         this.time = time;
         this.height = height;
         this.width = width;
+        this.xoffset = xoffset;
+        this.yoffset = yoffset;
         this.data = data;
         this.imageDataType = imageDataType;
         this.imageType = imageType;
@@ -41,6 +49,14 @@ public int getWidth() {
         return width;
     }
 
+    public int getXOffset() {
+        return xoffset;
+    }
+
+    public int getYOffset() {
+        return yoffset;
+    }
+
     public ListNumber getData() {
         return data;
     }

epics-vtype/vtype/src/main/java/org/epics/vtype/VImage.java

@@ -29,6 +29,26 @@ public abstract class VImage extends VType implements AlarmProvider, TimeProvide
      */
     public abstract int getWidth();
 
+    /**
+     * Horizontal pixel offset.
+     * For sub-images within a larger image,
+     * this is the X offset.
+     * Defaults to zero.
+     *
+     * @return pixel offset
+     */
+    public abstract int getXOffset();
+
+    /**
+     * Vertical pixel offset.
+     * For sub-images within a larger image,
+     * this is the Y offset.
+     * Defaults to zero.
+     *
+     * @return pixel offset
+     */
+    public abstract int getYOffset();
+
     /**
      * Image data;
      *
@@ -65,7 +85,25 @@ public abstract class VImage extends VType implements AlarmProvider, TimeProvide
      * @return a new instance of VImage
      */
     public static VImage of(int height, int width, final ListNumber data, VImageDataType imageDataType, VImageType vImageType, Alarm alarm, Time time) {
-        return new IVImage(height, width, data, imageDataType, vImageType, alarm, time);
+        return of(height, width, 0, 0, data, imageDataType, vImageType, alarm, time);
+    }
+
+    /**
+     * Creates a new VImage.
+     *
+     * @param height image height
+     * @param width image width
+     * @param xoffset horizontal offset
+     * @param yoffset vertical offset
+     * @param data image data
+     * @param imageDataType image data type
+     * @param vImageType image type
+     * @param alarm alarm information
+     * @param time timestamp
+     * @return a new instance of VImage
+     */
+    public static VImage of(int height, int width, int xoffset, int yoffset, final ListNumber data, VImageDataType imageDataType, VImageType vImageType, Alarm alarm, Time time) {
+        return new IVImage(height, width, xoffset, yoffset, data, imageDataType, vImageType, alarm, time);
     }
 
     @Override
@@ -80,6 +118,8 @@ public final boolean equals(Object obj) {
             return getClass().equals(other.getClass()) 
                     && getHeight() == other.getHeight()
                     && getWidth() == other.getWidth()
+                    && getXOffset() == other.getXOffset()
+                    && getYOffset() == other.getYOffset()
                     && getData().equals(other.getData())
                     && getDataType().equals(other.getDataType())
                     && getVImageType().equals(other.getVImageType())
@@ -95,6 +135,8 @@ public final int hashCode() {
         int hash = 7;
         hash = 23 * hash + Objects.hashCode(getHeight());
         hash = 23 * hash + Objects.hashCode(getWidth());
+        hash = 23 * hash + Objects.hashCode(getXOffset());
+        hash = 23 * hash + Objects.hashCode(getYOffset());
         hash = 23 * hash + Objects.hashCode(getData());
         hash = 23 * hash + Objects.hashCode(getDataType());
         hash = 23 * hash + Objects.hashCode(getVImageType());