From 8a949c38e9a1d746590c257fe5762ce9dff93633 Mon Sep 17 00:00:00 2001 From: Mykyta Petrenko Date: Sun, 19 May 2024 19:02:32 +0300 Subject: [PATCH] 1.1.1.0 update --- docs/images/align_minor_meshes.png | Bin 0 -> 17095 bytes docs/images/transfer_basis_coordinates.png | Bin 0 -> 4971 bytes docs/transfer_shape_deprecated.md | 4 +-- docs/workflow_1_1.md | 40 +++++++++++---------- 4 files changed, 24 insertions(+), 20 deletions(-) create mode 100644 docs/images/align_minor_meshes.png create mode 100644 docs/images/transfer_basis_coordinates.png diff --git a/docs/images/align_minor_meshes.png b/docs/images/align_minor_meshes.png new file mode 100644 index 0000000000000000000000000000000000000000..0fc073a4a82dbc8184a95a17f8850d9641b3895e GIT binary patch literal 17095 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 P6c}pvw3I3pEJFT2o3J|E literal 0 HcmV?d00001 diff --git a/docs/images/transfer_basis_coordinates.png b/docs/images/transfer_basis_coordinates.png new file mode 100644 index 0000000000000000000000000000000000000000..df6eb0891851d2e060d9d08f536afc6e8e81e062 GIT binary patch literal 4971 zcmV-x6O`RtUS9nC{O0E7<>lq3rl!cq z$T>MV%*@Q!*Vpm!@isO#+1c52baeFe^e-+9>_;NWa*Y?_*y;^N{nGc(Z8&{$YludlEE{{EJhmaMF-;o;%I!NEE@I$ByE-b>Reo0e0+SauC8uwZbL&uwY9YX0054T zj+d90Qc_Y+Pfw4JkGZ+I+}zxNfPiLZW?5NTF)=Z;w6xaN)@f;Jv$M0$&(DR0h3V<( zYiny_Vq(9)zb-B=p`oG6%gb$TZDV6&H8nNE!^5JYqCh}El$4a1n3#5Uc2!kXoSdB9 z-QCK{%4B3@o12@qwzmKO|IN+Kjg5`Gyu36tH1hKD+uPgd=;+eY(!RdFVPRpJnVG`E z!d6yREiEm#x3?@TEO~i(a&mG-MMWzsD~XATySuyE+S+AhWl&I1rKP37z`#vSOprD|~$H#+%gQ%#eh=_<_U|@%bhn^lD zogE#T8X9gcF8=@k&kqlRf`Xo&o{Ni%XJ==nB_*mVDk>@}DJdx>B_$ytAtNIrCMG5) zCnqQ!)IVzQ|ArNhv){H~)+py)0L6BUsN{u9vqfRIt4WB$~B%f&% zs3VWsWbpKnBsRVlb_*kAcsfvG*A9O+9$^Y01)xac?uCFf41qhM=0EL6b^DtHMsi-MZ@>ci$WTaIj zUlYkw7JXY_fE1OnOP9inIRkb}oL69%0*-Z_wkU$cTBVIp8+MCWr^!&M#U{yzH$Y5i zXfr@_ZC_N4eX5Dvopy6X6RL+5%8(&sey@IlZ~$xw185tE%9$- z1^3d0n5`2hAO|;HUQjmzISppsuhz+NJ*>Q_HPZ2<^L>_qzvvR!?YKwI`6N1BiClP| zwk2w&MolfLL@L5FM~ycrtpuJ;Xdnw`9o#=UXA&sUY1GuHNw>fXJ(5N%Ia(t(@(uI- z7cBq>6D`ARd549V%qfqhuj>*Plw4EDT{rBIgla{@Pr;6RhdZ9clb0N>T7`9&oE-&k zJ(BCaimQM43eVOkNH)gj{(CgRgg0rY&qh>c*egJ4W^Wh~x^kT%O|?Q(qaaZdE98ls zo)X|ul+bT4y`8VL2Lo2O|8U71YlYg0h`%_lRK{T&a6K_@`77lXvIn7UN8?}if36K# znBW1s?_8I&_W^P$mLa9)jifyH>_ohb7_cu2lgB2hAjqx9PMgGl{!8)Fk|yz^#~oj# zXqjY39i_oS_6PlUXi-kQ;oob}hcLTD)~T^dR~r91ak|QJmpADsxzd7}K_^bnn4WG{ zr{ZI%bic+4b|caXDn5XWVittfWH$Uf?RbcSWy7I2+#cyBP)Tw+35QssBDF?Og(tuw zM#CQ#levX%7-xW4=llO`c9)!Tmf=%2TUPa_+XPTYlAo*0Im=FLQyStv2qqLN%3j{c=e>@XsisdZs-D*FfuoGmPSUwn-5H=Idvb^W-HM;9uf;@< z*@Rjo4l@@g-ZQ=@ar}TMQRUyaa=ZLjqHAn(#PhNJh3xRRdZtaFOfl0xB>iF0+?E*m zh3Fj(RpMyqalu9d+b-16w+^>>VfT3IuL~vA8YPPlQJuq}pE^|@S8?Z^iv5jQCUiY% zuAQf!b!=)~gu~p#sKZaImu@K9|DS|}&34J_;J%W(S39O^Rgm3YQxS`o_5PxNSonlK znY45B6JL4mD7s?#6|nHwSheqoC-)s&za>|JTCEBF8B?Aw+OGXh#s0>0I5yfM1fJC8 zGE}$7D|x!0k^QV;Oogh_q2yh+oU#2;K0!Q87L^*SFPq>(V`e0oo{JG#)Z#aO*IhGP z-e`pL5euQ9T2bGyR`Hx+4po0pU1h1UuU!(-aA5zb-WB^DbFsxP__Mt`+l4B-#Iz!h z37EgPDm^rM8@8u~6M*gi9DJq|(`ij%qaJOnvT1@|9Nor3XqjnFrblBh28%(t}oTu^-M1-PSzwBK`_bhoNcVB(_V z%FnM(Ho7n4Pj!l{%CIc=*AVGlvA;1HO9lRJlT| zX&tuT&|(u_#hx<}yrLPIa|pU%k!(g%u!p30^Ci{wVy^ydY*Z_++8jK8C88X#H_{+Y z35>op7Bzin3GX5^Bz|GZPNzcB$|g{3&1MmT;c_3ojoD0uvg^qDCn8i}E=d*;+| zxKCeTgO+S3(eN|sho$}KHiJ0I`|Pr?diP~!>1Pk?DhbJRM**Jc^Y>GR1uHa46=3y1txOXb{KPD*KiU)yF_Vh}4o6Xt=H)m|cvx4@h&jSAHaQ_E8`0^i- z+6KTL>1Z1rE!e*d#y0lvu*Og0S`aqn`Q>n~Om)IH;S>R8<6&t7a*%JPLy1Id ziZ!{%7s1*EBQBMDZ3@c#ONm>*cg)Q_o_62fn||578BzBOu|)MoU4*aNhNAtGR*cp= znM^K0k>?L5Y);r*V1R|j{<~A_#wkL~MlC`Ql7fY6?(K)tAa$a4YRH|8~8mp z6%n3MNZN}vFGj=K1~xij&#c@pR5`~Sg7w*Fdxp~2Y*1ba{$kRpRJXQ({bMRrT^PvNu{}cR+Lvv-5`4#$-K?#t^w6kDcuU~s zaTb+|aZM|#SbCW{+|ZaX-AcBVjis=G9527fbymt^JA@K7B*a9 zV$HH7YS4Xqz3WT-93NqrR9HWA_q86Ow26cB52=&`5k)kYnxtTJsbE-NdhV(op|r?^DqacxVTKz~!%L*Y>aC>1Qb;rq zf4ts(IVZ-NNdgmV{jBG@nXFD*nJG&#!Mn?O= zIXe}ju&Fz}1H-uCHVL!}oeDEignP>!1LpJyrP)YZM+tsmf(T%PC5@v%$yPk;09%@y zE`zOjAAheh=_p%XEWMbQL~_GsbGs65q`V4x*rVu`@?~5zHqMQ+iEJ!*Hn-z7ZQO9% z+j*N0kRZ~d?XdKE)(w+hp>#=S34USzzo{oC|KsR^kpnRm-y;hW5y$|ur7H^>=(X@& zg9-E2K(B)D;->Bcy@>wN5T+n$kYVat4d^oXqnMnIt#(X-r0mAoj=5{VR>EI-wzor= zf}kNxLDCSWAn9Y6K{Lnn^J@5}k6}(EIXQl6KIMug_{D5#g+cuLMsY}MU~0D!+&+Ri zSeiytLuf^2XYUv9m#r0P`HY4xV3lrh6 zpHx}yif82i6!Q#XUW+|h?X?9EwzO^4>K3QuDShy{#HtEsNvu)_m z6jxQhHdt=KWD2F=YcTsL90iRQnkUSTpC^nkgy=XtJI0!gut^Mni??KR5*HERF9;OJ zj)GRa1^44ICbyG7BQem>rLA7GvIL<=N|WeJinZ(Aa#kG1HD z(7?h>um@`>AhAC%{|_{TDM%W^6eJBwO!8O(jiU>D{f(GF#_lmWgY9p`+FQd3BL`|R pd{gbitd7k=_Q9WkYY0=2^j~~N0}eLh{c8XK002ovPDHLkV1m62l_mfH literal 0 HcmV?d00001 diff --git a/docs/transfer_shape_deprecated.md b/docs/transfer_shape_deprecated.md index 91d3568..c4aea32 100644 --- a/docs/transfer_shape_deprecated.md +++ b/docs/transfer_shape_deprecated.md @@ -1,8 +1,8 @@ -# Transfer Shape to Minor Meshes (Outdated) +# Transfer Shape to Minor Meshes (Deprecated) ```eval_rst .. important:: - This is how to transfer changes to minor meshes in versions 1.1.**0**.X. In 1.1.**1**.X the process was changed + This is how to transfer changes to minor meshes in versions 1.1.0.X. In 1.1.1.X the process was changed ``` #### How to transfer defromation from one edit object to another (eyeshels, eyelashes etc.) diff --git a/docs/workflow_1_1.md b/docs/workflow_1_1.md index 812ad56..04d7697 100644 --- a/docs/workflow_1_1.md +++ b/docs/workflow_1_1.md @@ -62,7 +62,7 @@ Once the FBX files are imported, we can proceed to initialize auxiliary and edit There are two parameters available: - **Weld Distance:** Determines the distance (centimeters) at which the vertices of the meshes will be welded. The Weld Distance should be sufficient to weld all points at seams intended to be smooth, but at the same time, too large a Weld Distance value might cause other points to merge, making it impossible to apply the Surface Deform modifier, which is vital for subsequent processing. After initialization, you can preliminarily check the meshes for the most common issues that may arise during welding by clicking on the "Validate Edges" and "Validate Faces" buttons, which we will discuss a bit later in this section. -- **Keep ShapeKeys:** By default, this is turned on. You can turn it off to avoid storing shape key data for edit objects and to keep the blend file size manageable. However, in this case, you will not be able to edit corrective shape keys. Remember that the Metahuman LOD0 uses many corrective shape keys to achieve a more realistic appearance, and sometimes it's necessary to adjust some of these shape keys as well as the base mesh. +- **Keep Shape Keys for Edit Objects:** By default, this is turned on. You can turn it off to avoid storing shape key data for edit objects and to keep the blend file size manageable. However, in this case, you will not be able to edit corrective shape keys. Remember that the Metahuman LOD0 uses many corrective shape keys to achieve a more realistic appearance, and sometimes it's necessary to adjust some of these shape keys as well as the base mesh.

@@ -109,31 +109,35 @@ We can recommend the following course of action: Next, in Sculpt Mode (enable x symmetry if you need), you can work on the skin model. I prefer to start with the Grab and Elastic Deform brushes at the initial stage. I recommend starting with sculpting because only then can you properly use symmetry. In Edit Mode, symmetry does not work as expected due to the fact that Metahuman has asymmetry. - By combining Edit Mode and Sculpt Mode, you can add more details. -Then you need to transfer changes from skin and teeth to the other objects. +```eval_rst +.. note:: + Editing the mesh with a large number of shape keys may be laggy when using some sculpt brushes. You can create a "light" duplicate of the problem mesh using the "Create Light Duplicate" feature from MetaReForge.Extras. After editing, transfer the deformations back to the original "FINAL" mesh similar to 4.3. Editing in third party application * +``` +[* 4.3. Editing in third party application](#43-editing-in-third-party-application) #### 4.2. How to transfer defromation from one edit object to another (eyeshels, eyelashes etc.) -To transfer deformations, you need -1. to select the necessary item from the list (_**1**_, see figure) to which you want to transfer the deformations. -2. Next, you need to set up the transfer. You can specify the basis and final objects manually or, as shown in the figure: enter the edit_id of the mesh from which the deformations will be transferred (_**2**_, see figure) and press the arrow button (_**3**_, see figure). If everything is specified correctly, then the basis and final objects should be determined automatically. -3. By default, the surface deform modifier will be used to transfer changes (in short, the vertices of the mesh will be attached to the closest polygons of the source mesh. [Learn more](https://docs.blender.org/manual/en/latest/modeling/modifiers/deform/surface_deform.html)). In some cases, it may not work as well as desired, for example, it may warp or significantly stretch the shape of the original objects, so an option with enabling the Laplacian deform (_**4**_, see figure) has been added (in brief, this modifier keeps the anchor vertices in fixed positions and calculates the optimal locations of all the remaining vertices to preserve the original geometric details. [Learn more](https://docs.blender.org/manual/en/latest/modeling/modifiers/deform/laplacian_deform.html)). In this case, points that are closer than "Lapl. Thresh." (_**5**_, see figure) to the mesh from which the transformations are transferred will be transferred using surface deform (attached to the surface), and points that are further will be reconstructed using Laplacian deform. **For example**, when transferring deformations from the main body mesh to the eyelashes, the roots of the eyelashes will be attached to the nearest polygons on the eyelids, while the rest of the eyelash will not be directly attached to the body but will try to preserve the original shape of the eyelash as much as possible taking into account the new location of the eyelash root. -4. Click transfer (_**6**_, see figure) -5. Revise the changes after the transfer and fix minor problems. - - + +Once the main meshes (skin, eyeballs, teeth) have been edited, you can proceed to edit the auxiliary meshes. MetaReForge offers a feature called "Align Minor Meshes" to somewhat simplify this process. + +

- +

-Despite the lengthy description, the process is simpler than it seems. **The skin, teeth, and eyes are edited manually based on your artistic needs.** The deformation is transferred to the other objects. For simplicity, we have compiled the following recommendations to help you quickly get oriented: - -1. **Saliva** - Transfer the deformation from "teeth" with disabled Laplacian deform. -2. **Eyeshell** - Transfer the deformation from "skin" with Laplacian Deform enabled (thresh >= 0.01). -3. **Eyelashes** - Transfer the deformation from "skin" with Laplacian Deform enabled (thresh >= 0.1). -4. **Eye Edge, Cartilage** - Transfer the deformation from "skin" with Laplacian Deform disabled. +Two configuration files are presented. Usually, the default one works well. If one or more eyelashes stray far from the main meshes, try using default_eyelashes_fix. Using these configuration files, changes identified with the skin will be transferred to objects with the next edit IDs: "eyeshell", "eyeEdge", "eyelashes", and "cartilage".The changes to "teeth" will be transferred to "saliva". Optionally, you can create custom configuration files. #### 4.3. Editing in third party application: -If you wish to modify any part of the body in an external application, you will need to export the necessary Final Mesh and then, after editing, import it back into Blender and assign it in the 'Final' field for the corresponding body part. It's important to ensure that the vertex order remains unchanged. +If you wish to modify any part of the body in an external application, you will need to export the necessary Final Mesh and then, after editing, import it back into Blender. +Then: +- Apply transforms (ofter newly imported mesh has nonzero transforms) +- Use "Transfer Basis Coordinates" operator from MetaReForge.Extras. Select the newly imported mesh, then select original "FINAL" mesh created by MetaReForge and click the button. The operator updates only vertex coordinates of the basis shape keepeng the remaining information (like bone weights, shape key deltas unchanged) + + +

+ +

+ ### 5. Editing the Armature After achieving the desired mesh shape, it's necessary to adjust the skeleton to these changes. The Metahuman skeleton contains about a thousand bones, and editing it manually is tedious and time-consuming. Therefore, our addon includes tools to simplify this routine by transferring the deformation from the final mesh to the skeleton.