Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
dev:viewer:actions:add_view [2023/02/09 18:42] pieter |
dev:viewer:actions:add_view [2023/02/14 14:21] jeroen removed |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Add View ====== | + | ====== Add, Move, Change View ====== |
| + | |||
| + | ===== View Modes ===== | ||
| + | |||
| + | The available View Modes depend on the loaded Resources: | ||
| + | |||
| + | * 3D View | ||
| + | * Streetlevel Spherical View | ||
| + | * Streetlevel Planar View | ||
| + | * Aerial Planar View | ||
| + | * Aerial Oblique Planar View | ||
| + | |||
| + | ===== Add View ====== | ||
| Click on the ' | Click on the ' | ||
| Line 5: | Line 17: | ||
| The different View modes are described [[dev: | The different View modes are described [[dev: | ||
| + | ===== Move View ===== | ||
| + | |||
| + | Move an existing View to a new location | ||
| + | |||
| + | Hover over the ID of the View on top, click ' | ||
| + | |||
| + | To move all views at once, hold Shift in move mode and choose a new location. While holding Shift, ' | ||
| + | |||
| + | ===== Switch View Mode ===== | ||
| + | |||
| + | Change the View Mode of a View. | ||
| + | |||
| + | Hover over the eye-icon on top of the view to open the 'View Mode Fly-out' | ||
| + | |||
| + | ===== Focus other Views ===== | ||
| + | |||
| + | |||
| + | ===== Search & Open best photo ===== | ||
| + | |||
| + | Add, Move and Focus Views trigger the request to Search and Open the " | ||
| + | Depending on the use case and data-type other methods or configurations can be used. \\ | ||
| + | Anyway, the action consists of 2 consecutive steps | ||
| + | - Get Candidates | ||
| + | - Sort Photos | ||
| + | |||
| + | ==== Get Candidates ==== | ||
| + | |||
| + | Find relevant photos around the requested Focus Coordinate. \\ | ||
| + | Any photo becomes a candidate if | ||
| + | * Focus Coordinate is nearby the Photo Coordinate (Search Radius) | ||
| + | * Focus Coordinate is in the field of View of the Photo. | ||
| + | |||
| + | Searching for candidates is done by incrementally increasing the search radius and ends when | ||
| + | * 10 or more candidates are found, or | ||
| + | * the maximum search radius is reached. | ||
| + | |||
| + | ==== Sort Photos ==== | ||
| - | ===== Find Best Photo ====== | + | Sort candidates by relevance, to get the best image and order alternative images. \\ |
| + | The best image has the smallest value for the selected option | ||
| - | FIXME Add find photo algorithm information | + | Options: |
| + | * By Direction offset \\ Offset between the Candidate Direction (Candidate to Focus Coordinate) and Request Direction (3D View Position to Focus Coordinate). | ||
| + | * By Pixel offset \\ Pixel offset of the Focus Coordinate projected on the Candidate Image to the Candidate Image Center. | ||
| + | * By Spatial distance \\ Spatial distance of the Focus Coordinate to the Candidate Coordinate. | ||
| - | Parameters : | ||
| - | * viewPosition : The position of the viewer (optional). | ||
| - | * returnSphericals : Return spherical photo positions? | ||
| - | * returnPlanars : Return planar photo positions? | ||
| - | * minPhotos : The minimum amount of photos to find after applying the requireFocusVisible filter. Ignored if not positive. | ||
| - | * minDistance2D : The minimum 2D distance of photo' | ||
| - | * relevantPhotosMax : The maximum number of relevant photos to return. | ||
| - | * searchDistances2D : The array of search distances to use when finding a closest photo. | ||
| - | * findCloserPhotoAlgorithm : The algorithm to use to find a closest photo. | ||
| - | * PIXEL_DISTANCE : Identifies the technique to find a closest photo by projecting the search coordinate on the photo and then sorting by distance to the photo center. | ||
| - | * SPATIAL_DISTANCE : Identifies the technique to find a closest photo by taking the 3d distance to the view position (fall back on focus position). | ||
| - | * directionFilter : Only return photo' | ||
| - | * tagFilter : Only return photo' | ||
| - | * timeFilter : Only return photo' | ||
| - | * requireFocusVisible : For planars, only return photo' | ||
| - | * isStreetlevel : We are searching on streetlevel? | ||
| - | * If true the 'is focus visible?' | ||
| - | * for each photo by looking at the angular distance between the photo heading (pan) and the heading defined by the vector from photo position to focus position. | ||
| - | * This yields a better result for streetlevel planars (sphericals don't have a 'focus visible' | ||
| - | * tagFilterApplyOnResourceGroupChildren : If tagFilter is specified, this parameter determines whether in case of a resource group, it applies to the children only. false means it applies to the parent resource only. | ||
| - | * timeFilterApplyOnResourceGroupChildren : If timeFilter is specified, this parameter determines whether in case of a resource group, it applies to the children only. false means it applies to the parent resource only. | ||
| - | * searchCenter : Identifies searching around the view position. | ||
| - | * FOCUS : Identifies searching around the focus position and selecting the photo closest to the focus position. | ||
| - | * FOCUS_AND_VIEW : Identifies searching around the focus position and selecting the photo closest to the view position if provided (focus position as fallback). | ||
| - | * VIEW : Identifies searching around the view position and selecting the photo closest to the view position. | ||
| - | ^ ^ default ^ Streetlevel Spherical ^ Streetlevel Planar ^ UAV Planar ^ Oblique Planar ^ | ||
| - | | viewPosition | null | | ||
| - | | returnSphericals | false | | ||
| - | | returnPlanars | false | | ||
| - | | minPhotos | 0 | | ||
| - | | minDistance2D | 0 | | ||
| - | | relevantPhotosMax | 10 | | ||
| - | | searchDistances2D | SearchDistancesStreetlevel | | ||
| - | | findCloserPhotoAlgorithm | SPATIAL_DISTANCE | | ||
| - | | directionFilter | null | | ||
| - | | tagFilter | null | | ||
| - | | timeFilter | null | | ||
| - | | requireFocusVisible | false | | ||
| - | | isStreetlevel | false | | ||
| - | | tagFilterApplyOnResourceGroupChildren | false | | ||
| - | | timeFilterApplyOnResourceGroupChildren | false | | ||
| - | | searchCenter | SEARCH_CENTER_FOCUS | | ||