IPA Projection Adjustment

Adjusting UI Layout for IPA Projections

This guide provides instructions for editing the ui_measurements.json file to adjust the layout of the IPA (Interactive Projection Area) menu and projection configurations. These changes primarily affect the projection layout, specifically for highlighting bins correctly within the port window. Typically you can calibrate the IPA through the settings on it’s UI, but in certain cases the open part of the port may be covered and may require manual changes.

File Location

The configuration file is located at:

/ipa/data/backend/conf/dynamic/ui_measurements.json

Structure of ui_measurements.json

Below is an example of the file structure:

{

   "version": "0001",

   "uiMeasurements": {

     "screenLayoutMeasurements": {

       "anchorPoints": {

         "bottom": 1292.0,

         "left": 1027.0,

         "right": 2735.0,

         "top": 106.0

       },

       "scaleFactorX": 2.58595912466475,

       "scaleFactorY": 2.58595912466475

     }

   }

}

Key Parameters

1. anchorPoints:
   • Defines the visible boundaries of the port window.
     • bottom: Position of the bottom edge of the visible area.
     • top: Position of the top edge of the visible area.
     • left: Position of the left edge of the visible area.
     • right: Position of the right edge of the visible area.
   • Modify these values to adjust the position and size of the projected area.
2. scaleFactorX and scaleFactorY:
   • Control the scaling of the projection in the X and Y axes.
   • These factors are calculated based on the physical height of the projector above the surface and the projector's hardware zoom level.
   • Adjusting these may require trial and error to achieve the desired scaling.

Steps to Adjust the Projection

1. Backup the Original File:
   • Before making any changes, create a backup of the original ui_measurements.json file.
2. Modify anchorPoints:
   • Adjust the values under anchorPoints to shift or resize the visible area of the projection.
   • Example:
     • Increasing the bottom value lowers the bottom edge of the projection.
     • Increasing the left value shifts the projection further left.
3. Adjust Scaling:
   • Modify scaleFactorX and scaleFactorY to tweak the scaling of the projection.
   • Use small increments to find the ideal configuration.
4. Test Changes:
   • Refresh the IPA browser to apply the changes.
   • May need a Sudo Reboot
   • Verify that the highlighted area aligns correctly within the port window or compartment.

Notes

• Touch Calibration: These adjustments only affect the visible projection. Touch interactions use a separate calibration process and will not automatically align with these changes.
• Hardware Dependencies: The scaling factors depend on the physical setup, including the projector height and zoom level. Ensure these are fixed before making adjustments.
• Trial and Error: Precise alignment may require several iterations of adjustment and testing.

Disclaimer

Changing these values can impact the system's behavior. Proceed cautiously, and ensure any changes are documented for future reference. Always try to calibrate the IPA first before resorting to this solution.