Core Components

Photo Controller

The main controller that manages the processes of photographing, sorting, and saving. It stores references to all other components. This component is not meant for editing, only for reading. You can refer to it to get data from PinnedList and AllCards lists, which contain all photo cards in the scene. Contains 3 important references for assignment:

• Current Camera (scene camera that is the source of the photo)

• Photo Settings (scriptable object with photo process settings)

• Photo (photo card prefab with design settings)

Input Controller

A cross-platform input system with automatic configuration for 2D/3D on desktops and mobile devices. This component is not meant for editing. Contains public field to set Input System. By default, the system is set up for the old Input Manager. To fully switch to the new one, follow these steps:

• Open Edit → Project Settings → Player → Configuration, and set Active Input Handling to New if is not already selected. Install the Input System Unity package if it is not already installed. Set EventSystem to InputSystemUIInputModule if it is not already used.

• Set inputSystemType to New in the InputController component.

Photo UI Manager

Responsible for interface, photo interaction, gallery display, and visual feedback. It stores references to UI scene elements. These can be replaced with your own or edited. For example, move the targetSquarePos object to the location on Canvas where the newly created photo (frame) will visually move for saving. If targetSquarePos is not assigned, the frame will animate in place of the photo.

Audio Controller

Contains logic for playing sounds during photo capture and photo card movement.

Detection Volume Manager

Contains auxiliary logic for photo recognition.

Photo Settings (scriptable object)

Contains modes that can be turned on/off: Multiple Mode (for recognizing multiple objects instead of one), Duplication Mode (enables duplication of photographed objects), 2D Mode (for 2D duplication), Never Show Photo Description (to hide descriptions), Record As Developer (to save photos as sprtites in editor too).

Photo Settings example

Allows you to configure photo parameters:

• Photo Capture Style to change frame visual during the capture

• Crop Width, Crop Height for selecting photo proportions

• Render Texture Format and Depth for adjusting photo visual quality

• File Save Format to choose how to save the texture to disk

• Sphere Radius controls the size of object recognition area (should match Crop values, but can be smaller for increased precision)

• multiplayerPrecision increases object recognition accuracy in Multiple Objects mode

• Raycast Layers to choose which layer objects should be recognized

• Size Configuration to adjust photo card sizes (Card Pixel Height - photo height in pixels, idle state in collection, held state, pinned state on board)

• Capture Photo With... to change input type for capture (Hold / Click / Double Click or touch)

• Gamepad Controls to change input type for capture using gamepad device. Axis fields must be filled according to the axes in the Input Manager if using the old input system. See Gamepad Support

Photo Prefab

Controls the behavior of each photo card and contains references to UI elements of each (rotation button, delete button, hover frame, description placement point). In the prefab itself, you can adjust the position of each element relative to the photo card.

• Description Corner determines where the description (Description Point) will be relative to the photo card. None allows you to manually set this point on the photo card, but it won't align with different photo sizes.

• Description Offset is the size of the gap between the description and photo card in pixels. For example, with Bottom, 10 the description will be below the photo card by 10 pixels.

• Description Stretch controls the width and height of the description. This can match the width or height of the photo, scaling based on the Width Multiplier and Height Multiplier. With None, the description always has the same size.

• Delete Button Corner determines where the delete button will be relative to the photo card.

• Rotation Button Corner determines where the rotation button will be relative to the photo card.

• Frame Style contains the sprite used for the frame design.

Object To Photo (what to photograph)

Required for objects with custom descriptions or duplication capability. In the inspector, you need to specify PhotoController. This component can be added to any object to make it recognizable in photos. Has fields for: Custom description (optional), Duplication capability (optional), Unique index for copying (required for duplication).

Photo Detector (recognizes what was photographed)

Required for objects that should recognize photo descriptions. This component can be added to any object that needs to validate a photo's description when a player drags it onto the object. Has a Required Photo Data field for description criteria. PhotoDetector.cs allows editing custom activation logic in the OnActivate() method when photos successfully pass validation. Inside there are commented templates for different reactions, for example, how to drag a photo onto an object and assign it the same texture as in the photo.

Photo Input Blocker

This component can be added to any button to prevent accidental photo capture during clicks. In the inspector, you need to specify PhotoController.

UI Element Checker

This component is added to any UI zone so it can function as a board or collection for moving photos. Inside there are commented templates for reactions to photo transfers to this UI element, similar to a detector object with the PhotoDetector component.

Continious Rotation

Animates objects in the demo scene to demonstrate how photos of dynamic objects are recorded.

Cursor Cam

Tracks input to animate the moment of photo capture.

Photo Data

Required for saving data of each photo.

Spawn Pointer

Required for moving the object that shows the position where a copy of the photographed object will be created in duplication mode.

Photo Controller Editor

A helper script for clear button and field display in the Inspector.

OverlayController

A helper script that controls the behavior and design of the capture frame overlay.