Skip to content

Commit

Permalink
[ja] Translate GPUCompilationMessage (mdn#23629)
Browse files Browse the repository at this point in the history
* Translate GPUCompilationMessage

* Fix according to mdn-linter

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
2 people authored and sora32127 committed Oct 6, 2024
1 parent 54e2b7a commit 7c7bbd2
Show file tree
Hide file tree
Showing 7 changed files with 331 additions and 0 deletions.
45 changes: 45 additions & 0 deletions files/ja/web/api/gpucompilationmessage/index.md
Original file line number Diff line number Diff line change
@@ -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)
45 changes: 45 additions & 0 deletions files/ja/web/api/gpucompilationmessage/length/index.md
Original file line number Diff line number Diff line change
@@ -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)
50 changes: 50 additions & 0 deletions files/ja/web/api/gpucompilationmessage/linenum/index.md
Original file line number Diff line number Diff line change
@@ -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)
51 changes: 51 additions & 0 deletions files/ja/web/api/gpucompilationmessage/linepos/index.md
Original file line number Diff line number Diff line change
@@ -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)
43 changes: 43 additions & 0 deletions files/ja/web/api/gpucompilationmessage/message/index.md
Original file line number Diff line number Diff line change
@@ -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)
47 changes: 47 additions & 0 deletions files/ja/web/api/gpucompilationmessage/offset/index.md
Original file line number Diff line number Diff line change
@@ -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)
50 changes: 50 additions & 0 deletions files/ja/web/api/gpucompilationmessage/type/index.md
Original file line number Diff line number Diff line change
@@ -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)

0 comments on commit 7c7bbd2

Please sign in to comment.