Knowledge Base
Recent Changes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
dev:viewer:core:update_view [2023/05/11 14:40]
pieter [Switch View Mode] 		dev:viewer:core:update_view [2024/04/30 08:15] (current)
pieter [Search & Open best photo]
Line 3: Line 3:
 ===== View Modes ===== ===== View Modes =====
  
-Each View has a View Mode Fly-out menu that can be used to identify the current View Mode and also change the View Mode.+Each View has a 'View Mode' fly-out menu that can be used to identify the current View Mode and also change the View Mode.
 The available View Modes depend on the loaded Resources: The available View Modes depend on the loaded Resources:
  
Line 22: Line 22:
 Move an existing View to a new focus location Move an existing View to a new focus location
  
-Hover over the ID of the View on top, click 'move' and choose another location in one of the Views or Reference View. For image Views, it's possible to choose a specific image by clicking on the footprint of the photo position itself.+Hover over the 'View Actions' fly-out, select the 'Move' action and pick another location by clicking on one of the Views or Reference View. For image views, it's possible to open a specific image by clicking on the footprint of the photo position itself.
  
 To move all views at once, hold Shift in move mode and choose a new location. While holding Shift, 'move' in the View Action Fly-out will change to 'move all' to indicate this. To move all views at once, hold Shift in move mode and choose a new location. While holding Shift, 'move' in the View Action Fly-out will change to 'move all' to indicate this.
Line 30: Line 30:
 Change the View Mode of a View. Change the View Mode of a View.
  
-Hover over the View Mode fly-out and choose the desired View mode to change the type of the existing View.+Hover over the 'View Mode' fly-out and choose the desired View mode to change the type of the existing View.
  
 ===== Focus other Views ===== ===== Focus other Views =====
  
 +Focus other view in the workspace to the same detail.
 +
 +Hover over the 'View Actions' fly-out and select the 'Focus' action to let all other Views in the workspace focus on whatever the view is looking at.  The reference view has a small 'Focus' action button positioned left of the scale bar.
  
 ===== Search & Open best photo ===== ===== Search & Open best photo =====
  
 Add, Move and Focus Views trigger the request to Search and Open the "best" image. \\ Add, Move and Focus Views trigger the request to Search and Open the "best" image. \\
-Depending on the use case and data-type other methods or configurations can be used.  \\ +Depending on the use case and data-type, different methods or configurations can be used.  \\ 
-Anyway, the action consists of 2 consecutive steps+The action consists of 2 consecutive steps
   - Get Candidates   - Get Candidates
-  - Sort Photos+  - Sort Candidates 
 + 
 +Each Image View Mode has its own configuration in [[dev/viewer/core/settings|settings]].
  
 ==== Get Candidates ==== ==== Get Candidates ====
  
-Find relevant photos around the requested Focus Coordinate. \\+Find relevant photos around the Search Center (View Position or Focus Position).\\ 
 Any photo becomes a candidate if  Any photo becomes a candidate if 
-  * Focus Coordinate is nearby the Photo Coordinate (Search Radius)  +  * Search Center is nearby the Photo Position (Search Radius). 
-  * Focus Coordinate is in the field of View of the Photo. +  * Focus Position is inside the field-of-view of the Photo Image (Planar images). 
- +  * Optional: Photo has direct Line-Of-Sight to the Focus Position (is not obstructed by a Mesh for example).
-Searching for candidates is done by incrementally increasing the search radius and ends when +
-  * one photo candidate is found, or +
-  * the maximum search radius is reached.+
  
-The order of the resources in the workspace (or resource group child resources) does not matter.  Each resource is searched at the current search radius and only when none of the child resources yield a candidate, we increment the search radius.  +Searching for candidates is done in multiple steps.\\ With each step the search radius is increased.\\  
 +Search ends when : 
 +  * At least one photo candidate is found (usually more), or 
 +  * The maximum search radius is reached.
  
-==== Sort Photos ====+==== Sort Candidates ====
  
-Sort candidates by relevance, to get the best image and order alternative images. \\ +Sort candidates by relevance, to get the best image and order alternative images.
-The best image has the smallest value for the selected option+
  
-Options: +Available sorting methods: 
-  * By Direction offset \\ Offset between the Candidate Direction (Candidate to Focus Coordinate) and Request Direction (3D View Position to Focus Coordinate). +  * Direction Offset \\ Use the offset between the Candidate Direction (Photo Forward Direction with a fallback on the direction defined by the Photo Position and the Focus Position) and the Request Direction (3D View Position to Focus Position). 
-  * By Pixel offset \\ Pixel offset of the Focus Coordinate projected on the Candidate Image to the Candidate Image Center. +  * Spatial Distance \\ Use the distance between the Photo Position and the Search Center (View Position or Focus Position). 
-  * By Spatial distance \\ Spatial distance of the Focus or View Coordinate to the Candidate Coordinate.+  * Image Center Offset \\ Use the number of pixels between the Image Center and the projection of the Focus Position on the Candidate Image. 
 +  * Direction Offset + Spatial Distance \\ Sort by adding up the rank of each photo for both sorting methods.
  
  
 
Last modified:: 2023/05/11 14:40