wajahatx/zoomengine

Features

• Infinite zooming with SUInfinityImageView.
• Bounded zooming with SUBoundedZoomView.
• Seamless integration with SwiftUI using UIViewRepresentable.
• Delegate-based communication to handle zoom state changes.

Installation

Swift Package Manager

Add ZoomEngine to your project using Swift Package Manager:

1. Open your project in Xcode.
2. Go to File > Add Packages.
3. Enter the repository URL: https://github.com/wajahatx/ZoomEngine.
4. Choose the package and add it to your target.

Infinity Zoom

1. Drag a UIImageView into your storyboard.
2. Set the Custom Class of the UIImageView to ZoomEngineInfinityImageView in the Identity Inspector.
3. (Optional) Set the delegate of ZoomEngineInfinityImageView to a class conforming to the ZoomEngineDelegate protocol for zoom state callbacks.

Bounded Zoom

1. Drag a UIView into your storyboard.
2. Set the Custom Class of the UIView to ZoomEngineBoundedView in the Identity Inspector.
3. (Optional) Set the delegate of ZoomEngineBoundedView to a class conforming to the ZoomEngineDelegate protocol for zoom state callbacks.

SWIFTUI

Importing the Library

import ZoomEngine

Example: Using SUInfinityImageView and SUBoundedZoomView

The following example demonstrates how to use SUInfinityImageView for infinite zooming and SUBoundedZoomView for bounded zooming in a SwiftUI view.

Code Sample

import SwiftUI
import ZoomEngine

struct ContentView: View {
    @State var height: CGFloat?
    @State var width: CGFloat?
    @State private var isZooming: Bool = false

    var body: some View {
        VStack(spacing: 0) {
            // Infinite Zooming Image View
            SUInfinityImageView(image: .constant(.test), isZooming: $isZooming, cornerRadius: 0)

            // Bounded Zooming View
            SUBoundedZoomView(isZooming: $isZooming, content: {
                ZStack {
                    Image(.test)
                        .resizable()
                        .aspectRatio(contentMode: .fit)
                        .background(
                            GeometryReader { geo in
                                Color.clear
                                    .onAppear {
                                        self.width = geo.size.width
                                        self.height = geo.size.height
                                    }
                            }
                        )
                }
            })
            .frame(maxWidth: width ?? .infinity, maxHeight: height ?? .infinity)
            .clipped()
            .onChange(of: isZooming) { oldValue, newValue in
                print("Zoom state changed: \(newValue)")
            }
        }
        .frame(maxWidth: .infinity, maxHeight: .infinity)
    }
}

#Preview {
    ContentView()
}

Code Explanation

1. Infinite Zooming:

- SUInfinityImageView is used to create an image view that allows infinite zooming. - Bind the isZooming state to track whether the user is actively zooming.

1. Bounded Zooming:

- SUBoundedZoomView provides zooming within defined bounds. - Use the content closure to define the view that will be zoomable. - GeometryReader captures the size of the container view for dynamic layout adjustments.

1. Zoom State Handling:

- onChange(of: isZooming) monitors zoom state changes and prints the new value.

License

This library is licensed under the MIT License. See the LICENSE file for details.

Contributions

Contributions are welcome! Please feel free to submit a pull request or open an issue to report bugs or suggest new features.

Package Metadata

Repository: wajahatx/zoomengine

Default branch: main

README: README.md