Q100710: Mari 問題に関するトラブルシューティングガイド

まとめ

Mariで問題が繰り返し発生したり、期待通りに動作しなかったりすることがあります。そのような状況で自力で解決したい場合は、この記事が役立ちます。この記事では、 Mariトラブルシューティングをマスターするためのヒントを多数紹介しており、問題の詳細を理解して解決するのに役立つでしょう。

詳細情報

問題を調査する際に探している情報を把握する

トラブルシューティングを行う際には、次のような多くの肯定的な結果が目指せることを念頭に置いてください。

  • さまざまな手順でタスクを完了できる回避策を見つけます。
  • 問題が再発しないように、どのような設定を避けるべきかを正確に把握します。
  • バグが発生した後にその症状を除去する。
  • 失われた作業を回復しています。
  • 発見したことを他の人と共有する。
  • Mariへの理解が深まります。

これらすべての結果を得るには、問題の以下の側面を可能な限り理解する必要があります。

  • 再現手順- 条件をアクティブ化し、問題を引き起こす具体的な手順。これらの手順は、可能な限り簡略化して簡潔に記述する必要があります。
  • 条件- 問題が発生するために必要な個々の状況。再現手順において特定の順序で発生します。例としては、ノード属性が特定の値に設定されている、設定が誤って使用されている、サードパーティ製プラグイン、ファイルが破損している、OCIO Configが不完全であるなどが挙げられます。
  • トリガー- すべての条件が満たされると、トリガーは予期しない動作を引き起こすアクションです。
  • 症状- 予期しない動作に加えて、一部のトリガーによって、条件が削除された後でもテクスチャが破損するなど、作業に変更が残る場合があります。

以下に提案するテストの中には、こうした情報を提供するものがあり、それを基にトラブルシューティングを行い、良い結果を得ることができます。また、他のテストでは問題を直接解決し、原因を推測できる場合もあります。

お使いのコンピュータがMariをサポートしていることを確認してください

お使いのコンピュータがMari完全にサポートしているかどうかを確認するには、設定要件と照らし合わせて確認することをお勧めします。これは、パフォーマンス、キャンバスレンダリング、ファイルI/Oの問題に特に関係します。詳細は以下をご覧ください。
Mariのシステム要件
Q100701: Mariでサポートされているオペレーティング システムの互換性リスト

ナレッジベースとバグトラッカーで問題を検索してください

既知の問題が発生しており、 Foundryのサポートチームが既に徹底的な調査を実施している可能性があります。その場合、問題の解決に必要な情報がサポートポータルに既に掲載されている可能性があります。以下のページの検索バーを使用して調査することができます。

  • Mariのバグトラッカー- 問題が既知のバグである場合、公開バグレポートが作成されます。このレポートには、問題の内容、再現手順、影響を受けるMariバージョン、既知の回避策や解決策が記載されています。この情報から、個々のニーズに合った解決策が見つかるかもしれません。バグトラッカーの詳細については、こちらをご覧ください。
    Q100068: バグ トラッカーとは何ですか? また、どのように使用できますか?
  • Mariのナレッジベース- バグレポートに加えて、 Foundryのサポートチームは、様々なワークフローやトラブルシューティングのシナリオに役立つ記事(この記事など)も執筆しています。ここでは、特定の問題に対する修正プログラムや回避策、推奨されるベストプラクティス(問題の発生原因を示す場合もあります)、失われた作業の復元方法、パフォーマンスの向上方法など、さまざまな情報を見つけることができます。

リリースノートの既知の問題セクションを確認してください。

Mariのリリースノートには、今後のリリースで修正予定の重大な既知のバグと、関連する回避策の提案が記載された「既知の問題」セクションが含まれています。お使いのMariバージョンのリリースノートは、こちらからご覧いただけます。
Mariのリリースノート

Mariを更新して、最新のバグ修正と機能強化を入手してください

Mariの古いバージョンをご利用の場合は、バグ修正または機能強化により、後続Mariバージョンで問題が修正されている可能性があります。Mari の最新バージョンを確認し、こちらからダウンロードできます。
Mariをダウンロード

GPUドライバーをアンインストールしてから更新またはダウングレードする

Mariで問題が発生する場合、特にパフォーマンス、テクスチャ、ビューポートに関しては、GPU ドライバーの不具合が原因となることがあります。NVidia または AMD ドライバーをアップグレード(またはダウングレード)し、 Mariを再起動して問題が解決するかどうかを確認してください。

GPUドライバーのアップグレードを最も徹底的に行うには、まず現在のドライバーを完全にアンインストールし、問題のあるコンポーネントが残っていないことを確認する必要があります。そのためには、ディスプレイドライバーアンインストーラー(DDU)などのツールを使用します。

DDU とお使いのマシン用のドライバーは次のページで見つかります。
ディスプレイ ドライバー アンインストーラー - ダウンロード
Nvidia ドライバー
AMD ドライバー

