Working with Automated Annotations in Android

Take the following steps to start a project and add some code that demonstrates the automated annotation features of the LEADTOOLS Android Annotations.

1. Start the Eclipse IDE.
2. From the menu, choose File -> New -> Android Application Project....
3. In the New Android Application dialog box, specify the project name by typing "Android Automation" in the Application Name field, and type "leadtools.androidautomation" in the Package Name field. Then keep clicking the Next button until you have finished creating the project.

4. In the Project Explorer window, right-click on the AndroidAutomation project and select Properties... from the context menu. In the Project Properties dialog box, select the Java Build Path node, and then select the Libraries tab and click Add External JARs. Select the following .jar files:

   • leadtools.jar
   • leadtools.controls.jar
   • leadtools.annotations.core.jar
   • leadtools.annotations.designers.jar
   • leadtools.annotations.rendering.jar
   • leadtools.annotations.automation.jar

   In the Order and Export tab, make sure all the check boxes of the added jar files are checked.

5. In the Project Explorer window, right-click on the AndroidAutomation project and select New -> Folder... from the context menu. Then type "libs" in the Folder name and click OK.

6. Create subfolders under libs. The subfolders created depend on the target CPU, as shown in the following table:

1. Copy the following lib to the target cpu folders:

   • libleadtools.so

