Add new camera perspectives for animations (#8909)

This PR adds two new camera perspectives for animation jobs:
- static camera looking at XY plane (top-down view on the stack)
- static, isometric camera looking a the corner between XY, XZ, YZ plane


### Steps to test:
- CI should be enough for the frontend, backend changes
- Otherwise see worker PR

### TODOs:
- [ ] Merge related [worker PR
first](scalableminds/voxelytics#4279)

# DO NOT MERGE BEFORE UPDATING AND DEPLOYING WORKER FIRST

### Issues:
- None

------
(Please delete unneeded items, merge only when none are left open)
- [ ] Added changelog entry (create a `$PR_NUMBER.md` file in
`unreleased_changes` or use `./tools/create-changelog-entry.py`)
- [ ] Added migration guide entry if applicable (edit the same file as
for the changelog)
- [x] Updated [documentation](../blob/master/docs) if applicable
- [ ] Adapted [wk-libs python
client](https://github.com/scalableminds/webknossos-libs/tree/master/webknossos/webknossos/client)
if relevant API parts change
- [ ] Removed dev-only changes like prints and application.conf edits
- [ ] Considered [common edge
cases](../blob/master/.github/common_edge_cases.md)
- [ ] Needs datastore update after deployment

Author: hotzenklotz

app/controllers/JobController.scala

@@ -31,7 +31,7 @@ object MovieResolutionSetting extends ExtendedEnumeration {
 }
 
 object CameraPositionSetting extends ExtendedEnumeration {
-  val MOVING, STATIC_XZ, STATIC_YZ = Value
+  val MOVING, STATIC_ISOMETRIC, STATIC_XY, STATIC_XZ, STATIC_YZ = Value
 }
 
 case class AnimationJobOptions(

docs/automation/animations.md

@@ -12,7 +12,7 @@ Creating an animation is easy:
 2. Optionally, load some [3D meshes](../meshes/index.md) for any segments that you wish to highlight.
 3. For larger datasets, use the bounding box tool to create a bounding box around your area of interest. Smaller datasets can be used in their entirety.
 4. From the `Menu` dropdown in navbar at the top of the screen, select "Create Animation".
-5. Configure the animation options as desired, i.e. camera movement or resolution.
+5. Configure the animation options as desired, i.e. camera movement and positioning or video resolution.
 6. Click the `Start animation` button to launch the animation creation.
 
 

frontend/javascripts/types/api_types.ts

@@ -1280,6 +1280,8 @@ export type FolderUpdater = {
 
 export enum CAMERA_POSITIONS {
   MOVING = "MOVING",
+  STATIC_ISOMETRIC = "STATIC_ISOMETRIC",
+  STATIC_XY = "STATIC_XY",
   STATIC_XZ = "STATIC_XZ",
   STATIC_YZ = "STATIC_YZ",
 }

frontend/javascripts/viewer/view/action-bar/create_animation_modal.tsx

@@ -406,12 +406,18 @@ function CreateAnimationModal(props: Props) {
                 <Radio.Button value={CAMERA_POSITIONS.MOVING}>
                   Camera circling around the dataset
                 </Radio.Button>
+                <Radio.Button value={CAMERA_POSITIONS.STATIC_XY}>
+                  Static camera looking at XY-viewport{" "}
+                </Radio.Button>
                 <Radio.Button value={CAMERA_POSITIONS.STATIC_XZ}>
                   Static camera looking at XZ-viewport{" "}
                 </Radio.Button>
                 <Radio.Button value={CAMERA_POSITIONS.STATIC_YZ}>
                   Static camera looking at YZ-viewport{" "}
                 </Radio.Button>
+                <Radio.Button value={CAMERA_POSITIONS.STATIC_ISOMETRIC}>
+                  Static camera with an isometric perspective looking at all 3 viewports{" "}
+                </Radio.Button>
               </Space>
             </Radio.Group>
           </Col>

unreleased_changes/8909.md

@@ -0,0 +1,2 @@
+### Added
+- Added new camera positioning option for animations.