Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[NT-0] doc: Physical and Digital Realities #565

Merged
merged 11 commits into from
Dec 16, 2024
Prev Previous commit
Next Next commit
[NT-0] doc: resolving PR feedback
Correcting grammar and phrasing.
  • Loading branch information
MAG-SamBirley committed Dec 16, 2024
commit 7eb2614f1ee553f269e1c9233b9c34f78946f6d5
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Anchoring supports spatial positioning by accurately mapping physical locations

This alignment ensures _spatiotemporal coherence_; where all users see the same thing in the same place at the same time, creating a cohesive experience between digital and physical realities.

In CSP, anchoring is used to bridge the physical-digital divide, making digital elements appear fixed in real-world locations. The precision, accuracy and stability opf anchors are critical in enabling collaborative AR applications where multiple users need a shared, unchanging view of digital content.
In CSP, anchoring is used to bridge the physical-digital divide, making digital elements appear fixed in real-world locations. The precision, accuracy and stability of anchors are critical in enabling collaborative AR applications where multiple users need a shared, unchanging view of digital content.

### Understanding Digital Coordinates and Transforms

Expand Down Expand Up @@ -199,7 +199,7 @@ Querying anchors in CSP allows developers to locate and manage anchors based on

Anchors can be retrieved via CSP using three different methods in the Anchor System: `GetAnchorsInArea`, `GetAnchorsInSpace`, and `GetAnchorsByAssetCollectionId`.

All of the anchor querying methods support paging. Each parameter allows the application to specify how many anchors to **Skip are** returning and a **Limit** to how many per invocation should be returned.
All of the anchor querying methods support paging. The application can specify how many anchors to `Skip` returning (starting from the first anchor that would be returned by the query), and a `Limit` controlling the maximum number of anchors that the query can return.

### GetAnchorsInArea

Expand All @@ -219,8 +219,8 @@ AnchorSystem->GetAnchorsInArea(
nullptr, // Optional tags
nullptr, // Optional AllTags flag
nullptr, // Optional space IDs
0, // Skip count
10, // Limit on the number of anchors to return
0, // How many anchors to skip returning (starting from the zeroth anchor)
10, // Limit how many anchors are returned by this query
[](const AnchorCollectionResult& Result) {
if (Result.GetResultCode() == csp::systems::EResultCode::Success) {
// Process retrieved anchors
Expand Down Expand Up @@ -282,7 +282,7 @@ To integrate third-party anchors like GCA, CSP provides the parameters `ThirdPar
This parameter specifies the external cloud anchoring provider. For GCA, this value is set to `GoogleCloudAnchors`.

* `ThirdPartyAnchorId`
This parameter is a unique identifier defined byt the third-party anchor provider. It acts as a link between the CSP anchor and the corresponding anchor on the third-party platform, enabling applications to retrieve and resolve the anchor as needed.
This parameter is a unique identifier defined by the third-party anchor provider. It acts as a link between the CSP anchor and the corresponding anchor on the third-party platform, enabling applications to retrieve and resolve the anchor as needed.

## Resolving a Google Cloud Anchor at Runtime

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,7 @@ EntitySystem->CreateObject("MyFiducialMarker", MarkerEntityTransform, Callback);

## Relating Fiducial Marker Transforms to AR Spaces

Fiducial markers are critical in aligning digital content with physical spaces in augmented reality (AR). Their transforms-defined by position, rotation, and scale-determine the placement and orientation of AR content. Understanding how to manage fiducial marker transforms ensures precise spatial alignment in CSP applications.
Fiducial markers are critical in aligning digital content with physical spaces in augmented reality (AR). Their transforms determine the placement and orientation of AR content. Understanding how to manage fiducial marker transforms ensures precise spatial alignment in CSP applications.

![image info](../../_static/physical_digital/fiducial_flow.png)

Expand Down Expand Up @@ -238,7 +238,7 @@ Fiducial markers are useful tools in CSP for aligning digital content with physi
By linking the physical and digital worlds, fiducial markers ensure AR content is displayed correctly, regardless of user perspective or device.

1. **Fiducial Markers and AR Spatial Coherence**
Fiducial markers create a consistent relationship between the physical environment and digital coordinate systems. Their transforms-comprising position, rotation, and scale-define how digital content aligns with the real world. Proper configuration ensures spatial coherence, making AR experiences intuitive and immersive.
Fiducial markers create a consistent relationship between the physical environment and digital coordinate systems. Their transforms define how digital content aligns with the real world. Proper configuration ensures spatial coherence, making AR experiences intuitive and immersive.

2. **Practical Applications in Real-World AR Projects**

Expand Down