Added functionality in Shot Manager to create all cameras for a Kitsu Sequence

README.md

@@ -295,6 +295,27 @@ The shot is added at the end of the sequence and the scene's **End** frame grows
 
 The rig is built at the **3D cursor**, in the active collection: place the cursor and pick the collection first if you have a camera collection. The add-on keeps the rig's bone shapes in a hidden **Widgets** collection. If the add-on is not enabled, the dialog says so and no shot is added.
 
+### Shots from Kitsu
+
+**Shots from Kitsu...** builds every camera a sequence needs in one go, from the shots and casting in Kitsu. It needs Libreflow connected in the [Scene Manager](#connecting).
+
+1. Click **Shots from Kitsu...** and pick the sequence. The sequence of the Scene Manager's shot is at the top of the list.
+2. The dialog lists the Kitsu shots of the sequence in name order. Each line shows its frame count and what is cast in it:
+   - camera icon: to build;
+   - check mark: a shot of that name is in the scene already, left as it is;
+   - greyed out: nothing is cast in it (see **Only Cast Shots**).
+3. Choose the settings and click **OK**.
+
+| Setting | Use |
+|---|---|
+| **Only Cast Shots** | On (default): shots with nothing cast in Kitsu get no camera. |
+| **3D Cameras** | On: 3D **crane** rigs. Off: **2D** camera rigs. |
+| **Default Duration** | Length of the shots without a frame count in Kitsu. |
+
+Each shot is built as with **+**: an Add Camera Rigs rig at the 3D cursor, `CAM_<sequence>_<shot>` / `RIG_<sequence>_<shot>`, named with the Kitsu sequence name, and a camera marker named after the Kitsu shot. The shots go one after the other after the shots of the scene, in Kitsu order. Each one is as long as its Kitsu frame count (**Nb Frames**). When the sequence name follows `SEQUENCE_NAME_FORMAT`, the **Sequence** field is set from it. Running it again only adds the shots that are still missing, so it also picks up shots added in Kitsu later. **Ctrl+Z** undoes it.
+
+The frame counts and the casting of the whole sequence come from the wtdcmds command `wtd_get_sequence_shots`. With an older wtdcmds the shots are found shot by shot from their casting: it is slower, the shots that are not in Kitsu are left out, and every shot gets the **Default Duration**.
+
 ### Deleting a shot
 
 Put the playhead on the shot (or select it in the list) and click **−**:
@@ -517,6 +538,9 @@ The newer version is published but not downloaded on this site yet. Request it (
 **Scene Manager: "...its wtdcmds extension is too old".**
 Libreflow runs an older `wtdcmds` without the command (e.g. requests). Update the extension and restart Libreflow.
 
+**Shot Manager: Shots from Kitsu lists no shot.**
+The sequence has no shot in Kitsu, or its shots have Kitsu names that differ from the Libreflow ones. `melvile_test / sq00A` is such a sequence.
+
 **Shot Manager: playback only plays one shot.**
 **Loop Shot** is on. Untick it to play the whole sequence.