From ebec9fd3f774eab96af07c1d5f017f031e964e40 Mon Sep 17 00:00:00 2001
From: 0b5vr <0b5vr@0b5vr.com>
Date: Mon, 4 Dec 2023 15:51:02 +0900
Subject: [PATCH 01/13] Revert "Revert "feature: VRMAnimation""
This reverts commit 2f09d712311f87281c183a44460f9db0a035d7e3.
---
packages/three-vrm-animation/README.md | 9 +
.../examples/.editorconfig | 2 +
.../three-vrm-animation/examples/.eslintrc | 11 +
.../three-vrm-animation/examples/dnd.html | 281 ++++++++++++++++++
.../three-vrm-animation/examples/index.html | 24 ++
.../examples/loader-plugin.html | 151 ++++++++++
.../models/VRM1_Constraint_Twist_Sample.vrm | Bin 0 -> 10776032 bytes
.../examples/models/test.vrma | Bin 0 -> 11528 bytes
packages/three-vrm-animation/package.json | 61 ++++
packages/three-vrm-animation/rollup.config.js | 96 ++++++
.../three-vrm-animation/src/VRMAnimation.ts | 40 +++
.../src/VRMAnimationLoaderPlugin.ts | 255 ++++++++++++++++
.../src/VRMAnimationLoaderPluginOptions.ts | 7 +
.../src/VRMLookAtQuaternionProxy.ts | 39 +++
.../src/createVRMAnimationClip.ts | 150 ++++++++++
packages/three-vrm-animation/src/index.ts | 9 +
.../src/utils/arrayChunk.ts | 30 ++
packages/three-vrm-animation/tsconfig.json | 4 +
.../types-vrmc-vrm-animation-1.0/README.md | 14 +
.../types-vrmc-vrm-animation-1.0/package.json | 39 +++
.../src/Expression.ts | 12 +
.../src/Expressions.ts | 21 ++
.../src/Humanoid.ts | 11 +
.../src/HumanoidHumanBone.ts | 12 +
.../src/HumanoidHumanBones.ts | 9 +
.../src/LookAt.ts | 12 +
.../src/VRMCVRMAnimation.ts | 31 ++
.../types-vrmc-vrm-animation-1.0/src/index.ts | 7 +
.../tsconfig.json | 6 +
yarn.lock | 8 +
30 files changed, 1351 insertions(+)
create mode 100644 packages/three-vrm-animation/README.md
create mode 100644 packages/three-vrm-animation/examples/.editorconfig
create mode 100644 packages/three-vrm-animation/examples/.eslintrc
create mode 100644 packages/three-vrm-animation/examples/dnd.html
create mode 100644 packages/three-vrm-animation/examples/index.html
create mode 100644 packages/three-vrm-animation/examples/loader-plugin.html
create mode 100644 packages/three-vrm-animation/examples/models/VRM1_Constraint_Twist_Sample.vrm
create mode 100644 packages/three-vrm-animation/examples/models/test.vrma
create mode 100644 packages/three-vrm-animation/package.json
create mode 100644 packages/three-vrm-animation/rollup.config.js
create mode 100644 packages/three-vrm-animation/src/VRMAnimation.ts
create mode 100644 packages/three-vrm-animation/src/VRMAnimationLoaderPlugin.ts
create mode 100644 packages/three-vrm-animation/src/VRMAnimationLoaderPluginOptions.ts
create mode 100644 packages/three-vrm-animation/src/VRMLookAtQuaternionProxy.ts
create mode 100644 packages/three-vrm-animation/src/createVRMAnimationClip.ts
create mode 100644 packages/three-vrm-animation/src/index.ts
create mode 100644 packages/three-vrm-animation/src/utils/arrayChunk.ts
create mode 100644 packages/three-vrm-animation/tsconfig.json
create mode 100644 packages/types-vrmc-vrm-animation-1.0/README.md
create mode 100644 packages/types-vrmc-vrm-animation-1.0/package.json
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/Expression.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/Expressions.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/Humanoid.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/HumanoidHumanBone.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/HumanoidHumanBones.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/LookAt.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/VRMCVRMAnimation.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/src/index.ts
create mode 100644 packages/types-vrmc-vrm-animation-1.0/tsconfig.json
diff --git a/packages/three-vrm-animation/README.md b/packages/three-vrm-animation/README.md
new file mode 100644
index 000000000..c9b5757ff
--- /dev/null
+++ b/packages/three-vrm-animation/README.md
@@ -0,0 +1,9 @@
+# @pixiv/three-vrm-animation
+
+The implementation of VRM Animation
+
+[GitHub Repository](https://github.com/pixiv/three-vrm/tree/dev/packages/three-vrm-animation)
+
+[Examples](https://pixiv.github.io/three-vrm/packages/three-vrm-animation/examples)
+
+[Documentation](https://pixiv.github.io/three-vrm/packages/three-vrm-animation/docs)
diff --git a/packages/three-vrm-animation/examples/.editorconfig b/packages/three-vrm-animation/examples/.editorconfig
new file mode 100644
index 000000000..0b225afd4
--- /dev/null
+++ b/packages/three-vrm-animation/examples/.editorconfig
@@ -0,0 +1,2 @@
+[*]
+indent_style = tab
diff --git a/packages/three-vrm-animation/examples/.eslintrc b/packages/three-vrm-animation/examples/.eslintrc
new file mode 100644
index 000000000..48e061bbc
--- /dev/null
+++ b/packages/three-vrm-animation/examples/.eslintrc
@@ -0,0 +1,11 @@
+{
+ "root": true,
+ "plugins": [
+ "html"
+ ],
+ "extends": "mdcs",
+ "rules": {
+ "padded-blocks":"off",
+ "no-unused-vars": "off"
+ }
+}
diff --git a/packages/three-vrm-animation/examples/dnd.html b/packages/three-vrm-animation/examples/dnd.html
new file mode 100644
index 000000000..e1d7af8df
--- /dev/null
+++ b/packages/three-vrm-animation/examples/dnd.html
@@ -0,0 +1,281 @@
+
+
+
+
+
+ three-vrm-animation example
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/packages/three-vrm-animation/examples/index.html b/packages/three-vrm-animation/examples/index.html
new file mode 100644
index 000000000..494a2151d
--- /dev/null
+++ b/packages/three-vrm-animation/examples/index.html
@@ -0,0 +1,24 @@
+
+
+
+
+
+ three-vrm-animation examples
+
+
+
+
+
+
+ loader-plugin.html
+ Import a VRM Animation from gltf
+
+
+ dnd.html
+ A slightly advanced example with a drag-and-drop capability
+
+
+
diff --git a/packages/three-vrm-animation/examples/loader-plugin.html b/packages/three-vrm-animation/examples/loader-plugin.html
new file mode 100644
index 000000000..931450d50
--- /dev/null
+++ b/packages/three-vrm-animation/examples/loader-plugin.html
@@ -0,0 +1,151 @@
+
+
+
+
+
+ three-vrm-animation example
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/packages/three-vrm-animation/examples/models/VRM1_Constraint_Twist_Sample.vrm b/packages/three-vrm-animation/examples/models/VRM1_Constraint_Twist_Sample.vrm
new file mode 100644
index 0000000000000000000000000000000000000000..8ee8717df1af676c4ab89c2344d5bcd907d039f9
GIT binary patch
literal 10776032
zcmeFa+mal|nV{LW`yy?1wQE)^#rc3ciY*PP;XwmZQuoSaup*EoYZ|D+R23+)X?&Z#
z+Nat_+3$Ccj0``7r+a#4C4`mKnn6}X_~G~eeDd#KfAjnQ?O*=oU;f`W|M$QA^#A!QEBcys*|t1Yg&v1$5lXzI)IirM?NtuBiz
zR@IJu(YJr&&6``^{Al@VaaEK}U(`b}G?zRn>$>W@vXj@>SO4eVeNsDXXTN(PWUoDO
ziu%}7RL(A%h$&dcbk6z&g1cy(DL|9s0?M5NIPaZehppvMvF-I;tRO46w|A1=frDi`
zTrIn9057`|TrG+Mv>gRk%cdNQu_~9ix_h;_>Wi{yo1*R&sup9>mj@u~kiPD9*my}{
zJn{@KnwByAXosf?_`yxMI8>%Fql2c1;TbzTt;!mFTHnSBo|b8Bqbrt(S`}4OjHP0w
zMPGFt2q>spx5ZEwm4T`AyC0QTRogW~)0CT!6tWgW+f-%Kq_fpBh9m9BOs#$$L|$|)
z(>T)pDLnWZ!;yCQx_=4}zNYb`gQkdK9XoujyBbtlKa4eeO=BN@xljV?s%YDxX-61q
z-IUePRD(j-awuwpukPL~u7+ytn^7wOi2tfA`gBCCVp!4+QPr~7VdF*ADvc%WpTb4d
zDuyNP5Ox0)E}~Xx{OF)5VwlDbQJbne1W`rdP0#>_fsJpq)ne=_QBsw%ivA(HL>Wa>
z9lBPqZ&p?pZ`NIbqB@EHx*xl)ZR!IsHHI1OFjcKP6;sog(f%nsm>R>3c9^<<3J<2H
zaiT+}5DvK)hjy5X)MeZ2hq1y^>ompz|AT;LRITb7BMH+AWNivKY1x+wSv%0SGIW4q
z`EK2}W7&+gyo-fZH$#1Z0#L_rq#d^EwXZ|S%UJ6)mJ~6Ei?4MIPuk&Y#2hZd)@d9m
zdJfmtw*fvQOHqOyt#C0p_M#ZZqAROT|EQb3DeJNlrnO^m>XWV*>rw2Q0`zK%s_c<=
z>L(U?(e!n_!s#B~Uf)09fcRx=lnTaO+}ysp!IvR_Ub-VgF=X0B_
z{mQG8OJhc?6kydQI#Sb#dR-J1K9p`mZBf5U6q&MZ29v(fVx}(?Y}$fftyZxM0n`9+
zV*w=|l2t&(aMyMnP&Vhx1XNie?65yHpqddRgQ0X9L10O3UkycXqLuj#b~K>sn^u1V
z9%7$>h8|AgV3ekl6_jeCIQS~0IBgRnb0G!wfJiWKP^v_E7(fe6i{(((BZiov2Mh5v
zRWoSy7f^yhg$8WdW5ji18;eh2FvYO(b%esLcT_MH?NGHam0qb`7`a2y;!RX!*x&%H
z2NRj}`vppy!k-fJp{^NX!ltq*dcZgw1)*XDMF3K^49G+%6wY$!8^yuP0xqqcRR!dS
zpLFOHyIC-E^}5zki*kf+1vDCHJx(t?tm9Fjl*h@N7*4*F98C;ET#<^G#bv>sHIVqX
z`sHCfwj?p;w>hdfVQmk*J%8dHZ44{3=a?k_G4|NnyzmrzjNwD4+@sCNPO--r4syyp
z+AQc4du084HMvvn(Pkj0*yEXb4sNt`7$@=^@w}Y#9EriC&!4)-GxMD833yI-W}bt+
zdHQoaGtcRsfai2)<~iLH@Ei%no|EU`K1-iJk>~Vh<~jWn@Eq|{p7k7`fammQ<~i7I
z=`c>k)id*){t0-_aAuw}JOR%c&dhTpz?RGp5^&F`|@XUd^ibRFq1ZABDL{EJ0dk>^$8v5xTxInHSEZ`Pdl5*yr$|ADRBY%pu<
z>{P`nh+#~A)uV(rx=80?D7Z1k@ZxnijW#RIgp(Plkl@BJj@zJ4Ft{PPE#Q+Uw9y{L
z$tp>_83-kTIOFqNK)t824PqzeK7GER06y6)JrhjtacpDEW6tAInKPvGe#SP&JU%`i
zn~$3zeL{tjd!$)UHMV3e4?9t&BlzS1=zzZPr$M5Sv`j$Tm4xnfgsd&wp(Rs9eO^=*(OdO}M@e-Q
zgFUdyW92N-f^{yF8e0O1w1KuV9TUqra__r!jzhGASgI%@}B-dke
zX#Q3r6hP8g{XERAqUt-=HLB7n-pJ%u&~!m|75Q}vJR`|jB&lh;2DXGz*VQIx*I$sF
zrNJ{+sOcn8C|F_pbq&=M33#<`^pzB6<@a2)%UWc)-<6;((QLa8Hjbr6JHtWM{BQvybrO{?uW$ua_Q
zRC?Nu`t5rxyq@tm;qb~U0TH1|+NKy{C#>LA_E)Jd_5kM0Vd{9AoJT6p(Zu
zs`w>9Tux<6CJ#zRn?iFR!4*zOvbCaUDFl*Cw(OM2?V;4!NPo%tYON}K~
zA#!mt1N#vJv5WQkHcddp#nmMJx>h7Xfyc3-RpS&V0XH62e1Opmo-62pg5X&vWy~5{
zP20c;V@;Jxq}v*5MU^K7B%f1yl*_nG)FKAs&?3OFG=rn!Rv28FeBP;W$^{p7Mq@cN
zlsstc8ZmO!KhdeF2&fiOx{1=HZgXPmn7d@SZv|psv>k33akISzP
zh0>%}!SE{DRgA0sDjXGD((PBFlgZ7gGdnVLIzggxl6N=*FgNH%Q;Kf|Y}naw_yBtB
zelgh+3n4l~NFyF{(jYP%aI`QfL|HI^qh4w-*C-_r==3<{qHX^+
z#G{)`Rs5*MN9~nV3T-}`#2Hw_Pt9?Nl8Coa+(Hx1R9DhA1La_p4;0R{QdEiOZW3iZ
z4oav?7x04C6g5jtRrGzRzLK3pgzi#Sf8osJmt^A58;EB|eW;kYsY=
zs5+zA+?)EUZlyg{)kmUFd8PUZ(Fa3)5N+3nL6XUSIVTg#d|0w9eJZ2slEA&GD-}e<
z5n~yQ_G8s
z*iXly$}k470O})K@OTRzS@$}0<~nBc2<-4*?i_A`Jf6LXeXx$`eYgek`0XR+NP(4a
zju@U{&2hvGL87Ne-lN;>4hMAl97o-w%|vqX(X+?Y(xe4HI7T%jc>(D#PNi$Sc_uTC
zfa5XGF|{=55Z;wqnsoGYJT}kKxEjIJ%MlX$O#G%OF68eoA*Jh}|Hc=*41KNxU|Hr92<}#)VJ98%Q(#
zftIKwm0%S|OQV4MBdSCzAdQ?7E1xua3aAm}ZTemQUq0AEzUru=uMpI1PMQz3dTj7F
zPsv(>Y@`tpUDKIvc*~;EZ5YV2*(ROh!%RcAAk<=P-4N7l-t2>#!D*xFqE5(Zox-XJ
zOCwb)h$?_OZcQ&V^rPIDfejeq*LrMh69{(k2VK6#U5GzIkh{d
zUg$V`OpxL4tL2?pVnk@pI@x{lN9E_75f{k6wpRS)xX=tG^*qFHRJ0F|N?W6&h$c%n
zK@z5`Qqp&J(PA>ADGjaZY@@VYxsMO3(TqSfAYCk$cN2*9kXA}Ctc_xn-d
zysVETDr?2ZL4~EdB|S9H$@<8UPM<$f-2!RT=QyJCn3R(A`BV28Rf%#sF-@+>6YMdD
z1DtY?HU~KYJw}y(oN|v(z;mLCH%__7C*V0z^%tky;}h_lsA`H6?$N2nH~~FIT{Lpa
zJw5@?kvgJts=Q87#3{~^Gdk-YpMd9ZhtPTV_yjyBD(U}(^ym}~oB&s&a`jKS$0y)9
zQP+%|a*t1-=S1D&amqbD0ne$=%yXP1`4iA%RGRt;&(TS9KgAx;Y+E_G>!;Y`ne`ke
z@B9>d1P{-t=QxSvr`Y3}d5)7Aeu6zl<&vL}=Nyt`p6atYBq98memUx%l4&J*k7wpN
zM^7Yo6TqmoPlw}C&+!TLoHHkqSE+YgL?%ZWv4Artl2=cVNM4;ekz5*not)>KIgz|d
zz2o8_Ts-aZG*;>T2UT8oqp$d{08-V2VV-X{sU}lh@kNgtEwKdysSx
zdhzQp@|Mm?vw#%N6fucgJ4Z=I#3U?aI_`)`+`=}wNAk!!(UXMoX-tG6Czv*avDp
zAytH60Mrt9$?WbE1+SKmt8z+1DF%|at0uP7Oec!+O8pPH+?lYl8EG!8=pEWf6|X=F
zuEI_=&`_a1_oht~KsEx`$0gQ&mH6zm`^YktsUx!F4!gW~Nu!nduf4
z!i=FN)wQ6k>F-z#Q;+|ZD`w^OazyM2q@)ifZ7|^U>K8dp110UT_#{n#SMez`7rk;W
z5Xr?ST3pd(O(&kivS?C_q*5qFQ9Jo7AefQzMGd)pF!#jby41eJ6|69fZnpAY65Atj
zst?>1!I9H|BMNreyROvFb$>X96
zyM3&BpM-a<^;P7$V+%|=U{RCrKGG+riBx6i*tjZ$>dbpU=)rSjA+!fnT+m>Zy3$Cu
zqC8+~SgBxzrnpV~7g$N@Yb2~tgaWY2W4m=!wttFwy4$)oPo)lcL}!v;Pk>lqVCAu4
zQBIGn-OyREmdiUtn^O=f=;c9gRI8z`-|7AwiA%EGd2czP6azflp(qp*YnpvrS~aGpm86^&ux
z+X^_A6<^m_Qka_H$im%0Ct2z3s|>7~t9$TlPL?U2L1AEREK<=_d>v9z6&LG@Aq{Vj
z3@N%b!+$#(>I=yo1S)Ly>HaGL75DEn@y1sGsWPwrsI#yBuyq85B1@#|=+>Z>gwl^x
z`0s^PZPkP_53#ruBY;?$+#FIlIyZ0doPk@4mzxeESUAqa%2E{MuR}{6;na=^A~jq@
zZ9mfadT3&G1t1>)SSEYVz6``hFD@M5x;bL@lSd7%)6fK+=n*J{LuB)j4X(upn#GIv
zgOF2OMMEgat1`KI_H7^zgx(+D5JjyPz4(ll03&zGP<(b;imLe@InL^+`j-%Jj_&^G
z2P9KHk~}7gC0>2eIkb+6_#;MEt9s*wLQtqrMAnSlFsdjhK!Q$DPc8@FMqGt0#l~m1Xp|a}
zrNKe~GMR3a>}x+PELuin<+@!IM{V_Re>UmCLg$?k*Omht7Mz
zsmm>N+<7tS1byF<57L+bQlAhlm}2{+N&qsFGZfJQYm6MA8VN1>>I9&b$;X}Ys!V8c
zsnYYD0k#eUD6*k^JUKvj$C03bYsC2xc)+UH1}3Lg^=mU
zIylT4aYG`ORw!|C)1VO-fc`0cln4e{cdYAga20HMHnxp;h&3{a`@D>G#x;_>x=MJN
z?AxjE%0#8$RoDd=7C}R`%DdWOllo?H88*!`arAEQ=1sc|oBP-Uz{=FZol>z}V6{C|
z!wnvqh0}X~dmXmPnbd1cu8^m!a3v9!o7&NWmT;w5Tv8PaYq%6ur52z&r^+l7JkSV{
z-)f>e+>#A8*5ufww>SsXEXlb2nsidGa#FpD7Zj&n--g8-Nkiu9uqgo$_QsX!L+nL`T&xvG^F
z6uf1k6e$35cXK_3dW{RP2atn2Tmzxx{gR8=MUmX@4s1<J7{D#3mM<4x`*DlgtWelZV$@Kk
zBX+-SPdQzky~8i^SE8ewAssZTvM>a(7zV#g_u?wK2%JVFohsc+T7K>)DtiGDbxHrI
z!II2-V!&Pto<5>6Q6Pq`*(Y$sjK4auMo_zMB2d8CWmJ*iDR+5L^~BTMRIFrzFuw*&hO&fMJd!=IB+03%rm-&G!bMV)%9lpJH6Y1`my@&9jO7n3BRN
z?mH59F?V@x9_p0lon)8iR{Wfzx|8fOhL@ZaV{LWpB)g2^1Sj34%}P$O%eWFVnfcxA
z
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