Merge pull request #1351 from ousttrue/docs/release_v0_88_0

Docs/release v0 88 0

docs/chloggen.py

@@ -4,18 +4,19 @@ import git.repo
 import re
 import pathlib
 import release_gen
+from typing import TextIO
 
 HERE = pathlib.Path(__file__).absolute().parent
 
 MERGE_PATTERN = re.compile(r'Merge pull request #(\d+)')
 
 
-def main(repo: git.repo.Repo, version: str):
+def main(w: TextIO, repo: git.repo.Repo, version: str):
     major, minor, patch = [int(x) for x in version.split('.')]
     rev = f'v{major}.{minor-1}.0..v{major}.{minor}.0'
 
-    print(f'# v{version}: 1.0準備')
-    print()
+    w.write(f'# v{version}: 1.0準備\n')
+    w.write('\n')
     for item in repo.iter_commits(rev=rev):
         m = MERGE_PATTERN.match(item.message)
         if m:
@@ -23,12 +24,16 @@ def main(repo: git.repo.Repo, version: str):
             pr = m[1]
             lines = item.message.splitlines()
 
-            print(
-                f'* [[\\#{pr}](https://github.com/vrm-c/UniVRM/pull/{pr})] {lines[2]}'
+            w.write(
+                f'* [[\\#{pr}](https://github.com/vrm-c/UniVRM/pull/{pr})] {lines[2]}\n'
             )
 
 
 if __name__ == '__main__':
     repo = git.repo.Repo(str(HERE.parent))
     version = release_gen.get_version()
-    main(repo, version)
+
+    dst = HERE / f'release/079/v{version}.md'
+    with dst.open('w', encoding='utf-8') as w:
+        main(w, repo, version)
+    print(f'write to: {dst}')

docs/implementation/index.md

@@ -9,4 +9,5 @@ coordinate
 fast_spring_bone
 first_person
 scripted_importer
+transparent_zwrite
 ```

docs/implementation/transparent_zwrite.md

@@ -0,0 +1,26 @@
+# UnlitTransparentZWrite
+
+対応状況。
+
+| UniVRM                              | export | import | comment                                                                                                              |
+|-------------------------------------|--------|--------|----------------------------------------------------------------------------------------------------------------------|
+|                                     | ✅      | ✅      | GLTFの仕様外で MToon でもないので仕様の無い存在に。                                                                  |
+| {doc}`v0.44 </release/055/v0.44>`   | ❌      | ✅      | MToon のみを extensions.VRM に記述し、 `PBR` と `Unilt` は GLTF として記録する。                                     |
+| {doc}`v0.76 </release/068/v0.76.0>` | ❌      | ❌      | [\#1004](https://github.com/vrm-c/UniVRM/pull/1004) 仕様外のため削除。import すると MToon になるが調整されていない。 |
+| {doc}`v0.85 </release/079/v0.85.0>` | ❌      | 🔺     | [\#1248](https://github.com/vrm-c/UniVRM/pull/1248) import すると MToon になる。                                     |
+| {doc}`v0.88 </release/079/v0.88.0>` | ❌      | ✅      | [\#1331](https://github.com/vrm-c/UniVRM/pull/1331) MToon 変換を見直し。                                             |
+
+* `UniVRM-0.75` 以前はロードできます。
+* `UniVRM-0.88` 以降は見た目が同様になるように MToon に変換されます。
+* 新規に `ZWriteTransparent` にしたい場合は、 `MToon` を使用してください。
+
+## MToon を Unlit 的に設定する
+
+Emission を使うのがこつです。
+
+- _MainTex: 元の _MainTex
+- _Color: (0, 0, 0, 1)
+- _ShadeTex: null
+- _ShadeColor: (0, 0, 0, 1)
+- _EmissiveMap: 元の _MainTex
+- _Emission: (1, 1, 1, 1)

docs/release/079/v0.88.0.md

@@ -0,0 +1,36 @@
+# v0.88.0: 1.0準備
+
+## 過去に TransparentZWrite シェーダーでエクスポートしたファイルをロード時に変換する修正
+
+* {doc}`TransparentZWrite </implementation/transparent_zwrite>`
+* [[\#1331](https://github.com/vrm-c/UniVRM/pull/1331)] Fix UnlitTransparentZWrite fallback code.
+
+## buffer.uri に `data:` を使っている glb/gltf に対応
+
+`image.uri` では `data:` に対応していたのだけど、`buffer.uri` は対応していなかった。
+
+* [Error when load glb file (buffer.uri)](https://github.com/vrm-c/UniVRM/issues/1326)
+
+## 1.0
+* [[\#1347](https://github.com/vrm-c/UniVRM/pull/1347)] [1.0] Expression UV Binding の挙動
+* [[\#1346](https://github.com/vrm-c/UniVRM/pull/1346)] Fix10/fix expression migration
+* [[\#1344](https://github.com/vrm-c/UniVRM/pull/1344)] [1.0] const LICENSE_URL_JA
+* [[\#1342](https://github.com/vrm-c/UniVRM/pull/1342)] [1.0] migration fail safe
+* [[\#1340](https://github.com/vrm-c/UniVRM/pull/1340)] ReconstructSpringBoneを呼んだ時、デフォルトの回転角の指定が正しく行えない問題を修正
+
+## doc
+* [[\#1337](https://github.com/vrm-c/UniVRM/pull/1337)] sphinx エラー修正
+* [[\#1336](https://github.com/vrm-c/UniVRM/pull/1336)] Doc/update 20211022
+* [[\#1323](https://github.com/vrm-c/UniVRM/pull/1323)] Doc/update 20211018
+* [[\#1321](https://github.com/vrm-c/UniVRM/pull/1321)] UniVRM-0.87.0 release note
+
+## Others
+* [[\#1345](https://github.com/vrm-c/UniVRM/pull/1345)] UniVRM-0.88.0
+* [[\#1343](https://github.com/vrm-c/UniVRM/pull/1343)] bufferView の data uri を実装
+* [[\#1339](https://github.com/vrm-c/UniVRM/pull/1339)] [Maintenance] refactoring gltf buffer access
+* [[\#1338](https://github.com/vrm-c/UniVRM/pull/1338)] MaterialDescriptorをreadonly structに変更
+* [[\#1327](https://github.com/vrm-c/UniVRM/pull/1327)] Merge duplicated gltfExporter argument `GltfExportSettings`
+* [[\#1334](https://github.com/vrm-c/UniVRM/pull/1334)] [0.x] Remove RuntimeGltfInstance before saving a prefab.
+* [[\#1330](https://github.com/vrm-c/UniVRM/pull/1330)] FastSpringBoneがMathf関連のエラーを吐く問題を修正
+* [[\#1324](https://github.com/vrm-c/UniVRM/pull/1324)] Normalize quaternion on update headTransform.rotation
+* [[\#1322](https://github.com/vrm-c/UniVRM/pull/1322)] fix download url

docs/release_gen.py

@@ -79,6 +79,6 @@ def get_hash() -> str:
 
 
 if __name__ == '__main__':
-    version = get_version(UNIVRM_VERSION)
+    version = get_version()
     hash = get_hash()
     gen(version, hash)