From 05b5f604a3c8cd25c825a88b4c9cd741f52de04f Mon Sep 17 00:00:00 2001 From: MikeCAT Date: Tue, 17 Sep 2024 22:52:16 +0900 Subject: [PATCH 1/2] Translate GPUCompilationMessage --- .../ja/web/api/gpucompilationmessage/index.md | 45 ++++++++++++++++ .../api/gpucompilationmessage/length/index.md | 45 ++++++++++++++++ .../gpucompilationmessage/linenum/index.md | 50 ++++++++++++++++++ .../gpucompilationmessage/linepos/index.md | 51 +++++++++++++++++++ .../gpucompilationmessage/message/index.md | 43 ++++++++++++++++ .../api/gpucompilationmessage/offset/index.md | 47 +++++++++++++++++ .../api/gpucompilationmessage/type/index.md | 50 ++++++++++++++++++ 7 files changed, 331 insertions(+) create mode 100644 files/ja/web/api/gpucompilationmessage/index.md create mode 100644 files/ja/web/api/gpucompilationmessage/length/index.md create mode 100644 files/ja/web/api/gpucompilationmessage/linenum/index.md create mode 100644 files/ja/web/api/gpucompilationmessage/linepos/index.md create mode 100644 files/ja/web/api/gpucompilationmessage/message/index.md create mode 100644 files/ja/web/api/gpucompilationmessage/offset/index.md create mode 100644 files/ja/web/api/gpucompilationmessage/type/index.md diff --git a/files/ja/web/api/gpucompilationmessage/index.md b/files/ja/web/api/gpucompilationmessage/index.md new file mode 100644 index 00000000000000..600612aa0caebe --- /dev/null +++ b/files/ja/web/api/gpucompilationmessage/index.md @@ -0,0 +1,45 @@ +--- +title: GPUCompilationMessage +slug: Web/API/GPUCompilationMessage +l10n: + sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e +--- + +{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} + +{{domxref("WebGPU API", "WebGPU API", "", "nocode")}} の **`GPUCompilationMessage`** インターフェイスは、GPU シェーダーモジュールコンパイラーが生成した 1 個の情報・警告・エラーのメッセージを表します。 + +`GPUCompilationMessage` オブジェクトの配列を、{{domxref("GPUShaderModule.getCompilationInfo()")}} からアクセスできる {{domxref("GPUCompilationInfo")}} オブジェクトの `messages` プロパティで参照できます。 + +{{InheritanceDiagram}} + +## インスタンスプロパティ + +- {{domxref("GPUCompilationMessage.length", "length")}} {{Experimental_Inline}} {{ReadOnlyInline}} + - : メッセージが対応する部分文字列の長さを表す数値です。 +- {{domxref("GPUCompilationMessage.lineNum", "lineNum")}} {{Experimental_Inline}} {{ReadOnlyInline}} + - : メッセージが対応するシェーダーコードの行番号を表す数値です。 +- {{domxref("GPUCompilationMessage.linePos", "linePos")}} {{Experimental_Inline}} {{ReadOnlyInline}} + - : メッセージが対応するコードの行内の位置を表す数値です。これは点であることも、関係する部分文字列の始点であることもあります。 +- {{domxref("GPUCompilationMessage.message", "message")}} {{Experimental_Inline}} {{ReadOnlyInline}} + - : 人間向けのメッセージテキストを表す文字列です。 +- {{domxref("GPUCompilationMessage.offset", "offset")}} {{Experimental_Inline}} {{ReadOnlyInline}} + - : シェーダーコードの始点から、メッセージが対応する点または関連する部分文字列の始点までのオフセットを表す数値です。 +- {{domxref("GPUCompilationMessage.type", "type")}} {{Experimental_Inline}} {{ReadOnlyInline}} + - : メッセージの種類を表す列挙値です。`"error"`・`"info"`・`"warning"` のいずれかです。 + +## 例 + +例はメインの [`GPUCompilationInfo` のページ](/ja/docs/Web/API/GPUCompilationInfo#例)を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebGPU API](/ja/docs/Web/API/WebGPU_API) diff --git a/files/ja/web/api/gpucompilationmessage/length/index.md b/files/ja/web/api/gpucompilationmessage/length/index.md new file mode 100644 index 00000000000000..b077e8519e5aa0 --- /dev/null +++ b/files/ja/web/api/gpucompilationmessage/length/index.md @@ -0,0 +1,45 @@ +--- +title: "GPUCompilationMessage: length プロパティ" +slug: Web/API/GPUCompilationMessage/length +l10n: + sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e +--- + +{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} + +{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`length`** は、メッセージが対応する部分文字列の長さを表す数値です。 + +## 値 + +数値です。 + +正確には、`length` はメッセージが対応するシェーダーコードの部分文字列に含まれる UTF-16 コードユニットの数です。メッセージが部分文字列ではなく単一の点に対応する場合は、`length` は 0 になります。 + +## 例 + +```js + // ... + const shaderModule = device.createShaderModule({ + code: shaders, + }); + + const shaderInfo = await shaderModule.getCompilationInfo(); + const firstMessage = shaderInfo.messages[0]; + console.log(firstMessage.length); + // ... +} +``` + +より詳細な例は、メインの [`GPUCompilationInfo` のページ](/ja/docs/Web/API/GPUCompilationInfo#例)を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebGPU API](/ja/docs/Web/API/WebGPU_API) diff --git a/files/ja/web/api/gpucompilationmessage/linenum/index.md b/files/ja/web/api/gpucompilationmessage/linenum/index.md new file mode 100644 index 00000000000000..8bde33a4b56569 --- /dev/null +++ b/files/ja/web/api/gpucompilationmessage/linenum/index.md @@ -0,0 +1,50 @@ +--- +title: "GPUCompilationMessage: lineNum プロパティ" +slug: Web/API/GPUCompilationMessage/lineNum +l10n: + sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e +--- + +{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} + +{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`lineNum`** は、メッセージが対応するシェーダーコードの行番号を表す数値です。 + +## 値 + +数値です。 + +以下の点に注意してください。 + +- メッセージが部分文字列に対応する場合は、`lineNum` は部分文字列の始点の行番号を表します。 +- メッセージがコードの特定の行に対応していない場合 (シェーダーコード全体についてかもしれません) は、`lineNum` は 0 になります。 +- 値は one-based です。すなわち、値 1 がコードの最初の行を表します。 +- 行は改行で分割されます。WGSL では、[特定の文字のリスト](https://gpuweb.github.io/gpuweb/wgsl/#line-break)が改行として定義されています。 + +## 例 + +```js + // ... + const shaderModule = device.createShaderModule({ + code: shaders, + }); + + const shaderInfo = await shaderModule.getCompilationInfo(); + const firstMessage = shaderInfo.messages[0]; + console.log(firstMessage.lineNum); + // ... +} +``` + +より詳細な例は、メインの [`GPUCompilationInfo` のページ](/ja/docs/Web/API/GPUCompilationInfo#例)を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebGPU API](/ja/docs/Web/API/WebGPU_API) diff --git a/files/ja/web/api/gpucompilationmessage/linepos/index.md b/files/ja/web/api/gpucompilationmessage/linepos/index.md new file mode 100644 index 00000000000000..64f72f25467da3 --- /dev/null +++ b/files/ja/web/api/gpucompilationmessage/linepos/index.md @@ -0,0 +1,51 @@ +--- +title: "GPUCompilationMessage: linePos プロパティ" +slug: Web/API/GPUCompilationMessage/linePos +l10n: + sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e +--- + +{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} + +{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`linePos`** は、メッセージが対応するコードの行内の位置を表す数値です。これは点であることも、関係する部分文字列の始点であることもあります。 + +## 値 + +数値です。 + +正確には、`linePos` は行の始点から、メッセージが対応する点または関係する部分文字列の始点までの UTF-16 コードユニットの数です。 + +以下の点に注意してください。 + +- メッセージが部分文字列に対応している場合は、`linePos` はその部分文字列の最初の UTF-16 コードユニットを指します。 +- メッセージがコード内の特定の位置に対応しない場合 (シェーダーコード全体についてかもしれません) は、`linePos` は 0 になります。 +- 値は one-based です。すなわち、値 1 が行内の最初のコードユニットを表します。 + +## 例 + +```js + // ... + const shaderModule = device.createShaderModule({ + code: shaders, + }); + + const shaderInfo = await shaderModule.getCompilationInfo(); + const firstMessage = shaderInfo.messages[0]; + console.log(firstMessage.linePos); + // ... +} +``` + +より詳細な例は、メインの [`GPUCompilationInfo` のページ](/ja/docs/Web/API/GPUCompilationInfo#例)を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebGPU API](/ja/docs/Web/API/WebGPU_API) diff --git a/files/ja/web/api/gpucompilationmessage/message/index.md b/files/ja/web/api/gpucompilationmessage/message/index.md new file mode 100644 index 00000000000000..26ef9b8d9f1156 --- /dev/null +++ b/files/ja/web/api/gpucompilationmessage/message/index.md @@ -0,0 +1,43 @@ +--- +title: "GPUCompilationMessage: message プロパティ" +slug: Web/API/GPUCompilationMessage/message +l10n: + sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e +--- + +{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} + +{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`message`** は、人間向けのメッセージテキストを表す文字列です。 + +## 値 + +文字列です。 + +## 例 + +```js + // ... + const shaderModule = device.createShaderModule({ + code: shaders, + }); + + const shaderInfo = await shaderModule.getCompilationInfo(); + const firstMessage = shaderInfo.messages[0]; + console.log(firstMessage.message); + // ... +} +``` + +より詳細な例は、メインの [`GPUCompilationInfo` のページ](/ja/docs/Web/API/GPUCompilationInfo#例)を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebGPU API](/ja/docs/Web/API/WebGPU_API) diff --git a/files/ja/web/api/gpucompilationmessage/offset/index.md b/files/ja/web/api/gpucompilationmessage/offset/index.md new file mode 100644 index 00000000000000..8ee373cab9cf9b --- /dev/null +++ b/files/ja/web/api/gpucompilationmessage/offset/index.md @@ -0,0 +1,47 @@ +--- +title: "GPUCompilationMessage: offset プロパティ" +slug: Web/API/GPUCompilationMessage/offset +l10n: + sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e +--- + +{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} + +{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`offset`** は、シェーダーコードの始点から、メッセージが対応する点または関連する部分文字列の始点までのオフセットを表す数値です。 + +## 値 + +数値です。 + +正確には、`offset` はシェーダーコードの始点から、メッセージが対応する点または関連する部分文字列の始点までの UTF-16 コードユニットの数です。 + +メッセージが特定のコード位置に対応しない場合 (シェーダーコード全体についてかもしれません) は、`offset` は 0 になります。 + +## 例 + +```js + // ... + const shaderModule = device.createShaderModule({ + code: shaders, + }); + + const shaderInfo = await shaderModule.getCompilationInfo(); + const firstMessage = shaderInfo.messages[0]; + console.log(firstMessage.offset); + // ... +} +``` + +より詳細な例は、メインの [`GPUCompilationInfo` のページ](/ja/docs/Web/API/GPUCompilationInfo#例)を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebGPU API](/ja/docs/Web/API/WebGPU_API) diff --git a/files/ja/web/api/gpucompilationmessage/type/index.md b/files/ja/web/api/gpucompilationmessage/type/index.md new file mode 100644 index 00000000000000..f553134a334ac6 --- /dev/null +++ b/files/ja/web/api/gpucompilationmessage/type/index.md @@ -0,0 +1,50 @@ +--- +title: "GPUCompilationMessage: type プロパティ" +slug: Web/API/GPUCompilationMessage/type +l10n: + sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e +--- + +{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} + +{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`type`** は、メッセージの種類を表す列挙値です。それぞれの種類が異なる深刻度を表します。 + +## 値 + +列挙値です。以下の値をとりえます。 + +- `"error"` + - : コンパイルが成功できなくなる、シェーダー生成エラーです。 +- `"info"` + - : 参考になるだけのメッセージで、深刻度は低いです。 +- `"warning"` + - : コンパイルが成功しないわけではないが、開発者の注意を引くことが有益な問題についての警告です。たとえば、非推奨の関数や文法の使用についてです。 + +## 例 + +```js + // ... + const shaderModule = device.createShaderModule({ + code: shaders, + }); + + const shaderInfo = await shaderModule.getCompilationInfo(); + const firstMessage = shaderInfo.messages[0]; + console.log(firstMessage.type); + // ... +} +``` + +より詳細な例は、メインの [`GPUCompilationInfo` のページ](/ja/docs/Web/API/GPUCompilationInfo#例)を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebGPU API](/ja/docs/Web/API/WebGPU_API) From a35c81b6f0e1aa010f7b5e3ff291e2185c987b82 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E3=81=BF=E3=81=91CAT?= Date: Tue, 17 Sep 2024 22:56:21 +0900 Subject: [PATCH 2/2] Fix according to mdn-linter Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- files/ja/web/api/gpucompilationmessage/offset/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/ja/web/api/gpucompilationmessage/offset/index.md b/files/ja/web/api/gpucompilationmessage/offset/index.md index 8ee373cab9cf9b..06b2b297a67443 100644 --- a/files/ja/web/api/gpucompilationmessage/offset/index.md +++ b/files/ja/web/api/gpucompilationmessage/offset/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}} -{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`offset`** は、シェーダーコードの始点から、メッセージが対応する点または関連する部分文字列の始点までのオフセットを表す数値です。 +{{domxref("GPUCompilationMessage")}} インターフェイスの読み取り専用プロパティ **`offset`** は、シェーダーコードの始点から、メッセージが対応する点または関連する部分文字列の始点までのオフセットを表す数値です。 ## 値