Docs: Remove Download Links from Add-On Table & Remove Add-On READMEs from Docs #270
@ -43,7 +43,7 @@ If Kitsu is up and running and you can successfully log in via the web interface
|
|||||||
|
|
||||||
###### **Setup Login Data**
|
###### **Setup Login Data**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Host**: The web address of your kitsu server (e.g., https://kitsu.mydomain.com)<br/>
|
>**Host**: The web address of your kitsu server (e.g., https://kitsu.mydomain.com)<br/>
|
||||||
**Email**: The email you use to log in to kitsu<br/>
|
**Email**: The email you use to log in to kitsu<br/>
|
||||||
@ -53,7 +53,7 @@ Press the login button. If the login was successful, the next step is..
|
|||||||
|
|
||||||
###### **Setup Project Settings**
|
###### **Setup Project Settings**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Project Root Directory**: Path to the root of your project. Will later be used to configure the addon on a per project basis<br/>
|
>**Project Root Directory**: Path to the root of your project. Will later be used to configure the addon on a per project basis<br/>
|
||||||
|
|
||||||
@ -61,7 +61,7 @@ Press the login button. If the login was successful, the next step is..
|
|||||||
###### **Setup Animation Tools**
|
###### **Setup Animation Tools**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Playblast Root Directory**: Path to a directory in which playblasts will be saved to<br/>
|
>**Playblast Root Directory**: Path to a directory in which playblasts will be saved to<br/>
|
||||||
@ -71,19 +71,19 @@ Press the login button. If the login was successful, the next step is..
|
|||||||
|
|
||||||
###### **Setup Lookdev Tools**
|
###### **Setup Lookdev Tools**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Render Presets Directory**: Path to a directory in which you can save .py files that will be displayed in render preset dropdown. More info in: How to use render presets.<br/>
|
>**Render Presets Directory**: Path to a directory in which you can save .py files that will be displayed in render preset dropdown. More info in: How to use render presets.<br/>
|
||||||
|
|
||||||
###### **Setup Media Search Paths**
|
###### **Setup Media Search Paths**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Path List**: List of paths to top level directory. Only media that is a child (recursive) of one of these directories will be scanned for outdated media.<br/>
|
>**Path List**: List of paths to top level directory. Only media that is a child (recursive) of one of these directories will be scanned for outdated media.<br/>
|
||||||
|
|
||||||
###### **Setup Miscellaneous**
|
###### **Setup Miscellaneous**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Thumbnail Directory**: Directory where thumbnails will be saved before uploading them to kitsu. Cannot be edited.<br/>
|
>**Thumbnail Directory**: Directory where thumbnails will be saved before uploading them to kitsu. Cannot be edited.<br/>
|
||||||
**Sequence Editor Render Directory**: Directory where sequence editor renderings will be saved before uploading them to kitsu. Cannot be edited<br/>
|
**Sequence Editor Render Directory**: Directory where sequence editor renderings will be saved before uploading them to kitsu. Cannot be edited<br/>
|
||||||
@ -102,7 +102,7 @@ blender-kitsu sequence editor tools were constructed with the idea in mind to ha
|
|||||||
##### Metadata Strips
|
##### Metadata Strips
|
||||||
Metadata Strips are regular Movie Strips that can be linked to a shot in kitsu. It is a good idea to create a separate metadata strip in a separate channel that represents the shot. That gives you the freedom to assemble a shot out of multiple elements, like multiple storyboard pictures, and still have one metadata strip that contains the full shot range.
|
Metadata Strips are regular Movie Strips that can be linked to a shot in kitsu. It is a good idea to create a separate metadata strip in a separate channel that represents the shot. That gives you the freedom to assemble a shot out of multiple elements, like multiple storyboard pictures, and still have one metadata strip that contains the full shot range.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Good to know**: A metadata strip can have 3 states. It can be **initialized** but **not** linked yet. That means the movie strips knows I am a metadata strip but I don't have a relationship to a shot on Kitsu yet. It can be **linked**, which means the strip is already initialized and is linked to a sequence_id and shot_id on Kitsu. Only if a strip is linked you can exchange metadata, push thumbnails etc. The last state is **uninitialized** which basically means it's a regular movie strips and has nothing to do with kitsu.
|
>**Good to know**: A metadata strip can have 3 states. It can be **initialized** but **not** linked yet. That means the movie strips knows I am a metadata strip but I don't have a relationship to a shot on Kitsu yet. It can be **linked**, which means the strip is already initialized and is linked to a sequence_id and shot_id on Kitsu. Only if a strip is linked you can exchange metadata, push thumbnails etc. The last state is **uninitialized** which basically means it's a regular movie strips and has nothing to do with kitsu.
|
||||||
|
|
||||||
@ -112,7 +112,8 @@ This will create a blank movie strip. The metadata strip will be placed one chan
|
|||||||
|
|
||||||
###### Initialize a Shot
|
###### Initialize a Shot
|
||||||
1. Select a metadata strip and open the `Kitsu` tab in the sidebar of the sequence editor. You will find multiple ways on how to initialize your strip.
|
1. Select a metadata strip and open the `Kitsu` tab in the sidebar of the sequence editor. You will find multiple ways on how to initialize your strip.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
2. Case A: Shot does **already exist** on Kitsu
|
2. Case A: Shot does **already exist** on Kitsu
|
||||||
|
|
||||||
@ -120,7 +121,7 @@ This will create a blank movie strip. The metadata strip will be placed one chan
|
|||||||
|
|
||||||
2.2 Alternatively you can also link a shot by pasting the URL. (e.G: https://kitsu.yourdomain.com/productions/fc77c0b9-bb76-41c3-b843-c9b156f9b3ec/shots/e7e6be02-5574-4764-9077-965d57b1ec12) <br/>
|
2.2 Alternatively you can also link a shot by pasting the URL. (e.G: https://kitsu.yourdomain.com/productions/fc77c0b9-bb76-41c3-b843-c9b156f9b3ec/shots/e7e6be02-5574-4764-9077-965d57b1ec12) <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
3. Case B: Shot **does not exist** on Kitsu yet
|
3. Case B: Shot **does not exist** on Kitsu yet
|
||||||
|
|
||||||
@ -133,12 +134,12 @@ This will create a blank movie strip. The metadata strip will be placed one chan
|
|||||||
3.4 Execute the `Submit New Shot` operator in the `Push` Panel (Will warn you if the shot already exists on Kitsu). This operator can optionally populate each 'Shot' with a task set to the project's default task status.
|
3.4 Execute the `Submit New Shot` operator in the `Push` Panel (Will warn you if the shot already exists on Kitsu). This operator can optionally populate each 'Shot' with a task set to the project's default task status.
|
||||||
|
|
||||||
>**Note**: Most of the operator are selection sensitive. So you can do these operations for a batch of sequence strips. If you have nothing selected it will usually try to operate on all strips in the sequence editor. <br/>
|
>**Note**: Most of the operator are selection sensitive. So you can do these operations for a batch of sequence strips. If you have nothing selected it will usually try to operate on all strips in the sequence editor. <br/>
|
||||||
|
|
||||||
|
|
||||||
##### Metadata
|
##### Metadata
|
||||||
If you select a single linked strip you will see a `Metadata` panel that shows you the information that is related to the sequence and shot the strip is linking to.
|
If you select a single linked strip you will see a `Metadata` panel that shows you the information that is related to the sequence and shot the strip is linking to.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The frame range will be updated by using the Blender editing tools on the strip. (trimming, sliding, etc.). <br/>
|
The frame range will be updated by using the Blender editing tools on the strip. (trimming, sliding, etc.). <br/>
|
||||||
If you execute the `Initialize Shot Start Frame` operator (refresh icon) the current in point of the strip will be remapped so the shot starts at 101 in the current editing state. <br/>
|
If you execute the `Initialize Shot Start Frame` operator (refresh icon) the current in point of the strip will be remapped so the shot starts at 101 in the current editing state. <br/>
|
||||||
@ -146,7 +147,7 @@ You can reassign the shot to another sequence by executing the `Link Sequence` O
|
|||||||
|
|
||||||
If you linked in a sequence that has no `["data"]["color"]` attribute on Kitsu yet the gpu overlay line will be white. In order to add a new sequence color execute the `Add Sequence Color` operator. <br/>
|
If you linked in a sequence that has no `["data"]["color"]` attribute on Kitsu yet the gpu overlay line will be white. In order to add a new sequence color execute the `Add Sequence Color` operator. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
All this information and more can be `pushed` to kitsu which bring us to the next panel. <br/>
|
All this information and more can be `pushed` to kitsu which bring us to the next panel. <br/>
|
||||||
@ -155,7 +156,7 @@ All this information and more can be `pushed` to kitsu which bring us to the nex
|
|||||||
|
|
||||||
In the `Push` panel you will find all the operators that push data to Kitsu. <br/>
|
In the `Push` panel you will find all the operators that push data to Kitsu. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Metadata**: Pushes metadata of shot: sequence, shot name, frame range, sequence_color
|
>**Metadata**: Pushes metadata of shot: sequence, shot name, frame range, sequence_color
|
||||||
>>**Note**: Global edit frame range will be saved in `"frame_in"` `"frame_out"` kitsu shot attribute <br/>
|
>>**Note**: Global edit frame range will be saved in `"frame_in"` `"frame_out"` kitsu shot attribute <br/>
|
||||||
@ -168,42 +169,42 @@ If you select multiple metadata strips it will always use the middle frame to cr
|
|||||||
##### Pull
|
##### Pull
|
||||||
In the `Pull` panel you will find all the operators that pull data from Kitsu to a metadata strip. <br/>
|
In the `Pull` panel you will find all the operators that pull data from Kitsu to a metadata strip. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Metadata**: Pulls metadata of shot: sequence, shot name, shot description and updates the strip name to match the shot name.
|
>**Metadata**: Pulls metadata of shot: sequence, shot name, shot description and updates the strip name to match the shot name.
|
||||||
>>**Note**: Frame ranges will **never** be updated when pulling data from Kitsu. They belong to the edit and will only be pushed to Kitsu.<br/>
|
>>**Note**: Frame ranges will **never** be updated when pulling data from Kitsu. They belong to the edit and will only be pushed to Kitsu.<br/>
|
||||||
|
|
||||||
If you have not sequence selected the `Pull Entire Edit` Operator will appear in the `Pull` panel.<br/>
|
If you have not sequence selected the `Pull Entire Edit` Operator will appear in the `Pull` panel.<br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
After you selected the channel it will go through all shots on Kitsu, create a metadata strip which will be linked to the respective shot and pulls all metadata. <br/>
|
After you selected the channel it will go through all shots on Kitsu, create a metadata strip which will be linked to the respective shot and pulls all metadata. <br/>
|
||||||
It will use te `frame_in` and `frame_out` attribute on Kitsu to determine the in and out points in the edit. So make sure these are up to date and don't overlap. <br/>
|
It will use te `frame_in` and `frame_out` attribute on Kitsu to determine the in and out points in the edit. So make sure these are up to date and don't overlap. <br/>
|
||||||
|
|
||||||
As a result a bigger edit with nice sequence_colors can look pretty cool:
|
As a result a bigger edit with nice sequence_colors can look pretty cool:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
##### Multi Edit
|
##### Multi Edit
|
||||||
|
|
||||||
The `Multi Edit` panel only appears when you select multiple metadata strips that are all `initialized` but not `linked` yet. <br/>
|
The `Multi Edit` panel only appears when you select multiple metadata strips that are all `initialized` but not `linked` yet. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
It is meant to be way to quickly setup lots of shots if they don't exist on Kitsu yet. You specify the sequence all shots should belong to and adjust the `Shot Counter Start` value. In the preview property you can see how all shots will be named when you execute the `Multi Edit Strip` operator. <br/>
|
It is meant to be way to quickly setup lots of shots if they don't exist on Kitsu yet. You specify the sequence all shots should belong to and adjust the `Shot Counter Start` value. In the preview property you can see how all shots will be named when you execute the `Multi Edit Strip` operator. <br/>
|
||||||
|
|
||||||
##### Shot as Image Sequence
|
##### Shot as Image Sequence
|
||||||
The `Shot as Image Sequence` Operator will replace a playblast from your Playblast Root directory with an image sequence located in the Frames Root directory. The Shots Directory and the Frames Directory should have matching folder structures. Typically the format is `/{sequence_name}/{shot_name}/{shot_name}-{shot_task}/`
|
The `Shot as Image Sequence` Operator will replace a playblast from your Playblast Root directory with an image sequence located in the Frames Root directory. The Shots Directory and the Frames Directory should have matching folder structures. Typically the format is `/{sequence_name}/{shot_name}/{shot_name}-{shot_task}/`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Use this operator to replace playblasts with image sequences that have been approved via the [Render Review Add-On](/addons/render_review) Image Sequences can be loaded as either `EXR` or `JPG` sequences.
|
Use this operator to replace playblasts with image sequences that have been approved via the [Render Review Add-On](/addons/render_review) Image Sequences can be loaded as either `EXR` or `JPG` sequences.
|
||||||
|
|
||||||
###### Advanced Settings
|
###### Advanced Settings
|
||||||
If you check the `Advanced` checkbox next to the counter value, you have access to advance settings to customize the operator even more.
|
If you check the `Advanced` checkbox next to the counter value, you have access to advance settings to customize the operator even more.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
You can adjust the number of counter digits, the increment size and also the `Pattern` it will use to generate the shot name. <br/>
|
You can adjust the number of counter digits, the increment size and also the `Pattern` it will use to generate the shot name. <br/>
|
||||||
>**Pattern**: supports 3 wildcards. `<Sequence>`, `<Counter>`, `<Project>` that can be used multiple times in any order. <br/>
|
>**Pattern**: supports 3 wildcards. `<Sequence>`, `<Counter>`, `<Project>` that can be used multiple times in any order. <br/>
|
||||||
@ -213,15 +214,15 @@ You can adjust the number of counter digits, the increment size and also the `Pa
|
|||||||
##### General Sequence Editor Tools
|
##### General Sequence Editor Tools
|
||||||
In the general tab you can find some tools that don't directly relate to Kitsu but are useful for editing.
|
In the general tab you can find some tools that don't directly relate to Kitsu but are useful for editing.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
`Scan for outdated media` will scan the selected / all sequence strips for their source media file. It searches for a later version in the same directory as the source media. If the current media file is outdated it will highlight that strip with a red line in the sequence editor:
|
`Scan for outdated media` will scan the selected / all sequence strips for their source media file. It searches for a later version in the same directory as the source media. If the current media file is outdated it will highlight that strip with a red line in the sequence editor:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
To update the outdated strips you can select them individually and by clicking the `Arrow Up` or `Arrow Down` you cycle through the available versions on disk. You will be prompted with an information if you reached the latest or oldest version.
|
To update the outdated strips you can select them individually and by clicking the `Arrow Up` or `Arrow Down` you cycle through the available versions on disk. You will be prompted with an information if you reached the latest or oldest version.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Note**: The operator searches for a version string e.G `v001` and checks files that are named the same but have a different version. <br/>
|
>**Note**: The operator searches for a version string e.G `v001` and checks files that are named the same but have a different version. <br/>
|
||||||
@ -232,7 +233,7 @@ blender-kitsu context features were constructed with the idea in mind to create
|
|||||||
|
|
||||||
To create 'context' you can find the `Context Browser` in the `Kitsu` panel in the sidebar of the 3D Viewport. <br/>
|
To create 'context' you can find the `Context Browser` in the `Kitsu` panel in the sidebar of the 3D Viewport. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
By selecting the different drop down menus you can browse through the Kitsu file structure and set e.G the active sequence, active shot and task type you want to work on. <br/>
|
By selecting the different drop down menus you can browse through the Kitsu file structure and set e.G the active sequence, active shot and task type you want to work on. <br/>
|
||||||
|
|
||||||
@ -245,7 +246,7 @@ Depending on which `Task Type` you select different tool sets will be available.
|
|||||||
The animation tools will show up when you selected a `Task Type` with the name `Animation`. <br/>
|
The animation tools will show up when you selected a `Task Type` with the name `Animation`. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Create Playblast**: Will create a openGL viewport render of the viewport from which the operator was executed and uploads it to Kitsu. The `+` button increments the version of the playblast. If you would override an older version you will see a warning before the filepath. The `directory` button will open a file browser in the playblast directory. The playblast will be uploaded to the `Animation` Task Type of the active shot that was set in the `Context Browser`. The web browser will be opened after the playblast and should point to the respective shot on Kitsu. <br/>
|
>**Create Playblast**: Will create a openGL viewport render of the viewport from which the operator was executed and uploads it to Kitsu. The `+` button increments the version of the playblast. If you would override an older version you will see a warning before the filepath. The `directory` button will open a file browser in the playblast directory. The playblast will be uploaded to the `Animation` Task Type of the active shot that was set in the `Context Browser`. The web browser will be opened after the playblast and should point to the respective shot on Kitsu. <br/>
|
||||||
**Push Frame Start**: Will Push the current scene's frame start to Kitsu. This will set the `['data']['3d_start]` attribute of the Kitsu shot.
|
**Push Frame Start**: Will Push the current scene's frame start to Kitsu. This will set the `['data']['3d_start]` attribute of the Kitsu shot.
|
||||||
@ -257,7 +258,7 @@ The animation tools will show up when you selected a `Task Type` with the name `
|
|||||||
##### Lookdev Tools
|
##### Lookdev Tools
|
||||||
The lookdev tools will show up when you selected a `Task Type` with the name `Lighting` | `Rendering` | `Compositing`. <br/>
|
The lookdev tools will show up when you selected a `Task Type` with the name `Lighting` | `Rendering` | `Compositing`. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>**Apply Render Preset**: Consists of a dropdown menu that displays all `.py` files which are present in the `Render Presets Directory` (defined in the add-on preferences). Select the `.py` file you want to execute. When you hit the `Play` button the `main()` function of the python file will be executed. Very useful to quickly switch between different render settings.
|
>**Apply Render Preset**: Consists of a dropdown menu that displays all `.py` files which are present in the `Render Presets Directory` (defined in the add-on preferences). Select the `.py` file you want to execute. When you hit the `Play` button the `main()` function of the python file will be executed. Very useful to quickly switch between different render settings.
|
||||||
|
|
||||||
@ -266,7 +267,7 @@ The lookdev tools will show up when you selected a `Task Type` with the name `Li
|
|||||||
blender-kitsu has different checks that are performed during file load or during editing. If it detects an error that prevents other operators to run it will display an error in the ui. <br/>
|
blender-kitsu has different checks that are performed during file load or during editing. If it detects an error that prevents other operators to run it will display an error in the ui. <br/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Shot Builder
|
## Shot Builder
|
||||||
Shot Builder is a Feature of the Blender Kitsu Add-on To automatically build shot files, using the data from Kitsu server and the file structures defined on the [Blender Studio](https://studio.blender.org/pipeline/naming-conventions/svn-folder-structure) website.
|
Shot Builder is a Feature of the Blender Kitsu Add-on To automatically build shot files, using the data from Kitsu server and the file structures defined on the [Blender Studio](https://studio.blender.org/pipeline/naming-conventions/svn-folder-structure) website.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user