【Kotlin】AndroidでImageViewのピンチイン・ピンチアウト（拡大・縮小）を実装する方法

この記事では、Kotlinを使ってAndroidアプリのImageViewにズームイン（拡大）とズームアウト（縮小）機能を実装する方法を解説します。ピンチジェスチャーを検出するScaleGestureDetectorを活用することで、指2本での直感的な画像の拡大・縮小操作が可能になります。

手順1：新規プロジェクトを作成する

Android Studioを開き、「File」→「New Project」を選択して、必要な情報を入力し、新しいプロジェクトを作成します。

手順2：レイアウトファイル（activity_main.xml）にコードを追加する

res/layout/activity_main.xml に以下のコードを記述します。ImageViewを画面中央に配置したシンプルなLinearLayout構造です。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical"
    android:padding="16dp"
    tools:context=".MainActivity">
    <ImageView
        android:id="@+id/imageView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:src="@drawable/image" />
</LinearLayout>

手順3：MainActivity.ktにコードを追加する

src/MainActivity.kt に以下のコードを記述します。ScaleGestureDetectorでピンチ操作を検出し、スケール係数を0.1倍〜10倍の範囲に制限しながらImageViewに反映させます。

import android.os.Bundle
import android.view.MotionEvent
import android.view.ScaleGestureDetector
import android.view.ScaleGestureDetector.SimpleOnScaleGestureListener
import android.widget.ImageView
import androidx.appcompat.app.AppCompatActivity
import kotlin.math.max
import kotlin.math.min
class MainActivity : AppCompatActivity() {
    private lateinit var scaleGestureDetector: ScaleGestureDetector
    private var scaleFactor = 1.0f
    private lateinit var imageView: ImageView
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        imageView = findViewById(R.id.imageView)
        scaleGestureDetector = ScaleGestureDetector(this, ScaleListener())
    }
    override fun onTouchEvent(motionEvent: MotionEvent): Boolean {
        scaleGestureDetector.onTouchEvent(motionEvent)
        return true
    }
    private inner class ScaleListener : SimpleOnScaleGestureListener() {
        override fun onScale(scaleGestureDetector: ScaleGestureDetector): Boolean {
            scaleFactor *= scaleGestureDetector.scaleFactor
            scaleFactor = max(0.1f, min(scaleFactor, 10.0f))
            imageView.scaleX = scaleFactor
            imageView.scaleY = scaleFactor
            return true
        }
    }
}

コードのポイント

• ScaleGestureDetector： 2本の指によるピンチジェスチャーを検出するクラスです。
• scaleFactor： 現在の拡大率を保持します。初期値は1.0f（等倍）です。
• max(0.1f, min(scaleFactor, 10.0f))： 拡大率を0.1倍〜10倍の間に制限し、極端な拡大・縮小を防ぎます。
• onScale()： ピンチ操作のたびに呼び出され、ImageViewのscaleX・scaleYを更新します。

手順4：AndroidManifest.xmlのコードを確認する

androidManifest.xml は以下のようになります。特別な権限は不要です。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.q11">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリを実行して動作を確認する

それでは、実際にアプリを実行してみましょう。Android端末をパソコンに接続していることを前提としています。Android Studioから実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。表示された選択肢から接続中のモバイルデバイスを選択すると、実機の画面にアプリが起動します。

アプリを起動したら、画面上の画像に対して指2本でピンチイン・ピンチアウト操作を行ってください。画像が滑らかに拡大・縮小されれば、実装は成功です。