안드로이드에서 이미지 확대·축소(핀치 줌) 기능 구현하는 방법

이 튜토리얼에서는 안드로이드 앱에서 이미지에 확대·축소(핀치 줌) 기능을 구현하는 방법을 단계별로 소개합니다. 두 손가락으로 화면을 벌리거나 오므리는 제스처를 감지해 이미지 크기를 자연스럽게 조절할 수 있으며, ScaleGestureDetector 클래스를 활용하는 것이 핵심입니다.

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project 메뉴로 이동한 후, 필요한 모든 세부 정보를 입력하여 새 프로젝트를 생성합니다.

2단계 — 레이아웃 작성 (res/layout/activity_main.xml)

먼저 확대·축소할 이미지를 res/drawable 폴더에 넣어둔 뒤, activity_main.xml에 다음과 같이 ImageView를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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"
    tools:context=".MainActivity">

    <ImageView
        android:id="@+id/imageView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:src="@drawable/sample_image" />

</RelativeLayout>

3단계 — MainActivity.java 코드 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다. ScaleGestureDetector가 사용자의 핀치 제스처를 감지하면 onScale() 콜백에서 배율(scale factor)을 계산하고, 이 값을 ImageView의 X·Y 스케일에 적용합니다. 이 예제에서는 배율을 최소 1배, 최대 10배로 제한하여 이미지가 무한정 커지거나 사라지지 않도록 했습니다.

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.view.MotionEvent;
import android.view.ScaleGestureDetector;
import android.widget.ImageView;

public class MainActivity extends AppCompatActivity {

    private ScaleGestureDetector scaleGestureDetector;
    private float scaleFactor = 1f;
    private ImageView imageView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        imageView = findViewById(R.id.imageView);
        scaleGestureDetector = new ScaleGestureDetector(this, new ScaleListener());
    }

    public boolean onTouchEvent(MotionEvent motionEvent) {
        scaleGestureDetector.onTouchEvent(motionEvent);
        return true;
    }

    private class ScaleListener extends ScaleGestureDetector.SimpleOnScaleGestureListener {
        @Override
        public boolean onScale(ScaleGestureDetector scaleGestureDetector) {
            scaleFactor *= scaleGestureDetector.getScaleFactor();
            scaleFactor = Math.max(1f, Math.min(scaleFactor, 10.0f));
            imageView.setScaleX(scaleFactor);
            imageView.setScaleY(scaleFactor);
            return true;
        }
    }
}

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.sample">

    <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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 상단 툴바의 Run 아이콘을 클릭합니다. 기기 목록에서 본인의 모바일 기기를 선택하면, 해당 기기 화면에 앱의 기본 화면이 표시됩니다.

이후 화면에서 두 손가락으로 이미지를 벌리면 최대 10배까지 확대되고, 손가락을 오므리면 원래 크기(1배)로 되돌아오는 것을 확인할 수 있습니다.