2. In the Project Explorer window, select res/layout/*activity_main.xml* file, and replace its content with the following:

   [XAML]

   <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
      xmlns:tools="http://schemas.android.com/tools" 
      android:layout_width="match_parent" 
      android:layout_height="match_parent" 
      android:orientation="vertical" 
      android:weightSum="1.0"  
      android:background="@android:color/black"> 
                       
      <HorizontalScrollView 
         android:layout_width="match_parent" 
         android:layout_height="wrap_content" 
         android:orientation="horizontal"> 
            <LinearLayout 
               android:layout_width="wrap_content" 
               android:layout_height="match_parent" 
               android:orientation="horizontal"> 
                  <Button 
                     android:layout_width="wrap_content" 
                     android:layout_height="wrap_content" 
                     android:text="Load Annotations" 
                     android:onClick="onLoadAnnotations"/> 
                  <Button 
                     android:layout_width="wrap_content" 
                     android:layout_height="wrap_content" 
                     android:text="Save Annotations" 
                     android:onClick="onSaveAnnotations"/> 
                  <Button 
                     android:id="@+id/btn_runmode" 
                     android:layout_width="wrap_content" 
                     android:layout_height="wrap_content" 
                     android:text="Run Mode" 
                     android:onClick="onAnnotationsModeChanged"/> 
                  <Button 
                     android:id="@+id/btn_designmode" 
                     android:layout_width="wrap_content" 
                     android:layout_height="wrap_content" 
                     android:text="Design Mode" 
                     android:onClick="onAnnotationsModeChanged"/> 
            </LinearLayout> 
      </HorizontalScrollView> 
                       
      <RelativeLayout 
         android:id="@+id/relativelayout" 
         android:layout_width="match_parent" 
         android:layout_height="0dp" 
         android:layout_weight=".96" > 
                          
         <ImageView 
            android:layout_width="match_parent" 
            android:layout_height="match_parent" 
            android:background="@android:color/white" 
            android:src="@drawable/yourfile" /> 
                             
      </RelativeLayout> 
                       
      <HorizontalScrollView  
         android:layout_width="match_parent" 
         android:layout_height="wrap_content" 
         android:orientation="horizontal"> 
         <LinearLayout 
            android:layout_width="wrap_content" 
            android:layout_height="match_parent" 
            android:orientation="horizontal"> 
            <Button 
               android:layout_width="wrap_content" 
               android:layout_height="wrap_content" 
               android:text="Select" 
               android:tag="-1" 
               android:onClick="onAnnotationsObjectChanged"/> 
            <Button 
               android:layout_width="wrap_content" 
               android:layout_height="wrap_content" 
               android:text="Pointer" 
               android:tag="-9" 
               android:onClick="onAnnotationsObjectChanged"/> 
            <Button 
               android:layout_width="wrap_content" 
               android:layout_height="wrap_content" 
               android:text="Rectangle" 
               android:tag="-3" 
               android:onClick="onAnnotationsObjectChanged"/> 
            <Button 
               android:layout_width="wrap_content" 
               android:layout_height="wrap_content" 
               android:text="Text" 
               android:tag="-12" 
               android:onClick="onAnnotationsObjectChanged"/> 
            <Button 
               android:layout_width="wrap_content" 
               android:layout_height="wrap_content" 
               android:text="Ruler" 
               android:tag="-23" 
               android:onClick="onAnnotationsObjectChanged"/> 
         </LinearLayout> 
      </HorizontalScrollView> 
   </LinearLayout> 

3. In the previous code, you need to replace "yourfile" with the name of the file that will be drawn in the ImageViewer. To do so, perform the following steps: In the "Package Explorer", select your project, expand it. Now select "res", right-click it and select "New", and then select "Folder". In the folder name field enter "drawable" and then copy your file to that folder and replace its name into the activity_main.xml.

4. In the Project Explorer window, edit the src/leadtools.androidautomation/*MainActivity.java* file, and add the following lines before the Main activity class:

   [Java]

   import java.io.File; 
   import java.io.FileWriter; 
   import java.util.ArrayList; 
   import leadtools.LeadMatrix; 
   import leadtools.LeadPointD; 
   import leadtools.LeadRectD; 
   import leadtools.LeadSizeD; 
   import leadtools.RasterImage; 
   import leadtools.RasterSupport; 
   import leadtools.annotations.automation.AnnAutomation; 
   import leadtools.annotations.automation.AnnAutomationManager; 
   import leadtools.annotations.core.AnnCodecs; 
   import leadtools.annotations.core.AnnContainer; 
   import leadtools.annotations.core.AnnEventListener; 
   import leadtools.annotations.core.AnnFormat; 
   import leadtools.annotations.core.AnnObject; 
   import leadtools.annotations.core.AnnPointerEvent; 
   import leadtools.annotations.core.AnnPointerListener; 
   import leadtools.annotations.core.AnnRenderingEngine; 
   import leadtools.annotations.core.AnnUserMode; 
   import leadtools.annotations.core.IAnnAutomationControl; 
   import leadtools.annotations.rendering.AnnAndroidRenderingEngine; 
   import android.os.Environment; 
   import android.content.Context; 
   import android.graphics.Canvas; 
   import android.view.MotionEvent; 
   import android.view.View; 
   import android.widget.RelativeLayout; 
   import android.widget.Toast; 

5. Add the following member variables to the MainActivity class:

   [Java]

   private AnnAutomation mAutomation; 
   private final String mAnnFilePath = Environment.getExternalStorageDirectory() + "/LEAD_AnnFile.xml"; 

6. Update the onCreate() function as shown below:

   [Java]

   super.onCreate(savedInstanceState); 
   setContentView(R.layout.activity_main); 
                    
   RelativeLayout layout = (RelativeLayout) findViewById(R.id.relativelayout); 
                    
   // Initialize support 
   RasterSupport.initialize(this); 
                    
   // Create automation manager object 
   AnnAutomationManager manager = new AnnAutomationManager(); 
                    
   // Create the default annotations objects 
   manager.createDefaultObjects(); 
                    
   // Initialize custom automation control 
   AutomationControl automatioControl = new AutomationControl(this); 
   layout.addView(automatioControl); 
                    
   mAutomation = new AnnAutomation(manager, automatioControl); 
   mAutomation.setActive(true); 

7. Add the following functions:

   [Java]

   public void onLoadAnnotations(View v) 
   { 
      if(!Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) 
      { 
         return; 
      } 
                       
      // Check if the file exist before load 
      File file = new File(mAnnFilePath); 
      if(file.exists()) 
      { 
         // Create AnnCodecs Objects 
         AnnCodecs codecs = new AnnCodecs(); 
                          
         // Load file 
         AnnContainer container = codecs.load(file, 1); 
                          
         // Clear the current annotation objects 
         mAutomation.getContainer().getChildren().clear(); 
                          
         // add the loaded objects 
         for(AnnObject annObject: container.getChildren()) 
         { 
            mAutomation.getContainer().getChildren().add(annObject); 
         } 
                          
         mAutomation.invalidate(LeadRectD.getEmpty()); 
      } 
   } 
                    
   public void onSaveAnnotations(View v) 
   { 
      if(!Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) 
      { 
         return; 
      } 
                       
      File file = new File(mAnnFilePath); 
                       
      // if the file exist, delete it. 
      if(file.exists()) 
         file.delete(); 
                          
      try 
      { 
         // Save Annotations 
         FileWriter fw = new FileWriter(mAnnFilePath); 
         AnnCodecs codecs = new AnnCodecs(); 
         codecs.save(fw, mAutomation.getContainer(), AnnFormat.ANNOTATIONS, null, 0); 
      } 
      catch(Exception ex) 
      { 
         Toast.makeText(this, ex.getMessage(), Toast.LENGTH_LONG).show(); 
      } 
   } 
                    
   public void onAnnotationsModeChanged(View v) 
   { 
      // Set annotation user mode 
      AnnUserMode mode = v.getId() == R.id.btn_runmode ? AnnUserMode.RUN : AnnUserMode.DESIGN; 
      mAutomation.getManager().setUserMode(mode); 
   } 
                    
   public void onAnnotationsObjectChanged(View v) 
   { 
      // set current object 
      int objectIndex = Integer.parseInt((String)v.getTag()); 
      mAutomation.getManager().setCurrentObjectId(objectIndex); 
   } 
                    
   // Custom automation control 
   private class AutomationControl extends View implements IAnnAutomationControl 
   { 
      private AnnContainer mContainer = null; 
      private AnnAndroidRenderingEngine mEngine = null; 
      private LeadPointD mOffset = new LeadPointD(0, 0); 
      private ArrayList<AnnPointerListener> mAutomationTouchListenersList = new ArrayList<AnnPointerListener>(); 
      public AutomationControl(Context context) 
      { 
         super(context); 
      } 
                       
      @Override 
      public void onDraw(Canvas canvas) 
      { 
         super.onDraw(canvas); 
         mEngine.setContext(canvas); 
         mEngine.render(LeadRectD.getEmpty()); 
         mEngine.setContext(null); 
      } 
                       
      @Override 
      public boolean onTouchEvent(MotionEvent event) 
      { 
         switch(event.getAction()) 
         { 
            case MotionEvent.ACTION_DOWN: 
               AnnPointerEvent annPointerDownEvent = new AnnPointerEvent(this, getAutomationContainer().getMapper().pointToContainerCoordinates(new LeadPointD(event.getX(), event.getY()))); 
               for(AnnPointerListener listener: mAutomationTouchListenersList) 
               listener.onPointerDown(annPointerDownEvent); 
               this.automationInvalidate(LeadRectD.getEmpty()); 
            break; 
            case MotionEvent.ACTION_MOVE: 
               AnnPointerEvent annPointerMoveEvent = new AnnPointerEvent(this, getAutomationContainer().getMapper().pointToContainerCoordinates(new LeadPointD(event.getX(), event.getY()))); 
               for(AnnPointerListener listener: mAutomationTouchListenersList) 
               listener.onPointerMove(annPointerMoveEvent); 
               this.automationInvalidate(LeadRectD.getEmpty()); 
            break; 
            case MotionEvent.ACTION_UP: 
               AnnPointerEvent annPointerUpEvent = new AnnPointerEvent(this, getAutomationContainer().getMapper().pointToContainerCoordinates(new LeadPointD(event.getX(), event.getY()))); 
               for(AnnPointerListener listener: mAutomationTouchListenersList) 
               listener.onPointerUp(annPointerUpEvent); 
               this.automationInvalidate(LeadRectD.getEmpty()); 
            break; 
         } 
                          
         return true; 
      } 
                       
      @Override 
      public void addAutomationEnabledChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void addAutomationGotFocusListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void addAutomationLostFocusListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void addAutomationSizeChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void addAutomationTouchListener(AnnPointerListener listener) 
      { 
         if(!mAutomationTouchListenersList.contains(listener)) 
            mAutomationTouchListenersList.add(listener); 
      } 
                       
      @Override 
      public void addAutomationTransformChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void addAutomationUseDpiChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void automationAttach(AnnContainer container) 
      { 
         mContainer = container; 
         mEngine = new AnnAndroidRenderingEngine(mContainer, null); 
         invalidate(); 
      } 
                       
      @Override 
      public void automationDetach() 
      { 
         mContainer = null; 
      } 
                       
      @Override 
      public void automationInvalidate(LeadRectD rc) 
      { 
         invalidate(); 
      } 
                       
      @Override 
      public AnnContainer getAutomationContainer() 
      { 
         return mContainer; 
      } 
                       
      @Override 
      public double getAutomationDpiX() 
      { 
         return 96.0; 
      } 
                       
      @Override 
      public double getAutomationDpiY() 
      { 
         return 96.0; 
      } 
                       
      @Override 
      public boolean getAutomationEnabled() 
      { 
         return true; 
      } 
                       
      @Override 
      public LeadPointD getAutomationOffset() 
      { 
         return mOffset; 
      } 
                       
      @Override 
      public LeadSizeD getAutomationSize() 
      { 
         return new LeadSizeD(getWidth(), getHeight()); 
      } 
                       
      @Override 
      public LeadMatrix getAutomationTransform() 
      { 
         return LeadMatrix.getIdentity(); 
      } 
                       
      @Override 
      public boolean getAutomationUseDpi() 
      { 
         return false; 
      } 
                       
      @Override 
      public double getAutomationXResolution() 
      { 
         return 96.0; 
      } 
                       
      @Override 
      public double getAutomationYResolution() 
      { 
         return 96.0; 
      } 
                       
      @Override 
      public RasterImage getImage() 
      { 
         return null; 
      } 
                       
      @Override 
      public AnnRenderingEngine getRenderingEngine() 
      { 
         return mEngine; 
      } 
                       
      @Override 
      public void removeAutomationEnabledChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void removeAutomationGotFocusListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void removeAutomationLostFocusListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void removeAutomationSizeChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void removeAutomationTouchListener(AnnPointerListener listener) 
      { 
         if(mAutomationTouchListenersList.contains(listener)) 
            mAutomationTouchListenersList.remove(listener); 
      } 
                       
      @Override 
      public void removeAutomationTransformChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void removeAutomationUseDpiChangedListener(AnnEventListener listener) 
      { 
      } 
                       
      @Override 
      public void setRenderingEngine(AnnRenderingEngine engine) 
      { 
         mEngine = (AnnAndroidRenderingEngine)((engine instanceof AnnAndroidRenderingEngine) ? engine : null); 
      } 
   } 

8. Add the following line to the AndroidManifest.xml before the application tag:

   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

9. Build and run the program.