iOS Integration

iOS Files App Interaction

forger exposes its "Documents" folder to the Apple "Files" app so users can interact with elements generated by forger or make new contents accessible to it via this app.

This app also allows users to exchange files with iCloud drive or the different cloud vendors.

The forger Documents folder recognizes and encourages users to fill the following subdirectories to have their contents accessible from the app:

  • Documents/stamps/ Can contain square, black & white images to use as brush tips during painting.
  • Documents/ibls/ Can contain lat-long, HDR images, if possible in the .exr and .hdr formats to light scenes with (Preferably of a maximum of 2000 pixels wide)
  • Documents/images/ Can contain any images that users may want to use to project paint with the "ProjectBrush".

iOS Drag & Drop

forger has partial support for iOS Drag & Drop due to the current limitations of the iOS Drag & Drop system.

Only images can be dropped to the "Resources" and the "Stamps" panels, when dropped, these will be saved automatically to their corresponding subdirectories in the forger Documents directory.

IBL/HDR image dropping is not supported since iOS would clamp HDR image values to the 0-255 range, so it is recommended that users add IBLs via the Apple "Files" app.

Geometry or scene files can't be opened in forger since the current iOS implementation of Drag & Drop is rather primitive and would require an entire file to be loaded in memory before it can be used, whilst that may seem reasonable for some simpler text files it simply isn't acceptable for the kind of files that forger can work with. Once Drag & Drop is a bit more mature Apple might expose some sort of direct access to files so developers can get direct access to a file (and thus be able to load it in chunks), this will be implemented.

Note

Tapping on any Geometry or scene file within the Apple "Files" app will instantly launch forger and load it so there is no need to do the actual drag action.

iTunes File Sharing

Users can use iTunes file sharing for moving files in/out of forger, this feature can be used any time via wifi if iTunes synchronization is enabled for the device or via cable if it is not.

In the "Applications" tab in the device sync preferences, there are two sections, in the lower section, iTunes lets users move files from/to connected devices.

After adding files through the iTunes file sharing interface, models will appear in the "File" menu ready to import.

Open In...

forger allows users to import scenes or models directly from other apps via iOS's "Open In..." functionality.

This can be done from Apple's "Mail" or "Files" apps, Safari, or any other app that may generate or contain any editable file type supported by the app.