Component:PhotoMetadata: Difference between revisions

From Resonite Wiki
Re-add descriptions for location & taken fields
m no double space for first line oops
 
(6 intermediate revisions by 2 users not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=PhotoMetadataComponent.png
|Image=PhotoMetadataComponent.png
|Name=Photo Metadata
|Name=Photo Metadata
}}
}}
The '''PhotoMetadata''' component is used to contain the information on a photo usually taken within Resonite. It is automatically attached to every screenshot taken using the finger photo gesture. This component can also be attached to a photo imported with the "import as screenshot" option when importing an image.


<!--T:2-->
<!--T:2-->
Line 12: Line 12:
{{Table ComponentFields
{{Table ComponentFields
|LocationName|String|Name of the session the screenshot was taken in.
|LocationName|String|Name of the session the screenshot was taken in.
|LocationURL|Uri|
|LocationURL|Uri| The URI of the session's world that the photo was taken in. (basically a world link)
|LocationHost|{{RootFieldType|UserRef}}|TypeAdv2=true|Host of the session the screenshot was taken in.
|LocationHost|{{RootFieldType|UserRef}}|TypeAdv2=true|Host of the session the screenshot was taken in.
|LocationAccessLevel|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:SessionAccessLevel|SessionAccessLevel]]&gt;'''|TypeAdv3=true|Access level of the session.
|LocationAccessLevel|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:SessionAccessLevel|SessionAccessLevel]]&gt;'''|TypeAdv3=true|Access level of the session.
Line 18: Line 18:
|TimeTaken|DateTime|Exact timestamp that the screenshot was taken.
|TimeTaken|DateTime|Exact timestamp that the screenshot was taken.
|TakenBy|{{RootFieldType|UserRef}}|TypeAdv6=true|User who took the screenshot.
|TakenBy|{{RootFieldType|UserRef}}|TypeAdv6=true|User who took the screenshot.
|TakenGlobalPosition|Float3|
|TakenGlobalPosition|Float3| The position in [[Coordinate spaces|global space]] the camera had when the photo was taken.
|TakenGlobalRotation|FloatQ|
|TakenGlobalRotation|FloatQ| The rotation in  [[Coordinate spaces|global space]] the camera had when the photo was taken.
|TakenGlobalScale|Float3|
|TakenGlobalScale|Float3| The scale in [[Coordinate spaces|global space]] the camera had when the photo was taken.
|AppVersion|String|Resonite version number of the photographer.
|AppVersion|String|Resonite version number of the photographer.
|UserInfos|{{RootFieldType|SyncList`1|[[Type:UserInfo|UserInfo]]}}|TypeAdv11=true|
|UserInfos|{{RootFieldType|SyncList`1|[[Type:UserInfo|UserInfo]]}}|TypeAdv11=true| See [[Type:UserInfo|UserInfo]]
|__legacyPresentUsers|{{RootFieldType|SyncList`1|[[Type:UserRef|UserRef]]}}|TypeAdv12=true|
|__legacyPresentUsers|{{RootFieldType|SyncList`1|[[Type:UserRef|UserRef]]}}|TypeAdv12=true| Internal. no longer used.
|CameraManufacturer|String|Manufacturer of the camera.
|CameraManufacturer|String|Manufacturer of the camera.
|CameraModel|String|Model of the camera.
|CameraModel|String|Model of the camera.
|CameraFOV|Float|FOV of the camera at picture time.
|CameraFOV|Float|FOV of the camera at picture time.
|Is360|Bool|Whether the image is a 360 degree image or not.
|Is360|Bool|Whether the image is a 360 degree image or not.
|StereoLayout|StereoLayout|
|StereoLayout|StereoLayout| The layout of the image's left and right sections if it is a stereoscopic image, also known as a 3D image.
|_exportedUsers|{{RootFieldType|SyncBag`1|[[Type:UserRef|UserRef]]}}|TypeAdv18=true|
|_exportedUsers|{{RootFieldType|SyncBag`1|[[Type:UserRef|UserRef]]}}|TypeAdv18=true| This is a list of users that exported the screenshot. If this component is part of a saved item, this is the list of users that exported the screenshot before the item was saved to the cloud.
}}
}}


<!--T:3-->
== Sync Delegates ==
== Usage ==
{{Table ComponentTriggers
|SetFromCurrentWorld()|[[Type:Action|Action]]| {{Template:AssetMetadataSetFromWorld}}
}}


<!--T:4-->
<!--T:4-->
== Examples ==
== Examples ==
<gallery widths=480px heights=480px>
File:Component_AssetMetadata_Example_1.webp|The PhotoMetadata component on a screenshot.
</gallery>


<!--T:5-->
<!--T:5-->
== Related Components ==
== See Also ==
* [[Component:FileMetadata]]
* [[Component:AssetMetadata]]
* [[Component:AudioMetadata]]
 
</translate>
</translate>
[[Category:ComponentStubs]]
[[Category:Components{{#translation:}}|Photo Metadata]]
[[Category:Components{{#translation:}}|Photo Metadata]]
[[Category:Components:Data{{#translation:}}|Photo Metadata]]
[[Category:Components:Data{{#translation:}}|Photo Metadata]]

Latest revision as of 22:33, 7 November 2024

Component image 
Photo Metadata component as seen in the Scene Inspector

The PhotoMetadata component is used to contain the information on a photo usually taken within Resonite. It is automatically attached to every screenshot taken using the finger photo gesture. This component can also be attached to a photo imported with the "import as screenshot" option when importing an image.

Fields

Fields
Name Type Description
persistent Bool Determines whether or not this item will be saved to the server.
UpdateOrder Int Controls the order in which this component is updated.
Enabled Bool Controls whether or not this component is enabled.
LocationName String Name of the session the screenshot was taken in.
LocationURL Uri The URI of the session's world that the photo was taken in. (basically a world link)
LocationHost direct UserRef Host of the session the screenshot was taken in.
LocationAccessLevel Nullable`1<SessionAccessLevel> Access level of the session.
LocationHiddenFromListing Nullable`1<Bool> Whether the location was marked as hidden.
TimeTaken DateTime Exact timestamp that the screenshot was taken.
TakenBy direct UserRef User who took the screenshot.
TakenGlobalPosition Float3 The position in global space the camera had when the photo was taken.
TakenGlobalRotation FloatQ The rotation in global space the camera had when the photo was taken.
TakenGlobalScale Float3 The scale in global space the camera had when the photo was taken.
AppVersion String Resonite version number of the photographer.
UserInfos list of UserInfo See UserInfo
__legacyPresentUsers list of UserRef Internal. no longer used.
CameraManufacturer String Manufacturer of the camera.
CameraModel String Model of the camera.
CameraFOV Float FOV of the camera at picture time.
Is360 Bool Whether the image is a 360 degree image or not.
StereoLayout StereoLayout The layout of the image's left and right sections if it is a stereoscopic image, also known as a 3D image.
_exportedUsers direct SyncBag`1<UserRef> This is a list of users that exported the screenshot. If this component is part of a saved item, this is the list of users that exported the screenshot before the item was saved to the cloud.

Sync Delegates

Triggers
Method Name Method type and Arguments. Description
SetFromCurrentWorld() Action fills in all the fields using the current session data and the local user (the user running this method)

Examples

See Also