Stabilize camera images on Android SDK (Kotlin/Java)
Stay organized with collectionsSave and categorize content based on your preferences.
ARCore now supports Electronic Image Stabilization (EIS), which helps produce a smooth camera preview. EIS achieves stabilization by observing phone movement using gyro and applying compensation homography mesh within the boundaries of camera texture that counters the minor shakes. EIS is only supported in the device's portrait orientation. All orientations will be supported in the 1.39.0 release of ARCore.
Query for EIS support and enable EIS
To enable EIS, configure your session to useImageStabilizationMode.EIS. If the device doesn't support the EIS feature, this will cause an exception to be thrown from ARCore.
When EIS is on, the renderer needs to use the modified device coordinates and matching texture coordinates that incorporate the EIS compensation when rendering the camera background. To get the EIS compensated coordinates, useFrame.transformCoordinates3d(), usingOPENGL_NORMALIZED_DEVICE_COORDINATESas input andEIS_NORMALIZED_DEVICE_COORDINATESas output to get 3D device coordinates andEIS_TEXTURE_NORMALIZEDas output to get 3D texture coordinates. For now, the only supported input coordinate type forFrame.transformCoordinates3d()isOPENGL_NORMALIZED_DEVICE_COORDINATES.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-14 UTC."],[[["\u003cp\u003eARCore now utilizes Electronic Image Stabilization (EIS) to deliver a smoother camera preview by countering minor shakes through gyro-based movement observation and homography mesh compensation within the camera texture boundaries.\u003c/p\u003e\n"],["\u003cp\u003eEIS support is currently limited to portrait orientation on supported devices, with full orientation support planned for the upcoming ARCore 1.39.0 release.\u003c/p\u003e\n"],["\u003cp\u003eTo enable EIS, configure your session with \u003ccode\u003eImageStabilizationMode.EIS\u003c/code\u003e, ensuring device compatibility to avoid exceptions.\u003c/p\u003e\n"],["\u003cp\u003eWhen EIS is active, developers should employ \u003ccode\u003eFrame.transformCoordinates3d()\u003c/code\u003e to obtain modified device and texture coordinates incorporating EIS compensation for accurate background rendering.\u003c/p\u003e\n"],["\u003cp\u003eRendering with EIS necessitates updating shaders to handle 3D coordinates and apply perspective correction to the camera texture, detailed code examples and a sample app are provided for implementation guidance.\u003c/p\u003e\n"]]],[],null,["# Stabilize camera images on Android SDK (Kotlin/Java)\n\nARCore now supports Electronic Image Stabilization (EIS), which helps produce a smooth camera preview. EIS achieves stabilization by observing phone movement using gyro and applying compensation homography mesh within the boundaries of camera texture that counters the minor shakes. EIS is only supported in the device's portrait orientation. All orientations will be supported in the 1.39.0 release of ARCore.\n\nQuery for EIS support and enable EIS\n------------------------------------\n\nTo enable EIS, configure your session to use [`ImageStabilizationMode.EIS`](/ar/reference/java/com/google/ar/core/Config.ImageStabilizationMode#eis). If the device doesn't support the EIS feature, this will cause an exception to be thrown from ARCore. \n\n### Java\n\n```java\nif (!session.isImageStabilizationModeSupported(Config.ImageStabilizationMode.EIS)) {\n return;\n}\nConfig config = session.getConfig();\nconfig.setImageStabilizationMode(Config.ImageStabilizationMode.EIS);\nsession.configure(config);\n```\n\n### Kotlin\n\n```kotlin\nif (!session.isImageStabilizationModeSupported(Config.ImageStabilizationMode.EIS)) return\nsession.configure(\n session.config.apply { imageStabilizationMode = Config.ImageStabilizationMode.EIS }\n)\n```\n\nTransform coordinates\n---------------------\n\nWhen EIS is on, the renderer needs to use the modified device coordinates and matching texture coordinates that incorporate the EIS compensation when rendering the camera background. To get the EIS compensated coordinates, use [`Frame.transformCoordinates3d()`](/ar/reference/java/com/google/ar/core/Frame#transformCoordinates3d-inputCoordinates-inputVertices2d-outputCoordinates-outputVertices3d), using [`OPENGL_NORMALIZED_DEVICE_COORDINATES`](/ar/reference/java/com/google/ar/core/Coordinates2d#opengl_normalized_device_coordinates) as input and [`EIS_NORMALIZED_DEVICE_COORDINATES`](/ar/reference/java/com/google/ar/core/Coordinates3d#eis_normalized_device_coordinates) as output to get 3D device coordinates and [`EIS_TEXTURE_NORMALIZED`](/ar/reference/java/com/google/ar/core/Coordinates3d#eis_texture_normalized) as output to get 3D texture coordinates. For now, the only supported input coordinate type for `Frame.transformCoordinates3d()` is `OPENGL_NORMALIZED_DEVICE_COORDINATES`. \n\n### Java\n\n```java\nfinal FloatBuffer cameraTexCoords =\n ByteBuffer.allocateDirect(COORDS_BUFFER_SIZE_3D)\n .order(ByteOrder.nativeOrder())\n .asFloatBuffer();\n\nfinal FloatBuffer screenCoords =\n ByteBuffer.allocateDirect(COORDS_BUFFER_SIZE_3D)\n .order(ByteOrder.nativeOrder())\n .asFloatBuffer();\n\nfinal FloatBuffer NDC_QUAD_COORDS_BUFFER =\n ByteBuffer.allocateDirect(COORDS_BUFFER_SIZE_2D)\n .order(ByteOrder.nativeOrder())\n .asFloatBuffer()\n .put(\n new float[] {\n /*0:*/ -1f, -1f, /*1:*/ +1f, -1f, /*2:*/ -1f, +1f, /*3:*/ +1f, +1f,\n });\n\nfinal VertexBuffer screenCoordsVertexBuffer =\n new VertexBuffer(render, /* numberOfEntriesPerVertex= */ 3, null);\nfinal VertexBuffer cameraTexCoordsVertexBuffer =\n new VertexBuffer(render, /* numberOfEntriesPerVertex= */ 3, null);\n\nNDC_QUAD_COORDS_BUFFER.rewind();\nframe.transformCoordinates3d(\n Coordinates2d.OPENGL_NORMALIZED_DEVICE_COORDINATES,\n NDC_QUAD_COORDS_BUFFER,\n Coordinates3d.EIS_NORMALIZED_DEVICE_COORDINATES,\n screenCoords);\nscreenCoordsVertexBuffer.set(screenCoords);\n\nNDC_QUAD_COORDS_BUFFER.rewind();\nframe.transformCoordinates3d(\n Coordinates2d.OPENGL_NORMALIZED_DEVICE_COORDINATES,\n NDC_QUAD_COORDS_BUFFER,\n Coordinates3d.EIS_TEXTURE_NORMALIZED,\n cameraTexCoords);\ncameraTexCoordsVertexBuffer.set(cameraTexCoords);\n```\n\n### Kotlin\n\n```kotlin\nval COORDS_BUFFER_SIZE_2D = 2 * 4 * Float.SIZE_BYTES\nval COORDS_BUFFER_SIZE_3D = 3 * 4 * Float.SIZE_BYTES\nval cameraTexCoords =\n ByteBuffer.allocateDirect(COORDS_BUFFER_SIZE_3D)\n .order(ByteOrder.nativeOrder())\n .asFloatBuffer()\nval screenCoords =\n ByteBuffer.allocateDirect(COORDS_BUFFER_SIZE_3D)\n .order(ByteOrder.nativeOrder())\n .asFloatBuffer()\nval cameraTexCoordsVertexBuffer = VertexBuffer(render, /* numberOfEntriesPerVertex= */ 3, null)\nval screenCoordsVertexBuffer = VertexBuffer(render, /* numberOfEntriesPerVertex= */ 3, null)\nval NDC_QUAD_COORDS_BUFFER =\n ByteBuffer.allocateDirect(COORDS_BUFFER_SIZE_2D)\n .order(ByteOrder.nativeOrder())\n .asFloatBuffer()\n .apply {\n put(\n floatArrayOf(\n /* 0: */\n -1f,\n -1f,\n /* 1: */\n +1f,\n -1f,\n /* 2: */\n -1f,\n +1f,\n /* 3: */\n +1f,\n +1f\n )\n )\n }\nNDC_QUAD_COORDS_BUFFER.rewind()\nframe.transformCoordinates3d(\n Coordinates2d.OPENGL_NORMALIZED_DEVICE_COORDINATES,\n NDC_QUAD_COORDS_BUFFER,\n Coordinates3d.EIS_NORMALIZED_DEVICE_COORDINATES,\n screenCoords\n)\nscreenCoordsVertexBuffer.set(screenCoords)\n\nNDC_QUAD_COORDS_BUFFER.rewind()\nframe.transformCoordinates3d(\n Coordinates2d.OPENGL_NORMALIZED_DEVICE_COORDINATES,\n NDC_QUAD_COORDS_BUFFER,\n Coordinates3d.EIS_TEXTURE_NORMALIZED,\n cameraTexCoords\n)\ncameraTexCoordsVertexBuffer.set(cameraTexCoords)\n```\n\nWhen EIS is off, the output 3D coordinates are equivalent to their 2D counterparts, with z values set to produce no change.\n\nModify shaders\n--------------\n\nThe 3D coordinates calculated about should be passed to background rendering shaders. The vertex buffers are now 3D with EIS: \n\n layout(location = 0) in vec4 a_Position;\n layout(location = 1) in vec3 a_CameraTexCoord;\n out vec3 v_CameraTexCoord;\n void main() {\n gl_Position = a_Position;\n v_CameraTexCoord = a_CameraTexCoord;\n }\n\nAdditionally, the fragment shader needs to apply perspective correction: \n\n precision mediump float;\n uniform samplerExternalOES u_CameraColorTexture;\n in vec3 v_CameraTexCoord;\n layout(location = 0) out vec4 o_FragColor;\n void main() {\n vec3 tc = (v_CameraTexCoord / v_CameraTexCoord.z);\n o_FragColor = texture(u_CameraColorTexture, tc.xy);\n }\n\nSee the [hello_eis_kotlin](https://github.com/google-ar/arcore-android-sdk/tree/master/samples/hello_eis_kotlin) sample app for more details."]]
