expo-image-to-video 0.1.2 → 0.1.4

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'expo.modules.imagetovideo'
-version = '0.1.2'
+version = '0.1.4'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -35,9 +35,27 @@ android {
   namespace "expo.modules.imagetovideo"
   defaultConfig {
     versionCode 1
-    versionName "0.1.2"
+    versionName "0.1.4"
   }
   lintOptions {
     abortOnError false
   }
 }
+
+dependencies {
+    // 2. Kotlin Standard Library (SDK 54 uses Kotlin 1.9+)
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8"
+
+    // 3. Android KTX for cleaner Kotlin code
+    implementation "androidx.core:core-ktx:1.12.0"
+
+    // 4. Coroutines for background processing (Critical for VideoEncoder)
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3"
+
+    // 5. EXIF support for image rotation handling
+    implementation "androidx.exifinterface:exifinterface:1.3.6"
+    
+    // 6. Lifecycle KTX (Useful if you want to scope encoding to the app lifecycle)
+    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.7.0"
+}

package/android/src/main/java/expo/modules/imagetovideo/ExpoImageToVideoModule.kt

@@ -2,6 +2,8 @@ package expo.modules.imagetovideo
 
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
+import expo.modules.kotlin.records.Field    
+import expo.modules.kotlin.records.Record   
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
@@ -40,35 +42,42 @@ class ExpoImageToVideoModule : Module() {
       ))
     }
 