異なるセーフモードレベルで問題を再現する

最初の実践的なテストは、問題を再現できるか試すことです。できれば最初から、セーフモードの異なるレベルで再現できるか試してみてください。特定のレベルで問題が再現されなくなった場合は、問題の原因が特定できる可能性があります。例えば、

  • --safe=4で問題が発生しなくなった場合、問題はデフォルトではないMari設定に関連しているはずなので、問題の原因を環境設定またはツール プロパティで調べる必要があるかもしれません。
  • 新しいサンプル プロジェクトでも--safe=8で問題が発生する場合は、この問題がMariに固有のものであり、おそらくバグであることが確認できます ( Mariインストールが破損していない限り)。

セーフモードレベルでテストを行う際は、通常のMariセッションで行った操作によって発生した問題が必ずしも解決されるわけではないことに注意してください。既存の問題が解決されるかどうかは、貴重な情報です。例えば、ペイントノードからテクスチャデータが消えてしまう原因不明の問題を引き起こしたとします。

  • テクスチャがセーフモードで復帰した場合、症状はトリガーがアクティブな間のみ発生することを意味します。おそらく、キャンバスが既存のテクスチャをレンダリングできないことが原因です。
  • セーフ モードでテクスチャが復元されない場合は、トリガーが削除された後に症状が発生する可能性があるため、テクスチャが破損している可能性があります。

セーフ モードとは何か、そのさまざまなレベル、およびそれらのレベルを使用してMari起動する方法については、以下を参照してください。
Q100022: より安全なモードを使用してMari新規インストールとして起動する

注:セーフモードで問題が解決した場合、 Mari常にセーフモードで起動することは問題の解決策ではありません。Mari Mari常に新規インストールのように起動すると、様々な制限が生じるためです。代わりに、セーフモードで提供される情報を使用して、通常のMariで問題を解決する必要があります。

問題が特定のプロジェクトに固有のものであるかどうかを確認する

現在、問題の解決に注力しているか、問題を理解しているかに関係なく、別のプロジェクトで問題を再現できるかどうかを知ることで、役立つ洞察が得られるはずです。

例えば、問題が元のプロジェクトに固有のものである場合、ベイクポイントノードが多すぎるか、UVに問題がある可能性があります。一方、別のプロジェクトで簡単に再現する場合は、特定のノード設定は関係ないか、ジオメトリに問題がない可能性があります。

問題がプロジェクト固有のものであるかどうかを確認する最良の方法は、 Mariサンプルプロジェクトで再現してみることです。別のコンピュータで正しくセットアップされた完全なアーカイブでテストすることで、問題が確実に再現されるからです。場合によっては、できるだけコンテンツが少ない新しいプロジェクトでテストすることも効果的です。その場合は、シンプルなジオメトリを使用して独自のテストプロジェクトを作成することもできます。

サンプル プロジェクトの新しいバージョンを作成するには、 Mariを開いて、 [ヘルプ] > [サンプル プロジェクトの作成]を選択します。

セーフモードとサンプルプロジェクトを組み合わせる

上記の2つのセクションでは、まずセーフモード、次にサンプルプロジェクトについて説明し、それぞれをトラブルシューティングツールとして使用する方法について説明しました。ほとんどの問題の場合、まずはセーフモードでサンプルプロジェクトを使用して問題を再現できるかをテストしてください。これは、これら2つのテストを同時に実行することで、サードパーティ製プラグインや不適切なプロジェクト設定などの変数を同時に削除できるため、問題がMari固有のものかどうかを判断できる可能性があるためです。このテストが完了したら、必要に応じて各トラブルシューティングツールを個別に試すことができます。

ユーザー設定の削除

--safer=4で問題が発生しなくなった場合、または問題がユーザー定義の設定(レイアウト、環境設定、ツールプロパティ、ショートカットなど)に関連していると思われる場合は、 Mari工場出荷時のデフォルト設定にリセットするために、設定を削除してみることをお勧めします。これにより、 Mariをカスタマイズしたすべての設定が失われる可能性がありますが、ツールの誤動作、パフォーマンスの低下、起動時のクラッシュなど、多くの問題がすぐに解決されることが知られています。

Mariデフォルト設定にリセットするには:

  1. Mari閉じた状態で、 TheFoundryフォルダを移動するか名前を変更します。これにより、 Mari設定を見つけて読み込むことができなくなりますが、設定のバックアップは保持されます。
  2. Mariを起動します。Mari Mari TheFoundryフォルダを見つけることができないため、デフォルト設定を使用して最初から再作成されます。
  3. 問題が解決したかどうかを確認してください。
  4. 問題は解決したが、設定の一部を復元したい場合は、 Mariセッションの合間に、元のTheFoundryフォルダから新しいTheFoundryフォルダにファイルの一部を移動してみることができます。
  5. 手順4を実行する際に、特定のファイルを復元すると問題が再発することがわかります。これにより問題の原因が特定され、必要に応じてさらに調査を進めることができます。原因は多くの場合、 Mari 7.1v1ファイルであるため、 TheFoundry親フォルダ全体を削除する前に、手順1でこのファイルを削除してMariを再起動することもできます。

