diff --git a/README.md b/README.md index 9ec88dd..0f8589b 100644 --- a/README.md +++ b/README.md @@ -15,16 +15,20 @@ Video of the previous version : https://vimeo.com/241970235 Installation
  • - Contents + Create a picker from scratch
  • - Location + How to use an existing picker +
  • +
  • + Precisions
  • ## Installation +### Developper installation For external user, you can clone the repository using: ```sh git clone https://git.autourdeminuit.com/autour_de_minuit/rig_picker.git @@ -39,10 +43,192 @@ For Internal user: ```sh git clone ssh://git@git.autourdeminuit.com:222/autour_de_minuit/rig_picker.git ``` +### User installation - -## Contents + Addon available on blender 4.X , you can process this way to add this on your blender +
    + +![doc_picker_01.png](attachments/doc_picker_01.png) + +

    + +

    + +

    + + +## Create a picker from scratch + +#### 1. Canvas Creation +
    +1. Once the addon is installed , you'll find the "rigging" tab on the right of your 3D viewport, on it to start your picker first click on the "+" on top here + +
    + + +

    + +

    + +
    + + It will create a plane inside a "**controller**" collection, this plane will be the background of your picker. The collection is important, you can rename it **but don't delete it.** You can also rename the plane at your liking. + +
    + + If you click on this new plane, on the tab you will find (cf menu picture) : + - The name of the armature you want to pick + - The name of the canvas of your picker + - Symmetry + - The path needed to save your futur picker + - The save button + +
    + + +

    + +

    + +

    +#### 2. Picker Controller Creation +
    +1. Next, select the controllers of your armature, and click on the button "Create Shape". It will create empty meshes with the same names as your controllers, it should already be connected to the good controller of your armature, but for more details on that read the rest of this documentation. + +
    + +

    + +

    + +

    + +2. Create meshes inside the object of the picker's controller freshly generated +
    + +

    + +

    + +
    + +3. On those shape, you can add a material with this button in the "rigging" tab, you can add one, delete one if there already is a material here or pick from the scene a material on another element. (it works with a multiple selection) + +
    + +

    + +

    + +
    + +You can also create some shapes display to represent the body of your character +
    + +

    + +

    + +
    + +#### 3. Controller's Setup + +
    + +- Back on the "rigging" tab, you will find buttons : + - A create shape button + - A mirror shape button + - An auto Bone assign button + - A "Name from bones" button + +
    + +- The last part is where you define to what bone the shape is connected. If you used the button "create shape" the good bone should already be picked, but if you created your own mesh or if you want the mesh to pick another bone instead, you need to pick it from this selection window. + +
    + + It is also where you decide if this shape is supposed to be : + - A bone : meaning selectable on the picker + - A display : only there for a visual purpose (like representing the character's shape) + - An Operator : to be connected to a script. + +
    + +

    + +

    + +
    + +#### 4. Final Touch + +
    + +- Place all of your meshes on top of the canvas, be careful as it works as photoshops layers, meaning, you need to put the mesh up on the Z axis if you want your shape on top on the 2D picker. The mesh with the vertex that is the higher up on the Z axis will be the top one on the picker display. + +
    + +

    + +

    + +
    + +- When you are all done, save the picker then click on the armature , one the "Sources" window a button to add your picker. Select the path and the file. + +
    + + +

    + +

    + +
    + + +## How to use an existing picker + +- Open a "picker" view, select your armature in pose mode and in the "rigging" tab click on the small "+" sign. That will allow you to choose the picker file that you want. You can "reload" the picker if it doesn't show (or click on the "1" on the top right which center the page of the pickers in the view, in case you have more han one) +
    + +

    + +

    + +
    + +- You can have more than one page for your picker if you need to detail things a bit more. For exemple in here we have a second canvas (in its own collection), that we'll save with a different name and load it as well. + +
    + +

    + +

    + +
    + +You can select now your controller directly on the picker. + +
    + + +## Precisions +
    +- In this menu, you will find some features that have actions on your picker's controllers + +
    + +

    + +

    +
    + +- If you double click on a controller, it will HIDE the whole layer of this bone + +
    + +

    + +

    - -## Location diff --git a/attachments/Doc_picker_01.gif b/attachments/Doc_picker_01.gif new file mode 100644 index 0000000..619d509 Binary files /dev/null and b/attachments/Doc_picker_01.gif differ diff --git a/attachments/Doc_picker_02.gif b/attachments/Doc_picker_02.gif new file mode 100644 index 0000000..11ed6a5 Binary files /dev/null and b/attachments/Doc_picker_02.gif differ diff --git a/attachments/Doc_picker_03.gif b/attachments/Doc_picker_03.gif new file mode 100644 index 0000000..aadb481 Binary files /dev/null and b/attachments/Doc_picker_03.gif differ diff --git a/attachments/Doc_picker_04.gif b/attachments/Doc_picker_04.gif new file mode 100644 index 0000000..a0eedd0 Binary files /dev/null and b/attachments/Doc_picker_04.gif differ diff --git a/attachments/doc_picker_01.png b/attachments/doc_picker_01.png new file mode 100644 index 0000000..c7ea2ba Binary files /dev/null and b/attachments/doc_picker_01.png differ diff --git a/attachments/doc_picker_02.png b/attachments/doc_picker_02.png new file mode 100644 index 0000000..84e2095 Binary files /dev/null and b/attachments/doc_picker_02.png differ diff --git a/attachments/doc_picker_03.png b/attachments/doc_picker_03.png new file mode 100644 index 0000000..f2d3175 Binary files /dev/null and b/attachments/doc_picker_03.png differ diff --git a/attachments/doc_picker_04.png b/attachments/doc_picker_04.png new file mode 100644 index 0000000..611f080 Binary files /dev/null and b/attachments/doc_picker_04.png differ diff --git a/attachments/doc_picker_05.png b/attachments/doc_picker_05.png new file mode 100644 index 0000000..1155e62 Binary files /dev/null and b/attachments/doc_picker_05.png differ diff --git a/attachments/doc_picker_06.png b/attachments/doc_picker_06.png new file mode 100644 index 0000000..0fbc767 Binary files /dev/null and b/attachments/doc_picker_06.png differ diff --git a/attachments/doc_picker_07.png b/attachments/doc_picker_07.png new file mode 100644 index 0000000..bd85906 Binary files /dev/null and b/attachments/doc_picker_07.png differ diff --git a/attachments/doc_picker_08.png b/attachments/doc_picker_08.png new file mode 100644 index 0000000..83129ce Binary files /dev/null and b/attachments/doc_picker_08.png differ diff --git a/attachments/doc_picker_09.png b/attachments/doc_picker_09.png new file mode 100644 index 0000000..94c590a Binary files /dev/null and b/attachments/doc_picker_09.png differ diff --git a/attachments/doc_picker_10.png b/attachments/doc_picker_10.png new file mode 100644 index 0000000..f44150e Binary files /dev/null and b/attachments/doc_picker_10.png differ diff --git a/attachments/doc_picker_11.png b/attachments/doc_picker_11.png new file mode 100644 index 0000000..03b0f38 Binary files /dev/null and b/attachments/doc_picker_11.png differ diff --git a/attachments/doc_picker_12.png b/attachments/doc_picker_12.png new file mode 100644 index 0000000..b46a7a8 Binary files /dev/null and b/attachments/doc_picker_12.png differ diff --git a/attachments/doc_picker_13.png b/attachments/doc_picker_13.png new file mode 100644 index 0000000..47aebfb Binary files /dev/null and b/attachments/doc_picker_13.png differ diff --git a/attachments/doc_picker_14.png b/attachments/doc_picker_14.png new file mode 100644 index 0000000..ed74d0e Binary files /dev/null and b/attachments/doc_picker_14.png differ diff --git a/attachments/doc_picker_15.png b/attachments/doc_picker_15.png new file mode 100644 index 0000000..4fcb729 Binary files /dev/null and b/attachments/doc_picker_15.png differ