Image

First, you have to import Layout class:

      import com.infairy.cocina.SDK.Layout.Layout;
      import com.infairy.cocina.SDK.Layout.LayoutImage;
      

Then, get Layout service

        Layout layout=(Layout)Tools.getService(context, Layout.class.getName(), "(FUNCTION=LAYOUT)");
      

Next, create layout tag and get LayoutID for other layout object used purpose:

            LayoutTag ltag=new LayoutTag();

            ltag.backgroundImage="img/background.png";
            ltag.bundleID=BundleID;
            ltag.LayoutHeight=450;
            ltag.LayoutWidth=800;
            ltag.title="My App";
            /*
             * Create layout tag and get layout id for other layout object use
             */
            LayoutID=layout.createUI(this, ltag);
      

Nex, create image layout object:

              LayoutImage lim=new LayoutImage();
              lim.LayoutID=LayoutID;              //set the image layout belong to the Layout with the LayoutID
              lim.imageSrc="png/switch.png";
              lim.width=164;
              lim.height=164;
              //create image layout object
              imageId=layout.createUI(this, lim);
      

The Image layout can be clicked by users, you just need to do defined the key value:

          lim.key=device.DEVICE_OPERATION_USER_DEFINED_0;
      

"DEVICE_OPERATION_USER_DEFINED_0" is defined by com.infairy.cocina.SDK.device.DevicePool#DEVICE_OPERATION_xxx
then defined the Operation object( refer to Operation):

        public class myFirstBundle implements BundleActivator, Runnable{
            ...
           
           /*
            * Bundle ID
            */
           String BundleID="";
           
           /*
            * Layout ID
            */
           String LayoutID="";
           
           Thread me;

           /*
            * Layout object 
            */
           Layout layout;
           
          /*
           * entry point
           */
          public void start(BundleContext context) throws Exception {
              ...
              /*
               * get layout service
               */
              layout=(Layout)Tools.getService(context, Layout.class.getName(), "(FUNCTION=LAYOUT)");

              .....

              /*
               * define operation for layout key mapping
               */
              Vector Operation=new Vector();
              OperationDNA oobj=new OperationDNA();
              
              //when user click the image layout object, this operation object will trigger to run the Funtoin:Go()
              oobj.KEY=device.DEVICE_OPERATION_USER_DEFINED_0;   
              oobj.Function="Go";
              Operation.addElement(oobj);
              
              dict.put(InfairyInterface.DeviceOperation, Operation);

              ...
              
              BundleID=device.addDevice(this, dict);
            

You have also implemnt Go() function to catch up the action.

              public void Go(){
                ....
              }
            

The Image layout object properties show as below:

          /**
           * layout id of bundle
           */
          public String LayoutID="";
          /**
           * Layout key defined, please refer to {@link com.infairy.cocina.SDK.device.DevicePool#DEVICE_OPERATION_DIMMER}, {@link com.infairy.cocina.SDK.device.DevicePool#DEVICE_OPERATION_xxx}...
           */
          public String key="";
          /**
           * layout width in pixel, default is  10
           */
          public int width=10;
          /**
           * layout height in pixel, default is 10
           */
          public int height=10;
          /**
           * layout axis of left, default is 0
           */
          public int left=0;
          /**
           * layout axis of top, default is 0
           */
          public int top=0;
          /**
           * text align, Layout key defined, please refer to 
           *  {@link com.infairy.cocina.SDK.device.DevicePool#LAYOUT_ITEM_ALIGN_CENTER} 
           *  {@link com.infairy.cocina.SDK.device.DevicePool#LAYOUT_ITEM_ALIGN_CENTER_VERTICAL} 
           *  {@link com.infairy.cocina.SDK.device.DevicePool#LAYOUT_ITEM_ALIGN_CENTER_HORIZONTAL} 
           *  {@link com.infairy.cocina.SDK.device.DevicePool#LAYOUT_ITEM_ALIGN_LEFT} 
           *  {@link com.infairy.cocina.SDK.device.DevicePool#LAYOUT_ITEM_ALIGN_RIGHT}
           */
          public String textAlign="";
          /**
           * layout key value, defined by developer
           */
          public String value="";
          /**
           * text
           */
          public String text="";
          /**
           * image src / url
           */
          public String imageSrc="";
          /**
           * font color
           */
          public String fontColor="";
          /**
           * font size, default is 10
           */
          public int fontSize=10;
          /**
           * background color
           */
          public String backgroundColor="";
          /**
           * display time, when this time'up, this object will disappear, and appear after click again
           * , default is 0
           */
          public long displayTime=0;
          /**
           * when user click this layout, the UI was switch the the layout id
           */
          public String ChangedLayoutID="";
          /**
           * layout key index value, defined by developer
           */
          public String index="";
          /**
           * visibility, default is true
           */
          public boolean visible=true;
          /**
           * transparent(0.0~1.0) of layout, default is 1.0
           */
          public double alpha=1.0;