Mariの config フォルダとその場所に関する詳しい情報は、次の場所を参照してください。
Q100723: Mariのユーザー設定ファイルとその場所

注意:シェルフ コンテンツを復元するには、シェルフフォルダーを戻す必要があるでしょう。これは貴重なものであり、通常は問題の原因にはなりません。

Mariログファイルまたは詳細出力を読む

Mari Log.txt ファイルは、 Mariで作業中に生成されるレポートです。アプリケーションが処理している内容がすべて記録され、エラーやクラッシュレポートも含まれます。そのため、トラブルシューティングを行う際には、問題の原因を深く理解できる貴重なリソースとなります。

問題を再現し、 Mari Log.txt ファイルを開いて最後の数行を読んで、役立つ情報がないか確認してください。Mari Log.txt に関する詳細情報とその場所については、以下の記事Mariご覧ください。
Q100020: MariMari Log.txt ファイルとその場所

場合によっては、 Mari Log.txt の出力をリアルタイムで確認し、特定のアクションが内部でどのように処理されているかを確認すると役立つことがあります。そのためには、 Mari詳細出力で起動します。
Q100589: トラブルシューティングを支援するために、 Mari詳細出力で起動する方法

ステップと条件を特定して削減する

問題が一貫して再現される一連の手順がわかっている場合は、問題を引き起こす正確な条件をさらに特定できるはずです。そのためには、問題を繰り返し再現しますが、各サイクルごとに次のいずれかを実行します。

  • いくつかの手順を削除して、問題がまだ発生するかどうかを確認します。
    • たとえば、クラッシュをトリガーするために特定のノードを表示する必要はないため、その手順は削除できます。
  • 手順の代わりに、条件を削除してみてください。
    • 例えば、チャンネルを表示した際にシェーディングエラーが発生する場合は、シェーディングエラーが解決されるまで上流ノードの特定のセクションを削除します。これにより、問題の原因となっているノードを特定しやすくなります。
  • 別のアプローチで問題を再現してみてください。
    • 例えば、エクスポートマネージャを使用する代わりに、ペイントノードから直接テクスチャをエクスポートすることもできます。ペイントノードからエクスポートしても問題が発生しない場合は、問題はエクスポート全般ではなく、エクスポートマネージャにある可能性があります。

これらは、問題の原因を正確に特定できる一般的なトラブルシューティング手法です。正確な状況が分かれば、問題を回避しやすくなります。また、ツールのプロパティを変更するなど、対処方法を知ることで、問題の解決にも役立つ場合があります。

このトラブルシューティング方法を用いることで、 Foundryサポートに報告すべき問題の説明も改善されます。より明確な内訳で問題を再現できる可能性が高くなるため、問題を回避するための提案や、発見されたバグの詳細なレポートを返信できる可能性も高まります。

Mariを再インストールする

発生している問題は、お使いのマシンへのMariのインストールに問題があることが原因である可能性があります。これにより、起動の問題、機能の欠落、データの損失などの問題が発生する可能性があります。ただし、 Mari再インストールするだけでは「工場出荷時の状態にリセット」されることにはならないため、これらの問題が解決されない可能性があります。これは、 Mariが使用する一部のコンテンツが、アプリのアンインストーラーではコンピューターから削除されないためです。

以下の記事では、 Mariを完全にアンインストールする方法について説明しています。その後、2番目のリンクからMariのインストーラーを新規ダウンロードし、再インストールしてください。
Q100138: Mariとその関連コンテンツのアンインストール
Mariをダウンロード

コミュニティで議論する

あなただけではありません。他のMariユーザーも、現在あなたが経験している問題に共感している可能性があります。サポートに問い合わせるだけでなく、他のアーティストと問題について話し合うこともできます。

Mariには、知識を共有し、一緒にMari最大限に活用することに熱心なコミュニティがあります。これらのコミュニティは、 Mariやテクスチャリングに関するあらゆる質問、トラブルシューティング、議論に最適な場所です。

Mari公式コミュニティ フォーラムは、こちらにあります:
Foundryコミュニティ - Mariアーティスト

Mari Discordグループも活発に活動しています。こちらからご参加ください。
Discord招待リンク



さらに詳しく

問題によっては、次の記事も役立つ場合があります。

さらなる支援

依然として問題が発生する場合、またはバグを再現する手順が判明した場合は、サポート チケットを作成し、この記事で要求されている情報をご提供ください。
Q100090: Mari問題を報告する際にサポートに送信する情報

サポート チケットを開く方法の詳細については、次の記事を参照してください。
Q100064: サポートチケットを発行する方法

    私たちはそれを聞いて申し訳ございません

    理由をお聞かせください