Setup and Modes
Last updated
Last updated
0. Check the (universal setup in the first 9 seconds).
1. Import the asset package into your Unity project.
2. Add the PhotoController prefab to your scene (Import of TMP may be required).
3. Camera Setup (required). In the PhotoController inspector, assign your Camera to the Current Camera field and disable prefab`s Camera.
4. Recommended. Unpack prefab and move UICanvas content to existing Canvas or vice versa so UI elements don't overlap.
The asset is ready to use immediately after Camera setup. Run the scene and take a photo.
5. Recommended. In the inspector, PhotoController has references to PhotoSettings and PhotoPrefab for additional settings. The PhotoSettings scriptable object can be replaced with one of the ready-made ones in the SettingsExamples folder or create a new one: Create → Settings → PhotoSettings.
In PhotoSettings, adjust the Sphere Radius (recognition area) relative to your location's dimensions. The smaller the radius, the more precisely the camera recognizes an object among others. The larger the radius, the more objects the camera can recognize in Multiple Objects mode. Also, select the appropriate Render Texture Format for your project for correct rendering. Adjust Crop Width and Height to change the visual proportions of the shots. Set Card Pixel Height and Size values, which are responsible for the height of photos in the collection.
In PhotoPrefab, customize the design of the photo card, for example, the position of the cross relative to the photo or the style of frames.
6. Add the ObjectToPhoto component to scene objects that should contain a description (like a QR code). Add the PhotoDetector component to scene objects that should recognize photos based on the description of photographed objects (like a QR code reader).
Modes in PhotoSettings (advanced settings):
Set Photo Capture Style to Overlay, so a customizable prefab frame (Prefabs > Overlay) will be used for visual capturing.
Set Multiple Objects to true, so the photos can recognize more than one main object.
Set Never Show Photo Description to true, so photos do not display captured data when hovered over.
Set Duplication Mode to true so the player can recreate photographed duplicatable objects. For 2D project set Mode 2D to true so the duplication mode uses 2D coordinates & 2D pointer. Not compatible with Multiple Objects mode.
Set Record As Developer to true to save each photo additionally in the Assets/PhotoCollection/PhotoSprites folder while working in the Unity Editor. Then use the captured images as illustrations for the tutorial or promotional materials.