-    AsyncFunction("generateVideo") { options: VideoOptions, promise: expo.modules.kotlin.Promise ->
+    // The 'options' argument will now automatically map to the VideoOptions class below
+        AsyncFunction("generateVideo") { options: VideoOptions, promise: expo.modules.kotlin.Promise ->
             val context = appContext.reactContext ?: throw Exception("Context not found")
             
-            // Run in background thread to keep UI and JS thread responsive
             CoroutineScope(Dispatchers.IO).launch {
                 try {
                     val outputFile = if (options.outputPath != null) {
-                        File(options.outputPath)
+                        File(options.outputPath!!)
                     } else {
                         File(context.cacheDir, "video_${System.currentTimeMillis()}.mp4")
                     }
 
+                    // Ensure defaults are handled if 0 or null
+                    val finalBitrate = options.bitrate ?: 2500000 
+                    
                     val encoder = VideoEncoder(
                         outputFile,
                         options.width,
                         options.height,
                         options.fps,
-                        options.bitrate ?: 2500000
+                        finalBitrate
                     )
 
                     encoder.start()
 
                     options.images.forEach { uri ->
-                        // Resolve Expo/Content URIs to Bitmaps
+                        // Load bitmap with the fixed width/height
                         val bitmap = ImageUtils.loadBitmap(context, uri, options.width, options.height)
-                            ?: throw Exception("Failed to load image: $uri")
                         
-                        encoder.encodeFrame(bitmap)
-                        bitmap.recycle() // Critical for memory management
+                        if (bitmap != null) {
+                            encoder.encodeFrame(bitmap)
+                            bitmap.recycle()
+                        } else {
+                            // Optional: Log warning for failed image load
+                            println("ExpoImageToVideo: Failed to load $uri")
+                        }
                     }
 
                     encoder.stop()
@@ -93,11 +102,25 @@ class ExpoImageToVideoModule : Module() {
 }
 
 // Data class for Expo Module auto-serialization
-data class VideoOptions(
-    val images: List<String>,
-    val fps: Int,
-    val width: Int,
-    val height: Int,
-    val bitrate: Int?,
-    val outputPath: String?
-) : expo.modules.kotlin.types.Enumerable
+// 1. Must implement 'Record'
+// 2. Must use 'var' (mutable) properties
+// 3. Must use '@Field' annotation
+class VideoOptions : Record {
+    @Field
+    var images: List<String> = emptyList()
+
+    @Field
+    var fps: Int = 30
+
+    @Field
+    var width: Int = 1280
+
+    @Field
+    var height: Int = 720
+
+    @Field
+    var bitrate: Int? = null
+
+    @Field
+    var outputPath: String? = null
+}

package/android/src/main/java/expo/modules/imagetovideo/ImageUtils.kt

@@ -0,0 +1,80 @@
+package expo.modules.imagetovideo
+
+import android.content.Context
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import android.graphics.Matrix
+import android.net.Uri
+import androidx.exifinterface.media.ExifInterface
+import java.io.InputStream
+
+object ImageUtils {
+    /**
+     * Loads a bitmap from a URI, scales it to fit the target dimensions,
+     * and corrects the orientation based on EXIF data.
+     */
+    fun loadBitmap(context: Context, uriString: String, targetWidth: Int, targetHeight: Int): Bitmap? {
+        val uri = Uri.parse(uriString)
+        var inputStream: InputStream? = null
+        
+        try {
+            // 1. Get dimensions without loading into memory
+            val options = BitmapFactory.Options().apply {
+                inJustDecodeBounds = true
+            }
+            context.contentResolver.openInputStream(uri).use { 
+                BitmapFactory.decodeStream(it, null, options) 
+            }
+
+            // 2. Calculate scaling to save memory (OOM Prevention)
+            options.inSampleSize = calculateInSampleSize(options, targetWidth, targetHeight)
+            options.inJustDecodeBounds = false
+
+            // 3. Decode the actual bitmap
+            val decodedBitmap = context.contentResolver.openInputStream(uri).use {
+                BitmapFactory.decodeStream(it, null, options)
+            } ?: return null
+
+            // 4. Correct rotation if needed (common with phone photos)
+            return rotateImageIfRequired(context, decodedBitmap, uri)
+        } catch (e: Exception) {
+            e.printStackTrace()
+            return null
+        }
+    }
+
+    private fun calculateInSampleSize(options: BitmapFactory.Options, reqWidth: Int, reqHeight: Int): Int {
+        val (height: Int, width: Int) = options.outHeight to options.outWidth
+        var inSampleSize = 1
+
+        if (height > reqHeight || width > reqWidth) {
+            val halfHeight: Int = height / 2
+            val halfWidth: Int = width / 2
+            while (halfHeight / inSampleSize >= reqHeight && halfWidth / inSampleSize >= reqWidth) {
+                inSampleSize *= 2
+            }
+        }
+        return inSampleSize
+    }
+
+    private fun rotateImageIfRequired(context: Context, img: Bitmap, selectedImage: Uri): Bitmap {
+        val input = context.contentResolver.openInputStream(selectedImage) ?: return img
+        val ei = ExifInterface(input)
+        val orientation = ei.getAttributeInt(ExifInterface.TAG_ORIENTATION, ExifInterface.ORIENTATION_NORMAL)
+
+        return when (orientation) {
+            ExifInterface.ORIENTATION_ROTATE_90 -> rotateImage(img, 90f)
+            ExifInterface.ORIENTATION_ROTATE_180 -> rotateImage(img, 180f)
+            ExifInterface.ORIENTATION_ROTATE_270 -> rotateImage(img, 270f)
+            else -> img
+        }
+    }
+
+    private fun rotateImage(img: Bitmap, degree: Float): Bitmap {
+        val matrix = Matrix()
+        matrix.postRotate(degree)
+        val rotatedImg = Bitmap.createBitmap(img, 0, 0, img.width, img.height, matrix, true)
+        img.recycle()
+        return rotatedImg
+    }
+}

package/build/ExpoImageToVideo.types.d.ts

@@ -16,17 +16,36 @@ export type ExpoImageToVideoViewProps = {
     style?: StyleProp<ViewStyle>;
 };
 export interface VideoOptions {
-    /** Array of local file URIs (e.g., from expo-image-picker or expo-file-system) */
+    /**
+     * An array of local file URIs (file://...) to images.
+     * At least one image is required.
+     */
     images: string[];
-    /** Frames per second (e.g., 30 or 60) */
+    /**
+     * Frames per second for the output video.
+     * Recommended: 30 or 60.
+     */
     fps: number;
-    /** Final video width (pixels) */
+    /**
+     * Width of the output video in pixels.
+     * Example: 1920 (for 1080p), 1280 (for 720p).
+     */
     width: number;
-    /** Final video height (pixels) */
+    /**
+     * Height of the output video in pixels.
+     * Example: 1080 (for 1080p), 720 (for 720p).
+     */
     height: number;
-    /** Target bitrate in bits per second. Default is 2.5Mbps (2,500,000) */
+    /**
+     * Optional bitrate in bits per second.
+     * Higher values = better quality but larger file size.
+     * Default: 2,500,000 (2.5 Mbps).
+     */
     bitrate?: number;
-    /** Optional custom output path. If not provided, a temp file is created */
+    /**
+     * Optional full path to the output file.
+     * If not provided, a temporary file is created in the cache directory.
+     */
     outputPath?: string;
 }
 export type VideoModuleEvents = {};

package/build/ExpoImageToVideo.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoImageToVideo.types.d.ts","sourceRoot":"","sources":["../src/ExpoImageToVideo.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,kBAAkB,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,EAE/B,CAAC"}
+{"version":3,"file":"ExpoImageToVideo.types.d.ts","sourceRoot":"","sources":["../src/ExpoImageToVideo.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,kBAAkB,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,EAE/B,CAAC"}

package/build/ExpoImageToVideo.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoImageToVideo.types.js","sourceRoot":"","sources":["../src/ExpoImageToVideo.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StyleProp, ViewStyle } from 'react-native';\n\nexport type OnLoadEventPayload = {\n  url: string;\n};\n\nexport type ExpoImageToVideoModuleEvents = {\n  onChange: (params: ChangeEventPayload) => void;\n};\n\nexport type ChangeEventPayload = {\n  value: string;\n};\n\nexport type ExpoImageToVideoViewProps = {\n  url: string;\n  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;\n  style?: StyleProp<ViewStyle>;\n};\n\nexport interface VideoOptions {\n  /** Array of local file URIs (e.g., from expo-image-picker or expo-file-system) */\n  images: string[];\n  /** Frames per second (e.g., 30 or 60) */\n  fps: number;\n  /** Final video width (pixels) */\n  width: number;\n  /** Final video height (pixels) */\n  height: number;\n  /** Target bitrate in bits per second. Default is 2.5Mbps (2,500,000) */\n  bitrate?: number;\n  /** Optional custom output path. If not provided, a temp file is created */\n  outputPath?: string;\n}\n\nexport type VideoModuleEvents = {\n  // You could add onProgress here later if needed\n};"]}
+{"version":3,"file":"ExpoImageToVideo.types.js","sourceRoot":"","sources":["../src/ExpoImageToVideo.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StyleProp, ViewStyle } from 'react-native';\n\nexport type OnLoadEventPayload = {\n  url: string;\n};\n\nexport type ExpoImageToVideoModuleEvents = {\n  onChange: (params: ChangeEventPayload) => void;\n};\n\nexport type ChangeEventPayload = {\n  value: string;\n};\n\nexport type ExpoImageToVideoViewProps = {\n  url: string;\n  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;\n  style?: StyleProp<ViewStyle>;\n};\n\nexport interface VideoOptions {\n  /**\n   * An array of local file URIs (file://...) to images.\n   * At least one image is required.\n   */\n  images: string[];\n\n  /**\n   * Frames per second for the output video.\n   * Recommended: 30 or 60.\n   */\n  fps: number;\n\n  /**\n   * Width of the output video in pixels.\n   * Example: 1920 (for 1080p), 1280 (for 720p).\n   */\n  width: number;\n\n  /**\n   * Height of the output video in pixels.\n   * Example: 1080 (for 1080p), 720 (for 720p).\n   */\n  height: number;\n\n  /**\n   * Optional bitrate in bits per second.\n   * Higher values = better quality but larger file size.\n   * Default: 2,500,000 (2.5 Mbps).\n   */\n  bitrate?: number;\n\n  /**\n   * Optional full path to the output file.\n   * If not provided, a temporary file is created in the cache directory.\n   */\n  outputPath?: string;\n}\n\nexport type VideoModuleEvents = {\n  // You could add onProgress here later if needed\n};"]}

package/build/index.d.ts

@@ -1,10 +1,9 @@
-export { default as ExpoImageToVideoView } from './ExpoImageToVideoView';
 import { VideoOptions } from './ExpoImageToVideo.types';
 /**
- * Converts a list of images to an MP4 video file using native hardware encoders.
- * @param options Configuration for the video encoding process.
- * @returns A promise that resolves to the local URI of the generated .mp4 file.
+ * Converts a sequence of images into an MP4 video.
+ * * @param options Configuration object for video generation.
+ * @returns A Promise that resolves to the file URI of the generated video.
  */
 export declare function generateVideo(options: VideoOptions): Promise<string>;
-export * from './ExpoImageToVideo.types';
+export { VideoOptions };
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAIzE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAO1E;AAED,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB1E;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/build/index.js

@@ -1,20 +1,23 @@
-// Reexport the native module. On web, it will be resolved to ExpoImageToVideoModule.web.ts
-// and on native platforms to ExpoImageToVideoModule.ts
-// export { default } from './ExpoImageToVideoModule';
-export { default as ExpoImageToVideoView } from './ExpoImageToVideoView';
-// export * from  './ExpoImageToVideo.types';
 import ExpoImageToVideoModule from './ExpoImageToVideoModule';
 /**
- * Converts a list of images to an MP4 video file using native hardware encoders.
- * @param options Configuration for the video encoding process.
- * @returns A promise that resolves to the local URI of the generated .mp4 file.
+ * Converts a sequence of images into an MP4 video.
+ * * @param options Configuration object for video generation.
+ * @returns A Promise that resolves to the file URI of the generated video.
  */
 export async function generateVideo(options) {
-    // Validate basic requirements before hitting native code
-    if (options.images.length === 0) {
-        throw new Error("At least one image is required to generate a video.");
+    // 1. Validate Image List
+    if (!options.images || options.images.length === 0) {
+        throw new Error("[ExpoImageToVideo] The 'images' array cannot be empty. Please provide at least one image URI.");
     }
+    // 2. Validate Dimensions
+    if (options.width <= 0 || options.height <= 0) {
+        throw new Error(`[ExpoImageToVideo] Invalid dimensions: ${options.width}x${options.height}. Width and height must be positive integers.`);
+    }
+    // 3. Validate FPS
+    if (options.fps <= 0) {
+        throw new Error(`[ExpoImageToVideo] Invalid FPS: ${options.fps}. Frames per second must be greater than 0.`);
+    }
+    // 4. Call Native Module
     return await ExpoImageToVideoModule.generateVideo(options);
 }
-export * from './ExpoImageToVideo.types';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,uDAAuD;AACvD,sDAAsD;AACtD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,6CAA6C;AAE7C,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAI9D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAqB;IACvD,yDAAyD;IACzD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,sBAAsB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,cAAc,0BAA0B,CAAC","sourcesContent":["// Reexport the native module. On web, it will be resolved to ExpoImageToVideoModule.web.ts\n// and on native platforms to ExpoImageToVideoModule.ts\n// export { default } from './ExpoImageToVideoModule';\nexport { default as ExpoImageToVideoView } from './ExpoImageToVideoView';\n// export * from  './ExpoImageToVideo.types';\n\nimport ExpoImageToVideoModule from './ExpoImageToVideoModule';\nimport { VideoOptions } from './ExpoImageToVideo.types';\n\n\n/**\n * Converts a list of images to an MP4 video file using native hardware encoders.\n * @param options Configuration for the video encoding process.\n * @returns A promise that resolves to the local URI of the generated .mp4 file.\n */\nexport async function generateVideo(options: VideoOptions): Promise<string> {\n  // Validate basic requirements before hitting native code\n  if (options.images.length === 0) {\n    throw new Error(\"At least one image is required to generate a video.\");\n  }\n  \n  return await ExpoImageToVideoModule.generateVideo(options);\n}\n\nexport * from './ExpoImageToVideo.types';"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAG9D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAqB;IACvD,yBAAyB;IACzB,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,0CAA0C,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,+CAA+C,CACzH,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,mCAAmC,OAAO,CAAC,GAAG,6CAA6C,CAC5F,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,OAAO,MAAM,sBAAsB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["import ExpoImageToVideoModule from './ExpoImageToVideoModule';\nimport { VideoOptions } from './ExpoImageToVideo.types';\n\n/**\n * Converts a sequence of images into an MP4 video.\n * * @param options Configuration object for video generation.\n * @returns A Promise that resolves to the file URI of the generated video.\n */\nexport async function generateVideo(options: VideoOptions): Promise<string> {\n  // 1. Validate Image List\n  if (!options.images || options.images.length === 0) {\n    throw new Error(\n      \"[ExpoImageToVideo] The 'images' array cannot be empty. Please provide at least one image URI.\"\n    );\n  }\n\n  // 2. Validate Dimensions\n  if (options.width <= 0 || options.height <= 0) {\n    throw new Error(\n      `[ExpoImageToVideo] Invalid dimensions: ${options.width}x${options.height}. Width and height must be positive integers.`\n    );\n  }\n\n  // 3. Validate FPS\n  if (options.fps <= 0) {\n    throw new Error(\n      `[ExpoImageToVideo] Invalid FPS: ${options.fps}. Frames per second must be greater than 0.`\n    );\n  }\n\n  // 4. Call Native Module\n  return await ExpoImageToVideoModule.generateVideo(options);\n}\n\nexport { VideoOptions };"]}

package/ios/ExpoImageToVideo.podspec

@@ -20,7 +20,8 @@ Pod::Spec.new do |s|
 
   s.dependency 'ExpoModulesCore'
 
-  s.frameworks = 'AVFoundation', 'CoreMedia', 'CoreVideo', 'UIKit'
+  #s.frameworks = 'AVFoundation', 'CoreMedia', 'CoreVideo', 'UIKit'
+  s.frameworks = 'AVFoundation', 'CoreMedia', 'CoreVideo', 'UIKit', 'CoreGraphics'
 
   # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {

package/ios/ExpoImageToVideoModule.swift

@@ -1,5 +1,6 @@
 import ExpoModulesCore
 import AVFoundation
+import UIKit
 
 public class ExpoImageToVideoModule: Module {
   // Each module class must implement the definition function. The definition consists of components
@@ -33,19 +34,22 @@ public class ExpoImageToVideoModule: Module {
       ])
     }
 
+    // The 'options' argument automatically maps to the VideoOptions struct below
     AsyncFunction("generateVideo") { (options: VideoOptions, promise: Promise) in
-      // Move to background thread to avoid blocking the JS/UI threads
+      
+      // Run on global background queue to avoid blocking UI
       DispatchQueue.global(qos: .userInitiated).async {
         do {
+          // 1. Output Path Setup
           let outputURL = options.outputPath != nil 
             ? URL(fileURLWithPath: options.outputPath!) 
             : URL(fileURLWithPath: NSTemporaryDirectory()).appendingPathComponent("video_\(UUID().uuidString).mp4")
 
-          // Delete existing file if it exists (AVAssetWriter will fail otherwise)
           if FileManager.default.fileExists(atPath: outputURL.path) {
             try FileManager.default.removeItem(at: outputURL)
           }
 
+          // 2. Initialize Encoder
           let encoder = try VideoEncoder(
             outputURL: outputURL,
             width: options.width,
@@ -54,13 +58,18 @@ public class ExpoImageToVideoModule: Module {
             bitrate: options.bitrate ?? 2_500_000
           )
 
+          // 3. Loop through images
           for (index, imageUri) in options.images.enumerated() {
-            // Use autoreleasepool to prevent memory spikes during high-res processing
+            // Autoreleasepool is critical for memory dumping between frames
             try autoreleasepool {
-              guard let url = URL(string: imageUri),
-                    let data = try? Data(contentsOf: url),
-                    let image = UIImage(data: data) else {
-                throw NSError(domain: "ExpoImageToVideo", code: 1, userInfo: [NSLocalizedDescriptionKey: "Failed to load image at \(imageUri)"])
+              guard let url = URL(string: imageUri) else { return }
+
+              // IMPROVEMENT: Downsample image on load to save RAM (like Android's inSampleSize)
+              let downsampledImage = self.loadDownsampledImage(at: url, for: CGSize(width: options.width, height: options.height))
+              
+              guard let image = downsampledImage else {
+                 print("ExpoImageToVideo: Failed to load \(imageUri)")
+                 return 
               }
 
               let frameTime = CMTime(value: Int64(index), timescale: Int32(options.fps))
@@ -68,6 +77,7 @@ public class ExpoImageToVideoModule: Module {
             }
           }
 
+          // 4. Finish
           encoder.finish { success in
             if success {
               promise.resolve(outputURL.path)
@@ -81,6 +91,23 @@ public class ExpoImageToVideoModule: Module {
       }
     }
 
+    // Helper: Efficiently loads and downsamples image without decoding full resolution first
+  private func loadDownsampledImage(at url: URL, for size: CGSize) -> UIImage? {
+    let options: [CFString: Any] = [
+        kCGImageSourceCreateThumbnailFromImageAlways: true,
+        kCGImageSourceCreateThumbnailWithTransform: true, // Respects EXIF orientation
+        kCGImageSourceShouldCacheImmediately: true,
+        kCGImageSourceThumbnailMaxPixelSize: max(size.width, size.height)
+    ]
+    
+    guard let source = CGImageSourceCreateWithURL(url as CFURL, nil),
+          let cgImage = CGImageSourceCreateThumbnailAtIndex(source, 0, options as CFDictionary) else {
+        return nil
+    }
+    return UIImage(cgImage: cgImage)
+  }
+
+
     // Enables the module to be used as a native view. Definition components that are accepted as part of the
     // view definition: Prop, Events.
     View(ExpoImageToVideoView.self) {
@@ -98,11 +125,23 @@ public class ExpoImageToVideoModule: Module {
 
 
 // Structure to map the JS options object
+// Must inherit from 'Record' and use '@Field'
 struct VideoOptions: Record {
-  @Field var images: [String] = []
-  @Field var fps: Int = 30
-  @Field var width: Int = 1280
-  @Field var height: Int = 720
-  @Field var bitrate: Int? = nil
-  @Field var outputPath: String? = nil
+  @Field
+  var images: [String] = []
+
+  @Field
+  var fps: Int = 30
+
+  @Field
+  var width: Int = 1280
+
+  @Field
+  var height: Int = 720
+
+  @Field
+  var bitrate: Int? = nil
+
+  @Field
+  var outputPath: String? = nil
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-image-to-video",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "High-performance native image-to-video conversion for Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",