Converts between the European and U.S. metric systems. After installing the plugin it can be accessed through the editor's contextual menu by choosing Plugins->Conversion.

Configuring the converter plugin

Adding a new format

If you want to add new format, start Oxygen XML editor and edit the "conversion.xml" file following next steps:

  1. Add a new element 'entries' with the format attribute set to the name of the format. (Eg. The name of the format can be "length", "speed", etc..)
    <entries format = "format name">
    .
    . one or more entries
    .
    </entries>
  2. Add one or more 'entry' inside the 'entries' element. Eg.
    <entry>
       <!-- Master measure unit  -->
       <s1Value>Foot</s1Value> 
    
       <!-- Master measure unit  label-->
       <s1Label>ft</s1Label>
       
       <!-- Slave measure unit  -->
       <s2Value>Meter</s2Value>
       
       <!-- Slave measure unit  label-->
       <s2Label>m</s2Label>
       
        <!-- The conversion factor: result will be : s2 = s1 * convertionFactor-->
        <convertionFactor>0.3048</convertionFactor> 
            <!-- 
            ( or, instead of convertionFactor element :
                <convertionFormula> 
                    <v1>0</v1>
                    <v2>3.2808</v2>
                </convertionFormula>
                result will be : s2 = (s1 - v1) / v2
             )
             -->
        <!-- The number of decimals to be shown in the result-->
         <decimals>4</decimals>             
     </entry>
    
    Note:
    • 's1Value', 's2Value', 's1Label', 's2Label' and one of 'conversionFactor' or 'conversionFormula' tags are REQUIRED;
    • 'decimals' tag AREN'T REQUIRED, if this tag isn't appearing then all decimals of the result will be show.

Changing the labels of the measurement systems

In the beginning of the configuration document, there are the following elements that allow you to control the label strings of the plugin dialog:

<!-- Labels for internationalization-->
<labels>
    <label key="Format" value="Format"/>
    <label key="Master system" value="U.S. System"/>
    <label key="Slave system" value="Metric System"/>
    <label key="Copy value and close" value="Copy value and close"/>
    <label key="Include labels" value="Include labels"/>
    <label key="Swap values" value="Swap values"/>
    <label key="Decimals override" value="Decimals Override"/>
    <label key="Type" value="Type"/>
</labels>
        

By modifying the values you can chnage the labels displayed in the dialog. The keys must remain the same! Make sure you do not modify them.

Changing the default settings

The following section allows locking/unlocking the checkbox that controls the format label insertion. If the value is true, the checkbox is selected and locked.

 <!-- Default values -->
<defaults>
    <defaultvalue key="Lock labels" value="true"/>
</defaults>
        

Sample - AREA

<!-- Area Conversion Factors -->
<entries format="Area">
    <entry>
                <s1Value>Square foot</s1Value>
                <s1Label>sq. ft.</s1Label>
                <s2Value>Square meter</s2Value>
                <s2Label>sq. m.</s2Label>
                <convertionFactor>0.09290304</convertionFactor>                      
                <decimals>-1</decimals>               
    </entry>
    <entry>
                <s1Value>Square inch</s1Value>
                <s1Label>sq. in.</s1Label>
                <s2Value>Square meter</s2Value>
                <s2Label>sq. m.</s2Label>
                <convertionFactor>0.00064516</convertionFactor>                      
                <decimals>-1</decimals>               
    </entry>
    <entry>
                <s1Value>square yard</s1Value>
                <s1Label>sq. yd.</s1Label>
                <s2Value>Square meter</s2Value>
                <s2Label>sq. m.</s2Label>
                <convertionFactor>0.83612736</convertionFactor>                      
                <decimals>-1</decimals>               
    </entry>
    <entry>
                <s1Value>Acre</s1Value>
                <s1Label>ac.</s1Label>
                <s2Value>Hectare</s2Value>
                <s2Label>ha.</s2Label>
                <convertionFactor>0.4047</convertionFactor>                      
                <decimals>-1</decimals>               
    </entry>
</entries>
            

Sample - MASS

<!-- Mass format -->
<entries format="Mass"> 
 <!-- Add a new entry in this format-->

 <!-- This 'entry' will be transform pounds(lb) to Kilograms(kg) 
     with conversion factor 0.4535924.
     All resulted decimals will be show in convertor plugin. -->  
 <entry>
   <s1Value>Pound</s1Value>
   <s1Label>lb.</s1Label>
   <s2Value>Kilograms</s2Value>
   <s2Label>kg.</s2Label>
   <convertionFactor>0.4535924</convertionFactor>                      
 </entry>               

 <!-- This 'entry' will be transform ounce(oz.) to grams(g) 
     with conversion factor 28.34952 -->
     Six resulted decimals will be show in convertor plugin -->  
 <entry>
   <s1Value>Ounce</s1Value> 77
   <s1Label>oz.</s1Label>
   <s2Value>Grams</s2Value>
   <s2Label>g</s2Label>
   <convertionFactor>28.34952</convertionFactor>                      
   <decimals>6</decimals>
 </entry>               
</entries>

Note: