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. (Images that aren't square will not be listed)
- 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".
- Documents/litspheres/ Can contain square images to use as LitSpheres (aka MatCaps) for shading. (Images that aren't square will not be listed)
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", the "Stamps" and the "LitSpheres" 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 dragged into 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.
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.
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.
External Keyboard Support
forger supports external keyboards that can connect to iOS (Apple Smart Keyboard, or any bluetooth one!), users can run shortcuts to speed up their workflow, a full list of keyboard shortcuts can be found in the Appendix section.
A quick way to discover shortcuts is press-holding the command key, although it only shows a small list of all possible shortcuts ;)
Please note that shortcuts are context-dependent they may vary between painting/sculpting.